订阅

UiPath 活动

UiPath 活动指南

关于“SAP BAPI 活动包”

“SAP BAPI 活动包”可帮助 RPA 开发者调用 SAP 业务应用程序编程接口 (BAPI)。该活动包附带一个作用域活动“SAP 应用程序作用域”,用户可借助该活动连接到 SAP 系统,并使用“调用 SAP BAPI”活动来调用指定的 BAPI。

发行说明

安装必备程序

安装该活动包之前,必须先安装 SAP Connector for Microsoft .NET 3.0 (NCo 3.0) 的 32 位 (x86) .NET 4.0 版本。该连接器还需使用 Microsoft C++ 运行时 DLL 10.0 版(已包含在 Microsoft Visual C++ 2010 可再发行组件包中)。您可以请求 SAP 管理员提供此安装程序。

📘

Important!

请注意,SAP Connector for Microsoft 必须安装在 Windows 全局程序集缓存 (GAC) 中才能正常运行。为此,请在安装 SAP 连接器期间选择相应选项。

您需在要在其中使用该活动包的任何机器上安装这些依赖项。这类机器是指开发机器以及生产机器,其中开发机器可让用户使用 Studio 创建工作流,而生产机器则可供机器人执行这类工作流。

📘

Note:

要使用连接器的所有 SAP 用户都需要从 SAP 获取各自解决方案或组件的许可证才能获得授权。

The official documentation of the SAP .NET Connector can be found here.

📘

Studio Compatibility

Please refer to the link below for Studio version compatibility and support:
https://www.uipath.com/legal/trust-and-security/legal-support/product-lifecycle.

生成 SAP BAPI 工作流

v2.0.0 版及更高版本

Due to the massive refactoring that took place with UiPath.SAP.BAPI.Activities v2.0.0, instructions for using this pack have moved to their respective activity documentation pages, SAP Application Scope and Invoke SAP BAPI.

v2.0.0 以下版本

安装 SAP BAPI 包后,您便可在 UiPath Studio“设计”功能区选项卡中的“向导”部分找到“SAP 连接器向导”

首先,您必须创建能与 SAP 系统建立连接的工作流。执行该步骤后,您便可在关闭连接之前调用多个 BAPI 工作流。

该向导包含以下 4 个部分:

Login Credentials

该部分要求您输入“系统连接参数”和“登录信息”

在“系统连接参数”中,需输入要连接的 SAP 系统的详细信息,以便提取 BAPI 信息。必填字段包括:

  • Application Server Host
  • System Number

在“登录信息”中,需输入经授权能够连接至上述 SAP 系统的 SAP 用户的详细信息。必填字段包括:

  • 客户端
  • User
  • 密码

您还可以填写“语言”字段以指定 SAP 系统的语言。请注意,该字段应填入语言代码(如 EN、DE 等)。您需在要连接的 SAP 实例上安装指定语言。如未在该字段中指定任何语言,则系统会使用 SAP 系统的默认语言。

单击“连接”会,系统会指示连接是否成功,并会将状态更改为“联机”。

📘

Note:

如果无法建立连接,则系统会显示一条错误消息。请检查并更正“系统连接参数”或“登录信息”,然后重试。如果无法成功建立连接,请咨询 SAP 管理员。

“SAP BAPI 向导”会保留“系统连接参数”和“登录信息”的值(除“密码”字段以外),以供当前 Studio 会话使用。

Choose BAPI

在“SAP BAPI 名称”字段中输入要自动执行的 BAPI 的名称。您也可选择输入描述。

填写“SAP BAPI 名称”字段后,单击“下一步”;如果在存储库中找到此 BAPI,则该向导会导航至“参数”屏幕。

如未找到此 BAPI,系统会显示一条错误消息。请检查输入的 SAP BAPI 名称准确无误,且已在 SAP 系统中启用该名称。如果无法找到此 BAPI,请向 SAP 管理员寻求帮助。

Select Arguments

向导将列出此 BAPI 的所有参数以及每个参数的详细信息,如“方向”(“输入”、“输出”、“输入/输出”)、“数据类型”以及该参数是否为“必填项”。选择要映射到工作流的参数。始终选择标记为“必填项”的参数进行映射。

您还可以为“工作流参数”指定要使用的“指定名称”,以替代 SAP BAPI 中的“技术名称”

如果 BAPI 包含表格和结构等复杂参数,而这类参数中又包含复杂参数,则系统会抛出“不支持的 BAPI”异常。以下参数类型会遭遇该问题:

  • 表格中包含表格。
  • 结构中包含表格。
  • 结构中包含结构。
  • 表格中包含结构。

An error is also thrown if a BAPI includes the return argument with a parameter type different than BAPIRETURN, BAPIRETURN1, BAPIRET1, BAPIRET2, BAPIRET2_FIX.

单击“下一步”将会导航至“生成工作流”屏幕。

Generate Workflow

该屏幕可用于查看工作流的详细信息,确保您已选择要映射的所有参数。

“工作流文件路径”属性字段用于指定要保存工作流的位置。

单击“生成”后,系统会使用“选择参数”屏幕中选定的所有选项在指定路径下创建一个“.xaml”文件。

Invoking the BAPI Workflow

“调用工作流文件”活动可用于调用 SAP BAPI 工作流。必须将“打开 SAP 连接”活动置于调用活动之前,因为该活动会生成一个“SAPConnectionService”变量,随后需用于 SAP BAPI 工作流参数“SAPConnectionService”中。该参数应在“打开 SAP 连接”活动的“SapConnectionService”属性字段中进行设置。

📘

重要提示:

使用“调用工作流文件”活动中的“隔离”属性时,系统无法调用经由 SAP BAPI 包生成的工作流。

BAPI 中所有具有“Table”类型的参数均会映射到“DataTable”参数,而 BAPI 中所有具有“Structure”类型的参数均会映射到“DataRow”参数。所有其他参数均会映射到基本数据类型。

每个 BAPI 工作流还会返回具体参数,其中包含相应类型所采用的“BapiReturn”结构。

执行“调用工作流文件”活动后,您须使用“关闭 SAP 连接”活动来关闭与 SAP 的连接。该连接可由相同的“SAPConnectionService”变量指定。

Updated about a month ago


关于“SAP BAPI 活动包”


建议的编辑仅限用于 API 参考页面

You can only suggest edits to Markdown body content, but not to the API spec.