Check out files

If you work with Dimensions CM projects, you can check out files in the Visual Studio IDE.

Require file checkout

For Dimensions CM projects, you can require users to check out files before working on them (also known as working pessimistically) by setting an option in the dm.cfg server configuration file.

Set the configuration variable DM_VISUALSTUDIO_PESSIMISTIC to yes (y) as follows:

DM_VISUALSTUDIO_PESSIMISTIC y

For details on how to set options in the dm.cfg file on the Dimensions CM server, see Administration.

Caution: When you work in pessimistic mode, and you click Cancel while checking out a project file, you may get a warning that the action could not be completed. You can ignore the warning.

In certain situations a warning about conflicting modifications to a solution file is displayed. In this case, select the Overwrite option.

Back to top

Check 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 can optionally prevent other users from checking files out while you are editing them.

If you are using optimistic source control, you do not need to explicitly check files out to edit them. If a file you attempt to edit is not already writable, you are prompted to make it writable.

Caution: When you work in pessimistic mode, and you click Cancel while checking out a project file, you may get a warning that the action could not be completed. You can ignore the warning.

To check out one or more files:

  1. In Solution Explorer, select the files, projects, or solution that you want to check out, and right-click. Select Check Out. The Check Out dialog box is displayed.
  2. Refine your selection by selecting or de-selecting files in the list.
  3. Optionally, click Compare to open the merge tool and compare the latest version of the file you’re checking out to your local copy.
  4. To overwrite local copies, even if the local copies have been updated since you last retrieved them from the repository, set Overwrite modified files to Yes.
  5. Select the Proceed with concurrent checkout option to get the files, even if they are already checked out to another user elsewhere. This option allows multiple users to check the files out and work on them concurrently. Click Next.
  6. If any requests are available to relate to the files you are checking out, select the requests and click Next.
  7. On the New Item Revision Attributes page, you can set attributes as needed for the files you are checking out. Select the file or files, then choose a role section to display all available attributes. Set the attributes as needed and click Finish.
  8. Click OK.

Back to top

Undo checkout

When you undo a checkout, a read-only copy of the latest revision is left in the workfile location and the revision number that was created during checkout is released. No changes are checked into the Dimensions repository.

In Solution Explorer, select the files, projects, or solution for which you want to undo checkout. Right-click and select Undo Checkout.

Back to top

See also: