Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Objectives:

The new learning objectives of this exercise are to create a repository connection to a Collaborator repository with the Syndeia Plug-in for Rhapsody, view the repository including search, and create a reference connection.

...

Preparation:

This exercise assumes the student has

...

The user can use any Collaborator repository they have available.  Because the content of your Collaborator repository will be different, the specific examples in the following exercise instructions are only a guide and example for your actions. It is generally advisable to carry out these exercises in a non-production repository, a “sandbox”, set up for training and practice purposes.

...

Background-

...

Collaborator:

As envisioned by Intercax, the Digital Thread is composed of inter-model connections between models in different repositories, which Syndeia creates and manages, and intra-model connections between elements in the same repository, which the individual tool creates and manages. As of Syndeia release 3.5, the Syndeia Web Dashboard can extract and display some model information from the Collaborator repository. Figure 1 shows a view of this information in the Syndeia dashboard Repository Manager with labels identifying the Collaborator element types. Note the different icons. The label color coding indicates how the Collaborator element type is mapped to the Syndeia Cloud element types: Repository (green), Container (red), and Artifact (blue).

...

Figure 1 : Repository Manager view of Collaborator repository

...

Exercise:

  1. Launch the Syndeia Dashboard (see Video 1.1) and open the Repository Manager tab (Figure 2).

    Figure 2 : Syndeia Dashboard, Repository Manager tab

  2. If no repository connection to Collaborator is available, right-click on Collaborator in the left column and select Add... Complete the form (consult your Collaborator administrator for the property values in your organization; Grant Type and Scope show default values) and click OK (Figure 3).

    Image RemovedImage Added

    Figure 3 : Adding a Collaborator repository connection

  3. If a Collaborator repository connection already appears under Collaborator, but you need to add your own access credential, right-click on the repository in the left column and select Update…. Complete username and password and click Update (Figure 4).

    Image RemovedImage Added

    Figure 4 : Updating Collaborator repository info

  4. In the left column, select a Collaborator repository connection (Collaborator @ Intercax). Your repository should appear at the top of the right side. Expand it to show Reviews, Participants and Defects, as in Figure 5. See Background section for discussion of Collaborator artifact types. It may be necessary to right-click the repository and select Refresh before it can be expanded.

    Image RemovedImage Added

    Figure 5 : Viewing Collaborator repository contents on Repository Manager tab

  5. On the right border, click the button labeled Search Repository. In the Search Repository window under New Search, select Review by Text or Review by ID to search for a specific review.

    1. If Review by Text is selected, fill in the blank field with a text string and click Search. In our example, we entered Hello. The result(s) of the search are shown below, as in Figure 6.

    2. If Review by Text is selected, fill in the blank field with the review’s Collaborator ID (external id) and click Search. For example, the entry Review-4 returns the search results Hello Syndeia 3.5 Review.

    3. If you right-click on an item under search results, several options are available, including opening the item in the Collaborator browser interface or Get Info, which shows the item properties in the notification window at the bottom of the dashboard.

    4. Click outside the Search window to close it.

      Image RemovedImage Added

      Figure 6 : Syndeia dashboard, Repository Manager tab, Search feature (search result highlighted in red)

  6. To create a reference connection between a Collaborator item and an element in another repository, go to the Connection Manager tab, select and expand the Collaborator repository in one column and the second repository in the other. In our example in Figure 7, we have opened the Rhapsody model on the left and Collaborator on the right.

    1. Select Reference as the Connection Type in the center column.

    2. Create a reference connection by dragging an element in one column on top of an element in the other. Confirm that you want to create a reference connection. In our example, we dragged the APU block in SysML onto the Hello Syndeia 3.5 Review review in Collaborator.

...

  1. Edit the Collaborator part opened in the previous step and save a new version.

  2. In the Connection Search tab of the Syndeia dashboard, click Get All to ensure that all connections are showing. Right-click the reference connection just created and select Compare Source and Target, as in Figure 9.

    Image RemovedImage Added

    Figure 9 : Syndeia dashboard, Connection Search tab, comparing across reference connection

...