Mapping Specification Metadata and some properties in the FIBO Annotation Vocabulary to the Commons Annotation Vocabulary
The Commons Ontology Library (Commons) v1.0 Specification was approved for formalization at the December 2022 OMG Technical Meeting. The specification itself and the ontologies included are available on the OMG site at https://www.omg.org/spec/COMMONS and in GitHub at https://github.com/ObjectManagementGroup/Commons. FIBO has depended on the annotations in the OMG's Specification Metadata for many years, but they include technical debt that is not germane to FIBO, and may change as OMG requirements for their Specification Catalog evolve. Use of the Commons Ontology Library Annotation Vocabulary, which overlaps with the FIBO Annotation Vocabulary, is a far safer and more appropriate solution. Use of the Specification Metadata is being discontinued as a consequence. The annotations that are redundant with the new Commons Annotation Vocabulary are being deprecated in FIBO and will be eliminated from FIBO over time.
The table below includes the mapping from what we have used to date in FIBO to the corresponding replacement annotation for FIBO users to assist with transitioning their applications of FIBO to use the Commons Annotation Vocabulary plus a few additional annotations that remain in FIBO as appropriate. Annotations that are not mentioned in the table, such as dct:abstract, others from Dublin Core and SKOS will remain in use.
Vocabulary | Original Element | Original Element IRI | New Element | New Element IRI | Notes |
|---|---|---|---|---|---|
Specification Metadata | content language | sm:contentLanguage | n/a |
| This annotation is not needed as all of our ontologies are expressed in the W3C Web Ontology Language (OWL). |
| contributor | sm:contributor | contributor | dct:contributor |
|
| copyright | sm:copyright | copyright | cmns-av:copyright |
|
| depends on | sm:dependsOn | n/a |
| This annotation is largely redundant with ontology imports statements and is not needed. |
| filename abbreviation | sm:fileAbbreviation | n/a |
| This annotation is redundant with the declared prefix for an ontology and is not needed. |
| filename | sm:filename | n/a |
| This annotation is redundant with the local name of the ontology, based on file naming conventions for FIBO, and is not needed. |
| direct source | sm:directSource | direct source | cmns-av:directSource | The original annotation is only used in three FIBO ontologies: Agents, CurrencyAmount, and the ISO 4217 Currency codes and can be easily replaced. |
| related specification | sm:relatedSpecification | source | dct:source | The original annotation is only used in one FIBO ontology, Agents, and can be easily replaced. |
| Module | sm:Module | module | fibo-fnd-utl-av:Module |
|
FIBO Annotation Vocabulary | has maturity level | fibo-fnd-utl-av:hasMaturityLevel | has maturity level | fibo-fnd-utl-av:hasMaturityLevel | Retained |
| abbreviation | fibo-fnd-utl-av:abbreviation | abbreviation | cmns-av:abbreviation |
|
| adapted from | fibo-fnd-utl-av:adaptedFrom | adapted from | cmns-av:adaptedFrom |
|
| common designation | fibo-fnd-utl-av:commonDesignation | common designation | fibo-fnd-utl-av:commonDesignation | Retained |
| definition origin | fibo-fnd-utl-av:definitionOrigin | definition origin | fibo-fnd-utl-av:definitionOrigin | Retained |
| explanatory note | fibo-fnd-utl-av:explanatoryNote | explanatory note | cmns-av;explanatoryNote |
|
| logical definition | fibo-fnd-utl-av:logicalDefinition | logical definition | cmns-av:logicalDefinition |
|
| modified by | fibo-fnd-utl-av:modifiedBy | contributor | dct:contributor | This annotation was not used in any FIBO ontology. |
| modified on | fibo-fnd-utl-av:modifiedOn | modified | dct:modified | This annotation was not used in any FIBO ontology. |
| preferred designation | fibo-fnd-utl-av:preferredDesignation | preferred designation | fibo-fnd-utl-av:preferredDesignation | Retained |
| symbol | fibo-fnd-utl-av:symbol |
| cmns-av:symbol |
|
| synonym | fibo-fnd-utl-av:synonym |
| cmns-av:synonym |
|
| term origin | fibo-fnd-utl-av:termOrigin | term origin | fibo-fnd-utl-av:termOrigin | Retained |
| usage note | fibo-fnd-utl-av:usageNote |
| cmns-av:usageNote |
|