Facilities and Equipment

From OpenOrg
Revision as of 14:08, 31 January 2012 by WikiSysop (talk | contribs) (Equipment)
Jump to: navigation, search

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

If you don't want to make any effort minting URIs for manufacturers, just add #manufacturer to the equipment URI. If you have many items of equipment, many from the same manufacturer, it may be useful to actually assign them more formal URIs, but this could just be created from the MD5 Hash of their homepage URL.

The "manufacturersPageForItem" is a property of the equipment, not the manufacturer, as each item of equipment many have a different page on their website. This is useful to include if the data is being aggregated between sources as you can use it to identify two organisations have the same (or at least a similar) equipment.

You can list an item being within any or all of room, building, site and city. For the first 3 see the Places description in this wiki. You should at least include type, label & lat/long if available in the same document as the equipment. For cities (population centers) please use the geonames URI for that place, failing that the DBPedia one.

<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:resource="...contact-uri... />
 <oo:relatedFacility rdf:resource="...facility-uri.." /> 
 <oo:formalOrganisation rdf:resource="...org-uri..." />
 <oo:organisationPart rdf:resource="...org-part-uri..." />
 <spatialrelations:within rdf:resource="...site-uri..." />
 <oo:manufacturer rdf:resource="http://id.example.org/equipment/E0001#manufacturer" />
 <oo:manufacturersPageForItem rdfs:about="...URL..." />      

</oo:Equipment>

<foaf:Organisation rdf:resource="http://id.example.org/equipment/E0001#manufacturer">

 <rdfs:label>Vorlon Heavy Industrial Systems</rdfs:label>
 <foaf:homepage rdf:resource="http://www.vorlon-industrial.com/" />

</foaf:Organisation> </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>