Add Resources to Source Control

Use this dialog box to add view-private resources (files and directories that are in a view but not under ClearCase® control) to ClearCase.

After you have added a resource to source control, it becomes an element in a VOB and is available to other team members who can access that VOB. The newly created element has version number 0. If you are adding a file to source control and you select Checkout artifacts after adding to source control, you can modify the file and check it in to create version 1.

Controls in the dialog box

The following controls appear in the dialog box:


Control name	Control description
Show Details	Displays additional information and options. If the resource is in a UCM view, the UCM Activity settings also appear.
Hide Details	Conceals additional information and options.
Include descendant artifacts of the selected directories	Click to mark all subdirectories and files below directories in the The selected resources list box for adding to source control. This option is active when the currently selected resource is a directory. Note: When you use the Add to Source Control option in ClearTeam® Explorer and select the Include descendant artifacts of the selected directories option, then the Checkout artifacts after adding to source control option is disabled. This update helps to avoid the automatic deletion of files from a folder when you select the Undo Checkout option.
Include artifacts named	Click to apply a filter recursively to the files and directories in The selected resources list box. Only the files that meet the filter criteria appear in The selected resources list box. For example, if the filter criteria is *.java, only files with a .java file extension appear in The selected resources list box.
Exclude artifacts named	Click to apply a filter recursively to the files and directories in The selected resources list box. The files that meet this criteria are excluded from The selected resources list box. For example, if the filter criteria is *.txt, any files with a .txt file extension are removed from The selected resources list box.
Filter	Enter the criteria for a filter to include or exclude resources from an add to source control operation. By default, the criteria is . and shows all files.
Apply Filter	Click to run the filter criteria against all resources that are currently in The selected resources list box.
The selected resources	Displays the artifact name, comment information, an indication of whether a resource is going to be in a checked out state after being added to source control, and directory path information for each resource. If the resource is a directory, you can click the plus sign (+) to the left of directory to view any files or directories below your current location. The check box next to a resource indicates whether the resource should be added to source control. To prevent a resource from being added to source control, clear the associated check box.
Check All	Click to select the check box for all resources in The selected resources list box and mark them to be added to source control. This option also applies to all elements below any directories in the list box.
Check None	Click to clear the check box for all resources in The selected resources list box and prevent them from being added to source control. This option also applies to all elements below any directories in the list box.
Select All	Click to select all resources in The selected resources list box in order to apply a comment or activity to each resource. This option also applies to all elements below any directories in the list box.
Select None	Click to specify that no resources in The selected resources list box are selected. This option also applies to all elements below any directories in the list box.
Activity	Displays the activity that is to be associated with the checkout. Click to select another activity or click New to create a new activity. This option only appears if the resource is in a UCM view. Note: If you are using the ClearTeam Explorer UCM integration with Rational® Team Concert, and the Display tasks instead of activities in UCM views, when task associations are required option on the ClearTeam Explorer preference page is selected, Rational Team Concert work items display instead of UCM activities.
New	Click to generate a new UCM activity using the Create New Activity dialog box. This option only appears if the resource is in a UCM view. Note: If you are using the ClearTeam Explorer UCM integration with Rational Team Concert, clicking New invokes the Create Work Item dialog box in Rational Team Concert. When you click OK in the Create Work Item dialog box, this action creates a new ClearTeam Explorer UCM activity and associates it with the new Jazz Team Server work item.
Find	Click to specify an existing UCM activity in the Find an activity dialog box. This option only appears if the resource is in a UCM view. Note: If you are using the ClearTeam Explorer UCM integration with Rational Team Concert, clicking Find invokes the Select Work Item dialog box in Rational Team Concert. When you click OK in the Select Work Item dialog box, this action associates the current ClearTeam Explorer UCM activity with the selected Jazz Team Server work item.
Checkout artifacts after adding to source control	Select this check box to force a file to be checked out after it has been created in the VOB (added to source control). This option does not apply to directories.
Comment	Enter an optional comment. This comment is associated with the creation of the new element.
Leave the parent directory checked out	Click this check box to leave the parent directory of the selected resources in a checked-out state after the resource is added to source control.
Current Activity after Add to Source Control	Displays the activity that is to be in effect after the add to source control operation is complete. Click to specify a different activity. Note: If you are using the ClearTeam Explorer UCM integration with Rational Team Concert, and the For Task Provider integrations, display tasks instead of activities in UCM views option on the ClearTeam Explorer preference page is selected, a Rational Team Concert work item displays instead of a UCM activity.
OK	Confirms the operation and dismisses the window.
Cancel	Cancels the operation.

Note: In a UCM view, this dialog box includes items that let you specify a new or existing UCM activity to associate with the action. If your UCM project is ClearQuest-enabled, specifying an existing UCM activity and then clicking OK in the Add Resources To Source Control dialog box may invoke the ClearQuest® record that is associated with the current activity if your policies are configured to automatically transition the associated record and if the record contains fields that require more information. You can then modify the ClearQuest record as appropriate for your activity.