デザイン > システムサービス、リスナおよびコネクタ > 電子メールサービスの使用

電子メールサービスの使用

電子メール接続プロパティ

電子メール接続を定義して、電子メールサーバーから指定された受信者のリストに電子メールを送信できます。電子メールアプリケーション接続には、OAuth 2.0認証またはパスワードベースの認証を使用できます。OAuth 2.0認証は、Microsoft Outlook電子メールアカウントにのみ使用できます。

場合によっては、複数の電子メール接続を定義する必要があります。例えば、大学内の各学部に異なるSMTPホストを使用することがあります。または、各ドメインが固有のSMTP設定を持つ必要がある複数のドメインを設けることがあります。各SMTPホストに、個別の接続が必要です。

［IICS Cloud Application Integration電子メール（使用ライセンスあり）］を接続タイプとして選択した場合、接続作成ページで電子メール固有の接続プロパティを設定できます。

パスワードベースの認証を使用して電子メール接続を作成するには、接続作成ページで次のプロパティを設定します。

プロパティ	説明
認証	必須。電子メール接続でパスワードベースの認証を使用する必要があるかどうかを指定します。［有効化］を選択した場合、電子メールコネクタは、電子メール接続プロパティに入力したユーザー名とパスワードを認証します。［無効化］を選択した場合、電子メールコネクタは認証を実行せず、電子メール接続プロパティに入力したユーザー名とパスワードを無視します。デフォルトは［有効化］です。
ユーザー名	パスワードベースの認証を有効にする場合は必須です。パスワードベースの認証を無効にすると、電子メールコネクタは認証を実行せず、このフィールドに入力した値を無視します。電子メールサーバーにログインするためのユーザー名を入力します。ユーザー名は、アカウント名または電子メールアドレスのいずれかです。例: notifyme@mydomain.com 注: 環境内のSMTPをパスワードベースの認証なしで動作するように設定した場合、ユーザー名とパスワードを入力しないでください。
パスワード	パスワードベースの認証を有効にする場合は必須です。パスワードベースの認証を無効にすると、電子メールコネクタは認証を実行せず、このフィールドに入力した値を無視します。電子メールアドレスのパスワードを入力します。注: 環境内のSMTPをパスワードベースの認証なしで動作するように設定した場合、ユーザー名とパスワードを入力しないでください。
セキュリティ	必須。電子メール接続で使用する必要のあるセキュリティプロトコルを指定します。次のいずれかの値を選択します。 - なし。電子メール接続はセキュリティプロトコルを使用しません。 - TLS 。電子メール接続はTLSプロトコルを使用します。 - SSL。電子メール接続はSSLプロトコルを使用します。デフォルトは［なし］です。
接続タイムアウト	オプション。電子メールサーバーへの接続を試行するときに待機するミリ秒数を指定します。デフォルトは30000ミリ秒です。電子メール接続の使用中にタイムアウトが発生した場合、ネットワークおよびファイアウォールの設定を確認します。

OAuth認証を使用して電子メール接続を作成するには、接続作成ページで次のプロパティを設定します。

プロパティ	説明
認証URL	必須。ユーザー要求の認証に使用する電子メールサービスのOAuth認証URLを入力します。例: https://login.microsoftonline.com/xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx/oauth2/v2.0/authorize
トークン要求URL	必須。トークン要求を処理するOAuthトークン要求URLを入力します。例: https://login.microsoftonline.com/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/oauth2/v2.0/token リフレッシュトークンの有効期限は90日です。ユーザーは、トークンの有効期限が切れる前に、再度認証して接続をパブリッシュする必要があります。
クライアントID	必須。OAuthプロバイダからの識別子の値を指定します。
クライアントシークレット	必須。電子メールアプリケーションに接続するためのクライアントシークレットを入力します。
スコープ	必須。スコープを指定します。OAuth認証のスコープは、アプリケーションからユーザーのアカウントへのアクセスを制限するものです。1つのクライアントに対して複数のスコープを選択できます。複数のスコープを入力するには、各値をスペースで区切ります。 Microsoft Outlook電子メールアカウントの場合は、次のスコープを入力します。 https://outlook.office.com/SMTP.Send offline_access
承認ステータス	現在のステータス、承認したユーザーの名前、最後に承認が完了した時刻を示します。
アクセスの承認	OAuthを使用した承認ワークフローを開始するにはクリックします。

注: OAuthプロバイダで、接続を作成するCAI PODのホストにリダイレクトURIを設定します。リダイレクトURIには、/oauthcallback文字列が含まれている必要があります。例: https://<Informatica Cloud Application Integration URL>/oauthcallback

接続作成ページで次の共通プロパティを設定します。

プロパティ	説明
ホスト	必須。mail.mydomain.comなどの電子メールサーバーのDNS名、または、192.168.1.1などのIPアドレスを入力します。
ポート	必須。プロセスサーバーと電子メールサーバーとの間の通信用のポートを入力します。デフォルトは25です。
電子メールアドレスのテスト	オプション。電子メール接続をテストするときにテストメッセージを送信する電子メールアドレスを入力します。複数の電子メールアドレスはカンマで区切ります。
送信者電子メールアドレス	オプション。接続から送信する電子メールの［送信者］フィールドに表示する電子メールアドレスを入力します。例: no-reply@example.com

電子メール接続のパブリッシュ

電子メール接続を作成した後に、接続を検証、保存、およびパブリッシュできます。詳細については、「デザイン」を参照してください。

電子メール接続をパブリッシュすると、アプリケーション統合は［メタデータ］タブで次の項目を作成します。

sendEmailService
AttachmentInformation
EmailTaskInput
EmailTaskOutput

プロセスまたはガイドでの電子メールオブジェクトの使用

プロセスまたはガイドで電子メールオブジェクトを使用するには、次の手順を実行します。

1電子メールオブジェクトを割り当てるフィールドを作成します。

2［タイプ］リストで［タイプをさらに表示］を選択します。

3［カテゴリ］リストで［定義された接続タイプ］を選択します。

4［接続］リストで、電子メール接続を選択します。

5次の図に示すように、［タイプ］セクションで、必要な電子メールオブジェクトを選択します。

この図には、プロセスまたはガイドで使用できる電子メールオブジェクトが示されています。

次に、プロセスまたはガイドの電子メールオブジェクトフィールドに値を割り当てることができます。

プロセスまたはガイドでの電子メール接続の使用

電子メール接続を作成した後、プロセスまたはガイドのサービスステップで使用できます。

プロセスまたはガイドで電子メール接続を使用するには、次の手順を実行します。

1プロセスまたはガイドにサービスステップを追加します。
2［サービス］タブをクリックします。
3［サービスタイプ］リストから、［接続］を選択します。
4［接続］リストから、作成した電子メール接続を参照して選択します。
5［アクション］リストで、電子メール接続がパブリッシュされたときに作成されたsendEmailServiceアクションを選択します。アプリケーション統合は、入力フィールドの下のemailTaskInputオブジェクトと出力フィールドの下のemailTaskOutputオブジェクトを読み込みます。

次の図は、電子メールを送信するサンプルのサービスステップを示しています。

この図は、電子メールを送信するサービスステップを示しています。

6［入力フィールド］タブをクリックします。
7電子メールメッセージのコンテンツを［emailTaskInput］フィールドに設定します。

複数の受信者に電子メールを送信するには、電子メールアドレスをカンマで区切ります。

8必要に応じて、電子メールの添付ファイルと出力フィールドを設定します。
9プロセスまたはガイドを検証、保存、パブリッシュ、および実行します。