Using other projects in your server project allows you to use the elements of the used projects (e.g., as types) in the main project. You can choose from full usage, where an entire project is used, or partial usage, where you select the specific project scope you want to use. Additionally, usage type (full or partial) and scope can be changed at any time.

Projects are used only in read-only mode. For more information about modifying project usages, see Editing the content of a used project.

To use a server project in your main project, you must have the Administer Resources permission.

Full project usage

Full project usage is the default usage type, where an entire project is used in your main project.


To use a server project (full usage)

  1. Do one of the following:
  2. In the Project Usages dialog, click  and select Use Server Project.



  3. In the Use Server Project dialog, select the project you want to use and click Next.

    You can use the search bar to filter projects by project version, commit tags, author, or comment.

  4. Select the project version you want to use and click the Finish button.



  5. Wait for the usage to be established and click OK to close the Project Usages dialog.


Used projects are displayed under the Project Usages package in the Containment tree and in the Project Usages dialog. Once the usage is established, you can use the elements of a used project in your main project.

Partial project usage (technology preview)

Partial project usage allows you to use only the selected part of the project.

If the elements in the selected usage scope reference elements outside the scope, these referenced elements will be matched with corresponding elements in the main project. If corresponding elements are not found in the main project and its current usages, all references to them will be removed from the selected scope.

For example, if the usage scope contains a part whose type is outside the scope, and the main project does not include that type, the reference to the type will be removed. As a result, the part in the used project will no longer have a type.

To minimize the risk of lost references, it is recommended to use all standard profiles of the used project in your main project beforehand.


To use a part of a server project (partial usage)

  1. Do one of the following:
  2. In the Project Usages dialog, click  and select Use Server Project.

  3. In the Use Server Project dialog, select the project you want to use and click Next.

    You can use the search bar to filter projects by project version, commit tags, author, or comment.

  4. Select the project version you want to use.
  5. Select the Partial Usage (Technology Preview) check box.



  6. Click the Next button.
  7. Select the project elements you want to use. Selecting a parent element automatically includes all of its owned elements in the usage scope.



  8. Click the Finish button.
  9. Wait for the usage to be established and click OK to close the Project Usages dialog.


Used projects are displayed under the Project Usages package in the Containment tree and in the Project Usages dialog. Once the usage is established, you can use the elements of a used project in your main project.