Versioning
CATENA-X RELEASES
For information about the Catena-X release management, refer to the Catena-X website . Implications for Behaviour Twin use cases are mentioned in the section To Be Considered.
VERSIONING ASSETS
All EDC assets must be decorated by the cx-common:version
within the properties
list of the asset definitions. This applies to graph assets (data and service binding assets) as well as to skill assets.
ONTOLOGY CHANGES
In most cases, ontologies are not alternated, but extended. The meaning of nodes/edges must not change.
New service or data types must have new types within the ontologies.
⚠️ If an ontology gets extended, not all users may be aware of this extension. As a consumer of data or services, you cannot expect that all providers provide the corresponding data until next major release. If required, you may establish a appropriate mechanism in your use case for informing your partners and requiring them to provide the extended data.
DATA AND SERVICE VERSIONS
Versioning of services, but also data is especially helpful if you want to harmonize versions within a use case. The attribute cx-common:version
within the properties
list of the asset definitions can be used for this purpose. Using semantic versioning, the feature version number can be harmonized by all participants (e.g. by agreements or standards). Semantic versioning is expressed in the following format: [0-9]+.[0-9]+.[0-9]+(-SNAPSHOT)?
A second option would be an extension of the corresponding ontologies and taxonomies. Then, the version information can be a part of the SHACL description in the graph assets.
It's up to the use case to handle the versioning. In skills, both options can be used to determine the desired data and service versions.