> ## Documentation Index > Fetch the complete documentation index at: https://docs.arc.cdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Email Send コネクタ > SMTP メールサーバーまたはSendGrid を介してメッセージを送信します。OAuth 2.0 対応、テンプレートによるコンテンツ生成、ファイル配信のための添付モードをサポートします。 export const NameDescription = ({extraRows}) => {extraRows}
設定 説明
Connector Id コネクタの静的で一意の識別子です。
Connector Type コネクタ名とその機能の説明を表示します。
Connector Description コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。
; export const CommonProxySettings = () => <>

これらは、接続のルーティング先となるプロキシを識別し認証するための一連の設定です。デフォルトでは、このセクションはSecurity Settings ページのProxy Settings 部分にあるグローバル設定を使用します。チェックボックスをオフにすると、コネクタ固有の設定を指定できます。

設定説明
Proxy Type プロキシベースのファイアウォールで使用されるプロトコル。
Proxy Host プロキシベースのファイアウォールの名前またはIP アドレス。
Proxy Port プロキシベースのファイアウォールのTCP ポート。
Proxy User プロキシベースのファイアウォールで認証するために使用するユーザー名。
Proxy Password プロキシベースのファイアウォールで認証するために使用するパスワード。
Authentication Scheme デフォルトのNone のままにするか、次の認証スキームのいずれかを選択します：Basic、Digest、Proprietary、またはNTLM。
; export const SlasTab = ({siteName = "CData Arc"}) => <>

サービスレベルアグリーメント（SLA）の設定に関する設定です。

SLA を使用すると、フロー内のコネクタが送受信すると見込まれるボリュームを設定し、そのボリュームを達成すると見込まれる期間を設定できます。{siteName} は、SLA が達成されない場合にユーザーへ警告するメールを送信し、SLA をAt Risk としてマークします。これは、SLA が間もなく達成されない場合にViolated としてマークされることを意味します。これにより、ユーザーは介入してSLA が達成されない理由を特定し、適切な対応を取る機会を得られます。At Risk 期間の終了時点でもSLA が達成されない場合、SLA はviolated としてマークされ、ユーザーに再度通知されます。

SLA を定義するには、Expected Volume をオンに切り替え、Settings タブをクリックします。

SLA Empty

次の例は、月曜日から金曜日まで毎日1000 件のファイルを受信すると見込むコネクタ向けに設定されたSLA を示しています。1000 件のファイルが受信されていない場合、期間の終了の1時間前にAt Risk 通知が送信されます。

SLA Configuration Example 必要に応じてSLA アラートをオフにすることができます。これはメンテナンスウィンドウ中に役立ちます。navbar でSettings をクリックし、Alerts > General Alerts に移動します。タブレットと鉛筆のアイコンをクリックして編集し、SLA Alerts 設定のチェックを外します。 ; export const AlertsTab = ({siteNameShort = "Arc"}) => <>

アラートの設定に関する設定です。

サービスレベルアグリーメント（SLA）を実行する前に、通知用のメールアラートをセットアップする必要があります。デフォルトでは、{siteNameShort} はAlerts タブのグローバル設定を使用します。このコネクタに別の設定を使用するには、Override global setting をオンに切り替えます。

デフォルトではエラーアラートが有効になっており、エラーが発生するたびにメールが送信されます。これをオフにするには、Enable チェックボックスのチェックを外します。

Subject（必須）を入力し、必要に応じてRecipient のメールアドレスをカンマ区切りのリストで入力します。

; export const Message = () => <>

Message 設定は、コネクタがメッセージを検索する方法と、処理後にメッセージを管理する方法を決定します。

設定説明
Save to Sent Folder コネクタが処理したファイルをコネクタのSent フォルダにコピーするには、これをオンにします。
Sent Folder Scheme 選択した間隔に従って、コネクタがSent フォルダ内のファイルをグループ化するよう指示します。例えば、Weekly オプションは、コネクタが毎週新しいサブフォルダを作成し、その週のすべての送信済みファイルをそのフォルダに保存するよう指示します。空白の設定は、コネクタがすべてのファイルをSent フォルダに直接保存するよう指示します。多数のトランザクションを処理するコネクタでは、サブフォルダを使用することでファイルを整理しやすくなり、パフォーマンスを向上できます。
; export const MiscConnector = () => <>

Miscellaneous 設定は、特定のユースケース向けの設定です。

設定 説明
Other Settings 非表示のコネクタ設定をセミコロン区切りのリストで設定できます（例：setting1=value1;setting2=value2）。通常のコネクタのユースケースや機能では、これらの設定の使用は必要ありません。
; export const Logging = () => <>

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

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

コネクタへのリソースの割り当てに関する設定です。

設定 説明
Max Workers このコネクタでファイルを処理するためにスレッドプールから消費されるワーカースレッドの最大数です。設定すると、Advanced Settings ページのPerformance Settings 部分にあるデフォルト設定が上書きされます。
Max Files コネクタに割り当てられた各スレッドが送信するファイルの最大数です。設定すると、Advanced Settings ページのPerformance Settings 部分にあるデフォルト設定が上書きされます。
; export const siteNameShort = "Arc"; export const siteName = "CData Arc"; Email Send コネクタは、SMTP メールサーバーを介してメッセージを送信します。 ## 主な機能 * ユーザー指定のサーバーまたはSendGrid を使用したSMTP ベースのE メール配信。最新のプロバイダー向けにOAuth 2.0 をサポート * XML データまたは{siteNameShort}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](https://community.cdata.com/cdata-arc-48/using-oauth-2-0-in-the-email-send-and-receive-connectors-106?tid=106\&fid=48)を参照してください。 ## コネクタの設定 このセクションには、設定可能なすべてのコネクタプロパティが含まれます。 ### Email Config #### 接続の確立 {siteNameShort} でE メールを送信できるようにするには、まずEmail Send 接続を確立する必要があります。一度確立すると、接続は複数のEmail Send コネクタ間で共有できます。この接続を確立するには2つの方法があります： 1. フローにEmail Send コネクタを追加します。次に、**Connection** ドロップダウンを使用して既存の接続を選択するか、**Create** をクリックして新しい接続を追加します。 2. {siteNameShort} の**Settings** ページを開き、**Connections** タブを開きます。**Add** をクリックし、**Email Send** を選択して**Next** をクリックします。 この方法で接続を作成した場合でも、コネクタの**Connection** ドロップダウンから接続を選択する必要があります。 次のプロパティを設定します： | 設定 | 説明 | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Email Protocol** | ユーザー指定のSMTP サーバーとSendGrid のどちらを使用するか。SendGrid を選択した場合、残るのは**TLS Type** のみです。他のすべてのフィールドはSMTP に関連するものです。 | | **API Key** | SendGrid のAPI キー。{siteNameShort} 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**：メッセージ本文を、インプットファイルから値を読み取る{siteNameShort}Script テンプレートとして解釈します。スクリプティングテンプレートの作成方法の詳細については、[テンプレートモード](#テンプレートモード)を参照してください。 | | **To** | 送信E メールメッセージの受信者のE メールアドレス。複数の受信者に送信するには、カンマ区切りのリストを使用します。 | | **Show From** | 送信E メールメッセージの送信者のE メールアドレスを入力するフィールドを開きます。コネクタは、SMTP サーバーに渡される**User** クレデンシャルに基づいて、このフィールドの値を自動的に判定しようとします。 | | **Show Cc / Show Bcc** | カーボンコピー（CC）またはブラインドカーボンコピー（BCC）するE メールアドレスを入力するフィールドを開きます。複数の受信者に送信するには、カンマ区切りのリストを使用します。 | | **Subject** | 送信E メールメッセージの件名。 | | **Message Body** | E メール本文。 | ### Settings タブ #### Email Send Configuration *コネクタの名前と説明の設定。* ### Advanced タブ #### Advanced Settings *処理に関連する追加の設定。* | 設定 | 説明 | | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Allow {siteNameShort}Script in Attachment mode** | **Message Type** がAttachment の場合に、メッセージ本文での{siteNameShort}Script の評価を許可するには、これをチェックします。 | | **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 コネクタを使用](../flows/designing-a-flow#ローカルファイルシステムとのやり取り)してローカルファイルシステムを管理することがベストプラクティスです。 | #### Proxy Settings #### Message #### Logging #### Miscellaneous ### Automation タブ #### Automation Settings | 設定 | 説明 | | ------------------ | ----------------------------------------------------------------------------------------------------------------- | | **Send** | ファイルの準備ができたときにコネクタが自動的にファイルを送信するよう指示するトグル。 | | **Retry Interval** | 失敗した送信を再試行するまでにコネクタが待機する間隔。 | | **Max Attempts** | コネクタがメッセージの送信を試みる回数。この値を *1* に設定すると、再試行せずに最初の送信試行のみを行うようコネクタに指示します。コネクタは各試行の間に**Retry Interval** で指定された時間だけ待機します。 | #### Performance ### Alerts タブ ### SLAs タブ ### Transactions タブ このタブには、コネクタに関連するすべてのメッセージが一覧表示されます。検索バーを使用して特定のメッセージを見つけるか、じょうごアイコンをクリックしてフィルタを適用します。追跡されたヘッダー、時間、ステータスのいずれか、またはその組み合わせでフィルタリングできます。 ## E メールの送信 [Email Config](#email-config)タブで、送信するE メールメッセージが決まります： * **Message Type** が**Attachment** に設定されている場合、コネクタが処理するファイルがE メールの添付ファイルとして送信されるため、メッセージテキストエディタでメッセージの本文を指定する必要があります。詳細については、[添付モード](#添付モード)を参照してください。 * **Message Type** が**Template** に設定されている場合、メッセージテキストエディタは{siteNameShort}Script テンプレートとして扱われます。スクリプティングテンプレートでは、コネクタが処理するファイルから値を解析してE メール本文に含めることができます。詳細については、[テンプレートモード](#テンプレートモード)を参照してください。 1通のE メールで複数の添付ファイルを送信するには、含めたいすべての添付ファイルを含む[バッチグループ](../getting-started/architecture#バッチグループ)を構築し、そのバッチグループを処理のためにEmail Send コネクタに送信する必要があります。 ### 動的フィールド **To**、**From**、**CC**、**BCC**、**Subject** フィールドは、送信ファイルからの動的情報（例えば、ファイル名やファイルを処理したコネクタ）をサポートします。 ファイル情報は[*\_message*](../scripting/introduction-to-arcscript#メッセージ-_message)アイテムを通じて利用できます。*\_message* アイテムには、送信ファイルで利用可能な各ヘッダーに対応する`header:` プレフィックス付きのアトリビュートのコレクションがあります。これらのヘッダーには、ファイル名、{siteNameShort} フロー内でのファイル処理に関連するメタデータ、およびスクリプティングによってファイルにプロモートされたカスタムヘッダーが含まれます。 *\_message* アイテムとヘッダーアトリビュートは、他の{siteNameShort}Script アイテムと同様に角括弧で参照されます： `[_message.header:headerName]` 例えば、送信ファイルのファイル名を含めるために、Subject を次の値に設定できます： `[_message.header:filename]` ### テンプレートモード **Message Type** をTemplate に設定すると、メッセージ本文を{siteNameShort}Script テンプレートとして解釈するようコネクタに指示します。テンプレートはシンプルな構文を使用してインプットファイルとやり取りし、E メール本文で使用する値を取得します。これらの値を静的なテキストと組み合わせることで、コネクタが処理するファイルに基づいて動的に値が入力される標準的な本文形式を生成できます。 Template モードを使用するには、コネクタはインプットとしてXML ファイルを受信する必要があります。テンプレートはXML ファイルからのみ情報を解析できます。 #### 基本のテンプレート テンプレートメッセージの例として、次のインプットXML ドキュメントを考えてみます： ```xml theme={null} ABC, Inc. john@abcinc.com John Blue Widget ``` このファイルには、`Lead` タグ内に属性のリスト（`Company`、`Email`、`FirstName`、`Description`）が含まれています。`Email` フィールドをメッセージに渡す{siteNameShort}Script の式は次のようになります： `[document.lead_email]` この式には3つのコンポーネントがあります： * 現在開いているファイルを指す *document* アイテム。 * '[john@abcinc.com](mailto:john@abcinc.com)' を指す *lead\_email* アトリビュート。 * リテラル文字ではなくフォーマッタの使用を示す角括弧（`[]`）。 上記のXML インプットファイルのE メール本文テンプレートは次のようになります： ``` Hi [document.lead_firstname],
We saw that you might be interested in the following product:
[document.lead_description]
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.? ``` {siteNameShort}Script の詳細については、[スクリプティング](../scripting/scripting)セクションを参照してください。 #### XPath フォーマット XPath フォーマッタ（式では`xpath` と記述）は、ファイルから動的な値を取得するための代替アプローチを提供します。このアプローチは、{siteNameShort} の他の箇所ですでに{siteNameShort}Script を使用しているユーザーには馴染みがあるかもしれません。XPath では、インプットファイルがXML ファイルである必要があります。 上記と同じインプットファイルの例を使用します： ```xml theme={null} ABC, Inc. john@abcinc.com John Blue Widget ``` E メールアドレスを返すXPath 式は次のようになります： `[xpath(/Lead/Email)]` この式には3つのコンポーネントがあります： * *xpath* の後に括弧が続き、式がXPath 式であることを示します。 * データへのパス。各レベルはスラッシュで区切られます。 * リテラル文字ではなくフォーマッタの使用を示す角括弧（`[]`）。 ##### テンプレートモードでのXPath フォーマッタの使用 次のXML を考えてみます： ```xml theme={null} myProject Bob Ross 02/27/2024 http://mydomain.com/desc http://mydomain.com/images http://mydomain.com/colors ``` 上記のXML インプットファイルにxpath 式を使用したE メール本文テンプレートは次のようになります： ```xml theme={null} Hi [xpath(/Items/assignee)],
You have a new project to start working on. The name of the project is [xpath(/Items/projectName)].
All the resources you need can be found at the following links:
  • Description: [xpath(/Items/resources/description)]
  • Images: [xpath(/Items/resources/images)]
  • Colors: [xpath(/Items/resources/colors)]

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 ファイルからの情報を高度に処理するためのカスタム{siteNameShort}Script を作成できます。Code View エディタを開くには、メッセージエディタで**Code View** ボタンをクリックします。 このモードでは、{siteNameShort}Script の式を使用して複数のデータエントリを一度に処理できます。次のインプットファイルの例には、名前のリストが含まれています： ```xml theme={null} Dave James Satchel John Smith Gina Newberry ``` Code View エディタで記述された次のメッセージは、{siteNameShort}Script を使用してこのインプットファイルからデータを取り込みます： ```xml theme={null} Hi [document.record_to],
Here are the people you were asking about:
[_value] [_value]
``` このコードは、インプットXML ファイル内のすべての名と姓の値をループ処理し、メッセージの本文に出力します。上記のインプットファイルで実行すると、最終的なE メールは次のようになります： ``` Hi Dave, Here are the people you were asking about: James Satchel John Smith Gina Newberry ``` {siteNameShort}Script およびカスタム式の詳細については、[スクリプティング](../scripting/scripting)セクションを参照してください。 ### 添付モード **Message Type** をAttachment に設定する場合は、E メールメッセージの本文をエディタに入力します。必要に応じて、インプットメッセージのヘッダーを参照してE メールの本文を充実させることができます。Email Send コネクタはそれらのヘッダーを評価し、インプットファイルを送信E メールに添付します。 これは、必要な値をヘッダーとしてメッセージにプロモートする、フロー内の前のステップに依存します。ファイルの内容に応じて、さまざまな[オペレーション](../scripting/operations/operations)やコネクタ設定でこれを行うことができます。 次のXML を考えてみます： ```xml theme={null} myProject Bob Ross 02/27/2024 http://mydomain.com/desc http://mydomain.com/images http://mydomain.com/colors ``` E メール本文は次のようになります： ```xml theme={null} Hi [_message.header:assignee],
You have a new project to start working on. The name of the project is [_message.header:projectname].
All the resources you need can be found at the following links:
  • Description: [_message.header:description]
  • Images: [_message.header:images]
  • Colors: [_message.header:colors]

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. ```