> ## 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. # XML Group Connector > Group and aggregate collections of related XML records by key fields, with support for MIN, MAX, SUM, AVG, COUNT, and CONCATENATE functions. export const NameDescription = ({extraRows}) => {extraRows}
設定 説明
Connector Id コネクタの静的で一意の識別子です。
Connector Type コネクタ名とその機能の説明を表示します。
Connector Description コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。
; 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（必須）を入力します。Allow {siteNameShort}Script in Subject をチェックすると、Subject フィールドで{siteNameShort}Script を使用できます。これを選択すると、{siteNameShort}Script エディタボタンが表示されます（arcscript editor button）。

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

; 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 MacrosExamples = ({extraMacros = []}) => <>

%Ext% や %ShortDate% などの一部のマクロは引数を必要としませんが、引数を必要とするものもあります。 引数を取るすべてのマクロは次の構文を使用します。%Macro:argument%

引数を取るマクロの例を次に示します。

次の例に示すように、より高度なマクロを作成することもできます。

; export const MacrosTable = ({siteName = "CData Arc", extraMacros = []}) => <>

ファイル命名戦略でマクロを使用すると、データの整理効率と文脈の理解を高めることができます。 ファイル名にマクロを組み込むことで、識別子、タイムスタンプ、ヘッダー情報などの関連情報を 動的に含めることができ、各ファイルに有用な文脈を提供します。

{siteName} は次のマクロをサポートしています。これらはすべて次の構文を使用します。%Macro%

{extraMacros.map(item => )}
マクロ説明
ConnectorIDコネクタのConnectorID に評価されます。
ConnectorNameコネクタの名前に評価されます。ファイル名やパスに接続名を含めることができます。例えば、どのデータベース接続が生成したかによってバックアップファイルにタグを付けるために使用できます。
Extコネクタが現在処理しているファイルの拡張子に評価されます。
Filenameコネクタが現在処理しているファイルのファイル名（拡張子を含む）に評価されます。
FilenameNoExtコネクタが現在処理しているファイルのファイル名（拡張子を除く）に評価されます。
MessageIdコネクタが出力しているメッセージのMessageId に評価されます。
RegexFilename:patternコネクタが現在処理しているファイルのファイル名に正規表現パターンを適用します。
Header:headernameコネクタが現在処理しているメッセージ上の対象ヘッダー（headername）の値に評価されます。
LongDateシステムの現在の日時を長い形式（例：Wednesday, January 24, 2024）で評価します。
ShortDateシステムの現在の日時をyyyy-MM-dd 形式（例：2024-01-24）で評価します。
DateFormat:formatシステムの現在の日時を指定された形式（format）で評価します。利用可能な日時形式については、日付形式のサンプルを参照してください。
Vault:vaultitem指定されたVault アイテムの値に評価されます。
{item.name} {item.description}
; export const Performance = () => <>

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

設定 説明
Max Workers このコネクタでファイルを処理するためにスレッドプールから消費されるワーカースレッドの最大数です。設定すると、Advanced Settings ページのPerformance Settings 部分にあるデフォルト設定が上書きされます。
Max Files コネクタに割り当てられた各スレッドが送信するファイルの最大数です。設定すると、Advanced Settings ページのPerformance Settings 部分にあるデフォルト設定が上書きされます。
; export const siteNameShort = "Arc"; export const siteName = "CData Arc"; The XML Group connector processes collections of related XML records, grouping them by columns for efficient data management and analysis. ## Key Capabilities * Hierarchical XML record grouping and aggregation with key-based grouping and multiple grouping keys * Aggregate function support (MIN, MAX, SUM, AVG, COUNT, and CONCATENATE) with XPath-based identification * Preserves original record structure while adding summary and grouping elements ## Overview The XML Group connector processes collections of related XML records by aggregating, validating, and transforming structured data for seamless integration with various systems. It enables efficient handling of hierarchical XML data, ensuring consistency and interoperability across applications such as data exchange, reporting, and automated workflows. ## Connector Configuration This section contains all of the configurable connector properties. ### Group Config Tab *Settings related to configuring the group.* #### Sample File *Use the **Sample File** toggle to specify a sample file that allows the connector to provide more context about the document. See [Using Sample Files](#using-sample-files) for more information.* | Setting | Description | | --------------- | ---------------------------------------------------- | | **Sample File** | Select an existing sample file, or upload a new one. | #### Loop Settings *Settings related to the XPath the connector should use to represent a single record in the input document, as well as the XML element to use to hold each group of related records.* | Setting | Description | | ---------------- | ----------------------------------------------------------------------- | | **Element Name** | The name of the XML element to use for the grouping in the output file. | | **Record XPath** | Which XPath from the input should represent a single record. | #### Group Settings *Settings that define which elements in each record to use to determine the key for each group. See [Using Group Settings](#using-group-settings) for more information.* | Setting | Description | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Element Name** | Tells the connector what to name the XML element to use for grouping in the output file. This is usually the same name as the element in the input file that the Key XPath points to, but you can use a different name. | | **Key XPath** | The XPath from the input file of the element to use as the *key* (what you want to group by). The **Key XPath** is relative to the **Record XPath**. | | **Add Key XPath** | Click this button to define additional keys. | #### Summary Settings *Use the **Summary Settings** toggle to see the settings that define how to summarize the records in each group. See [Using Summary Settings](#using-summary-settings) for more information.* | Setting | Description | | ----------------------- | --------------------------------------------------------------------------------------------- | | **Element Name** | The name of the XPath to use to summarize the records. | | **Function** | The function to use as the aggregate. Choose from MIN, MAX, SUM, AVG, COUNT, and CONCATENATE. | | **XPath** | The relative XPath to the element to aggregate. | | **Add Aggregate XPath** | Click this button to add more aggregate XPaths. | #### Order By Settings *Use the **Order By** toggle to see the settings that define how to sort the records in each group.* | Setting | Description | | ---------------------- | ------------------------------------------------- | | **XPath** | The relative XPath to the element to sort by. | | **Order By** | Whether to sort in ascending or descending order. | | **Add Order By XPath** | Click this button to add more XPaths to sort by. | ### Settings Tab #### Configuration *Settings related to establishing the connection.* ### Automation Tab #### Automation Settings *Settings related to the automatic processing of files by the connector.* | Setting | Description | | -------- | ------------------------------------------------------------------------------- | | **Send** | Check this to have the connector automatically send groups when they are ready. | #### Performance ### Alerts Tab ### SLAs Tab ### Advanced Tab #### Logging #### 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](../flows/designing-a-flow#ローカルファイルシステムとのやり取り) to manage local file systems instead of this setting. | #### Miscellaneous ## Using Sample Files Toggle **Sample File** on to upload a sample input XML that mimics the XML input that is going to be passed into the connector. When enabled, it provides XPath helpers for each of the XPath fields in the UI, so it becomes easier to see the document structure and select the correct XPath. You can only click eligible XML elements, based on what the XPath is representing for the connector. For example, in **Loop Settings**, you can only select parent elements because {siteNameShort} expects that those elements are what represent a *record*. Then, in **Group Settings**, the visible elements are the child elements of the **Loop Settings** parent element because {siteNameShort} expects the *key* element to be a child of the parent record. ## Using Group Settings Group settings define the elements in each record to use to determine the key for each group. The key is usually an `Id` value such as `CustomerID` or `InvoiceID`. You can have multiple keys, which appear as children of the element name and xpath set in [Loop Settings](#loop-settings). * **Element Name** tells the connector what to name the XML element to use for grouping in the output file. This is usually the same name as the element in the input file that the Key XPath points to, but you can use a different name. * **Key XPath** is the XPath from the input file of the element to use as the *key* (what you want to group by). The **Key XPath** is relative to the **Record XPath**. For example, in the following XML, the `` element is the key. This lets you group all occurrences of `ALPHA`, `BRAVO` and `CHARLIE` together in the output, instead of having multiples of each. ```xml theme={null} ALPHA Alpha Materials 1000.00 ALPHA Alpha Materials 2000.00 BRAVO Bravo Materials 100.00 CHARLIE Charlie Materials 500.00 CHARLIE Charlie Materials 100.00 ``` ## Using Summary Settings Summary settings control how the connector should aggregate data. You can define an XPath containing a value that you want to perform an action operator on (MIN, MAX, SUM, AVG, COUNT, CONCATENATE), and the connector then performs that operator on all records in a group. A common example is to SUM the price of each record. The following example uses the **Loop Settings** and **Group Settings** described in the previous images, along with the following **Summary Settings**: Using the XML in the previous section results in an output XML with a `InvoiceDetailGroup` for each key element (the `MaterialCode`). Inside each `InvoiceDetailGroup` is the `MaterialCode` key from the **Group Settings**, and the calculated `NetAmountSUM` from the **Summary Settings**. Finally, the original `InvoiceDetail` elements and their children are included: ```xml theme={null} ALPHA 3000 ALPHA Alpha Materials 1000.00 ALPHA Alpha Materials 2000.00 BRAVO 100.00 BRAVO Bravo Materials 100.00 CHARLIE 600 CHARLIE Charlie Materials 500.00 CHARLIE Charlie Materials 100.00 ``` Because you already have the associated records as nested children of the key, instead of in a flat structure, this XML is easier to work with when it goes to an [XML Map](./xml-map/xml-map) connector. ## Macros ### Examples