Import a link from ALM Synchronizer

Note: This topic is relevant for NextGen Synchronizer only. For details about the ALM Synchronizer, see ALM Synchronizer for Agile Manager or search using the ALM Synchronizer filter.

If you previously used ALM Synchronizer for Agile Manager to synchronize records between ALM and Agile Manager, you can import synchronization links into NextGen Synchronizer.

Caution: To prevent errors or data loss, import your link as soon as possible after the most recent synchronization in ALM Synchronizer.

After importing your link, do not run the synchronization from both ALM Synchronizer and NextGen Synchronizer. Running both links in parallel may lead to errors.

  1. Access your link in ALM Synchronizer for Agile Manager. If synchronizations are currently scheduled, disable scheduling, and then disable the link. For details, see:

  2. Export the following files from ALM Synchronizer:

    Link backup file (.zip) For details, see Export links.
    User mapping file (.csv)

    Optional, only if you want to import user mapping data.

    For details, see:

  3. Import the link to NextGen Synchronizer.

    Note: If you use Internet Explorer to import a synchronization link, use version 10 or later.

    On the Integrations > Synchronizer > Link Configuration page, do one of the following:

    • Right-click the name of the bridge or workspace to which you want to import the link, and select Import Link.
    • Select Add Link > Import Link.

  4. Select the files you exported from ALM Synchronizer, and click Next.

  5. Continue through the wizard as if you were creating a new link. For details, see Create a synchronization link.

    Note: Some fields shown in the wizard are automatically populated, as their values are taken from the imported files. You can modify these values as needed.

    Other values, including requirement type mapping and synchronization rules are taken directly from the import files and cannot be modified in the wizard. You can make changes in these values later on.

    For details, see Edit requirement type mapping and Edit synchronization rules.

  6. Verify and modify the link configuration if necessary, and then run an integrity check before you start synchronizing.

    Caution: If the imported link includes mappings that are not supported by NextGen Synchronizer, these mappings are not imported with the link.

    NextGen Synchronizer supports:

    • Mapping field values for list fields only.
    • Entity links to or from user stories or defects only, and not to or from features or themes.

See also: