電子メールエンドポイントを使用すると、ユーザーは、1 つ以上のドキュメントを(電子メールの添付ファイルとして)指定した電子メールアカウントに送信することで、サービスを呼び出すことができます。 E メールインボックスは、添付ファイルの収集ポイントとして機能します。 サービスはインボックスを監視し、添付ファイルを処理します。 変換の結果は、エンドポイントで定義されたユーザーに転送されます。
電子メールエンドポイントの場合、許可されたユーザーは、適切なアカウントにファイルを電子メールで送信することで、プロセスを呼び出すことができます。 結果は、送信ユーザー(デフォルト)またはエンドポイント設定で定義されたユーザーに返されます。
電子メールエンドポイントを設定する前に、エンドポイントで使用する POP3 または IMAP 電子メールアカウントを作成します。 コンバージョンのタイプごとに別のアカウントを設定します。 例えば、あるアカウントを、受信する添付ファイルから標準のPDFドキュメントを生成するように設定し、別のアカウントを設定して安全なPDFドキュメントを生成することができます。
各電子メールアドレスは、1 つの電子メールエンドポイントにのみマッピングする必要があります。 追加の電子メールエンドポイントが無効になっている場合でも、1 つの電子メールアドレスに対して複数の電子メールエンドポイントを設定することはできません。
すべての電子メールエンドポイントは、電子メールインボックスに対して認証済みのユーザー名とパスワードを使用して設定されます。このユーザー名とパスワードは、サービスを呼び出す際に必要になります。 電子メールアカウントは、その電子メールアカウントが設定されているメールサーバーシステムによって保護されます。
ユーザーがファイルおよび変換パス名の中で西ヨーロッパ言語の文字を使用してドキュメントを送信する場合は、必要なエンコードの種類(Latin1 [ISO-8859-1]、西ヨーロッパ言語 [Windows] または UTF-8)をサポートするメールアプリケーションを使用する必要があります。詳しくは、 AEM forms のインストールおよびデプロイ ドキュメントを作成します。
電子メールエンドポイントを設定する前に、Email サービスを設定します。 ( 詳しくは、 デフォルトの電子メールエンドポイント設定の指定.) Email サービスの設定パラメーターには、次の 2 つの目的があります。
POP3、IMAP、または SMTP で、電子メールエンドポイントに Secure Sockets Layer(SSL) を使用するように設定できます。
電子メールサーバーで、製造元のドキュメントに従って、POP3、IMAP、または SMTP の SSL を有効にします。
電子メールサーバーからクライアント証明書を書き出します。
keytool プログラムを使用して、クライアント証明書ファイルをアプリケーションサーバーの Java 仮想マシン (JVM) 証明書ストアに読み込みます。 この手順は、JVM とクライアントのインストールパスによって異なります。
例えば、Microsoft Windows Server® 2003 で JDK 1.5.0 を使用してデフォルトのOracleWebLogic Server インストールを使用している場合は、コマンドプロンプトで次のテキストを入力します。
keytool -import -file client_certificate -alias myalias -keystore BEA_HOME\jdk150_04\jre\security\cacerts
パスワードの入力を求められたら、適切なパスワードを入力します(Java の場合、デフォルトのパスワードは changeit
です)。証明書が正常に読み込まれたことを示すメッセージが表示されます。
管理コンソールを使用して、電子メールエンドポイントをサービスに追加します。
管理コンソールで電子メールエンドポイントを作成します。 エンドポイントを設定する際に、「POP3/IMAP SSL Enabled for incoming messages」と「SMTP SSL Enabled for outgoing messages」を選択し、それに応じてポートのプロパティを変更します。
ヒント:SSL を使用する際に問題が発生した場合は、Microsoft Outlook などの電子メールクライアントを使用して、SSL を使用して電子メールサーバーにアクセスできるかどうかを確認します。 電子メールクライアントが電子メールサーバーにアクセスできない場合、問題は証明書または電子メールサーバーの設定に関連しています。
「サービスの管理」ページを使用して、すべての電子メールエンドポイントに共通する属性を設定し、すべての電子メールエンドポイントのデフォルト値を指定できます。
forms ワークフローがユーザーからの受信電子メールメッセージを受信して処理するには、Complete Task サービスの電子メールエンドポイントを作成する必要があります。 この電子メールエンドポイントには、 Complete Task サービス用の電子メールエンドポイントの作成.
Cron 式: Quartz が入力ディレクトリのポーリングをスケジュールするために使用する Cron 式。
繰り返し間隔:ディレクトリのポーリングを繰り返す間隔です。エンドポイントの設定でこの値を指定しない場合は、デフォルトの繰り返し間隔(秒単位)が使用されます。デフォルト値は 10 です。この値を 10 未満にすることはできません。
繰り返し回数:入力ディレクトリのポーリング回数です。この値がエンドポイントの設定で指定されていない場合に使用されるデフォルトの繰り返し回数です。 -1 の値は、ディレクトリの無限スキャンを示します。 デフォルト値は -1 です。
ジョブ開始時の遅延:エンドポイントをスキャンするジョブを開始するまでに待機する時間(秒単位)のデフォルト値。デフォルト値は 0 です。
バッチサイズ:最適なパフォーマンスを得るために、受信者が 1 回のスキャンで処理するメールの数。値が —1 の場合、すべての電子メールが送信されます。 デフォルト値は 2 です。
非同期:呼び出しタイプを非同期または同期として識別します。一過性および同期型のプロセスは、同期型でのみ呼び出すことができます。デフォルト値は「asynchronous」です。
ドメインパターン:受信メールをフィルタリングするために使用されるドメイン名パターン。例えば、adobe.com を使用すると、adobe.com から受信したメールのみが処理され、それ以外のドメインからのメールは無視されます。
ファイルパターン:プロバイダーが受け入れる受信ファイルの添付パターン。これには、特定の拡張子(*.dat, *.xml)、特定の名前(data)、名前と拡張子に複合式(.[dD][aA]'port')を持つファイルが含まれます。デフォルト値は * です。*。
ジョブの成功の通知先:ジョブの正常終了を示すメールの送信に使用する 1 つ以上のメールアドレス。デフォルトでは、成功したジョブメッセージは常に最初のジョブの送信者に送信されます。 最大 100 人の受信者を指定できます。この設定を無効にするには、このフィールドを空白のままにします。
ジョブの失敗の通知先:ジョブの失敗を示すメールの送信に使用する 1 つ以上のメールアドレス。デフォルトでは、失敗したジョブメッセージは常に、最初のジョブを送信した送信者に送信されます。 最大 100 人の受信者を指定できます。この設定を無効にするには、このフィールドを空白のままにします。
インボックスホスト:メールプロバイダーがスキャンの対象とするインボックスのホスト名または IP アドレス。
インボックスポート:メールプロバイダーがスキャンの対象とするインボックスのポート番号。値が 0 の場合は、デフォルトの IMAP または POP3 ポートが使用されます。
インボックスプロトコル:メールエンドポイントがインボックスをスキャンする際に使用するメールプロトコル。選択肢は IMAP または POP3 です。 指定のプロトコルはインボックスホストメールサーバーでサポートされている必要があります。
インボックスタイムアウト:インボックスに接続しようとする際に、エンドポイントが操作をキャンセルするまでに待機する時間を指定します。タイムアウト値に達する前に接続が確立されない場合、インボックスはポーリングされません。
インボックスユーザー:メールアカウントにログインするために必要なユーザー名。メールサーバーと設定によって、メールのユーザー名の部分だけを指定する場合と、完全なメールアドレスを指定する場合があります。
インボックスのパスワード: インボックスユーザーのパスワード。
POP3/IMAP SSL を有効にする:選択すると、SSL が有効になります。
SMTP ホスト:メールプロバイダーが結果やエラーメッセージの送信時に使用するメールサーバーのホスト名。例えば、mail.example.com のように指定します。
SMTP ポート:メールサーバーへの接続に使用されるポート。デフォルト値は 25 です。
SMTP ユーザー:メールプロバイダーが結果やエラーを通知するメールの送信時に使用するユーザーアカウント。
SMTP パスワード: SMTP アカウントのパスワード。 SMTP パスワードが不要なメールサーバーもあります。
送信者:結果およびエラーのメール通知を送信するときに使用するメールアドレス(user@company.com など)。「送信元」の値を指定しない場合、電子メールサーバーは、「 SMTP ユーザー」設定で指定された値と電子メールサーバー上で設定されているデフォルトのドメインを組み合わせて、電子メールアドレスを決定しようとします。 電子メールサーバーにデフォルトのドメインがなく、「送信元」の値を指定しない場合は、エラーが発生する場合があります。 メールメッセージに正しい送信元アドレスが表示されるように、「送信者」設定の値を指定してください。
SMTP SSL を有効にする:選択すると、SSL over SMTP が有効になります。
元の E メール本文を添付ファイルとして含める: デフォルトでは、Formsサーバーに E メールを送信すると、メッセージの本文に元のテキストが含まれます。 代わりに、テキストを添付ファイルとして含めるには、このオプションを選択します。
結果のメールに元の件名を使用:デフォルトでは、Forms サーバーは結果のメールメッセージを送信する際の件名として、「成功のメールの件名」と「エラーのメールの件名」の設定で指定された値を使用します。代わりに、サーバーに送信された元のメールと同じ件名行を使用するには、このオプションを選択します。
成功メールの件名: 処理を開始または続行するために電子メールエンドポイントに電子メールを送信した後、AEM Forms Server から返信の電子メールメッセージを受け取ります。 E メールが正常に送信された場合は、成功の E メールを受け取ります。 E メールが失敗した場合は、失敗の理由を示す失敗の E メールを受け取ります。 この設定を使用すると、このエンドポイントに対して送信される成功の電子メールメッセージの件名行を指定できます。
成功のメールの本文:この設定により、このエンドポイントに対して送信される成功のメールメッセージの本文を指定できます。
エラーのメールの件名プレフィックス:この設定により、このエンドポイントに対して送信される失敗のメールメッセージの件名の先頭に使用されるテキストを指定できます。
エラーのメールの件名:この設定により、このエンドポイントに対して送信される失敗のメールメッセージの件名を指定できます。このテキストは、エラーのメールの件名プレフィックスの後に表示されます。
エラーのメールの本文: この設定により、このエンドポイントに対して送信される失敗のメールメッセージの本文の最初の行を指定できます。
メールの概要情報: 成功または失敗の各メッセージには、Forms Server に送信した元の電子メールテキストを含むセクションが含まれています。 この設定では、そのセクションの上に表示するテキストを指定します。
このエンドポイントを作成/更新する前にインボックスを検証: このオプションを選択した場合、Formsサーバーは、エンドポイントを作成する前に、SMTP/POP3 の設定が正しいかどうかを確認します。 「追加」をクリックすると、インボックスアカウントが有効かどうかを示すメッセージが表示されます。 このオプションを選択しない場合、AEM Forms Server はインボックスを検証せずにエンドポイントを作成します。
文字セットエンコーディング:メールメッセージに使用するエンコード形式。デフォルトは UTF-8 で、日本以外のほとんどのユーザーが使用します。 日本の環境のユーザーは、ISO2022-JPを選択できます。
送信失敗メールフォルダー: SMTP メールサーバーが動作していない場合に結果を保存するディレクトリを指定します。
次の設定を使用して、電子メールエンドポイントを設定します。
名前:エンドポイントを識別する必須の設定。< は含めないでください。含めると、Workspace に表示される名前の一部が省略されます。エンドポイント名として URL を入力する場合は、RFC1738 で指定された構文規則に準拠していることを確認します。
説明:エンドポイントの説明。< は含めないでください。含めると、Workspace に表示される説明の一部が省略されます。
Cron 式: Cron 式を使用してメールをスケジュールする必要がある場合に Cron 式を入力。
繰り返し回数:メールエンドポイントでフォルダーまたはディレクトリをスキャンする回数。値を —1 にすると、無限にスキャンされます。 デフォルト値は -1 です。
繰り返し間隔:受信側が受信メールの有無をチェックするために使用するスキャン頻度。
ジョブ開始時の遅延:スケジューラーを開始してからスキャンを実行するまでの待機時間。
バッチサイズ:最適なパフォーマンスを得るために、受信者が 1 回のスキャンで処理するメールの数。値が —1 の場合、すべての電子メールが送信されます。 デフォルト値は 2 です。
ユーザー名:必須の設定で、メールからターゲットサービスを呼び出す際に使用するユーザー名。デフォルト値は「SuperAdmin」です。
ドメイン名:必須の設定で、ユーザーのドメイン。デフォルト値は「DefaultDom」です。
ドメインパターン:プロバイダーが受け入れる受信メールのドメインパターンを指定します。例えば、adobe.com を使用すると、adobe.com から受信したメールのみが処理され、それ以外のドメインからのメールは無視されます。
ファイルパターン:プロバイダーが受け入れる受信メールの添付ファイルのパターンを指定します。これには、特定の拡張子を持つファイル(*.dat や *.xml)、特定の名前のファイル(data)、名前と拡張子が混在する式に一致するファイル(*.[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 回の応答が返されます。「非同期」を指定すると、処理されるドキュメントごとに応答が送信されます。
例えば、1 つの Word ドキュメントを取得し、そのドキュメントをPDFファイルとして返すサービスに対して電子メールエンドポイントを作成するとします。 複数 (3) の Word ドキュメントを含む電子メールをエンドポイントのインボックスに送信できます。 3 つのドキュメントすべてが処理されると、エンドポイントが同期として設定されている場合、3 つのドキュメントがすべて添付された 1 つの応答 E メールが送信されます。 エンドポイントが非同期の場合、Word ドキュメントがPDFに変換されるたびに、応答 E メールが送信されます。 結果として、それぞれが 1 つの添付ファイルを持つ 3 つの E メールがPDFされます。
デフォルト値は asynchronous(非同期)です。
元の E メール本文を添付ファイルとして含める: デフォルトでは、Formsサーバーに E メールを送信すると、メッセージの本文に元のテキストが含まれます。 代わりにテキストを添付ファイルとして含めるには、このオプションを選択します。
結果のメールに元の件名を使用する: デフォルトでは、Forms サーバーは結果のメールメッセージを送信する際に、件名行として、「成功のメールの件名」と「エラーのメールの件名」の設定に指定された値を使用します。代わりにサーバーに送信された元のメールと同じ件名行を使用するには、このオプションを選択します。
成功メールの件名: 処理を開始または続行するために電子メールエンドポイントに電子メールを送信した後、AEM Forms Server から返信の電子メールメッセージを受け取ります。 E メールが正常に送信された場合は、成功の E メールを受け取ります。 E メールが失敗した場合は、失敗の理由を示す失敗の E メールを受け取ります。 この設定を使用すると、このエンドポイントに対して送信される成功の電子メールメッセージの件名行を指定できます。
成功のメールの本文:この設定により、このエンドポイントに対して送信される成功のメールメッセージの本文を指定できます。
エラーのメールの件名プレフィックス:この設定により、このエンドポイントに対して送信される失敗のメールメッセージの件名の先頭に使用されるテキストを指定できます。
エラーのメールの件名:この設定により、このエンドポイントに対して送信される失敗のメールメッセージの件名を指定できます。このテキストは、エラーのメールの件名プレフィックスの後に表示されます。
エラーのメールの本文: この設定により、このエンドポイントに対して送信される失敗のメールメッセージの本文の最初の行を指定できます。
メールの概要情報: 成功または失敗の各メッセージには、Forms Server に送信した元の電子メールテキストを含むセクションが含まれています。 この設定では、そのセクションの上に表示するテキストを指定します。
このエンドポイントを作成/更新する前にインボックスを検証: このオプションを選択した場合、Formsサーバーは、エンドポイントを作成する前に、SMTP/POP3 の設定が正しいかどうかを確認します。 「追加」をクリックすると、インボックスアカウントが有効かどうかを示すメッセージが表示されます。 このオプションを選択しない場合、AEM Forms Server はインボックスを検証せずにエンドポイントを作成します。
操作名:この設定は必須です。E メールエンドポイントに割り当てることができる操作のリストです。 ここで選択する操作によって、「Input Parameter Mappings」セクションと「Output Parameter Mappings」セクションに表示されるフィールドが決まります。
入力パラメーターのマッピング: サービスおよび操作を処理するために必要な入力を設定するために使用します。入力には、リテラルと変数の 2 種類があります。
リテラル: メールでは、フィールドに入力された値を表示どおりに使用します。
変数: メールの件名、本文、ヘッダーまたは送信者のメールアドレスから文字列をマップできます。これを行うには、%SUBJECT%、%BODY%、%HEADER%、または%SENDER%のいずれかのキーワードを使用します。 例えば、%SUBJECT%を使用する場合、電子メールの件名の内容が入力パラメーターとして使用されます。 添付ファイルを取得するには、電子メールエンドポイントが添付ドキュメントの選択に使用できるファイルパターンを入力します。 例えば、*.pdf と入力すると、ファイル名に拡張子 .pdf を持つ添付ドキュメントがすべて選択されます。* と入力すると、添付ドキュメントがすべて選択されます。example.pdf と入力すると、example.pdf という名前の添付ドキュメントがすべて選択されます。
出力パラメーターのマッピング: サービスおよび操作の出力を設定するために使用します。出力パラメーターに次の文字を使用すると、マップされた値が添付ファイル名に展開されます。
%F ソースファイルのファイル名(拡張子は除く)を表します。
%Eソースファイルの拡張子を表します。
バックスラッシュ(\)は %% に置き換えられます。
注意:サービス要求メッセージに複数の添付ファイルが含まれている場合、エンドポイントの出力パラメーターのマッピングプロパティの値に、%F パラメーターおよび %E パラメーターを使用することはできません。サービス応答が複数の添付ファイルを返す場合、複数の添付ファイルに同じファイル名を指定することはできません。 これらの推奨事項に従わない場合、呼び出されたサービスは返されたファイルの名前を作成しますが、名前は予測可能ではありません。
使用可能な値を次に示します。
単一のオブジェクト: メールプロバイダーはソースフォルダーの宛先を持たないので、結果は添付ファイルとして返されます。パターンは「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)になります。
forms ワークフローがユーザーからの受信電子メールメッセージを受信して処理するには、Complete Task サービスの電子メールエンドポイントを作成する必要があります。
*.*
と入力します。これで、受信メールメッセージのすべての添付ファイルが Complete Task プロセスのマップ変数に送信されます。%BODY%
と入力します。%SENDER%
と入力します。これで、送信者のアドレスが Complete Task プロセスデータにマップされます。results
と入力します。これにより、Complete Task または Start Process が結果の文字列を返します。