Cypher Linking

You can link one or more Cypher statements to each Scenario. This completes the full development lifecycle by linking an executable Cypher query against the specific question or scenario.

There are icons that depict if a Scenario has associated Cypher statments and also an overall status of linking across the Scenario Set:

  • Scenario Set Bar status: Below the AppBar is the Scenario Set Bar. On the far right is an indicator that consists of parentheses with an icon. It looks like this: (1/2) (icon).

    • The left number is the number of Scenarios with attached Cypher statements.

    • The right number is the total number of Scenarios.

    • If every Scenario has an associated Cypher statement, the icon is a green checkmark. Otherwise it is a blue circle. The blue circle is a soft indicator to indicate that not every scenario has an associated Cypher statement yet.

  • Scenario Accordion Bar status: In the Accordion Bar for each Scenario, there is an icon that indicates whether the scenario has associated Cypher statements or not. If it does, a green checkmark is used. Otherwise a blue circle.

Hovering over the icons will show a tooltip.

Linking Cypher statements

Use the </> button to bring up the Cypher selection dialog. The dialog provides a search area where you can search for Cypher statements by title or by tokens within the Cypher statement. A token is a word in a Cypher statement such as a variable, Node Label, Relationship Type, property name, or function. Cypher statements built from Cypher Builder or contained in a Cypher Suite are available for selection. Click on the desired Cypher statement to associate it. It is possible to associate more than one Cypher statement to a scenario.

Once a Cypher statement is linked a table will appear below the Scenario. The table headers are:

  • Valid?: Only shown if validation is run, otherwise it is hidden.

  • Title: The Cypher statement title.

  • Visual?: If Yes, indicates the query was built with the Cypher Builder, otherwise it is a query from a Cypher Suite.

  • Cypher: Shows the Cypher statement. Longer Cypher statements may have their display truncated. If so, click on the Show More…​ button to show the full Cypher.

  • Actions: Icons that allow for editing and removing the association.

Note on searching: The first 512 characters of a Cypher statement are used to provide search capability. The non-word characters such as parenthesis, colons, and brackets are stripped out leaving just the tokens. These tokens are used by a Neo4j full text index to power the search capability.

Editing Cypher statements

Under Actions to the right of the Cypher statement is a pencil icon. Click on the pencil to launch the appropriate editing tool for the Cypher statement. A query marked as Visual will launch Cypher Builder, otherwise the Cypher Suite is launched.

Removing Associated Cypher statements

Under Actions to the right of the Cypher statement is a trash icon. Click on the trash icon to remove the associated Cypher statement. Clicking on the trash icon does not remove the Cypher statement from Cypher Builder or a Cypher Suite, it only removes the association to the scenario.