メールエンドポイントの設定

メールエンドポイントの設定

メールエンドポイントを設定するには、次の設定を使用します。

名前： ​エンドポイントを識別する必須の設定。< は含めないでください。含めると、Workspace に表示される名前の一部が省略されます。エンドポイント名として URL を入力する場合は、RFC1738 で指定された構文規則に準拠していることを確認します。

説明： ​エンドポイントの説明。< は含めないでください。含めると、Workspace に表示される説明の一部が省略されます。

Cron 式： Cron 式を使用してメールをスケジュールする必要がある場合に Cron 式を入力。

繰り返し回数： ​メールエンドポイントでフォルダーまたはディレクトリをスキャンする回数。-1 を指定すると、無限にスキャンされます。デフォルト値は -1 です。

繰り返し間隔： ​受信側が受信メールの有無をチェックするために使用するスキャン頻度。

ジョブ開始時の遅延： ​スケジューラーを開始してからスキャンを実行するまでの待機時間。

バッチサイズ： ​最適なパフォーマンスを得るために、受信者が 1 回のスキャンで処理するメールの数。-1 を指定すると、すべてのメールが処理されます。デフォルト値は 2 です。

ユーザー名： ​必須の設定で、メールからターゲットサービスを呼び出す際に使用するユーザー名。デフォルト値は「SuperAdmin」です。

ドメイン名： ​必須の設定で、ユーザーのドメイン。デフォルト値は「DefaultDom」です。

ドメインパターン： ​プロバイダーが受け入れる受信メールのドメインパターンを指定します。例えば、adobe.com を使用すると、adobe.com から受信したメールのみが処理され、それ以外のドメインからのメールは無視されます。

ファイルパターン： ​プロバイダーが受け入れる受信メールの添付ファイルのパターンを指定します。これには、特定の拡張子を持つファイル（&ast;.dat や &ast;.xml）、特定の名前のファイル（data）、名前と拡張子が混在する式に一致するファイル（&ast;.[dD][aA]'port'）が該当します。

ジョブの成功の受信者： ​ジョブの正常終了を示すメッセージの送信先になるメールアドレスです。デフォルトでは、ジョブの正常終了を示すメッセージは常に送信者に送信されます。sender と入力すると、メールの結果は送信者に送信されます。最大 100 人の受信者を指定できます。追加の受信者をメールアドレスで指定するときは、カンマ（,）で区切ります。

この設定を無効にするには、設定を空白のままにします。結果のメール通知を送信しないで、プロセスを起動することが必要な場合もあります。

失敗したジョブの受信者：ジョブの失敗を示すメッセージの送信先になるメールアドレスです。デフォルトでは、ジョブ失敗メッセージは常に送信者に送信されます。sender と入力すると、メールの結果は送信者に送信されます。最大 100 人の受信者を指定できます。追加の受信者をメールアドレスで指定するときは、カンマ（,）で区切ります。

この設定を無効にするには、設定を空白のままにします。結果のメール通知を送信しないで、プロセスを起動することが必要な場合もあります。

インボックスホスト：：メールプロバイダーがスキャンの対象とするインボックスのホスト名または IP アドレスです。

インボックスポート： ​メールサーバーが使用するポートです。POP3 のデフォルト値は 110 で、IMAP のデフォルト値は 143 です。SSL が有効になっている場合は、POP3 のデフォルト値は 995 で、IMAP のデフォルト値は 993 です。

インボックスプロトコル： ​メールエンドポイントがインボックスをスキャンするときに使用するメールプロトコルです。値は IMAP または POP3 です。指定のプロトコルはインボックスホストメールサーバーでサポートされている必要があります。

インボックスタイムアウト： ​メールプロバイダーがインボックスの応答を待機する時間（秒単位）です。

インボックスユーザー： ​メールアカウントにログインするためのユーザー名です。メールサーバーと設定によって、メールのユーザー名の部分だけを指定する場合と、完全なメールアドレスを指定する場合があります。

インボックスのパスワード： ​インボックスユーザーのパスワードです。

POP3/IMAP SSL を有効にする： ​この設定を選択すると、メールプロバイダーはインボックスのスキャンに SSL を使用します。メールサーバーで SSL がサポートされている必要があります。

SMTP ホスト： ​メールプロバイダーが結果やエラーメッセージを送信するメールサーバーのホスト名です。

SMTP ポート： SMTP ポートのデフォルト値は 25 です。

SMTP ユーザー： ​メールプロバイダーが結果およびエラーのメール通知を送信するときに使用するユーザーアカウントです。

SMTP パスワード： SMTP アカウントのパスワードです。 SMTP パスワードが不要なメールサーバーもあります。

送信者： ​結果およびエラーのメール通知を送信するときに使用するメールアドレス（user@company.com など）。「送信者」の値を指定しない場合、メールサーバーでは、「SMTP ユーザー」設定で指定されている値と、メールサーバーで設定されているデフォルトのドメインを組み合わせて、メールアドレスを決定します。使用しているメールサーバーにデフォルトのドメインがなく、「送信者」の値を指定しない場合は、エラーが発生することがあります。メールメッセージに正しい送信元アドレスが表示されるように、「Send From」設定の値を指定してください。

SMTP SSL を有効にする： ​この設定を選択すると、メールプロバイダーはインボックスのスキャンに SSL を使用します。メールサーバーで SSL がサポートされている必要があります。

送信が失敗したメールのフォルダー： SMTP メールサーバーが動作していない場合に結果を保存するディレクトリを指定します。

非同期：「同期」に設定すると、すべての入力ドキュメントが処理された後に 1 回の応答が返されます。「asynchronous」（非同期）に設定すると、1 つのドキュメントの処理が完了するたびに応答が返されます。

例えば、1 つの Word ドキュメントを受け取って PDF ファイルとして返すサービスにメールエンドポイントを作成します。複数（3 つ）の Word ドキュメントが含まれるメールをエンドポイントのインボックスに送信できます。エンドポイントが「同期」に設定されている場合は、3 つドキュメントのすべてが処理されると、1 つの応答メールに 3 つのドキュメントのすべてが添付されて送信されます。エンドポイントが非同期の場合、1 つの Word ドキュメントが PDF に変換されるごとに、応答メールが送信されます。その結果、それぞれ 1 つの PDF ファイルが添付された 3 件のメールが送信されます。

デフォルト値は asynchronous（非同期）です。

元のメール本文を添付ファイルとして含める： デフォルトでは、Forms サーバーにメールを送信すると、元のメッセージのテキストはメッセージの本文に含まれます。代わりにテキストを添付ファイルとして含めるには、このオプションを選択します。

結果のメールに元の件名を使用する： デフォルトでは、Forms サーバーは結果のメールメッセージを送信する際に、件名行として、「成功のメールの件名」と「エラーのメールの件名」の設定に指定された値を使用します。代わりにサーバーに送信された元のメールと同じ件名行を使用するには、このオプションを選択します。

成功のメールの件名： ​メールをメールエンドポイントに送信してプロセスを開始または続行すると、AEM Forms サーバーから返信のメールメッセージを受け取ります。送信したメールに問題がなかった場合は、成功のメールを受け取ります。送信したメールに問題があった場合は、問題の内容を知らせる失敗のメールを受け取ります。この設定により、このエンドポイントに対して送信される成功のメールメッセージの件名行を指定できます。

成功のメールの本文： ​この設定により、このエンドポイントに対して送信される成功のメールメッセージの本文を指定できます。

エラーのメールの件名プレフィックス： ​この設定により、このエンドポイントに対して送信される失敗のメールメッセージの件名の先頭に使用されるテキストを指定できます。

エラーのメールの件名： ​この設定により、このエンドポイントに対して送信される失敗のメールメッセージの件名を指定できます。このテキストは、エラーのメールの件名プレフィックスの後に表示されます。

エラーのメールの本文： この設定により、このエンドポイントに対して送信される失敗のメールメッセージの本文の最初の行を指定できます。

メールの概要情報： ​各成功または失敗のメッセージには、Forms サーバーに送信された元のメールのテキストを含むセクションがあります。この設定では、そのセクションの上に表示するテキストを指定します。

このエンドポイントの作成／更新の前にインボックスを検証する： ​このオプションを選択した場合、エンドポイントを作成する前に、SMTP／POP3 の設定が正しいかどうかを Forms サーバーが確認します。「追加」をクリックすると、インボックスアカウントが有効かどうかを示すメッセージが表示されます。このオプションを選択しなかった場合、AEM Forms サーバーはインボックスを確認せずにエンドポイントを作成します。

操作名： ​この設定は必須です。メールエンドポイントに割り当てることができる操作のリストです。ここで選択した操作によって、「入力パラメーターのマッピング」および「出力パラメーターのマッピング」のセクションに表示されるフィールドが決定されます。

入力パラメーターのマッピング： サービスおよび操作を処理するために必要な入力を設定するために使用します。入力には、リテラルと変数の 2 種類があります。

リテラル： メールでは、フィールドに入力された値を表示どおりに使用します。

変数： メールの件名、本文、ヘッダーまたは送信者のメールアドレスから文字列をマップできます。これを行うには、キーワード %SUBJECT%、%BODY%、%HEADER%、%SENDER% のいずれかを使用します。例えば、%SUBJECT% を使用すると、メールの件名の内容が入力パラメーターとして使用されます。添付ファイルを取得するには、メールエンドポイントが使用できるファイルパターンを入力します。このパターンによって、添付ドキュメントが選択されます。例えば、&ast;.pdf と入力すると、ファイル名に拡張子 .pdf を持つ添付ドキュメントがすべて選択されます。&ast; と入力すると、添付ドキュメントがすべて選択されます。example.pdf と入力すると、example.pdf という名前の添付ドキュメントがすべて選択されます。

出力パラメーターのマッピング： サービスおよび操作の出力を設定するために使用します。出力パラメーターに次の文字を使用すると、マップされた値が添付ファイル名に展開されます。

%F ソースファイルのファイル名（拡張子は除く）を表します。

%E ​ソースファイルの拡張子を表します。

バックスラッシュ（\）は %% に置き換えられます。

注意​：サービス要求メッセージに複数の添付ファイルが含まれている場合、エンドポイントの出力パラメーターのマッピングプロパティの値に、%F パラメーターおよび %E パラメーターを使用することはできません。サービス応答が複数の添付ファイルを返す場合、2 つ以上の添付ファイルに同じファイル名を指定することはできません。これらの推奨事項に従わない場合は、返されるファイルには、呼び出されたサービスにより名前が付けられるので、予期できない名前になります。

使用可能な値を次に示します。

単一のオブジェクト： メールプロバイダーはソースフォルダーの宛先を持たないので、結果は添付ファイルとして返されます。パターンは「Result/%F.ps」です。結果は、「Result%%sourcefilename.ps」という名前の添付ファイルとして返されます。

リスト： ​パターンは「Result/%F/」です。結果は、「Result%%sourcefilename%%file1」という名前の添付ファイルとして返されます。

マップ： パターンは、「Result/%F/」です。ソースの宛先は、「Result%%sourcefilename%%file1」および「Result%%sourcefilename%%file2」です。複数のオブジェクトがマップにあり、パターンが「Result/%F.ps」である場合、応答添付ファイルは「Result%%sourcefilename1.ps」（出力 1）および「Result%%sourcefilename2.ps」（出力 2）になります。