The Annotated SSWAP Protocol

sswap.info
Simple Semantic Web Architecture and Protocol

The Annotated SSWAP Protocol


Class sswap:Resource (Developer docs). A required class. This class designates the semantically described resource. Resources that "do things", for example, transform input (sswap:Subject) to output (sswap:Object), are commonly called services. Resources may also be web pages, ontologies, etc. Resource description graphs reside at distinct URLs, one for each resource.

 

Its Properties

sswap:name                            Required property that points to a string containing the resource's preferred name.

sswap:operatesOn                   Required property that points to a web resource of type sswap:Graph. That resource is often a blank node (no URL). Resources can have more than one sswap:operatesOn. OWL DL does not allow the use of RDF Containers and Collections. By using the sswap:Graph class you can build complex data structures while remaining OWL DL compliant. This allows you, for example, to differentiate between accepting and returning data as a pair of lists or a list of pairs.

sswap:aboutURI                     Optional reference to web page where the user could find additional information about the provider.

sswap:inputURI                      Optional reference to web page where the resource can solicit input from a user. For machine-machine interaction, this user input page is not needed. But if you want search engines to be able to find your resource and then forward users to a web page for them to input data and parameters before invoking the resource, use this predicate to indicate the URL of that web page. See also sswap:outputURI below.

sswap:metadata                       Optional reference to URL where the provider can place text that may be used by a semantically-aware search engine to richen the association of words with the resource. It could be words about the resource, or, for example, it could be a list of genes that the provider wants associated with it to empower token-matching search engines. The provider has no control as to how, or if at all, these words are used by third-party engines.

sswap:oneLineDescription     Optional reference that points to a string containing a brief description of the provider. Should be human readable for use by search engine result pages.

sswap:outputURI                    Optional reference to web page which can format the SSWAP output graph of the resource to make it suitble for an end-user. For machine-machine interaction, this output page is not needed. But if you want users to be able to read the output as a human readable web page, instead OWL RDF/XML, then use this predicate to indicate the URL of that web page. See also sswap:inputURI above.

sswap:providedBy                  Optional property pointing to the provider offering this resource. Resources can have at most one sswap:providedBy predicate. Providers must either explicitly reciprocate the relationship by using a sswap:providesResource predicate or their URI must be a parent of the Resource's path; e.g., sswap.info/examples/resourceProvider and http://sswap.info/examples/resources/canonical/canonicalResource. If canonicalResource would claim to be provided by www.YourWebsite.org/yourProvider, yourProvider would have to reciprocate the relationship by using the sswap:providesResource predicate pointing back to canonicalResource. See also sswap:Provider on the Provider page.

 

Examples

 

You can validate RDF graphs with the W3C's RDF Validator.

You can validate OWL graphs with Mindswap's archived Pellet validator or the University of Manchester's WonderWeb.

You can validate SSWAP graphs with SSWAP's Resource Validator.

 

<?xml version="1.0" encoding="UTF-8"?>

 

<rdf:RDF

xmlns:rdf = "http://www.w3.org/1999/02/22-rdf-syntax-ns#"

xmlns:sswap = "http://sswapmeet.sswap.info/sswap/"

>

 

<sswap:Resource rdf:about="http://sswap.info/examples/resources/canonical/canonicalResource" />

 

</rdf:RDF>

 

canonicalResource is a sswap:Resource.

 

 

 

<?xml version="1.0" encoding="UTF-8"?>

 

<rdf:RDF

xmlns:rdf = "http://www.w3.org/1999/02/22-rdf-syntax-ns#"

xmlns:sswap = "http://sswapmeet.sswap.info/sswap/"

>

 

<sswap:Resource rdf:about="http://sswap.info/examples/resources/canonical/canonicalResource">

     <sswap:providedBy>

      <sswap:Provider rdf:about="http://sswap.info/examples/resourceProvider"/>

     </sswap:providedBy>

</sswap:Resource>

 

</rdf:RDF>

 

canonicalResource is a sswap:Resource and has a sswap:providedBy relationship to the SSWAP Provider resourceProvider

 

You can see the complete description graph with all its predicates at sswap.info/examples/resources/canonical/canonicalResource
(On some browsers you may need to use View Page Source to see the RDF/XML in its entirety).



Home     Protocol     Ontologies     Developers' Page     Contact Us



UOA                         NSF



SSWAP 9.08.1  •  26 Aug 2009