New field values created in a destination endpoint during synchronization are automatically sent back the record in the source endpoint.

So, for example, when you create a record in ALM and synchronize it to Agile Manager, that new record is created in Agile Manager, and assigned an Agile Manager ID.

NextGen Synchronizer recognizes this new ID field value, and sends it back to ALM, adding it to the source record.

This last step is the update you see in your run history.

The following types of synchronization runs are removed from the run history after subsequent synchronizations are run:

If your link is in automatic mode, and a synchronization ran with errors, the records with errors are not necessarily fixed in subsequent runs.

This may happen if the errors occurred because of changes outside of the link configuration, such as if the schema changed, but the field mapping was not updated. If you fix the cause of the error (such as refreshing the Field Mapping tab and map the new fields), Synchronizer will re-synchronize those records if changes in the actual record are detected.

Synchronizer also periodically re-synchronizes all records, including those that had run with errors, but have had no subsequent changes.

To ensure that records that ran with errors are indeed re-synchronized in the next upcoming run, manually set the link to re-synchronize those records.

For details, see Re-synchronizing records with fixed errors (automatic mode only).

To improve synchronization performance between Agile Manager and ALM, add indices to your ALM project schema as follows, depending on the type of database you use:

CREATE INDEX BG_VTS_IDX ON [td].[BUG] (BG_VTS, BG_BUG_ID);

CREATE INDEX RQ_VTS_IDX ON [td].[REQ] (RQ_VTS);

CREATE INDEX RT_VTS_IDX ON [td].[REQ_TRACE] (RT_VTS);

CREATE INDEX RT_CREATION_DATE_IDX ON [td].[REQ_TRACE] (RT_CREATION_DATE);

CREATE INDEX LN_CREATION_DATE_IDX ON [td].[LINK] (LN_CREATION_DATE);

CREATE INDEX BG_VTS_IDX ON BUG (BG_VTS, BG_BUG_ID);

CREATE INDEX RQ_VTS_IDX ON REQ (RQ_VTS);

CREATE INDEX RT_VTS_IDX ON REQ_TRACE (RT_VTS);

CREATE INDEX RT_CREATION_DATE_IDX ON REQ_TRACE (RT_CREATION_DATE);

CREATE INDEX LN_CREATION_DATE_IDX ON LINK (LN_CREATION_DATE);

Group stories are not reflected in the ALM requirements tree. Therefore, Synchronizer does not automatically recognize Agile Manager Group Stories, and does not synchronize any group (parent/child) relationship between stories.

If Agile Manager is the master of the synchronization link, and a user story that was synchronized with ALM is broken into a group story in Agile Manager, Synchronizer considers the user story to have been deleted.

If ALM is the master of the synchronization link, breaking a synchronized user story into a group story in Agile Manager causes no changes on ALM.

You cannot search in the link tree when a link is in edit mode. Save any changes or click Cancel Edit to enable the search box.

• After a link is synchronized, you can no longer remove mapped requirement types. You can still add types that are not yet mapped.

• To edit requirement type mapping you must be in edit mode. For details see Edit requirement type mapping.

If inexplicable errors occur, such as an inability to read run reports, constant synchronization failures, errors while creating links, verify that you are synchronizing with a supported version of ALM. For details, see Supported ALM versions.

If your version of ALM is supported, contact customer support. There may be too many files concurrently open on the Agile Manager server.

If this is the case:

• The following error will appear in the Agile Manager log files: java.net.SocketException: Too many open files

• The maximum number of open files allowed by the operating system is too low, and must be increased.

Check the list of custom fields defined in Agile Manager (Site/Workspace> Fields configuration page). Make sure that the field in question still defined for the workspace you are synchronizing.

• The custom field may have been previously defined as a site-level field, and then moved to other workspaces.
• The custom field may have been removed from the system.

This may happen if an ALM entity has an attachment whose name contains special characters (~!@#$%()^&).

Workaround: On Agile Manager, remove the added attachment. On ALM, rename the attachment so that it does not contain special characters.