✕
✕

SystemDataItemByKey

TwinCAT TIA
Geräte DEPRAG Geräte Ablaufsteuerung ActiveDevices Ein Client Systeminfo Steuerungsdaten

ns=2;s=DEPRAG Smart/Devices/DEPRAG/AST/ActiveDevices/0/SystemOverview/SystemData/SystemDataItemByKey

Ruft einen Eintrag ab.

Parameter:

    Key
    Eindeutiger Identifier, der bestimmt, welcher Eintrag aus den Systemdaten abgerufen werden sollen.

Rückgabewert:

    SystemDataItemByKey
    Eine Variable vom Typ OpcMethodReturnValueString. In der Eigenschaft Result sind die befehlsspezifischen Rückgabewerte enthalten
      Result
      Wert des angeforderten Parameters.

Beispiele:

Neben den bereits erläuterten Parametern sind für die Implementierung in TwinCAT 3 nachfolgende Variablen anzulegen / zu übergeben:

Beckhoff Parameter:

    bAstSystemDataItemByKey
    Eine boolesche Variable, über welche die Ausführung des SystemDataItemByKey-Befehls getriggert werden kann.
    outputAstSystemDataItemByKey
    Eine Instanz der ST_StringOutputData Struktur in welche der Rückgabewert der SystemDataItemByKey-Methode geschrieben wird.
    hrAstSystemDataItemByKey
    Hiermit kann die Ausführung des Befehls überwacht werden. Fehler-Codes haben den Typ HRESULT.
    fbAst
    Eine Instanz des, mit der DEPRAG Smart-Bibliothek gelieferten, FB_AST Funktionsbausteins.
    sDeviceId
    Ein String-Wert, der das Gerät spezifiziert, für welches Systemdaten abgeholt werden sollen.
    sKey
    Die String-Variable gibt an, welcher Parameter der Systemdaten ausgelesen werden soll.
    ConnectionHandle
    Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle". 


VAR
     bAstSystemDataItemByKey    : BOOL;
     outputAstSystemDataItemByKey  : ST_StringOutputData;                                          
     hrAstSystemDataItemByKey   : HRESULT;

     fbAst   : FB_AST;
END_VAR

hrAstSystemDataItemByKey := fbAst.SystemDataItemByKey(
       bExecute    := bAstSystemDataItemByKey,   
       ConnectionHandle := depragSmartConnection.ConnectionHandle,
       sDeviceId   := '0',
       sKey    := 'DeviceName',
       OutputData   => outputAstSystemDataItemByKey);
IF hrAstSystemDataItemByKey <> S_FALSE THEN 
 bAstSystemDataItemByKey := FALSE;
END_IF

Für Beispiele und Erklärungen bezüglich der Aufrufe von Knoten via Siemens TIA Portal sei an dieser Stelle auf den Unterpunkt "Siemens TIA Portal" in Abschnitt "Erste Schritte" verwiesen.