Associating a Jira Version with a Global Configuration

Following are the steps to associate a Jira Version with a GC.

1. In the Project settings page, locate and click on the Global Configuration option in the OSLC Connect section.
2. If the project hasn't enabled Configuration Management yet, click the widget The project ... is configuration management disabled. and click edit after reading the information displayed. A dialog opens, tick the checkbox to indicate your understand the action and its consequences and then click Enable.
3. Search and/or select the Jira Version to associate with a GC and click on the corresponding Actions column (on the tree dots icon) ^[1]. Searching is done by typing a text in the Filter Versions field. This will search for all project versions containing the typed text in their name or description (combined with the current status filters) ^[2].
4. Click on the Select Configuration... option in the opened menu to open the Global Configuration Picker dialog.
5. If you have registered more than one GC friend (and you haven't associated a single Version before), the dialog will ask you to start by selecting a friend application ^{[3], [4]}. As soon as the friend application is selected (manually or automatically), a pop-up window will appear ^[5]. If you hadn't previously started an IBM Global Configuration Management (GCM) application session, in the same browser, the new window will show you the GCM login page and you must continue with this step, otherwise please go to the next one ^[6]. The login page is here to complete the user authentication process, so please provide valid user credentials, it is not necessary that such user has an admin role ^{[6], [7]}.
6. At this point, the GCM application provides the GC selection dialog, navigate to the one you are interested of and select it.

If everything went ok, the GCM dialog will be closed and the chosen GC will be displayed on the Configuration column of the versions table. If you want to change the associated GC, you can click on the Select Configuration... option again and repeat the procedure. If you want to remove the associated GC, click on the Clear Configuration... option instead and confirm when prompted ^[8]. Note: making changes or removing a GC association will affect all existing Collaboration Links using such version, breaking some of them or worse: making them point to a different version of an artifact. This is why you shouldn't change/remove the mapping association once set and Collaboration Links have been created.

Under the ellipsis button (...) you will find two rich actions

1. Validating and Repairing GCM Links
   IBM Engineering Lifecycle Management (ELM) 7.0.2+ Users

   If you're using GCs of IBM Global Configuration Management 7.0.2 (or higher versions), check related tasks for further information.

2. Export to CSV
   You can view all the versions' data in an external tool by using the export to CSV functionality.

^[1] Available versions are those defined for this project. Go to the Versions tab to manage them. ^[2] By default a maximum of 50 versions are displayed on this page, if the version you're looking for is not listed, try refining your search or changing the limit. For a complete list of versions check the export action ^[3] If only one GC friend has been registered, it will be selected automatically. This automatic selection is done also, for the last GC friend selected, once the fist association is created. ^[4] If some friends are down (or unreachable) and they cannot be determined as GC friends, they will be listed below the Friend selector. ^[5] It may be the case that your browser prevented the opening of the pop-up window. Some browsers notify this with a message in a top bar, others are more discrete and just show a little red icon at the end of the addresses bar; in any case, all of them allow you to authorize pop-up windows, typically by clicking on the area where they showed you the blocking notification and choosing the option to allow pop-up windows. Please follow the corresponding procedure of your browser to allow them and then continue. ^[6] Available GC projects, components and configurations to create the association with, on the next step, will depend directly on the privileges of the logged GCM user. ^[7] The GCM session can also be started since the moment you enter this page (step 1) by clicking in the friend's corresponding Log in button located inside the associations table. ^[8] If a Remove Global Configuration backlink. checkbox is visible, and you don't know why, check related tasks for details.