Setting Up and Removing Graph Editors

This section provides details on prerequisites and on how to set up graph editors in PoolParty.

The GraphEditor feature provides a setup wizard that will guide you through all the necessary steps.

Note

The GraphEditor in PoolParty is an additional component, available with PoolParty Enterprise Server and included with PoolParty Semantic Integrator.

Graph editors are project dependent. Therefore you need at least one project ready to use in your PoolParty instance.

Prerequisites

In order to be able to use the GraphEditor feature, you will have to prepare and set up the following:

The following topics are available here:

How to Access the GraphEditors Node

This section provides a guide on how to access the GraphEditors node and functionality in PoolParty.

Note

The GraphEditor in PoolParty is an additional component, available with PoolParty Enterprise Server and included with PoolParty Semantic Integrator.

You need project editing permissions in order to be able to use the GraphEditor function, which corresponds to the PoolPartyUser role.

Steps to Access the GraphEditor Function
  1. Open an existing PoolParty project.

  2. Find the GraphEditors node at the bottom of the available nodes in the Hierarchy Tree.

  3. Expand it and find the list of available editors in the Details View on the right.

24576948.png

In order to create a graph editor, refer to this topic: How to Create a Graph Editor - Overview

How to Create a Graph Editor - Overview

In this section find the guide on how to create a graph editor.

In order to create a graph editor in PoolParty, you will use the assistant PoolParty provides and also should prepare a few things before you start.

Prerequisites for Creating a Graph Editor
  • Create a PoolParty thesaurus project.

  • Create one or more custom schemes on that PoolParty instance.

  • Check or create a configuration for a external graph database in the Semantic Middleware Configurator (SMC).

  • Plan for a URI pattern for the new graph editor, which will be used for new resources, if you create them there. The GraphEditor Assistant will suggest a pattern you can use as part of the creation process.

Steps to Create a Graph Editor Using the Assistant - Summary

Details on how to start the assistant find in this page: How to Start the PoolParty GraphEditor Assistant

After you have opened a PoolParty project, you will use the GraphEditor Assistant, the New GraphEditor dialogue, which consists of the basic steps and necessary settings to set up a graph editor. The following steps will be covered, one after another. You find details about each, the fields and settings you can change or information you need to provide in the topics of this section.

  1. Basic Information: the assistant starts out with fields to fill all the information you might need for it, a mandatory Title, optional creator's and contributor's information, or an optional description.

  2. URI Generation Method: here you will define the URI pattern used for the resources you create in the graph editor. Additionally, the separator, creation method and possible incrementation start.

  3. Pick Your Schemes: choose from the available custom schemes, which ones you want to be included in your editor.

  4. Graph Database & Instance: depending on the configuration in the SMC for external graph databases, select here which one you want to connect to. Only supported and available ones will be listed and can be selected from.

  5. Link to Graphs: the last step lets you choose from the list of available graphs and after that determine, if they are to be Look-up Graphs and which of them to make Editable Graphs.

24576951.png

Each step is covered in an individual topic, find them here:

How to Start the PoolParty GraphEditor Assistant

This section provides a short guide on how to start the GraphEditor assistant in PoolParty.

After you have accessed the GraphEditors node, follow these steps:

Steps to Start the GraphEditor Assistant
  1. Double-click the GraphEditors node or right-click it to open the context menu, select Create GraphEditor.

  2. The New GraphEditor dialogue opens, the first step visible, the Basic Information. Continue with this topic: How to Create a Graph Editor - Basic Information

24576960.png

How to Create a Graph Editor - Basic Information

This section contains a short introduction on what the first step of the GraphEditor assistant lets you do.

The Basic Information Step in the PoolParty GraphEditor
  1. After you have started the assistant, the New GraphEditor dialogue displays this initial step for the metadata information.

  2. Enter the information into the available fields, here the Title field is mandatory.

  3. Click Next to continue. Click Cancel to abort the process.

24576964.png
Available Fields

Fields with an asterisk beside their name are mandatory. The fields will be part of the RDF data and as such can also be looked up.

  • Title*(mandatory)

    Title or name of the graph editor, use a name of your choice.

  • Subject

    Provide a subject or theme the graph editor is dedicated to.

  • Description

    Enter a description of what the graph editor should do or what information it provides.

  • ContributorEnter a name or names of users contributing.

How to Create a Graph Editor - URI Generation Method

In this section find out about the URI generation method you can choose for PoolParty graph editors.

Set a URI Generation Method for a New Graph Editor
  1. In the second step, you define settings for the URI pattern.

  2. Fill out the Base URI field, using a pattern of your choice or using the suggestion from the Sample.

  3. The Increment At field will only be visible if you select INCREMENT as Method. Details about available fields find in the following paragraph.

  4. Click Next to continue or Previous to go back a step. Click Cancel on the left to abort the process.

51733691.png
Available Fields
  • Base URI* (mandatory)

    Enter the URI pattern that should be used for resources you create later using the editor itself.

    Note

    The BaseURI you enter here, will be the name of the graph PoolParty will then create on the external graph database for all data you create using the graph editor. Therefore the name should be unique.

  • Resource SeparatorThe URI's elements can be separated either by a slash or a hash. Slash is recommended, so far the hashes inside URIs have been known to cause problems with some parsers yet.

  • Method The method used to create URIs. The following are available:

    • INCREMENT: the base URI you configured will automatically be incremented for resources starting at the place defined in the Increment At field.

    • UUID: resources will be identified by a 'Universal Unique Identifier' (UUID).

    • MANUAL: this means that you would set each URI manually

  • Increment At (Only visible if you selected INCREMENT as method.)

    Enter a number used as starting point for the incrementation of URIs.

  • Sample

    Once you have entered a URI into theBase URIfield, a sample will be displayed here.

How to Create a Graph Editor - Pick Your Schemes

In this section you find a short guide on how to define the custom schemes for a PoolParty graph editor.

Define Custom Schemes for a New Graph Editor
  1. In this step, choose from the available custom schemes, which ones should be used for your graph editor, multi-select is possible.

  2. You can use the Filter field at the top of the dialogue to filter the available custom schemes via autocomplete. Activate the check box of any custom scheme you want to use.

  3. Click Next to continue or Previous to go back a step. Click Cancel to abort the process.

24576968.png
Available Functions
  • Filter

    Field at the top for filtering custom schemes. Start typing to use the autocomplete function.

How to Create a Graph Editor - Graph Database & Instance

The following section contains an overview of how to set the extremal graph database for a PoolParty graph editor.

The graphs you will edit as well as new resources you create, will be read from and written to existing graph databases. You select from these available graph databases in this step.

You will have to check or create a external graph database configuration in the Semantic Middleware Configurator (SMC) , before you can use any external graph databases here.

The graph databases available here will be the ones supported by PoolParty and connected successfully by configuring them in the SMC.

Define a External Graph Database for a New Graph Editor
  1. The Graph Database & Instance dialogue lets you choose from the available graph databases, depending on the SMC configuration.

  2. Click an entry in the list.

  3. The sub-entries will be displayed, depending on the SMCs setup, one or more entries will be visible. Click the radio button to select one.

  4. Click Next to continue or Previous to go back a step. Click Cancel to abort the process.

24576970.png

Delete a Graph Editor

This section contains a short guide on how to delete a graph editor in PoolParty.

Note

When you delete a graph editor, it means that the configuration for it will be deleted. The actual graphs on the external graph database will be retained.

Note

PoolParty will not ask you to confirm the deletion of a graph editor. Make sure you really want to delete, before following the procedure below.

In your opened graph editor, follow these steps to delete:

  1. In the Hierarchy Tree, below the GraphEditors node, find the graph editor, you want to delete.

  2. Activate it and right-click its node. From the context menu, select Delete.

    • The graph editor will be deleted right away.

51733700.png