ComManager-Objekt
Das ComManager- Objekt kapselt einen vollständigen WinCC OA- Manager, der im selben Prozessraum wie die Hostanwendung läuft. Daraus resultieren einige Einschränkungen:
-
Der ComManager kann nicht innerhalb von WinCC OA (im Ctrl oder im Vision) verwendet werden.
-
Der Manager muss über das erste instanzierte Objekt über die Init- Methode gestartet werden.
-
Der Manager beendet den eigenen Prozess, wenn die Config- Datei fehlerhafte Einträge enthält oder keine Verbindung zum Data- und Event- Manager aufgebaut werden kann. In diesem Fall wird auch die Hostanwendung beendet.
Die einzelnen Methoden entsprechen weitgehend den gleichnamigen Ctrl- Funktionen. Die Datenpunkt- Funktionen arbeiten im Ctrl mit Parameter- Arrays, was von der COM Laufzeitschicht nicht unterstützt wird. Daher sind solche Parameter als VARIANT ausgeführt, die entweder einen einzelnen Wert des Typs oder eben ein Array dieser Typen aufnehmen, wobei auch verschränkte Array's - z.B. bei dpGetPeriod mit mehreren Datenpunkten - unterstützt werden.
Auf den nachfolgenden Seiten sind die einzelnen Methoden, die das ComManager-Objekt bereitstellt, ausführlich beschrieben. Ein Beispiel finden Sie unter EXCEL-Beispiel.
| Methode | Beschreibung |
|---|---|
| Init() | Initialisiert (startet) den COM-Manager |
| dpGet() | Abfrage von Werten |
| dpSet() | Setzt einen Wert |
| dpConnect() | Baut einen Hotlink zu einem Datenpunkt auf. |
| dpConnectCB() | Ereignis als Reaktion bei Wertänderung |
| dpDisconnect() | Baut die Verbindung wieder ab. |
| dpElementType() | Liefert zu einem Datenpunktelement den entsprechenden Elementtyp. |
| dpGetAlias() | Liefert den Alias zum Datenpunktelement. |
| dpGetAsynch() | Liefert die historischen Werte, die zum Zeitpunkt galten. |
| dpGetDescription() | Liefert die Beschreibung zum Datenpunktelement. |
| dpGetFormat() | Liefert das Format zum Datenpunktelement. |
| dpGetPeriod() | Liefert alle Werte innerhalb einer Periode. |
| dpGetUnit() | Liefert die Einheit zum Datenpunktelement. |
| dpNames() | Liefert die Datenpunkte, die dem Typ und Muster entsprechen. |
| dpQuery() | Setzt eine Abfrage mit Hilfe von SQL-Statements ab. |
| dpTypes() | Liefert die Datenpunkttypen, die dem Muster entsprechen. |
| getLicense() | Liefert die Anzahl der noch freien Lizenzen für den angegebenen API-Typ. |
| dpGetPeriodIntervall() | Spezielle Funktion für den Excel Report |
| dpGetAsynchIntervall() | Spezielle Funktion für den Excel Report |
| getTimeList() | Spezielle Funktion für den Excel Report |
