2.1. aas - High-level structures

The main module of the AAS meta-model. It is used to define the class structures of high level elements such as AssetAdministrationShell.

class AssetAdministrationShell(asset_information: AssetInformation, id_: str, id_short: str | None = None, display_name: MultiLanguageNameType | None = None, category: str | None = None, description: MultiLanguageTextType | None = None, parent: UniqueIdShortNamespace | None = None, administration: AdministrativeInformation | None = None, submodel: Set[ModelReference[Submodel]] | None = None, derived_from: ModelReference[AssetAdministrationShell] | None = None, embedded_data_specifications: Iterable[EmbeddedDataSpecification] = (), extension: Iterable[Extension] = ())

An Asset Administration Shell

Variables:

  • asset_information – AssetInformation of the asset this AssetAdministrationShell is representing

  • id – The globally unique id (Identifier) of the element. (inherited from Identifiable)

  • id_short – Identifying string of the element within its name space. (inherited from Referable)

  • display_name – Can be provided in several languages. (inherited from Referable)

  • category – The category is a value that gives further meta information w.r.t. to the class of the element. It affects the expected existence of attributes and the applicability of constraints. (inherited from Referable)

  • description – Description or comments on the element. (inherited from Referable)

  • parent – Reference to the next referable parent element of the element. (inherited from Referable)

  • administration – AdministrativeInformation of an Identifiable element. (inherited from Identifiable)

  • submodel – Unordered list of ModelReference to Submodel to describe typically the asset of an AAS.

  • derived_from – The reference to the AAS the AAs was derived from

  • embedded_data_specifications – List of Embedded data specification.

  • extension – An extension of the element. (from HasExtension)

class AssetInformation(asset_kind: AssetKind = AssetKind.INSTANCE, global_asset_id: str | None = None, specific_asset_id: Iterable[SpecificAssetId] = (), asset_type: str | None = None, default_thumbnail: Resource | None = None)

In AssetInformation identifying meta data of the asset that is represented by an AAS is defined.

The asset may either represent an asset type or an asset instance. The asset has a globally unique identifier plus – if needed – additional domain specific (proprietary) identifiers. However, to support the corner case of very first phase of lifecycle where a stabilised/constant global asset identifier does not already exist, the corresponding attribute globalAssetId is optional.

Constraint AASd-131: The globalAssetId or at least one specificAssetId shall be defined for AssetInformation.

Variables:

  • asset_kind – Denotes whether the Asset is of AssetKind TYPE or INSTANCE. Default is INSTANCE.

  • global_asset_id – Identifier modelling the identifier of the asset the AAS is representing. This attribute is required as soon as the AAS is exchanged via partners in the life cycle of the asset. In a first phase of the life cycle the asset might not yet have a global id but already an internal identifier. The internal identifier would be modelled via specific_asset_id.

  • specific_asset_id – Additional domain specific, typically proprietary Identifier (Set of SpecificAssetIds for the asset like e.g. serial number etc.

  • asset_type –

    In case AssetInformation/assetKind is applicable the AssetInformation/assetType is the asset ID of the type asset of the asset under consideration as identified by AssetInformation/globalAssetId.

    Note

    In case AssetInformation/assetKind is Instance then the AssetInformation/assetType denotes which Type the asset is of. But it is also possible to have an AssetInformation/assetType of an asset of kind Type.

  • default_thumbnail – Thumbnail of the asset represented by the asset administration shell. Used as default.

property asset_type: str | None
property global_asset_id: str | None
property specific_asset_id: ConstrainedList[SpecificAssetId]