Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

OBJECTIVES:

The new learning objectives of this exercise are to create a repository connection to a VOLTA repository on the Syndeia Web Dashboard (SWD), view the repository including properties, relations, and search, and create a reference connection.

PREPARATION:

This exercise assumes the student has

·       Syndeia Cloud 3.5 installed with a valid user account,

·       A valid user account to a VOLTA repository, and

·       A valid user account to at least one other online repository, e.g. JIRA.

The user can use any VOLTA repository they have available.  Because the content of your VOLTA 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.

See Video 1.9 for an introduction to the Syndeia Web Dashboard.

BACKGROUND - VOLTA:

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 VOLTA repository. Figure 1 shows a tree view of this information, with labels identifying the VOLTA element types. Note the different icons. The label color coding indicates how the VOLTA element type is mapped to the Syndeia Cloud element types: Repository (green), Container (red), and Artifact (blue).

In the case of the Syndeia VOLTA integration, the Relations table (Step 7) and the Digital Thread Explorer (Step 9 onwards) can display some intra-model connection types between Artifacts, shown in Table 1, as well as inter-model connections. The intra-model connections are not permanently part of the Syndeia Cloud graph; they are extracted and displayed as needed.

This information is important in formulating and interpreting Syndeia graph queries. A more complete diagram of the VOLTA data model as it is understood by Syndeia is available through the web dashboard help menu on the left.

Table 1

VOLTA Intra-Model Relation Types

Relation Type

Artifact Types Connected

Related Model

Session → Model

Contains

Folder → Folder or File

Figure 1: Tree view of VOLTA repository

EXERCISE:

  1. Log on to the Syndeia Cloud Web Dashboard (see Video 1.9) and click on the Repositories icon on the left border (Figure 2).

Figure 2 : SWD Repositories page (initial) – Repositories icon outlined in red

2. If no repository connection to VOLTA is available, select VOLTA in the left column, then click the + icon at the top of the column. Complete the form (consult your VOLTA administrator for the property values in your organization) and click Create (Figure 3).

Figure 3 : Adding a VOLTA repository connection

3. If a VOLTA repository connection already appears under VOLTA, but you need to add your own access credentials, select the VOLTA repository and click the Gear icon at the top of the column. Complete username and password and click Update (Figure 4).

Figure 4 : Updating VOLTA repository info

4. Your repository should load. Expand it to show Projects, Models, Plans and Sessions, as in Figure 5. See Background section for discussion of VOLTA artifact types.

Figure 5 : Viewing VOLTA repository contents on Repositories page

5. On the right border, there are three icons, labeled Details, Relations and Search. Select a VOLTA element in the Tree View column (Beam_Optimization_Process_Model in our example) and click on the Details icon. A Detail list appears to the right as in Figure 6. Scroll down and review the attributes of the VOLTA element that are available to Syndeia 3.5, including name and externalKey, which is the unique version-independent identifier in the VOLTA repository. Click the Details icon again to close the list.

Figure 6 : SWD Repositories page, Details list (Details icon highlighted in red)

6. Click the Search icon on the right.

  1. In the Search window, use VOLTA Simple or VOLTA Advanced from the Select type pull down menu.

  2. From the Select item type pull down menu, select the VOLTA artifact type to be searched for. In our example in Figure 7, this is Folder.

  3. Using VOLTA Simple to Search by text, enter a text string in the Name Contains field from the name of the VOLTA folder to search for. In our example, we entered DEMO and clicked Search. The result(s) of the search are shown on the right, as in Figure 7.

  4. To Search by ID, enter a text string with the VOLTA ID in the ID field. The version-independent VOLTA ID is the same as the externalKey on the Details page (Figure 6).

  5. If you select the VOLTA Advanced option before searching, you may enter a query in VQL (VOLTA Query Language) for the search.  See VOLTA documentation for a discussion of VQL.

  6. Click the Search icon again to close the Search window.

Figure 7 : SWD Repositories page, Search feature (Search icon and search result highlighted in red)

  • No labels