Skip to main content
CSV 端口可以將逗號分隔值 (CSV) 檔案轉換為 XML,也可以從 XML 生成 CSV 檔案。

核心功能

  • 支援 CSV/XML 雙向轉換,具有可配置的分隔符號和編碼
  • 具有標頭檢測和自定義列對映能力
  • 支援各種字元編碼和特殊字元處理

概覽

端口配置

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

設定

配置

與端口 Id 和描述相關的設定。

端口設定

與端口核心操作相關的設定。

其他設定

未包含在先前類別中的設定。

範例檔案索引標籤

高階頁面 (Advanced Tab)

訊息

日誌

其他設定

自動化頁面 (Automation Tab)

自動化設定

效能

通知索引標籤

SLA 索引標籤

將 CSV 轉換為 XML

檔案轉換為 XML,得到的 XML 將包含以下結構:
原始檔案中的每一行(記錄)都成為根元素 Items 的子元素。所有記錄元素的名稱由端口設定中設定的 記錄名稱 選項確定。每個記錄元素都有與輸入檔案每行中的值相對應的子元素。 某些 檔案包含一行訊息頭資訊,為檔案中的值提供上下文。當啟用 存在列標題 設定時,將解析此標題行,並將解析後的標題用作值元素(記錄元素的子元素)的元素名稱。否則,值元素將被賦予通用名稱,例如 field_0field_1 等。

將 XML 轉換為 CSV

要將 XML 轉換為 檔案,輸入 XML 必須具有“平面”結構。這意味著,忽略 Items 根元素,XML 結構的深度為 2。例如:
XML 解釋如下:
  • 根元素的子元素在結果檔案中被視為記錄(行)
  • 每個記錄元素的子元素被視為每行中的值
如果啟用 存在列標題 選項,則會將標題行插入到生成的 檔案中,其中包含每個值元素的名稱,以提供值的上下文。在上面的範例中,此標題行將由 titleyearruntime 組成。

列印檢視

CSV 轉換:使用 XML Map 端口

CSV 運算器

除了知行之橋提供的操作之外,端口還可以提供將功能擴充套件到 ArcScript 中的操作。 這些端口操作可以像任何其他 ArcScript 操作一樣呼叫,但有兩個細節除外:
  1. 它們必須透過 connector.rsc 端點呼叫。
  2. 它們必須包含認證權杖。
例如,使用這兩條規則呼叫端口操作可能如下所示:
下面列出了 CSV 端口功能特定的操作。

csvListRecords

迴圈遍歷指定 CSV 檔案或字串中的每條記錄。有關更多詳細資訊,請參閱函式

必需參數

  • file: CSV 檔案的路徑。

可選參數

  • data: 如果 CSV 資料以字串形式存在,而不是儲存在 CSV 檔案中,請使用此參數代替 file
  • columns: 輸出中要包含的列的逗號分隔清單(如果未指定,將包含所有列)。
  • requireheader: 預設情況下,資料的第一行會被解釋為列標題;向此參數傳入 false 時,將使用通用列名(例如 c1、c2、c3)。

輸出

csvListRecords 操作中的任何指令碼都會執行多次:對輸入 CSV 檔案/資料中的每條記錄/行執行一次。在操作中,可以使用 csv 格式化器存取各個 CSV 值。此格式化器將列名作為參數,並輸出當前記錄中該列的值。 例如,假設 CSV 輸入資料包含訂單中購買的一組商品,商品名稱儲存在 ItemName 列中。以下指令碼生成 XML,在 Item 元素中包含每個 ItemName 值:

範例