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

# Batch Create Connector

> Group individual messages into Batch Groups for collective processing using the CData Arc Batch Create connector.

CData Arc では、データは本文（body）とメタデータヘッダーで構成されるメッセージとしてフロー内を移動します。例えば、あるコネクタが別のコネクタにファイルを渡す場合、そのファイルは本文にファイルを含み、ヘッダーにファイルや関連コネクタに関するメタデータを含むメッセージとして送信されます。メッセージはバッチグループにまとめることができ、これにより複数のメッセージが単一の単位としてまとめて移動できます。バッチグループの用途には、システム間でのデータ移動や、複数の発注書の一括処理などがあります。メッセージがバッチグループの一部である場合、それはバッチメッセージと呼ばれます。

## Key Capabilities

* Intelligent message grouping based on correlation IDs and batch size limits
* Configurable minimum and maximum batch sizes for optimal processing
* Scheduled and immediate batch creation modes
* Support for custom correlation headers for advanced grouping logic

## Overview

The Batch Create connector produces Batch Groups based on Messages that arrive in the Send folder (the **Transactions** tab of the connector settings pane). When a Batch Group is created, it is passed down the flow through the **Transactions** tab, where it can be processed by other connectors as needed.

> [!NOTE]
>
> The Batch Create connector can only accept individual messages as inputs. If the connector receives an existing Batch Group as an input, it throws an error message.

## Connector Configuration

This section contains all of the configurable connector properties.

### Settings Tab

#### Configuration

*Settings that determine how the connector can be accessed.*

<table><thead><tr><th>設定</th>
<th>説明</th></tr></thead>
<tbody><tr><td>**Connector Id**</td>
<td>コネクタの静的で一意の識別子です。</td></tr>
<tr><td>**Connector Type**</td>
<td>コネクタ名とその機能の説明を表示します。</td></tr>
<tr><td>**Connector Description**</td>
<td>コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。</td></tr></tbody></table>

#### Advanced Settings

*Settings that specify Batch Grouping options.*

| Setting | Description |
| - | - |
| **Correlation Id Header** | The connector looks for headers that match the header name you enter, then groups messages according to the values they have assigned to that header. See [Correlation Id Header Example](#correlation-id-header-example) for details. |
| **Max Batch Size** | The maximum number of messages to include in a Batch Group. Any messages in excess of this number wait until the next sending interval. For example, if this is set to 5, and seven messages arrive in the send folder, the connector creates one Batch Group of five messages and adds the final two to the next scheduled Batch Group. |
| **Min Batch Size** | The minimum number of messages that must be present to create a Batch Group. For example, if this is set to five, and three messages arrive in the Send folder, the connector does not create a Batch Group from those messages (even if the specified sending interval passes) until at least two more messages arrive. |

### Advanced Tab

#### Logging

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

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

#### Other Settings

| Setting | Description |
| - | - |
| **Processing Delay** | The amount of time (in seconds) by which the processing of files placed in the **Transactions** tab is delayed. This is a legacy setting. Best practice is to [use a File connector](https://docs.arc.cdata.com/26.4/cloud/ja/flows/designing-a-flow.md#ローカルファイルシステムとのやり取り) to manage local file systems instead of this setting. |

#### Miscellaneous

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

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

### Automation Tab

#### Automation Settings

*Settings related to the creation and sending of Batch Groups.*

| Setting | Description |
| - | - |
| **Enable automation** | If selected, the connector automatically creates Batch Groups following the settings below. If cleared, the connector does not create Batch Groups until you manually trigger it. |
| **Send** | If selected, the connector automatically creates Batch Groups from messages as soon as they arrive in the Send folder (**Transactions** tab) as long as other set criteria are met. |
| **Scheduled Send** | If selected, the connector uses a scheduled interval to create Batch Groups from messages that arrive in the Send folder. |
| **Send Interval** | The interval at which to create Batch Groups. Only available if **Scheduled Send** is enabled. |
| **Minutes Past the Hour** | The minutes offset for an hourly schedule. Only applicable when the interval setting above is set to *Hourly*. For example, if this value is set to 5, the automation service downloads at 1:05, 2:05, 3:05, etc. |
| **Time** | The time of day that the attempt should occur. Only applicable when the interval setting above is set to *Daily*, *Weekly*, or *Monthly*. |
| **Day** | The day on which the attempt should occur. Only applicable when the interval setting above is set to *Weekly* or *Monthly*. |
| **Minutes** | The number of minutes to wait before attempting the download. Only applicable when the interval setting above is set to *Minute*. |
| **Cron Expression** | A five-position string representing a cron expression that determines when the attempt should occur. Only applicable when the interval setting above is set to *Advanced*. |
| **Start Date and Time** | The date and time at which the automation first runs. Every run after that follows the interval setting above. The last and next run times appear in the [Automation Status](#automation-status) section. |

#### Automation Status

*オートメーションが実行されているか、前回の実行で何が起きたか、次回の実行がいつかを示す読み取り専用のサマリです。*

**オートメーションステータス**カードは、**受信**、**ダウンロード**、**スケジュール送信**のオートメーションにおいて、**オートメーション**タブの**有効**チェックボックスの下に表示されます。このカードでは、オートメーションが実行されたか、実行が成功したか、次回の実行がいつかという3点を確認できます。

コネクタを保存する前に、**有効**チェックボックス、**間隔**、または**開始日時**の設定を変更すると、カードもそれに合わせて更新されます。

![一時停止中のステータス、失敗した最後に処理された結果、および次回の実行時刻を表示するオートメーションタブのオートメーションステータスカード](https://docs.arc.cdata.com/26.4/images/automation-status-card.png)

ステータス

コネクタのオートメーションの現在の状態です。

<table><thead><tr><th>ステータス</th>
<th>説明</th></tr></thead>
<tbody><tr><td>**進行中**</td>
<td>実行が現在行われているか、別のインスタンスがスケジュールされた枠をロックしています。</td></tr>
<tr><td>**アイドル**</td>
<td>オートメーションは次のスケジュールされた実行を待機しています。</td></tr>
<tr><td>**一時停止中**</td>
<td>実行の失敗が繰り返された後、コネクタは[バックオフ](https://docs.arc.cdata.com/26.4/cloud/ja/connectors/connector-backoff.md)状態にあり、オートメーションサービスはこのコネクタをスキップしています。</td></tr>
<tr><td>**無効**</td>
<td>このコネクタのオートメーションはオフになっています。</td></tr></tbody></table>

前回の実行時刻

直近の実行の結果です。

<table><thead><tr><th>フィールド</th>
<th>説明</th></tr></thead>
<tbody><tr><td>**日付**</td>
<td>前回の実行のスケジュールされた時刻。</td></tr>
<tr><td>**最後に処理された開始**</td>
<td>コネクタが前回の実行の処理を実際に開始した時刻。スケジュールされた時刻よりわずかに遅れる場合があります。</td></tr>
<tr><td>**最後に処理された結果**</td>
<td>前回の実行の結果：
<ul><li>**成功**：実行が完了し、データが処理されました。</li>
<li>**データなし**：実行は完了しましたが、クエリが行を返さなかった場合など、処理するものがありませんでした。</li>
<li>**失敗**：実行が完了しませんでした。</li></ul></td></tr>
<tr><td>**最後に成功した日時**</td>
<td>直近で成功した実行の日時。このフィールドは、前回の実行が失敗した場合またはデータなしだった場合に表示され、コネクタが成功した実行なしでどれくらい経過しているかを確認できます。</td></tr></tbody></table>

次回の実行時刻

**日付**フィールドには、次にオートメーションが実行される予定の日時が表示されます。オートメーションが無効の場合は空白になります。

詳細を表示

**一時停止中**ステータス、**失敗**の結果、および**データなし**の結果にはそれぞれ**詳細を表示**リンクがあり、クリックすると完全なメッセージを表示するダイアログが開きます：

<ul><li>**一時停止中**：バックオフ状態にある各インスタンス、失敗した回数、およびオートメーションサービスが再開する時刻を一覧表示します。コネクタがこの状態を終了する方法については、[コネクタのバックオフ](https://docs.arc.cdata.com/26.4/cloud/ja/connectors/connector-backoff.md)を参照してください。</li>
<li>**失敗**：前回失敗した実行のエラーメッセージを表示します。</li>
<li>**データなし**：`0 rows returned` など、コネクタが報告したメッセージを表示します。</li></ul>

未実行とデータなしの違い

このカードでは、まだ実行されていないコネクタと、実行されたものの何も見つからなかったコネクタを区別できます。**最後に処理された結果**が空の場合、オートメーションはまだ実行されていないため、**次回の実行時刻**とスケジュール設定を確認してください。結果が**データなし**の場合、オートメーションはスケジュールどおりに実行されましたが、データソースから何も返されなかったため、ソースに新しいデータがあるかどうかを確認してください。

無効なコネクタ

無効なコネクタは前回の実行情報を保持するため、いつ最後に実行され、何が起きたかを引き続き確認できます。クリアされるのは**次回の実行時刻**のみです。

#### Performance

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

<table><thead><tr><th>設定</th>
<th>説明</th></tr></thead>
<tbody><tr><td>**Max Workers**</td>
<td>このコネクタでファイルを処理するためにスレッドプールから消費されるワーカースレッドの最大数です。設定すると、[Advanced Settings](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/advanced-settings.md) ページの[Performance Settings](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/performance-settings.md) 部分にあるデフォルト設定が上書きされます。</td></tr>
<tr><td>**Max Files**</td>
<td>コネクタに割り当てられた各スレッドが送信するファイルの最大数です。設定すると、[Advanced Settings](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/advanced-settings.md) ページの[Performance Settings](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/performance-settings.md) 部分にあるデフォルト設定が上書きされます。</td></tr></tbody></table>

### Alerts Tab

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

サービスレベルアグリーメント（SLA）を実行する前に、通知用のメールアラートをセットアップする必要があります。デフォルトでは、Arc は[Alerts](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/alerts.md) タブのグローバル設定を使用します。このコネクタに別の設定を使用するには、**Override global setting** をオンに切り替えます。

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

**Subject**（必須）を入力します。**Allow ArcScript in Subject** をチェックすると、**Subject** フィールドでArcScript を使用できます。これを選択すると、**ArcScript エディタ**ボタンが表示されます（![arcscript editor button](https://docs.arc.cdata.com/26.4/images/rest_arcscript_editor.png)）。

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

### SLAs Tab

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

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

SLA が*At Risk* または*Violated* に移行したことも[アプリケーションログ](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/activity.md#アプリケーションログ)に書き込まれるため、Application Performance Monitoring（APM）やログ収集ツールでもアラートを設定できます。

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

![SLA Empty](https://docs.arc.cdata.com/26.4/images/sla_empty.png)
<ul><li>コネクタに送信と受信の個別のアクションがある場合は、ラジオボタンを使用してSLA がどちらの方向に適用されるかを指定します。</li>
<li>ウィンドウの**Expect at least** 部分で、次を設定します。
<ul><li>処理を見込む最小トランザクション数（ボリューム）を設定します。</li>
<li>**Every** フィールドを使用して期間を指定します。</li>
<li>SLA を有効にするタイミングを指定します。**Starting on** を選択した場合は、日付および時刻フィールドを入力します。</li>
<li>SLA を有効にしたい曜日のチェックボックスをオンにします。必要に応じて、ドロップダウンで**Everyday** を選択します。</li></ul></li>
<li>ウィンドウの**Set status to 'At Risk'** 部分で、SLA をAt Risk としてマークするタイミングを指定します。
<ul><li>デフォルトでは、SLA が違反状態になるまで通知は送信されません。これを変更するには、**Send an 'At Risk' notification** をオンにします。</li></ul></li></ul>

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

![SLA Configuration Example](https://docs.arc.cdata.com/26.4/images/sla_defined.png)

> [!NOTE]
>
> 必要に応じてSLA アラートをオフにすることができます。これはメンテナンスウィンドウ中に役立ちます。navbar で**Settings** をクリックし、**Alerts > General Alerts** に移動します。タブレットと鉛筆のアイコンをクリックして編集し、**SLA Alerts** 設定のチェックを外します。

## Correlation Id Header Example

When you enter a header name in the **Correlation Id Header** field, the connector looks for headers that match the name you enter, then groups messages according to the values they have assigned to that header. For example, the following table displays six incoming messages:

| MessageId | Filename | Header | Header Value |
| - | - | - | - |
| 1 | test1.txt | Batch-Correlation-Id | 001 |
| 2 | test2.txt | Batch-Correlation-Id | 001 |
| 3 | test3.txt | Batch-Correlation-Id | 002 |
| 4 | test4.txt | Batch-Correlation-Id | 002 |
| 5 | test5.txt | | |
| 6 | test6.txt | | |

If you enter **Batch-Correlation-Id** in the **Correlation Id Header** field, the connector creates three Batch Groups of these messages:

* The first batch group contains the messages with **MessageId** 1 and 2, since they both have the value `001` for the Batch-Correlation-Id header.
* The second batch group contains messages with **MessageId** 3 and 4, since they both have the value `002` for the header.
* The third batch group contains messages 5 and 6, since neither of them has the Batch-Correlation-Id header.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.
設定	説明
Connector Id	コネクタの静的で一意の識別子です。
Connector Type	コネクタ名とその機能の説明を表示します。
Connector Description	コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。
設定	説明
Log Level	コネクタが生成するログの詳細度です。サポートを依頼する際は、これをDebug に設定してください。
Log Subfolder Scheme	選択した間隔に従って、コネクタがLogs フォルダ内のファイルをグループ化するよう指示します。Weekly オプション（デフォルト）は、コネクタが毎週新しいサブフォルダを作成し、その週のすべてのログをそのフォルダに保存するよう指示します。この設定を空白のままにすると、コネクタはすべてのログをLogs フォルダに直接保存します。多数のトランザクションを処理するコネクタでは、サブフォルダを使用することでログを整理しやすくなり、パフォーマンスが向上します。
Log Messages	処理したファイルのログエントリにファイル自体のコピーを含めるには、これをオンにします。これを無効にすると、Transactions タブからファイルのコピーをダウンロードできなくなる場合があります。
ステータス	説明
進行中	実行が現在行われているか、別のインスタンスがスケジュールされた枠をロックしています。
アイドル	オートメーションは次のスケジュールされた実行を待機しています。
一時停止中	実行の失敗が繰り返された後、コネクタは[バックオフ](https://docs.arc.cdata.com/26.4/cloud/ja/connectors/connector-backoff.md)状態にあり、オートメーションサービスはこのコネクタをスキップしています。
無効	このコネクタのオートメーションはオフになっています。
フィールド	説明
日付	前回の実行のスケジュールされた時刻。
最後に処理された開始	コネクタが前回の実行の処理を実際に開始した時刻。スケジュールされた時刻よりわずかに遅れる場合があります。
最後に処理された結果	前回の実行の結果：成功：実行が完了し、データが処理されました。データなし：実行は完了しましたが、クエリが行を返さなかった場合など、処理するものがありませんでした。失敗：実行が完了しませんでした。
最後に成功した日時	直近で成功した実行の日時。このフィールドは、前回の実行が失敗した場合またはデータなしだった場合に表示され、コネクタが成功した実行なしでどれくらい経過しているかを確認できます。