Specification Metadata (SM) Vocabulary
type: Ontology
specification name or title: Specification Metadata (SM) Ontology
specification abbreviation or acronym: SM
specification abstract: This ontology provides a set of basic metadata annotations for use in describing Object Management Group (OMG) specifications, standards, and documents. It was recommended for use by the OMG Architecture Board (AB) in OMG standard ontologies, vocabularies and other models at the March 2013 Reston meeting. The annotations defined herein extend properties defined in the Dublin Core Metadata Terms Vocabulary and in the W3C Simple Knowledge Organization System (SKOS) Vocabulary, and have been customized to support the OMG specification development process. Note that any of the original properties provided in Dublin Core and SKOS can be used in addition to the terms provided herein. However, any Dublin Core terms that are not explicitly defined as OWL annotation properties below must be so declared in the ontologies that use them.
related specification: http://www.metadata-standards.org/24706/index.html
source: http://www.omg.org/cgi-bin/doc
depends on: http://purl.org/dc/terms/
depends on: http://www.w3.org/2004/02/skos/core.rdf
topic area: analysis and design
keyword: specification metadata
publication date: 2014-08-18T18:00:00
specification version URL: http://www.omg.org/techprocess/ab/20140801/SpecificationMetadata/
specification version status: OMG Architecture Board Recommendation
history note: Revisions are managed per the process outlined in the Policies and Procedures for OMG standards, with the intent to maintain backwards compatibility to the degree possible. The RDF/XML serialized OWL corresponding to the ODM/OWL model has been checked for syntactic errors and logical consistency with Protege 4 (http://protege.stanford.edu/), HermiT 1.3.8 (http://www.hermit-reasoner.com/) and Pellet 2.2 (http://clarkparsia.com/pellet/).
change note: The ontology was revised in August 2014 to: (1) clean up the metadata about this ontology to reflect current usage (2) add support for OMG issue resolution detail to facilitate change management and automated specification generation (3) modify the approach to inclusion of licensing information in model metadata to reference an individual of type dct:LicenseDocument, contained in this metadata ontology, rather than requiring the text to be repeated in any ontology published by the OMG
change note: The ontology was revised in July, 2013, as follows: (1) to use slash style URI/IRIss (also called 303 URIs, vs. hash style) as required to support server side processing and specifically for the Financial Industry Business Ontology (FIBO) and other forthcoming OMG ontology specifications (2) to introduce the use of version-independent IRIs for all definitions internally as opposed to version-specific IRIs (3) to change the file suffix from .owl to .rdf to increase usability in RDF tools (4) to extend the file-level metadata to allow for cases such as FIBO, where the specification includes family, specification, spcification version, module, and ontology level detail that should be documented via annotations (e.g., family level of FIBO, specification level of Foundations, module level such as Utilities, and ontology level including annotation vocabulary, business types, and relations) (5) to make other minor corrections in the metadata and definitions for clarification purposes
addressForComments: http://www.omg.org/issues/
copyright: Copyright (c) 2012-2014 Adaptive Copyright (c) 2012-2014 Object Management Group, Inc. Copyright (c) 2012-2014 Thematix Partners LLC
license: The MIT License
responsible task force: http://www.omg.org/news/about/ab.htm
electronic file name: SpecificationMetadata.rdf
version IRI: SpecificationMetadata
is normative: true
prior version: http://www.omg.org/techprocess/ab/20130701/SpecificationMetadata/
prior version: http://www.omg.org/techprocess/ab/20130301/SpecificationMetadata.owl
content language: http://www.w3.org/standards/techs/owl#w3c_all
imports: core

specification family title
type: AnnotationProperty
definition: specification family title (for example, Financial Industry Business Ontology)
sub property of: title
domain: specification family
range: string
sub property of: prefLabel

specification family abbreviation or acronym
type: AnnotationProperty
definition: abbreviation or acronym for the specification family
domain: specification family
range: string
sub property of: altLabel

specification family URL
type: AnnotationProperty
definition: URL where the specification family is published
domain: specification family
range: anyURI

family abstract
type: AnnotationProperty
definition: a short textual description of the family of specifications
sub property of: abstract
domain: specification family
range: string

specification name or title
type: AnnotationProperty
definition: the full (complete) formal title of the specification, without abbreviations
sub property of: title
domain: specification
range: string

specification abbreviation or acronym
type: AnnotationProperty
definition: official abbreviation or acronym for the specification and related electronic files
domain: specification
range: string
sub property of: altLabel

short name for the specification or module
type: AnnotationProperty
definition: a short, commonly used, or preferred name, for a given specification or module
sub property of: title
domain: specification
range: string
sub property of: prefLabel

specification URL
type: AnnotationProperty
definition: URL for the specification directory on the OMG web site
domain: specification
range: anyURI

formal version
type: AnnotationProperty
definition: a link to the latest published formal specification (document)
sub property of: hasVersion
domain: specification
range: anyURI

specification abstract
type: AnnotationProperty
definition: a short textual description for the specification
sub property of: abstract
domain: specification
range: string

copyright
type: AnnotationProperty
definition: copyright statement for the specification version, content, or model/electronic file
sub property of: rights
range: string

submitter
type: AnnotationProperty
definition: a contributor that is an OMG member, identified member of the submission team, and filed the requisite LOI, responsible for the content of the specification or model
domain: specification
sub property of: contributor

responsible task force
type: AnnotationProperty
definition: task force or working group responsible for the original RFP/RFC and specification adoption
domain: specification
range: anyURI

editor
type: AnnotationProperty
definition: an editor of the specification, which may include the primary contact organization, or RTF/FTF co-chair (organization), depending on where the specification is in the process
sub property of: contributor

contributor
type: AnnotationProperty
definition: an organization or individual that has made a significant contribution to the specification
sub property of: contributor

revised by
type: AnnotationProperty
definition: task force or working group responsible for this revision of the specification

related specification
type: AnnotationProperty
definition: specification or standard (range can be xsd:string, xsd:anyURI, or BibliographicCitation)
sub property of: references
domain: specification
range: specification

normative reference
type: AnnotationProperty
definition: a normative reference or standard for the specification
sub property of: references
range: specification
domain: specification

informative reference
type: AnnotationProperty
definition: informative reference, standard, or document
sub property of: references
domain: specification
range: specification

direct source
type: AnnotationProperty
definition: reference used as a primary, direct source for content in developing this specification or model (range can be a string, URI, or BibliographicCitation)
sub property of: source

depends on
type: AnnotationProperty
definition: a bibliographic reference for and/or URL of any electronic files or documents (e.g., document version URL if applicable) on which this specification or model depends; if the model contains multiple modules, then dependencies should reflect those of the model in question
sub property of: seeAlso

keyword
type: AnnotationProperty
definition: keyword relevant to the specification
editorial note: may appear more than once, as appropriate
sub property of: subject
domain: specification
range: string

technology area
type: AnnotationProperty
editorial note: may appear more than once, as appropriate
definition: technology area relevant to the specification, for example, analysis and design, business process modeling, information exchange and interoperability, middleware, etc.
sub property of: subject
domain: specification
range: string

topic area
type: AnnotationProperty
editorial note: may appear more than once, as appropriate
definition: topic or area of interest that this particular specification relates to, for example, real time, robotics
sub property of: subject
domain: specification
range: string

this version
type: AnnotationProperty
definition: the version identifier for this version of the specification
sub property of: hasVersion
domain: specification version
range: string

prior specification version
type: AnnotationProperty
definition: a link to the immediately preceding OMG formal specification version
sub property of: hasVersion
domain: specification version
range: anyURI

specification version URL
type: AnnotationProperty
definition: explicit URI where the specification version is published
domain: specification version
range: anyURI

publication date
type: AnnotationProperty
definition: the date this version of the specification was published
sub property of: issued
domain: specification version
range: dateTime

specification version status
type: AnnotationProperty
definition: status of this version of the specification from a process perspective, including whether or not it has been formally adopted or superseded by a newer version
domain: specification version
range: string
sub property of: note

affects model element
type: AnnotationProperty
domain: issue resolution

task force report
type: AnnotationProperty
definition: a link to the FTF or RTF report, if applicable
domain: specification version
range: anyURI

addressForComments
type: AnnotationProperty
definition: a link to a mailing list or web page where questions, discussion, and issues can be raised
domain: specification version
range: anyURI

module name
type: AnnotationProperty
definition: module name, if distinct from the specification title
sub property of: title
domain: module
range: string

module abbreviation or acronym
type: AnnotationProperty
definition: abbreviation or acronym for the module, if distinct from that of the specification
domain: module
range: string
sub property of: altLabel

module version
type: AnnotationProperty
definition: module version, if distinct from the specification version
sub property of: hasVersion
domain: module
range: string

module short title
type: AnnotationProperty
definition: a short title for the component or module
sub property of: title
domain: module
range: string
sub property of: prefLabel

module abstract
type: AnnotationProperty
definition: a short textual description of the module
sub property of: abstract
domain: module
range: string

electronic file name
type: AnnotationProperty
definition: name of the electronic document or file this metadata is associated with
range: string

file version
type: AnnotationProperty
definition: file version, if distinct from the specification or module version
sub property of: hasVersion
range: string

file-level abbreviation or acronym
type: AnnotationProperty
definition: abbreviation or acronym for the file, such as a namespace prefix, if distinct from that of the specification
range: string
sub property of: altLabel

file-level abstract
type: AnnotationProperty
definition: a short textual description of the model or file
sub property of: abstract
range: string

prior version
type: AnnotationProperty
definition: a link to the immediately preceding version at the file level
sub property of: hasVersion
range: string

document number
type: AnnotationProperty
definition: OMG document number (for the document or file this metadata is associated with); note that a single OMG document number may be associated with many files, for example in the case of an archive containing all of the ontologies associated with a given FIBO specification
sub property of: identifier
range: string

URL for the document
type: AnnotationProperty
definition: document URL (for the specific document or model file this metadata is associated with)
range: anyURI

is normative
type: AnnotationProperty
definition: boolean value indicating whether or not the file is a normative component of a specification
range: boolean

content type
type: AnnotationProperty
definition: indicates the content type, for example, MOF metamodel, UML profile, UML model, SBVR or RDF vocabulary, OWL or CL ontology
range: content type

content language
type: AnnotationProperty
definition: a link to the core language and/or specification of the model/electronic file, for example, UML, OWL, SysML, BPMN, including linking to the version of the language in question
sub property of: type
range: anyURI

format
type: AnnotationProperty
definition: serialization format for the file in terms of its MIME Type, such as xmi, rdf/xml, owl/xml, etc.
sub property of: format
range: MIME MediaType

author
type: AnnotationProperty
definition: Author identifies an individual or organization that originated the model or specification (range can be a dct:Agent or string).
sub property of: creator

has specification version
type: ObjectProperty
definition: relates a 'master' or umbrella specification to specific versions of that specification, created through a finalization or revision process
domain: specification
range: specification version

is reflected in
type: ObjectProperty
domain: issue resolution
range: specification version
inverse of: reflects

is version of
type: ObjectProperty
definition: relates a given version of a specification to the 'master' or original specification that it modifies
range: specification
domain: specification version
inverse of: has specification version

reflects
type: ObjectProperty
range: issue resolution
domain: specification version

has description
type: DatatypeProperty
domain: issue resolution
range: string

has issue reference
type: DatatypeProperty
domain: issue resolution
range: anyURI

is identified by
type: DatatypeProperty
type: FunctionalProperty
domain: issue resolution
range: string

bibliographic citation
type: Class
subclass of: Concept
definition: a reference to an authoritative source for provenance or substatiation purposes; The form of bibliographic citation may be specific to a domain, publication, or community, thus specific properties to define the details are not provided. FRBR, ISO 690, and others provide reasonable approaches if none is explicitly required for a specification.

issue resolution
type: Class
subclass of: Concept
subclass of: Restriction
  on property: has issue reference
  qualified cardinality: 1
  on data range: anyURI
subclass of: Restriction
  on property: is identified by
  qualified cardinality: 1
  on data range: string
definition: An Issue is a report made to OMG of an error in an OMG Specification. An F/RTF Report lists the issues and comments received by the F/RTF against a specification, and the resolution, if any, for each comment (referred to by its Issue Number). For resolutions that involve changes to the models (machine readable artifacts) corresponding to the specification, an individual of type IssueResolution should be included in the administrative metadata for the version of the specification to which it applies, for each issue resolved, linking to the appropriate issue page in the OMG JIRA system where further information about the issue and how it was dealt with can be found.

MIME MediaType
type: Class
subclass of: Concept
definition: MIME media type as defined by the IANA standard

module
type: Class
subclass of: Concept
definition: Modularization of any engineering model involves principles of the model driven architecture methodology (MDA), including but not limited to separation of concerns, coherence, and establishing clear logical boundaries in order to increase reusability and maintainability. A module should be designed to reflect these principles, including a small number of models that have well-defined relationships with one another, that form a coherent and cohesive whole for some purpose, and that have clear boundaries or interfaces to other external modules.

organization
type: Class
subclass of: Concept
definition: an entity, such as an institution or an association, that has a collective goal and is linked to an external environment
source: http://en.wikipedia.org/wiki/Organization

specification
type: Class
subclass of: Concept
definition: an explicit set of requirements to be satisfied by a material, product, or service
source: http://en.wikipedia.org/wiki/Specification
alternative label: spec

specification family
type: Class
subclass of: Concept
definition: a family of specifications, such as the OMG's Financial Industry Business Ontology (FIBO) or the Information Exchange Framework (IEF)

specification version
type: Class
subclass of: Concept
subclass of: Restriction
  on property: is version of
  on class: specification
  qualified cardinality: 1
definition: a formal revision of a given specification, produced through the efforts of a finalization or revision task force

content type
type: Class
subclass of: Concept
definition: the content type for the model or module, for example, MOF metamodel, UML profile, UML model, vocabulary, ontology, ruleset, etc. The actual content language for the module (for example, RDF Schema, OWL, or SBVR in the case of a vocabulary) should be specified using the contentLanguage annotation property. Valid values are specified as individuals.

The MIT License
type: NamedIndividual
type: LicenseDocument
rights: The MIT License: Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
rights: http://opensource.org/licenses/mit-license.php
definition: license document representing the actual text of the MIT License