Creating a Query-Based Graph View Definition

Query based GVDs enable users to view items, relationships, and data that are explicitly defined within a Query Definition. This can be useful when there is a need to filter or focus the user’s interaction on specific items and details.

Before creating a Query-based Graph View Definition, you must first create the Query Definition. For information on how to create a Query Definition, refer to the Query Builder Guide. Specifically, Section 2 walks you through creating a sample Query Definition. Use a carefully configured Query Definition to automatically generate the necessary underlying items for the Graph View Definition.

Use the following procedure to create a Query Based Graph View Definition:

1. Create a Query Definition using the Query Builder Application.
2. Create a new Graph View Definition item, specifying a unique Name and selecting the desired Query Definition.

Figure 8.

3. Save the Graph View Definition. The following popup dialog appears:

Figure 9.

4. Clicking the generate button runs a method that generates all underlying ItemTypes and Relationships and maps them to the query items of the Query Definition. If you select the Treat Relationship As Connector option, all relationships in the Query Definition are treated as connectors. Otherwise, each relationship is drawn as a separate node and connectors will be implicit. If you select the Generate View Cards For Each Query Item a unique view card is generated for each Query Item and added as a GVD Default View Card. The generated view cards will have a row for each property selected for the Query Item in the Query Definition.
5. In the Default View Cards Relationship Tab, you may associate ItemTypes in the Graph View with specific View Cards. Click on the New Relationship icon to pick a View Card. Then select the ItemType to associate the View Card with in the ItemType ID cell..
6. In the Nodes Relationship Tab you can view and edit generated Node Types which are associated with the respective Query Item. Click on a Node Type to be directed to the Node Type Form. You may also associate an existing Node View Definition to a specific Node within the relationship tab.

Figure 10.

7. From a Node Type Form, you may add, remove, or edit Node Type Properties. The Name of a property is used to bind data to a View Card. See Section View Card Template for an example of a View Card that uses the content_binding attribute to refer to Node Type content. The Value Template is used to define the content to display. The Value Template supports both static and generated content. In Figure 11, observe that both name and state use Value Templates which refer to static and generated data.

Figure 11.

8. If desired, repeat Steps 6 and 7 for the generated connectors and Connector Types found in the Connectors Relationship Tab.