Release Notes of twinsphere.TypedAasMetamodels

Versioning

The twinsphere.TypedAasMetamodels library follows semantic versioning ⧉ in the form major.minor.patch.

twinsphere.TypedAasMetamodels 1.3.0

Released on 05-May-2026.

  • [TAM] Improved AasxPackagingInformation API as a replacement of the PackagePreprocessor.
    • Provides a fluent API for package creation
    • Allows the creation of packages without shells
  • [TAM] Arbitrary elements now allow users to specify supplemental semantic ids.
  • [TAM] [Bugfix] Conversion of arbitrary elements to the typed representation no longer silently drops supplemental semantic ids.
  • [TAM] [Bugfix] Resolving DropIns now removes the https://admin-shell.io/smt-dropin/smt-dropin-use/1/0 supplemental semantic id.
  • [TAM] [Bugfix] Conversion of empty submodel element collections (i.e. submodel element collections for which all elements are optional) to their typed model representation no longer fails.
  • [TAM] [Bugfix] Creation of typed models and validation no longer fails due to the submodel templates not being accessible.
  • [TAM] [Bugfix] Multiple escaping issues in DisplayNames and Descriptions.
  • [TAM] [Bugfix] Resolve multiple inconsistencies in conformity validation due to incorrect submodel templates.
  • [TAM] [Bugfix] Packaging now properly encodes file paths containing special characters.
  • [TAM] [Bugfix] Packaging on Windows no longer uses incorrect path separators.
  • [TAM] [Bugfix] Setters on list properties no longer throw.
  • [TAM] [Bugfix] Fix conversion problems for Property values to C# representation and vice versa.
  • [TAM] [Bugfix] Numeric boundaries are now properly checked for ValueOnly conversion.
  • [TAM] [Bugfix] [DigitalNameplate 3.0] AssetSpecificProperties and GuidelineSpecificProperties now allow users to specify no arbitrary element, as well.
  • [TAM] [Bugfix] [HandoverDocumentation 2.0] KeyWords now is an optional property.
  • [Semantics] [Bugfix] Add missing attributes for arbitrary property type in schema.
  • [Semantics] [Bugfix] Conversion of base64 Blob values no longer corrupts data.
  • [Semantics] [Bugfix] Serialization no longer fails with exhausted XmlWriter.
  • [Semantics] [Bugfix] Exceptions no longer hide the full stack trace.
  • [Semantics] [Bugfix] Serialization of empty lists of arbitrary elements no longer fails.
  • [Semantics] [Bugfix] Serialization to semantics representation no longer modifies the submodel.

twinsphere.TypedAasMetamodels 1.2.0

Released on 14-Apr-2026.

  • [TAM] Added migrations to convert between Handover Documentation v1.2 and v2.0 (and vice versa)
  • [TAM] AASX Packaging interface now allows users to specify file and concept description resolving strategies
  • [TAM] Added an extensible validation interface
    • Package validation
    • Meta model constraint validation
    • Submodel specific (template/instance) validations
    • Dynamic Submodel conformity validations that check whether submodel instances conform to constraints specified in their templates
  • [TAM] Switch to AAS v3.1: TAM now consumes, produces, and validates to v3.1 of the AAS specification
  • [TAM] Added a AAS 3.0 compatibility layer that allows the consumption and on-the-fly conversion of of v3.0 data
  • [TAM] HandoverDoucmentation v1.2 and v2.0: make DocumentClassifications extensible for further translations
  • [Bugfix] Make numberOfDocuments of Handover Documentation v1.2 optional
  • [Bugfix] In HandoverDocumentation v1.2 and v2.0 use VDI 2770 Blatt 1:2020 instead of VDI2770 Blatt 1:2020
  • [Bugfix] Unrecognized languages in language code checks
  • [Bugfix] DigitalNameplate v2.0 and 3.0: unrecognized country codes in countries of origins check
  • [Bugfix] Failure to validate valid MIME types for extensions with multiple possible MIME types
  • [Bugfix] [Exp] Rename namespace of DigitalQualityDocument to twinsphere.TypedAasMetamodels.Experimental.Types.Submodels.DigitalQualityDocument.V1_0 (was twinsphere.TypedAasMetamodels.Types.Submodels.DigitalQualityDocument.V1_0)

twinsphere.TypedAasMetamodels 1.1.5

Released on 02-Mar-2026.

  • [TAM] TAM now has support for older .aasx packages still using the deprecated _rels format.
  • [Exp] Add experimental package for testing to-be-released SMTs:
    • Digital Quality Document 1.0
    • Digital Battery Passport
    • Digital Nameplate 1.0
    • Product Carbon Footprint 1.0
    • Handover Documentation 1.0
    • Technical Data 1.0
    • Product Condition 1.0
    • Material Composition 1.0
    • Circularity 1.0
  • [Bugfix] Fix representation of semantic Ids in meta model conversion for multiple SMTs
  • [Bugfix] Fix too strict validations in CarbonFootprint 0.9
  • [Bugfix] Add missing constraint on Path types
  • [Bugfix] Fix null dereference in validation of Handover Documentation 1.2

twinsphere.TypedAasMetamodels 1.1.4

Released on 20-Nov-2025.

  • [TAM] Update to most recent specification versions for several submodels
    • Contact Informations 1.0
    • Technical Data 2.0
    • Handover Documentation 2.0
    • Hierarchical Structures enabling Bill of Materials 1.1
  • [Bugfix] Packaging and conversion now ensures that file paths/values are properly percent encoded in conformity with RFC2396.

twinsphere.TypedAasMetamodels 1.1.3

Released on 06-Nov-2025.

  • [Bugfix] Fix broken semantic ids in HandoverDocumentation 1.2
  • [Bugfix] ToMetamodel conversion of HandoverDocumentation 1.2 now sets descriptions of PreviewFile correctly
  • [Bugfix] ToMetamodel conversion of Technical Data 2.0 now sets section description correctly

twinsphere.TypedAasMetamodels 1.1.2

Released on 30-Oct-2025.

  • [Bugfix] Fix semantic ids for HandoverDocumentation 1.2 and HandoverDocumentation 2.0
  • [Bugfix] Fix constructor and setter constraint for TechnicalProperties, MainSection, and SubSection of TechnicalData 1.2
  • [TAM] Update to most recent specification versions for several submodels
  • [TAM] Introduce consistent error messages in validation
  • [TAM] Improve documentation.
  • [Semantics] Update to most recent specification versions for several submodels

twinsphere.TypedAasMetamodels 1.1.1

Released on 30-Sep-2025.

  • [Bugfix] Fix several invalid language string entries in concept descriptions

twinsphere.TypedAasMetamodels 1.1.0

Released on 09-Sep-2025.

  • [Bugfix] Fix property names in reported errors
  • [Bugfix] Arbitrary property operations now check for the id short to be non-empty
  • [Bugfix] Semantics now also supports file paths that don't start with "file://"
  • [Bugfix] Semantics now also support custom classifications for HandoverDocumentation 1.2
  • [Bugfix] Fix property names in semantic schema for HandoverDocumentation 1.2
  • [Bugfix] Semantics now support more than a single arbitrary property element
  • [Bugfix] Semantics now correctly support MultiLanguageProperties
  • [Bugfix] Add support for missing DocumentClassifications in HandoverDocumentation 1.2
  • [Bugfix] Add missing DocumentClassifications translations for HandoverDocumentation 1.2
  • [TAM] Rename SpherePackageBuilder to AasxPackageBuilder
  • [TAM] Introduce Core reference types at interfaces instead of string references.
  • [TAM] Extend arbitrary property interfaces to support user-defined descriptions and display names.
  • [TAM] Add support for non-list elements with cardinality elements without pattern syntax in validation
  • [TAM] Add support for multiple submodels
    • TechnicalData 2.0
    • HandoverDocumentation 2.0
    • DigitalNameplate 3.0

twinsphere.TypedAasMetamodels 1.0.1

Released on 04-Aug-2025.

  • [Bugfix] Packaging now collects all files referenced in a submodel
  • [Bugfix] Packaging now allows packages without submodels or concept descriptions

twinsphere.TypedAasMetamodels 1.0.0

  • [Bugfix] Packaging now ensures that files and thumbnails are only packaged once
  • [Bugfix] HandoverDocumentation now won't throw if the model is erroneous
  • [Bugfix] File types now support file paths without "file://" prefix
  • [TAM] Add support for more than one shell in packaging
  • [TAM] Introduce validations for shell types
  • [TAM] Add full support for arbitrary properties
  • [TAM] Rename file types and referable types to decrease ambiguity with Core Works
  • [HandoverDocumentation 1.2] add support for user defined ClassIds
  • [TechnicalData 1.2] upgrade to match latest specification release
  • [Semantic] Add human-readable description to semantic schema

Released on 21-Jul-2025.

twinsphere.TypedAasMetamodels 1.0.0-RC-20250423

Released on 23-Apr-2025.

  • [TAM] Introduce library abstractions over core data types (Blob, File, ...) to simplify user experience

twinsphere.TypedAasMetamodels 1.0.0-RC-20250416

Released on 16-Apr-2025.

  • [Bugfix] Resolve submodels in semantics by semantic ID, not template ID

twinsphere.TypedAasMetamodels 1.0.0-RC-20250415

Released on 15-Apr-2025.

  • [TAM] Representation, conversion, verification methods and classes for shells
  • [TAM] Representation, conversion, verification methods and classes for several submodels
    • Carbon Footprint 0.9
    • Contact Informations 1.0
    • Digital Nameplate 2.0
    • Handover Documentation 1.2
    • Hierarchical Structures enabling Bill of Materials 1.1
    • Technical Data 1.2
  • [TAM] Conversion methods for ValueOnly representation
  • [TAM] Utilities for package creation
  • [Semantic] Semantic schema support for several submodels
    • Carbon Footprint 0.9
    • Contact Informations 1.0
    • Digital Nameplate 2.0
    • Handover Documentation 1.2
    • Hierarchical Structures enabling Bill of Materials 1.1
    • Technical Data 1.2
  • [Semantic] Conversion from and to meta model from semantic schema XML