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 VersionVault control) to VersionVault.

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 HCL VersionVault 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.
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.
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.
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.
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.