Skip to main content

Jama Connect User Guide

Change Global ID

A Global ID is a unique identifier of items that are connected through synchronization. While every item has its own unique ID, two items that are synchronized can share a Global ID.

You can change or add a prefix, as well as an optional item type key, in front of the Global ID assigned to items.

Note

You must have organization admin permissions to complete this task.

  1. Select Admin > Details, then click Edit.  

    org_admin_detail.png
  2. Select whether to allow multiple items with the same Global ID in a single project.

    • Yes — One item can be synchronized with other items in the same project.

    • No — (Default) Items can only be synchronized to items in other projects.

      Global_ID.png
  3. To change the prefix for your Global ID, click Edit next to Global ID prefix.

    update_global_id_prefix.png
  4. In the window that opens, enter a new value for the prefix and select the options you need.

    • Change only future prefixes — Change the Global ID Prefix and click Update. No current IDs are affected. Future IDs include the new prefix.

    • Change ALL prefixes (past and future) — Select Apply prefix to existing items, then click Update. All existing prefixes are changed if they match the old prefix, and new IDs contain the new prefix. If the past Global IDs didn't have a prefix, the new prefix is appended to those IDs.

      prefix_change_examples.png
    • Include item type in the global ID — Enter a new prefix value and select Include Item Type Key, then click Update .

  5. To change the value for the Global ID next counter, click Edit next to Global ID next counter.

  6. Set the counter that assigns Global IDs, then click Update. If you set the counter to a value that's being used, the counter uses the next available ID as its starting point when the next item is assigned.

Your changes appear on the Organization Details page.