Discovering OSLC services

OSLC Services are declared in a way that their URLs should always be discovered and not the result of string concatenations.
The only fixed URL is for the Root Services document and is https://SERVER:PORT/rest/oslc/1.0/rootservices.

Discovering the Root Services document

The Root Services document is the entry point for recursively discovering OSLC services.
This entry point does not require user authentication.

Method: GET
URL: https://SERVER:PORT/rest/oslc/1.0/rootservices
Request Headers:
- Accept: application/xml
- OSLC-Core-Version: 2.0
Response Status: the HTTP response status
Response Body: An XML stream describing the available services

<rdf:Description rdf:about="https://SERVER:PORT/rest/oslc/1.0/rootservices"
  ...
  <oslc_cm:cmServiceProviders rdf:resource="https://SERVER:PORT/rest/oslc/1.0/cm/catalog"/>
  <oslc_qm:qmServiceProviders rdf:resource="https://SERVER:PORT/rest/oslc/1.0/qm/catalog"/>
  ...
</rdf:Description>

Quality Management and Xray Support.

The Quality Management Service Provider Catalog is available only if there are Issue Types of a given scheme mapped to Quality Management resources.

Discovering the Service Provider Catalog

The Service Provider Catalog is the list of Jira projects for a given OSLC domain.

Method: GET
URL: https://SERVER:PORT/rest/oslc/1.0/cm/catalog for Change Management or https://SERVER:PORT/rest/oslc/1.0/qm/catalog for Quality Management, as defined with the <oslc_cm:cmServiceProviders> or <oslc_qm:qmServiceProviders> XML element in the Root Services document
Request Headers:
- Authorization: Jira user and password encoded as BASIC authentication
- Accept: application/xml
- OSLC-Core-Version: 2.0
Response Status: the HTTP response status
Response Body: An XML stream describing the available Service Providers, where each Service Provider represents a Jira project

<rdf:RDF>
  <oslc:ServiceProviderCatalog rdf:about="https://SERVER:PORT/rest/oslc/1.0/cm/catalog">
    <oslc:serviceProvider>
      <oslc:ServiceProvider rdf:about="https://SERVER:PORT/rest/oslc/1.0/cm/project/JIRA-PROJECT-ID>
        <dcterms:title rdf:parseType="Literal">My Project</dcterms:title>
      </oslc:ServiceProvider>
      ...
    </oslc:serviceProvider>
    ...
  </oslc:ServiceProviderCatalog>
</rdf:RDF>

<rdf:RDF>
  <oslc:ServiceProviderCatalog rdf:about="https://SERVER:PORT/rest/oslc/1.0/qm/catalog">
    <oslc:serviceProvider>
      <oslc:ServiceProvider rdf:about="https://SERVER:PORT/rest/oslc/1.0/qm/project/JIRA-PROJECT-ID>
        <dcterms:title rdf:parseType="Literal">My Project</dcterms:title>
      </oslc:ServiceProvider>
      ...
    </oslc:serviceProvider>
    ...
  </oslc:ServiceProviderCatalog>
</rdf:RDF>

Discovering Service Providers

A Service Provider is an OSLC representation of a Jira project for a given OSLC domain.
A service provider declares OSLC services, that are capabilities exposed for a Jira project. It notably enables querying and creating Jira issues using OSLC vocabulary.

Method: GET
URL: https://SERVER:PORT/rest/oslc/1.0/cm/project/JIRA-PROJECT-ID for Change Management or https://SERVER:PORT/rest/oslc/1.0/qm/project/JIRA-PROJECT-ID for Quality Management, as defined with the <oslc:ServiceProvider> XML element in the Service Provider Catalog
Request Headers:
- Authorization: Jira user and password encoded as BASIC authentication
- Accept: application/xml
- OSLC-Core-Version: 2.0
Response Status: the HTTP response status
Response Body: An XML stream describing the Service Provider

<rdf:RDF 
  ...
  <oslc:ServiceProvider rdf:about="https://SERVER:PORT/rest/oslc/1.0/cm/project/PROJECT-ID">
    ...
    <oslc:service>
      <oslc:Service>
        <oslc:domain rdf:resource="http://open-services.net/ns/cm#"/>
        <oslc:queryCapability>
          <oslc:QueryCapability>
            <oslc:queryBase rdf:resource="https://SERVER:PORT/rest/oslc/1.0/cm/issue/query/PROJECT-ID"/>
            <oslc:resourceType rdf:resource="http://open-services.net/ns/cm#ChangeRequest"/>
          </oslc:QueryCapability>
        </oslc:queryCapability>
        <oslc:creationFactory>
          <oslc:CreationFactory>
            <oslc:resourceType rdf:resource="http://open-services.net/ns/cm#ChangeRequest"/>
            <oslc:resourceShape rdf:resource="https://SERVER:PORT/rest/oslc/1.0/cm/resourceShape/PROJECT-ID/ChangeRequest"/>
            <oslc:creation rdf:resource="https://SERVER:PORT/rest/oslc/1.0/cm/PROJECT-ID/ChangeRequest"/>
          </oslc:CreationFactory>
        </oslc:creationFactory>
        ...
      </oslc:Service>
    </oslc:service>
  </rdf:Description>
</rdf:RDF>

<rdf:RDF 
  ...
  <oslc:ServiceProvider rdf:about="https://SERVER:PORT/rest/oslc/1.0/qm/project/PROJECT-ID">
    ...
    <oslc:service>
      <oslc:Service>
        <oslc:domain rdf:resource="http://open-services.net/ns/qm#"/>
        <oslc:queryCapability>
          <oslc:QueryCapability>
            <oslc:queryBase rdf:resource="https://SERVER:PORT/rest/oslc/1.0/qm/TestCase/query/PROJECT-ID"/>
            <oslc:resourceType rdf:resource="http://open-services.net/ns/qm#TestCase"/>
          </oslc:QueryCapability>
        </oslc:queryCapability>
        <oslc:creationFactory>
          <oslc:CreationFactory>
            <oslc:resourceType rdf:resource="http://open-services.net/ns/qm#TestCase"/>
            <oslc:resourceShape rdf:resource="https://SERVER:PORT/rest/oslc/1.0/qm/resourceShape/PROJECT-ID/TestCase"/>
            <oslc:creation rdf:resource="https://SERVER:PORT/rest/oslc/1.0/qm/PROJECT-ID/TestCase"/>
          </oslc:CreationFactory>
        </oslc:creationFactory>
        ...
      </oslc:Service>
    </oslc:service>
  </rdf:Description>
</rdf:RDF>