Difference between revisions of "Facilities and Equipment"

From OpenOrg
Jump to: navigation, search
(Created page with "This pattern is to describe how to communication Facilities, Equipment and Services available from one or more organisation. It's being developed to support a project between the...")
 
(Facility)
Line 53: Line 53:
  
 
   <rdfs:label>Alien Technology Lab</rdfs:label>
 
   <rdfs:label>Alien Technology Lab</rdfs:label>
   <oo:contact rdfs:about="...contact-uri... />
+
   <oo:contact rdf:about="...contact-uri... />
  
 
</oo:Facility>
 
</oo:Facility>
 +
</syntaxhighlight>
 +
 +
== Equipment ==
 +
 +
<syntaxhighlight lang="xml">
 +
<oo:Equipment rdf:about="...uri...">
 +
 +
  <rdfs:label>Xondrite Array</rdfs:label>
 +
 +
  <dcterms:description rdf:datatype="xtypes:Fragment-PlainText">......<dcterms:description>
 +
  <dcterms:description rdf:datatype="xtypes:Fragment-HTML">......<dcterms:description>
 +
 +
  <oo:contact rdf:about="...contact-uri... />
 +
 +
  <oo:relatedFacility rdf:about="...facility-uri.." />
 +
  <oo:formalOrganisation rdf:about="...org-uri..." />
 +
  <oo:organisationPart rdf:about="...org-part-uri..." />
 +
 +
  <oo:manufacturer rdf:about="...manufacturer-uri..." />
 +
  <oo:manufacturersPageForItem rdfs:about="...URL..." />     
 +
 +
</oo:Equipment>
 +
 +
<oo:Organisation rdf
 +
 +
</syntaxhighlight>
 +
 +
== Service ==
 +
 +
<syntaxhighlight lang="xml">
 +
<oo:Service rdf:about="...uri...">
 +
 +
  <rdfs:label>Exposure to Alien Rays</rdfs:label>
 +
 +
  <oo:contact rdf:about="...contact-uri... />
 +
 +
</oo:Service>
 
</syntaxhighlight>
 
</syntaxhighlight>

Revision as of 11:04, 31 January 2012

This pattern is to describe how to communication Facilities, Equipment and Services available from one or more organisation. It's being developed to support a project between the Universities of Oxford, Cambridge, Imperial, UCL & Southampton to make each other aware of our facilities. There's nothing to restrict it to research facilities, or universities.

It's primarily intended to describe the existence of these things, to describe a formally offered service catalogue, consider using Good Relations, either instead or in addition to this pattern. The goal is to allow easy aggregation from multiple organisations in a sector and/or geographic region.

A full description will include Facilities, Equipment, Services, Contacts, Manufacturers (of equipment), Places and part of the Organisation. However the minimum is a single description of a facilility, item of equipment or service with a label and a contact. Without listing at least one form of contact, this isn't valid!

You can use this pattern any way you choose, but if describing it as a single document then minimum data should be included for places (label, type, lat/long), org-units (label, parent org), contacts (name & contact details). That allows it to be aggregated from a single URL, like an RSS feed.

Contacts

Contacts are vital. Without these, nobody can actually find out more about the things described. Contacts can either be embedded in facilities, equipment, services or assigned URIs. If it's a generic contact for a facility, service or bit of equipment, just make the URI a #contact on the end of the URI for that thing.

<syntaxhighlight lang="xml"> <oo:Facility rdf:about="http://id.example.org/facility/alien-lab">

 <rdfs:label>Alien Technology Lab</rdfs:label>
 <oo:contact rdf:resource="http://id.example.org/facility/alien-lab#contact" />

</oo:Facility>

<oo:contact rdf:about="http://id.example.org/facility/alien-lab#contact">

 <foaf:mbox rdf:resource="mailto:alien-lab@example.org" />

</oo:contact> </syntaxhighlight>

Other recommended properties for contacts: foaf:name, foaf:homepage, foaf:phone. Addresses should use vcard.

If a facility has multiple contacts you can indicate the main one using oo:primaryContact IN ADDITION to oo:contact. It may be useful to provide backup contacts.

<syntaxhighlight lang="xml"> <oo:Facility rdf:about="http://id.example.org/facility/alien-lab">

 <rdfs:label>Alien Technology Lab</rdfs:label>
 <oo:contact rdf:resource="http://id.example.org/facility/alien-lab#contact" />
 <oo:primaryContact rdf:resource="http://id.example.org/facility/alien-lab#contact" />
 <oo:contact rdf:resource="http://id.example.org/person/professor-x" />

</oo:Facility>

<oo:contact rdf:about="http://id.example.org/facility/alien-lab#contact">

 <foaf:mbox rdf:resource="mailto:alien-lab@example.org" />

</oo:contact>

<oo:contact rdf:about="http://id.example.org/person/professor-x">

 <foaf:name>Professor X</foaf:name>
 <foaf:phone rdf:resource="tel:+44123456789" />
 <foaf:mbox rdf:resource="mailto:professor-x@example.org" />
 <foaf:homepage rdf:resource="http://example.org/professor-x/" />

</oo:contact> </syntaxhighlight>

Facility

<syntaxhighlight lang="xml"> <oo:Facility rdf:about="...uri...">

 <rdfs:label>Alien Technology Lab</rdfs:label>
 <oo:contact rdf:about="...contact-uri... />

</oo:Facility> </syntaxhighlight>

Equipment

<syntaxhighlight lang="xml"> <oo:Equipment rdf:about="...uri...">

 <rdfs:label>Xondrite Array</rdfs:label>
 <dcterms:description rdf:datatype="xtypes:Fragment-PlainText">......<dcterms:description>
 <dcterms:description rdf:datatype="xtypes:Fragment-HTML">......<dcterms:description>
 <oo:contact rdf:about="...contact-uri... />
 <oo:relatedFacility rdf:about="...facility-uri.." /> 
 <oo:formalOrganisation rdf:about="...org-uri..." />
 <oo:organisationPart rdf:about="...org-part-uri..." />
 <oo:manufacturer rdf:about="...manufacturer-uri..." />
 <oo:manufacturersPageForItem rdfs:about="...URL..." />      

</oo:Equipment>

<oo:Organisation rdf

</syntaxhighlight>

Service

<syntaxhighlight lang="xml"> <oo:Service rdf:about="...uri...">

 <rdfs:label>Exposure to Alien Rays</rdfs:label>
 <oo:contact rdf:about="...contact-uri... />

</oo:Service> </syntaxhighlight>