SAP 发送 IDOC 活动

运行时期间,使用 SAP 发送 IDOC 活动以将 IDOC 发送至指定的 SAP 端点。

如果使用 RFC 端口将 SAP 数据直接发送至 SAP 系统,则需使用 SAP 发送 IDOC 活动。 如果通过 SAP 系统的 SAP 文件端口来发送 SAP 数据作为文件,则需在设计时使用项目 >导入 >SAP IDOC 模式工具栏菜单选项,为 IDOC 元数据生成平面文件模式,并使用写入平面文件活动来写入 SAP 数据。有关更多信息,请参阅从 IDOC 中生成平面文件模式

要从 Studio 连接至 SAP 系统,必须下载 SAP Jar 文件和 DLL,并将其安装在 Windows 开发机器上。有关更多信息,请参阅下载和安装 SAP Jar 文件和 DLL

运行时期间,如果 SAP 发送 IDOC 活动处理了两个 IDOC 实例(两个实例具有相同的 IDOC 号),那么 SAP 发送 IDOC 活动会将第二个实例的数据段附加到第一个实例的末尾。

注: 必须持续启用含 SAP 发送 IDOC 活动的编排。有关更多信息,请参阅启用持久性
以下过程中描述了在编排中添加并配置 SAP 发送 IDOC 活动的步骤:

将 SAP 发送 IDOC 活动添加至编排

  1. 创建或打开编排。这样会以图形形式显示编排。
  2. 选择活动选项卡并展开 SAP 文件夹。
  3. 发送 IDOC 活动拖动至编排上。
  4. 选择该活动。这样会显示核对表

创建、选择或编辑 SAP 端点

  1. 核对表中单击选取端点任务,并选择以下一个操作:
    • 选择现有端点:
      1. 选择浏览。这样会显示 Project Explorer
      2. 选择现有端点并单击确定。 转至配置活动过程。
    • 选择现有端点并编辑该端点:
      1. 选择浏览。这样会显示 Project Explorer
      2. 选择现有端点并单击确定
      3. 单击编辑。这样会显示编辑端点面板。
    • 创建新端点:选择新建。这样会显示创建端点面板。
  2. 创建或编辑 SAP 端点

配置活动

  1. 核对表中选择配置任务。 这样会显示配置面板。
  2. 单击浏览......
  3. 选择 IDOC 行并单击确定配置任务中的消息类型IDOC 类型IDOC 扩展类型已填充。

指定重试选项

  1. 核对表中选择重试任务。 这样会显示重试面板。
  2. 配置重试选项以连接 SAP 系统。下表描述了用于连接 SAP 系统的重试选项:
    重试选项 描述
    1) 在两次重试之间等待 ___ 秒。 指定 Integration Appliance 在尝试建立与 SAP 系统的连接之前等待的秒数。
    2) 在尝试连接 ___ 次后失败。 指定 Integration Appliance 在发出错误并停止处理当前编排作业之前尝试与 SAP 系统建立连接的最大次数。 如果部署包含 SAP 发送 IDOC 活动在内的编排,且 Integration Appliance 无法与指定的 SAP 系统建立连接,那么 Integration Appliance 会在系统和编排日志中将连接错误记录为“警告”,直至达到重试次数值。当达到重试计数时,Integration Appliance 会在系统和编排日志中记录错误,并且停止处理当前编排作业。例如,您将重试计数设置为 3。第一个、第二个和第三个连接错误在系统日志中显示为“警告”。Integration Appliance 将第四个连接错误记录为错误,并且停止处理当前编排作业。

映射活动的输入

  1. 核对表中选择映射输入任务。 至活动面板中会显示活动的输入参数。由所选 IDOC 类型和 IDOC 扩展类型生成的 XML 模式成为活动的输入参数。
  2. 右键单击至活动部分并选择显示可选参数

    SAP 连接器还支持从端点动态连接到其他 SAP 系统。在运行时期间,如果希望实现以下目的,请在映射输入的 sapConnectionProperties 中添加可选参数:希望动态连接到端点面板中配置的 SAP 系统之外的 SAP 系统;希望使用不同于端点面板中使用的用户名和密码连接到同一 SAP 系统;希望 SSO 令牌不同于端点面板中添加的 SSO 令牌。下表中描述了 sapConnectionProperties 的参数:
    表 1. 连接属性
    可选参数 描述
    sapConnectionProperties 参数
    hostName 指定包含 SAP 系统的 IP 地址或机器名称。
    systemNumber 指定标识 Studio 应连接的特定 SAP 系统实例的编号。您的 SAP 管理员必须提供该信息。
    client 指定将 Studio 和 Integration Appliance 标识为 SAP 系统的客户端的编号。您的 SAP 管理员必须提供该信息。
    language 指定 SAP 的消息语言选项。 例如,EN 是表示英语的 ISO 代码。
    basicAuthentication 参数
    username 指定要在连接 SAP 系统时使用的用户名。
    password 指定与连接 SAP 系统时的用户名对应的密码。
    ssoAuthentication 参数
    ssotoken 指定单点登录 (SSO) 令牌。
    sncAuthentication 参数
    sncmode 指定是否启用安全网络连接 (SNC) 方式。
    sncname 指定 SNC 连接的专有名称。
    partner 指定 SNC 合作伙伴的专有名称。
    qop 指定 SNC 的安全级别。
    X509 证书 指定要用作登录凭单的 X509 证书。只有在将基于用户名/密码的认证与 SNC 一起使用时,该字段才为可选字段。
    connectionPool 参数
    maximumConnections 指定 Integration Appliance 根据消息负荷打开的额外 SAP 连接数,最多为该指定的数量。
    maxIdleTime 指定 SAP 连接在 Integration Appliance 将其关闭之前可以处于打开和空闲状态的分钟数。
  3. 在编排变量与 IDOC 输入参数和表之间创建映射。请参阅创建映射,以获取与映射有关的常规指示信息。

有关部署 SAP 编排的注意事项

在使用 Web 管理控制台部署具有 SAP 活动的编排前,Integration Appliance 必须首先与 SAP 系统建立连接。如果 Integration Appliance 未能与 SAP 系统建立连接,则无法部署编排。