How to Configure an Existing External Service or Jira Configuration

This section provides a guide on how to access and edit external service connection setups using the Semantic Middleware Configurator (SMC).

The following topics will guide you through the necessary steps of configuring external service configurations or a connection to a Jira system:

Access and Edit an External Services Configuration

This section contains instructions on how to access and configure an external system configuration.

  1. Access the SMC.

  2. The External Services node inside the Systems node can be expanded. In the list below that node you find all external systems PoolParty supports. Expand the Services node.

  3. Click the service's node you want to configure.

  • After you changed the settings (4), click Update to save them. Details on the available options find below.

  • Clicking Delete will delete the whole configuration.

    Note

    Clicking Delete will delete that configuration immediately, so make sure it is alright to delete.

  • To access the service you configured, expand the menu button in the top right-hand corner (5), there click its icon.

The image displays an example of the WebVOWL configuration that is available by default. The interface for SKOS Play! looks similar, the options are explained below in more detail.

23900470.png

Available Options

Note

Options that are special to a certain service are marked with an asterisk.

  • Name: enter a name of your choice for the configuration here.

  • URL: the URL at which the service (visualization in this case) can be reached online.

  • Image: the image you want to be displayed in buttons or place holders for this service. You can use external URLs for displaying images on the right-hand side of a service. Recommended resolution is 162x162 px as minimum, formats can be any that are compatible to the HTML <img>-tag.

  • Data Source: select the data source of your PoolParty project the visualization should use for data representation. The following can be selected per check box:

    • Whole Project: the project data as a whole that is base for the knowledge graph will be used, relations, concept schemes, concept subtrees, custom and core ontologies.

    • Concept Scheme or Concept Subtree: the data of concept schemes or subtrees in a project will be used as visualization basis.

    • Custom and Core Ontologies: the ontologies in your project, custom or core ontologies will be used as basis for visualization.

  • Export Type: select from the drop down between the following export types:

    • File Download: download as a file in one of the formats selected in Export Format.

    • HTTP Request: use the service in an HTTP request.

    • No Data Export: data cannot be exported.

  • Export Format: select the export format for File Download from one of the following data formats:

    • N3, NQUADS, VDEX, TRIX, BINARYRDF, MULTITHES, RDFXML, TURTLE, NTRIPLES, RDFJSON, TRIG, JSONLD

  • URL Placeholder*: this option is only available for a WebVOWL configuration. It determines the type of visualization WebVOWL will provide. For details refer to the WebVOWL documentation.

Access and Edit an Existing Jira Configuration

This section contains instructions how to access and configure an existing Jira connection configuration.

  1. After you have accessed the SMC, the External Services node inside the Systems node can be expanded.

  2. Expand the Jira node and find the Jira configuration there, in this case called 'Jira Test'.

  3. Use the fields to edit values. Details on the available options find below.

  • After you changed the settings, click Update to save them.

  • Clicking Delete will delete the whole configuration.

    Note

    Clicking Delete will delete that configuration immediately, so make sure it is alright to delete.

23900472.png

Available Options

  • Name: change the name to one of your choice for the configuration here.

  • URL: the URL at which the Jira instance can be reached online.

  • Project Key: Jira project key.

  • Number of Log Lines: Jira log file length, default value: 200 (recommended).

  • Use Credentials: activate the check box, if you want to use alternative user credentials for remote access.

    • User Name - Password: enter the values for the credentials to be used.

Delete an Existing External Services Configuration

This section describes shortly how to delete an existing external service configuration.

After you have accessed the Semantic Middleware Configurator (SMC) (1), you find the external service configurations inside the External Services node.

Four options are available to delete a configuration:

  • In the list of existing configurations in the Details View of the SMC, select the External Services tab (2). Find the configuration and click the Delete icon (3).

  • Click the External Services node, in this example below it select Services (4), on the right find the configuration and use the Delete icon (5) to delete it.

  • Access the external service. Right-click its node and from the context menu select Delete (6).

  • In the opened configuration's Details View on the right click Delete (7).

Note

Clicking Delete will delete that configuration immediately, so make sure it is alright to delete.

23900477.png
23900479.png
23900480.png

Delete an Existing Jira Configuration

This section describes shortly how to delete an existing Jira connection configuration.

After you have accessed the Semantic Middleware Configurator (SMC) (1), you find the Jira configurations inside the External Services node.

Four options are available to delete a Jira configuration:

  • In the list of existing configurations in the Details View of the SMC, select the External Services tab (2). Find the configuration and click the Delete icon (3).

  • Click the Jira node (4), in the list on the right find the configuration and use the Delete icon (5) at the end of that row to delete it.

  • Right-click the Jira configuration's node, from the context menu select Delete (6).

  • After expanding the Jira configuration's node, in the Details View on the right click Delete (7).

Note

Clicking Delete will delete that configuration immediately, so make sure it is alright to delete.

23900485.png
23900486.png
23900487.png