Checking Out Files

When you check out a file, a writable copy of the latest revision is placed in the workfile location and assigned the next revision number.

You do not need to check out individual files if you are working with Dimensions streams, or if your organization follows an optimistic locking model.

To check out a previous version of a file, you must select the specific revision using the file history.

NOTE  If you are logged into your system as the root user, files you have checked out will not be set to writable. They will be set to read-only. You must manually make the files writable before you can work on them.

To check out files:

1. In Eclipse, right-click the files and select Team | Checkout.

   NOTE   The .project file contains information about the project. Even if you do not explicitly check out this file, Eclipse may silently make this file writable to note the changes to the project.

The Checkout dialog box appears with a list of selected files to be checked out.

NOTE   You must share the project which contains the file to activate the checkout command.

2. On the Checkout dialog box, do any of the following and click Next:

• Select or deselect which files will be checked out.

• Select from available options on Options tab. For example, change the value to Prompt for Overwrite modified files to be prompted if the file in your local workspace is different than the file being retrieved from the Dimensions CM repository.

3. If you are prompted to relate requests to the files that you are checking out, select the requests from the My Inbox or My Working List tabs. Click Next.

4. On the Relate Requests panel, select the Dimensions CM requests to relate to the item during the check out operation. The items are grouped by type, allowing you to easily relate requests to multiple items with similar types.

By default, only those requests that can be used are displayed. If you choose the Show All option, the unavailable requests appear in italics and the Details column provides information on why they cannot be used.

5. On the New Item Revision Attributes panel, set the Dimensions CM attributes for the items that you are checking out.

The attributes are grouped by type. You can copy attributes by right-clicking and selecting from the resulting menu.

6. Click Finish.

On successful completion, a check mark () appears next to each file icon to indicate that the files are checked out.