Skip to content

(FE) Allow importing user to choose to import memberships or not

This is the frontend portion of this feature. The backend work will be tracked in #481718 (closed)

Problem

Currently we import user memberships together with user contributions. It's not possible to separate contributions and memberships mapping, but it would be beneficial for users to be able to do that. There are cases when importing users don't want to move over all members.

Proposal

Add a checkbox that a group owner can uncheck before the migration. Checkbox will be selected by default. If they uncheck the box, no memberships will be imported, for all the groups that are migrated in this import.

Checkbox should be on the page where group owner chooses groups to be migrated. This is same solution as in GH importer.

Design and copy

Screenshot_2024-08-13_at_17.26.51

Emails and banners

We need to show different messages in emails and in confirmation banners - we should not talk about mapping contributions and memberships, but only contributions.

Docs

Here's proposal of docs update - can be used as starting point:

Paragraph title: Opt out of importing memberships

There might be cases when you don't want to import user memberships that are on the source instance. For example, on the source instance the groups or projects that you import have 200 members, but on the destination GitLab instance you want to have only 50 members.

Before the import begins, opt out of importing memberships by clearing the Import user memberships checkbox. If you clear the checkbox, no memberships are imported for the groups and projects that are migrated.

The Import user memberships checkbox is available on the page where you choose groups or projects to be imported.

After the import completes, you can add members to groups and projects at will.

Test cases

  • By default user memberships are imported. That means that users with memberships in groups/projects on the source instance, become members of imported groups and projects on destination instance upon reassignment of contributions from placeholders to them on destination instance.
  • If group owner unchecks a checkbox for memberships import before starting the import, only user contributions are imported for this import process. No user memberships are imported.
Edited by Magdalena Frankiewicz