SAVEコマンドは、現在のメッセージのさまざまなコンポーネントをローカル・ファイルに保存する場合に使用されます。

構文:

コマンド

キーワード

開発者用メモ

SAVE







OBJECT



*TEXT

メッセージの本文が保存されることを示します。
メッセージのコンテンツ・タイプがtext/またはmultipart/で始まらない場合、コマンドはステータス・フィールドに値NOTEXTを返します。

*ATTACHMENT

この値を使って、保存する特定の添付ファイルを指定することができます。
この値は、キーワード ENTRY またはキーワード SELECT と組み合わせることで、保存する添付ファイルを特定します。キーワードに ENTRY もしくは SELECT のどちらも指定されていない場合は、最初の添付ファイルが保存されます。
現在のメッセージに添付ファイルが関連付けられていない場合、コマンド・ステータスはNOATTACHMENTが返されます。

*ATTACHMENTS

この値を使用して、すべての添付ファイルをキーワードDIRで指定されたディレクトリに保存します。
現在のメッセージに関連する添付ファイルが存在しない場合、コマンド・ステータスにはNOATTACHMENTが返されます。

ENTRY

整数

読み込む添付ファイルのファイル番号を指定します。
 各添付ファイルに割り当てられる番号は、送信者がメールに添付ファイルを追加する順序で決まります。
デフォルト値は1です。

SELECT

添付ファイル名をもとに、読み込む添付ファイルを選択します。

FILE

このキーワードは、情報の保存先のローカル・ファイル名を指定します。
FILE値に含まれるパスの詳細はすでに存在していなければなりません。ファイル自体を必要に応じて作成したり、置き換えたりします。
OBJECT(*TEXT) を利用する場合、ファイル名を提供する必要があります。
OBJECT(*ATTACHMENT) を使用する場合、現在の添付ファイルは指定のファイル名に変更されます。
OBJECT(*ATTACHMENTS) を使用する場合、FILE キーワードは無視されます。

DIR

ファイルが保存されるローカル・ディレクトリです。デフォルトではJSMインスタンス・ディレクトリが使用されます。
DIRパスがない場合は作成されます。

SAVE OBJECT(*TEXT) FILE(/folder/file.txt)

SAVE OBJECT(*ATTACHMENT) ENTRY(2) FILE(/folder/file.xml)

SAVE OBJECT(*ATTACHMENT) SELECT(order.csv) FILE(/folder/file.csv)

SAVE OBJECT(*ATTACHMENTS) DIR(/folder)