Email Send コネクタ

Email Send コネクタは、SMTP メールサーバーを介してメッセージを送信します。

主な機能

ユーザー指定のサーバーまたはSendGrid を使用したSMTP ベースのE メール配信。最新のプロバイダー向けにOAuth 2.0 をサポート
XML データまたはScript から動的にコンテンツを生成するテンプレートモード
カスタマイズ可能なメッセージ本文を伴ってファイルを送信する添付モード
動的なフィールド入力による複数の宛先（To、CC、BCC）のサポート

概要

Email Send コネクタはSMTP サーバー（ユーザー指定またはSendGrid）の配信サービスに接続し、ファイルを送信E メールメッセージとして送信します。コネクタが処理するインプットファイルは、E メールの添付ファイルとして直接送信することも、インプットファイルからデータを解析してスクリプティングテンプレートを介して送信メッセージに含めることもできます。スクリプティングテンプレートの作成方法の詳細については、テンプレートセクションを参照してください。

Outlook およびGmail メールサーバー向けのOAuth 2.0 設定は、Email Send コネクタで行われる最も一般的な2つの接続設定です。これら2つのメールサーバーに関する追加のガイドとリソースは、CData Community で参照できます。Using OAuth 2.0 in the Email Send and Receive Connectorsを参照してください。

コネクタの設定

このセクションには、設定可能なすべてのコネクタプロパティが含まれます。

Email Config

接続の確立

でE メールを送信できるようにするには、まずEmail Send 接続を確立する必要があります。一度確立すると、接続は複数のEmail Send コネクタ間で共有できます。この接続を確立するには2つの方法があります：

フローにEmail Send コネクタを追加します。次に、Connection ドロップダウンを使用して既存の接続を選択するか、Create をクリックして新しい接続を追加します。
のSettings ページを開き、Connections タブを開きます。Add をクリックし、Email Send を選択してNext をクリックします。
この方法で接続を作成した場合でも、コネクタのConnection ドロップダウンから接続を選択する必要があります。

次のプロパティを設定します：

設定	説明
Email Protocol	ユーザー指定のSMTP サーバーとSendGrid のどちらを使用するか。SendGrid を選択した場合、残るのはTLS Type のみです。他のすべてのフィールドはSMTP に関連するものです。
API Key	SendGrid のAPI キー。 Cloud の実装には適用されません。
Host	SMTP サーバーのホスト名またはIP アドレス。
Port	SMTP サーバーへの接続に使用するポート。代表的な値は143 と993 です。
Authentication Mechanism	サーバーへのログインに使用する認証の種類。選択内容に応じてオプションが変わります。
Password	（Basic およびNTLM）IMAP サーバーへのパスワード。
Auth URL	（OAuth 2.0）サービスの認可URL。Connect ボタンをクリックしてログインし、アプリケーションへのアクセスを許可する際に誘導されるURL です。
Access Token URL	（OAuth 2.0）アクセストークンへのURL。
Client Id	（OAuth 2.0）OAuth に登録した際に割り当てられたクライアントId。
Client Secret	（OAuth 2.0）OAuth に登録した際に割り当てられたシークレット。
Scope	（OAuth 2.0）アプリケーションがアクセスできるべきスコープのリスト。
Callback URL	（OAuth 2.0）接続先のサービスがアクセスを提供するためにトークンを返すURL。サービスでは許可するURL をホワイトリストに登録する必要があることが多いため、これはサービスへのアプリケーション登録を設定する際に使用する値です。
None	認証は必要ありません。
User	SMTP サーバーへのログインに使用するユーザー名。Authentication Mechanism がNone に設定されている場合は表示されません。
TLS Type	サーバーへの接続時にTLS/SSL をネゴシエートするために使用する方法： STARTTLS：プレーンテキスト接続が確立されます。その後、明示的なコマンドでTLS/SSL を開始できます。 SSL/TLS：まずプレーンテキスト接続を確立せずに、ただちにネゴシエーションが行われます。 None (Plain Text)：プレーンテキスト接続が確立され、TLS/SSL は使用されません。 Automatic：適切なTLS/SSL ネゴシエーション方法がポート番号に基づいて検出され、適用されます。標準のメールポート（25、587）にはSTARTTLS が使用され、ポート465 にはTLS/SSL が使用されます。

SMTP サーバーへのネットワークレベルの接続を確立するには、次の設定が必要です：

Host
Port
TLS Type

ネットワークレベルの接続が確立されたら、サーバーに保存されているメッセージにアクセスするために次の設定が必要です：

User
Password またはOAuth 2.0 認証クレデンシャル
Mailbox

SendGrid が必要とする設定はTLS Type のみです。 Add and Test ボタンを使用して、コネクタがサーバーに到達できることを確認します。

追加の設定

送信E メールメッセージの設定。これらのフィールドのほとんどには、送信ファイルからの動的データを含めることができます（詳細については、動的フィールドを参照してください）。

設定	説明
Message Type	メッセージの処理方法を指定します： Attachment：コネクタに到着したファイルを添付ファイルとして送信します。詳細と例については、添付モードを参照してください。 Template：メッセージ本文を、インプットファイルから値を読み取るScript テンプレートとして解釈します。スクリプティングテンプレートの作成方法の詳細については、テンプレートモードを参照してください。
To	送信E メールメッセージの受信者のE メールアドレス。複数の受信者に送信するには、カンマ区切りのリストを使用します。
Show From	送信E メールメッセージの送信者のE メールアドレスを入力するフィールドを開きます。コネクタは、SMTP サーバーに渡されるUser クレデンシャルに基づいて、このフィールドの値を自動的に判定しようとします。
Show Cc / Show Bcc	カーボンコピー（CC）またはブラインドカーボンコピー（BCC）するE メールアドレスを入力するフィールドを開きます。複数の受信者に送信するには、カンマ区切りのリストを使用します。
Subject	送信E メールメッセージの件名。
Message Body	E メール本文。
Allow Script in Email Body	Message Type がAttachment の場合に、メッセージ本文でのScript の評価を許可するには、これをチェックします。

To、From、CC、BCC、Subject フィールドでもScript エディタボタンをクリックすることでScript を使用できます。

Settings タブ

Email Send Configuration

コネクタの名前と説明の設定。

Advanced タブ

Advanced Settings

処理に関連する追加の設定。

設定	説明
Attachment Filter	送信前にメッセージに適用するグロブパターンフィルタ。パターンは肯定または否定にできます。例えば、`.edi` は`.edi` 拡張子のファイルのみを送信し、`-.tmp` は`.tmp` 拡張子のファイルを除外します。カンマ区切りのフィルタのリストを指定できます。完全一致を使用しない限り、後のフィルタが優先されます。
Outgoing Server Public Certificate	TLS/SSL サーバーのID を検証するために使用される公開鍵証明書。ターゲットサーバーがTLS/SSL を使用する場合、このフィールドにサーバーを識別する証明書を設定します。サーバーの証明書が利用できない場合、この設定を空白のままにして、基盤となるOS/JVM に証明書の検証を実行させるか、`Any Certificate` に設定してサーバーのID を暗黙的に信頼することができます。
Extension Map	添付ファイルのContent-Type ヘッダー値を判定するための、名前と値のペアのカンマ区切りのリスト。例えば、.txt=text/plain, .dat=application/edi-x12, .edi=application/edifact 注意：インプットメッセージにContent-Type ヘッダーを含めると、この設定で判定されるコンテンツタイプが上書きされます。
Processing Delay	Transactions タブに配置されたファイルの処理を遅延させる時間（秒単位）。これはレガシー設定です。この設定の代わりにFile コネクタを使用してローカルファイルシステムを管理することがベストプラクティスです。

Proxy Settings

Logging

Miscellaneous

Automation タブ

Automation Settings

設定	説明
Send	ファイルの準備ができたときにコネクタが自動的にファイルを送信するよう指示するトグル。
Retry Interval	失敗した送信を再試行するまでにコネクタが待機する間隔。
Max Attempts	コネクタがメッセージの送信を試みる回数。この値を 1 に設定すると、再試行せずに最初の送信試行のみを行うようコネクタに指示します。コネクタは各試行の間にRetry Interval で指定された時間だけ待機します。

Performance

Alerts タブ

SLAs タブ

Transactions タブ

このタブには、コネクタに関連するすべてのメッセージが一覧表示されます。検索バーを使用して特定のメッセージを見つけるか、じょうごアイコンをクリックしてフィルタを適用します。追跡されたヘッダー、時間、ステータスのいずれか、またはその組み合わせでフィルタリングできます。

E メールの送信

Email Configタブで、送信するE メールメッセージが決まります：

Message Type がAttachment に設定されている場合、コネクタが処理するファイルがE メールの添付ファイルとして送信されるため、メッセージテキストエディタでメッセージの本文を指定する必要があります。詳細については、添付モードを参照してください。
Message Type がTemplate に設定されている場合、メッセージテキストエディタはScript テンプレートとして扱われます。スクリプティングテンプレートでは、コネクタが処理するファイルから値を解析してE メール本文に含めることができます。詳細については、テンプレートモードを参照してください。

1通のE メールで複数の添付ファイルを送信するには、含めたいすべての添付ファイルを含むバッチグループを構築し、そのバッチグループを処理のためにEmail Send コネクタに送信する必要があります。

動的フィールド

To、From、CC、BCC、Subject フィールドは、送信ファイルからの動的情報（例えば、ファイル名やファイルを処理したコネクタ）をサポートします。ファイル情報は_messageアイテムを通じて利用できます。_message アイテムには、送信ファイルで利用可能な各ヘッダーに対応するheader: プレフィックス付きのアトリビュートのコレクションがあります。これらのヘッダーには、ファイル名、フロー内でのファイル処理に関連するメタデータ、およびスクリプティングによってファイルにプロモートされたカスタムヘッダーが含まれます。 _message アイテムとヘッダーアトリビュートは、他のScript アイテムと同様に角括弧で参照されます： [_message.header:headerName] 例えば、送信ファイルのファイル名を含めるために、Subject を次の値に設定できます： [_message.header:filename]

テンプレートモード

Message Type をTemplate に設定すると、メッセージ本文をScript テンプレートとして解釈するようコネクタに指示します。テンプレートはシンプルな構文を使用してインプットファイルとやり取りし、E メール本文で使用する値を取得します。これらの値を静的なテキストと組み合わせることで、コネクタが処理するファイルに基づいて動的に値が入力される標準的な本文形式を生成できます。 Template モードを使用するには、コネクタはインプットとしてXML ファイルを受信する必要があります。テンプレートはXML ファイルからのみ情報を解析できます。

基本のテンプレート

テンプレートメッセージの例として、次のインプットXML ドキュメントを考えてみます：

<Lead>
  <Company>ABC, Inc.</Company>
  <Email>john@abcinc.com</Email>
  <FirstName>John</FirstName>
  <Description>Blue Widget</Description>
</Lead>

このファイルには、Lead タグ内に属性のリスト（Company、Email、FirstName、Description）が含まれています。Email フィールドをメッセージに渡すScript の式は次のようになります： [document.lead_email] この式には3つのコンポーネントがあります：

現在開いているファイルを指す document アイテム。
‘john@abcinc.com’ を指す lead_email アトリビュート。
リテラル文字ではなくフォーマッタの使用を示す角括弧（[]）。

上記のXML インプットファイルのE メール本文テンプレートは次のようになります：

Hi [document.lead_firstname],
<br>
We saw that you might be interested in the following product:
<br>
[document.lead_description]
<br>
Would you like to set up a demo to learn more about how we can help you with your work at [document.lead_company]?

このメッセージは次のE メールを生成します：

Hi John,

We saw that you might be interested in the following product:

Blue Widget

Would you like to set up a demo to learn more about how we can help you with your work at ABC, Inc.?

Script の詳細については、スクリプティングセクションを参照してください。

XPath フォーマット

XPath フォーマッタ（式ではxpath と記述）は、ファイルから動的な値を取得するための代替アプローチを提供します。このアプローチは、の他の箇所ですでにScript を使用しているユーザーには馴染みがあるかもしれません。XPath では、インプットファイルがXML ファイルである必要があります。上記と同じインプットファイルの例を使用します：

<Lead>
  <Company>ABC, Inc.</Company>
  <Email>john@abcinc.com</Email>
  <FirstName>John</FirstName>
  <Description>Blue Widget</Description>
</Lead>

E メールアドレスを返すXPath 式は次のようになります： [xpath(/Lead/Email)] この式には3つのコンポーネントがあります：

xpath の後に括弧が続き、式がXPath 式であることを示します。
データへのパス。各レベルはスラッシュで区切られます。
リテラル文字ではなくフォーマッタの使用を示す角括弧（[]）。

テンプレートモードでのXPath フォーマッタの使用

次のXML を考えてみます：

<Items>
    <projectName>myProject</projectName>
    <assignee>Bob Ross</assignee>
    <dueDate>02/27/2024</dueDate>
    <resources>
        <description>http://mydomain.com/desc</description>
        <images>http://mydomain.com/images</images>
        <colors>http://mydomain.com/colors</colors>
    </resources>
</Items>

上記のXML インプットファイルにxpath 式を使用したE メール本文テンプレートは次のようになります：

Hi [xpath(/Items/assignee)],
<br>
You have a new project to start working on. The name of the project is [xpath(/Items/projectName)].
<br>
All the resources you need can be found at the following links:
<br>
<ul>
  <li>Description: [xpath(/Items/resources/description)]</li>
  <li>Images: [xpath(/Items/resources/images)]</li>
  <li>Colors: [xpath(/Items/resources/colors)]</li>
</ul>
<br>
The due date for this project is [xpath(/Items/dueDate)].

このメッセージは次のE メールを生成します：

Hi Bob Ross,

You have a new project to start working on. The name of the project is myProject.

All the resources you need can be found at the following links:

  - Description: http://mydomain.com/desc
  - Images: http://mydomain.com/images
  - Colors: http://mydomain.com/colors

The due date for this project is 02/27/2024.

Code View エディタ

Code View エディタを使用すると、XML ファイルからの情報を高度に処理するためのカスタムScript を作成できます。Code View エディタを開くには、メッセージエディタでCode View ボタンをクリックします。

このモードでは、Script の式を使用して複数のデータエントリを一度に処理できます。次のインプットファイルの例には、名前のリストが含まれています：

<record>
  <to>Dave</to>
  <items>
    <item>
      <first_name>James</first_name>
      <last_name>Satchel</last_name>
    </item>
    <item>
      <first_name>John</first_name>
      <last_name>Smith</last_name>
    </item>
    <item>
      <first_name>Gina</first_name>
      <last_name>Newberry</last_name>
    </item>
  </items>
</record>

Code View エディタで記述された次のメッセージは、Script を使用してこのインプットファイルからデータを取り込みます：

Hi [document.record_to],
<br>
Here are the people you were asking about:
<br>
<arc:set attr="xml.xpath" value="/record/items/item" />
<arc:call op="xmlDOMSearch" in="xml">
  <arc:set attr="first.names" value="[xpath(first_name)]" />
  <arc:set attr="last.names" value="[xpath(last_name)]" />
  <arc:enum attr="first.names">
    [_value]
  </arc:enum>
  <arc:enum attr="last.names">
    [_value]
  </arc:enum>
  <br>
</arc:call>

このコードは、インプットXML ファイル内のすべての名と姓の値をループ処理し、メッセージの本文に出力します。上記のインプットファイルで実行すると、最終的なE メールは次のようになります：

Hi Dave,

Here are the people you were asking about:

James Satchel
John Smith
Gina Newberry

Script およびカスタム式の詳細については、スクリプティングセクションを参照してください。

添付モード

Message Type をAttachment に設定する場合は、E メールメッセージの本文をエディタに入力します。必要に応じて、インプットメッセージのヘッダーを参照してE メールの本文を充実させることができます。Email Send コネクタはそれらのヘッダーを評価し、インプットファイルを送信E メールに添付します。

これは、必要な値をヘッダーとしてメッセージにプロモートする、フロー内の前のステップに依存します。ファイルの内容に応じて、さまざまなオペレーションやコネクタ設定でこれを行うことができます。

次のXML を考えてみます：

<Items>
    <projectName>myProject</projectName>
    <assignee>Bob Ross</assignee>
    <dueDate>02/27/2024</dueDate>
    <resources>
        <description>http://mydomain.com/desc</description>
        <images>http://mydomain.com/images</images>
        <colors>http://mydomain.com/colors</colors>
    </resources>
</Items>

E メール本文は次のようになります：

Hi [_message.header:assignee],
<br>
You have a new project to start working on. The name of the project is [_message.header:projectname].
<br>
All the resources you need can be found at the following links:
<br>
<ul>
  <li>Description: [_message.header:description]</li>
  <li>Images: [_message.header:images]</li>
  <li>Colors: [_message.header:colors]</li>
</ul>
<br>
The due date for this project is [_message.header:duedate].

このメッセージは次のE メールを生成し、インプットファイルを添付ファイルとして含めます：

Hi Bob Ross,

You have a new project to start working on. The name of the project is myProject.

All the resources you need can be found at the following links:

  - Description: http://mydomain.com/desc
  - Images: http://mydomain.com/images
  - Colors: http://mydomain.com/colors

The due date for this project is 02/27/2024.

はじめに

フロー

EDI トレーディングパートナー管理コンソール

コネクタ

マッピング

API と自動化

ハウツーガイド

スクリプティング

ソフトウェアライセンスとサードパーティ著作権

主な機能

概要

コネクタの設定

Email Config

接続の確立

追加の設定

Settings タブ

Email Send Configuration

Advanced タブ

Advanced Settings

Proxy Settings

Logging

Miscellaneous

Automation タブ

Automation Settings

Performance

Alerts タブ

SLAs タブ

Transactions タブ

E メールの送信

動的フィールド

テンプレートモード

基本のテンプレート

XPath フォーマット

テンプレートモードでのXPath フォーマッタの使用

Code View エディタ

添付モード

​主な機能

​概要

​コネクタの設定

​Email Config

​接続の確立

​追加の設定

​Settings タブ

​Email Send Configuration

​Advanced タブ

​Advanced Settings

​Proxy Settings

​Logging

​Miscellaneous

​Automation タブ

​Automation Settings

​Performance

​Alerts タブ

​SLAs タブ

​Transactions タブ

​E メールの送信

​動的フィールド

​テンプレートモード

​基本のテンプレート

​XPath フォーマット

テンプレートモードでのXPath フォーマッタの使用

​Code View エディタ

​添付モード

主な機能

概要

コネクタの設定

Email Config

接続の確立

追加の設定

Settings タブ

Email Send Configuration

Advanced タブ

Advanced Settings

Proxy Settings

Logging

Miscellaneous

Automation タブ

Automation Settings

Performance

Alerts タブ

SLAs タブ

Transactions タブ

E メールの送信

動的フィールド

テンプレートモード

基本のテンプレート

XPath フォーマット

Code View エディタ

添付モード