Exportieren/Importieren von Informationen zur Basiseinheit über AML - TIAPortal

TIA Portal Openness: API für die Automatisierung von Engineering-Workflows

ft:publication_title
TIA Portal Openness: API für die Automatisierung von Engineering-Workflows
Product
TIAPortal
Version
V20
Publication date
01/2025
Language
de-DE
Exportieren/Importieren von Informationen zur Basiseinheit über AML

Voraussetzung

Verwendung

Im TIA Portal können Sie Informationen zur Basiseinheit aus dem TIA Portal exportieren und in das TIA Portal importieren, um den Informationsaustausch mit anderen Tools wie EPLAN zu vereinfachen.

Beim Export aus ein und Import in ein TIA Portal-Projekt werden zwei Arten von Basiseinheiten unterstützt:

  • Einzelne Basiseinheit

  • Doppelte Basiseinheit

Export einer Basiseinheit

Beispiel: CAx exportiert für ein Modul, das mit Informationen zur Basiseinheit in TIA Portal konfiguriert ist, die Informationen zur Basiseinheit als "Submodul" unter einem Modul in der AML-Datei.

Das Submodul der Basiseinheit wird stets exportiert mit:

  • PositionNumber: 0

  • DeviceItemType: Zubehör

  • BuiltIn: False

  • TypeIdentifier: "Typ-ID der Basiseinheit"

  • ID: Immer ein zufällig generierter GUID

Export einer einzelnen Basiseinheit

Das untenstehende Beispiel zeigt eine AML-Datei für ein DI-Modul, das mit einer einzelnen Basiseinheit im TIA Portal konfiguriert ist.

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

<InternalElement ID="6f76c890-5c5d-41c4-9ade-96543b0222ac" Name="DI 8x24VDC ST_1">

...

<InternalElement ID="69233c1f-7ef7-4999-8e84-691d0ff3a210" Name="BaseUnit">

<Attribute Name="DeviceItemType" AttributeDataType="xs:string">

<Value>Accessory</Value>

</Attribute>

<Attribute Name="PositionNumber" AttributeDataType="xs:int">

<Value>0</Value>

</Attribute>

<Attribute Name="BuiltIn" AttributeDataType="xs:boolean">

<Value>false</Value>

</Attribute>

<Attribute Name="TypeIdentifier" AttributeDataType="xs:string">

<Value>OrderNumber:6ES7 193-6BP00-0DA0</Value>

</Attribute>

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationRoleClassLib/DeviceItem" />

</InternalElement>

...

Export einer doppelten Basiseinheit

Das untenstehende Beispiel zeigt eine AML-Datei für zwei DI-Module, die mit doppelter Basiseinheit im TIA Portal konfiguriert sind. Beispiel: Das erste Modul mit der Basiseinheit wird mit dem Präfix IX300 und das zweite mit derselben doppelten Basiseinheit wird mit dem Präfix IX301 konfiguriert.

Beim Export wird nur das erste Modul der Basiseinheit mit dem Präfix IX300 mit dem Submodul der Basiseinheit in die AML-Datei exportiert. Das zweite Modul, das mit dem Präfix IX301, wird in kein untergeordnetes Submodul eingefügt.

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

<InternalElement ID="6f76c890-5c5d-41c4-9ade-96543b0222ac" Name="DI 8x24VDC ST_1">

...

<InternalElement ID="3a1bee8a-12d0-4ec4-849c-333d45113d9c" Name="BaseUnit">

<Attribute Name="DeviceItemType" AttributeDataType="xs:string">

<Value>Accessory</Value>

</Attribute>

<Attribute Name="PositionNumber" AttributeDataType="xs:int">

<Value>0</Value>

</Attribute>

<Attribute Name="BuiltIn" AttributeDataType="xs:boolean">

<Value>false</Value>

</Attribute>

<Attribute Name="TypeIdentifier" AttributeDataType="xs:string">

<Value>OrderNumber:6ES7 193-6BP60-0DA0</Value>

</Attribute>

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationRoleClassLib/DeviceItem" />

</InternalElement>

...

<InternalElement ID="5f843491-b053-4dc8-b879-9ac327ee2a7e" Name="DI 8x24VDC ST_2">

...

<InternalElement ID="55c30280-6f8a-4c37-9b2d-41bb90941258" Name="DI 8x24VDC ST_2">

<Attribute Name="PositionNumber" AttributeDataType="xs:int">

<Value>1</Value> </Attribute>

<Attribute Name="BuiltIn" AttributeDataType="xs:boolean">

<Value>true</Value>

</Attribute>

...

Import einer Basiseinheit

Es ist möglich, ein mit einem Submodul einer Basiseinheit konfigurierten Modul in eine AML-Datei zu importieren.

Während des Imports einer Basiseinheit

  • haben GUID, PositionNumber, BuiltIn und DeviceItem keine Relevanz und werden deshalb nicht im TIA Portal angezeigt.

  • Wenn ein unbeabsichtigtes Modul in der AML-Datei ein Submodul einer Basiseinheit hat, gibt Openness das Attribut "BaseUnit" dafür nicht zurück. Somit zeigt CAx in der Protokolldatei eine entsprechende Warnung an.

  • CAx prüft nicht auf die Richtigkeit der MLFB der Basiseinheit in der AML-Datei (außer zur Ermittlung, ob es sich um eine einzelne oder doppelte Basiseinheit handelt). CAx versucht, die MLFB der Basiseinheit über Openness festzulegen. Tritt in Openness ein Fehler auf, wird ein entsprechender Fehler angezeigt.

  • Der Import der Vorgängerversion der AML-Datei mit/ohne Informationen zur Basiseinheit ist erfolgreich, wenn Informationen ins TIA Portal importiert werden.

Import einer einzelnen Basiseinheit

Beim Import einer einzelnen Basiseinheit wird nur das Modul, das das Submodul der Basiseinheit in der AML-Datei enthält, mit Informationen zur Basiseinheit ins TIA Portal importiert.

Die einzelne Basiseinheit wird anhand des TypeIdentifier und dem nachfolgenden Muster in der AML-Datei identifiziert:

OrderNumber:xxxx 193-6[B|U|T]xYx-xxxx, dabei liegt der Wert von Y (11. Stelle) im Bereich von 0 bis 5.

Import einer doppelten Basiseinheit:

Beim Import einer doppelten Basiseinheit werden zwei (benachbarte) Module mit Informationen zur Basiseinheit im TIA Portal angezeigt. Das erste Modul mit einem Submodul einer doppelten Basiseinheit in der AML-Datei wird mit einer doppelten Basiseinheit importiert, indem das Suffix |X300 an die MLFB der Basiseinheit angehängt wird. Das zweite Modul, das kein untergeordnetes Submodul einer Basiseinheit hat, wird mit derselben Basiseinheit importiert, indem das Suffix |X301 an die MLFB der Basiseinheit angehängt wird. Die doppelte Basiseinheit wird anhand des TypeIdentifier und dem nachfolgenden Muster in der AML-Datei identifiziert:

OrderNumber:xxxx 193-6[B|U|T]x6x-xxxx