Linked Data Applications

This topic covers how to configure external Linked Data applications to work with Polarion.

Polarion's external Linked Data support lets users link to objects from other tools, like Teamcenter.

The Linked Data can be used to:

(This is usually done by creating or selecting a remote object in a "delegated UI" provided by the external Linked Data application.)

Administrators can define linking rules in the Linked Data Semantics and Linked Data Mapping configuration sections.

Example:

  1. A user selects a Requirement Work Item that is considered a "rm:Requirement" according to the Linked Data Mapping configuration.

  2. They select the "is implemented by" link role, as the backlink for the "implements" role.

  3. The "implements" role is mapped to "cm:implementsRequirement" based on the "Linked Data Mapping" configuration.

  4. The reverse for that is "rm:implementedBy" based on the "Linked Data Semantics" configuration.

  5. The Linked Data link type "rm:implementedBy" can be used from "rm:Requirement" to "cm:ChageRequest" according to the "Linked Data Semantics" configuration.

    (So only dialogs that can be used to select cm:ChangeRequest remote objects are shown.)

  6. After a user selects a cm:ChangeRequest the available link roles are also filtered so that only those valid for use with "rm:Requirement" and "cm:ChageRequest" are displayed.

Once and "Linked Data Friend is added", and "a Linked Data Association" is established, an icon appears in the Linked Work Items section of a Polarion Work Item.

Users can then Link Items to and from external Linked Data applications.

Add Server as a "Friend"

  1. As an Administrator, click on the top left of the Navigation Bar.

  2. Click Administration.

  3. Click Global Administration.

  4. Click on the Linked Data topic on the Navigation Bar.

  5. Click on the Linked Data Friends sub-topic.

  6. Click .

  7. The dialog below appears.

  8. Enter the following information and click NEXT .

    • URI: <OSLC Server URL>/lis/oslc/rootservices

    • Name: Enter a name that will help you to identify your external Linked Data server,

    • OAuth Secret: Enter any random text.

      This OAuth file is secure and only available for authorized users. (The @admin group by default.)

  9. A pop-up dialog appears with the login screen of the external Linked Data application.

  10. Log into the external Linked Data application

  11. Authorize Polarion as a "Friend" of the external Linked Data application:

    1. Name: Enter the URL of the Polarion server that you want to add as a friend.

    2. Tick the box.

    3. Click Allow .

  12. Now it's time to enable the linking of Polarion Work Items with the external Linked Data application's items.

Enable Item Linking

Once an external Linked Data application and Polarion are configured to communicate with each other, an association between the two must be created before being able to link items back and forth.

  1. Select a target Project and enter the Project level Administration.

  2. ( Administration Linked Data Linked Data Associations.)

  3. Click and select the external Linked Data server to connect to the selected Polarion Project

    Note

    If connecting to SIEMENS' Teamcenter for the first time of a session, an additional pop-up will open with the Active Workspace login.

    Enter your Teamcenter Credentials.

  4. Select the external Linked Data services to associate Polarion with.

    • Select Change Management if you want to link to Teamcenter items specific to Change Management (for Example: PR, ECR, ECN).

    • Select Core Services if you want to create generic links to any Teamcenter item type.

    • Select Embedded Software Management if you want to link a release in Polarion to Teamcenter.

    • Select Requirements Management if you want to link to Teamcenter requirements.

    TIP

    Select all to have access to all the integration functions.

  5. Click Add .

  6. An association between the external Linked Data application and Polarion is made.

  7. Items can now be linked between Polarion and the External Linked Data application

Configure Linked Data Mapping

Linked Data Mapping is used to map custom Work Item and link types to semantic types defined in Linked Data Semantics.

Linked Data Mapping can be defined on both the Global and Project levels.

Note

Project level Linked Data Mapping overrides Global Level Linked Data Mapping for the targeted project.

Project Level:

(Select Project Administration Linked Data Linked Data Mapping)

Global Level:

(Select Project Administration Global Administration Linked Data Linked Data Mapping).

There administrators can:

  • Map Work Item Types to Linked Data types.

  • Map Link Roles to Linked Data link types.

Configure Linked Data Semantics

Linked Data Semantics are defined on the Global Administration level and are described on the Linked Data Semantics Administration page:

(Select Project Administration Global Administration Linked Data Linked Data Semantics)

There administrators can:

  • Determine linking rules based on semantic Linked Data types.

  • Define how backlinks are created.

  • Define the relationship between Linked Data domains and semantic types.

  • Define prefixes used in the Linked Data Semantic and Mapping configurations.

Important!

When adjusting the configuration in Linked Data Semantics it is essential to make sure that the external Linked Data application understands the adjusted semantics.

Adding a custom resource or link type will not work if the external application does not understand the configured custom types.

(Polarion's default configuration only maps the default Work Item Types.)

See the Semantic configuration page to categorize custom Work Item types as a "Change Request" or "Requirement".