Open Information Model Common Definitions 1.0

Candidate Recommendation 07 July 2021

Copyright © XBRL International Inc., All Rights Reserved.

This version:
<http://www.xbrl.org/Specification/oim-common/CR-2021-07-07/oim-common-CR-2021-07-07.html>
Editors:
Paul Warren, XBRL International Inc. <pdw@xbrl.org>
Herm Fischer, Mark V Systems Limited <fischer@markv.com>
Mark Goodhand, CoreFiling <mrg@corefiling.com>
Contributors:
Daniel Dracott, CoreFiling <djd@corefiling.com>
Eleanor Joslin, CoreFiling <ejj@corefiling.com>

Status

Circulation of this Candidate Recommendation is unrestricted. This document is normative. Other documents may supersede this document. Recipients are invited to submit comments to oim@xbrl.org, and to submit notification of any relevant patent rights of which they are aware and provide supporting documentation.

Abstract

This document provides a set of common definitions used concrete representations of the XBRL Open Information Model.

Table of Contents

1 Introduction
1.1 Terminology
1.2 Namespaces and namespace prefixes
2 Document types
3 Definitions
3.1 SQName
3.2 Prefix map
3.3 URI map
3.4 Unit string representation
3.5 Period string representation
3.6 Space-separated list

Appendices

A References
B Intellectual property status (non-normative)
C Document History (non-normative)
D Errata Corrections incorporated in this document

Tables

1 Namespaces and reserved prefixes
2 Error code namespace prefix

Examples

1 Examples of standard string representation of units
2 Examples of period string representation

Definitions


Encoded URI
Lexicographic order
Period string representation
Prefix Map
Reserved prefix
Space-separated list
SQName
Unit string representation
URI
URI alias
URI Map

Error codes

oimce:invalidAliasForReservedURI
oimce:invalidPeriodRepresentation
oimce:invalidSQName
oimce:invalidURI
oimce:invalidURIAlias
oimce:invalidURIForReservedAlias
oimce:invalidUnitStringRepresentation
oimce:multipleAliasesForURI
oimce:multipleURIsForAlias
oimce:unboundPrefix 2
oimce:unsupportedDocumentType


1 Introduction

The XBRL Open Information Model provides a syntax-independent definition of the content of an XBRL report. A number of alternative syntaxes are defined as concrete representations of the model. In order to achieve consistency between these representations, this document provides a number of definitions which may be used across these different formats.

1.1 Terminology

The key words MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL, in this specification, are to be interpreted as described in [IETF RFC 2119].

The keywords expanded name, NCName and QName are to be interpreted as described in the XML Names specification [XML Names].

1.2 Namespaces and namespace prefixes

Many values in the Open Information Model are XML expanded names, that is, the combination of a namespace URI and a localname. This specification uses QName notation in the form prefix:localname to refer to these, where the prefix is a short string representing a full namespace URI. The prefixes used by this specification are defined below. These prefixes are reserved prefixes.

Table 1: Namespaces and reserved prefixes
Prefix Namespace URI
iso4217 http://www.xbrl.org/2003/iso4217
utr http://www.xbrl.org/2009/utr
xbrl https://xbrl.org/CR/2021-07-07
xbrli http://www.xbrl.org/2003/instance
xs http://www.w3.org/2001/XMLSchema

This specification also uses the following prefix for error codes. This prefix is not a reserved prefix.

Table 2: Error code namespace prefix
Prefix Namespace URI
oimcehttps://xbrl.org/CR/2021-07-07/oim-common/error

2 Document types

Most syntactic representations of the Open Information Model contain a "document type" string that identifies which specification and version the document conforms to. Processors MAY support multiple specificatons and versions. Processors MUST raise oimce:unsupportedDocumentType (or an equivalent code from a later version of this specification) if they encounter a document type that does not correspond to a specification that is supported by that processor, or if a document type is not present in the document.

3 Definitions

3.1 SQName

The Open Information Model makes extensive use of expanded names ([XML Names]) to provide globally unique identifiers. These are a namespace URI/localname pair. In order to reduce size and improve readability, it is convenient to use a QName-like mechanism for representing these (and some other) values, where the globally unique namespace-URI is replaced with a compact, document-scoped prefix. The mechanism used is referred to as an SQName ("Simplified QName").

An SQName is a compact, colon-separated represention of a URI/value pair, where a short, document-scoped, prefix is used to represent the URI.

An SQName MUST have the following format: (oimce:invalidSQName)

prefix:localname

Where prefix is an NCName and localname is any string. The prefix is resolved to a URI using the prefix map.

Unlike QNames, the localname can consist of any non-whitespace characters, including colon (":"); the prefix and localname in an SQName are separated by the first colon character.

3.2 Prefix map

A prefix map is a URI map that is used to resolve the prefix component of a QName or SQName to a URI.

The prefix for a QName or SQName  MUST correspond to a key in the prefix map (oimce:unboundPrefix).

A reserved prefix is a reserved URI alias that is specified as applying to a prefix map.

3.3 URI map

A URI map is a set of key/value pairs that is used to resolve URI aliases to full URIs. A URI alias is an NCName used to provide a limited scope short name for a URI. The location and format of a URI map is defined by the specification for the representation in which it is used, but it MUST conform to the following constraints:

This specification uses the term URI to refer to a value that conforms to the xs:anyURI datatype [XML Schema Datatypes]. Such a value can be transformed into a value that conforms with the [RFC2396]/[RFC2732] definition of a URI reference by applying the URI reference escaping procedure described in [XML Schema Datatypes]. This specification uses the term encoded URI to refer to the result of this applying the URI reference escaping procedure.

  1. URI aliases MUST NOT be empty, and MUST be valid NCNames (oimce:invalidURIAlias).
  2. A URI MUST NOT be bound to more than one URI alias within the map (oimce:multipleAliasesForURI).
  3. A URI alias MUST NOT be bound to more than one URI within the map (oimce:multipleURIsForAlias).
  4. A reserved URI alias MUST only be bound to the URI prescribed for that URI alias (oimce:invalidURIForReservedAlias).
  5. URIs MUST be valid according to the xs:anyURI datatype [XML Schema Datatypes], and the encoded URI MUST be an absolute URI Reference [RFC2396]/[RFC2732] (oimce:invalidURI).
  6. A URI for which a reserved URI alias is prescribed MUST NOT be bound to any other URI alias (oimce:invalidAliasForReservedURI).

A reserved URI alias is any URI alias identified as being reserved by either this specification (see Section 1.2) or the specification defining the inclusion of the URI map.

URIs in this specification are used purely as unique identifiers, and should be compared using simple, case-sensitive string comparison. Percent-encoded characters are not considered equivalent to literal, unencoded characters.

It should be noted that some of the constraints listed above, such as the requirement for URI aliases to be unique within the map, may be enforced by syntactic or structural constraints of the format in which the map is represented. In this case, implementations should raise the appropriate error for that format, rather than the code listed above.

3.4 Unit string representation

The unit core dimension defines units in terms of the combination of QNames by defining an unordered collection of numerators and an unordered collection of denominators. Reflecting this in concrete representations can be somewhat cumbersome, particularly as analysis the structure of units is expected to be a relatively uncommon operation compared to simply comparing units for equivalence, or rendering them to a user.

This section defines a standardised unit string representation, allowing units to be captured using a unique string value. This has the property that, provided that a consistent set of namespace prefixes are used, a given unit will have a single representation meaning that equivalence of units can be determined by string comparison.

The unit string representation is obtained as follows:

  1. If {denominators} is not present, the QNames representing the {numerators} are combined in lexicographic order, separated by the "*" character.
  2. Otherwise, lists of {numerators} and {denominators} are created by combining QNames in lexicographic order and separating with the "*" character, as above. If a list contains more than one item, the list is enclosed in parentheses, "(" and ")". The final string is then obtained by concatenating the list of numerators, the "/" character, and the list of denominators.

Whitespace is not permitted anywhere in the string representation, and the use of QNames ensures that a 1:1 mapping between prefixes and namespaces is available thus ensuring that equivalent units appearing within the same document are represented with the same string.

Lexicographic order means ordered based on comparison of Unicode code point values of each character.

Processors MUST raise oimce:invalidUnitStringRepresentation if they encounter a unit string representation that does not conform to the syntax described above. If any QNames in the unit string representation use a prefix that is not defined in the prefix map then oimce:unboundPrefix MUST be raised.

Example 1: Examples of standard string representation of units

The following list show a set of valid unit string representations.

  • iso4217:EUR
  • iso4217:EUR/xbrli:shares
  • utr:m*utr:m
  • utr:kg/(utr:m*utr:m)
  • (utr:m*utr:m*utr:m)/utr:S

3.5 Period string representation

The period core dimension takes a value that is a time interval, which may be zero-length (i.e. an instant). This section defines a standard period string representation which can be used to express such values.

The period string representation is obtained as follows:

  1. If the value is a non-zero length interval, then the representation is a pair of ISO 8601 date-time values, separated by the "/" character;
  2. Otherwise, the value is a single ISO 8601 date-time value.

The date-time values used in this representation MUST be valid according to the xs:dateTime datatype and MUST be in the canonical lexical representation. The error code oimce:invalidPeriodRepresentation MUST be raised for values that are required to be a period string representation and which do not conform to the above format.

It should be noted that unlike the xbrli:dateUnion type used in xBRL-XML, the xs:dateTime datatype used here does not allow the time component to be omitted.

Example 2: Examples of period string representation

  • 2019-01-01T00:00:00/2020-01-01T00:00:00
  • 2020-01-01T00:00:00
  • 2020-01-01T00:00:00Z

3.6 Space-separated list

A space-separated list is a string containing items that are separated by a single space character (unicode 0x20). The list MUST NOT contain sequences of more than one space character, or space characters at the beginning or end of the string.

Appendix A References

IETF RFC 2119
IETF (Internet Engineering Task Force).
"RFC 2119: Key words for use in RFCs to Indicate Requirement Levels"
Scott Bradner.
OIM
XBRL International Inc..
"XBRL Open Information Model"
Paul Warren.
RFC2396
IETF (Internet Engineering Task Force).
"RFC 2396: Uniform Resource Identifier (URI): Generic Syntax"
T. Berners-Lee
, L. Masinter, and R. Fielding.
RFC2732
IETF (Internet Engineering Task Force).
"RFC 2732: Uniform Resource Identifier (URI): Generic Syntax"
R. Hinden
, B. Carpenter, and L. Masinter.
XML Names
W3C (World Wide Web Consortium).
"Namespaces in XML 1.0 (Third Edition)"
XML Schema Datatypes
W3C (World Wide Web Consortium).
"XML Schema Part 2: Datatypes Second Edition"
Paul V. Biron
, and Ashok Malhotra.

Appendix B Intellectual property status (non-normative)

This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to XBRL International or XBRL organizations, except as required to translate it into languages other than English. Members of XBRL International agree to grant certain licenses under the XBRL International Intellectual Property Policy (www.xbrl.org/legal).

This document and the information contained herein is provided on an "AS IS" basis and XBRL INTERNATIONAL DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

The attention of users of this document is directed to the possibility that compliance with or adoption of XBRL International specifications may require use of an invention covered by patent rights. XBRL International shall not be responsible for identifying patents for which a license may be required by any XBRL International specification, or for conducting legal inquiries into the legal validity or scope of those patents that are brought to its attention. XBRL International specifications are prospective and advisory only. Prospective users are responsible for protecting themselves against liability for infringement of patents. XBRL International takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Members of XBRL International agree to grant certain licenses under the XBRL International Intellectual Property Policy (www.xbrl.org/legal).

Appendix C Document History (non-normative)

DateAuthorDetails
14 December 2016Paul Warren

Candidate Recommendation. The contents of this specification were previously included in Public Working Drafts of the xBRL-JSON and OIM specifications.

02 May 2017Paul Warren

Second Candidate Recommendation

12 December 2018Paul Warren

Third Candidate Recommendation

12 June 2019Paul Warren

Fourth Candidate Recommendation

07 May 2020Paul Warren

Fifth Candidate Recommendation

14 October 2020Paul Warren

Sixth Candidate Recommendation

03 February 2021Paul Warren

Seventh Candidate Recommendation

07 July 2021Paul Warren

Eighth Candidate Recommendation

Appendix D Errata Corrections incorporated in this document

This appendix contains a list of the errata that have been incorporated into this document. This represents all those errata corrections that have been approved by the XBRL International Specification Maintenance Working Group (SWG) up to and including 07 July 2021. Hyperlinks to relevant e-mail threads may only be followed by those who have access to the relevant mailing lists. Access to internal XBRL mailing lists is restricted to members of XBRL International Inc.

No errata have been incorporated into this document.