Using Managed Graphs
  • 18 Apr 2024
  • 2 Minutes to read
  • Contributors
  • Dark
    Light
  • PDF

Using Managed Graphs

  • Dark
    Light
  • PDF

Article summary

Managed Graphs provide pre-built business logic that you can use directly in your project without adding extra elements to the project. Unlike a Graph Template, when you use a Managed Graph in your project, you will just get that node and no other components.

Graph Templates are helpful if you wish to copy and extend some functionality. A Managed Graph is useful when you wish to use some functionality that someone else has defined, and they will update this functionality.

Using a Managed Graph In Your Project 

Managed Graphs are added via the Add Node to Graph menu item by either:

  • Right-clicking on the background of the graph editor and choosing Add Node to Graph from the context menu.
  • Right-clicking on an existing node and choosing Replace Node from the context menu
  • Selecting an existing node and clicking Replace Node from the sidebar.

The available Managed Graphs will appear under this window's Managed Graphs section. It is important to note that when using managed graphs, you will be able to store the return values in schema locations for other graphs to use that stored data. Still, another managed graph cannot call from the same schema location.

If you want to access a value inside a managed graph, the value must be sent in as a parameter inside.

When you hover over a Managed Graph, the Description and Change Log will be shown for that graph. This typically has instructions on how to use the graph, the inputs that should be provided, and the outputs to be expected. This information is always available when the node is in the graph and may also contain links to more complete documentation.

Managed Graph Connections

If the Managed Graph has any Connection dependencies, you will be asked to enter some new connection details or choose an existing connection from your project. 

The screen above shows that the Managed Graph requires one REST Web Service to be available. The Connection details should be completed in the usual fashion. 

Any input parameters can then be set for the node by selecting it, and setting the input in the sidebar.

If connection details were skipped on the initial configuration pop-up, or if connection details need to be updated, connections for a managed graph node can be found on the admin panel project page under connections. The connections will be in the Managed section with the naming format: 'Graph Name' > 'Template Name' > 'Connection Type'.

Managed Graph Updates

If the publisher of the Managed Graph issues an update, then the managed graph icon will show an alert icon to update you to the fact that a new version of the Managed Graph is available. Xponent does not change the Managed Graph version in any graphs - the user must accept this change into their project.

It is recommended that you run a regression test to ensure that the change has not broken anything before creating a new version and deploying it.

To upgrade to the new version, click on the alert icon.

Which will then bring up a menu highlighting all changes. Click 'Update' to confirm and upgrade, or 'Cancel' to cancel the update.

Deleting Managed Graphs

If a managed graph is deleted, the managed graph node, and every place it was used, will be deleted. It will turn any location of the managed graph used as a node into a ghost node with the name of the managed graph. Any graph with a managed graph that gets deleted will be invalid and must be fixed. 


Is it helpful? React and share your comment

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Eddy AI, facilitating knowledge discovery through conversational intelligence