search

admin-shell-io / submodel-templates

Submodel Templates for AAS
Creative Commons Attribution 4.0 International
36 stars 14 forks source link

Documentation of SML with SMC as child in Submodel Template (SMT) specifications #65

Open foprs opened 1 month ago

foprs commented 1 month ago

There is the constraint AASd-120 in the metamodel specification stating that "idShort of submodel elements being a direct child of a SubmodelElementList shall not be specified".

image

However in some SMT specifications like IDTA 02036-1-0 Product Change Notifications (Draft) an idShort is awarded and a separate class table is used to document the elements of the SMC. See the picture below.

image

My question is whether contraint AASd-120 is effective for SMT and whether the existing SMT specifications with idShort are valid or not.

BirgitBoss commented 1 month ago

We need a different kind of table for SubmodelElementList, e.g. image

Update 2024-05-23 Export asciidoc from AASX Package Explorer looks like this: image

foprs commented 1 month ago

With the constraint AASd-120 in the metamodel specification stating that "idShort of submodel elements being a direct child of a SubmodelElementList shall not be specified" there is in the example above no idShort available for the SubmodelElementCollection.

In the screenshot above there is a class name "Marking" defined in the specification document. This class name is not modeled in the AASX.

The SubmodelElementCollection with class name "Marking" would need a separate class table for its elements where no idShort would be available for (if constraint AASd-120 applies).

Question: Should the line idShort be replaced by "Class name" in this case for the standard table for SMC?

BirgitBoss commented 1 month ago

The SMC table for Marking would be part of the SMT specification and is used by the SML. But you are right, it would not be part of the aasx file itself. There we only have the semanticId for referencing.

I would still use the idShort Marking for the SMC table as well. It is some kind of SMT dropin that could also be reused at other places different to the SML Markings.

What could be done today with V3.0: create a ConceptDescription for the semanticIdListElement and define Marking as the idShort of the ConceptDescription.

BirgitBoss commented 1 month ago

But perhaps we should relax constraint AASd-120 for SMT. I created https://github.com/admin-shell-io/aas-specs/issues/432 so that it can be discussed in the AAS Specification Workstream.