Versions Compared

Key

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

The Global Graph Queries capability in the Syndeia Web Dashboard makes it possible for users to perform sophisticated formulate and run complex graph queries on the digital thread data managed by Syndeia Cloud.

(1) To get started, watch the demonstration videos in the tutorials available here: Part 19 - Syndeia Cloud Graph Analysis

(2) Read the API Overview document available here API - Overview to learn about the Syndeia domain model that provides the schema for the digital thread managed by Syndeia Cloud.

(3) Click on the Graph Queries icon in the main menu of the Syndeia Web Dashboard.

...

(4digital threads. This capability is accessible from the Graph Queries menu in the main menu bar, as shown in Figure 1 below.

...

Privileges

Status
colourPurple
titleNew in 3.6

(1) The Global Graph Queries capability presented here is an admin level capability to run graph queries across ALL Digital Thread Projects in a Syndeia Cloud deployment. Hence, Syndeia users will need a special Global Permission (GLOBAL_GRAPH_QUERY) to access this capability. Refer to Global Privileges to learn more.

(2) All Syndeia end-users should use the Query Library capability available in Digital Thread Project Dashboard to manage and execute Gremlin graph queries for their Digital Thread Projects. Refer to Queries - Digital Thread Project to learn more.

Info

Syndeia admins should ONLY assign GLOBAL_GRAPH_QUERY permission to admins or advanced users who are overseeing ALL Digital Thread Projects on the given Syndeia Cloud deployment. For all Syndeia end-users, the Query Library capability in the Digital Thread Project Dashboard should be used.

General Operation

(1) Refer to the Digital Thread Projects page in this guide and the API - Overview section in the Syndeia Web Dashboard to learn about the Syndeia Cloud domain model.

(2) Select the Graph Queries menu in the main menu bar, as shown in Figure 1 above.

(3) You can formulate queries using the Query Builder or the Raw Query approach as demonstrated in the tutorials - Part 19 - Syndeia Cloud Graph Analysis.

The Raw Query approach allows users to write sophisticated expressive graph queries using the widely popular Gremlin query and traversal language, which is part of the Apache Tinkerpop stack.

(54) Query results can be viewed in three different ways:

  • Graph View with color coding corresponding to the Repository Types (e.g. JIRAJIra, Jama Connect, Aras InnovatorTeamcenter, GitHub), as shown belowin Figure 1 above.

  • Table View

  • JSON View

...

(65) If you right-click on any node Artifact in the graph view, and select More details, Syndeia Cloud will take you to the native repository of that artifact. As shown below, if a user right-clicks on a JIRA artiact resulting from a graph query and selects More details, Syndeia Cloud will open the JIRA page for that issue (RHS).

...

The graph query capability is also available via the POST /graph/query/raw endpoint in the Syndeia Cloud REST API.

...

Web Dashboard will launch a browser tab/window to show the selected artifact in the external repository, if applicable. Figure 2 shows an example of this operation for a Teamcenter artifact (Item) opened in Active Workspace.

...

Tutorials

Refer to the following tutorials to learn more.