使用 SAP 调用 BAPI 活动,以在运行时期间调用在指定 SAP 端点上远程启用的业务对象方法 (BAPI)。
在编排中添加 SAP 调用 BAPI 活动
- 创建或打开编排。此时以图形形式显示编排。
- 选择活动选项卡,并展开 SAP 文件夹。
- 将 SAP 调用 BAPI活动拖动到编排上。
- 选择该活动。这样会显示核对表。
创建、选择或编辑 SAP 端点。
- 从核对表中单击选取端点任务,并选择以下一个操作:
- 选择一个现有端点:
- 选择浏览。这样会显示 Project Explorer。
- 选择一个现有端点,并单击确定。
转至配置活动过程。
- 选择一个现有端点并编辑该端点:
- 选择浏览。这样会显示 Project Explorer。
- 选择一个现有端点,并单击确定。
- 单击编辑。这样会显示编辑端点窗格。
- 创建一个新端点:选择新建。这样会显示创建端点面板。
- 创建或编辑 SAP 端点。
配置活动
- 从核对表中选择配置任务。
这样会显示配置面板。
- 在对象名字段中,单击浏览...。
BAPI 列表对话框即会显示。
- 搜索业务对象。单击列表中的一个业务对象,并输入该业务对象名称开头的若干个字符。
- 展开该业务对象,以查看关联的 BAPI 方法。
- 选择一个业务对象和方法,并单击确定。
- 选择一下一个事务选项:
- 无操作(事务由 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 系统发送第二条消息,表明已发生事务回滚后,才处理编排中的下一个活动。
指定重试选项
- 从核对表中选择重试任务。
这样会显示重试面板。
- 配置用于连接到 SAP 系统的重试选项。下表描述了用于连接到 SAP 系统的重试选项:
重试选项 |
描述 |
1) 在两次重试之间等待 ___ 秒。 |
指定 Integration Appliance 在尝试建立与 SAP 系统的连接之前等待的秒数。 |
2) 在尝试连接 ___ 次后将失败。 |
指定 Integration Appliance 在发出错误并停止处理当前编排作业之前尝试与 SAP 系统建立连接的最大次数。
如果部署包含 SAP 调用 BAPI 活动在内的编排,且 Integration Appliance 无法与指定的 SAP 系统建立连接,那么 Integration Appliance 会在系统和编排日志中将连接错误记录为“警告”,直至达到重试次数值。当达到重试计数后,Integration Appliance 会在系统和编排日志中记录一个“错误”并停止处理当前编排作业。例如,您将重试计数设置为 3。第一个、第二个和第三个连接错误在系统日志中显示为“警告”。Integration Appliance 会将第四个连接错误记录为“错误”,并停止处理当前编排作业。 |
映射活动的输入
- 从核对表中选择映射输入任务。
从 BAPI 的输入参数生成的 XML 模式显示为目标活动面板中请求输入参数下的节点。此外,如果 BAPI 包含表,代表 BAPI 表的 XML 模式将显示为目标活动面板中请求输入参数下的节点。
- 在编排变量与 BAPI 输入参数和表之间创建映射。请参阅创建映射,以获取有关映射的常规指示信息。
在运行时必须为 BAPI 输入参数或表的所有必选元素提供相应值。
可以通过指定元素的缺省值提供值,也可以通过与将元素与输入节点链接提供值。运行时期间,如果未提供必选元素的值,那么活动会在运行时期间抛出由 Web 管理控制台 (WMC) 报告的异常。如果在运行时期间没有为 BAPI 输入参数或表的可选元素提供值,在运行时期间不会抛出异常。
映射活动的输出
- 选择“核对表”中的映射输出任务。
从 BAPI 的返回类型生成的 XML 模式显示为源活动面板中响应输出参数下的节点。此外,如果 BAPI 包含表,代表此类表的 XML 模式将显示为源活动中响应节点下的节点。
- 在 BAPI 输出参数和表与编排变量间创建映射。请参阅创建映射,以获取有关映射的常规指示信息。
有关部署 SAP 编排的注意事项
Integration Appliance 必须首先能够与 SAP 系统建立连接,然后您才可以使用 WMC 部署带有 SAP 活动的编排。如果 Integration Appliance 未能与 SAP 系统建立连接,则无法部署编排。