Konfiguration der Node.js®-Schnittstelle

WinccoaManager Interface in JavaScript

Für den Zugriff auf WinCC OA-Funktionalität in TypeScript oder JavaScript muss eine Instanz der WinccoaManager-Klasse erstellt werden. Dies erfolgt mittels import(TypeScript) oder require(JavaScript)

Sollten zusätzliche Klassen eingesetzt werden, müssen diese innerhalb des import/require Blocks angegeben werden, siehe Beispiel unterhalb.

TypeScript - `import` WinccoaManager Klasse

// import WinCC OA interface
import { WinccoaManager } from 'winccoa-manager';
const winccoa = new WinccoaManager();

JavaScript - `require` WinccoaManager Klasse

// require WinCC OA interface
const { WinccoaManager } = require('winccoa-manager');
const winccoa = new WinccoaManager();

TypeScript - `import` mehrerer Klassen

import { WinccoaManager, WinccoaSecurityEventId, WinccoaError } from 'winccoa-manager';
const winccoa = new WinccoaManager();

Syntax-Manageroptionen

Der WinCC OA JavaScript Manager für Node.js erlaubt es über die Manageroptionen zusätzliche Parameter für Node.js sowie TypeScript/JavaScript anzuführen.

Diese müssen sich an die definierte Reihenfolge halten, um erfolgreich an die jeweilige Komponente übermittelt zu werden:

[Node.js Kommandozeilenparameter] [WinCC OA Manager Parameter] <Skriptname> [JavaScript Parameter]

Node.js-Kommandozeilenparameter

Kommandozeilenparameter, welche direkt an Node.js übergeben werden, siehe auch Unterstützte Node.js®-Kommandozeilenoptionen.

Node.js-Parameter müssen immer mit doppeltem Bindestrich "--" angegeben werden.

WinCC OA-Managerparameter

Allgemeine WinCC OA-Managerparameter, siehe Allgemeine Optionen.

Folgende Optionen werden zur Angabe des Projekts unterstützt:

-proj <Projektname>
-currentproj
-config <Konfigurationsdatei>
Umgebungsvariablen (PVSS_II_PROJ)

Anmerkung:

Die Option -num (Managernummer) ist optional. Sie wird nur benötigt, wenn der Manager in der Console angezeigt werden soll. Manager für einmalige Ausführungen (z.B. für ASCII-Import/-Export) müssen -num nicht angeben.

Skriptname

Der Pfad/Name des TypeScript/JavaScript-Skriptes, welches durch den Manager ausgeführt werden soll.

Der Pfad für das Skript muss relativ zum Verzeichnis nodejs des Projekts oder als absoluter Pfad zur Skriptdatei angegeben werden.

TypeScript/JavaScript-Parameter

Um einem Skript Parameter für TypeScript/JavaScript übergeben zu können, müssen diese am Ende der Manageroptionen, angeführt werden.

Der Zugriff innerhalb des Skripts erfolgt dann mittels der process.argv Konstante.

Persistenter Manager mit Debugging

--inspect -num 42 mymodule/index.js arg1 arg2

Der WinCC OA JavaScript Manager für Node.js wird mit der Node.js-Option --inspect im Debugging Modus gestartet.

Der WinCC OA-Manager startet mit der Manager-ID "42" und dem gestarteten Skript mymodule/index.js werden die Parameter arg1 sowie arg2 übergeben.

Einmalige Ausführung mit -currentproj

-currentproj mymodule/import.js

Der WinCC OA JavaScript Manager für Node.js wird mit dem aktuell aktiven Projekt gestartet. Es wird keine Managernummer angegeben, da es sich um eine einmalige Ausführung handelt (z.B. ein ASCII-Import).