CORDRA™ Vocabulary Conventions
Document Information
Status: Draft
Version: V1.00.20050101
Revision Date: 2005-01-01
Type: Specification/Definition
CORDRA ID:
H
[2000.01/92872563653A4262AC70C07FFCBBDC54]
Metadata ID:
H
[2000.01/5BB111C79DCD4EC3A008F1E0C013B7FD]
Abstract
This document describes the structure, conventions and format of all CORDRA vocabularies.
All CORDRA vocabularies SHALL be defined following a common set of structuring and definition conventions. Throughout this document, the term vocabulary SHALL be understood to be a CORDRA vocabulary.
These vocabulary conventions SHALL apply to all CORDRA vocabularies, i.e., all vocabularies that are used to define the CORDRA System, the CORDRA System instance or implementation of the CORDRA system, or a definition, instance or implementation of Federated CORDRA.
These vocabulary conventions MAY be applied to vocabularies used to define an individual CORDRA instance or implementation.
Each CORDRA vocabulary SHALL be defined by two documents, one designed to be human readable and one that is machine processable representation.
The machine processable representation of a CORDRA system vocabulary SHALL be represented using the H CORDRA Vocabulary Definition Specification Application Profile.
For interchange, the machine processable representation of a CORDRA system vocabulary shall be encoded in XML as defined in the H CORDRA Vocabulary Definition Specification Application Profile.
Each CORDRA system vocabulary shall be assigned a CORDRA ID within the system/vocabulary namespace, from the CORDRA NA.
Each CORDRA vocabulary SHALL have a set of metadata.
Each CORDRA vocabulary SHALL consist of a list of one or more vocabulary items or terms. Each term SHALL consist of a token naming the term and a definition of the term.
Each CORDRA system vocabulary SHALL be registered in the CORDRA system registry.
Each term in a CORDRA system vocabulary SHALL be assigned a CORDRA ID within the system/vocabulary namespace, from the CORDRA NA.
If the same term is used in multiple CORDRA vocabularies, the instance of the term SHOULD be defined only once and the all occurrences SHOULD be resolved from the original CORDRA ID.
When there is a discrepancy between the human readable and the machine processable definition of a vocabulary, the machine readable representation SHALL be definitive.
When a CORDRA vocabulary is cited without reference to version, the most recent version SHALL be used.
Each CORDRA vocabulary SHALL be assigned a version number. The version number SHALL change with each publication and official release of the vocabulary. The version number SHALL be included in all machine processable representations of the vocabulary.
A CORDRA vocabulary or vocabulary version that has status draft has not been officially released. The vocabulary MAY be modified without changing the version number.
CORDRA vocabulary terms MAY be versioned.
The definition of a term in a CORDRA vocabulary MAY be translated into different languages.
The token for the term in a CORDRA vocabulary SHALL NOT be translated.
| Version | ID | Date | Change Summary |
|---|---|---|---|
| 1.00 | H | 20041018 | Initial release |
| 20050101 | Editorial changes |