SAP IDoc V1 端口（棄用） - 知行之桥文档

SAP IDoc 端口支援向各種 SAP 系統傳送 IDoc 檔案並從中接收 IDoc 檔案。它是一個資料容器，用於在 SAP 與能夠理解資料語法和語義的其他處理程序之間交換資訊。

概覽

IDoc 端口可以使用以下方法連線到 SAP： Windows

NetWeaver RFC SDK
Classic RFC SDK
支援 Unicode 的 Classic RFC SDK
SOAP（僅傳送）

Java

Java Connector (JCO)
SOAP（僅傳送）

IDoc 端口可以傳送和檢索原始 IDoc 或 IDoc XML 格式的檔案。

端口配置

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

設定索引標籤

主機配置

與建立 SAP 系統連線相關的設定。

設定	說明
端口 ID	端口的靜態唯一識別碼。
端口型別	顯示端口名稱及其功能說明。
端口描述	可選欄位，用於自由描述端口及其在工作流程中的作用。
連線型別	連線到 SAP 的方法。請參閱建立連線部分，瞭解你的方法對應的其他資訊。
SAP 主機	目標 SAP 系統的主機名或 IP 地址。
系統編號	用於定義目標 SAP 系統的編號。有效值為 0-99，通常應為 0。

用戶端身分驗證

與針對 SAP 系統進行身分驗證相關的設定。

設定	說明
用戶端	向 SAP 系統進行身分驗證的用戶端。
使用者	用於身分驗證的使用者名稱憑據。
密碼	指定使用者的密碼。

接收設定

與接收 IDoc 檔案相關的設定。

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

控制記錄資訊選項

本節允許你在將 IDoc 檔案傳送到 SAP 之前覆蓋 IDoc 檔案的控制頭。當從一個 SAP 系統接收 IDoc 檔案並將其傳送到另一個 SAP 系統時，這非常有用：在這種情況下，應在不更改 IDoc 檔案資料的情況下更改控制記錄。有關詳細資訊，請參閱向 SAP 傳送 IDocs。

進階選項卡

語言設定

與通訊語言相關的設定。

設定	說明
語言	連線到 SAP 系統時使用的語言值。將其設定為 SAP 系統所用語言的 ISO 639-1 值。

閘道器

與透過閘道器和 SAP 通訊相關的設定。

設定	說明
閘道器主機	要透過其連線的閘道器主機名或 IP 地址。
閘道器服務	要使用的閘道器服務。

登入負載平衡

與以組方式登入 SAP 系統以啟用負載平衡相關的設定。

設定	說明
訊息伺服器	負載平衡器的服務名稱。
系統 ID	標識 SAP 系統。
登入組	負載平衡時要使用的組。

安全網路通訊 (SNC)

與使用外部安全產品增強 SAP 連線安全性相關的設定。

設定	說明
SNC 名稱	發起連線的機器的 SNC 名稱。
SNC 夥伴名稱	端口所連線 SAP 系統的 SNC 名稱。
SNC 保護質量等級	SNC 產品增加的保護等級。
SNC 庫	外部安全產品庫的路徑。

進階設定

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

設定	說明
延遲處理	放置在交易索引標籤中的檔案的處理將延遲的時間（秒）。這是舊版設定。最佳做法是使用 File 端口管理本地檔案系統，而不是使用此設定。
重新整理範本	啟用後，端口會在發生解析錯誤時嘗試更新其用於解析的範本。端口會連線 SAP 系統並查詢相應範本來執行更新。

訊息

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

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

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

日誌

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

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

其他設定

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

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

自動化索引標籤

自動化設定

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

設定	說明
傳送	到達端口的檔案是否自動傳送。
重試間隔	傳送失敗後再次嘗試傳送之前的時間。
最大嘗試次數	傳送失敗後重試的最大次數。

效能

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

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

警示索引標籤

SLA 索引標籤

建立連線

使用 NetWeaver RFC SDK

必須將 NetWeaver RFC SDK 中的以下庫放入知行之橋的 www\bin\x64 資料夾（32 位作業系統上為 www\bin\x86）：

sapnwrfc.dll
icudt30.dll
icuin30.dll
icuuc30.dll
libicudecnumber.dll
libsapucum.dll

根據安裝的 SAP RFC SDK 版本，.dll 名稱可能不同。上面的範例適用於 3.0 版本。
需要將 sapgw00 服務新增到列出的服務中，NetWeaver SDK 連線才能在用戶端機器上工作。可以將其新增到 C:\Windows\System32\drivers\etc\services 中的 services 檔案。

使用 Classic RFC SDK

非 Unicode 庫除 librfc32.dll 外不需要其他內容。將 librfc32.dll 放入知行之橋的 www\bin\x64 資料夾（32 位作業系統上為 www\bin\x86）。

這些庫同時提供 x86 和 x64 版本，因此必須使用與處理程序相同的平臺。如果應用程式在 64 位 Windows 上執行，則該處理程序為 64 位。

使用支援 Unicode 的 Classic RFC SDK

必須將 SAP RFC SDK 中的以下庫放入知行之橋的 www\bin\x64 資料夾（32 位作業系統上為 www\bin\x86）：

librfc32u.dll
icudt30.dll
icuin30.dll
icuuc30.dll

根據安裝的 SAP RFC SDK 版本，.dll 名稱可能不同。上面的範例適用於 3.0 版本。
這些庫同時提供 x86 和 x64 版本，因此必須使用與處理程序相同的平臺。如果應用程式在 64 位 Windows 上執行，則該處理程序為 64 位。

使用 Java Connector

要使用 Java 端口，請將 sapjco3.jar 新增到 Java servlet 容器的 lib 資料夾中。

使用 SOAP

SOAP 只能用於向 SAP 傳送 IDoc。必須使用其他連線型別才能從 SAP 接收 IDoc。

這需要在 SAP 系統上啟用 SOAP 連線。

服務配置

除了上述依賴項外，還必須將以下服務新增到 %WINDIR%\system32\drivers\etc\services；如果系統執行 Linux 或 Mac OS X，則新增到 /etc/services。如果機器上已安裝 SAP NetWeaver，則無需進一步操作。

服務名稱	端口號/協議
sapdp00	3200/tcp
sapdp01	3201/tcp
sapdp02	3202/tcp
sapdp03	3203/tcp
sapdp04	3204/tcp
sapdp05	3205/tcp
sapdp06	3206/tcp
sapdp07	3207/tcp
sapdp08	3208/tcp
sapdp09	3209/tcp
sapdp10	3210/tcp
sapdp11	3211/tcp
sapdp12	3212/tcp
sapdp13	3213/tcp
sapdp14	3214/tcp
sapdp15	3215/tcp
sapdp16	3216/tcp
sapdp17	3217/tcp
sapdp18	3218/tcp
sapdp19	3219/tcp
sapdp20	3220/tcp
sapdp21	3221/tcp
sapdp22	3222/tcp
sapdp23	3223/tcp
sapdp24	3224/tcp
sapdp25	3225/tcp
sapdp26	3226/tcp
sapdp27	3227/tcp
sapdp28	3228/tcp
sapdp29	3229/tcp
sapdp30	3230/tcp
sapdp31	3231/tcp
sapdp32	3232/tcp
sapdp33	3233/tcp
sapdp34	3234/tcp
sapdp35	3235/tcp
sapdp36	3236/tcp
sapdp37	3237/tcp
sapdp38	3238/tcp
sapdp39	3239/tcp
sapdp40	3240/tcp
sapdp41	3241/tcp
sapdp42	3242/tcp
sapdp43	3243/tcp
sapdp44	3244/tcp
sapdp45	3245/tcp
sapdp46	3246/tcp
sapdp47	3247/tcp
sapdp48	3248/tcp
sapdp49	3249/tcp
sapdp50	3250/tcp
sapdp51	3251/tcp
sapdp52	3252/tcp
sapdp53	3253/tcp
sapdp54	3254/tcp
sapdp55	3255/tcp
sapdp56	3256/tcp
sapdp57	3257/tcp
sapdp58	3258/tcp
sapdp59	3259/tcp
sapdp60	3260/tcp
sapdp61	3261/tcp
sapdp62	3262/tcp
sapdp63	3263/tcp
sapdp64	3264/tcp
sapdp65	3265/tcp
sapdp66	3266/tcp
sapdp67	3267/tcp
sapdp68	3268/tcp
sapdp69	3269/tcp
sapdp70	3270/tcp
sapdp71	3271/tcp
sapdp72	3272/tcp
sapdp73	3273/tcp
sapdp74	3274/tcp
sapdp75	3275/tcp
sapdp76	3276/tcp
sapdp77	3277/tcp
sapdp78	3278/tcp
sapdp79	3279/tcp
sapdp80	3280/tcp
sapdp81	3281/tcp
sapdp82	3282/tcp
sapdp83	3283/tcp
sapdp84	3284/tcp
sapdp85	3285/tcp
sapdp86	3286/tcp
sapdp87	3287/tcp
sapdp88	3288/tcp
sapdp89	3289/tcp
sapdp90	3290/tcp
sapdp91	3291/tcp
sapdp92	3292/tcp
sapdp93	3293/tcp
sapdp94	3294/tcp
sapdp95	3295/tcp
sapdp96	3296/tcp
sapdp97	3297/tcp
sapdp98	3298/tcp
sapdp99	3299/tcp
sapgw00	3300/tcp
sapgw01	3301/tcp
sapgw02	3302/tcp
sapgw03	3303/tcp
sapgw04	3304/tcp
sapgw05	3305/tcp
sapgw06	3306/tcp
sapgw07	3307/tcp
sapgw08	3308/tcp
sapgw09	3309/tcp
sapgw10	3310/tcp
sapgw11	3311/tcp
sapgw12	3312/tcp
sapgw13	3313/tcp
sapgw14	3314/tcp
sapgw15	3315/tcp
sapgw16	3316/tcp
sapgw17	3317/tcp
sapgw18	3318/tcp
sapgw19	3319/tcp
sapgw20	3320/tcp
sapgw21	3321/tcp
sapgw22	3322/tcp
sapgw23	3323/tcp
sapgw24	3324/tcp
sapgw25	3325/tcp
sapgw26	3326/tcp
sapgw27	3327/tcp
sapgw28	3328/tcp
sapgw29	3329/tcp
sapgw30	3330/tcp
sapgw31	3331/tcp
sapgw32	3332/tcp
sapgw33	3333/tcp
sapgw34	3334/tcp
sapgw35	3335/tcp
sapgw36	3336/tcp
sapgw37	3337/tcp
sapgw38	3338/tcp
sapgw39	3339/tcp
sapgw40	3340/tcp
sapgw41	3341/tcp
sapgw42	3342/tcp
sapgw43	3343/tcp
sapgw44	3344/tcp
sapgw45	3345/tcp
sapgw46	3346/tcp
sapgw47	3347/tcp
sapgw48	3348/tcp
sapgw49	3349/tcp
sapgw50	3350/tcp
sapgw51	3351/tcp
sapgw52	3352/tcp
sapgw53	3353/tcp
sapgw54	3354/tcp
sapgw55	3355/tcp
sapgw56	3356/tcp
sapgw57	3357/tcp
sapgw58	3358/tcp
sapgw59	3359/tcp
sapgw60	3360/tcp
sapgw61	3361/tcp
sapgw62	3362/tcp
sapgw63	3363/tcp
sapgw64	3364/tcp
sapgw65	3365/tcp
sapgw66	3366/tcp
sapgw67	3367/tcp
sapgw68	3368/tcp
sapgw69	3369/tcp
sapgw70	3370/tcp
sapgw71	3371/tcp
sapgw72	3372/tcp
sapgw73	3373/tcp
sapgw74	3374/tcp
sapgw75	3375/tcp
sapgw76	3376/tcp
sapgw77	3377/tcp
sapgw78	3378/tcp
sapgw79	3379/tcp
sapgw80	3380/tcp
sapgw81	3381/tcp
sapgw82	3382/tcp
sapgw83	3383/tcp
sapgw84	3384/tcp
sapgw85	3385/tcp
sapgw86	3386/tcp
sapgw87	3387/tcp
sapgw88	3388/tcp
sapgw89	3389/tcp
sapgw90	3390/tcp
sapgw91	3391/tcp
sapgw92	3392/tcp
sapgw93	3393/tcp
sapgw94	3394/tcp
sapgw95	3395/tcp
sapgw96	3396/tcp
sapgw97	3397/tcp
sapgw98	3398/tcp
sapgw99	3399/tcp

登入 SAP

連線 SAP 系統需要以下設定。

設定	說明
SAP 主機	目標系統的主機名。主機名可以是 `hosts` 檔案中定義的常規主機名、類似 `123.123.123.123` 的 IP 地址，或類似 `/H/hostname/S/connector/H/host/S/connector/...` 的 SAProuter 地址。
系統編號	用於定義目標系統的編號。有效範圍為 0 到 99，但通常為 0。
用戶端	向 SAP 系統進行身分驗證的用戶端。
使用者	向 SAP 系統進行身分驗證的使用者。
密碼	身分驗證使用者的密碼。

閘道器

透過閘道器連線到 SAP 時，請使用進階索引標籤的閘道器部分中的選項。

負載平衡

要透過負載平衡登入，請在進階索引標籤的登入負載平衡部分中設定屬性。

安全網路通訊 (SNC)

要啟用安全網路通訊，請在進階索引標籤的安全網路通訊 (SNC)部分選中啟用 SNC 框。將 SNC 庫設定為用於連線 SAP 的 SNC 庫 .dll。

向 SAP 傳送 IDocs

配置 IDoc 端口以連線到 SAP 系統後，即可開始向 SAP 傳送 IDoc 檔案。IDoc 端口可以傳送原始 IDoc 或 XML IDoc 格式的檔案。可以將端口配置為自動將控制記錄資訊插入到傳送給 SAP 的 IDoc 中，例如 DOCREL、SNDPOR、SNDPRT 等。這使傳出 IDoc 更容易由已配置的系統處理。在設定索引標籤的控制記錄資訊選項部分配置這些設定。向 SAP 系統傳送 IDoc 之前，請確保已在 SAP 中正確配置合作伙伴配置檔案。如果 SAP 中沒有合作伙伴配置檔案與正在傳送的 IDoc 中的控制記錄資訊匹配，SAP 系統將不會處理這些資料。有關設定合作伙伴配置檔案的更多資訊，請參閱測試向 SAP 傳送 IDoc。

可以使用交易程式碼 WE60 搜尋不同 IDoc 型別的段文件。

測試向 SAP 傳送 IDoc

要測試向 SAP 傳送 IDoc，首先需要將 SAP 系統配置為具有知行之橋的合作伙伴配置檔案。以下步驟介紹如何使用 ORDERS IDoc 完成此操作。

建立合作伙伴： 轉到交易程式碼 WE20 並定義合作伙伴配置檔案。將客戶的合作伙伴型別設定為 KU，並將合作伙伴編號設定為有效的客戶編號。
為 ORDERS 文件新增入站參數： 此文件的訊息型別為 ORDERS。在入站選項索引標籤上，將處理程式碼設定為 ORDE，以告知 SAP 系統在收到採購訂單 ORDERS 文件時如何建立銷售訂單。
將客戶分配到銷售部門： 步驟 1 中配置的客戶必須分配給銷售組織、分銷渠道和部門。轉到交易 VOE2，在 EDSDC 表中配置這些設定。

從 SAP 接收 IDocs

配置 IDoc 端口以連線到 SAP 系統後，即可開始從 SAP 接收 IDoc 檔案。IDoc 端口可以接收原始 IDoc 或 XML IDoc 格式的檔案。要從 SAP 接收檔案，請為知行之橋建立一個 RFC 目標。然後，可以在設定索引標籤的接收設定部分勾選啟用 IDoc 接收器，並輸入你在 SAP 系統中為知行之橋註冊的程式 ID。

測試從 SAP 接收 IDoc

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

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

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

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

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

建立處理端口： 轉到交易程式碼 WE21。建立一個新的交易性 RFC 端口，使用唯一名稱以及你在步驟 2 中建立的同一目標。
建立合作伙伴配置檔案： 開啟交易 WE20。為步驟 1 中新增的邏輯系統建立一個合作伙伴配置檔案。接下來，為 MATMAS 文件新增一個出站參數。將訊息型別設定為 MATMAS。在出站選項索引標籤上，將接收方端口設定為步驟 3 中配置的端口值，將輸出模式設定為 Transfer IDoc Immed，並將 IDoc 基本型別設定為 MATMAS05。
傳送測試 IDoc： 使用交易 BD10 向知行之橋傳送指定物料編號的測試 IDoc。傳送訊息之前，需要配置訊息型別和邏輯系統。使用交易 BD87 監控傳出訊息，並在必要時再次處理它們。

​概覽

​端口配置

​設定索引標籤

​主機配置

​用戶端身分驗證

​接收設定

​控制記錄資訊選項

​進階選項卡

​語言設定

​閘道器

​登入負載平衡

​安全網路通訊 (SNC)

​進階設定

​訊息

​日誌

​其他設定

​自動化索引標籤

​自動化設定

​效能

​警示索引標籤

​SLA 索引標籤

​建立連線

​使用 NetWeaver RFC SDK

​使用 Classic RFC SDK

​使用支援 Unicode 的 Classic RFC SDK

​使用 Java Connector

​使用 SOAP

​服務配置

​登入 SAP

​閘道器

​負載平衡

​安全網路通訊 (SNC)

​向 SAP 傳送 IDocs

​測試向 SAP 傳送 IDoc

​從 SAP 接收 IDocs

​測試從 SAP 接收 IDoc

​宏

​範例

概覽

端口配置

設定索引標籤

主機配置

用戶端身分驗證

接收設定

控制記錄資訊選項

進階選項卡

語言設定

閘道器

登入負載平衡

安全網路通訊 (SNC)

進階設定

訊息

日誌

其他設定

自動化索引標籤

自動化設定

效能

警示索引標籤

SLA 索引標籤

建立連線

使用 NetWeaver RFC SDK

使用 Classic RFC SDK

使用支援 Unicode 的 Classic RFC SDK

使用 Java Connector

使用 SOAP

服務配置

登入 SAP

閘道器

負載平衡

安全網路通訊 (SNC)

向 SAP 傳送 IDocs

測試向 SAP 傳送 IDoc

從 SAP 接收 IDocs

測試從 SAP 接收 IDoc

宏

範例