READコマンドは、指定したメッセージ内容を作業リストに配置します。作業リスト定義は、予想される内容に適していなければなりません。例えば、テキスト内容を読み込む場合、作業リストには1つのフィールドが必要です。テキスト以外の内容 (区切り文字の値を含む内容など) を読み込む場合、その内容の最大列数に対応できるように作業リストを定義する必要があります。
ENCODINGキーワードとCONTENTキーワードにより、内容処理要件が制御されます。
構文：
コマンド | キーワード | 値 | 開発者用メモ |
|---|---|---|---|
READ | OBJECT | *TEXT | メッセージの本文が作業リストに読み込まれます。メッセージの内容タイプがtext/またはmultipart/で始まらない場合、コマンドはステータス・フィールドにNOTEXTを返します。 |
*ATTACHMENT | これを使って、作業リストに読み込む特定のファイルを指定します。この値とENTRYキーワードまたはSELECTキーワードを組み合わせて使用して、保存する添付ファイルを特定します。キーワードに ENTRY もしくは SELECT のどちらも指定されていない場合は、最初の添付ファイルが読み込まれます。現在のメッセージに添付ファイルが関連付けられていない場合、コマンド・ステータスはNOATTACHMENTが返されます。 | ||
ENTRY | 整数 | 読み込む添付ファイルのファイル番号を指定します。 各添付ファイルに割り当てられる番号は、送信者がメールに添付ファイルを追加する順序で決まります。 デフォルト値は 1 です。 | |
SELECT | 値 | 添付ファイル名をもとに、読み込む添付ファイルを選択します。 | |
ENCODING | エンコーディング | コンテンツをUnicode文字列変換する際に適用するエンコーディングを指定します。ENCODINGキーワードのデフォルト値は*DEFAULTです。 | |
CONTENT | *TEXT | 添付ファイルのコンテツをテキストとして読み込み、作業リストに入れます。 | |
*SV | 添付ファイルのコンテツを区切り値として読み込み、作業リストに入れます。 | ||
*CSV | 添付ファイルのコンテツをCSVとして読み込み、作業リストに入れます。 | ||
*TSV | 添付ファイルのコンテツをTSVとして読み込み、作業リストに入れます。 | ||
SEPARATOR | 任意。詳細は「SEPARATOR」を参照してください。 | ||
SVROW | 任意。「SVROW」を参照してください。 | ||
SVROWLIMIT | 任意。「SVROWLIMIT」を参照してください。 | ||
SVMODE | 任意。「SVMODE」を参照してください。 | ||
SVHEAD | 任意。「SVHEAD」を参照してください。 | ||
NUMBERFORMAT | | 任意。「NUMBERFORMAT」を参照してください。 |
例
READ OBJECT(*TEXT) #WRKLST(TXT)
READ OBJECT(*ATTACHMENT) ENTRY(2) CONTENT(*TEXT) #WRKLST(TXT)