Controls in the checkout dialog box
Check out a resource when you want to modify it.
Use this dialog box to make a reserved or unreserved checkout of any resource that is under VersionVault View Configuration control. A reserved checkout guarantees you the right to check in your modifications to the element as the successor version on the selected branch. If someone else has a reserved checkout on an element you want to modify, you can make an unreserved checkout, but you must merge your changes with changes made by the user who had the reserved checkout.
Note: An unreserved
checkout will always be unreserved non-mastered when the branch is
mastered at another replica.
Checking out a resource that is not loaded implicitly creates a load rule for the resource and loads it into the view's copy area.
The following controls always appear in the dialog box:
| Control name | Control description |
|---|---|
| Show Details | Displays additional information and options. If you are using a UCM view, the UCM Activity settings also appear. |
| Hide Details | Conceals additional information and options. |
| Hijack Instead | Click to hijack the resource instead of checking it out. This option is only available when you begin to modify a file that is currently checked in to source control. |
| Include descendant artifacts of the selected directories | Click to mark all subdirectories and files below directories in the The selected resources list box for checkout. This option is active when the currently selected resource is a directory. |
| Checkout descendant artifacts only, do not checkout descendant directories | Click to mark only file elements below the current directory for checkout. This option is active when the Include descendant artifacts of the selected directories option is selected. |
| 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 for checkout. |
| Apply Filter | Click to run the filter criteria against all resources in The selected resources list box. |
| The selected resources | Displays the artifact name, any associated comments, and the directory path information of resources. 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 checked out. To prevent the checkout of a resource, clear its associated check box. If the resource is in a UCM view, the activity associated with each resource also appears. |
| Check All | Click to select the check box for all elements in The selected resources list box and mark them for checkout. This option also applies to all files and subdirectories below any directories in the list box. |
| Check None | Click to clear the check box for all elements in The selected resources list box and prevent them from being checked out. This option also applies to all files and subdirectories below any directories in the list box. |
| Select All | Click to select all elements in The selected resources list box in order to apply a comment or activity to each element. This option also applies to all files and subdirectories below any directories in the list box. |
| Select None | Click to specify that no elements in The selected resources list box are selected. This option also applies to all files and subdirectories below any directories in the list box. |
| Select 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, or click Find to select an existing activity. This option only appears if you are using a UCM view. |
| New | Click to generate a new UCM activity using the Create New Activity dialog box. This option only appears if you are using a UCM view. |
| Find | Click to specify an existing UCM activity in the Find an activity dialog box. This option only appears if you are using a UCM view. |
| Comment | Enter an optional comment (one that describes the reason for the checkout, for example.) |
| Reserved Checkout | Click this pull-down menu to specify a checkout status. A Reserved Checkout gives you the exclusive right to check in the element when you are finished. Click Prefer reserved, unreserved if necessary to attempt a reserved checkout, but to allow an unreserved checkout if the element is already checked out reserved in a different VersionVault View Configuration view. If you select Unreserved Checkout, you may need to merge your changes at checkin time, if someone else checked in the same element before you did. |
| Preserve Time | When checking out a resource, select this option to specify that the time of last modification is preserved from the last time the resource was checked in to source control. When this option is not selected, the time of last modification is set to the current time when you check out the resource. |
| Current Activity after Checkout | Displays the activity that is to be in effect after the checkout operation is complete. Click to specify a different activity. This option only appears if you are using a UCM view. |
| Request Branch Mastership | Click to request branch mastership if a checkout operation fails because a branch
is mastered remotely. Whenever a reserved checkout operation fails due to mastership or an
unreserved checkout operation succeeds but the branch is remotely mastered, the checkout fails and
an information dialog box informs the user that VersionVault View Configuration mastership has been requested
for the specific branches. After mastership has been requested, the packets of information related
to the request must be imported from the server, either by automated scripts or by a manual process.
After the packets have been imported, an information dialog box informs the user that mastership has
been granted for the specified branches. At that point, the user can successfully perform the
checkout operation. Note: You can specify that this option is selected by default by setting the
Request branch mastership if necessary option on the preference page.
|
| Keep the hijack content | Click to checkout the hijacked version of a file instead of the latest version. This option is only active when you select a hijacked file for checkout. |
| OK | Confirms the operation and dismisses the window. |
| Cancel | Cancels the operation. |
Note: In a UCM view, all checkouts performed by a merge operation will be performed
in the context of the destination view's current activity.