search

admin-shell-io / aas-specs-api

Repository of the Asset Administration Shell Specification DTA-01002 API
https://industrialdigitaltwin.org/
Creative Commons Attribution 4.0 International
9 stars 4 forks source link

Add Explanation on the Implementation of different Profile Versions #264

Open sebbader-sap opened 3 months ago

sebbader-sap commented 3 months ago

What?

With V3.1, new profiles will be added and clients will find servers supporting both V3.0 (e.g. https://admin-shell.io/aas/API/3/0/SubmodelRegistryServiceSpecification/SSP-002) and V3.1 (e.g. https://admin-shell.io/aas/API/3/1/SubmodelRegistryServiceSpecification/SSP-003) at the same time.

How?

It will certainly increase clarity if we add a section to explain the target behaviour:

  1. Clients shall understand that a V3.1 profile has all features of a V3.0. Therefore, if they require https://admin-shell.io/aas/API/*3/0*/SubmodelRegistryServiceSpecification/SSP-002 but a server exposes support for https://admin-shell.io/aas/API/*3/1*/SubmodelRegistryServiceSpecification/SSP-002, the client needs to understand that its requests will work.
  2. Servers can expose the latest profiles and by this automatically describe support for the older versions. It is sufficient to only list https://admin-shell.io/aas/API/*3/1*/SubmodelRegistryServiceSpecification/SSP-002 if also https://admin-shell.io/aas/API/*3/0*/SubmodelRegistryServiceSpecification/SSP-002 is possible.

Task: Formulate a section and add it to the V3.1 ASCIIDOC.