ITcSysManager

ITcSysManager ist die Hauptschnittstelle des TwinCAT Automation Interface. Diese Schnittstelle ermöglicht grundlegende Operationen zwecks Konfiguration von TwinCAT 3 XAE und besteht aus mehreren Methoden um dies zu tun. Im Laufe der Jahre wurde die ITcSysManager-Schnittstelle mit weiteren Funktionalitäten erweitert, um dem Kunden den Zugriff auf alle Funktionen des Automation Interface zu vereinfachen. Aufgrund von Einschränkungen in den COM-Objektmodellen mussten diese neuen Funktionen als getrennte Schnittstellen dem Automation Interface hinzugefügt werden. Aus diesem Grunde wurden diese Eigenschaften, jedes Mal wenn ein neuer Eigenschaftensatz hinzugefügt wurde, in einer neuen Schnittstelle zusammengefasst, die dann ITcSysManagerX genannt wurde, wobei X eine Zahl ist, die bei jedem Hinzufügen einer neuen Schnittstelle inkrementiert wurde. Die folgenden Tabellen erläutern, welche Methoden Bestandteil der ITcSysManager-Schnittstelle sind, und welche jeweils einer neuen “;Eigenschaftensatz”;-Schnittstelle hinzugefügt wurden.

Methoden

ITcSysManager-Methoden	Beschreibung	Verfügbar seit
NewConfiguration	Erzeugt eine neue Konfiguration	TwinCAT 2.11
OpenConfiguration	Lädt eine zuvor erzeugte Konfigurationsdatei (WSM-Datei).	TwinCAT 2.11
SaveConfiguration	Speichert die Konfiguration in eine Datei mit angegebenem Namen oder mit dem aktuellen Namen.	TwinCAT 2.11
ActivateConfiguration	Aktiviert die Konfiguration (genau wie „;Save To Registry“; (In Registry speichern))	TwinCAT 2.11
LookupTreeItem	Sucht nach einem Konfigurationselement (Element im Baum) nach Namen und gibt eine ITcSmTreeItem-Schnittstelle zurück.	TwinCAT 2.11
StartRestartTwinCAT	Startet oder startet erneut das TwinCAT-System	TwinCAT 2.11
IsTwinCATStarted	Prüft, ob das TwinCAT-System bereits läuft.	TwinCAT 2.11
LinkVariables	Verknüpft zwei Variablen, die mit Namen angegeben werden	TwinCAT 2.11
UnlinkVariables	Löscht die Verknüpfung zwischen zwei mit Namen bezeichneter Variablen oder alle Verknüpfungen zu einer Variablen.	TwinCAT 2.11

ITcSysManager2-Methoden	Beschreibung	Verfügbar seit
SetTargetNetId	Legt die Ziel-NetId der aktuell geöffneten TwinCAT-Konfiguration fest.	TwinCAT 2.11
GetTargetNetId	Ruft die Ziel-NetId der aktuell geöffneten TwinCAT-Konfiguration ab.	TwinCAT 2.11
GetLastErrorMessages	Ruft die letzten Fehlermeldungen ab, die im TwinCAT-Subsystem aufgetreten sind.	TwinCAT 2.11

ITcSysManager3-Methoden	Beschreibung	Verfügbar seit
LookupTreeItemById	Sucht nach einem Tree Item mit spezifizierter Element-Id.	TwinCAT 2.11
ProduceMappingInfo	Erstellt eine Xml-Beschreibung des eigentlichen Konfigurations-Mappings.	TwinCAT 3.1
ClearMappingInfo	Löscht die Mapping-Informationen.	TwinCAT 2.11

Kommentare

Die ITcSysManager-Schnittstelle enthält zwei Methoden für das Navigieren innerhalb von TwinCAT XAE: ITcSysManager::LookupTreeItem und ITcSysManager3::LookupTreeItemById. Eine ausführliche Erläuterung bezüglich dem Browsen von TwinCAT XAE finden Sie im Kapitel Tree item-Browsingmodelle.

Achtung: Die drei Methoden ITcSysManager::NewConfiguration, ITcSysManager::OpenConfiguration und ITcsSysManager::SaveConfiguration sind ausschließlich im Kompatibilitätsmodus verfügbar. Sie im Standardmodus aufzurufen löst eine E_NOTSUPPORTED-Ausnahme aus.

Die ITcSysmanager- und ITcSmTreeItem-Schnittstellen ermöglichen uneingeschränkten Zugriff auf eine TwinCAT-Konfiguration. Im Abschnitt „;Vorgehensweise...“; dieser Dokumentation finden Sie eine lange (aber unvollständige) Liste von Beispielen, wie eine TwinCAT-Konfiguration automatisch bearbeitet werden kann.

Versionsinformationen

Voraussetzungen

Erforderliche TwinCAT Version
Diese Schnittstelle wird ab TwinCAT 2.11 unterstützt.