Share this page

# Work with projects and streams in Eclipse

OpenText Dimensions CM for Eclipse provides access to OpenText Dimensions CM source control functionality using projects and streams.

In this topic:

## OpenText Dimensions CM source control

You can perform OpenText Dimensions CM source control actions, such as check in and check out, directly from the Eclipse environment.

You can map Eclipse projects either to OpenText Dimensions CM projects or OpenText Dimensions CM streams. For details, see Use projects or streams.

You can also group multiple projects into a project group, or organize Eclipse projects into project containers. Project containers are a special type of OpenText Dimensions CM project that may contain more than one IDE project. For details, see Use Eclipse project containers.

The Eclipse project files are placed into the OpenText Dimensions CM repository based on the mapping.

When you add your Eclipse projects to the OpenText Dimensions CM repository, OpenText Dimensions CM stores information about the Eclipse project, such as integration type and project name, in the OpenText Dimensions CM repository.

Back to top

## Eclipse project data

When you add an Eclipse project to OpenText Dimensions CM control, OpenText Dimensions CM stores additional data about the project, such as the IDE type (Eclipse), the actual project name in Eclipse, and other project specific information.

The information is stored as attributes for the OpenText Dimensions CM project that is associated with the Eclipse project.

This information is stored either as a project marker file with the extension .ecl (when working with Eclipse containers), or as attributes for the OpenText Dimensions CM project or stream. Additional information is associated with Eclipse Project Containers that allows them to be explicitly identified in the OpenText Dimensions CM Explorer.

Back to top

## Use projects or streams

To work with your Eclipse projects, you can use OpenText Dimensions CM projects or streams:

OpenText Dimensions CM projects | Use OpenText Dimensions CM projects to explicitly check files out and in when working on them. Projects may be most useful for teams for whom more cautious day to day version management is critical. For example, this may include large teams whose members work concurrently on the same files, or teams working on the main line of development for a product. For details, see About projects.
OpenText Dimensions CM streams | Use OpenText Dimensions CM streams to manage parallel development efforts that do not require explicit file checkout. Streams enable teams working on parallel lines of code to work in a more agile fashion to build and deliver patches and maintenance releases without having to continuously reconcile against the main lines of development. For details, see About streams. For details about topic streams and pull requests, including examples and scenarios, see Topic streams and pull requests. To work with streams: You need to ensure that all users have added the stream to their local workspace. For details, see Add projects to your workspace. As users update local files, they synchronize with the repository to update and merge Repository changes or deliver new or changed local files. For details, see Synchronize with a OpenText Dimensions CM repository. Then, to fetch any changes from the repository to the local workspace, users should regularly update their projects. For details, see Update a workspace in Eclipse.
OpenText Dimensions CM project containers | Use Eclipse project containers to group multiple Eclipse projects under a common OpenText Dimensions CM project. For details, see Use Eclipse project containers.

Back to top

## Optimistic locking

Optimistic locking enables you to check in files that were not checked out.

You check in the updated workfile to the repository directly, or if the repository revision has changed, you merge the local file and the repository revision and then check in the changed file into source control.

Optimistic locking differs from the classic pessimistic approach, where you have to explicitly check out the file before being able to place the updates into the repository.

Optimistic locking works well in an Eclipse development environment where developers are working concurrently on projects. A developer may have the entire project locally and need to make changes, but he may not know which files are affected until beginning work on the code. Optimistic locking allows the developer to alter the code, and then only check in the files that have been changed.

OpenText Dimensions CM provides both optimistic and pessimistic options. In OpenText Dimensions CM streams, files are writable by default.

Note: You cannot enforce either optimistic or pessimistic mode in OpenText Dimensions CM from the server level. As an Eclipse user, you may set preferences within Eclipse to facilitate one approach or the other. For example, you can require a checkout before editing files (Pessimistic locking approach).

Back to top

See also:

- Control assets

https://admhelp.microfocus.com Dimensions CM 8942
Tips to improve your search results... OpenText™ Dimensions CM Help Center OpenText™ Dimensions CM Help 25.2 All View Local Help Center View Online Help Center Version: