Editing a File
All changes to resources in the DTR are made in activities.
Prerequisites
The file has been checked in into the DTR.
Checking Out Resources
...
1. In the Repository Browser, select the resource to be edited in the workspace.
a. To edit files in the folder, in the context menu of the folder in the Repository Browser, choose Edit files in this folder
The specified folder and the files under it are checked out .
b. To edit files in the subtree, in the context menu of the folder in the Repository Browser, choose Edit files in the subtree.
The specified folder along with the complete hierarchy under it is checked out.
c. To edit a file, in the context menu of the file in the Repository Browser choose Edit.
The specified file is checked out.
Checking out the resources for edit makes them write-enabled in the client workspace.
2. If you have selected the option of explicitly specifying the activity for the operations on the workspace, the dialog window Activity Selection is displayed with the list of open activities existing in the repository. You can either select an existing activity or create a new one.
The resources are added to the activity specified.
Displaying the Changes in the Version
...
To view the changes made in the resource, in the context menu choose Show Changes on the resource visible under the activity in the Open Activities view.
If there are no differences between the current version and the latest version of the resource in the repository, an appropriate message is displayed.
Otherwise the differences are displayed in the diff tool specified in the Window → Preferences → Team → DTR Preferences.
Displaying the Contents of the Version
...
To view the contents of the version, in the context menu choose Show Changes on the resource visible under the activity in the Open Activities view.
Uploading the Contents of the Version
During an upload, the content of the activity is stored on the server without checking in (and thus closing) the activity.
...
To upload the contents of the version, in the context menu choose Upload on the resource visible under the activity in the Open Activities view.
The contents of the current version are uploaded to the server.
An upload is executed only, if the content of the local file system has been changed since the last update.
Forced Upload of the Version Content
...
To force-upload the contents of the version, in the context menu choose Forced Upload on the resource visible under the activity in the Open Activities view.
The content of the current version is uploaded to the DTR server without a check of whether the content has been changed.
Downloading the Contents of the Version
During a download, the content of a version on the server is copied to the local file system (provided that this file has been synced before).
...
To download the contents of the version, in the context menu choose Download on the resource visible under the activity in the Open Activities view.
The contents of the version will be downloaded only if it was changed on the server since the last upload or the resource does not exist in the client workspace.
Displaying the Version Graph of the Resource
...
To view the version graph of the resource, in the context menu choose Show Version Graph on the resource visible under the activity in the Open Activities view.
The version graph is displayed in the Version Graph view of the DTR perspective.
Locating the Resource in the Repository Browser
...
To locate a resource in the Repository Browser, in the context menu choose Show in Repository Browser on the open version visible under the activity in the Open Activities view.
Checking in the Activity
...
After making the necessary changes to the resources, check in the open activity by choosing Check in in its context menu in the Open Activities view.
The check-in makes the versions in the activity available on the server; the activity is now closed and can no longer be changed.
Result
A new version of every resources in the activity is added to the repository. These are now the new versions in the DTR workspace. The resource is now read-only again in the local file system.