Profile

From OpenOrg
Revision as of 10:43, 27 October 2012 by AlexDutton (talk | contribs) (Added outline of OPD to content section)
Jump to: navigation, search

Abstact

This document defines an organisational profile document, which can be used to discover datasets about aspects of the organisation, and standards-conformant APIs which can be used to interact with some aspect of the organisation.

The profile document is a dataset about the organisation.

Format

The profile document should be available as either RDF/XML (application/rdf+xml) or Turtle (text/turtle). One may implement content negotiation, but it isn't required.

Content

The document should be of type oo:OrganizationProfileDocument, and contain a foaf:primaryTopic property pointing at the organization. We recommend that you use a class from the Organization ontology, such as org:FormalOrganization

<syntaxhighlight lang="xml"> <?xml version="1.0" encoding="utf-8"?> <rdf:RDF

   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
   xmlns:foaf="http://xmlns.com/foaf/0.1/"
   xmlns:oo="http://purl.org/openorg/">
 <oo:OrganizationProfileDocument rdf:about="">
   <foaf:primaryTopic>
     <org:FormalOrganization rdf:about="http://id.example.org/">
     </org:FormalOrganization>
   </foaf:primaryTopic>
 </oo:OrganizationProfileDocument>

</rdf:RDF> </syntaxhighlight>

Organization metadata

Discovery

Discovering with well-known URI

The RFC 5758 defines a mechanism for reserving 'well-known' URIs on any Web server.

We intend to register the well-known URI /.well-known/openorg for the purpose of discovering the organisational profile document.