ConceptDescription🔗

Inheritances 🔗

• Identifiable
• HasDataSpecification

Properties 🔗

extensions: Optional[List[Extension]] 🔗

(From HasExtensions)

An extension of the element.

category: Optional[NonEmptyString] 🔗

(From Referable)

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.

The category is not identical to the semantic definition (HasSemantics) of an element. The category e.g. could denote that the element is a measurement value whereas the semantic definition of the element would denote that it is the measured temperature.

idShort: Optional[IdShort] 🔗

(From Referable)

In case of identifiables this attribute is a short name of the element. In case of referable this ID is an identifying string of the element within its name space.

In case the element is a property and the property has a semantic definition (HasSemantics.semanticId) conformant to IEC61360 the Referable.idShort is typically identical to the short name in English.

displayName: Optional[List[LangString]] 🔗

(From Referable)

Display name. Can be provided in several languages.

If no display name is defined in the language requested by the application, then the display name is selected in the following order if available:

• the preferred name in the requested language of the concept description defining the semantics of the element
• If there is a default language list defined in the application, then the corresponding preferred name in the language is chosen according to this order.
• the English preferred name of the concept description defining the semantics of the element
• the short name of the concept description
• the Referable.idShort of the element

description: Optional[List[LangString]] 🔗

(From Referable)

Description or comments on the element.

The description can be provided in several languages.

If no description is defined, then the definition of the concept description that defines the semantics of the element is used.

Additional information can be provided, e.g., if the element is qualified and which qualifier types can be expected in which context or which additional data specification templates are provided.

checksum: Optional[NonEmptyString] 🔗

(From Referable)

Checksum to be used to determine if an Referable (including its aggregated child elements) has changed.

The checksum is calculated by the user's tool environment. The checksum has no semantic meaning for an asset administration shell model and there is no requirement for asset administration shell tools to manage the checksum

administration: Optional[AdministrativeInformation] 🔗

(From Identifiable)

Administrative information of an identifiable element.

Some of the administrative information like the version number might need to be part of the identification.

id: Identifier 🔗

(From Identifiable)

The globally unique identification of the element.

embeddedDataSpecifications: Optional[List[EmbeddedDataSpecification]] 🔗

(From HasDataSpecification)

Embedded data specification.

isCaseOf: Optional[List[Reference]] 🔗

Reference to an external definition the concept is compatible to or was derived from.

It is recommended to use a global reference.

Compare to is-case-of relationship in ISO 13584-32 & IEC EN 61360"

Invariants 🔗

• Extensions must be either not set or have at least one item
  (From HasExtensions)
  

  not (self.extensions is not None)
  or (len(self.extensions) >= 1)

• Constraint AASd-077: The name of an extension within Has-Extensions needs to be unique.
  (From HasExtensions)
  

  not (self.extensions is not None)
  or ExtensionNamesAreUnique(
      self.extensions
  )

• Description must be either not set or have at least one item
  (From Referable)
  

  not (self.description is not None)
  or (len(self.description) >= 1)

• Description specifies no duplicate languages
  (From Referable)
  

  not (self.description is not None)
  or LangStringsHaveUniqueLanguages(
      self.description
  )

• Display name must be either not set or have at least one item
  (From Referable)
  

  not (self.displayName is not None)
  or (len(self.displayName) >= 1)

• Display name specifies no duplicate languages
  (From Referable)
  

  not (self.displayName is not None)
  or LangStringsHaveUniqueLanguages(
      self.displayName
  )

• Embedded data specifications must be either not set or have at least one item
  (From HasDataSpecification)
  

  not (self.embeddedDataSpecifications is not None)
  or (len(self.embeddedDataSpecifications) >= 1)

• Is-case-of must be either not set or have at least one item
  

  not (self.isCaseOf is not None)
  or (len(self.isCaseOf) >= 1)

• Constraint AASd-051: A concept description shall have one of the following categories: 'VALUE', 'PROPERTY', 'REFERENCE', 'DOCUMENT', 'CAPABILITY',; 'RELATIONSHIP', 'COLLECTION', 'FUNCTION', 'EVENT', 'ENTITY', 'APPLICATION_CLASS', 'QUALIFIER', 'VIEW'.
  

  not (self.category is not None)
  or (self.category in ValidCategoriesForConceptDescription)

• Constraint AASc-003: For all concept descriptions with a category except VALUE using data specification IEC 61360, the definition of the data specification is mandatory and shall be defined at least in English.
  

  not (
      (
          (self.category is not None)
          and self.category != 'VALUE'
          and (self.embeddedDataSpecifications is not None)
      )
  )
  or DataSpecificationIec61360sHaveDefinitionAtLeastInEnglish(
      self.embeddedDataSpecifications
  )

• Constraint AASc-008: For a concept description with category VALUE using data specification IEC 61360, the value of the data specification shall be set.
  

  not (
      (
          (self.category is not None)
          and self.category == 'VALUE'
          and (self.embeddedDataSpecifications is not None)
      )
  )
  or DataSpecificationIec61360sHaveValue(
      self.embeddedDataSpecifications
  )

• Constraint AASc-007: For a concept description with category QUALIFIER_TYPE using data specification IEC 61360, the data type of the data specification is mandatory and shall be defined.
  

  not (
      (
          (self.category is not None)
          and self.category == 'QUALIFIER_TYPE'
          and (self.embeddedDataSpecifications is not None)
      )
  )
  or DataSpecificationIec61360sHaveDataType(
      self.embeddedDataSpecifications
  )

• Constraint AASc-006: For a concept description with category DOCUMENT using data specification IEC 61360, the data type of the data specification is mandatory and shall be one of: FILE, BLOB, HTML.
  

  not (
      (
          (self.category is not None)
          and self.category == 'DOCUMENT'
          and (self.embeddedDataSpecifications is not None)
      )
  )
  or DataSpecificationIec61360sForDocumentHaveAppropriateDataType(
      self.embeddedDataSpecifications
  )

• Constraint AASc-005: For a concept description with category REFERENCE using data specification IEC 61360, the data type of the data specification is mandatory and shall be one of: STRING, IRI, IRDI.
  

  not (
      (
          (self.category is not None)
          and self.category == 'REFERENCE'
          and (self.embeddedDataSpecifications is not None)
      )
  )
  or DataSpecificationIec61360sForReferenceHaveAppropriateDataType(
      self.embeddedDataSpecifications
  )

• Constraint AASc-004: For a concept description with category PROPERTY or VALUE using data specification IEC 61360, the data type of the data specification is mandatory and shall be one of: DATE, STRING, STRING_TRANSLATABLE, INTEGER_MEASURE, INTEGER_COUNT, INTEGER_CURRENCY, REAL_MEASURE, REAL_COUNT, REAL_CURRENCY, BOOLEAN, RATIONAL, RATIONAL_MEASURE, TIME, TIMESTAMP.
  

  not (
      (
          (self.category is not None)
          and (
              (
                  self.category == 'PROPERTY'
                  or self.category == 'VALUE'
              )
          )
          and (self.embeddedDataSpecifications is not None)
      )
  )
  or DataSpecificationIec61360sForPropertyOrValueHaveAppropriateDataType(
      self.embeddedDataSpecifications
  )

Usages