CSV Map 端口

CSV Map 端口使用 ArcScript 將平面 XML 檔案轉換為 CSV、TSV 和 PSV 檔案格式。平面 XML 檔案是指除根元素之外深度不超過兩層的檔案。

核心功能

使用 ArcScript 範本將扁平 XML 檔案轉換為 CSV、TSV 和 PSV 格式
提供用於簡單對映的視覺化設計器（支援欄位自動匹配），併為複雜轉換提供程式碼檢視
支援透過 XPath 導航從巢狀 XML 結構中提取值，並具備動態範本生成功能

概覽

CSV Map 端口有兩種操作模式，視覺化設計器和以指令碼為中心的指令碼。設計器支援在文件型別之間視覺化地建立簡單的關係。更復雜的翻譯需要指令碼，指令碼利用強大的 ArcScript 指令碼語言在 XML 和平面檔案結構之間建立對映範本。首先，在”設定”索引標籤中上傳一個範例來源檔案和目的檔案。如果兩個範例檔案的結構都允許設計器驅動的對映，則視覺化設計器將填充源和目標欄位。該應用程式還將嘗試用儘可能多的目標結構填充指令碼視窗。

端口配置

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

對映索引標籤

上傳檔案以啟動源欄位和目標欄位的設計驅動對映。 點選 上傳檔案，然後選擇您的來源檔案和目的檔案。

來源檔案 代表輸入文件的 XML 結構。端口處理的任何檔案都應具有匹配的 XML 結構。要支援設計驅動對映，此檔案必須是簡單的 XML、CSV、PSV 或 TSV 結構。
目的檔案 代表輸出文件的結構。要使用設計驅動對映，此檔案必須是簡單的 XML、CSV、PSV 或 TSV 結構。

對映

定義輸入和輸出檔案之間的對映關係。設計器檢視可以對映簡單的 XML、CSV、TSV 和 PSV 結構，而指令碼檢視可以對映更復雜的 XML 結構。有關更多詳細資訊，請參見使用設計器和使用指令碼檢視。

設定索引標籤

端口配置

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

設定	描述
端口 Id	端口的靜態、唯一識別碼。
端口型別	顯示端口型別及其用途的描述。
端口描述	一個可選欄位，用於提供端口及其在流中的角色的自由格式描述。

進階設定

設定	描述
處理延遲	交易索引標籤中檔案的處理延遲時間（秒）。這是一個遺留設定。最佳實踐是使用檔案端口來管理本地檔案系統，而不是使用此設定。
本地檔名格式	為端口輸出的訊息分配檔名的方案。可以在檔名中動態使用宏來包含識別碼和時間戳等資訊。有關更多資訊，請參閱宏。

訊息

訊息設定確定端口如何搜尋訊息並在處理後管理它們。

注意：以下設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇顯示成功路徑，然後將成功路徑連線到 File 端口。

設定	描述
儲存到已傳送資料夾（已棄用）	將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。
已傳送資料夾方案（已棄用）	按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。

日誌

用於管理日誌建立和儲存的設定。

設定	描述
日誌級別	指定要記錄在端口日誌目錄中的資訊型別： None - 不建立任何日誌。 Error - 僅當端口遇到錯誤時才建立日誌。 Warning - 僅當端口發出警告時才建立日誌。 Info - 記錄工作流程的一般資訊，包括任何錯誤和警告（如果適用）。 Debug - 記錄成功和失敗工作流程的詳細偵錯資訊。 Trace - 記錄成功和失敗工作流程的詳細跟蹤資訊。請注意：Debug 和 Trace 級別的日誌可能會記錄敏感資訊，包括訊息內容和 SSL 憑證。儘管連線屬性（例如密碼）被遮蔽了，但在與您的組織外部共享它們之前，請檢視此級別的日誌以避免洩漏敏感資訊。
日誌資料夾結構	指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如，Weekly 選項指示端口每週建立一個新的子資料夾，並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口，使用子資料夾有助於保持日誌的有序性並提高效能。
保留訊息副本	指示端口在日誌目錄中儲存最新訊息副本的切換。請注意，端口每個子資料夾只保留一個訊息，並且端口在再次執行時會覆蓋以前儲存的訊息。

其他

特殊設定適用於特定用例。

設定	描述
其他設定	允許在以分號分隔的清單中配置隱藏的端口設定，例如 `setting1=value1;setting2=value2`。正常的端口用例和功能不需要使用這些設定。

自動化索引標籤

自動化

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

設定	描述
傳送	到達端口的訊息是否會被自動處理。

效能

與端口資源分配相關的設定。

設定	描述
最大工作執行緒數	此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定，則會覆蓋進階設定頁面的效能設定部分的預設設定。
最大檔案數	分配給端口的每個執行緒傳送的最大檔案數。如果設定，則會覆蓋進階設定頁面的效能設定部分的預設設定。

通知索引標籤

SLA 索引標籤

使用設計器

視覺化設計器僅適用於結構簡單的 XML、CSV、TSV 和 PSV 檔案。下面是一個簡單的 XML 文件作為來源檔案的例子：

<actor table="actor">
  <actor_id key="true">124455</actor_id>
  <first_name>Bob</first_name>
  <last_name>Smith</last_name>
</actor>

此範例來源檔案可以與以下 CSV 文件配對作為目的檔案：

id,first name,last name,time
124455,Bob,Smith,2017-07-18T17:38:53-04:00

當這些檔案被配置為來源檔案和目的檔案時，設計器將在源列中顯示來源檔案中每一行的行（actor_id, first_name,和 last_name）。對於源中的每個欄位，使用下拉功能表選擇適當的目標列。應用程式將根據列名自動嘗試匹配源欄位和目標欄位。在上面的範例中，actor_id 行將自動與 id 列匹配。

使用指令碼檢視

指令碼檢視提供了使用 ArcScript 手動生成對映範本的能力。這允許對可能的輸入和輸出格式進行更精細的控制。指令碼檢視定義了目的檔案呈現後的外觀，ArcScript 元素使用源文件中的值動態填充範本。ArcScript 元素都以 arc 字首開頭，例如 <arc:set>。指令碼檢視中任何不是 ArcScript 的內容都將作為輸出檔案的一部分。

導航 XML 輸出

ArcScript 支援導航複雜的 XML 結構，以便從來源檔案中解析出值。xmlDOMSearch 函式將 xpath 作為輸入，並在給定的路徑上載入 XML 結構。該操作針對在源文件中找到的 xpath 的每個例項進行迴圈；要載入整個文件並避免迴圈，請將 XML 源的根元素作為輸入提供給 xmlDOMSearch。例如：

<arc:call op=xmlDOMSearch?xpath=/root>
  <!-- Inside this operation call the parsed XML elements can be accessed -->
</arc:call>

一旦載入了 XML 文件，xpath 格式化器支援在指定的路徑從 XML 中讀取值。格式化器接受絕對 XPath 以及相對於 xmlDOMSearch 載入的路徑的 XPath。與所有格式化器一樣，xpath 格式化器只能在方括號 [] 內使用。例如：

<arc:call op="xmlDOMSearch?xpath=/root/author">
  [xpath('name')]
</arc:call>

以下 XML 作為上述指令碼的範例輸入：

<root>
  <author>
    <name>Stephen King</name>
  </author>
  <author>
    <name>Kurt Vonnegut</name>
  </author>
</root>

在本例中，xmlDOMSearch 操作將迴圈存取 root 中的每個 author 元素。在每個 author 迴圈中，來自 name 元素的值在輸出檔案中作為內容讀取。這種情況下的輸出檔案如下所示：

Stephen King
Kurt Vonnegut

範本輸出資料

指令碼檢視用作輸出檔案的範本，而 ArcScript 將值填充到定義的範本中。舉個簡單的例子，如果資料應該被格式化為逗號分隔的值，那麼這些逗號可以作為指令碼檢視的一部分被包括進來，以便為 ArcScript 函式提供結構。因此，CSV 檔案可以從更復雜的 XML 結構中生成。以下面的 XML 為例，它包含巢狀元素，不適合使用設計器方式：

<actor table="actor">
  <actor_id key="true">12445</actor_id>
  <name>
    <first_name>Viggo</first_name>
    <last_name>Mortensen</last_name>
  </name>
  <actor_id key="true">12522</actor_id>
  <name>
    <first_name>Gal</first_name>
    <last_name>Gadot</last_name>
  </name>
</actor>

透過將適當的路徑傳遞給 ArcScript 的 xpath 格式化器，可以輕鬆檢索巢狀元素。這些格式化器可以放在逗號內和標題名稱之後，以提供所需的 CSV 結構，並且一個附加的 csvescape 格式化器確保這些值被正確引用：

id,first name,last name
<arc:call op="xmlDOMSearch?xpath=actor">
[xpath('actor_id') | csvescape],[xpath('name/first_name') | csvescape],[xpath('name/last_name') | csvescape]
</arc:call>

透過常數範本資料和 ArcScript 的結合使用，可以生成各種文字檔案。

附加指令碼功能

由於完整的 ArcScript 在指令碼檢視中可用，因此可能需要利用 ArcScript 運算器。例如，如果來源檔案只包含資料庫中某個項的標識，但需要該項的實際名稱，則 dbQuery 操作可以用來查詢對應的 Id 的名稱。 ArcScript 還支援對映範本中的條件邏輯。arc:if 關鍵字是可用於幫助在範本中執行條件邏輯的關鍵字之一。例如，如果來源檔案包含有關 QuickBooks 中客戶的資訊，則可能需要對未清餘額的客戶執行不同的業務邏輯，對已全額付款的客戶執行不同的業務邏輯。這個用例的一個簡單範例可能如下所示：

<arc:set item="Customer" attr="paidinfull" value="true" />
<arc:call op="xmlDOMSearch?xpath=Customer">
  <arc:if exp="[xpath('balance')] > 0">
    <arc:set item="Customer" attr="paidinfull" value="false" />
  </arc:if>
</arc:call>
id,first name,last name, paid in full
[xpath('customer_id') | csvescape],[xpath('first_name') | csvescape],[xpath('last_name') | csvescape],[Customer.paidinfull]

入門指南

工作流

EDI 交易夥伴管理控制台

端口

對映

系統 API

操作指南

腳本編寫

軟體許可和第三方版權

核心功能

概覽

端口配置

對映索引標籤

對映

設定索引標籤

端口配置

進階設定

進階設定

訊息

日誌

其他

自動化索引標籤

自動化

效能

通知索引標籤

SLA 索引標籤

使用設計器

使用指令碼檢視

導航 XML 輸出

範本輸出資料

附加指令碼功能

宏

範例

​核心功能

​概覽

​端口配置

​對映索引標籤

​對映

​設定索引標籤

​端口配置

​進階設定

​進階設定

​訊息

​日誌

​其他

​自動化索引標籤

​自動化

​效能

​通知索引標籤

​SLA 索引標籤

​使用設計器

​使用指令碼檢視

​導航 XML 輸出

​範本輸出資料

​附加指令碼功能

​宏

​範例

核心功能

概覽

端口配置

對映索引標籤

對映

設定索引標籤

端口配置

進階設定

進階設定

訊息

日誌

其他

自動化索引標籤

自動化

效能

通知索引標籤

SLA 索引標籤

使用設計器

使用指令碼檢視

導航 XML 輸出

範本輸出資料

附加指令碼功能

宏

範例