Move items in projects

As part of refactoring operations, you can move items within a project or between projects.

Before moving items, review the recommendations in Refactor projects and files.

Move items in a project

You can move one or more items within a project.

To move an item in a project:

  1. Before moving the item, check it in. See Check in files.

  2. Select the item to move.

  3. Depending on your perspective:

    1. Right-click and choose Move. Select the new location for your resource.

    2. Choose Refactor > Move. In the Move dialog box, select the new location for the file and the desired options.

      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 file is moved to the new location. The old location is displayed alongside the filename.

  4. Commit the changes for the moved file to the repository. Right-click the moved item and select Team > Commit Move. The Commit Move dialog box opens.

  5. Exclude any items that you do not want to commit to the repository, and change the commit options as needed. For example, select Yes for Convert to outgoing additions to create new files and delete the originals, instead of moving the files. If you are prompted to relate requests, choose the requests and complete the Commit Move dialog box.

  6. 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.

  7. Synchronize the project. Right-click the project and select Team > Synchronize with Repository. For example, if other elements were automatically updated with new references to the file location, you must check in the updated elements.

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

Back to top

Move items in a project

You can move items from one project to another.

To move an item between projects:

  1. Before moving the item, check it in. See Check in files.

  2. Select the item to move.

  3. Depending on your perspective:

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

    • Right-click the file and select Refactor > Move. In the Move dialog box, select the new location for the file and the desired options.

    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 file is moved to the new location. The old project and location are displayed alongside the filename.

  4. Commit the changes for both the old and the new projects to the repository.

    1. Under the new project, right-click the moved item, and select Team > Commit Move. The Commit Move dialog box opens.

    2. Exclude any items that you do not want to commit to the repository, and change the commit options as needed. For example, select Yes for Convert to outgoing additions to create new files and delete the originals deleted, instead of moving the files.

    3. 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.

    4. Synchronize the old project with the repository. Right-click the project, and select Team > Synchronize with Repository.

All users should now get the projects from source control.

Back to top

See also: