Metamodel Changes

General

This Annex lists the changes from version to version of the metamodel together with major changes in the overall document. Non-backward compatible changes (nc) are marked as such.

nc="x" means not backward compatible, if no value is added in the table, the change is backward compatible.

nc="(x)" means that the change made was implicitly contained or stated in the document before and is now being formalized. Therefore, the change is considered to be backward compatible.

Changes for the data specification templates of the metamodel are listed in separate tables each.

Each subclause consists of three parts:

  • changes w.r.t. previous version,

  • new elements in metamodel w.r..t previous version,

  • new, changed, or removed Constraints w.r.t previous version.

Changes V3.1 vs. V3.0.2

Major changes:

  • Transfer from .docx to asciidoc

  • Update Terms and Definitions to be compliant to IEC63278-1:2023 and other parts of specification

Minor changes:

  • add sentence (again) stating that the template ID is conformant to the rules for semantic IDs for data specifications as defined in Part 1 of the document series

  • added note: This specification is only valid in combination with IDTA-01001-3-1.

  • editorial

Table 1. Changes in Metamodel V3.1
nc V3.1 vs. V3.0.2 Comment

ValueTypeIec61360

Change length of data type from 2000 to 2048

Changes V3.0.2 vs. V3.0.1

Bugfixes:

  • all constraints corrected that mention data specification template ID: instead of complete version "3/0" only major version "3"

+ added note in Annex “Handling of Constraints”: If a constraint is mentioning the id of the Template, then the same constraints shall also be valid for deprecated data specification template IDs

  • change numbering of constraints that do not yet had "-3a" in their name

Table 2. New, Changed or Removed Constraints in V3.0.2
nc V3.0.2 vs. V3.0.1 New, Update, Removed, Reformulated, Renamed Comment

AASc-002

Renamed

renamed to AASc-3a-002

AASc-3a-003

Update

Now https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3

AASc-3a-003: For a ConceptDescription referenced via ValueList/valueId and using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3), DataSpecificationIec61360/value shall be set.

AASc-3a-004

Update

Now https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3

AASc-3a-004: For a ConceptDescription with category PROPERTY or VALUE using data specification template IEC61360 (https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3), DataSpecificationIec61360/dataType is mandatory and shall be one of DATE, STRING, STRING_TRANSLATABLE, INTEGER_MEASURE, INTEGER_COUNT, INTEGER_CURRENCY, REAL_MEASURE, REAL_COUNT, REAL_CURRENCY, BOOLEAN, RATIONAL, RATIONAL_MEASURE, TIME, TIMESTAMP.

AASc-3a-005

Update

Now https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3

AASc-3a-005: For a ConceptDescription with category REFERENCE using data specification template IEC61360 (https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3), DataSpecificationIec61360/dataType shall be one of STRING, IRI, IRDI.

AASc-3a-006

Update

Now https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3

AASc-3a-006: For a ConceptDescription with category DOCUMENT using data specification template IEC61360 (https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3), DataSpecificationIec61360/dataType shall be one of FILE, BLOB, HTML.

AASc-3a-007

Update

Now https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3

AASc-3a-007: For a ConceptDescription with category QUALIFIER_TYPE using data specification template IEC61360 (https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3), DataSpecificationIec61360/dataType is mandatory and shall be defined.

AASc-3a-008

Update

Now https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3

AASc-3a-008: For a ConceptDescription using data specification template IEC61360 (https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3), DataSpecificationIec61360/definition is mandatory and shall be defined at least in English. Exception: the concept description describes a value, i.e. DataSpecificationIec61360/value is defined.

AASc-009

Renamed

renamed to AASc-3a-009

AASc-010

Renamed

renamed to AASc-3a-010

AASc-3a-050

Update

Now https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3

AASc-3a-050: If the DataSpecificationContent DataSpecificationIec61360 is used for an element, the value of HasDataSpecification/dataSpecification shall contain the external reference to the IRI of the corresponding data specification template https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3.

Changes V3.0.1 vs. V3.0

Bugfixes:

  • also support deprecated data specification template IDs (#4, #2)

    • http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0

    • http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIEC61360/3/0

    • https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIEC61360/3/0

  • For backward compatibility of future versions of this specification the ID of data specification template and value of attribute “id” of DataSpecification are now distinguished: Therefore https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0 is also deprecated and https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3 shall be used instead

  • corrected examples for qualifier of namespace IEC (min instead of Min for enumeration LevelType)

  • removed sentence stating that the template ID is conformant to the rules for semantic IDs for data specifications as defined in Part 1 (IDTA-01001-3-0) of the document series: this is not the case but the ID will not be changed

  • (Editorial) Constraint AASc-3a-050: external reference instead of globale reference

  • (Editorial) Notes "Note: it is recommended to use a global reference." were updated to "Note: it is recommended to use an external reference." (#5)

Table 3. New, Changed or Removed Constraints in V3.0.1
nc V3.0.1 vs. V3.0 New, Update, Removed, Reformulated Comment

AASc-3a-003

Update

Change http to https

AASc-3a-003: For a ConceptDescription referenced via ValueList/valueId and using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/value shall be set.

AASc-3a-004

Update

Change http to https

AASc-3a-004: For a ConceptDescription with category PROPERTY or VALUE using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/dataType is mandatory and shall be one of DATE, STRING, STRING_TRANSLATABLE, INTEGER_MEASURE, INTEGER_COUNT, INTEGER_CURRENCY, REAL_MEASURE, REAL_COUNT, REAL_CURRENCY, BOOLEAN, RATIONAL, RATIONAL_MEASURE, TIME, TIMESTAMP.

AASc-3a-005

Update

Change http to https

AASc-3a-005: For a ConceptDescription with category REFERENCE using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/dataType shall be one of STRING, IRI, IRDI.

AASc-3a-006

Update

Change http to https

AASc-3a-006: For a ConceptDescription with category DOCUMENT using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/dataType shall be one of FILE, BLOB, HTML.

AASc-3a-007

Update

Change http to https

AASc-3a-007: For a ConceptDescription with category QUALIFIER_TYPE using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/dataType is mandatory and shall be defined.

AASc-3a-008

Update

Change http to https

AASc-3a-008: For a ConceptDescription using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/definition is mandatory and shall be defined at least in English. Exception: the concept description describes a value, i.e. DataSpecificationIec61360/value is defined.

AASc-3a-050

Update

Change http to https and External instead of global reference

AASc-3a-050: If the DataSpecificationContent DataSpecificationIec61360 is used for an element, the value of HasDataSpecification/dataSpecification shall contain the external reference to the IRI of the corresponding data specification template https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0.

Changes V3.0 vs. Part 1 V2.0.1

Major Changes:

  • CHANGE: was part of part 1 in former versions of the document series until V3.0RC02

  • NEW: has a unique IDTA number IDTA-01003-a

  • CHANGE: string types replaced by explicit types with length restrictions, etc.

  • CHANGE: id of data specification IEC62360 changed (camel case)

  • NEW: additional IEC 61360 data types: IRI, IRDI, HTML, FILE, BLOB

  • EDITORIAL: mapping to IEC 61360 notes added

  • NEW: new terms added to Clause "Terms, Definitions and Abbreviations" (maximum value, minimum value, nominal value, non-quantitative property, quantitative property)

  • NEW: Clause "Normative References" in Preamble

  • NEW: SpecificAssetId added to table with categories of concept descriptions

  • NEW: constraints added for applying categories to concept descriptions

  • UPDATE: data mappings IEC 61360 to xsd data types as used in part 1

  • CHANGE: no IEC 61360 data type RATIONAL_* allowed any longer for RANGE; instead, INTEGER_* is used

  • CHANGE: all IEC 61360 data types allowed for Property, except STRING_TRANSLATABLE, IRI, IRDI, HTML, FILE, BLOB (before only STRING_TRANSLATABLE was excluded)

  • CHANGE: LevelType changed from Enumeration to Class, Table added

  • CHANGE: Names containing IEC renamed to camel case using Iec, e.g. DataSpecificationIEC61360

Table 4. Changes in Metamodel V3.0
nc V3.0 vs. Part 1 V2.0.1 Comment

x

DataSpecificationIEC61360

Renamed to DataSpecificationIec61360

DataSpecificationContent

Stereotype <<Template>> added

x

DataTypeIEC61360

Renamed to DataTypeIec61360

Some new values added: BLOB, FILE, HTML, IRDI; URL renamed to IRI

x

DataSpecificationIec61360/valueId

Removed, the valueId is identical to the ID of the concept description

x

LevelType

Changed from enumeration to complex data type with four Boolean attributes because more than one value can be selected

x

ValueList/valueReferencePairs

Bugfix, was ValueList/valueReferencePairTypes before

x

ValueReferencePair/value

Type changed from ValueDataType to string
Table 5. New Elements in Metamodel V3.0
nc V3.0 vs. Part 1 V2.0.1 New Elements Comment

x

DataTypeIec61360

Renamed, before: DataTypeIEC61360

Values remain, some new values added, see separate entries

DataTypeIec61360/BLOB

New value, compared to DataTypeIEC61360

DataTypeIec61360/FILE

New value, compared to DataTypeIEC61360

DataTypeIec61360/HTML

New value, compared to DataTypeIEC61360

DataTypeIec61360/IRDI

New value, compared to DataTypeIEC61360

x

DataTypeIec61360/IRI

Renamed, before URL in DataTypeIEC61360

x

DataSpecificationIec61360

Renamed, before: DataSpecificationIEC61360

Some attribute types changed, see separate entries

x

DataSpecificationIec61360/definition

Type changed from LangStringSet to DefinitionTypeIec61360 compared to DataSpecificationIEC61360/definition

x

DataSpecificationIec61360/levelType

Type changed from enumeration to complex type (name stayed LevelType) compared to DataSpecificationIEC61360/levelType

x

DataSpecificationIec61360/preferredName

Type changed from LangStringSet to PreferredNameTypeIec61360 with limited max. length compared to DataSpecificationIEC61360/preferredName

x

DataSpecificationIec61360/shortName

Type changed from LangStringSet to ShortNameTypeIec61360 with limited max. length compared to DataSpecificationIEC61360/shortName

x

DataSpecificationIec61360/value

Type changed from ValueDataType to ValueTypeIec61360

x

DataSpecificationIec61360/valueFormat

Type changed from string to ValueFormatTypeIec61360 compared to DataSpecificationIEC61360/valueFormat

ValueTypeIec61360

New type for values
Table 6. New, Changed or Removed Constraints in V3.0
Nc V3.0 vs. Part 1 V2.0.1 New, Update, Removed, Reformulated Comment

AASc-3a-002

New

Updated version of AASd-076, renamed to AASc-3a-002 because applicable to data specification IEC61360

Constraint AASc-3a-002: DataSpecificationIec61360/preferredName shall be provided at least in English.

(x)

AASc-3a-003

New

Constraint AASc-3a-003: For a ConceptDescription referenced via ValueList/valueId and using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/value shall be set.

(x)

AASc-3a-004

New

Constraint AASc-004: For a ConceptDescription with category PROPERTY or VALUE using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/dataType is mandatory and shall be defined.

(x)

AASc-3a-005

New

Constraint AASc-005: For a ConceptDescription with category REFERENCE using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/dataType is STRING by default.

(x)

AASc-3a-006

New

Constraint AASc-006: For a ConceptDescription with category DOCUMENT using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/dataType shall be one of the following values: STRING or URL.

(x)

AASc-3a-007

New

Constraint AASc-007: For a ConceptDescription with category QUALIFIER_TYPE using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/dataType is mandatory and shall be defined.

(x)

AASc-3a-008

New

Constraint AASc-3a-008: For a ConceptDescription using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/definition is mandatory and shall be defined at least in English. Exception: the concept description describes a value, i.e. DataSpecificationIec61360/value is defined.

(x)

AASc-3a-009

New

Constraint AASc-009: If DataSpecificationIec61360/dataType is one of INTEGER_MEASURE, REAL_MEASURE, RATIONAL_MEASURE, INTEGER_CURRENCY, REAL_CURRENCY, then DataSpecificationIec61360/unit or DataSpecificationIec61360/unitId shall be defined.

(x)

AASc-3a-010

New

Constraint AASc-010: If DataSpecificationIec61360/value is not empty, DataSpecificationIec61360/valueList shall be empty, and vice versa

AASc-3a-050

New

Constraint AASc-050: If the DataSpecificationContent DataSpecificationIec61360 is used for an element, the value of HasDataSpecification/dataSpecification shall contain the global reference to the IRI of the corresponding data specification template https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0

Changes V3.0 vs. Part 1 V3.0RC02

Major Changes:

  • CHANGE: was part of Part 1 in former versions of the document series until V3.0RC02

  • CHANGE: string types replaced by explicit types with length restrictions, etc.

  • CHANGE: id of data specification IEC62360 changed (camel case)

  • EDITORIAL: mapping to IEC 61360 notes added

  • NEW: new terms added to Clause "Terms, Definitions and Abbreviations" (maximum value, minimum value, nominal value, non-quantitative property, quantitative property)

  • NEW: Clause "Normative References" in Preamble

  • NEW: SpecificAssetId added to table with categories of concept descriptions

  • UPDATE: data mappings IEC 61360 to xsd data types as used in part 1

  • CHANGE: no IEC 61360 data type RATIONAL_* allowed any longer for RANGE

Bugfixes:

  • LevelType changed from Enumeration to Class, Table added

  • IEC 61360 Data Specification Template for Properties and Ranges: footnote corrected, data types like Iso29002Irdi and Icid are subsumed in IRDI, no camel case writing but capital letters and underscore

  • Renaming constraints relevant for concept descriptions from AASd- to AASc-

Table 7. Changes in Metamodel V3.0
nc V3.0 vs. Part 1 V3.0RC02 Comment

x

DataSpecificationIec61360

Renamed, before: DataSpecificationIEC61360

x

DataSpecificationIec61360/definition

Type changed from MultiLanguageSet to DefinitionTypeIec61360 compared to DataSpecificationIEC61360/definition

x

DataSpecificationIec61360/levelType

Type changed from enumeration to complex type (name stayed LevelType) compared to DataSpecificationIEC61360/levelType

x

DataSpecificationIec61360/preferredName

Type changed from MultiLanguageSet to PreferredNameTypeIec61360 with limited max. length compared to DataSpecificationIEC61360/preferredName

x

DataSpecificationIec61360/shortName

DataSpecificationIEC61360/shortName

x

DataSpecificationIec61360/value

Type changed from ValueDataType to ValueTypeIec61360

x

DataSpecificationIec61360/valueFormat

Type changed from string to ValueFormatTypeIec61360 compared to DataSpecificationIEC61360/valueFormat

x

DataTypeIec61360

Renamed, before: DataTypeIEC61360

x

LevelType

Changed from enumeration to complex data type with four Boolean attributes because more than one value can be selected

x

ValueReferencePair/value

Type changed from string to ShortNameTypeIec61360 with limited max. length
Table 8. New, Changed or Removed Constraints in V3.0
Nc V3.0 vs. Part 1 V3.0RC02 New, Update, Removed, Reformulated Comment

AASd-050

Removed

Renamed from AASd-050 to AASc-3a-050, see new AASc-3a-050 + update renamed elements

AASc-002

Removed

Renamed from AASc-002 to AASc-3a-002 + update renamed elements

AASc-003

Removed

Renamed from AASc-003 to AASc-3a-003 + update renamed elements

AASc-004

Removed

Renamed from AASc-004 to AASc-3a-004 + update renamed elements

AASc-005

Removed

Renamed from AASc-005 to AASc-3a-005 + update renamed elements

AASc-006

Removed

Renamed from AASc-006 to AASc-3a-006 + update renamed elements

AASc-007

Removed

Renamed from AASc-007 to AASc-3a-007 + update renamed elements

AASc-008

Removed

Renamed from AASc-008 to AASc-3a-008 + update renamed elements

AASc-009

Removed

Renamed from AASc-009 to AASc-3a-009 + update renamed elements

AASc-010

Removed

Renamed from AASc-010 to AASc-3a-010 + update renamed elements

AASc-3a-002

New

Renamed from AASc-002 to AASc-3a-002 + update renamed elements

AASc-3a-003

New

Renamed from AASc-003 to AASc-3a-003 and changed to no longer contain category Constraint AASc-3a-003: For a ConceptDescription referenced via ValueList/valueId and using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIEC61360/value shall be set.

AASc-004

New

Renamed from AASc-004 to AASc-3a-004, + update renamed elements + editorial changes

AASc-005

New

Renamed from AASc-005 to AASc-3a-005, + update renamed elements + editorial changes

AASc-006

New

Renamed from AASc-006 to AASc-3a-006, + update renamed elements + editorial changes

AASc-007

New

Renamed from AASc-007 to AASc-3a-007, + update renamed elements + editorial changes

AASc-3a-008

New

Renamed from AASc-008 to AASc-3a-008 and changed to no longer contain category

Constraint AASc-3a-008: For a ConceptDescription using data specification template IEC61360 (http://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0), DataSpecificationIec61360/definition is mandatory and shall be defined at least in English. Exception: the concept description describes a value, i.e. DataSpecificationIec61360/value is defined.

AASc-009

New

Renamed from AASc-009 to AASc-3a-009, + update renamed elements + editorial changes

AASc-010

New

Renamed from AASc-010 to AASc-3a-010, + update renamed elements + editorial changes

AASc-3a-050

New

Renamed from AASd-050 to AASc-3a-050 + update renamed elements + version updated

Constraint AASc-3a-050: If the DataSpecificationContent DataSpecificationIec61360 is used for an element, the value of HasDataSpecification/dataSpecification shall contain the global reference to the IRI of the corresponding data specification template https://admin-shell.io/DataSpecificationTemplates/DataSpecificationIec61360/3/0