Version 26.2.9636

• 总览
• 端口配置
  • 设置
    • 转换设置
    • 客户端身份验证
    • 接收设置
    • 控制记录信息选项
  • 高级设置
    • 语言设置
    • 网关
    • 登录负载均衡
    • 网络通信安全（SNC）
    • 高级设置
    • 消息
    • 日志
    • 特殊设置
• 建立连接
  • 自动化
    • 自动化设置
    • 性能
  • 通知选项卡
  • SLA 选项卡
  • 使用 NetWeaver RFC SDK
  • 使用 Classic RFC SDK
  • 使用支持 Unicode 的 Classic RFC SDK
  • 使用 Java Connector
  • 使用 SOAP
  • 服务配置
  • 登录 SAP
    • 网关
    • 负载均衡
    • 安全网络通信 (SNC)
• 向 SAP 发送 IDocs
  • 测试发送 IDoc 到 SAP
• 从 SAP 接收 IDocs
  • 测试从 SAP 接收 IDoc。
• 宏
  • 示例

SAP IDoc 端口支持向各种 SAP 系统发送和接收 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 文件的格式为 RawIDoc 或者 XML。

控制记录信息选项

本节允许在将 IDoc 文件发送到 SAP 之前覆盖 IDoc 文件的头部控制信息。这在从一个 SAP 系统接收 IDoc 文件并将其发送到另一个 SAP 系统时非常有用：在这种情况下，应该在不更改 IDoc 文件数据的情况下更改控制记录。有关详细信息，请参阅将 IDoc 发送到 SAP。

高级设置

语言设置

有关语言的设置。

• 语言 连接到 SAP 系统时要使用的语言。对于 SAP 系统使用的语言，此值应设置为 ISO 639-1。

网关

关于通过网关与 SAP 通信的设置。

• 网关主机 要连接网关的主机名或 IP 地址。
• 网关服务 要使用的网关服务。

登录负载均衡

关于以分组方式登录 SAP 系统并启用负载均衡的设置。

• 消息服务器 负载均衡服务器名称。
• 系统 ID SAP 系统 ID。
• 登录组 负载平衡时要使用的组。

网络通信安全（SNC）

关于使用外部安全产品增强 SAP 连接安全性的设置。

• SNC 名称 进行连接的计算机的 SNC 名称。
• SNC 伙伴名称 该端口将要连接 SAP 系统的 SNC 名称。
• SNC 保护质量等级 SNC 产品增加的保护质量等级。
• SNC 库 外部安全产品库的路径。

高级设置

不包含在之前类别中的设置。

• 延迟处理 放置在输入文件夹中的文件的处理延迟的时间量（以秒为单位）。 这是一个遗留设置。 最佳实践是使用 File 端口 来管理本地文件系统，而不是此设置。
• 刷新模板 启用后，端口会在发生解析错误时尝试更新其用于解析的模板。 通过联系 SAP 系统并查询适当的模板来更新模板。

消息

消息设置 确定端口如何搜索消息并在处理后管理它们。 可以将消息保存到你的 已发送 文件夹，或者可以根据 已发送 文件夹方案将它们保存，如下所述。

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

日志

• 日志级别 端口生成的日志的详细程度。 当端口请求支持时，请将其设置为 调试。
• 日志子文件夹方案：指示端口根据所选的时间间隔对日志（Logs）文件夹中的文件进行分组。每周（Weekly）选项（默认设置）指示端口每周创建一个新子文件夹，并将该周的所有日志存储在其中。如果此设置留空，则端口将所有日志直接保存在日志文件夹中。对于处理大量事务的端口，使用子文件夹有助于保持日志井然有序并提高性能。
• 保留消息副本 选中此项可使已处理文件的日志条目包含文件本身的副本。 如果禁用此功能，端口可能无法从 交易 选项卡下载文件的副本。

特殊设置

特殊设置 适用于特定用例。

• 其他设置 允许在以分号分隔的列表中配置隐藏的端口设置，例如setting1=value1;setting2=value2。 正常的端口用例和功能不需要使用这些设置。

建立连接

自动化

自动化设置

关于端口自动处理文件的设置。

• 发送 端口收到的文件是否自动发送。
• 重试间隔 发送失败后进行重发的时间间隔。
• 最大重试次数 发送失败的最大重试次数。

性能

与端口资源分配相关的设置。

• 最大工作线程数 此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置，则会覆盖 高级设置 页面的 性能设置 部分的默认设置。
• 最大文件数 分配给端口的每个线程发送的最大文件数。如果设置，则会覆盖 高级设置 页面的 性能设置 部分的默认设置。

通知选项卡

与配置通知相关的设置。

在执行服务级别协议 (SLA) 之前，需要设置电子邮件通知以接收通知。默认情况下，知行之桥使用 通知 选项卡上的全局设置。要为此端口使用其他设置，请启用覆盖全局设置。

默认情况下，错误通知处于启用状态，这意味着每当出现错误时都会发送电子邮件。要关闭错误通知，请取消选中启用复选框。

输入主题（必填），然后（可选）输入以逗号分隔的收件人电子邮件列表。

SLA 选项卡

与配置服务级别协议 (SLA) 相关的设置。

SLA 允许配置预期流程中端口发送或接收的数据量，并设置预期达到该数据量的时间范围。当 SLA 未达到时，知行之桥会发送电子邮件警告用户，并将 SLA 标记为_存在风险_，这意味着如果 SLA 未能尽快达到，则会被标记为_已违反_。这让用户有机会介入并确定 SLA 未达到的原因，并采取适当的措施。如果在风险时间段结束时仍未达到 SLA，则会将 SLA 标记为_已违反_，并再次通知用户。

要定义 SLA，请启用预期数据量，然后点击设置选项卡。

• 如果端口具有单独的发送和接收操作，请使用单选按钮指定 SLA 适用的方向。
• 在窗口的预计至少部分中：
  • 设置预计处理的最小事务数量（交易量）
  • 使用每个字段指定时间范围
  • 指示 SLA 生效的时间。如果选择开始于，请填写日期和时间字段。
  • 勾选希望 SLA 生效的星期几对应的复选框。如有必要，请使用下拉菜单选择每天。
• 在窗口的将状态设置为“有风险”部分中，指定应将 SLA 标记为有风险的时间。
  • 默认情况下，只有在违反 SLA 的情况下才会发送通知。要更改此设置，请勾选发送“有风险”通知。

以下示例显示了为端口配置的 SLA，该端口预计在周一至周五每天接收 1000 个文件。如果尚未收到 1000 个文件，则会在时间段结束前 1 小时发送风险通知。

注意：如果有必要，可以关闭 SLA 通知。这在维护窗口期间非常有用。点击导航栏上的设置，然后跳转到通知 > 通用通知。点击平板和铅笔图标进行编辑，并取消勾选 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”的服务文件中。

使用 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 只能用于“发送”IDoc 到 SAP。 必须使用不同的连接类型才能从 SAP“接收”IDoc。

注意：这需要在 SAP 系统上启用 SOAP 连接。

服务配置

除了以上的依赖关系，如果你的系统运行在 Linux 或 Mac OS X 上，以下服务必须添加到 %WINDIR%/system32/drivers/etc/services，或者 /etc/services。如果 SAP NetWeaver 已经安装在机器上，那么不需要进一步的操作。

登录 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 Connector 连接到 SAP 系统，就可以开始向 SAP 发送 IDoc 文件。IDoc Connector 可以发送原始 IDoc 或 XML IDoc 格式的文件。

可以将端口配置为自动将控制记录信息插入到发送到 SAP 的 IDoc 中：DOCREL、SNDPOR、SNDPRT 等。 这使得处理传出 IDoc 到已配置系统变得更加容易。 在 设置 选项卡的 控制记录信息选项 部分中配置这些设置。

在将 IDoc 发送到 SAP 系统之前，请确保已在 SAP 中正确配置合作伙伴配置文件。 如果 SAP 中没有合作伙伴配置文件与发送的 IDoc 中的控制记录信息相匹配，则 SAP 系统将不会处理数据。 有关设置合作伙伴配置文件的更多信息，请参阅测试向 SAP 发送 IDoc。

提示：可以使用事务代码 WE60 搜索不同 IDoc 类型的段文档。

测试发送 IDoc 到 SAP

要测试向 SAP 发送 IDoc，首先需要将 SAP 系统配置为具有知行之桥的合作伙伴配置文件。以下步骤将展示如何使用订单 IDoc 进行此操作。

1. 创建一个合作伙伴。转到事务代码 WE20 并定义一个合作伙伴配置文件。需要为客户将合作伙伴类型设置 KU，将合作伙伴编号设置为有效的客户编号。

1. 然后需要为 ORDERS 文档添加一个入库参数。该文档的消息类型为 ORDERS，在入库选项卡上，需要将流程代码设置为 ORDE，以告诉 SAP 系统收到采购订单 ORDERS 文档时，如何创建销售订单。

1. 将客户分配到销售部门。必须将第一步中配置的客户分配给一个销售组织、分销渠道和部门。转到事务 VOE2，在 EDSDC 表中配置这些设置。

从 SAP 接收 IDocs

一旦配置了 IDoc Connector 连接到你的 SAP 系统，就可以开始从 SAP 接收 IDoc 文件。IDoc 端口可以接收原始 IDoc 或 XML IDoc 格式的文件。

要从 SAP 接收文件，请为知行之桥创建一个 RFC 目标。然后，你可以在端口的”设置”页面中的接收器选项选择启用 IDoc 接收机选项，并输入你在 SAP 系统中为知行之桥注册的程序 Id。

测试从 SAP 接收 IDoc。

这个例子将描述配置 SAP 系统向知行之桥发送 MATMAS IDoc 的步骤。

1. 定义一个逻辑系统。首先，进入事务 SALE。接下来进入基本设置->逻辑系统->定义逻辑系统。创建一个新条目，并提供有效的名称（如知行之桥）和描述。
2. 创建一个 RFC 目的地。打开事务代码 SM59。单击创建按钮，并填写下面描述的 RFC 目的地的字段。

• 目的地 新目的地的唯一名称（例如，ARC_DEST）。
• 连接类型 T 代表 TCP/IP。

• 描述 目的地的描述.

  程序 ID:

  目的地的唯一名称(例如 ARC_DEST).

  连接类型:

  TCP/IP 的 ‘T’.

  描述:

  目的地的描述。

• 程序ID 知行之桥中设置的唯一名称，用于识别目的地。
• 激活类型 选择注册服务器程序。

保存设置后，就可以测试连接，确保成功连接到知行之桥。

1. 创建一个处理端口。转到事务代码 WE21。创建一个新的事务性 RFC 端口，它有一个独特的名称和你在步骤 2 中创建的相同的目标。

   

2. 创建一个合作伙伴档案。打开交易 WE20 为步骤1中添加的逻辑系统创建一个伙伴配置文件。接下来为 MATMAS 文档添加一个出站参数。将 消息类型 设置为 MATMAS。在出站选项部分，接收方端口应与步骤 3 中配置的端口相同，将输出模式设置为 Transfer IDoc Immed，将 IDoc 基本类型 设置为 MATMAS05。

   

3. 发送测试 IDoc：使用事务 BD10 向知行之桥发送指定材料号的测试 IDoc。在发送消息之前，你需要配置消息类型和逻辑系统。你可以使用事务 BD87 来监控发出的消息，并在必要时再次处理。

宏

在文件命名策略中使用宏可以提高组织效率和对数据的上下文理解。 通过将宏合并到文件名中，可以动态地包含相关信息，例如标识符、时间戳和消息头信息，从而为每个文件提供有价值的上下文。 这有助于确保文件名反映对组织重要的详细信息。

知行之桥 支持这些宏，它们都使用以下语法：%Macro%。

示例

某些宏（例如 %Ext% 和 %ShortDate%）不需要参数，但其他宏则需要。 所有带有参数的宏都使用以下语法：%Macro:argument%

以下是带有参数的宏的一些示例：

• %Header:headername%：其中 headername 是消息上消息头的名称。
• %Header:mycustomheader% 解析为输入消息上设置的 mycustomheader 消息头的值。
• %Header:ponum% 解析为输入消息上设置的 ponum 消息头的值。
• %RegexFilename:pattern%：其中“pattern”是正则表达式模式。 例如，%RegexFilename:^([\w][A-Za-z]+)% 匹配并解析为文件名中的第一个单词，并且不区分大小写（test_file.xml解析为test） 。
• %Vault:vaultitem%：其中 vaultitem 是 vault 中项目的名称。 例如，%Vault:companyname%解析为存储在保管库中的companyname项的值。
• %DateFormat:format%：其中 format 是可接受的日期格式（有关详细信息，请参阅示例日期格式）。 例如，%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%解析为文件上的日期和时间戳。

还可以创建更复杂的宏，如以下示例所示：

• 将多个宏组合在一个文件名中：%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%
• 包括宏之外的文本：MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%
• 在宏中包含文本： %DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%