Help TOC > PLCS technical description > Reference Data > OWL - Annotation properties | |
OWL - Annotation properties | Date: 2008/03/04 21:49:21 Revision: 1.3 |
This section details the metadata used for the management of the Ontology, Classes, etc. (e.g. a version identifier). This meta data is represented by annotation properties which are based on the Dublin Core set of properties.
The Dublin Core is an industry standard for data about Web resources managed by the Dublin Core Metadata Initiative (DCMI). Quoting from their Web site:
“The Dublin Core Metadata Initiative is an open forum engaged in the development of interoperable online metadata standards that support a broad range of purposes and business models. DCMI's activities include consensus-driven working groups, global workshops, conferences, standards liaison, and educational efforts to promote widespread acceptance of metadata standards and practices.”
For annotating PLCS Reference Data elements, not all of the Dublin Core Elements and Terms are required. However, every Dublin Core Element or Term is not applicable to every PLCS Reference Data element. For use in OWL, these terms are provided as OWL Annotation Properties. An annotation property does not affect the semantics of the Ontology, Class or Property. For PLCS RDL, annotation properties are used as part of the process of managing the library itself.
In addition to the Dublin Core, the OWL language has built-in Annotation Properties that Reference Data developers can use.
For the purpose of managing the OASIS PLCS TC RD development process, a small number of TC-specific OWL Annotation Properties have been defined.
The following matrix shows what OWL Annotation Properties and Dublin Core Elements and Terms to apply. The properties are hyperlinked to the Web and their formal definitions.
Annotation Property |
Brief Description |
On Ontology |
On Class |
---|---|---|---|
dc:creator (http://dublincore.org/documents/dcmi-terms/#creator) |
person and organization |
Required |
Required |
dc:modified (http://dublincore.org/documents/dcmi-terms/#modified) |
last date modified YYYY-MM-DD |
Required |
Required |
dc:created (http://dublincore.org/documents/dcmi-terms/#created) |
date created YYYY-MM-DD |
Required |
Required |
dc:abstract (http://dublincore.org/documents/dcmi-terms/#abstract) |
brief summary of content |
Required |
No |
dc:title (http://dublincore.org/documents/dcmi-terms/#title) |
formal name |
Required |
No |
dc:source (http://dublincore.org/documents/dcmi-terms/#source) |
standard or resource from which element was taken, use multiple dc:source annotations if required |
Optional |
Required |
owl:versionInfo (http://www.w3.org/TR/owl-ref/#versionInfo-def) |
version identifier n (e.g. 1 or 2 or 3). Will be automatically set to 1 upon official publication of full RDL. |
Required |
Required |
dc:OASIS_stage (defined here) |
OASIS stage of "DeveloperDraft", "CommitteeDraft", "PublicReviewDraft", "CommitteeSpecification" set to manage the development/ballot process. This annotation is removed when the RD is published on the OASIS site. |
No |
Required |
dc:OASIS_revision (defined here) |
OASIS revision with an OASIS stage set to manage the development/ballot process. Starts at '0' when the RD item reaches the stage and is incremented each time the RD item is modified within that stage. This annotation is removed when the RD is published on the OASIS site. |
No |
Required |
rdfs:label (http://www.w3.org/TR/rdf-schema/#ch_label) |
a human readable name for the RD item |
No |
Required |
rdfs:comment (http://www.w3.org/TR/rdf-schema/#ch_comment) |
a human readable text definition of the RD item |
No |
Required |
dc:references (http://dublincore.org/documents/dcmi-terms/#references) |
Refers to any standard or other document referenced in the definition of the Reference Data item. use multiple dc:references annotations if required |
No (or will be set automatically upon RDL publication) |
Optional |
dc:dateAccepted (http://dublincore.org/documents/dcmi-terms/#dateAccepted) |
The date the Reference Data item reached the "Registered" status in the PLCS RDL. |
No. |
Required when Registered |
dc:subject (http://dublincore.org/documents/dcmi-terms/#subject) |
Add keywords or classification codes to classify a RD item. Use multiple dc:subject annotations if required |
No. |
Optional |
dc:issued (http://dublincore.org/documents/dcmi-terms/#issued) |
Automatically added date of publication of entire PLCS RDL version. |
Automated |
Automated |
dcterms:rightsHolder (http://dublincore.org/documents/dcmi-terms/#rightsHolder) |
Used with rights to define any Intellectual Property Rights (IPR) |
Optional |
Optional |
An rdfs:comment is a human readable text definition for an RD item where more than one are allowed to support definitions in different natural languages.
An rdfs:label is a human readable name for an RD item where more than one are allowed to support labels in different natural languages (e.g. 'Chat' in French and 'Cat' in English)
The OASIS_stage is set to reflect the stage at which the item has progressed within development and review process. Valid values are "Developer Draft", "Committee-Draft", "Public Review Draft" and "Committee Specification". An OASIS_stage occurs within an OWL versionInfo to manage the process of publishing RD (i.e. each version of an RD item goes through these stages).
The OASIS_revision is set to reflect changes that have occurred within the stage of the process and has valid values 0, 1, 2, 3, etc. For example, when a class reaches "Committee Draft" stage the revision is set to '0' but if comments are raised and addressed then the revision is raised to '1' to reflect the fact that it has been changed since entering the "Committee Draft" stage. However, when the item moves to the next OASIS_stage the OASIS_revision is reset to '0'.
The OWL versionInfo is set to reflect the version of the RD item. It starts with '1' and then increments to '2', etc. The versionInfo is set as soon as the RD item enters the "Developer Draft" stage. The versionInfo for an RD item within an ontology is independent of the ontology and only gets updated if changes occur to the definition of the RD item. So, PLCS RD versionInfo '2' ontology may contain RD classes at versionInfo '1'. In fact all the classes might be at versionInfo '1' if none were changed between ontology '1' and '2'. This would happen if ontology '2' only contained new additional RD items.
The Dublin Core term "creator" is the annotation to be used to define the person and organization who added the class to the RD Library. The form of the dc:creator value should be first name, last name, comma, and then organization name (e.g Rob Bodington, Eurostep).
The Dublin Core term "created" is the annotation to be used to define the date that the creator added the RD to their work space (e.g. YYYY-MM-DD).
The Dublin Core term "modified" is the annotation to be used to define the date of the most recent change to the Reference Data item (e.g. YYYY-MM-DD).
The Dublin Core term "source" is the annotation to be used to define any standard or organization that originally created the class and is responsible for publishing it and controlling its development. A unique name for any dc:source must be agreed by the RD developers.
If the RD is entirely new, created by the PLCS modeller, then the dc:source should be set to read "PLCS RDL n" where "n" is the version of the PLCS Reference Data Library in which the RD first appeared (e.g. PLCS RDL 1).
At the time of publication of each version of the PLCS RDL, any RD that does not have a dc:source set will have that value set with the applicable "PLCS RDL n" by default.
The Dublin Core term "dateAccepted" is the annotation to be used to define the date that the RD item reached the Registered status in the PLCS RD development process. The user is expected to set this date. (e.g. YYYY-MM-DD)
The Dublin Core term "issued" is the annotation to be used to define the date that the Reference Data item version was published as part of an official OASIS PLCS RDL version being published. This date is not changed if the item did not change between PLCS RDL version n.nn and n.nn+1.
This will be automatically set when a version of the PLCS RDL is published.
The Dublin Core term "language" is the annotation to be used to define the natural language in which a label, definition or comment is made (e.g. "en" for English).
The two letter codes specified in ISO 629-2 shall be used (http://www.loc.gov/standards/iso639-2/langcodes.html)
The Dublin Core term "publisher" is the annotation to be used to define that OASIS PLCS TC published the RDL. This will be set automatically upon official OASIS publication of a version of the RDL.
The Dublin Core term "references" is the annotation to be used to define any reference to another standard or document that appears as part of the definition of the RD item. (e.g. "ISO 10303-41").
The Dublin Core term "rightsHolder" is the annotation to be used to define who owns the Intellectual Property Rights, etc. related to an RD item. It is used in conjunction with "rights".
The Dublin Core term "rights" is the annotation to be used to define the Intellectual Property Rights, etc. related to the RD. It is used in conjunction with "rightsHolder".
The Dublin Core term "subject" is the annotation to be used to define the keywords or classifications codes (e.g. class of class) related to an RD item. Each keyword or classification code should be created in separate instances of "subject". (e.g. "Aircraft maintenance")
The Dublin Core term "title" is the annotation to be used to provide the title for an OWL ontology that is part of the RDL.
Dublin Core Metadata Initiative(http://dublincore.org/)
DCMI Metadata Terms(http://dublincore.org/documents/dcmi-terms/)