> ## 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 Receive

> 使用知行之橋SAP IDoc 端口配置從 SAP 接收 IDoc 檔案。

## 端口配置

從 SAP 接收 IDoc 時，可以使用以下設定。

#### 接收設定

*關於接收 IDoc 檔案的設定。*

| 設定           | 說明                          |
| ------------ | --------------------------- |
| **IDoc 接收器** | 端口是否應從 SAP 檢索 IDoc 檔案。      |
| **程式 ID**    | 一個用於向 SAP 系統標識知行之橋的唯一名稱。    |
| **IDoc 格式**  | 是否以原始 IDoc 或 IDoc XML 接收檔案。 |

#### 進階設定

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

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

#### 伺服器狀態

*伺服器的狀態。*

| 狀態      | 描述                        |
| ------- | ------------------------- |
| **活動**  | 伺服器正在執行。點選**停止伺服器**可將其停止。 |
| **非活動** | 伺服器未執行。點選**啟動伺服器**可將其啟動。  |

要檢視伺服器執行期間生成的日誌，請參閱[日誌索引標籤](./sap-idoc#日誌索引標籤)。

#### 訊息

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

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

#### 日誌

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

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

#### 其他設定

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

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

## 從 SAP 接收 IDocs

配置 IDoc 端口以連線到 SAP 系統後，即可開始從 SAP 接收 IDoc 檔案。IDoc 端口可以接收原始 IDoc 或 XML IDoc 格式的檔案。

要從 SAP 接收檔案，請為知行之橋建立一個 RFC 目標。然後，可以在設定索引標籤 的[接收設定](#接收設定)部分勾選**啟用 IDoc 接收器**，並輸入你在 SAP 系統中為知行之橋註冊的**程式 ID**。

### 測試從 SAP 接收 IDoc

此範例介紹如何配置 SAP 系統，以便向知行之橋傳送 MATMAS IDoc。

1. *定義邏輯系統：* 首先，進入交易 SALE。然後導航到 基本設定 > 邏輯系統 > 定義邏輯系統。建立一個具有有效名稱（例如 Arc）和描述的新項目。

2. *建立 RFC 目標：* 開啟交易程式碼 SM59。單擊建立按鈕，並填寫下述 RFC 目標欄位。

   | 設定         | 說明                      |
   | ---------- | ----------------------- |
   | **RFC 目標** | 新目標的唯一名稱（例如 Arc\_DEST）。 |
   | **連線型別**   | **T** 表示 TCP/IP。        |
   | **描述**     | 目標的描述。                  |
   | **程式 ID**  | 將在知行之橋中設定的唯一名稱，用於標識該目標。 |
   | **啟用型別**   | 選擇**註冊伺服器程式**。          |

   <img src="https://mintcdn.com/qiao/3lMD3uYuGJqErRlJ/public/images/sap-rec-dest.png?fit=max&auto=format&n=3lMD3uYuGJqErRlJ&q=85&s=7a13058f676b738eb9d4e0977fd96868" alt="SAP RFC 目標設定" width="762" height="778" data-path="public/images/sap-rec-dest.png" />

   儲存設定後，測試連線以確保可以成功連線到知行之橋。

3. *建立處理端口：* 轉到交易程式碼 WE21。建立一個新的交易性 RFC 端口，使用唯一名稱以及你在步驟 2 中建立的同一目標。

   <img src="https://mintcdn.com/qiao/3lMD3uYuGJqErRlJ/public/images/sap-rec-connector.png?fit=max&auto=format&n=3lMD3uYuGJqErRlJ&q=85&s=7671ed7ecc05d03e42783fb178ef54e5" alt="SAP 接收端口設定" width="879" height="457" data-path="public/images/sap-rec-connector.png" />

4. *建立合作伙伴配置檔案：* 開啟交易 WE20。為步驟 1 中新增的邏輯系統建立一個合作伙伴配置檔案。接下來，為 MATMAS 文件新增一個出站參數。將**訊息型別**設定為 **MATMAS**。在**出站選項**索引標籤上，將**接收方端口**設定為步驟 3 中配置的端口值，將**輸出模式**設定為 **Transfer IDoc Immed**，並將 IDoc **基本型別**設定為 **MATMAS05**。

   <img src="https://mintcdn.com/qiao/3lMD3uYuGJqErRlJ/public/images/sap-rec-param.png?fit=max&auto=format&n=3lMD3uYuGJqErRlJ&q=85&s=a7ac1c1157e86af9fb760279f11599fe" alt="SAP 接收合作伙伴配置檔案設定" width="743" height="692" data-path="public/images/sap-rec-param.png" />

5. *傳送測試 IDoc：* 使用交易 BD10 向知行之橋傳送指定物料編號的測試 IDoc。傳送訊息之前，需要配置**訊息型別**和**邏輯系統**。使用交易 BD87 監控傳出訊息，並在必要時再次處理它們。
