Ein Objekt aus einer Masterkopie erstellen - 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
Ein Objekt aus einer Masterkopie erstellen

Voraussetzung

Einleitung

Die Schnittstelle TIA Portal Openness API unterstützt die Verwendung von Masterkopien im Projekt. Sie können in der Zusammensetzung des Objekts aus einer Masterkopie in einer Projektbibliothek oder einer globalen Bibliothek mit Hilfe der Methode CreateFrom ein Objekt erstellen.

Der Ausgabetyp entspricht dem Ausgabetyp der jeweiligen Zusammensetzung.

Die Methode CreateFrom unterstützt nur Masterkopien, die einzelne Objekte enthalten. Wenn die Zusammensetzung, wo die Aktion aufgerufen wird, und die Quellmasterkopie inkompatibel sind (z. B. wenn die Quellmasterkopie eine PLC-Variablentabelle enthält und die Zusammensatzung die Zusammensetzung eines PLC-Bausteins ist), wird eine wiederherstellbare Ausnahme ausgelöst.

Die folgenden Zusammensetzungen werden unterstützt:

  • Siemens.Engineering.HW.DeviceComposition

  • Siemens.Engineering.HW.DeviceItemComposition

  • Siemens.Engineering.SW.Blocks.PlcBlockComposition

  • Siemens.Engineering.SW.Tags.PlcTagTableComposition

  • Siemens.Engineering.SW.Tags.PlcTagComposition

  • Siemens.Engineering.SW.Types.PlcTypeComposition

  • Siemens.Engineering.SW.TechnologicalObjects.TechnologicalInstanceDBComposition

  • Siemens.Engineering.SW.Tags.PlcUserConstantComposition

  • Siemens.Engineering.Hmi.Tag.TagTableComposition

  • Siemens.Engineering.Hmi.Tag.TagComposition

  • Siemens.Engineering.Hmi.Screen.ScreenComposition

  • Siemens.Engineering.Hmi.Screen.ScreenTemplateComposition

  • Siemens.Engineering.Hmi.RuntimeScripting.VBScriptComposition

  • Siemens.Engineering.HW.SubnetComposition

  • Siemens.Engineering.HW.DeviceUserGroupComposition

  • Siemens.Engineering.SW.Blocks.PlcBlockUserGroupComposition

  • Siemens.Engineering.SW.ExternalSources.PlcExternalSourceUserGroupComposition

  • Siemens.Engineering.SW.Tags.PlcTagTableUserGroupComposition

  • Siemens.Engineering.SW.Types.PlcTypeUserGroupComposition

Programmcode: PLC-Baustein aus einer Masterkopie erstellen

Um einen PLC-Baustein aus einer Masterkopie in einer Bibliothek zu erstellen, ändern Sie folgenden Programmcode:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

var plcSoftware = ...;

MasterCopy copyOfPlcBlock = ...;

PlcBlock plcSoftware.BlockGroup.Blocks.CreateFrom(copyOfPlcBlock);

Programmcode: Ein Gerät aus einer Masterkopie erstellen

Um ein Gerät aus einer Masterkopie in einer Bibliothek zu erstellen, ändern Sie folgenden Programmcode:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

Project project = ...;

MasterCopy copyOfDevice = ...;

Device newDevice = project.Devices.CreateFrom(copyOfDevice);

Programmcode: Ein Geräteelement aus einer Masterkopie erstellen

Um ein Geräteelement aus einer Masterkopie in einer Bibliothek zu erstellen, ändern Sie folgenden Programmcode:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

Device device = ...;

MasterCopy copyOfDeviceItem = ...;

DeviceItem newDeviceItem = device.DeviceItems.CreateFrom(copyOfDeviceItem);

Programmcode: Ein Subnetz aus einer Masterkopie erstellen

Um ein Subnetz aus einer Masterkopie in einer Bibliothek zu erstellen, ändern Sie folgenden Programmcode:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

Project project = ...;

MasterCopy copyOfSubnet = ...;

Subnet newSubnet = project.Subnets.CreateFrom(copyOfSubnet);

Programmcode: Einen Geräteordner aus einer Masterkopie erstellen

Um einen Geräteordner aus einer Masterkopie in einer Bibliothek zu erstellen, ändern Sie folgenden Programmcode:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

Project project = ...;

MasterCopy copyOfDeviceGroup = ...;

DeviceGroup newDeviceGroup= project.DeviceGroups.CreateFrom(copyOfDeviceGroup);