FP_SMTP_SET_MODE_TRANSFER_LOG

为数据记录文件设置SMTP传输模式

此FP指令定义了数据记录文件完成后电子邮件的SMTP客户端传输设置。

参数

输入

nLogID (WORD, INT, UINT)

LOG编号（允许范围：0-15）。编译器将在内部生成LOG文件编号的字符串，例如'LOG=0'

sGroupNumber_Subject (STRING)

设置目标组编号和电子邮件的主题。

使用关键字语法'GRPNO=n1+n2+…+n8'最多设置八个目标组编号。

值：0–7

使用以下两个关键字设置之一设置主题（最多64个字符，一字节）：

'SUBJECT=xxxxxx'：设置用户定义的主题文本。

'SUBJECTAUTO'：自动生成的主题包含有关发送触发器类型的信息。

自动生成的主题：

日语	英语
ロギング／トレース (LOG0)	Logging/Trace (LOG0)
ロギング／トレース (LOG1)	Logging/Trace (LOG1)
...	...
ロギング／トレース (LOG14)	Logging/Trace (LOG14)
ロギング／トレース (LOG15)	Logging/Trace (LOG15)

注意：

自动生成的信息所使用的语言由指令FP_SMTP_SET_CONNECTION指定。使用参数sCommunication将语言从日语（默认）切换为英语。
关键字'GRPNO'和'SUBJECT'必须用逗号分隔并按此顺序输入。

示例：

目标组编号为0，由用户定义主题的“LogFileTransmission”：'GRPNO=0,SUBJECT=LogFileTransmission'
目标组编号为1、3、4、7，由用户定义主题的“LogFilesGroups”：'GRPNO=1+3+4+7,SUBJECT=LogFilesGroups'
目标组编号为0至7，自动生成主题：'GRPNO=0+1+2+3+4+5+6+7,SUBJECTAUTO'

sBodyText (STRING)

信息（最多256个字符，1个字节）

指定存储电子邮件文本或字符常量的变量。

sAttachment (STRING)

指定是否发送附加信息或文件附件。

使用以下关键字设置之一在电子邮件文本中包含附加信息：

'INFO=NONE'：不自动添加信息
'INFO=AUTO'：添加自动生成的文本

以下信息将被添加到电子邮件文本中：

日语	英语
基本項目送信元 CPU 型番（例：CPS41E） IPv4 アドレス IPv6 アドレスロギングトレース(ID 番号) ファイル確定時刻	Basic information From CPU Part number（例如CPS41E） IPv4 address IPv6 address Logging Trace ID File fixed Time

日语

英语

基本項目

送信元
CPU 型番（例：CPS41E）
IPv4 アドレス
IPv6 アドレス
ロギングトレース(ID 番号)
ファイル確定時刻

Basic information

From
CPU Part number（例如CPS41E）
IPv4 address
IPv6 address
Logging Trace ID
File fixed Time

注意：

自动生成的信息所使用的语言由指令FP_SMTP_SET_CONNECTION指定。使用参数sCommunication将语言从日语（默认）切换为英语。
要生成sAttachment字符串，也可以使用FP_SMTP_GET_DATA_FORMAT。

使用以下关键字设置附加数据记录文件（LOG文件）：

'ATT=NONE'：不要将LOG文件附加到电子邮件。
'ATT=FILE'：使用nLogID指定的编号附加LOG文件。

示例：

不要添加任何信息，不附加LOG文件：'INFO=NONE,ATT=NONE'
添加自动生成的信息，附加LOG文件：'INFO=ADD,ATT=FILE'

输出

bError (BOOL)

在以下情况下将变为TRUE：

如果超过连接超时
如果 IP 地址无效

当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

标注

文本自动生成及文件附件的参数不可省略。
通过逗号分隔所有关键字输入。例如：'NAME=abcd,FROM=sender@server.com'
请勿更改关键字的顺序。按照此处所列顺序指定关键字及其设置参数。
字符串数据的字符数不得超过256。
此指令不可用于中断程序。
执行此指令前，需使用FP_SMTP_SET_CONNECTION或SMTP客户端的设置对话框指定电子邮件传输服务器。
执行此指令前，需使用FP_SMTP_SET_GROUP或SMTP客户端的设置对话框指定组和事件邮件设置。
大小写字符均可用于指定关键字。但是，主题、电子邮件文本和附件的文件名区分大小写。
执行此指令前，确保sys_bIsEthernetInitializing为FALSE。sys_bIsEthernetInitializing在执行指令后将变为TRUE。sys_bIsEthernetInitializing为TRUE时，执行指令将发生错误。
成功执行此指令后，会重置系统变量sys_bIsCarry和sys_iEthernetConnectionErrorCode。
仅当指定nLogID编号的传输请求标志为FALSE时，才能执行该指令。当传输请求标志为TRUE时，将发生运算错误。
指令将用于sGroupNumber_Subject、sBodyText及sAttachment的数据记录的电子邮件设置存储在由nLogID指定的LOG文件编号中。
当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

如果指定nLogID编号的传输请求标志为TRUE，例如，如果sys_blsLog0DataRecordingActive为TRUE。
如果指定nLogID编号的数据记录条件为未注册。
如果为参数指定的值超出允许的范围。
如果指令是在中断程序中执行的。
如果字符串数据的字符数超过256。
如果指定了未使用指令FP_SMTP_SET_GROUP或SMTP客户端的设置对话框定义的目标组编号。
如果未指定电子邮件传输服务器。
如果指定了未通过指令FP_SMTP_SET_CONNECTION或SMTP客户端的设置对话框指定的电子邮件传输服务器。

sys_bIsOperationErrorNonHold（对于一次扫描变为TRUE）

如果指定nLogID编号的传输请求标志为TRUE，例如，如果sys_blsLog0DataRecordingActive为TRUE。
如果指定nLogID编号的数据记录条件为未注册。
如果为参数指定的值超出允许的范围。
如果指令是在中断程序中执行的。
如果字符串数据的字符数超过256。
如果指定了未使用指令FP_SMTP_SET_GROUP或SMTP客户端的设置对话框定义的目标组编号。
如果未指定电子邮件传输服务器。
如果指定了未通过指令FP_SMTP_SET_CONNECTION或SMTP客户端的设置对话框指定的电子邮件传输服务器。

sys_bIsCarry（对于一次扫描变为TRUE）

如果指令是在以太网初始化期间执行的，则sys_iEthernetConnectionErrorCode设置为“11：以太网正在初始化”。

示例

POU头

所有用于编程此函数的输入和输出变量已在POU头中声明。所有编程语言使用相同的POU头。

	VAR
		bIsError: BOOL:=FALSE;
		bSetLogTransferSMTP: BOOL:=FALSE;
		bDisableLogTransferSMTP: BOOL:=FALSE;
	END_VAR

POU本体

如果bSetLogTransferSMTP和bDisableLogTransferSMTP设置为TRUE，将执行指令。

LD本体

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

ST本体

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;