Merge branch 'IDTA-01001-3-1_working' into BiBo/V3.0.1_Changes_2nd

documentation/IDTA-01001/modules/ROOT/pages/IDTA-01001_ChangeLog.adoc

@@ -78,8 +78,11 @@ also abbreviations partly adopted; changes:
 Minor Changes:
 
 * explanation of ValueOnly-Normal round-trip issues (https://github.com/admin-shell-io/aas-specs/issues/364[#364])
+* improve explanation for recommendation to use external references for semanticId (https://github.com/admin-shell-io/aas-specs/issues/376[#376]) and related attributes like valueId and isCaseOf (https://github.com/admin-shell-io/aas-specs/issues/396[#396]) 
+* update information on OPC UA mapping (https://github.com/admin-shell-io/aas-specs/issues/373[#373])
+* update information on AutomationML mapping (https://github.com/admin-shell-io/aas-specs/issues/397[#397])
+* update bibliography (newer versions, link update, removal of entries not referenced)
 * editorial changes
-* improve explanation for recommendation to use external references for semanticId (https://github.com/admin-shell-io/aas-specs/issues/376[#376])
 
 
 === Metamodel Changes V3.1 vs. V3.0

documentation/IDTA-01001/modules/ROOT/pages/IDTA-01001_Mappings.adoc

@@ -182,7 +182,7 @@ Note 3: example files can be found n the repository "aas-specs"  of the github p
 ====
 
 
-==   Format "Normal" in AutomationML
+==   Formats in AutomationML
 
 AutomationML (IEC 62714) is especially suited for serializing the import and export scenarios of the metamodel of an Asset Administration Shell in the engineering phase.
 
@@ -208,13 +208,10 @@ Note 2: the resulting application recommendation (AR 004E) "Asset Administration
 ====
 
 
-==  Format "Normal" in OPC UA
+==  Formats in OPC UA
 
-OPC UA is suited for the operating phase of Asset Administration Shellsfootnote:[OPC UA is used for several purposes in the context of Industry 4.0. In this document, however, the focus is on Asset Administration Shell representation only.] and especially applicable in case of machine-to-machine communication. The information model xref:IDTA-01xxx_Bibliography.adoc#bib42[[42\]] is the basis for the definition of so-called OPC UA Information Models, or OPC UA Companion Specifications xref:IDTA-01xxx_Bibliography.adoc#bib43[[43\]].
+OPC UA is suited for the operating phase of Asset Administration Shells and especially applicable in case of machine-to-machine communication. The information model xref:IDTA-01xxx_Bibliography.adoc#bib42[[42\]] is the basis for the definition of so-called OPC UA Information Models, or OPC UA Companion Specifications xref:IDTA-01xxx_Bibliography.adoc#bib43[[43\]].
 
-Note1 : the mapping to the OPC UA are carried out in a joint working groupfootnote:[see: https://opcfoundation.org/collaboration/i4aas/] "I4AAS" between OPC Foundation, ZVEI and VDMA (https://opcfoundation.org/markets-collaboration/I4AAS/ xref:IDTA-01xxx_Bibliography.adoc#bib30[[30\]].
-
-
-====
-Note 2: the different versions of the OPC UA Companion Specification for I4AAS can be found here: https://reference.opcfoundation.org/%3cversion%3e/I4AAS/%3cversion%3e/docs/[https://reference.opcfoundation.org/<version>/I4AAS/<version>/docs/], e.g. https://reference.opcfoundation.org/v104/I4AAS/v100/docs/ for release 1.00 xref:IDTA-01xxx_Bibliography.adoc#bib41[[41\]].
-====
+The joint Working Group of the https://opcfoundation.org/[OPC Foundation] and https://industrialdigitaltwin.org/[IDTA] 
+https://profiles.opcfoundation.org/workinggroup/40[Industry 4.0 Asset Administration Shell - AAS (I4AAS)] (xref:IDTA-01xxx_Bibliography.adoc#bib52[[41\]]) 
+"will develop new companion specifications and / or Submodel Templates related to OPC UA for Asset Administration Shell V3.0 and compatible."

documentation/IDTA-01001/modules/ROOT/pages/IDTA-01xxx_Bibliography.adoc

@@ -6,8 +6,6 @@ https://creativecommons.org/licenses/by/4.0/).
 
 SPDX-License-Identifier: CC-BY-4.0
 
-Illustrations:
-Plattform Industrie 4.0; Anna Salari, Publik. Agentur für Kommunikation GmbH, designed by Publik. Agentur für Kommunikation GmbH
 ////
 
 [bibliography]
@@ -83,7 +81,8 @@ Plattform Industrie 4.0; Anna Salari, Publik. Agentur für Kommunikation GmbH, d
 [23] DIN SPEC 16593-1 "Reference Model for Industrie 4.0 Service Architectures – Part 1: Basic Concepts of an Interaction-based Architecture", Beuth-Verlag: Berlin, Germany, 2018. [Online]. Available: https://www.beuth.de/en/technical-rule/din-spec-16593-1/287632675
 
 [#bib24]
-[24] ISO 13854-42 "Standard data element types with associated classification scheme – Part 1: Definitions – Principles and methods" Edition 4.0, 2017-07
+[24] ISO 13584-42 "Standard data element types with associated classification scheme – Part 1: Definitions – Principles and methods" Edition 4.0, 2017-07
+
 
 [#bib25]
 [25] IEC 61360-1 "Standard data element types with associated classification scheme – Part 1: Definitions – Principles and methods", Edition 4.0, 2017-07
@@ -100,8 +99,10 @@ Plattform Industrie 4.0; Anna Salari, Publik. Agentur für Kommunikation GmbH, d
 [#bib29]
 [29] H. Knublauch, D. Knotokostas "Shapes Constraint Language (SHACL)" W3C Recommendation, 2017, [Online]. Available: https://www.w3.org/TR/shacl/
 
+////
 [#bib30]
 [30] "I4AAS – Industrie 4.09 Asset Administration Shell". June 2021. [Online] Available: https://opcfoundation.org/markets-collaboration/I4AAS/
+////
 
 [#bib31]
 [31] DIN SPEC 91406:2019 "Automatische Identifikation von physischen Objekten und Informationen zum physischen Objekt in IT-Systemen, insbesondere IoT-Systemen/Automatic identification of physical objects and information on physical objects in IT systems, particularly IoT systems". December 2019
@@ -111,18 +112,6 @@ Plattform Industrie 4.0; Anna Salari, Publik. Agentur für Kommunikation GmbH, d
 
 [#bib33]
 [33] T. R. Gruber "A translation approach to portable ontology specifications." Knowledge acquisition 5.2 (1993): 199-220. [Online]. Available: https://tomgruber.org/writing/ontolingua-kaj-1993.htm
-////
-Copyright (c) 2023 Industrial Digital Twin Association
-
-This work is licensed under a [Creative Commons Attribution 4.0 International License](
-https://creativecommons.org/licenses/by/4.0/). 
-
-SPDX-License-Identifier: CC-BY-4.0
-
-Illustrations:
-Plattform Industrie 4.0; Anna Salari, Publik. Agentur für Kommunikation GmbH, designed by Publik. Agentur für Kommunikation GmbH
-////
-
 
 [#bib34]
 [34] "The Industrial Internet of Things Vocabulary". Technical Report. Version 2.3. October 10, 2020. Industrial Internet Consortium. IIC:IIVOC:V2.3:20201025 [Online] Available: https://www.iiconsortium.org/vocab/
@@ -134,19 +123,26 @@ Plattform Industrie 4.0; Anna Salari, Publik. Agentur für Kommunikation GmbH, d
 [36] T. Preston-Werner "Semantic Versioning". Version 2.0.0. Accessed: 2020-11-13. [Online] Available: https://semver.org/spec/v2.0.0.html
 
 [#bib37]
-[37] "Details of the Asset Administration Shell – Interoperability at Runtime – Exchanging Information via Application Programming Interfaces". See xref:IDTA-01xxx_Bibliography.adoc#bib46[[46\]].
+[37] IDTA-01002 "Specification of the Asset Administration Shell Part 2 – Application Programming Interfaces". See xref:IDTA-01xxx_Bibliography.adoc#bib46[[46\]].
 
 [#bib38]
-[38] "Asset Administration Shell. Reading Guide". Plattform Industrie 4.0 in cooperation with IDTA. November 2020. See xref:IDTA-01xxx_Bibliography.adoc#bib46[[46\]].
+[38] "Asset Administration Shell. Reading Guide". Industrial Digital Twin Association. November 2022. [Online] Available: https://industrialdigitaltwin.org/en/wp-content/uploads/sites/2/2022/12/2022-12-07_IDTA_AAS-Reading-Guide.pdf
 
 [#bib39]
-[39] "Submodel Templates of the Asset Administration Shell - Generic Frame for Technical Data for Industrial Equipment in Manufacturing", Version 1.1, Nov. 2020, Plattform Industrie 4.0 [Online] Available: https://www.plattform-i40.de/PI40/Redaktion/EN/Downloads/Publikation/Submodel_templates-Asset_Administration_Shell-Technical_Data.html
+[39] IDTA-02003 "Submodel Template of the Asset Administration Shell - Generic Frame for Technical Data for Industrial Equipment in Manufacturing", Version 1.2, Aug. 2022, Industrial Digital Twin Assocation [Online] Available: https://industrialdigitaltwin.org/en/content-hub/submodels
+
 
 [#bib40]
-[40] "Submodel Templates of the Asset Administration Shell - ZVEI Digital Nameplate for industrial equipment", Version 1.0, Nov. 2020, Plattform Industrie 4.0 [Online] Available: https://www.plattform-i40.de/PI40/Redaktion/EN/Downloads/Publikation/Submodel_templates-Asset_Administration_Shell-digital_nameplate.html
+[40] IDTA-02006 "Submodel Template of the Asset Administration Shell - Digital Nameplate for Industrial Equipment", Version 2.0, Oct. 2022, Industrial Digital Twin Assocation [Online] Available: https://industrialdigitaltwin.org/en/content-hub/submodels
 
+////
 [#bib41]
 [41] OPC 30270: OPC UA for Asset Administration Shell (AAS). 2021-06-04. [Online]. Available: https://reference.opcfoundation.org/v104/I4AAS/v100/docs/
+////
+
+[#bib52]
+[41] Joint Working Group of the https://opcfoundation.org/[OPC Foundation] and https://industrialdigitaltwin.org/[IDTA]  
+https://profiles.opcfoundation.org/workinggroup/40[Industry 4.0 Asset Administration Shell - AAS (I4AAS)] 
 
 [#bib42]
 [42] OPC Unified Architecture Specification. Part 5 Information Model. [Online]. Available: https://opcfoundation.org/developer-tools/specifications-unified-architecture
@@ -155,25 +151,29 @@ Plattform Industrie 4.0; Anna Salari, Publik. Agentur für Kommunikation GmbH, d
 [43] OPC UA Information Models. [Online]. Available: https://opcfoundation.org/developer-tools/specifications-opc-ua-information-models
 
 [#bib44]
-[44] IEC 63278-1 "Asset Administration Shell for industrial applications – Part 1: Asset Administration Shell structure". 95/925/CDV
+[44] IEC 63278-1:2023 "Asset Administration Shell for industrial applications – Part 1: Asset Administration Shell structure".
 
 [#bib45]
 [45] "Registered AAS Submodel Templates". Industrial Digital Twin Association. Available: https://industrialdigitaltwin.org/en/content-hub/submodels
 
 [#bib46]
-[46] "Asset Administration Shell Specifications – Quicklinks to Different Versions & Reading Guide". [Online]. Available: https://www.plattform-i40.de/IP/Redaktion/EN/Standardartikel/specification-administrationshell.html
+[46] "Asset Administration Shell Specifications". [Online]. Available: https://industrialdigitaltwin.org/en/content-hub/aasspecifications
 
 [#bib47]
 [47] (German) "I4.0-Sprache. Vokabular, Nachrichtenstruktur und semantische Interaktionsprotokolle der I4.0-Sprache", Discussion Paper. Plattform Industrie 4.0 [Online] Available: https://www.plattform-i40.de/IP/Redaktion/DE/Downloads/Publikation/hm-2018-sprache.html
 
 [#bib48]
 [48] "How to create a submodel template specification". Guideline. December 2022. Industrial Digital Twin Association. Available: https://industrialdigitaltwin.org/wp-content/uploads/2022/12/I40-IDTA-WS-Process-How-to-write-a-SMT-FINAL-.pdf
 
+////
 [#bib49]
 [49] Vincent Hu, David Ferraiolo, Rick Kuhn, Adam Schnitzer, Kenneth Sandlin, Robert Miller and Karen Scarfone, "Guide to Attribute Based Access Control (ABAC) Definition and Considerations", NIST Special Publication 800-162, Jan. 2014. [Online]. Available: http://dx.doi.org/10.6028/NIST.SP.800-162
+////
 
 [#bib50]
 [50] "Secure Download Service", Discussion Paper. Oct. 2020, Plattform Industrie 4.0 [Online] Available: https://www.plattform-i40.de/PI40/Redaktion/EN/Downloads/Publikation/secure_downloadservice.html
 
 [#bib51]
-[51] "AAS Repository. Repository for Information and Code for the Asset Administration Shell". https://github.com/admin-shell-io
+[51] "AAS Repository. Repository for Information and Code for the Asset Administration Shell". Industrial Digital Twin Assocation. https://github.com/admin-shell-io
+
+// bib52 see [41]

documentation/IDTA-01001/modules/ROOT/pages/Spec/IDTA-01001_Metamodel_ConceptDescriptions.adoc

@@ -39,13 +39,13 @@ Reference to an external definition the concept is compatible to or was derived
 
 
 ====
-Note: it is recommended to use an external reference, i.e. _Reference/type = ExternalReference_.
+Note 1: it is recommended to use an external reference, i.e. _Reference/type = ExternalReference_, compare to xref:Spec/IDTA-01001_Metamodel_Common.adoc#HasSemantics[HasSemantics/semanticId]
 ====
 
 
 
 ====
-Note: compare with is-case-of relationship in ISO 13584-32 & IEC EN 61360
+Note 2: compare with is-case-of relationship in ISO 13584-32 (xref:IDTA-01xxx_Bibliography.adoc#bib26[[26\]]) & IEC EN 61360 (xref:IDTA-01xxx_Bibliography.adoc#bib25[[25\]])
 ====
 
 
@@ -54,6 +54,6 @@ Note: compare with is-case-of relationship in ISO 13584-32 & IEC EN 61360
 
 Different types of submodel elements require different attributes to describe their semantics. This is why a concept description has at least one data specification template associated with it. This template defines the attributes needed to describe the semantics.
 
-See Clause 5.3.11.3 for predefined data specification templates.
+See IDTA-01003 series for predefined data specification templates.
 
 

documentation/IDTA-01001/modules/ROOT/pages/Spec/IDTA-01001_Metamodel_SubmodelElements.adoc

@@ -491,7 +491,7 @@ Reference to the global unique ID of a coded value.
 
 
 ====
-Note: it is recommended to use an external reference.
+Note: it is recommended to use an external reference, compare to xref:Spec/IDTA-01001_Metamodel_Common.adoc#HasSemantics[HasSemantics/semanticId]
 ====
 
 
@@ -596,7 +596,7 @@ a| Reference to the global unique ID of a coded value
 
 
 ====
-Note: it is recommended to use an external reference.
+Note: it is recommended to use an external reference, compare to xref:Spec/IDTA-01001_Metamodel_Common.adoc#HasSemantics[HasSemantics/semanticId]
 ====