> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SAP IDoc Translate

> 使用知行之橋SAP IDoc 端口配置 IDoc 到 XML 以及 XML 到 IDoc 的轉換。

## 端口配置

將 IDoc 轉換為 XML 或將 XML 轉換為 IDoc 時，可以使用以下設定。

#### 控制記錄資訊選項

當將 IDoc 檔案轉換為 XML，或將 XML 檔案轉換為 IDoc 時，你可能希望在不更改 IDoc 檔案資料的情況下更改控制記錄資訊。有關詳細資訊，請參閱[向 SAP 傳送 IDocs](./sap-idoc-send#sending-idocs-to-sap)。

要覆蓋 IDoc 檔案的控制頭，請選中**覆蓋**，然後更改以下選項。

| 設定                     | 說明                    |
| ---------------------- | --------------------- |
| **SAP 版本 (DOCREL)**    | IDOC 的 SAP 版本。        |
| **測試標誌 (TEST)**        | 指示 IDoc 是否應處於測試模式的標誌。 |
| **傳送方端口 (SNDPOR)**     | 傳送方端口（SAP 系統或外部子系統）。  |
| **傳送方合作伙伴編號 (SNDPRN)** | 傳送方的合作伙伴編號。           |
| **傳送方合作伙伴型別 (SNDPRT)** | 傳送方的合作伙伴型別。           |
| **傳送方合作伙伴功能 (SNDPFC)** | 傳送方的合作伙伴功能。           |
| **傳送方地址 (SNDSAD)**     | 傳送方的地址。               |
| **邏輯地址 (SNDLAD)**      | 傳送方的邏輯地址。             |
| **接收方端口 (RCVPOR)**     | 接收方端口。                |
| **接收方合作伙伴編號 (RCVPRN)** | 接收方的合作伙伴編號。           |
| **接收方合作伙伴型別 (RCFPRT)** | 接收方的合作伙伴型別。           |
| **接收方合作伙伴功能 (RCVPFC)** | 接收方的合作伙伴功能。           |
| **接收方地址 (RVCSAD)**     | 接收方的地址。               |
| **接收方邏輯地址 (RCVLAD)**   | 接收方的邏輯地址。             |
| **使用系統日期/時間**          | 是否在控制記錄資訊中包含系統日期/時間。  |

#### 進階設定

*不包含在上述類別中的設定。*

| 設定         | 說明                                                                                                                                   |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **延遲處理**   | 放置在 **交易**索引標籤中的檔案的處理將延遲的時間（秒）。這是舊版設定。最佳做法是[使用 File 端口](./Designing-a-Flow#interacting-with-the-local-file-system)管理本地檔案系統，而不是使用此設定。 |
| **重新整理範本** | 啟用後，端口會在發生解析錯誤時嘗試更新其用於解析的範本。端口會連線 SAP 系統並查詢相應範本來執行更新。                                                                                |
| **本地檔名格式** | 用於為端口輸出的訊息分配檔名的方案。可以在檔名中動態使用宏來包含識別碼和時間戳等資訊。有關詳細資訊，請參閱[宏](#macros)。                                                                   |
| **上傳範本**   | 用於上傳範本並將其安裝在端口的架構資料夾中。如果範本已存在，系統會詢問是否要覆蓋它。                                                                                           |

#### 訊息

<Note>
  **儲存至 Sent 資料夾**和**Sent 資料夾方案**設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇**顯示成功路徑**，然後將成功路徑連線到[File 端口](../file)。
</Note>

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

#### 日誌

*控制日誌建立和儲存的設定。*

| 設定           | 說明                                                                                                                                                |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **日誌級別**     | 端口生成日誌的詳細程度。請求支援時，請將其設定為 **Debug**。                                                                                                               |
| **日誌子資料夾方案** | 指示端口根據所選時間間隔對 Logs 資料夾中的檔案進行分組。**每週**（Weekly）選項（預設值）指示端口每週建立一個新的子資料夾，並將該周的所有日誌儲存在其中。留空則指示端口將所有日誌直接儲存到 Logs 資料夾中。對於處理大量交易的端口，使用子資料夾有助於保持日誌有序並提升效能。 |
| **日誌訊息**     | 選中此項可讓已處理檔案的日誌項目包含該檔案本身的副本。如果停用此項，可能無法從**交易**索引標籤 下載檔案副本。                                                                                         |

#### 其他設定

*其他設定適用於特定用例。*

| 設定       | 說明                                                                             |
| -------- | ------------------------------------------------------------------------------ |
| **其他設定** | 允許以分號分隔的清單配置隱藏的端口設定（例如 `setting1=value1;setting2=value2`）。正常的端口用例和功能不需要使用這些設定。 |

## 無需連線到 SAP 即可進行轉換

可以透過使用[進階設定](#進階設定)中的**上傳範本**選項，將附加文件範本上傳到端口，在沒有直接連線 SAP 的情況下將 IDoc 轉換為 XML，反之亦然。該範本包含基礎範本的所有元素。

要從 SAP 下載範本：

* 在 SAP 中，找到 TCODE 為 `WE60` 的文件交易。
* 如果你的 IDoc 型別是基本型別，請選擇**基本型別**選項按鈕。否則，選擇**增強**。
* 單擊**文件**功能表並選擇 **XML 模式**。
* 從 **XML** 功能表中，選擇**下載**。
* 將下載的檔案另存新檔 `${IDocType}.xsd`（例如 `SHPMNT05.xsd`）。
* 使用**上傳範本**將該檔案上傳到端口。