Difference between revisions of "Profile"

From OpenOrg
Jump to: navigation, search
(A start)
 
(Added outline of OPD to content section)
Line 11: Line 11:
 
== Content ==
 
== Content ==
  
The document should be of type void:Dataset, and  
+
The document should be of type <tt>oo:OrganizationProfileDocument</tt>, and contain a <tt>foaf:primaryTopic</tt> property pointing at the organization. We recommend that you use a class from the [http://www.epimorphics.com/public/vocabulary/org.html Organization ontology], such as <tt>org:FormalOrganization</tt>
 +
 
 +
<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/">
 +
        <!-- organization metadata -->
 +
        <!-- profile documents -->
 +
      </org:FormalOrganization>
 +
    </foaf:primaryTopic>
 +
  </oo:OrganizationProfileDocument>
 +
</rdf:RDF>
 +
</syntaxhighlight>
 +
 
 +
=== Organization metadata ===
  
 
== Discovery ==
 
== Discovery ==

Revision as of 10:43, 27 October 2012

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.