XML Group 端口

XML Group 端口處理相關 XML 記錄集合，並按列對其進行分組，以實現高效的資料管理和分析。

核心功能

支援層級 XML 記錄分組與聚合，可按鍵分組並使用多個分組鍵
支援透過 XPath 識別並執行 MIN、MAX、SUM、AVG、COUNT 和 CONCATENATE 等聚合函式
在新增彙總和分組元素的同時保留原始記錄結構

概觀

XML Group 端口透過聚合、驗證和轉換結構化資料來處理相關 XML 記錄集合，以便與各種系統無縫整合。它能夠高效處理層級 XML 資料，確保資料交換、報告和自動化工作流程等應用之間的一致性和互操作性。

端口配置

本節包含所有可配置的端口屬性。

組配置索引標籤

與配置組相關的設定。

範例檔案

使用 範例檔案 切換按鈕指定範例檔案，使端口能夠提供有關文件的更多上下文。有關更多資訊，請參閱使用範例檔案。

設定	說明
範例檔案	選擇現有範例檔案，或上傳新檔案。

迴圈設定

與端口應使用的 XPath 相關的設定，該 XPath 表示輸入文件中的單條記錄；同時還包括用於儲存每組相關記錄的 XML 元素。

設定	說明
元素名稱	輸出檔案中用於分組的 XML 元素名稱。
記錄 XPath	輸入中的哪個 XPath 應代表單條記錄。

分組設定

定義每條記錄中哪些元素用於確定每個組鍵值的設定。有關更多資訊，請參閱使用分組設定。

設定	說明
元素名稱	告訴端口在輸出檔案中用於分組的 XML 元素應命名為什麼。這通常與鍵 XPath 指向的輸入檔案元素名稱相同，但也可以使用不同名稱。
鍵 XPath	輸入檔案中要用作 key（分組依據）的元素的 XPath。鍵 XPath 相對於記錄 XPath。
新增鍵 XPath	點選此按鈕以定義其他鍵。

聚合設定

使用 聚合設定 切換按鈕檢視用於定義如何彙總每個組中記錄的設定。有關更多資訊，請參閱使用聚合設定。

設定	說明
元素名稱	用於彙總記錄的 XPath 名稱。
函式	用作聚合的函式。可從 MIN、MAX、SUM、AVG、COUNT 和 CONCATENATE 中選擇。
XPath	要聚合的元素的相對 XPath。
新增聚合 XPath	點選此按鈕以新增更多聚合 XPath。

排序依據設定

使用 排序依據 切換按鈕檢視用於定義如何對每個組中的記錄進行排序的設定。

設定	說明
XPath	用於排序的元素的相對 XPath。
排序依據	按升序還是降序排序。
新增排序依據 XPath	點選此按鈕以新增更多用於排序的 XPath。

設定索引標籤

配置

與建立連線相關的設定。

自動化索引標籤

自動化設定

與端口自動處理檔案相關的設定。

設定	說明
傳送	勾選此項，使端口在組準備就緒後自動傳送。

效能

警示索引標籤

SLA 索引標籤

進階選項卡

訊息

日誌

其他設定

設定	說明
處理延遲	放入交易索引標籤的檔案在處理前延遲的時間（秒）。這是一箇舊版設定。最佳實踐是使用 File 端口來管理本地檔案系統，而不是使用此設定。

雜項

使用範例檔案

開啟 範例檔案 以上傳一個範例輸入 XML，該 XML 模擬將傳遞到端口中的 XML 輸入。啟用後，它會為 UI 中的每個 XPath 欄位提供 XPath 助手，從而更容易檢視文件結構並選擇正確的 XPath。根據 XPath 在端口中代表的內容，只能點選符合條件的 XML 元素。例如，在 迴圈設定 中，只能選擇父元素，因為期望這些元素代表一條記錄。

然後，在 分組設定 中，可見元素是 迴圈設定 父元素的子元素，因為期望 key 元素是父記錄的子元素。

使用分組設定

分組設定定義每條記錄中用於確定每個組鍵值的元素。鍵通常是 Id 值，例如 CustomerID 或 InvoiceID。可以有多個鍵，它們會作為迴圈設定中設定的元素名稱和 XPath 的子項出現。

元素名稱 告訴端口在輸出檔案中用於分組的 XML 元素應命名為什麼。這通常與鍵 XPath 指向的輸入檔案元素名稱相同，但也可以使用不同名稱。
鍵 XPath 是輸入檔案中要用作 key（分組依據）的元素的 XPath。鍵 XPath 相對於 記錄 XPath。

例如，在以下 XML 中，<MaterialCode> 元素是鍵。這樣就可以在輸出中將 ALPHA、BRAVO 和 CHARLIE 的所有出現項分組在一起，而不是分別出現多個重複項。

<Items>
    <Invoice>
        <InvoiceDetail>
            <MaterialCode>ALPHA</MaterialCode>
            <MaterialCodeDescription>Alpha Materials</MaterialCodeDescription>
            <NetAmount>1000.00</NetAmount>
        </InvoiceDetail>
        <InvoiceDetail>
            <MaterialCode>ALPHA</MaterialCode>
            <MaterialCodeDescription>Alpha Materials</MaterialCodeDescription>
            <NetAmount>2000.00</NetAmount>
        </InvoiceDetail>
        <InvoiceDetail>
            <MaterialCode>BRAVO</MaterialCode>
            <MaterialCodeDescription>Bravo Materials</MaterialCodeDescription>
            <NetAmount>100.00</NetAmount>
        </InvoiceDetail>
        <InvoiceDetail>
            <MaterialCode>CHARLIE</MaterialCode>
            <MaterialCodeDescription>Charlie Materials</MaterialCodeDescription>
            <NetAmount>500.00</NetAmount>
        </InvoiceDetail>
        <InvoiceDetail>
            <MaterialCode>CHARLIE</MaterialCode>
            <MaterialCodeDescription>Charlie Materials</MaterialCodeDescription>
            <NetAmount>100.00</NetAmount>
        </InvoiceDetail>
    </Invoice>
</Items>

使用聚合設定

聚合設定控制端口應如何聚合資料。可以定義一個 XPath，其中包含要執行操作運算子（MIN、MAX、SUM、AVG、COUNT、CONCATENATE）的值，然後端口會對組中的所有記錄執行該運算子。一個常見範例是對每條記錄的價格求和。以下範例使用前面圖片中描述的 迴圈設定 和 分組設定，以及以下 聚合設定：

使用上一節中的 XML 會生成一個輸出 XML，其中每個鍵元素（MaterialCode）都有一個 InvoiceDetailGroup。每個 InvoiceDetailGroup 內都有來自 分組設定 的 MaterialCode 鍵，以及來自 聚合設定 的計算結果 NetAmountSUM。最後，還會包含原始的 InvoiceDetail 元素及其子元素：

<Items>
  <Invoice>
    <InvoiceDetailGroup>
      <MaterialCode>ALPHA</MaterialCode>
      <NetAmountSUM>3000</NetAmountSUM>
      <InvoiceDetail>
        <MaterialCode>ALPHA</MaterialCode>
        <MaterialCodeDescription>Alpha Materials</MaterialCodeDescription>
        <NetAmount>1000.00</NetAmount>
      </InvoiceDetail>
      <InvoiceDetail>
        <MaterialCode>ALPHA</MaterialCode>
        <MaterialCodeDescription>Alpha Materials</MaterialCodeDescription>
        <NetAmount>2000.00</NetAmount>
      </InvoiceDetail>
    </InvoiceDetailGroup>
    <InvoiceDetailGroup>
      <MaterialCode>BRAVO</MaterialCode>
      <NetAmountSUM>100.00</NetAmountSUM>
      <InvoiceDetail>
        <MaterialCode>BRAVO</MaterialCode>
        <MaterialCodeDescription>Bravo Materials</MaterialCodeDescription>
        <NetAmount>100.00</NetAmount>
      </InvoiceDetail>
    </InvoiceDetailGroup>
    <InvoiceDetailGroup>
      <MaterialCode>CHARLIE</MaterialCode>
      <NetAmountSUM>600</NetAmountSUM>
      <InvoiceDetail>
        <MaterialCode>CHARLIE</MaterialCode>
        <MaterialCodeDescription>Charlie Materials</MaterialCodeDescription>
        <NetAmount>500.00</NetAmount>
      </InvoiceDetail>
      <InvoiceDetail>
        <MaterialCode>CHARLIE</MaterialCode>
        <MaterialCodeDescription>Charlie Materials</MaterialCodeDescription>
        <NetAmount>100.00</NetAmount>
      </InvoiceDetail>
    </InvoiceDetailGroup>
  </Invoice>
</Items>

由於關聯記錄已作為鍵的巢狀子項存在，而不是扁平結構，因此當此 XML 進入 XML Map 端口時更易於處理。

入門指南

工作流

EDI 交易夥伴管理控制台

端口

對映

系統 API

操作指南

腳本編寫

軟體許可和第三方版權

核心功能

概觀

端口配置

組配置索引標籤

範例檔案

迴圈設定

分組設定

聚合設定

排序依據設定

設定索引標籤

配置

自動化索引標籤

自動化設定

效能

警示索引標籤

SLA 索引標籤

進階選項卡

訊息

日誌

其他設定

雜項

使用範例檔案

使用分組設定

使用聚合設定

宏

範例

​核心功能

​概觀

​端口配置

​組配置索引標籤

​範例檔案

​迴圈設定

​分組設定

​聚合設定

​排序依據設定

​設定索引標籤

​配置

​自動化索引標籤

​自動化設定

​效能

​警示索引標籤

​SLA 索引標籤

​進階選項卡

​訊息

​日誌

​其他設定

​雜項

​使用範例檔案

​使用分組設定

​使用聚合設定

​宏

​範例

核心功能

概觀

端口配置

組配置索引標籤

範例檔案

迴圈設定

分組設定

聚合設定

排序依據設定

設定索引標籤

配置

自動化索引標籤

自動化設定

效能

警示索引標籤

SLA 索引標籤

進階選項卡

訊息

日誌

其他設定

雜項

使用範例檔案

使用分組設定

使用聚合設定

宏

範例