Dynamische Instanzen erzeugen
Achtung: Eine dynamische Instanz ist ein Container für Laufzeitinstanzen, die über eine Datenbanktabelle einer externen Datenbank erzeugt werden.
Weitere Informationen zur Lizenzzuordnung und zu weiteren Enterprise+-Funktionen finden Sie unter Lizenzstufen.
Bevor Sie dynamische Instanzen verwenden, konfigurieren Sie unter Einstellungen die Dynamische Instanzen API.
Dynamische Instanz anlegen
Wenn Sie Verbindungen zur Laufzeit generieren möchten, wählen Sie im Snap-in „Verbindungen“ unter „Instanz erstellen“ den Menüpunkt „Dynamische Instanz erstellen“.
Im Dialog vergeben Sie einen Namen für die dynamische Instanz, wählen die gewünschte Vorlage aus und definieren Standardwerte für die Vorlagenvariablen.
Die dynamische Instanz selbst dient dabei als Container. Die eigentlichen Laufzeitinstanzen werden später über die API-Tabelle angelegt und in der Diagnose unter dieser dynamischen Instanz wie in einem Ordner zusammengefasst.
Bestätigen Sie den Dialog mit „Erstellen“ und veröffentlichen Sie die dynamische Instanz. Danach wird in der unter Einstellungen > Dynamische Instanzen konfigurierten Datenbank im Schema api eine neue Tabelle angelegt.
Der Tabellenname wird mit dem Schemapräfix api generiert und enthält nicht nur den Namen der dynamischen Instanz, sondern den gesamten Pfad der dynamischen Instanz. Diesen Namen dürfen Sie nicht ändern.
Anmerkung: Wir empfehlen, einen Benutzer zu erstellen, der ausschließlich Zugriff auf die Tabellen des api-Schemas hat. Für diesen Zweck finden Sie die vorinstallierte Rolle apiRole in der unter Einstellungen > Dynamische Instanzen konfigurierten Datenbank unter Sicherheit > Rollen.
Verbindungen über die API-Tabelle erzeugen
Innerhalb dieser Tabelle finden Sie die Variablen der Vorlage sowie die Felder [ID], [OpcR_Changed] und [InstanceName].
Um zur Laufzeit eine neue Instanz zu erzeugen, tragen Sie in einer Zeile die Werte für die Vorlagenvariablen ein und vergeben zusätzlich einen Namen über [InstanceName]. Wenn Sie für eine Variable keinen Wert angeben, verwendet der OPC Router den Standardwert aus dem Dialog „Dynamische Instanz erstellen“.
Für jede ausgefüllte Zeile wird eine Laufzeitinstanz innerhalb der dynamischen Instanz angelegt.
Anmerkung: Eine PlugIn_Id ist immer dann zusätzlich erforderlich, wenn in einer Vorlage ein Plug-in selbst dynamisch als Vorlagenvariable in ein Trigger- oder Transferobjekt eingebunden wird. Die Plug-in-IDs Ihrer Plug-ins sind eindeutig und stehen in der View api.View_PlugInInstances der unter Einstellungen > Dynamische Instanzen konfigurierten Datenbank.
Wenn für die Vorlage eine PlugIn_Id erforderlich ist, tragen Sie diese zusätzlich in der API-Tabelle der dynamischen Instanz ein.
Die Spalten [ID] und [OpcR_Changed] werden automatisch vom OPC Router gefüllt. Der Wert [InstanceName] muss eindeutig sein und wird zur Laufzeit als Anzeigename verwendet. Zusätzlich können Sie über Backslashes in [InstanceName] eine Ordnerstruktur innerhalb des Containers erzeugen.
Der Wert [OpcR_Changed] zeigt an, wann die Verbindung zuletzt geändert wurde.
Zeitangaben in dynamischen Instanzen
Für Zeitwerte, zum Beispiel für den Zyklus eines Time-Triggers, gelten folgende TimeOffsets:
- 1ms für Millisekunden
- 1s für Sekunden
- 1m für Minuten
- 1h für Stunden
- 1d für Tage
Zwischen Zahl und Einheit darf kein Leerzeichen stehen.
Achtung: Die erzeugten Laufzeitinstanzen sind sofort aktiv und müssen nicht zusätzlich veröffentlicht werden.
Unter Umständen müssen Sie die Ansicht über die Schaltfläche „Aktualisieren“ neu laden, damit alle dynamischen Instanzen angezeigt werden.
