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 系统并查询相应模板来执行更新。

消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置	描述
保存到已发送文件夹	选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案	端口根据选定的时间间隔对已发送文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在已发送文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

设置

描述

保存到已发送文件夹

选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。

已发送文件夹方案

端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

日志

用于管理日志创建和存储的设置。

设置	描述
日志级别	指定要记录在端口日志目录中的信息类型： 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

宏

示例