Scope
OMG GraphArch rendering of the Commons 1.3 formal specification
- Copyright © 2024-2025, Adaptive Analytics, Inc.
- Copyright © 2022-2025, agnos.ai U.K. Ltd.
- Copyright © 2024-2025, Airbus Group
- Copyright © 2024-2025, Boeing
- Copyright © 2024-2025, Dassault Systèmes
- Copyright © 2024-2025, DEKonsult
- Copyright © 2022-2026, EDM Council, Inc. d/b/a EDM Association
- Copyright © 2024-2025, 88Solutions
- Copyright © 2022-2025, Federated Knowledge, LLC
- Copyright © 2024-2025, GfSE e.V.
- Copyright © 2024-2025, Mayo Clinic
- Copyright © 2022-2025, OntoAge
- Copyright © 2024-2025, Ontogenesis Solutions, LLC
- Copyright © 2023-2025, Pistoia Alliance
- Copyright © 2024-2025, ProSTEP iViP Association
- Copyright © 2024-2025, Raytheon Technologies
- Copyright © 2022, QuoteWell, Inc.
- Copyright © 2024-2025, Sparx Systems Pty Ltd
- Copyright © 2022-2025, Stardog Union
- Copyright © 2022-2025, Thematix Partners LLC
- Copyright © 2022-2025, University of North Florida
- Copyright © 2022-2025, Working Ontologist
- Copyright © 2022-2026, Object Management Group, Inc.
USE OF SPECIFICATION – TERMS, CONDITIONS & NOTICES
The material in this document details an Object Management Group specification in accordance with the terms, conditions and notices set forth below. This document does not represent a commitment to implement any portion of this specification in any company's products. The information contained in this document is subject to change without notice.
LICENSES
The companies listed above have granted to the Object Management Group, Inc. (OMG) a nonexclusive, royalty-free, paid up, worldwide license to copy and distribute this document and to modify this document and distribute copies of the modified version. Each of the copyright holders listed above has agreed that no person shall be deemed to have infringed the copyright in the included material of any such copyright holder by reason of having used the specification set forth herein or having conformed any computer software to the specification.
Subject to all of the terms and conditions below, the owners of the copyright in this specification hereby grant you a fully-paid up, non-exclusive, nontransferable, perpetual, worldwide license (without the right to sublicense), to use this specification to create and distribute software and special purpose specifications that are based upon this specification, and to use, copy, and distribute this specification as provided under the Copyright Act; provided that: (1) both the copyright notice identified above and this permission notice appear on any copies of this specification; (2) the use of the specifications is for informational purposes and will not be copied or posted on any network computer or broadcast in any media and will not be otherwise resold or transferred for commercial purposes; and (3) no modifications are made to this specification. This limited permission automatically terminates without notice if you breach any of these terms or conditions. Upon termination, you will destroy immediately any copies of the specifications in your possession or control.
PATENTS
The attention of adopters is directed to the possibility that compliance with or adoption of OMG specifications may require use of an invention covered by patent rights. OMG shall not be responsible for identifying patents for which a license may be required by any OMG specification, or for conducting legal inquiries into the legal validity or scope of those patents that are brought to its attention. OMG specifications are prospective and advisory only. Prospective users are responsible for protecting themselves against liability for infringement of patents.
GENERAL USE RESTRICTIONS
Any unauthorized use of this specification may violate copyright laws, trademark laws, and communications regulations and statutes. This document contains information which is protected by copyright. All Rights Reserved. No part of this work covered by copyright herein may be reproduced or used in any form or by any means--graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems--without permission of the copyright owner.
DISCLAIMER OF WARRANTY
WHILE THIS PUBLICATION IS BELIEVED TO BE ACCURATE, IT IS PROVIDED "AS IS" AND MAY CONTAIN ERRORS OR MISPRINTS. THE OBJECT MANAGEMENT GROUP AND THE COMPANIES LISTED ABOVE MAKE NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS PUBLICATION, INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF TITLE OR OWNERSHIP, IMPLIED WARRANTY OF MERCHANTABILITY OR WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE OR USE. IN NO EVENT SHALL THE OBJECT MANAGEMENT GROUP OR ANY OF THE COMPANIES LISTED ABOVE BE LIABLE FOR ERRORS CONTAINED HEREIN OR FOR DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, RELIANCE OR COVER DAMAGES, INCLUDING LOSS OF PROFITS, REVENUE, DATA OR USE, INCURRED BY ANY USER OR ANY THIRD PARTY IN CONNECTION WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS MATERIAL, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
The entire risk as to the quality and performance of software developed using this specification is borne by you. This disclaimer of warranty constitutes an essential part of the license granted to you to use this specification.
RESTRICTED RIGHTS LEGEND
Use, duplication or disclosure by the U.S. Government is subject to the restrictions set forth in subparagraph (c) (1) (ii) of The Rights in Technical Data and Computer Software Clause at DFARS 252.227-7013 or in subparagraph (c)(1) and (2) of the Commercial Computer Software - Restricted Rights clauses at 48 C.F.R. 52.227-19 or as specified in 48 C.F.R. 227-7202-2 of the DoD F.A.R. Supplement and its successors, or as specified in 48 C.F.R. 12.212 of the Federal Acquisition Regulations and its successors, as applicable. The specification copyright owners are as indicated above and may be contacted through the Object Management Group, 9C Medway Road, PMB 274, Milford, MA 01757, U.S.A.
TRADEMARKS
CORBA®, CORBA logos®, FIBO®, Financial Industry Business Ontology®, FINANCIAL INSTRUMENT GLOBAL IDENTIFIER®, IIOP®, IMM®, Model Driven Architecture®, MDA®, Object Management Group®, OMG®, OMG Logo®, SoaML®, SOAML®, SysML®, UAF®, Unified Modeling Language®, UML®, UML Cube Logo®, VSIPL®, and XMI® are registered trademarks of the Object Management Group, Inc.
For a complete list of trademarks, see: https://www.omg.org/legal/tm_list.htm. All other products or company names mentioned are used for identification purposes only, and may be trademarks of their respective owners.
COMPLIANCE
The copyright holders listed above acknowledge that the Object Management Group (acting itself or through its designees) is and shall at all times be the sole entity that may authorize developers, suppliers and sellers of computer software to use certification marks, trademarks or other special designations to indicate compliance with these materials.
Software developed under the terms of this license may claim compliance or conformance with this specification if and only if the software compliance is of a nature fully matching the applicable compliance points as stated in the specification. Software developed only partially matching the applicable compliance points may claim only that the software was based on this specification but may not claim compliance or conformance with this specification. In the event that testing suites are implemented or approved by Object Management Group, Inc., software developed using this specification may claim compliance or conformance with the specification only if the software satisfactorily completes the testing suites.
OMG’s Issue Reporting Procedure
All OMG specifications are subject to continuous review and improvement. As part of this process, we encourage readers to report any ambiguities, inconsistencies, or inaccuracies they may find by completing the Issue Reporting Form listed on the main web page https://www.omg.org, under Specifications, Report a Bug/Issue (https://issues.omg.org/issues/create-new-issue).
1. Scope§
1.1 Introduction§
The Commons Ontology Library is designed to provide a useful set of modeling constructs that are reusable in different modeling and data deployment environments with minimal commitments. It is intended to be extensible such that new ontologies and potentially other models (for example, UML models corresponding to the ontologies) can be added as cross-domain requirements present themselves. These requirements may come from other OMG standards efforts or potentially from external users of the library, for example, the Industrial Ontology Foundry (IOF) manufacturing community, EDM Council projects with the Pistoia Alliance IDMP pharmaceutical community, and others.
1.2 Criteria for Inclusion§
Ontologies and other models will be identified primarily by drawing on other work, although care must be taken to ensure that intellectual property and other legal rights are addressed, and that standardization is desired by the user community. Oversight for curation of the library will be managed by the Commons revision task force (RTF) via the normal OMG process. The minimum criteria identified to date for inclusion include: (1) the need for the same set of concepts with the same semantics across multiple specifications and/or domain areas, such as manufacturing, finance and/or retail, (2) a clear set of use cases, competency questions, and test cases that can help limit the scope for a given ontology and provide the basis for regression testing, (3) reusability in their own right with minimal dependencies on other ontologies with the possible exception of other Commons ontologies, and (4) that the ontologies meet minimal requirements for metadata, logical consistency, and serialization (e.g., RDF/XML and Turtle serialized OWL, for OWL ontologies).
1.3 Overview§
The Commons Ontology Library of ontologies specified herein covers:
(1) Annotations
- A reusable set of declarations for commonly used annotation properties from the Dublin Core Metadata Initiative (DCMI) Terms1 and the Simple Knowledge Organization System (SKOS)2, so that these vocabularies can be reused without importing either.
- Additional annotation properties that provide metadata for documentation that is not explicitly available in either Dublin Core or SKOS.
(2) Collections:
- Collections – commonly used concepts for arrangements and schemes for organizing information and collections of things, such as structured collections that may be organized according to some scheme and related very high-level mereology relations to enable association of things with such collections and schemes.
- Structured Collections – an extension to collections that defines chronologically and indexed collections as well as sets and lists.
(3) Roles and Compositions:
- The notion of a composition that can be used, for example to relate something, such as a product or recipe, to its ingredients or constituents, and/or to the roles such constituents play in the composition, and optionally to some context, such as a jurisdiction, in which the composition is relevant.
- The concept of a role, supporting the representation of participants in compositions, situations, and relationships, as well as properties that link the role to something that plays that role, that links something to a role it has (e.g., a role that is pertinent to a situation or composition), as well as inverses that enable role traversal in a graph.
(4) Designations:
- Designators - commonly used concepts for naming, derived in part from the patterns defined in ISO 1087 for terminology work and ISO 11179-3, Metadata Registries. The top-level designators ontology includes several very high-level semiotic relationships, including defines, describes, and denotes for associating designators with the concepts they reference.
- Contextual Designators – an extension to the designators ontology to incorporate applicable dates and times and facilitate the inclusion of other context that is commonly needed, derived in part from the patterns defined in ISO 11179-3, Metadata Registries.
- Codes and Code Sets - commonly used concepts for describing codes, including standardized codes such as ISO language, country, and other code sets, the North American Industry Classification System (NAICS) codes, and custom code sets that many organizations develop for various purposes, derived from the patterns specified in ISO 11179-3, Metadata Registries.
- Identifiers - commonly used concepts for describing identifiers and the identification schemes that define them, such as various national and international identifiers for legal entities, financial instruments, and the like, derived from the patterns specified in ISO 11179-3, Metadata Registries.
- Contextual Identifiers – an extension to the contextual designators and identifiers ontologies covering concepts for describing more complex identifiers, including those that apply for some period of time as well as those that are structured and include other codes or identifiers.
- Languages – High-level concepts defining languages, including natural as well as formal languages, based on a number of standards including but not limited to ISO 639 as well as the language element of the Language Tag specified in BCP 47 (RFC 4646, RFC 4647). The concept of a language is included here to normalize definitions across the Application Programming Interfaces for Knowledge Platforms (API4KP), Distributed Ontology, Model, and Specification Language (DOL), Languages, Countries, and Codes (LCC), and Multiple Vocabulary Facility (MVF) standards to support interoperability, and for use in other OMG and external ontology projects.
(5) Classifiers:
- Abstract concepts for representation of classification schemes that enable the classification of arbitrary concepts into hierarchies (or partial orders) for use in other ontologies, derived in part from the patterns defined in ISO 1087-1 for terminology work and ISO 11179-3, Metadata Registries.
(6) Locations:
- Locations – Very high-level definitions of geographic region and geopolitical entity related concepts, including, but not limited to, countries, sub-country regions such as states and provinces, and municipalities, derived from a combination of ISO 3166, the UN M49 Region codes, Geonames, and other sources.
- Sites and Facilities – High-level concepts related to facilities, both virtual and physical, including sites that provide the context for various facilities.
(7) Parties :
- Parties and Situations – The concepts of agent, agent role, party, party role, and situation, which is a state of affairs or reified relationship that holds for some period of time, including lattice relations between the concepts driven by property chains that can be used to access the lattice from any perspective in the resulting graph.
- Organizations – an extension of the parties and situations and locations ontologies that defines organization, legal entity, organization membership, and related identifiers, as well as service and service provider, designed to enable mapping to other organization ontologies such as the W3C Organizations ontology.
- Business Authorizations – the concept of authorization from a business perspective, rather than security or access control viewpoint, as a situation or state of affairs, including related parties. This extension is needed to cover a range of requirements from retail, for example for defining digital signatures, as well as for banking and pharmaceuticals, for defining marketing and manufacturing authorizations for medicines.
- Registration Authorities – a small ontology that extends organizations defining registration authorities, registrars, registration-specific identifiers and related identification schemes, modeled after patterns included in ISO/IEC 11179-3.
- Regulatory Agencies – an extension of locations and organizations that specifies concepts including regulatory agencies, also known as regulatory authorities or regulators, and their jurisdictions.
(8) Quantities and Units:
- Documents - a small documents ontology that can be mapped to others, such as FRBR, to support representation of references and reference documents required for documenting certain units.
- Quantities and Units - an ontology defining scalar quantities and units, corresponding to the quantities and units library in SysML v2 covering the key concepts required for most domains, including but not limited to measurement scales, quantity kinds, dimensions, scalar quantities and scalar units.
(9) Time:
- Dates and Times - commonly used temporal concepts that cover those most frequently needed across domains, with a focus on terminology that is used in business applications. It is designed to be mappable to other date and time ontologies and specifications, such as the W3C Time Ontology in OWL3, certain temporal elements in ISO Basic Formal Ontology4, time concepts defined in schema.org, and the OMG Date Time Vocabulary (DTV) specification, without the corresponding overhead, or in some cases, issues. The concepts were originally derived from a number of date and time standards including ISO 8601:2004 Representation of Dates and Times.
- Mapping Dates and Times to OWL Time – an extension to the dates and times ontology to map it to the widely used W3C Time Ontology in OWL recommendation.
(10) Text Datatype:
- A custom datatype that combines language tagged and plain string values. This text datatype is useful in cases where it is not clear whether string values will be tagged or not, but where it is anticipated that multilingual strings might be appropriate.
Each of these ontologies is defined below.
1.4 Metadata§
Annotations on concepts, properties, and individuals in this specification follow the general policies recommended by the OMG Architecture Board, including the use of (1) the Dublin Core Metadata Terms [Dublin Core], (2) the Simple Knowledge Organization System (SKOS) [SKOS], and (3) the annotation vocabulary included in the Commons Ontology Library. Every element in the ontologies defined in the Commons Ontology Library must have a label and definition, and in many cases, the source for the definitions, such as an ISO or other OMG standard, is referenced. Examples are also included as appropriate, along with other notes that may assist users in understanding and reusing the ontology.
Dublin Core Metadata Initiative (DCMI), DCMI Metadata Terms -- https://www.dublincore.org/specifications/dublin-core/dcmi-terms/
Simple Knowledge Organization System (SKOS) -- https://www.w3.org/TR/2009/REC-skos-reference-20090818/
Available at https://www.omg.org/TR/owl-time