Perform operations in Windows Explorer
You can use the Windows Explorer plugin to compare or update your work area in conjunction with the Dimensions CM repository.
PRIVILEGES: To create or update items in the repository, you need the Update Item Content and the Create Item privileges.
Some operations require access to the Dimensions CM database, in which case you need to log in. After you log in, Dimensions CM will remember your credentials for future access. For details on how to log in, see Log in to the desktop client.
The Windows Explorer plugin uses client metadata to make comparisons between the work area and the repository. To create or maintain this metadata, the files and folders in the work area that correspond to existing items and directories in the project need to have been created using Dimensions CM item file operations.
The following table describes the Dimensions CM operations.
|Check out items||
Projects only. Right-click the file(s) or a folder and select Dimensions > Check-Out.
Note: In Windows, the maximum supported length of file path for a checked out file in the work area is 260 characters.
|Check in items||Projects only.
Note: If a file is unchanged, the Explorer plugin does not check in the file, but performs an Undo Check Out instead. This behavior is consistent with the Eclipse and Visual Studio integrations, but in contrast to the desktop client.
|Cancel item check-outs||Projects only. Right-click the file(s) or a folder and select Dimensions > Cancel Check-Out.|
|View the item properties of a file||Right-click the file, select properties, and select the Dimensions tab. The Properties dialog box opens, displaying the Dimensions properties of the file.|
|View the item history of a file||Right-click the file and select Dimensions > History. The History dialog opens, displaying the history of the item associated with this file. For details, see View items.|
|View the item pedigree of a file||
Right-click the file and select Dimensions > Pedigree. The Pedigree window opens, displaying the pedigree history of this file.
Note: Revisions of an item that do not belong to the current stream/project are displayed dimmed.
|Compare the contents of a modified file with an item revision in a repository||
By default, the default merge tool is launched for this purpose. For details on how to use the file merge tool, seeUse merge tools or the online help inside the tool.
You can configure other merge tools to use with Dimensions CM. For details, see Administration.
|Lock items in a stream||Right-click the file(s) or a folder and select Dimensions > Lock. A lock icon appears against the file icon.|
|Unlock a locked item in a stream||Right-click the file(s) or a folder and select Dimensions > Unlock. The lock icon is removed.|
|Discard changes to files||
If you have modified a file, you can discard it. Discarding a file performs a get of the original item revision from which the selected file was created, overwriting the file and setting its datestamp to the current system date and time.
|Synchronize both your work area and a project in the Dimensions repository||
|Update your work area with changes from a project or stream||
|Deliver changes from your work area to a project or stream in the repository||
Streams: Follow the steps inUpdate work areas from streams.
|View the changes in a repository compared with your work area||
|View the changes in your work area compared with a repository||
You do not need to log in to Dimensions CM unless you choose to review repository changes, or select the Compare option for a file. If the Log in to Dimensions dialog box opens, complete the details and click OK.
|Make files writable||Right-click file(s) or a folder and select Dimensions > Make writable.|
|Make files read-only||Right-click file(s) or a folder and select Dimensions > Make read-only.|
|Touch files to update their timestamp||
Right-click the file(s) or a folder and select Dimensions > Touch.
This is useful because, when working with build systems, you may want to update the timestamp of unchanged files in your work area, so that they are included in a build but not delivered to Dimensions source control.
|Action a Dimensions request||
In the initial list or requests, any request that is set in the Request under work field in the Explorer Properties dialog gets listed at the top. The other requests in the list are restricted to the requests for the product that are in the user's inbox.
To change the selection:
|Merge files or folders||Streams only. Right-click file(s) or folder(s) and select Dimensions > Merge. The Merge Streams wizard opens. Then follow the instructions inMerge changes.|
|View file annotations||
The annotation view enhances parallel development by adding annotations to blocks of code that have been modified. Right-click a file and select Dimensions > Annotation. The Annotation window opens. For details, see View file annotations.
|View a stream’s changesets||
A changeset is a logical grouping of changes that is created automatically every time that you deliver changes to a stream or project in a repository.
Right-click a folder and select Dimensions > Changesets. The Changesets window opens. For details, see Work with changesets.
|Log out of Dimensions CM||Right-click a file or folder and select Dimensions > Log Out.|