Navigating the Graphmart User Interface

The top-level view of a graphmart consists of two major frames: the explorer pane on the left and the Graphmart Overview frame on the right. This topic describes the graphmart user interface elements in general. For detailed information on the Graphmart Overview tabs, see Graphmart Overview.

Using the Header Bar

• The header bar includes the controls for switching the graphmart modes (Design/Deploy/Deactivate), loading preview data versus all data in the Design mode, and reloading all graphmart layers.

  

  The menu () on the right-hand side of the bar provides access to the Profile Data, Find Connections, Export, Add to Migration Package, Version, and Sharing features. Note that Sharing allows setting access control on the graphmart's configuration, not permissions controlling data access within the graphmart.

  The header bar also serves as a status bar providing notifications of errors during reloading or refreshing. The version of that the graphmart is connected to is shown in the middle (for example, AGL 3.2).

Using the Explorer Pane

• The explorer pane on the left-hand side shows the graphmart components in a tree structure, where the graphmart item is at the top, and its components - data layers, steps, ontology models, exports, dashboards, queries, and connections - are underneath it. Click the arrows to the left of the components in the explorer pane to expand them and work with the items underneath. As you traverse the tree and click the components and their sub-items, the composite frame on the right shows the relevant views for the selected item

  For example, the following composite frame is displayed when an ontology model is selected:

  

• Use the Search bar to quickly find graphmart objects whose name contains a specific string.

• Use the Add menu to the right of the Search bar to add a new source or transformation layer, a new endpoint or query.

• Where applicable, the slider control to the right of the items allows you to enable or disable them. For example, use sliders to enable or disable individual steps underneath the layers in the explorer pane:

  

• The menu icon () to the right of each item provides access to the context menu for this item type. The context menus for each level are

  

• Expand the Exports item to view your Data on demand endpoints (OData REST endpoints),

• Expand Dashboards to see references to any of the Hi-Res Analytics Dashboards that point to this graphmart, You can also create dashboards from this view.

• Queries can be saved into the graphmart as a set of shared queries for that graphmart. Click the Queries item to see a filtered-down view of the query audit log for this graphmart (Graph Lakehouse connection).

• Expand the Connections item to view the graphmart's source database connections and File Staging areas. The database connection view allows you to change the database connection settings and test the connection.

Managing Changes to a Graphmart

Once a grapmart is created, you can refine it and make changes to any of its elements/components. Graph Studio provides two ways to manage changes to a graphmart.

• Undo and Redo buttons are provided in the header bar of all graphmart components to enable changes made to a graphmart and its components (e.g., data layers, ontologies, exports, etc.) to be undone and redone, respectively. These controls provide a more granular approach to managing changes, allowing you to revert them one by one at the point they are made.

• When editing any graphmart component, pills display at the bottom of the screen to identify what entity in the graphmart has changed.

Clicking View Changes to the right of these pills launches a dialog that displays the changes that have been done to the graphmart after it was last saved. This feature is especially helpful in managing numerous changes as it gives you detailed information on what the change is and where it was done.

The dialog features a search bar that allows you to search for a specific change. To the right of this search bar are the Expand All and Collapse All buttons—these buttons will allow you to display and hide, respectively, all of the changes you have done to your graphmart.

Changes written in green represent new values, whereas those written in red represent old/previous values.

Clicking the Undo button to the right of a change removes this change from the list (i.e., reverses the change in the graphmart).

If you wish to redo the change, simply close the dialog by clicking the Close button, return to the graphmart editor, and undo the change in the graphmart.

Note that once all changes are accepted and saved, the pills at the bottom of the screen disappear and any previous changes can no longer be viewed.