SAP 调用 BAPI 活动

使用 SAP 调用 BAPI 活动,以在运行时期间调用在指定 SAP 端点上远程启用的业务对象方法 (BAPI)。

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

在编排中添加 SAP 调用 BAPI 活动

  1. 创建或打开编排。此时以图形形式显示编排。
  2. 选择活动选项卡,并展开 SAP 文件夹。
  3. SAP 调用 BAPI活动拖动到编排上。
  4. 选择该活动。这样会显示核对表

创建、选择或编辑 SAP 端点。

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

配置活动

  1. 核对表中选择配置任务。 这样会显示配置面板。
  2. 对象名字段中,单击浏览...BAPI 列表对话框即会显示。
  3. 搜索业务对象。单击列表中的一个业务对象,并输入该业务对象名称开头的若干个字符。
  4. 展开该业务对象,以查看关联的 BAPI 方法。
  5. 选择一个业务对象和方法,并单击确定
  6. 选择一下一个事务选项
    • 无操作(事务由 BAPI 直接处理) - 在运行时期间,调用该 BAPI 的 Integration Appliance 不执行任何事务处理。如果某个事务与该 BAPI 关联,该事务必须完全由 BAPI 处理。
    • 完成后落实事务 - 在运行时期间,Integration Appliance 调用 BAPI 并等待来自 SAP 系统的返回消息。从 SAP 系统返回的消息的返回码确定 Integration Appliance 是否应发送另一条消息,请求 SAP 系统落实或回滚该事务:
      • 如果从 BAPI 传回的返回码表明成功,Integration Appliance 将发送另一条消息,请求 SAP 系统落实该事务,并立即开始处理编排中的下一个活动。
      • 如果从 BAPI 传回的返回码表明失败,Integration Appliance 将向 SAP 系统发送一条回滚请求,并立即开始处理编排中的下一个活动。
    • 落实事务并等待完成 - 在运行时期间,Integration Appliance 调用 BAPI 并等待来自 SAP 系统的返回消息。从 SAP 系统返回的消息的返回码确定 Integration Appliance 是否应发送另一条消息,请求 SAP 系统落实或回滚该事务:
      • 如果从 BAPI 传回的返回码表明成功,Integration Appliance 将发送另一条消息,请求 SAP 系统落实该事务。编排将一直等待到 SAP 系统发送第二条消息,表明事务已落实后,才处理编排中的下一个活动。
      • 如果从 BAPI 传回的返回码表明失败,Integration Appliance 将向 SAP 系统发送一条回滚请求。 编排将一直等待到 SAP 系统发送第二条消息,表明已发生事务回滚后,才处理编排中的下一个活动。

指定重试选项

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

映射活动的输入

  1. 核对表中选择映射输入任务。 从 BAPI 的输入参数生成的 XML 模式显示为目标活动面板中请求输入参数下的节点。此外,如果 BAPI 包含表,代表 BAPI 表的 XML 模式将显示为目标活动面板中请求输入参数下的节点。
  2. 在编排变量与 BAPI 输入参数和表之间创建映射。请参阅创建映射,以获取有关映射的常规指示信息。

    在运行时必须为 BAPI 输入参数或表的所有必选元素提供相应值。 可以通过指定元素的缺省值提供值,也可以通过与将元素与输入节点链接提供值。运行时期间,如果未提供必选元素的值,那么活动会在运行时期间抛出由 Web 管理控制台 (WMC) 报告的异常。如果在运行时期间没有为 BAPI 输入参数或表的可选元素提供值,在运行时期间不会抛出异常。

映射活动的输出

  1. 选择“核对表”中的映射输出任务。 从 BAPI 的返回类型生成的 XML 模式显示为源活动面板中响应输出参数下的节点。此外,如果 BAPI 包含表,代表此类表的 XML 模式将显示为源活动响应节点下的节点。
  2. 在 BAPI 输出参数和表与编排变量间创建映射。请参阅创建映射,以获取有关映射的常规指示信息。

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

Integration Appliance 必须首先能够与 SAP 系统建立连接,然后您才可以使用 WMC 部署带有 SAP 活动的编排。如果 Integration Appliance 未能与 SAP 系统建立连接,则无法部署编排。