✕
✕

Send

TwinCAT TIA
Netzwerk E-Mail

ns=2;s=DEPRAG Smart/Network/EMailClient/Send

Dieser Befehl sendet eine E-Mail-Nachricht ohne Anhänge an alle im Feld MailAddressTo hinterlegten E-Mail-Adressen. Vor Verwendung der Funktionalität muss der SMTP-Server in den Einstellungen SmtpServerSettings gesetzt werden.

Parameter:

Rückgabewert:

    Send
    Eine Variable vom Typ OpcMethodReturnValueVoid. Die Methode hat keine befehlsspezifischen Rückgabewerte.

Beispiele:

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

Beckhoff Parameter:

    EmailAddressArray
    Eine Variable vom Typ "ARRAY[1..50] OF STRING(255)" in welchem die Empfänger E-Mail-Adressen hinterlegt werden
    bEMailClientSend
    Eine boolesche Variable, über welche die Ausführung des Send-Befehls getriggert werden kann.
    OutputDataEMailClientSend
    Eine Instanz der "ST_VoidOutputData" Struktur in welche der Rückgabewert des Send-Befehls geschrieben wird.
    hrEMailClientSend
    Hiermit kann die Ausführung des Befehls überwacht werden. Fehler-Codes haben den Typ "HRESULT".
    fbEMailClient
    Eine Instanz des, mit der DEPRAG Smart-Bibliothek gelieferten, "FB_EMailClient" Funktionsbausteins.
    sSubject
    Eine Variable vom Typ "POINTER TO ARRAY[1..1000] OF BYTE" in welchem der Betreff der E-Mail-Nachricht hinterlegt ist.
    SizeOfSubject
    Eine UINT-Variable, welche die Länge des Betreffs enthält.
    sContent
    Eine Variable vom Typ "POINTER TO ARRAY[1..5000] OF BYTE" in welchem der Text der E-Mail-Nachricht hinterlegt ist.
    SizeOfContent
    Eine UINT-Variable, welche die Länge des Textes enthält.
    sMailAdressFrom
    Eine Zeichenkette vom Typ "STRING(255)", welche die Absender E-Mail-Addresse spezifiziert.
    nNumberOfAddressesToMailTo
    Eine UINT-Variable, welche die Anzahl der Empfänger E-Mail-Adressen widergibt.
    ConnectionHandle
    Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle". 


VAR
   EmailAddressArray        : ARRAY[1..50] OF STRING(255) := ['employee@example.com'];
   bEMailClientSend       : BOOL;
   OutputDataEMailClientSend     : ST_VoidOutputData;
   hrEMailClientSend       : HRESULT;
   testShortByteArray : ARRAY[1..10] OF BYTE := [84, 101, 115, 116];
   testLongByteArray : ARRAY[1..1000] OF BYTE := [84, 101, 115, 116, 255, 84, 255];
   fbEMailClient         : FB_EMailClient;
END_VAR

hrEMailClientSend := fbEMailClient.EMailClientSend(  
          bExecute       := bEMailClientSend,
          ConnectionHandle    := depragSmartConnection.ConnectionHandle,
          sMailAdressFrom     := 'test@deprag.de',
          MailAddressTo     := EmailAddressArray,
          nNumberOfAddressesToMailTo  := 1,
          sSubject      := ADR(testShortByteArray),
          SizeOfSubject     := SIZEOF(testShortByteArray),
          sContent      := ADR(testLongByteArray),
          SizeOfContent     := SIZEOF(testLongByteArray),
          OutputData      => OutputDataEMailClientSend);
IF hrEMailClientSend <> S_FALSE THEN 
    bEMailClientSend := 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.