Attaching source control changelists to items

Source file actions and options depend on the source control application you are using. The following information applies to Surround SCM and Perforce P4. If you use a different application, refer to its documentation for information.

Changelists are used to group related source file actions and allow for atomic transactions where all actions are performed at the same time. If you use changelists to make changes related to Perforce ALM items, you can attach them to the items.

You can only attach changelists to issues, requirements, and test cases.

Surround SCM

You can attach pending and committed Surround SCM changelists to ALM items.

1. Click the Source Files tab when you are editing an item. The Source Files tab is on the Files tab in requirements and test cases.

2. Click Attach Changelist.

The Select Changelist dialog box opens.

3. Select a filter from the Filter changelists by list. You can display your pending or committed changelists, committed changelists by user, or all committed changelists. You can also search for committed changelists.

4. Select the changelist to attach.

To view information about a changelist or file, select it and click View Details.

5. Click OK.

The changelist is attached. Actions in the pending changelist are not performed in Surround SCM until the changelist is committed. See Committing pending changelists.

Perforce P4

You can attach submitted P4 changelists to ALM items. You can only attach changelists for the P4 user configured in ALM.

Depending on the configuration, you may be able to attach changelists to items when submitting them from P4 clients. See Attaching changelists to items from Perforce P4 clients.

1.Click the Source Files tab when you are editing an item. The Source Files tab is on the Files tab in requirements and test cases.

2. Click Attach Changelist.

The Attach Changelist dialog box opens.

3. Select the Workspace that contains the changelist.

4. Select the changelist to attach.

5. Click Attach.

The changelist is attached.