AssetInformation🔗

In AssetInformation identifying metadata of the asset that is represented by an Asset Administration Shell is defined.

Several asset kinds are distinguished like for example type assets and instance assets.

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 life cycle where a stabilized/constant global asset identifier does not already exist, the corresponding attribute AssetInformation.globalAssetId is optional.

Constraint AASd-116🔗

globalAssetId (case-insensitive) is a reserved key for SpecificAssetId.name with the semantics as defined in https://admin-shell.io/aas/3/x/AssetInformation/globalAssetId where x is the minor version.

AASd-116 is important to enable a generic search across global and specific asset IDs (e.g. in IDTA-01002-3-0 discovery operations like GetAllAssetLinksById). In the future the constraint might become more strict in stating that the name globalAssetId shall not be used as SpecificAssetId.name.
The comparison against globalAssetId is ASCII case-insensitive.
Constraint AASd-131🔗
For AssetInformation either the AssetInformation.globalAssetId shall be defined or at least one item in AssetInformation.specificAssetIds.

Properties 🔗

assetKind: AssetKind 🔗
globalAssetId: Optional[Identifier] 🔗
Identifier of the asset, the Asset Administration Shell is representing.
This attribute is required as soon as the Asset Administration Shell 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 asset ID but already an internal identifier. The internal identifier would be modelled via AssetInformation.specificAssetIds.
specificAssetIds: Optional[List[SpecificAssetId]] 🔗
Additional domain-specific, typically proprietary identifier for the asset like serial number, manufacturer part ID, customer part IDs, etc.
assetType: Optional[Identifier] 🔗
In case AssetInformation.assetKind is not AssetKind.NotApplicable the AssetInformation.assetType is the asset ID of the type asset of the asset under consideration as identified by AssetInformation.globalAssetId.
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".
defaultThumbnail: Optional[Resource] 🔗
Thumbnail of the asset represented by the Asset Administration Shell.
Used as default.

Invariants 🔗

  • Constraint AASd-116: ``globalAssetId`` (case-insensitive) is a reserved key. If used as value for the name of specific asset ID then the value of specific asset ID shall be identical to the global asset ID with semantics as defined in https://admin-shell.io/aas/3/x/AssetInformation/globalAssetId, x being the minor version of the used specification.
    not (self.specificAssetIds is not None)
or (
    all(
        not SpecificAssetIdNameMatchesGlobalAssetId(
            specificAssetId.name
        )
        or (
            (
                (self.globalAssetId is not None)
                and specificAssetId.value == self.globalAssetId
            )
        )
        for specificAssetId in self.specificAssetIds
    )
)
  • Constraint AASd-131: Either the global asset ID shall be defined or at least one specific asset ID.
    (
    (
        (
            (self.globalAssetId is not None)
            or (self.specificAssetIds is not None)
        )
    )
    and (
        not (self.specificAssetIds is not None)
        or (len(self.specificAssetIds) >= 1)
    )
)
  • Specific asset IDs must be either not set or have at least one item.
    not (self.specificAssetIds is not None)
or (len(self.specificAssetIds) >= 1)

Usages

AssetAdministrationShell AssetAdministrationShell.assetInformation