This topic is relevant for NextGen Synchronizer only, embedded in Agile Manager's configuration area. For details about the ALM Synchronizer, see for .
Agile Manager and ALM maintain separate lists of user list fields, such as for the Assigned To field. Users in these lists are mapped once for all links in the site, across all workspaces.
The following chart describes how Synchronizer recognizes mapped users, using manual or automatic mapping methods.
![]() |
Click the rounded rectangles to jump to more details below. |
ALM users defined with an email address that is identical to the one used to log in to Agile Manager are automatically mapped for all user list fields.
If a user has multiple email addresses defined in ALM, only the first email address is synchronized with Agile Manager.
Map ALM and Agile Manager users manually if the email addresses are not identical, or if the ALM user is not defined with an email address.
Select a link to edit its user mapping.
From the More Actions menu | Select More Actions > Edit User Mapping. |
From a user list field |
On the Field Mapping tab, select a user list field, such as Assigned To. The selected field must be mapped to a user list field in the other endpoint. On the right, expand the User Mapping node, and click edit. |
The User Mapping dialog box displays only users mapped manually. Users mapped automatically are not listed.
Tip: If you migrated the link from ALM Synchronizer for Agile Manager together with users mapped in a CSV file, or imported user mapping using a CSV file, those users are now mapped manually and are also listed in the table.
For details, see Import a link from ALM Synchronizer.
This may happen, for example, if a user once existed in an endpoint's user list, and is therefore listed as a user list value, but has since been deleted from the other endpoint's user list.
Expand the Default user area, and define default users for target endpoints in both Agile Manager and ALM.
Select corresponding users from the dropdown menus for each endpoint, set the direction, and then click Add Mapping.
Tip:
To import user mapping from a link created in ALM Synchronizer for Agile Manager, click Import import user mapping file at the top of the dialog box, and select a CSV file to import.
Imported mapping files must be prepared ahead of time. For details, see User mapping file (.csv).