Estabilishing and Managing Digital Product Traceability > Windchill RV&S > Establishing Digital Product Traceability between Windchill RV&S 12.3.0.0 and other products > Adding a New OSLC Server
Adding a New OSLC Server
The OSLC Client can discover OSLC resources provided by the OSLC Server and the Windchill OSLC Server. To access these resources, the server administrator must add the OSLC Server and the Windchill OSLC Server.
To add the supported OSLC servers, edit the OslcServers.xml file located in <Windchill RV&S installdir>/data/oslc.
Edit the following properties in the OslcServers.xml file:
Property
Description
ServerID
ID of the OSLC server.
* 
Specify unique names for IDs of the OSLC servers.
* 
The ID of the OSLC server must not change once OSLC links are created using the same OSLC server.
ServerType
Type of OSLC server.
Supported OSLC server types are:
• INTEGRITY_MODELER
• WINDCHILL
• WRVS
* 
The server types are case-sensitive. Do not modify the server types.
RootCatalogURI
URI of the base catalog.
The URI must contain the fully qualified domain name of the host.
AuthenticationURI
URI for the OSLC Server authentication.
This property is required only for the BEARER_TOKEN authentication scheme.
AuthenticationScheme
Supported authentication scheme.
The supported authentication scheme for the OSLC Server is BEARER_TOKEN.
The supported authentication scheme for the Windchill OSLC Server is BASIC.
The supported authentication schemes for the OSLC Server are:
• BASIC
• ISAM
For more information on the support for client-side certificate-based authentication using IBM Security Access Manager (ISAM), see Server for IBM Security Access Manager and the OSLC Server guide.
* 
The OSLC client users need to provide their login credentials when requested by the OSLC Server, the Windchill OSLC Server, or the OSLC Server.
Domains
URI of the domains supported by the target OSLC server.
Supported domains and the corresponding URIs are as follows:
• Requirements Management domain: http://open-services.net/ns/rm#
• Architecture Management domain: http://open-services.net/ns/am#
• Configuration Management domain: http://open-services.net/ns/config#
The OSLC Server provides support for the Requirements Management domain and Architecture Management domain.
The Windchill OSLC Server provides support for the Configuration Management domain.
The OSLC Server provides support for the Requirements Management domain.
Parameters
Multiple parameters are supported.
Each parameter should contain the following three attributes for the OSLC Server and the Windchill OSLC Server:
• resourceType (corresponding to the specified domain)
The resource type supported by the OSLC Server for the Requirements Management domain is:
◦ http://open-services.net/ns/rm#requirement
The resource type supported by the OSLC Server for the Architecture Management domain is:
◦ http://open-services.net/ns/am#resource
The resource types supported by the Windchill OSLC Server for the Configuration Management domain are:
◦ http://open-services.net/ns/config#VersionResource
◦ http://open-services.net/ns/config#Component
• selectAttributes
The values for this attribute define the columns that appear in the query result when you query for the exposed OSLC fields provided by the supported OSLC servers.
For the Windchill OSLC Server, the sample values for the selectAttributes attribute are as follows:
“dcterms:title,oslc:shortId,oslc_config:versionId”
For the OSLC Server, the sample values for the selectAttributes attributes are as follows:
“dcterms:title,dcterms:modified”
• whereAttributes
The values for this attribute define the available filters that you can use for querying exposed OSLC fields provided by the Windchill OSLC Server.
For the Windchill OSLC Server, the sample values for the whereAttributes attribute are as follows:
“dcterms:title,oslc:shortId”
* 
The OSLC Client supports the OSLC fields mentioned in the OSLC Core Specification for the selectAttributes and whereAttributes attributes. For the supported OSLC fields exposed by the OSLC Server and the Windchill OSLC Server, see the product documentation for and Windchill in the PTC eSupport Portal at https://www.ptc.com/en/support.
For the OSLC Server, specify the resourceType parameter only.
* 
The OSLC Server provides delegated UI for resource selection and query capabilities for requirement and requirement document resources of .OSLC Server.
The resource types supported by the OSLC Server for the Requirements Management domain are:
• http://open-services.net/ns/rm#Requirement
• http://open-services.net/ns/rm#RequiremenCollection
The requirements-domain-mapping.json mapping file contains the values for the where and select attributes under requirementCollectionsQuery or requirementsQuery for the query property. For more information on the requirements-domain-mapping.json file, see the Windchill RV&S OSLC Server guide.
Properties
The following properties are supported:
• coreVersion
Version of the supported OSLC specification.
The OSLC Server supports OSLC Core Version 2.0 specification.
The Windchill OSLC Server and OSLC Server support OSLC Core Version 3.0 specification.
• modelerServerNameDecode
Resolves the name of the Server in the query URI.
Default value is false.
* 
For OSLC Server 9.1, set the value of the modelerServerNameDecode property to true.
IsamHostURI
Virtual host URI of the OSLC Server configured on the ISAM virtual host junction. For example, https://host1.ptc.com:4444.
* 
This property is applicable only if the OSLC Server is configured with the ISAM authentication scheme.
After editing the OslcServers.xml file, restart the server. Any edits to the OslcServers.xml file requires restart of the server for changes to take effect.
* 
• The OSLC Server does not support creation of OSLC links between the same server from which the OSLC requests are initiated.
• Updates to the OslcServers.xml file in the older releases are not retained after upgrading to the 12.3.0.0 release. Administrators must take the backup of the OslcServers.xml file before upgrading to the 12.3.0.0 release. After upgrading, administrators must restore the updates in the OslcServers.xml file.
• Ensure that the OslcServers.xml file is configured correctly for the supported OSLC servers. If OSLC servers are configured incorrectly, DocStudio displays an error when you connect to the OSLC servers.
• Ensure that the OSLC Client and the supported OSLC servers are part of the same domain.