RDF-in/RDF-out (RIRO) Service Descriptions

This Version: http://purl.org/vocab/riro/sdl [HTML] [OWL]
Latest Version: http://purl.org/vocab/riro/sdl#
Authors: Sergei Egorov <esl@ariadnegenomics.com>
Contributors

This work is licensed under a Creative Commons License.

Introduction
Namespace
Summary of Terms
Vocabulary Classes
Vocabulary Properties
Examples
RDF Schema
License

Introduction

This vocabulary defines terms used to describe RIRO services. A RIRO service is characterised by its connection point, its command name and description, its input pattern, and its output template. RIRO Service Description contains all the information needed to use the service.

The description is built as a set of properties of the connection point resource (a node which URI is the URL of the service).

Input patterns and output templates are described using the accompanying RDF Graph Patterns and Templates vocabulary (http://purl.org/vocab/riro/gpt).

Changes From Previous Version

2006-03-05 - semantic change by Sergei Egorov: "First version"

Namespace

The URI for this vocabulary is

http://purl.org/vocab/riro/sdl#

When used in XML documents the suggested prefix is sdl

Each class or property in the vocabulary has a URI constructed by appending a term name to the vocabulary URI. For example:

http://purl.org/vocab/riro/sdl#commandName http://purl.org/vocab/riro/sdl#RIROService

The term name for a class always starts with an uppercase character. Where the term name is comprised of multiple concatenated words, the leading character of each word will be an uppercase character. For example:

RIROService

The term name for a property always starts with an lowercase character. Where the term name is comprised of multiple concatenated words, the leading character of the second and each subsequent word will be an uppercase character. For example:

commandName commandDescription

Summary of Terms

This vocabulary defines one class and 6 properties .

Term Name	Type	Definition
RIROService	class	A RDF-in/RDF-out (RIRO) Service.
commandName	property	The name of the command to invoke the service.
commandDescription	property	The description of the command to invoke the service.
fileUnder	property	The category/subcategory of the command to invoke the service.
inputPattern	property	The pattern matching proper input graphs.
outputTemplate	property	The template for output graphs produced by the service.
method	property	Query method ('get' or 'post').

Vocabulary Classes

Class: RIROService

Definition: A RDF-in/RDF-out (RIRO) Service.

A member of this class is a service supporting the RIRO protocol. As a rule, a member of this class is assigned a URI; if so, the URI is interpreted as URL of the service's connection point.

URI:	http://purl.org/vocab/riro/sdl#RIROService
Label:	RIRO Service
Subclass of	(a composite term, see schema)

History

2006-03-05 - first issued
2006-03-05 - editorial change by Sergei Egorov: "Added comment"

Vocabulary Properties

Property: commandName

Definition: [The value of this property is] The name of the command to invoke the service.

Please supply short and descriptive name, suitable for use in menus, command lists etc. Recommended length is 10-40 characters.

Example: 'Resolve LSRN to Record, URLs'.

This property is required.

URI:	http://purl.org/vocab/riro/sdl#commandName
Label:	command name
Domain	sdl:RIROService
Range	xsd:string

History

2006-03-05 - first issued

Property: commandDescription

Definition: [The value of this property is] The description of the command to invoke the service.

Please keep the description brief - no longer than 25-30 words. The description should be suitable for use in tooltips, help texts etc.

URI:	http://purl.org/vocab/riro/sdl#commandDescription
Label:	command description
Domain	sdl:RIROService
Range	xsd:string

History

2006-03-05 - first issued

Property: fileUnder

Definition: [The value of this property is] The category/subcategory of the command to invoke the service.

This property allows one to group related services together. The format of the property is category/subcategory/subsubcategory/..., similar to the convention used in the Open Directory Project (dmoz.org). Category names should follow the conventions for command names (10-40 characters, capitalized).

Example: 'Related/Journal Articles'

URI:	http://purl.org/vocab/riro/sdl#fileUnder
Label:	file under
Domain	sdl:RIROService
Range	xsd:string

History

2006-03-05 - first issued

Property: inputPattern

Definition: [The value of this property is] The pattern matching proper input graphs.

Graph patterns should be expressed via the RDF Graph Patterns and Templates vocabulary (http://purl.org/vocab/riro/gpt).

This property is required.

URI:	http://purl.org/vocab/riro/sdl#inputPattern
Label:	input pattern
Domain	sdl:RIROService
Range	rdfs:Resource

History

2006-03-06 - first issued

Property: outputTemplate

Definition: [The value of this property is] The template for output graphs produced by the service.

Graph patterns should be expressed via the RDF Graph Patterns and Templates vocabulary (http://purl.org/vocab/riro/gpt).

The input pattern and output template can share blank nodes. In real calls, the query and the reply graph will also share corresponding blank nodes by reusing nodeIDs; the reply is considered to be in the same nodeID namespace as the query.

This property is required.

URI:	http://purl.org/vocab/riro/sdl#outputTemplate
Label:	output template
Domain	sdl:RIROService
Range	rdfs:Resource

History

2006-03-06 - first issued

Property: method

Definition: [The value of this property is] Query method ('get' or 'post').

If the query method is 'get', the service is assumed to be idempotent (the query will have no side effects).

This property is required.

URI:	http://purl.org/vocab/riro/sdl#method
Label:	HTTP method
Domain	sdl:RIROService
Range	"get", "post"

History

2006-03-06 - first issued

Examples

sdl-example.rdf

sdl-example.ttl

RDF Schema

The schema included here is informational only. The normative schema can be found at http://purl.org/vocab/riro/sdl.rdf

<rdf:RDF
   xmlns:gpt="http://purl.org/vocab/riro/gpt#"
   xmlns:sdl="http://purl.org/vocab/riro/sdl#"
   xmlns:skos="http://www.w3.org/2004/02/skos/core#"
   xmlns:vann="http://purl.org/vocab/vann/"
   xmlns:cc="http://web.resource.org/cc/"
   xmlns:dctype="http://purl.org/dc/dcmitype/"
   xmlns:dct="http://purl.org/dc/terms/"
   xmlns:dc="http://purl.org/dc/elements/1.1/"
   xmlns:owl="http://www.w3.org/2002/07/owl#"
   xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" 
   xml:base="http://purl.org/vocab/riro/sdl">
  
  <owl:Ontology
     rdf:about=""
     dc:date="2006-02-21">
    <dc:title xml:lang="en">RDF-in/RDF-out (RIRO) Service Descriptions</dc:title>
    <rdfs:comment xml:lang="en">
      This vocabulary defines terms used to describe RIRO services. A RIRO 
      service is characterised by its connection point, its command name and 
      description, its input pattern, and its output template. RIRO Service 
      Description contains all the information needed to use the service.
    </rdfs:comment>
    <rdfs:comment xml:lang="en">
      The description is built as a set of properties of the connection point 
      resource (a node which URI is the URL of the service).
    </rdfs:comment>
    <rdfs:comment xml:lang="en">
      Input patterns and output templates are described using the accompanying 
      RDF Graph Patterns and Templates vocabulary 
      (http://purl.org/vocab/riro/gpt).
    </rdfs:comment>

    <dc:identifier>http://purl.org/vocab/riro/sdl</dc:identifier>
    <dct:isVersionOf rdf:resource="http://purl.org/vocab/riro/sdl#"/>
    <dc:creator>Sergei Egorov <esl@ariadnegenomics.com></dc:creator>
    <dc:rights>
      Copyright © 2006 Sergei Egorov
    </dc:rights>
    <dc:rights>
      OWL metadata & format Copyright © 2005 Richard Newman and Ian Davis
    </dc:rights>
    <vann:preferredNamespaceUri>http://purl.org/vocab/riro/sdl#</vann:preferredNamespaceUri>
    <vann:preferredNamespacePrefix>sdl</vann:preferredNamespacePrefix>

    <dct:hasFormat>
      <dctype:Text rdf:about="http://purl.org/vocab/riro/sdl.html">
        <dc:format>
          <dct:IMT>
            <rdf:value>text/html</rdf:value>
            <rdfs:label xml:lang="en">HTML</rdfs:label>
          </dct:IMT>
        </dc:format>
      </dctype:Text>
    </dct:hasFormat>
    <dct:hasFormat>
      <dctype:Text rdf:about="http://purl.org/vocab/riro/sdl.owl">
        <dc:format>
          <dct:IMT>
            <rdf:value>application/rdf+xml</rdf:value>
            <rdfs:label xml:lang="en">OWL</rdfs:label>
          </dct:IMT>
        </dc:format>
      </dctype:Text>
    </dct:hasFormat>

    <skos:example rdf:resource="sdl-example.rdf"/>
    <skos:example rdf:resource="sdl-example.ttl"/>

    <dct:issued>2006-03-05</dct:issued>
    <skos:historyNote
       rdf:value="First version"
       dc:date="2006-03-05"
       dc:creator="Sergei Egorov"/>
  </owl:Ontology>
  
  <cc:Work rdf:about="">
    <cc:license rdf:resource="http://creativecommons.org/licenses/by/2.5/"/>
  </cc:Work>
  
  <cc:License rdf:about="http://creativecommons.org/licenses/by/2.5/">
    <cc:permits rdf:resource="http://web.resource.org/cc/Reproduction"/>
    <cc:permits rdf:resource="http://web.resource.org/cc/Distribution"/>
    <cc:requires rdf:resource="http://web.resource.org/cc/Notice"/>
    <cc:requires rdf:resource="http://web.resource.org/cc/Attribution"/>
    <cc:permits rdf:resource="http://web.resource.org/cc/DerivativeWorks"/>
  </cc:License>
  
  <owl:ObjectProperty rdf:about="http://purl.org/dc/elements/1.1/format"/>
  <owl:ObjectProperty rdf:about="http://purl.org/dc/terms/hasFormat"/>
  <owl:AnnotationProperty rdf:about="http://purl.org/dc/terms/isVersionOf"/>
  <owl:AnnotationProperty rdf:about="http://purl.org/dc/terms/replaces"/>
  <owl:AnnotationProperty rdf:about="http://purl.org/dc/elements/1.1/type"/>
  <owl:DatatypeProperty rdf:about="http://purl.org/dc/elements/1.1/rights"/>
  <owl:DatatypeProperty rdf:about="http://purl.org/dc/elements/1.1/date"/>
  <owl:DatatypeProperty rdf:about="http://purl.org/dc/elements/1.1/identifier"/>
  <owl:DatatypeProperty rdf:about="http://purl.org/dc/elements/1.1/contributor"/>
  <owl:DatatypeProperty rdf:about="http://purl.org/dc/elements/1.1/title"/>
  <owl:AnnotationProperty rdf:about="http://purl.org/vocab/vann/preferredNamespacePrefix"/>
  <owl:AnnotationProperty rdf:about="http://purl.org/vocab/vann/preferredNamespaceUri"/>
  <owl:AnnotationProperty rdf:about="http://purl.org/vocab/vann/changes"/>
  <owl:DatatypeProperty rdf:about="http://www.w3.org/1999/02/22-rdf-syntax-ns#value"/>
  <owl:Class rdf:about="http://web.resource.org/cc/License"/>
  <owl:Class rdf:about="http://web.resource.org/cc/Permission"/>
  <owl:Class rdf:about="http://web.resource.org/cc/Requirement"/>
  <owl:ObjectProperty rdf:about="http://web.resource.org/cc/permits"/>
  <owl:ObjectProperty rdf:about="http://web.resource.org/cc/requires"/>
  <owl:AnnotationProperty rdf:about="http://web.resource.org/cc/license"/>
  <cc:Permission rdf:about="http://web.resource.org/cc/Reproduction"/>
  <cc:Permission rdf:about="http://web.resource.org/cc/Distribution"/>
  <cc:Requirement rdf:about="http://web.resource.org/cc/Notice"/>
  <cc:Requirement rdf:about="http://web.resource.org/cc/Attribution"/>
  <cc:Permission rdf:about="http://web.resource.org/cc/DerivativeWorks"/>
  
  <owl:Class rdf:about="http://purl.org/vocab/riro/sdl#RIROService">
    <rdfs:label xml:lang="en">RIRO Service</rdfs:label>
    <skos:definition xml:lang="en">
      A RDF-in/RDF-out (RIRO) Service.
    </skos:definition>
    <rdfs:comment xml:lang="en">
      A member of this class is a service supporting the RIRO protocol. As a rule, 
      a member of this class is assigned a URI; if so, the URI is interpreted 
      as URL of the service's connection point.
    </rdfs:comment>
    <rdfs:isDefinedBy rdf:resource="http://purl.org/vocab/riro/sdl#"/>
    <rdfs:subClassOf>
      <owl:Restriction>
        <owl:onProperty>
          <owl:DatatypeProperty rdf:about="http://purl.org/vocab/riro/sdl#commandName"/>
        </owl:onProperty>
        <owl:minCardinality 
          rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">
          1</owl:minCardinality>
        <owl:maxCardinality 
          rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">
          1</owl:maxCardinality>
      </owl:Restriction>
    </rdfs:subClassOf>
    <rdfs:subClassOf>
      <owl:Restriction>
        <owl:onProperty>
          <owl:DatatypeProperty rdf:about="http://purl.org/vocab/riro/sdl#commandDescription"/>
        </owl:onProperty>
        <owl:maxCardinality 
          rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">
          1</owl:maxCardinality>
      </owl:Restriction>
    </rdfs:subClassOf>
    <rdfs:subClassOf>
      <owl:Restriction>
        <owl:onProperty>
          <owl:DatatypeProperty rdf:about="http://purl.org/vocab/riro/sdl#fileUnder"/>
        </owl:onProperty>
        <owl:maxCardinality 
          rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">
          1</owl:maxCardinality>
      </owl:Restriction>
    </rdfs:subClassOf>
    <rdfs:subClassOf>
      <owl:Restriction>
        <owl:onProperty>
          <owl:ObjectProperty rdf:about="http://purl.org/vocab/riro/sdl#inputPattern"/>
        </owl:onProperty>
        <owl:minCardinality 
          rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">
          1</owl:minCardinality>
        <owl:maxCardinality 
          rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">
          1</owl:maxCardinality>
      </owl:Restriction>
    </rdfs:subClassOf>
    <rdfs:subClassOf>
      <owl:Restriction>
        <owl:onProperty>
          <owl:ObjectProperty rdf:about="http://purl.org/vocab/riro/sdl#outputTemplate"/>
        </owl:onProperty>
        <owl:minCardinality
          rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">
          1</owl:minCardinality>
        <owl:maxCardinality
          rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">
          1</owl:maxCardinality>
      </owl:Restriction>
    </rdfs:subClassOf>
    <rdfs:subClassOf>
      <owl:Restriction>
        <owl:onProperty>
          <owl:DatatypeProperty rdf:about="http://purl.org/vocab/riro/sdl#method"/>
        </owl:onProperty>
        <owl:minCardinality 
          rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">
          1</owl:minCardinality>
        <owl:maxCardinality
          rdf:datatype="http://www.w3.org/2001/XMLSchema#nonNegativeInteger">
          1</owl:maxCardinality>
      </owl:Restriction>
    </rdfs:subClassOf>
    <dct:issued>2006-03-05</dct:issued>
    <skos:changeNote
       rdf:value="Added comment"
       dc:date="2006-03-05"
       dc:creator="Sergei Egorov"/>
  </owl:Class>
  
  <owl:DatatypeProperty rdf:about="http://purl.org/vocab/riro/sdl#commandName">
    <rdfs:label xml:lang="en">command name</rdfs:label>
    <skos:definition xml:lang="en">
      The name of the command to invoke the service.
    </skos:definition>
    <rdfs:comment xml:lang="en">
      Please supply short and descriptive name, suitable for use in menus, 
      command lists etc. Recommended length is 10-40 characters.
    </rdfs:comment>
    <rdfs:comment xml:lang="en">
      Example: 'Resolve LSRN to Record, URLs'.
    </rdfs:comment>
    <rdfs:comment xml:lang="en">This property is required.</rdfs:comment>
    <rdfs:isDefinedBy rdf:resource="http://purl.org/vocab/riro/sdl#"/>
    <rdfs:domain rdf:resource="http://purl.org/vocab/riro/sdl#RIROService"/>
    <rdfs:range rdf:resource="http://www.w3.org/2001/XMLSchema#string"/>
    <dct:issued>2006-03-05</dct:issued>
  </owl:DatatypeProperty>
  
  <owl:DatatypeProperty rdf:about="http://purl.org/vocab/riro/sdl#commandDescription">
    <rdfs:label xml:lang="en">command description</rdfs:label>
    <skos:definition xml:lang="en">
      The description of the command to invoke the service.
    </skos:definition>
    <rdfs:comment xml:lang="en">
      Please keep the description brief - no longer than 25-30 words. The 
      description should be suitable for use in tooltips, help texts etc.
    </rdfs:comment>
    <rdfs:isDefinedBy rdf:resource="http://purl.org/vocab/riro/sdl#"/>
    <rdfs:domain rdf:resource="http://purl.org/vocab/riro/sdl#RIROService"/>
    <rdfs:range rdf:resource="http://www.w3.org/2001/XMLSchema#string"/>
    <dct:issued>2006-03-05</dct:issued>
  </owl:DatatypeProperty>
  
  <owl:DatatypeProperty rdf:about="http://purl.org/vocab/riro/sdl#fileUnder">
    <rdfs:label xml:lang="en">file under</rdfs:label>
    <skos:definition xml:lang="en">
      The category/subcategory of the command to invoke the service.
    </skos:definition>
    <rdfs:comment xml:lang="en">
      This property allows one to group related services together. The format 
      of the property is category/subcategory/subsubcategory/..., similar to 
      the convention used in the Open Directory Project (dmoz.org). Category 
      names should follow the conventions for command names (10-40 characters, 
      capitalized).
    </rdfs:comment>
    <rdfs:comment xml:lang="en">Example: 'Related/Journal Articles'</rdfs:comment>
    <rdfs:isDefinedBy rdf:resource="http://purl.org/vocab/riro/sdl#"/>
    <rdfs:domain rdf:resource="http://purl.org/vocab/riro/sdl#RIROService"/>
    <rdfs:range rdf:resource="http://www.w3.org/2001/XMLSchema#string"/>
    <dct:issued>2006-03-05</dct:issued>
  </owl:DatatypeProperty>
  
  <owl:ObjectProperty rdf:about="http://purl.org/vocab/riro/sdl#inputPattern">
    <rdfs:label xml:lang="en">input pattern</rdfs:label>
    <skos:definition xml:lang="en">
      The pattern matching proper input graphs.
    </skos:definition>
    <rdfs:comment xml:lang="en">
      Graph patterns should be expressed via the RDF Graph Patterns and 
      Templates vocabulary (http://purl.org/vocab/riro/gpt).
    </rdfs:comment>
    <rdfs:comment xml:lang="en">This property is required.</rdfs:comment>
    <rdfs:isDefinedBy rdf:resource="http://purl.org/vocab/riro/sdl#"/>
    <rdfs:domain rdf:resource="http://purl.org/vocab/riro/sdl#RIROService"/>
    <rdfs:range rdf:resource="http://www.w3.org/2000/01/rdf-schema#Resource"/>
    <dct:issued>2006-03-06</dct:issued>
  </owl:ObjectProperty>
  
  <owl:ObjectProperty rdf:about="http://purl.org/vocab/riro/sdl#outputTemplate">
    <rdfs:label xml:lang="en">output template</rdfs:label>
    <skos:definition xml:lang="en">
      The template for output graphs produced by the service.
    </skos:definition>
    <rdfs:comment xml:lang="en">
      Graph patterns should be expressed via the RDF Graph Patterns and 
      Templates vocabulary (http://purl.org/vocab/riro/gpt).
    </rdfs:comment>
    <rdfs:comment xml:lang="en">
      The input pattern and output template can share blank nodes. In real calls, 
      the query and the reply graph will also share corresponding blank nodes 
      by reusing nodeIDs; the reply is considered to be in the same nodeID 
      namespace as the query.
    </rdfs:comment>
    <rdfs:comment xml:lang="en">This property is required.</rdfs:comment>
    <rdfs:isDefinedBy rdf:resource="http://purl.org/vocab/riro/sdl#"/>
    <rdfs:domain rdf:resource="http://purl.org/vocab/riro/sdl#RIROService"/>
    <rdfs:range rdf:resource="http://www.w3.org/2000/01/rdf-schema#Resource"/>
    <dct:issued>2006-03-06</dct:issued>
  </owl:ObjectProperty>
  
  <owl:DatatypeProperty rdf:about="http://purl.org/vocab/riro/sdl#method">
    <rdfs:label xml:lang="en">HTTP method</rdfs:label>
    <skos:definition xml:lang="en">
      Query method ('get' or 'post').
    </skos:definition>
    <rdfs:comment xml:lang="en">
      If the query method is 'get', the service is assumed to be idempotent 
      (the query will have no side effects).
    </rdfs:comment>
    <rdfs:comment xml:lang="en">This property is required.</rdfs:comment>
    <rdfs:isDefinedBy rdf:resource="http://purl.org/vocab/riro/sdl#"/>
    <rdfs:domain rdf:resource="http://purl.org/vocab/riro/sdl#RIROService"/>
    <rdfs:range>
      <owl:DataRange>
        <owl:oneOf>
          <rdf:List>
            <rdf:first
              rdf:datatype="http://www.w3.org/2001/XMLSchema#string">
              get</rdf:first>
            <rdf:rest>
              <rdf:List>
                <rdf:first
                  rdf:datatype="http://www.w3.org/2001/XMLSchema#string">
                  post</rdf:first>
                <rdf:rest 
                  rdf:resource="http://www.w3.org/1999/02/22-rdf-syntax-ns#nil"/>
              </rdf:List>
            </rdf:rest>
          </rdf:List>
        </owl:oneOf>
      </owl:DataRange>
    </rdfs:range>
    <dct:issued>2006-03-06</dct:issued>
  </owl:DatatypeProperty>

</rdf:RDF>

License

This work is licensed under a Creative Commons License.

The following section is informational only, please refer to the Original License for complete license terms.

This license grants the following rights:

This license imposes the following restrictions:

RDF-in/RDF-out (RIRO) Service Descriptions

Table of Contents

Introduction

Changes From Previous Version

Namespace

Summary of Terms

Vocabulary Classes

Class: RIROService

History

Vocabulary Properties

Property: commandName

History

Property: commandDescription

History

Property: fileUnder

History

Property: inputPattern

History

Property: outputTemplate

History

Property: method

History

Examples

RDF Schema

License