Relations - Digital Thread Project

Owned by Manas Bajaj
Last updated: Apr 29, 2024
4 min read

The Relations tab in the Digital Thread Project Dashboard shows all the inter-model (digital thread) relations for the given Digital Thread Project. The table shows the relation key, name, version, and details of the source and target artifact for each relation. Figure 1 shows the Relations table for the Spacecraft 2404 Digital Thread Project.

image-20240429-022158.png
Figure 1: Relations

The names of the source and target artifacts are hyperlinked to their dedicated pages in the external repository that owns the artifacts, such as Jira, Teamcenter Active Workspace, Windchill, and others.

In this section, the capabilities available on the Relations page are presented.

Privileges

The following user privileges are required on the Digital Thread Project for working with Baselines.

(1) Relations can be created, updated, or deleted only by users who have RELATION_WRITE permission on the given Digital Thread Project.

(2) Relations can be viewed and and browsed by any user who has READ permission on the given Digital Thread Project.

(3) Users can view their privileges in the Settings tab of the Digital Thread Project Dashboard.

(4) To learn more about Digital Thread Project Privileges, refer to the following: Digital Thread Project Privileges.

Search Relations

Relations in a given Digital Thread Project can be viewed from the Explore → Relations tab of the Digital Thread Project Dashboard, as shown in Figure 2 below. Users can search for relations by their unique key.

(1) Click on the Search button image-20240429-101550.png on the top RHS of the table.

(2) Provide the key of the relation and click the Search button.

image-20240429-101114.png
Figure 2: Search a Relation by Key

(3) If a Relation with the given key exists, it will be displayed as shown as in Figure 3 below.

(4) Remove the search filter by pressing the X button to reset the search.

Relation search by other criteria such as source / target artifacts, containers, or repositories, or their attributes, is done using the graph query capability presented in Queries - Digital Thread Project.

Create a Relation

In the Syndeia Web Dashboard, Relations can be created in a Digital Thread Project in two ways.

  • Approach 1 - Create a Relation from the Explore → Relations page of the Digital Thread Project Dashboard. This approach is presented here.

  • Approach 2 - Create a Relation from the Workspace → Tree View page of the Digital Thread Project Dashboard by selecting an artifact in an external repository that will be the source / target of the new Relation. This approach is presented in Repositories - Digital Thread Project.

Follow the steps below to create a new Relation (Approach 1)

(1) Click on the Create button (top RHS), as shown in Figure 4 below.

(2) A new dialog Create Reference Relation will open, as shown in Figure 5 below.

(3) Select the source and target repositories. Browse the repositories, and select an artifact in each of them, as shown in Figure 5 above.

(4) The default direction of the relation is shown, from currently selected source to target artifact. Flip the direction using the dropdown, if needed.

(5) Click on the Create button to create a new reference relation

(6) A new Relation is created and added to the top of the Relations table, as shown in Figure 7 below.

Delete Relation

Follow the steps below to delete a Relation.

(1) Click on the delete button image-20240429-105150.png at the end of the Relation row, as shown in Figure 8 below.

(2) Click on the Confirm button to confirm deletion, as shown in Figure 9 below.

(3) Relation will be deleted and removed from the Relations table.

Tutorials

Refer to the following tutorial to learn more.