FB_NoSQLResultEvt

FB_NoSQLResultEvt 1:

Funktionsbaustein zum Auslesen gepufferter Datensätze.

Die Datensätze müssen zuvor mit dem FB_NoSQLQueryEvt beim Aufruf der ExecuteDataReturn-Methode aus der Datenbank abgerufen werden. Dabei wird der FB_NoSQLResultEvt zur Initialisierung angegeben. Diese können dann entweder als Struktur der SPS oder als Zeichenfolge ausgelesen werden.

Syntax

Definition:

FUNCTION BLOCK FB_SQLResultEvt
VAR_INPUT
    sNetID: T_AmsNetID := '';
    tTimeout: TIME := T#5S;
END_VAR
VAR_OUTPUT
    bBusy: BOOL;
    bError: BOOL;
    ipTcResult: Tc3_EventLogger.I_TcMessage
END_VAR

FB_NoSQLResultEvt 2: Eingänge

Name

Type

Beschreibung

sNetID

T_AmsNetID

AMS-Netzwerkkennung des Zielgerätes, an das der ADS-Befehl gerichtet ist.

tTimeout

TIME

Gibt die Zeit bis zum Abbruch der Funktion an.

FB_NoSQLResultEvt 3: Ausgänge

Name

Type

Beschreibung

bBusy

BOOL

TRUE, sobald eine Methode des Bausteins aktiv ist.

bError

BOOL

TRUE, sobald ein Fehler eintritt.

ipTcResult

Tc3_EventLogger.I_TcMessage

Nachrichten Interface vom TwinCAT 3 Eventlogger, welches Details zum Rückgabewert zur Verfügung stellt.

FB_NoSQLResultEvt 4: Eigenschaften

Name

Typ

Beschreibung

eTraceLevel

TcEventSeverity

Gibt die Gewichtung der Ereignisse an. Nur Ereignisse über diesem Wert werden an das TwinCAT System gesendet.

nDataCount

UDINT

Gibt die Anzahl der zurückgelieferten verfügbaren Datensätze vom Aufruf des FB_NoSQLQueryEvt.ExecuteDataReturn() an.

FB_NoSQLResultEvt 5: Methoden

Name

Definitionsort

Beschreibung

ReadAsString

Lokal

Liest eine vorgegebene Anzahl von Datensätzen aus den im TwinCAT Database Server gepufferten Ergebnisdaten als Json-String aus.

ReadAsStruct

Lokal

Liest eine vorgegebene Anzahl von Datensätzen aus den im TwinCAT Database Server gepufferten Ergebnisdaten in die angegebene Struktur.

Release

Lokal

Gibt vom TwinCAT Database Server gepufferte Daten wieder frei.

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS Bibliotheken

TwinCAT v3.1 Build 4022.20

PC oder CX (x86)

Tc3_Database