FP_SMTP_GET_DATA_FORMAT

生成SMTP协议的数据格式字符串

此FP指令将根据输入Var的数据类型生成指定数据格式的字符串（FP地址及长度）。此指令会将字符串写入适用于指令FP_SMTP_SET_MODE中的输入sAttachment的输出变量sDataFormat。

当应通过FP_SMTP_SET_MODE发送数据寄存器时，将生成给定数据值的CSV文件。在传输过程中，数据将根据数据类型被转换为ASCII。因此，sAttachment输入需要指示应将哪个数据转换为哪种ASCII类型的附加信息。

参数

输入

Var (BOOL, INT, UINT, WORD, DINT, UDINT, DWORD, REAL, DATE, TOD, DT, STRING)

简单的数据类型或简单的数据类型的数组，例如BOOL、INT、UINT、STRING等。

限制：不允许ARRAY..OF..STRING

nSize (WORD, INT, UINT)

字中的数据大小，或字节单元中的字符串大小。

输出

sDataFormat (STRING): 用于FP_SMTP_SET_MODE的sAttachment输入的指定数据格式的字符串

标注

执行此指令前，需使用FP_SMTP_SET_MODE或SMTP客户端的设置对话框指定电子邮件传输设置。
执行此指令前，需使用FP_SMTP_SET_GROUP或SMTP客户端的设置对话框指定组和事件邮件设置。
执行此指令前，确保sys_bIsEthernetInitializing为FALSE。sys_bIsEthernetInitializing在执行指令后将变为TRUE。sys_bIsEthernetInitializing为TRUE时，执行指令将发生错误。
仅当指定传输设置的传输请求标志为“FALSE: No transfer request”时，可以执行该指令。当传输请求标志为“TRUE: Transfer requested”时，将出现操作错误。
成功执行此指令后，会重置系统变量sys_bIsCarry和sys_iEthernetConnectionErrorCode。
当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

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

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

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

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

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

示例

POU头

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

	VAR
		arrayValues_UDINT: ARRAY [0..19] OF UDINT;
		bError: BOOL:=FALSE;
		bSetMode: BOOL:=FALSE;
		iID8: INT:=8;
	END_VAR

POU本体

如果bSetMode从FALSE更改为TRUE且sys_bIsEthernetInitializing为FALSE，则执行指令。

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 14 ;
        NETWORK_BODY
B(B_VARIN,,iID8,42,2,44,4,);
B(B_CONTACT,,bSetMode,4,1,6,3,R);
B(B_VAROUT,,bError,57,2,59,4,);
B(B_VARIN,,'GRPNO=0~SUBJECT=Time Notify Mail',42,4,44,6,);
B(B_VARIN,,'Hello~ this is time notify Mail from system. See attachment',42,5,44,7,);
B(B_VARIN,,'INFO=ADD~ATT=DATA;',11,7,13,9,);
B(B_VARIN,,'TRIG=TIME~/day~13:30:00',42,3,44,5,);
B(B_CONTACT,,sys_bIsEthernetInitializing,13,1,15,3,N);
B(B_VARIN,,arrayValues_UDINT,11,9,13,11,);
B(B_F,CONCAT-2!,,37,7,43,10,,?D?D?C);
B(B_F,Size_Of_Var!,,15,10,22,12,,?D?C);
B(B_F,FP_SMTP_GET_DATA_FORMAT!,,22,8,37,12,,?D@'Var'?DnSize?CsDataFormat);
B(B_F,FP_SMTP_SET_MODE!,,44,0,57,8,,?DEN?DnTransferID?DsTrigger?DsGroupNumber_Subject?DsBodyText?DsAttachment?AENO?CbError);
L(1,2,4,2);
L(6,2,13,2);
L(15,2,44,2);
L(37,9,37,10);
L(13,8,37,8);
L(15,10,15,11);
L(13,10,22,10);
L(43,7,43,8);
L(43,7,44,7);
L(1,0,1,14);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

If DF(bSetMode) And not sys_bIsEthernetInitializing then
    FP_SMTP_SET_MODE(nTransferID := iID8,
                     sTrigger := 'TRIG=TIME,/day,13:30:00',
                     sGroupNumber_Subject := 'GRPNO=0,SUBJECT=Time Notify Mail', 
                     sBodyText := 'Hello, this is time notify Mail from system. See attachment',
                     sAttachment := CONCAT('INFO=ADD,ATT=DATA;',
                                           FP_SMTP_GET_DATA_FORMAT(arrayValues_UDINT,
                                           Size_Of_Var(arrayValues_UDINT))),
                     bError => bError);
End_If;