10.11 SSWAP Protocol classes and properties. SSWAP Protocol 1 1 1 0 A sswap:Resource designates a semantically described web resource. Resources that "do things" for example, transform some input to some output are called services. A sswap:Resource sswap:operatesOn one or more sswap:Graphs, where the sswap:Graph acts as a data structure for the mapping of some input (sswap:Subject) to some output (sswap:Object). A resource that is a sswap:Resource has the URI of its Resource Description Graph (RDG). All sswap:Resources have a sole and unique sswap:Provider (indicated by the sswap:providedBy predicate) which claims ownership of the resource (reciprocated by the sswap:providesResource predicate). If the resource's URI is a lexical sub-path of the provider, then the provider does not have to reciprocate the sswap:providesResource claim. But if the resource is claiming ownership by a provider whose URI is not a lexical sub-path, then the provider must explicitly reciprocate the claim with sswap:providesResource. Similarly, if a provider claims a resource which is not in a sub-path, then the resource must reciprocate the claim. Required predicates: sswap:name, sswap:operatesOn, sswap:providedBy; Optional predicates: sswap:aboutURI, sswap:inputURI, sswap:metadata, sswap:oneLineDescription, sswap:outputURI. 1 1 1 Resource Root class of all SSWAP classes. For more information on the protocol see http://sswap.info. SSWAP 0 Object A sswap:Object is the object of a mapping; it is the data returned by (output from) the service. In the concept of a service mapping an input to an output, the sswap:Object corresponds to the output. The property sswap:mapsTo explicitly demarcates the mapping (or transformation) from an input to this output. One can also use sswap:mapsTo to describe inverse mappings where the stated relationship is from a sswap:Object to a sswap:Subject. Required predicates: (none); Optional predicates: sswap:mapsTo. Subject A sswap:Subject is the subject of a mapping; it is the data consumed by (input to) the service. In the concept of a service mapping an input to an output, the sswap:Subject corresponds to the input. The property sswap:mapsTo explicitly demarcates the mapping (or transformation) from this input to its output. One can also use sswap:mapsTo to describe inverse mappings where the stated relationship is from a sswap:Object to a sswap:Subject. Required predicates: sswap:mapsTo; Optional predicates: (none). A sswap:Provider designates the provider of one or more resources. Providers claim ownership of resources and are anticipated to be associated with actual organizations such as W3C, NCBI, etc. Providers may state that they provide multiple resources by using multiple sswap:providesResource properties. The resource that is a sswap:Provider is the URI of the provider's Provider Description Graph (PDG), and separate from the Resource Description Graphs (RDGs) of each service. The owl:Restriction on sswap:providedBy defines the class so as to prohibit the inferrence that sswap:Provider is a rdfs:subClassOf sswap:Resource. The property sswap:providedBy is not a valid predicate for a sswap:Provide. See sswap:Resource for notes on sswap:providesResource and sswap:providedBy. Required predicates: sswap:name; Optional predicates: sswap:about, sswap:metadta, sswap:oneLineDescription, sswap:providesResource. 0 Provider 1 0 1 0 1 A sswap:Graph delineates an entry point for a suite of mappings. For services, a "mapping" embeds the concept of taking some input and returning some output. An individual of this class is the RDF object of the sswap:hasMapping relationship from a sswap:Resource. By differentially using sswap:operatesOn and sswap:hasMapping, one can, for example, differentiate between a pair of lists and a list of pairs. Required predicates: sswap:hasMapping; Optional predicates: (none). Graph Super property for all SSWAP Object properties. This property is not used directly so it has no domain and range. objectProperty hasMapping A property that connects a sswap:Graph to a sswap:Subject. The sswap:Subject's subgraph then contains the relevant mappings of an input (sswap:Subject) to its output (sswap:Object). A property that connects a sswap:Subject to a sswap:Object, or vice-versa. For services, this is usually used to establish the transformation from the input to the output. This property is directional (implies a mapping from the domain to the range), but can be used as its own inverse. So one may delineate a mapping from sswap:Subject to sswap:Object, and use another sswap:mapsTo to delineate a mapping from sswap:Object to sswap:Subject. mapsTo Super property for all SSWAP Datatype properties. This property is not used directly so it has no domain and range. datatypeProperty Points to a URI that may contain words, phrases, or other such free text that programs may use to parse keywords to associated with the property's subject. metadata outputURI Resources may require special user interfaces to present output such as using web pages to display formated results to users. Programs that are handling a service's response may direct users to the URI pointed to by this property to handle the result graph. Resources may require special user interfaces to gather input such as using web pages to solicit input from users. Programs that are preparing to invoke a service may direct users to the URI pointed to by this property for the appropriate user interface. inputURI aboutURI Points to a URI for additional information. It is expected that the URI may resolve to a human-readable web page (an HTML resource). Programs may dereference the URI to provide users with additional information describing a sswap:Resource or sswap:Provider. name A human-readable name that services may use to name their sswap:Resource or sswap:Provider. oneLineDescription A one line, human-readable description that services may use to describe brief information about their sswap:Resource or sswap:Provider. A property identifying the entity providing the Resource. The Resource's URI must be a lexical sub-path of the Provider, unless the Provider explicitly claims the Resource by including a sswap:providesResource statement, pointing at the Resource, in the Provider's Description Graph (PDG). providedBy operatesOn A property that connects a sswap:Resource to a sswap:Graph. The sswap:Graph's subgraph then contains the relevant mappings of an input (sswap:Subject) to its output (sswap:Object). providesResource A property identifying the provided Resource. The Resource's URI must be a lexical sub-path of the Provider, unless the Resource explicitly claims the Provider by including a sswap:providedBy statement, pointing at the Provider, in the Resource's Description Graph (RDG).