Version 23.4.8843

• 总览
• 端口配置
  • 设置
    • 转换设置
    • 客户端身份验证
    • 接收设置
    • 控制记录信息选项
  • 自动化
    • 自动化设置
    • 性能
  • 通知
    • 端口邮件设置
    • 服务等级协议 (SLA) 配置
  • 高级设置
    • 语言设置
    • 网关
    • 登录负载均衡
    • 网络通信安全（SNC）
    • 高级设置
    • 消息
    • 日志
    • 特殊设置
• 建立连接
  • 使用 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。

自动化

自动化设置

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

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

性能

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

• 最大线程数 从线程池中消耗用于处理此端口上的文件的最大工作线程数。 如果设置，这将覆盖 设置 > 自动化 页面上的默认设置。
• 最大文件数 分配给端口的每个线程发送的最大文件数。 如果设置，这将覆盖 设置 > 自动化 页面上的默认设置。

通知

与配置警报和服务等级协议 (SLA) 相关的设置。

端口邮件设置

在执行 SLA 之前，需要设置电子邮件警报以获取通知。 单击 配置通知 将打开一个新的浏览器窗口，转到 系统设置，可以在其中设置系统范围的警报。 有关详细信息，请参阅通知。

服务等级协议 (SLA) 配置

SLA 能够配置期望工作流中的端口发送或接收的数量，并设置期望满足该数量的时间范围。 知行之桥在不满足 SLA 时发送电子邮件警告用户，并将 SLA 标记为 有风险，这意味着如果很快不满足 SLA，则会将其标记为 已违反。 这使用户有机会介入并确定未满足 SLA 的原因，并采取适当的措施。 如果在风险时间段结束时仍未满足 SLA，则将 SLA 标记为违反，并再次通知用户。

要定义 SLA，请单击 添加预期数量条件。

• 如果端口具有单独的发送和接收操作，请使用单选按钮指定 SLA 所属的方向。
• 将 期待至少 设置为期望处理的最小交易数量（交易量），然后使用 每 字段指定时间范围。
• 默认情况下，SLA 每天都有效。 要更改此设置，请取消选中每日，然后选中想要的一周中的几天的框。
• 使用 将状态设置为“有风险” 来指示何时应将 SLA 标记为存在风险。
• 默认情况下，在违反 SLA 之前不会发送通知。 要更改此设置，请选中 发送“有风险”通知。

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

高级设置

语言设置

有关语言的设置。

• 语言 连接到 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”文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

日志

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

特殊设置

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

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

建立连接

使用 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 来监控发出的消息，并在必要时再次处理。

宏

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

ArcCN 支持这些宏，它们都使用以下语法：%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%