Email Send コネクタ（廃止予定）

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

主な機能

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

概要

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

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

コネクタの設定

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

Settings タブ

Email Send Configuration

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

Connection

SMTP サーバーに接続するための設定。

設定	説明
Host	SMTP サーバーのホスト名またはIP アドレス。
Port	SMTP サーバーへの接続に使用するポート。
User	SMTP サーバーへのログインに使用するユーザー名。
Authentication Mechanism	サーバーへのログインに使用する認証の種類。選択内容に応じてオプションが変わります。
Password	（Basic およびNTLM）SMTP サーバーへのパスワード。
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	認証は必要ありません。
TLS Type	サーバーへの接続時にSSL/TLS をネゴシエートするために使用する方法：STARTTLS：プレーンテキスト接続が確立されます。その後、明示的なコマンドでSSL/TLS を開始できます。SSL/TLS：まずプレーンテキスト接続を確立せずに、ただちにネゴシエーションが行われます。None (Plain Text)：プレーンテキスト接続が確立され、SSL/TLS は使用されません。Automatic：コネクタは設定されたポート番号に基づいてTLS の種類を判定します。

Message

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

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

Automation タブ

Automation Settings

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

Performance

Alerts タブ

SLAs タブ

Advanced タブ

Proxy Settings

Advanced Settings

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

設定	説明
Allow Script in Attachment mode	Message Type がAttachment の場合に、メッセージ本文でのScript の評価を許可するには、これをチェックします。
Excluded Extensions	コネクタで処理すべきでないファイル拡張子のカンマ区切りのリスト。
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 コネクタを使用してローカルファイルシステムを管理することがベストプラクティスです。

Logging

ログの作成と保存を制御する設定。

設定	説明
Log Level	コネクタが生成するログの詳細度。サポートをリクエストする際は、これをDebug に設定してください。
Log Subfolder Scheme	コネクタに対して、選択した間隔に従ってLogs フォルダ内のファイルをグループ化するよう指示します。Weekly オプション（デフォルト）は、コネクタに対して毎週新しいサブフォルダを作成し、その週のすべてのログをそのフォルダに保存するよう指示します。この設定を空白のままにすると、コネクタはすべてのログをLogs フォルダに直接保存します。多くのトランザクションを処理するコネクタの場合、サブフォルダを使用するとログを整理しやすくなり、パフォーマンスが向上します。
Log Messages	処理されたファイルのログエントリにファイル自体のコピーを含めるには、これをチェックします。これを無効にすると、Input タブまたはOutput タブからファイルのコピーをダウンロードできなくなる場合があります。

Miscellaneous

接続の確立

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

Host
Port
TLS Type

Test Connection ボタンをクリックして、コネクタがサーバーに到達できることを確認します。ネットワークレベルの接続が確立されたら、サーバーにログインしてE メールの送信を開始するために次の設定が必要です：

User
Password

E メールの送信

コネクタのSettings ページのMessageセクションで、送信する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 メール本文で使用する値を取得します。これらの値は静的テキストと組み合わせて、コネクタが処理するファイルに基づいて動的に入力される標準的な本文フォーマットを生成できます。テンプレートモードを使用するには、コネクタがインプットとして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.?

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

添付モード

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

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

次の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 Send コネクタ（廃止予定）

主な機能

概要

コネクタの設定

Settings タブ

Email Send Configuration

Connection

Message

Automation タブ

Automation Settings

Performance

Alerts タブ

SLAs タブ

Advanced タブ

Proxy Settings

Advanced Settings

Logging

Miscellaneous

接続の確立

E メールの送信

動的フィールド

テンプレートモード

基本的なテンプレート

XPath フォーマット

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

Code View エディタ

添付モード

​主な機能

​概要

​コネクタの設定

​Settings タブ

​Email Send Configuration

​Connection

​Message

​Automation タブ

​Automation Settings

​Performance

​Alerts タブ

​SLAs タブ

​Advanced タブ

​Proxy Settings

​Advanced Settings

​Logging

​Miscellaneous

​接続の確立

​E メールの送信

​動的フィールド

​テンプレートモード

​基本的なテンプレート

​XPath フォーマット

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

​Code View エディタ

​添付モード

主な機能

概要

コネクタの設定

Settings タブ

Email Send Configuration

Connection

Message

Automation タブ

Automation Settings

Performance

Alerts タブ

SLAs タブ

Advanced タブ

Proxy Settings

Advanced Settings

Logging

Miscellaneous

接続の確立

E メールの送信

動的フィールド

テンプレートモード

基本的なテンプレート

XPath フォーマット

Code View エディタ

添付モード