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:
Linked Data consumers can connect to Polarion using the following rootservice URL:
(Polarion provides the OSLC RM and CM domain that enables Linked Data consumers to link to Polarion. Delegated UIs are provided.)
Link Polarion Work Items to objects that reside on external Linked Data enabled tools. (Act as an Linked Data provider.)
(This is usually done by creating or selecting a remote object in a "delegated UI" provided by the external Linked Data application.)
A user selects a Requirement Work Item that is considered a "
rm:Requirement" according to the Linked Data Mapping configuration.
They select the "is implemented by" link role, as the backlink for the "implements" role.
The "implements" role is mapped to "
cm:implementsRequirement" based on the "Linked Data Mapping" configuration.
The reverse for that is "
rm:implementedBy" based on the "Linked Data Semantics" configuration.
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.)
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.
Users can then Link Items to and from external Linked Data applications.
As an Administrator, click on the top left of the Navigation Bar.
Click Global Administration.
Click on the Linked Data topic on the Navigation Bar.
Click on the Linked Data Friends sub-topic.
The dialog below appears.
Enter the following information and click.
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.)
A pop-up dialog appears with the login screen of the external Linked Data application.
Log into the external Linked Data application
Authorize Polarion as a "Friend" of the external Linked Data application:
Name: Enter the URL of the Polarion server that you want to add as a friend.
Tick the box.
Now it's time to enable the linking of Polarion Work Items with the external Linked Data application's items.
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.
Select a target Project and enter the Project level Administration.
( Administration Linked Data Linked Data Associations.)
Click and select the external Linked Data server to connect to the selected Polarion Project
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.
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.
Select all to have access to all the integration functions.
An association between the external Linked Data application and Polarion is made.
Items can now be linked between Polarion and the External Linked Data application
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.
Project level Linked Data Mapping overrides Global Level Linked Data Mapping for the targeted project.
(Select Project Administration Linked Data Linked Data Mapping)
(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.
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.
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".