You can update your work area with the latest changes from any version of a stream that is associated with a work area. If there are conflicts you can resolve them by:
Choosing the item revision in the work area (Use Local).
Choosing the item revision in the repository (Use Repository).
Allowing Dimensions to attempt to automatically merge the contents provided there are no conflicts.
If a conflict includes path differences these resolutions are also available:
Use local path
Use repository path
In the Update wizard use the file merge tool to manually merge the content of the files unless they are merged automatically.
To set your current stream and work area in the desktop client:
Do one of the following:
Select Stream | Open Stream
In the Project/Stream context bar click the list button on the right and select Open Stream.
Do one of the following:
Select the default stream.
Select the global project.
From the Product list select a product. From the Stream list select a stream or use the browse button to find one. You can filter this list to only display streams that contain specific items.
Select a work area to be associated with the stream or use the browse button to select one.
To make this your default stream select Make the selected stream and work area my default
Click Open.
To update a work area from a stream and resolve conflicts:
Do one of the following:
Windows Explorer: right-click the work area root folder or any subfolder and select Dimensions | Update.
Desktop client: Right-click the stream root folder or any subfolder and select Update.
The Update Work Area from Stream wizard opens.
The Update changes from this stream box displays the name of the stream from which you invoked the update. To change the stream click Select and select one of the options in the Select Stream dialog box. If you select Another stream do one of the following:
Start typing the ID of a stream. Streams that contain any characters in the string are displayed. For example, to find ’QLARIUS:VS_BRANCHA’ type ’vs’.
Select a stream from the list. Favorite streams and recently used streams are displayed at the top.
Optionally select a version of this stream on which to base the new stream.
Enter the name of a stream, and optionally a version, in this format:
PRODUCT:STREAM_NAME;VERSION
For example: QLARIUS:JAVA_BRANCHA;5
NOTE If you do not specify a stream version the tip is used.
Click OK.
The Update this work area box displays the work area path that will be updated. To change the work area enter its path or click Select and choose an area.
To interactively (manually) verify the results of any file merge operation before applying them to the work area, select Perform an interactive update.
To restrict the update to a specific folder and its subfolders, select Limit the scope of the merge to this folder and browse to the folder, or enter its repository path. If you invoked the update operation from a subfolder, and not the root of the stream, its path is pre-populated.
To restrict the update to particular files or folders, enter wildcard filters in:
The Include repository file box to only include specific file types.
The Exclude repository file box to exclude specific file types.
For details about using these filters see Using Wildcards to Include and Exclude Files and Folders.
To apply the repository date and time to the updated files in the work area select Apply repository date and time.
(Used when shelving a stream) To create a clean work and reset the work area to the latest repository content, select Reset work area changes to repository versions and paths. You can also choose to delete locally added files (such as artifacts added by a local build process).
Select Expand substitution variables if required.
To automatically merge local and repository files whose content does not conflict, select Auto merge non-conflicting file content. You can also select a default character set that is used to transcode Unicode files before merging.
Do one of the following:
If you are performing an interactive update click Next and go to the next step.
If you are not performing an interactive update click Update. The work area is updated and the results are displayed.
On the Review Changes page expand the folder tree to display the changes that have been identified, including the conflict type (if applicable).
On the toolbar select a resolution for each conflict.
To ignore a change click Ignore.
To use the version of the change in the work area click Use Local.
To use the version of the change in the repository click Use Repository.
If a conflict includes path differences these resolutions are also available:
Use local path
Use repository path
Your selection is displayed in the Resolution column.
CAUTION! If you select Use local or Use Repository you may discard a change that you want to keep.
To merge the content of two file revisions that are in conflict click Merge. The default merge tool opens and displays the content of the revisions. After you have completed the merge successfully and exited the merge tool, the resolution is shown as Merge.
To view the changes that have been made to a revision, right click and select View.
Click Update. The results of the update operation are displayed.
Click Close.
Related Topics