Objectives
The new learning objectives of this exercise are to create a repository connection to a Confluence repository on the Syndeia Standalone Client, view the repository including search, and create a reference connection.
Preparation
This exercise assumes the student has
...
The user can use any Confluence repository they have available. Because the content of your Confluence 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 – Confluence
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.4, Syndeia can extract and display some model information from the Confluence repository. Figure 1 shows a view of this information in the Syndeia dashboard Repository Manager with labels identifying the Confluence element types. Note the different icons. The label color coding indicates how the Confluence element type is mapped to the Syndeia Cloud element types: Repository (green), Container (red), and Artifact (blue).
...
Figure 1 Repository Manager view of Confluence repository
Exercise
Launch the Syndeia Standalone Client Dashboard (see Exercise 1.1) and open the Repository Manager tab (Figure 2).
Figure 2 Syndeia Dashboard, Repository Manager tab
If no repository connection to Confluence is available, right-click on Confluence in the left column and select Add... Complete the form and click OK (Figure 3).
Figure 3 Adding a Confluence repository connection
If a Confluence repository connection already appears under Confluence, 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).
Figure 4 Updating Confluence repository info
In the left column, select a Confluence repository connection (Confluence @ Intercax). Your repository should appear at the top of the right side. Expand it to show Spaces and Pages, as in Figure 5. See Background section for discussion of Confluence artifact types. It may be necessary to right-click the repository and select Refresh before it can be expanded.
Figure 5 Viewing Confluence repository contents on Repository Manager tab
On the right border, click the button labeled Search Repository. In the Search Repository window under New Search, select Space or Page.
If Space is selected, fill in the Title contains field and click Search.
If Page is selected, select Simple or Advanced. Under Simple, select the Confluence Space to be searched from the Select space pull-down menu (refresh menu items if necessary), fill in the Title Contains field and click Search. In our example, we entered Intercax Knowledge Base for Space and MAC for Title contains. The result(s) of the search are shown on the right, as in Figure 6.
If you select the Advanced option before searching, you may enter a query in CQL (Confluence Query Language) for the search. See Confluence documentation for a discussion of CQL.
Click outside the Search window to close it.
Figure 6 Syndeia dashboard, Repository Manager tab, Search feature (search result highlighted in red)
To create a reference connection between a Confluence item and an element in another repository, go to the Connection Manager tab, select and expand the Confluence repository in one column and the second repository in the other. In our example in Figure 7, we have opened Confluence on the left and JIRA on the right.
Select Reference as the Connection Type in the center column.
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 Intercax Knowledge Base page in Confluence onto the COURSE-1 improvement in JIRA.
Note: In Syndeia release 3.4, it is not possible to create Model Transform inter-model connections to Confluence. Some use cases of this type may be added in future releases.
Figure 7 Syndeia dashboard, Connection Manager tab, creating reference connection
Having created the reference link, we can open either the source (Confluence Intercax Knowledge Base) or target (JIRA COURSE-1) from the connection in the Connection Search tab. In Figure 8, we click Get All to load the latest connections and open the Confluence page.
Figure 8 Syndeia dashboard, Connection Search tab, opening Confluence page in browser from Syndeia connection
The reference link can be used to detect changes in the Confluence page from the Syndeia dashboard.
Edit the Confluence page opened in the previous step. Change some part of the page and publish a new version.
In the Connection Search tab of the Syndeia dashboard, click Get All to ensure that all connections are showing. Right-click the same reference connection in Figure 8 and select Compare Source and Target.
The result of the compare operation is displayed as red (Figure 9) in a difference table. The Comment field states
“Source artifact of this connection is Intercax Knowledge Base (version 2) but a newer version Intercax Knowledge Base (version 3) is available. Target artifact of this connection is COURSE-1 (version …) which is also the latest version”
Figure 9 Syndeia dashboard, Comparison Result tab
The reference connection can be updated to point to the latest version of the Confluence page by right-clicking on the connection in the Connection Search tab (Figure 8) or the Comparison Result tab (Figure 9) and selecting either Sync Source -> Target or Sync Target -> Source. The result is the same for reference connections.
...