Rename projects or project elements

As part of refactoring operations, you can rename a project or its items.

Before renaming a project, review the recommendations in Refactor projects and files.

To rename a project or project element:

  1. Before renaming projects or project elements, ensure that all users checked in their changes.

  2. Select the item to rename.

  3. Depending on your perspective and the item type:

    • Right-click and select Rename. Enter the new name of your resource.

    • If you are renaming a single Eclipse project, select Refactor > Rename.

      If the file is not already checked out or made local, you are prompted to check it out or make it local. Select Make Local and click OK.

    The new name has been applied to the local file, and both the new name and old names are shown in the perspective.

  1. If you are renaming a non-project item or an Eclipse project that is shared in a container. Commit the change to the repository: right-click the file and select Team > Commit Move.

    The Commit Move dialog box opens.

    1. Exclude any items that you do not want to commit to the repository, and change the commit options as needed. For example, if you select Yes for Convert to outgoing additions, a new file will be created rather than moving the existing one.

    2. In the Relate Requests panel, select the Dimensions CM requests to relate to the item during the commit operation. The items are grouped by type, enabling you to easily relate requests to multiple items with similar types.

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

    3. Click Finish. The file is placed into local mode.

  1. To perform a synchronization and deliver the changes to the repository, select the following:

    • Projects: Team > Synchronize with repository.

    • Streams: Team > Deliver.

    After the synchronization, the name is changed in the Dimensions CM repository.

    All users should now get the updated project or project element from source control.

Back to top

See also: