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：転送要求なし」の場合のみ実行することができます。転送要求フラグが「TRUE：転送要求済み」の場合は、演算エラーが発生します。
この命令が正常に実行されると、システム変数sys_bIsCarryおよびsys_iEthernetConnectionErrorCodeがリセットされます。
エラーが発生した場合は、エラーコード番号のシステム変数sys_iEthernetConnectionErrorCodeを確認してください。

エラーフラグ

sys_bIsOperationErrorHold (TRUEになり、TRUEを保持)

接続のタイムアウトが経過した場合
IPアドレスが無効な場合

sys_bIsOperationErrorNonHold (1回のスキャンに対してTRUE)

接続のタイムアウトが経過した場合
IPアドレスが無効な場合

sys_bIsCarry (1回のスキャンに対してTRUE)

Ethernet初期化中に命令を実行した場合は、sys_iEthernetConnectionErrorCodeが「11：Ethernet初期化中」に設定されます。

例

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;