SMTP-Datenübertragungsmodus für Datenaufzeichnungsdateien einstellen
Dieser FP-Befehl definiert die SMTP-Client-Datenübertragungseinstellungen für E-Mails, wenn die Datenaufzeichnungsdatei abgeschlossen ist.
Eingang
LOG-Nummer (zulässiger Bereich: 0–15). Der Compiler erzeugt intern die Zeichenfolge für die Nummer der Protokolldatei, z.B. 'LOG=0'
Einstellen der Zielgruppennummer und des Betreffs der E-Mail.
Einstellen von bis zu acht Zielgruppennummern mit der Schlüsselwortsyntax 'GRPNO=n1+n2+…+n8'
.
Werte: 0–7
Einstellen des Betreffs mit einer der zwei folgenden Schlüsselworteinstellungen (max. 64 Zeichen, ein Byte):
'SUBJECT=xxxxxx'
: Einstellen eines benutzerdefinierten Betrefftextes.
'SUBJECTAUTO'
: Automatisch erzeugter Betreff mit Informationen über den Sendetriggertyp.
Automatisch erzeugte Betreffe:
Japanisch |
Englisch |
---|---|
ロギング/トレース (LOG0) |
Logging/Trace (LOG0) |
ロギング/トレース (LOG1) |
Logging/Trace (LOG1) |
... |
... |
ロギング/トレース (LOG14) |
Logging/Trace (LOG14) |
ロギング/トレース (LOG15) |
Logging/Trace (LOG15) |
Hinweis:
Die Sprache, die für automatisch erzeugte Informationen verwendet wird, wird mit dem Befehl FP_SMTP_SET_CONNECTION angegeben. Verwenden Sie den Parameter sCommunication, um die Sprache von Japanisch (Standardeinstellung) auf Englisch umzuschalten.
Die Schlüsselwörter 'GRPNO'
und 'SUBJECT'
müssen durch Kommas getrennt und in dieser Reihenfolge eingegeben werden.
Beispiele:
Zielgruppennummer 0, benutzerdefinierter Betreff "LogFileTransmission": 'GRPNO=0,SUBJECT=LogFileTransmission'
Zielgruppennummern 1, 3, 4, 7, benutzerdefinierter Betreff "LogFilesGroups": 'GRPNO=1+3+4+7,SUBJECT=LogFilesGroups'
Zielgruppennummern 0 bis 7, automatisch erzeugter Betreff: 'GRPNO=0+1+2+3+4+5+6+7,SUBJECTAUTO'
Nachricht (max. 256 Zeichen, ein Byte)
Geben Sie die Variable an, die E-Mail-Text oder eine Zeichenkonstante speichert.
Geben Sie an, ob zusätzliche Informationen oder ein Dateianhang gesendet werden sollen oder nicht.
Schließen Sie zusätzliche Informationen in den E-Mail-Text mit einer der folgenden Schlüsselworteinstellungen ein:
'INFO=NONE'
: Keine Informationen automatisch hinzufügen
'INFO=AUTO'
: Automatisch erzeugten Text hinzufügen
Die folgenden Informationen werden dem E-Mail-Text hinzugefügt:
Japanisch |
Englisch |
---|---|
基本項目
|
Basic information
|
Hinweis:
Die Sprache, die für automatisch erzeugte Informationen verwendet wird, wird mit dem Befehl FP_SMTP_SET_CONNECTION angegeben. Verwenden Sie den Parameter sCommunication, um die Sprache von Japanisch (Standardeinstellung) auf Englisch umzuschalten.
Um die Zeichenfolge sAttachment zu erzeugen, können Sie auch FP_SMTP_GET_DATA_FORMAT verwenden.
Hängen Sie die Datenaufzeichnungsdatei (LOG-Datei) mit der folgenden Schlüsselworteinstellung an:
'ATT=NONE'
: LOG-Datei nicht an die E-Mail anhängen.
'ATT=FILE'
: LOG-Datei mit der durch nLogID angegebenen Nummer anhängen.
Beispiele:
Keine Informationen hinzufügen und LOG-Datei nicht anhängen: 'INFO=NONE,ATT=NONE'
Automatisch erzeugte Informationen hinzufügen und LOG-Datei anhängen: 'INFO=ADD,ATT=FILE'
Ausgang
Wird unter den folgenden Bedingungen auf TRUE gesetzt:
wenn eine Zeitüberschreitung der Verbindung überschritten wird,
wenn eine IP-Adresse ungültig ist
Wenn ein Fehler auftritt, prüfen Sie die Systemvariable sys_iEthernetConnectionErrorCode auf die Fehlercodenummer.
Die Parameter für die automatische Texterstellung und den Dateianhang können nicht weggelassen werden.
Trennen Sie alle Schlüsselwörter durch Komma, z.B. 'NAME=abcd,FROM=sender@server.com'
Reihenfolge der Schlüsselwörter nicht verändern. Geben Sie die Schlüsselwörter und ihre Einstellparameter in der Reihenfolge an, in der sie hier aufgeführt sind.
Die Zeichenanzahl für Zeichenfolgen darf 256 nicht überschreiten.
Dieser Befehl ist in Interrupt-Programmen nicht verfügbar.
Bevor Sie den Befehl ausführen, müssen Sie die E-Mail-Übertragungsserver mit FP_SMTP_SET_CONNECTION oder dem Einstellungsdialog des SMTP-Clients angeben.
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.
Für die Angabe von Schlüsselwörtern können Groß- und Kleinzeichen verwendet werden. Beim Betreff, dem E-Mail-Text und dem Dateinamen des Anhangs wird jedoch zwischen Groß- und Kleinschreibung unterschieden.
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.
Der Befehl kann nur ausgeführt werden, wenn der Merker Datenübertragungsauftrag für die angegebene nLogID Nummer FALSE ist. Wenn der Merker Datenübertragungsauftrag TRUE ist, tritt ein Operationsfehler auf.
Der Befehl speichert die E-Mail-Einstellungen für die Datenaufzeichnung von sGroupNumber_Subject, sBodyText und sAttachment in der durch nLogID angegebenen LOG-Dateinummer.
Wenn ein Fehler auftritt, prüfen Sie die Systemvariable sys_iEthernetConnectionErrorCode auf die Fehlercodenummer.
wenn der Merker Datenübertragungsauftrag für eine angegebene nLogID Nummer TRUE ist, z.B. wenn sys_blsLog0DataRecordingActive TRUE ist.
wenn die Datenaufzeichnungsbedingung einer bestimmten nLogID Nummer nicht registriert ist.
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 die Zeichenanzahl für Zeichenfolgendaten 256 überschreitet.
wenn eine Zielgruppennummer angegeben ist, die nicht mit dem Befehl FP_SMTP_SET_GROUP oder dem Einstellungsdialog des SMTP-Clients definiert wurde.
wenn kein E-Mail-Übertragungsserver angegeben ist.
wenn ein E-Mail-Datenübertragungsserver angegeben ist, der nicht mit dem Befehl FP_SMTP_SET_CONNECTION oder dem Einstellungsdialog des SMTP-Clients konfiguriert wurde.
wenn der Merker Datenübertragungsauftrag für eine angegebene nLogID Nummer TRUE ist, z.B. wenn sys_blsLog0DataRecordingActive TRUE ist.
wenn die Datenaufzeichnungsbedingung einer bestimmten nLogID Nummer nicht registriert ist.
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 die Zeichenanzahl für Zeichenfolgendaten 256 überschreitet.
wenn eine Zielgruppennummer angegeben ist, die nicht mit dem Befehl FP_SMTP_SET_GROUP oder dem Einstellungsdialog des SMTP-Clients definiert wurde.
wenn kein E-Mail-Übertragungsserver angegeben ist.
wenn ein E-Mail-Datenübertragungsserver angegeben ist, der nicht mit dem Befehl FP_SMTP_SET_CONNECTION oder dem Einstellungsdialog des SMTP-Clients konfiguriert wurde.
wenn der Befehl während der Initialisierung des Ethernets ausgeführt wird, wird sys_iEthernetConnectionErrorCode auf "11: Ethernet wird initialisiert“ gesetzt.
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
bIsError: BOOL:=FALSE;
bSetLogTransferSMTP: BOOL:=FALSE;
bDisableLogTransferSMTP: BOOL:=FALSE;
END_VAR
Wenn bSetLogTransferSMTP und bDisableLogTransferSMTP auf TRUE gesetzt sind, wird der Befehl ausgeführt.
BODY
WORKSPACE
NETWORK_LIST_TYPE := NWTYPELD ;
ACTIVE_NETWORK := 0 ;
END_WORKSPACE
NET_WORK
NETWORK_TYPE := NWTYPELD ;
NETWORK_LABEL := ;
NETWORK_TITLE := ;
NETWORK_HEIGHT := 7 ;
NETWORK_BODY
B(B_VARIN,,0,19,2,21,4,);
B(B_VARIN,,'GRPNO=0~SUBJECTAUTO',19,3,21,5,);
B(B_VARIN,,'Sent Log Files',19,4,21,6,);
B(B_VARIN,,'INFO=NON~ATT=NONE',19,5,21,7,);
B(B_VAROUT,,bIsError,39,2,41,4,);
B(B_CONTACT,,bSetLogTransferSMTP,5,1,7,3,);
B(B_F,FP_SMTP_SET_MODE_TRANSFER_LOG!,,21,0,39,7,,?DEN?DnLogID?DsGroupNumber_Subject?DsBodyText?DsAttachment?AENO?AbError);
L(1,2,5,2);
L(7,2,21,2);
L(1,0,1,7);
END_NETWORK_BODY
END_NET_WORK
NET_WORK
NETWORK_TYPE := NWTYPELD ;
NETWORK_LABEL := ;
NETWORK_TITLE := ;
NETWORK_HEIGHT := 5 ;
NETWORK_BODY
B(B_CONTACT,,bDisableLogTransferSMTP,5,1,7,3,);
B(B_F,FP_SMTP_TRANSFER_CONTROL_LOG!,,21,0,39,5,,?DEN?DnLogID?DsControl?AENO?AbError);
B(B_VARIN,,0,19,2,21,4,);
B(B_VARIN,,'DISABLE',19,3,21,5,);
B(B_VAROUT,,bIsError,39,2,41,4,);
L(1,2,5,2);
L(7,2,21,2);
L(1,0,1,5);
END_NETWORK_BODY
END_NET_WORK
END_BODY
If (bSetLogTransferSMTP) Then
FP_SMTP_SET_MODE_TRANSFER_LOG(nLogID := 0,
sGroupNumber_Subject := 'GRPNO=0,SUBJECTAUTO',
sBodyText := 'Sent Log Files',
sAttachment := 'INFO=NON,ATT=NONE', bError => bIsError);
End_if;
If (bDisableLogTransferSMTP) Then
FP_SMTP_TRANSFER_CONTROL_LOG(nLogID := 0,
sControl := 'DISABLE', bError => bIsError);
End_if;