FP_SMTP_GET_EMAIL_TEXT

E-mail-Text abrufen

Dieser FP-Befehl liest die vordefinierten E-Mail-Texte der durch nTransferID angegebenen Nummer und schreibt den Text in die Ausgangsvariable sBodyText.

Parameter

Eingang

nTransferID (WORD, INT, UINT)

Einstellen der Datenübertragungs-Einstellungs-ID.

Werte: 0–15

Ausgang

sBodyText (STRING)

Speichert den vordefinierten E-Mail-Text

bError (BOOL)

Einstellen auf TRUE, wenn die Operation mit Fehler endet.

Wenn ein Fehler auftritt, prüfen Sie die Systemvariable sys_iEthernetConnectionErrorCode auf die Fehlercodenummer.

Anmerkungen

Dieser Befehl ist in Interrupt-Programmen nicht verfügbar.
Bevor Sie den Befehl ausführen, müssen Sie die E-Mail-Übertragungseinstellungen mit FP_SMTP_SET_MODE oder dem Einstellungsdialog des SMTP-Clients angeben.
Dieser Befehl liest den E-Mail-Text, der im Einstellungsdialog des SMTP-Clients angegeben wurde. Wenn kein E-Mail-Text angegeben wurde, kann er nicht gelesen werden, und in sBodyText wird Null gespeichert.
Bevor Sie den Befehl ausführen, müssen Sie die E-Mail-Einstellungen mit FP_SMTP_SET_GROUP oder dem Einstellungsdialog des SMTP-Clients angeben.
Bevor Sie den Befehl ausführen, prüfen Sie FP_CLIENT_STATUS_DUT ob ein aktiver Auftrag zum Senden einer E-Mail vorhanden ist. Wenn bIsTransferRequested TRUE ist, wenn Sie den Befehl ausführen, tritt ein Operationsfehler auf.
Bevor Sie den Befehl ausführen, stellen Sie sicher, dass sys_bIsEthernetInitializing FALSE ist. sys_bIsEthernetInitializing wird auf TRUE gesetzt, wenn der Befehl ausgeführt wird. Wenn Sie den Befehl ausführen, während sys_bIsEthernetInitializing TRUE ist, tritt ein Fehler auf.
Wenn dieser Befehl erfolgreich ausgeführt wurde, werden die Systemvariablen sys_bIsCarry und sys_iEthernetConnectionErrorCode zurückgesetzt.
Wenn ein Fehler auftritt, prüfen Sie die Systemvariable sys_iEthernetConnectionErrorCode auf die Fehlercodenummer.

Fehleralarmmerker

sys_bIsOperationErrorHold (wird auf TRUE gesetzt und bleibt TRUE)

wenn der mit dem Index-Modifizierer definierte Bereich größer ist als der zulässige Bereich
wenn ein für einen Parameter angegebener Wert außerhalb des zulässigen Bereichs liegt.
wenn der Befehl in einem Interrupt-Programm ausgeführt wird.
wenn das E-Mail-Datenübertragungsauftragsflag für die angegebene Datenübertragungseinstellung "TRUE ist: Datenübertragung beauftragt".
wenn eine E-Mail-Datenübertragungseinstellung angegeben ist, die nicht mit dem Befehl FP_SMTP_SET_MODE oder dem Einstellungsdialog des SMTP-Clients konfiguriert wurde.
wenn eine Zielgruppennummer angegeben ist, die nicht mit dem Befehl FP_SMTP_SET_GROUP oder dem Einstellungsdialog des SMTP-Clients definiert wurde.

sys_bIsOperationErrorNonHold (wird für einen Zyklus auf TRUE gesetzt)

wenn der mit dem Index-Modifizierer definierte Bereich größer ist als der zulässige Bereich
wenn ein für einen Parameter angegebener Wert außerhalb des zulässigen Bereichs liegt.
wenn der Befehl in einem Interrupt-Programm ausgeführt wird.
wenn das E-Mail-Datenübertragungsauftragsflag für die angegebene Datenübertragungseinstellung "TRUE ist: Datenübertragung beauftragt".
wenn eine E-Mail-Datenübertragungseinstellung angegeben ist, die nicht mit dem Befehl FP_SMTP_SET_MODE oder dem Einstellungsdialog des SMTP-Clients konfiguriert wurde.
wenn eine Zielgruppennummer angegeben ist, die nicht mit dem Befehl FP_SMTP_SET_GROUP oder dem Einstellungsdialog des SMTP-Clients definiert wurde.

sys_bIsCarry (wird für einen Zyklus auf TRUE gesetzt)

wenn der Befehl während der Initialisierung des Ethernets ausgeführt wird, wird sys_iEthernetConnectionErrorCode auf "11: Ethernet wird initialisiert“ gesetzt.

Verwandte Themen

SMTP-Client

sys_iEthernetConnectionErrorCode

Beispiel

POE-Kopf

Im POE-Kopf werden alle Ein- und Ausgangsvariablen deklariert, die für die Programmierung dieser Funktion verwendet werden. Für alle Programmiersprachen wird der gleiche POE-Kopf verwendet.

	VAR
		bRequest: BOOL:=FALSE;
		bError: BOOL:=FALSE;
		iID8: INT:=8;
		sEmailText: STRING[32]:='Hello World!';
	END_VAR

POE-Rumpf

Wenn bRequest von FALSE auf TRUE gesetzt wird und sys_bIsEthernetSMTPClientReady auf TRUE gesetzt ist, wird der Befehl ausgeführt.

KOP-Rumpf

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_CONTACT,,bRequest,4,1,6,3,R);
B(B_VARIN,,iID8,23,2,25,4,);
B(B_VAROUT,,bError,39,3,41,5,);
B(B_CONTACT,,sys_bIsEthernetSMTPClientReady,15,1,17,3,);
B(B_F,FP_SMTP_GET_EMAIL_TEXT!,,25,0,39,5,,?DEN?DnTransferID?AENO?CsBodyText?CbError);
B(B_VAROUT,,sEmailText,39,2,41,4,);
L(1,2,4,2);
L(6,2,15,2);
L(17,2,25,2);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST-Rumpf

If DF(bRequest) AND sys_bIsEthernetSMTPClientReady then
    FP_SMTP_GET_EMAIL_TEXT(nTransferID := iID8,
                           sBodyText => sEmailText,
                           bError => bError);
END_If;