...
· Syndeia Cloud 3.5 or later installed with a valid user account, and
...
See the tutorials under Syndeia Cloud Web-Dashboard/Part 19 – Syndeia Cloud Graph Analysis for an overview of this feature.
Update for Syndeia Cloud 3.6 – This exercise assumes that the user has been assigned Global Graph Query permission by the Syndeia Cloud administrator in order to access the Graph Queries page. Screenshots in this tutorial were taken from an earlier release; the icons on the left margin of the figures and the graphical display format of query results have been modified but the instructions are otherwise unchanged.
Background - Syndeia Cloud Data Model:
...
It is also important to understand the limitations of graph queries with respect to VOLTA repositories. As of Syndeia 3.6, graph queries cannot extract the internal structure of a VOLTA repository, i.e. they cannot be used to obtain the full structure of the VOLTA repository or internal (intra-model) relations between VOLTA artifacts. In this way, graph queries are different than the Tree View or Graph View (Digital Thread Explorer) capabilities of the Repositories page in the Syndeia Web Dashboard. Graph queries are most useful in viewing inter-model connections from VOLTA elements to other repositories.
Exercise:
Log on to the Syndeia Cloud Web Dashboard (see Video 1.
...
2) and click on the Graph Queries icon on the left border.
The first task is to compile a list of VOLTA Artifacts of a specific type. Per Figure 1, ArtifactTypes are owned by (specific to) a Repository. We typically want to begin by creating a list of Artifact types available in such a Repository.
If we use Query Builder (Figure 3), we select ArtifactType from the pull-down menu under Label.
...
Figure 3 : Graph Queries page (icon outlined in red) – Query Builder
To restrict the list of ArtifactTypes to our current VOLTA repository, we click Filters. We will filter by the name of our Repository, so we select Repository from the pull-down menu at the top marked Property of. Under Property Key, we select the Name property and under Property Value, we enter VOLTA @ Intercax. We then click the Plus (+) button to add the filter in the bottom list and the window should look similar to Figure 4. Click Close.
Figure 4 : Query Builder Filters window
Back on the Graph Queries page, click Run. The results, a list of all ArtifactTypes in VOLTA @ Intercax, may be displayed in table form as in Figure 5. Key ArtifactType properties in the table are Name and Key because we will use these in the next search. Click the Exports icon to export the list as a CSV file for future reference, if desired.
Note: only VOLTA artifact types actually present in the Syndeia graph will appear in this list, i.e. there must be at least one example of the artifact type connected to another domain by an inter-model connection in order for it to make the list.
...
5. The final part of the first task is to generate a list of all Artifacts of type Session within the VOLTA @ Intercax Repository. Note that Syndeia will return only those VOLTA Parts that are connected within the Syndeia Cloud graph or own elements that are connected within the Syndeia Cloud graph, not all Sessions in the repository.
We can search by ArtifactType Name (“Session”) or Key (ART-TYPE564), which we got from the table in Figure 5. Generally, it is better to search by Key, which is unique within the Syndeia Cloud database, rather than Name, which is not unique.
If we use Query Builder, we select Artifact from the pull-down menu under Label, as in Figure 6.
Figure 6 : Query Builder, Artifact search
To restrict the list of Artifacts to the VOLTA Requirement type, we click Filters. We will filter by the ArtifactType Key, so we select ArtifactType from the pull-down menu at the top marked Property of. Under Property Key, we select the sKey property and under Property Value, we enter ART-TYPE564, which we took from the table in Figure 5. After we click the Plus (+) icon, the Filters window should look like Figure 7. Click Close.
Figure 7 : Query Builder Filters window, filter by Artifact Type sKey
6. Back on the Graph Queries page, click Run. The results, a list of all Artifacts of type ART-TYPE564, which is owned by the repository VOLTA @ Intercax, may be displayed in table form as in Figure 8. Click the Exports icon to export the list as a CSV file for future reference, if desired.
...
9. We will begin by creating a list of Containers available in the Syndeia Repository.
If we use Query Builder (Figure 9), we select Container from the pull-down menu under Label.
Figure 9
...
: Graph Queries page (icon outlined in red) – Query Builder
To restrict the list of Containers to the Syndeia repository, we click Filters. We will filter by the name of our Repository, so we select Repository from the pull-down menu at the top marked Property of. Under Property Key, we select the Name property and under Property Value, we enter Syndeia Repository. We then click the Plus (+) button to add the filter in the bottom list and the window should look similar to Figure 10. Click Close.
...
Figure 10 : Query Builder Filters window
...
12. The next part of the second task is to generate a list of all Relations within a specific Syndeia Project.
We can search by Container Name (“Dirk Sandbox 26”) or Key (DZSB26), which we got from the table in Figure 11. Generally, it is better to search by Key, which is unique within the Syndeia Cloud database, rather than Name, which is not unique.
If we use Query Builder, we select Relation from the pull-down menu under Label, as in Figure 12. Remember, the Syndeia Projects contain relations, not artifacts.
...
Figure 12 : Query Builder, Artifact search
To restrict the list of Relations to a specific Syndeia Project, we click Filters. We will filter by the Container Key, so we select Container from the pull-down menu at the top marked Property of. Under Property Key, we select the sKey property and under Property Value, we enter DZSB26, which we took from the table in Figure 11. After we click the Plus (+) icon, the Filters window should look like Figure 13. Click Close.
...
Figure 13 : Query Builder Filters window, filter by Container sKey
13. Back on the Graph Queries page, click Run. The results, a list of all Relations in Container DZSB26, which is owned by the Syndeia Repository, may be displayed in graph form as in Figure 14. Note that all relations within the project appear, not just those with a VOLTA artifact at one end.
...