Quality Management Service Description

1.0 SPECIFICATION

Introduction

Notation and Conventions

The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC2119. Domain name examples use RFC2606.

Terminology

Service Description Resource - an informational resource describing the capabilities and contextual configuration needed for a set of quality management-specific services.

Service Description Document - the representation of a Quality Management Services Resource.

Service Provider - an implementation of the OSLC Quality Management specifications as a server. OSLC QM clients consume these services

Sevice Discovery

Starting with a single entry point to a service provider {base-url}, clients will discover the (typically hierarchical) arrangement of contexts managed by the application. To support the wide range of application and project configurations, OSLC is not specifying a predetermined arrangement of these contexts. Instead, clients will be able to iterate through a group of collections (Service Provider Catalogs) until identifying a context of interest, where the client will find a QM service description document.

The figure below illustrates a simple interaction where there is only one set of choices and then configuration has been completed.

The dicovery model flow is as follows:

1. Request information from an OSLC QM based service provider: GET {url}
2. If Response is a Service Provider Catalog:
   1. An entry is selected from the Service Provider Catalog
   2. With this entry's {url}, repeat to step #1
3. If Response is a Service Description Document, then continue to next step
4. Configuration has completed

The number of iterations over the configuration choices should be set by the client application. Typical configurations should not need more than 2 levels of configuration context, so a limit of 5 is recommended.

Termination of the discovery occurs when a the client application receives an HTTP response with a Content-Type of application/x-oslc-qm-service-description-1.0+xml and the service description document as the response's content body.

Service Description Resource

A Service Description Resource is an informational resource describing a the contextual configuration needs of a service provider.

The GET method on a Service Description Resource MUST retrieve a Service Description Document. This specification only covers retrieving a Service Description Resource with GET. The behavior of POST, PUT, and DELETE methods on Service Description Resources are not covered in this specification.

Service Description Document

The Service Description Document provides configuration definitions needed by consumers of a service provider.

The Service Description Document MUST be indentified using the media type of application/x-oslc-qm-service-description-1.0+xml.

XML namespace abbreviations used in this specification:

• rdf - RDF XML namespace - http://www.w3.org/1999/02/22-rdf-syntax-ns#
• dc - The Dublin Core Metadata Terms namespace - http://purl.org/dc/terms/
• oslc_qm - The Open Services for Lifecycle Collaboration Quality Management namespace - http://open-services.net/xmlns/qm/1.0 /

Providers of this Service Description Document MAY provide additional properties in a non-OSLC namespace.

Presentable text is intended to be seen by users of the client application communicating with the provider of this service. Presentable text, as indicated in the table above, can have multiple entries per translated language supported. The language of each presentable text string will be indicated with the xml:lang attribute.

Example

<?xml version="1.0" encoding="UTF-8"?>
<oslc_qm:ServiceDescriptor 
  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:dc="http://purl.org/dc/terms/"
  xmlns:oslc_qm="http://open-services.net/xmlns/qm/1.0/" 

  rdf:about="http://example.com/qm/service-descriptor.xml">

  <dc:title>Project X</dc:title>
  <dc:description>My Product Name's OSLC QM Service Description for Project X.</dc:description>
  <dc:contributor>
    <dc:title>My Company Name, My QM Product</dc:title>
    <dc:identifier>com.mycompany.myproduct</dc:identifier>
    <oslc_qm:icon>../icons/myprod.ico</oslc_qm:icon>
  </dc:contributor>
  
  <oslc_qm:testplans version="1.0">
    <!-- Resource creation factory URL -->
    <oslc_qm:factory oslc_qm:default="true">
      <dc:title>Location for creation of test plans</dc:title>
      <oslc_qm:url>./plan</oslc_qm:url>
    </oslc_qm:factory>

    <!-- Alternate resource creation factory URL -->
    <oslc_qm:factory>
      <dc:title>Location for creation of minimal plan</dc:title>
      <oslc_qm:url>./plan?type=minimal</oslc_qm:url>
    </oslc_qm:factory>
  
    <!-- Simple GET-based URL-encoded query -->    
    <oslc_qm:simpleQuery>
      <dc:title>Simple GET-based plan Query</dc:title>
      <oslc_qm:url>./plansquery</oslc_cm:url>
    </oslc_qm:simpleQuery>

    <!-- Resource Selection Dialog -->
    <oslc_qm:selectionDialog oslc_qm:hintWidth="740px" oslc_qm:hintHeight="480px">
      <dc:title>Web Dialog for finding and selecting test plans.</dc:title>
      <oslc_qm:url>./ui/resourcePicker</oslc_qm:url>
    </oslc_qm:selectionDialog>

    <!-- Resource Creation Dialog -->
    <oslc_qm:creationDialog oslc_qm:hintWidth="600px" oslc_qm:hintHeight="320px">
      <dc:title> Web Dialog for creating test plans.</dc:title>
      <oslc_qm:label>Plan</oslc_qm:label>
      <oslc_qm:url>./ui/submitDialog</oslc_qm:url>
    </oslc_qm:creationDialog>
  </oslc_qm:testplans>

  <oslc_qm:testcases version="1.0">
    <!-- Resource creation factory URL -->
    <oslc_qm:factory oslc_qm:default="true">
      <dc:title>Location for creation of test cases</dc:title>
      <oslc_qm:url>./case</oslc_qm:url>
    </oslc_qm:factory>

    <!-- Alternate resource creation factory URL -->
    <oslc_qm:factory>
      <dc:title>Location for creation of minimal case</dc:title>
      <oslc_qm:url>./case?type=minimal</oslc_qm:url>
    </oslc_qm:factory>
  
    <!-- Simple GET-based URL-encoded query -->    
    <oslc_qm:simpleQuery>
      <dc:title>Simple GET-based case Query</dc:title>
      <oslc_qm:url>./casesquery</oslc_cm:url>
    </oslc_qm:simpleQuery>

    <!-- Resource Selection Dialog -->
    <oslc_qm:selectionDialog oslc_qm:hintWidth="740px" oslc_qm:hintHeight="480px">
      <dc:title>Web Dialog for finding and selecting test cases.</dc:title>
      <oslc_qm:url>./ui/resourcePicker</oslc_qm:url>
    </oslc_qm:selectionDialog>

    <!-- Resource Creation Dialog -->
    <oslc_qm:creationDialog oslc_qm:hintWidth="600px" oslc_qm:hintHeight="320px">
      <dc:title> Web Dialog for creating test cases.</dc:title>
      <oslc_qm:label>Plan</oslc_qm:label>
      <oslc_qm:url>./ui/submitDialog</oslc_qm:url>
    </oslc_qm:creationDialog>
  </oslc_qm:testcases>
  
</oslc_qm:ServiceDescriptor>

References

• W3C XML 1.0 - xml:lang
• Dublin Core Metadata Terms