Lotus Domino Designer 7 ヘルプ

式言語

@MailSend
例

@MailSend には、次の 2 通りの使い方があります。

パラメータを指定しない場合は、現在の文書 (この @関数の評価時に処理されている文書) が、文書内の [SendTo] フィールドで指定されている受信者にメール送信されます。そのためには [SendTo] フィールドが必要です。
パラメータを指定する場合は、引数リストで指定した情報に基づいてメールメモが新規作成され、SendTo、copyTo、blindcopyTo の各引数で指定した受信者に送信されます。

構文
@MailSend
@MailSend( sendTo ; copyTo ; blindCopyTo ; subject ; remark ; bodyFields ; [ flags ] )

パラメータ
sendTo

文字列または文字列リスト。メールメモの主受信者です。

copyTo

文字列または文字列リスト。省略可能。メールメモのコピー受信者です。

blindCopyTo

文字列または文字列リスト。省略可能。メールメモの宛先匿名コピー受信者です。

subject

文字列。省略可能。[Subject] フィールドに表示する文字列です。メールメモの [Subject] フィールドと同じです。メッセージは、受信者のメールデータベースのビューにある [件名] 列内に表示されます。

remark

文字列。省略可能。メモの本文フィールドの先頭に置く文字列です。

bodyFields

文字列。現在の文書からメールメモに追加するフィールドの名前です。フィールドのデータ型は文字列か文字列リストでなければなりません。フィールドは指定した順序でメモに追加されます。数値フィールドを @Text で変換した結果を変数に格納して、その変数名をフィールド名として使うこともできます。各フィールド名は引用符で囲みます。複数のフィールドを指定する場合は、リスト形式を使います (description":"issues":"resolution)。フィールド名を変数に保存するときは、引用符は外します。

[IncludeDocLink] フラグ (後述) を使って現在の文書に文書リンクを追加する場合は、このパラメータにヌル値 ("") を指定します。指定した名前のフィールドが見つからないときは、代わりに文字列リテラルが使われます。

[ flags ]

キーワード。メモの優先順位とセキュリティに関するフラグを指定します。複数のフラグを指定する場合は、

[SIGN]:[PRIORITYHIGH]:[RETURNRECEIPT]

のようにリスト形式で指定します。各フラグは角カッコで囲みます。

使えるフラグは次のとおりです。

[SIGN]

メモを送信するとき、ユーザー ID の情報を使って電子的に署名します。このフラグを指定しない限り署名はできません。このフラグは Web アプリケーションでは使用できません。

[ENCRYPT]

受信者のパブリックキーを使って文書を暗号化し、プライベートキーが一致する受信者だけが文書を読めるようにします。このフラグを指定しない限り暗号化はできません。このフラグは Web アプリケーションでは使用できません。

[PRIORITYHIGH]

メール接続記録とサーバー文書の組み合わせで定義されている次のサーバーに、メッセージをすぐに配信します。メッセージを配信するために電話をかける必要があるときは、リモート接続記録に設定されているスケジュールにかかわらずすぐに電話がかけられます。このフラグを省略すると、優先順位はデフォルトの Normal になります。

[PRIORITYNORMAL]

メール接続記録に定義されているスケジュールに基づいて、メッセージを次のサーバーに配信します。受信者のメールファイルが同じ Domino ネットワークのサーバー上にある場合は、すぐに配信されます。このフラグを省略すると、優先順位はデフォルトの Normal になります。

[PRIORITYLOW]

受信者のメールファイルが異なる Notes/Domino ネットワークのサーバー上にある場合は、メッセージを夜間に配信します。受信者のメールファイルが同じ Notes/Domino ネットワークのサーバー上にある場合は、すぐに配信します。低優先順位メールは、MailLowPriorityTime=x という Notes/Domino 環境変数でも制御できます。x は 0 から 23 までの数値です。この変数をサーバーの NOTES.INI ファイルに追加することで、サーバーが低優先順位メールを配信する時間を指定します。このフラグを省略すると、優先順位はデフォルトの Normal になります。

[RETURNRECEIPT]

各受信者がメッセージを読んだときに、そのことを送信者に知らせます。このフラグを指定しないと、受信確認は返送されません。

[DELIVERYREPORTCONFIRMED]

メモが正常に送信されたかどうかを送信者に知らせます。デフォルトでは基本送信レポートフォームが使われ、送信が失敗した場合に限り通知されます。

[INCLUDEDOCLINK]

@MailSend が実行されたときに開いていたか選択されていた文書への文書リンクを文書に追加します。その文書をメールメモにリンクするには、このフラグを指定します。新規文書は保存する必要があります。

使い方
@MailSend は、エージェント、フォームアクション、フォームイベント、ビューアクション、ビューイベント、ツールバーボタンで使います。@MailSend は、定期エージェントであらかじめ決められた間隔でメールを送信する手段として使うと特に便利です。たとえば、部門ごとの会議についての通知を送信するような場合に使います。定期エージェントが正しく動作するには、データベースを開いた直後に、データベースから 1 つのビューがデフォルトとして選択されていなければなりません。この関数は、列式、選択式、非表示切り替え式、ウィンドウタイトル式では使えません。

ユーザーの notes.ini ファイルに次のステートメントが含まれている場合は、

NoExternalApps=1

@MailSend を使う式はすべて無効になります。この場合、式が失敗するだけでエラーメッセージは表示されません。

リッチテキストフィールドを送信する
bodyfields にリッチテキストフィールドを指定できるのは、エージェント式のみです。

文書上のメール関連フィールド
パラメータを指定しないで @MailSend を使う場合、現在の文書に 1 つ以上のメール関連フィールドが含まれていることがあります。その場合、文書の配信時にそのフィールドが使われます。

文書に [CopyTo] フィールドや [BlindCopyTo] フィールドがある場合は、同時にそれらの受信者にも配信されます。
文書に [DeliveryPriority] フィールド、[DeliveryReport] フィールド、[ReturnReceipt] フィールドがある場合は、[アクション] - [文書の送信] コマンドの場合と同じように、これらのフィールドが送信優先順位、送信レポートの作成、受信確認の作成の制御に使用されます。文書にこれらのフィールドがないときは、デフォルトで標準優先順位、送信レポートなし、受信確認なしに設定されます。

クロスリファレンス
LotusScript NotesDocument クラスの Send メソッド

LotusScript NotesUIDocument クラスの Send メソッド

Java Document クラスの send メソッド

例
関連項目

現在の文書に式言語でアクセスする

ECL セキュリティを伴う @関数

MailAddress @コマンド

MailComposeMemo @コマンド

MailSend @コマンド

Lotus Developer Domain の「Taking your Domino applications to the Web」

用語集

用語集