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