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.

Use of Annotation 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 PLCSProduct Life Cycle Support The project developing ISO 10303-239. The name of ISO 10303-239 (published by ISO in 2005). Reference DataReference Data is the collection of class definitions representing a concept used to specialize entities of the information model, to make the use of them semantically more precise. The classes are defined external to the information model and any data exchange file, and the term "External Reference Data" is therefore a synonym. 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 OWLWeb Ontology Language - A W3C recommendation http://www.w3.org/2004/OWL/for defining Ontologies (Class structures)., 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 TCThe technical committee within OASIS responsible for developing the PLCS DEXs http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=plcs. 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)

OASISOrganization for the Advancement of Structured Information Standards http://www.oasis-open.org. 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

Table 1 — Use of Annotation

rdfs:comment is The text definition of the RD item

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.

rdfs:label is The name of the RD item

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)

dc:OASIS_stage is The stage in the life cycle of the RD

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).

dc:OASIS_revision is The revision within a stage in the life cycle of the RD

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'.

owl:versionInfo is The version of the RD

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.

dc:creator is The PLCS Modeller who created RD

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).

dc:created is is the date creator added RD

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).

dc:modified is date of most recent change to RD item

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).

dc:source is The original source of the RD

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 LibraryA Reference Data Library (RDL) is a managed collection of Reference Data Classes that is specified separately to any data exchange file. 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.

dc:dateAccepted is date Registered with PLCS

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)

dc:issued is date of OASIS Publication of the specified version of the RD item

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.

dc:language is the natural language

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)

dc:publisher is OASIS PLCS TC

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.

dc:references is reference to another standard or document

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").

dc:rightsHolder is IPR holder

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".

dc:rights is IPR

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".

dc:subject is used for keywords and classification of RD

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")

dc:title is the title of an OWL ontology in the RD

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.

References

Dublin Core Metadata Initiative(http://dublincore.org/)

DCMI Metadata Terms(http://dublincore.org/documents/dcmi-terms/)