订阅

UiPath Studio

UiPath Studio 指南

支持的 SAP WinGUI 元素

SAP 界面包含各种特定控件,您可以按本页面所示与这些控件进行交互。

SAP 按钮

表示在 SAP WinGUI 窗口中找到的任何按钮。有几种类型,每种类型均由特定元素定义:

图标

图标为不显示文本标签的交互式按钮。

490490

普通按钮

按钮为简单的用户界面元素,可用于直接访问应用程序中的命令。

548548

单选按钮

单选按钮提供一系列选项。列表中至少包含两个单选按钮,并且您只能选择一个。

436436

You can use the Click activity to interact with buttons.

SAP 日历

SAP 日历用于选择单个日期或时间段。

314314

You can use the Select Dates in Calendar activity to interact with the SAP Calendar.

504504

📘

备注:

Studio 中的“录制”功能不支持此 SAP 控件。

SAP 复选框

复选框元素代表多项选择的列表。您可以选择一个、多个选项或不选择任何选项。

606606

You can use the Click activity to interact with checkboxes.

SAP 上下文菜单

表示上下文菜单中的项目列表。请注意,父上下文菜单中可以有多个子上下文菜单。

228228

You can use the Click activity to interact with the SAP Context Menu. The AA element detection framework is required for interactive selection.

SAP 对话框

表示外部窗口,可以容纳不同类型的其他 SAP 控件,例如按钮、文本消息或弹出窗口。

370370

对话框中的选取器是依据其本身代表的元素而生成。

If you want to close a dialog box using the Close button, you need to use the AA element detection framework.

You can use UIAutomation activities such as Click or Type Into to interact with dialog boxes.

SAP 下拉列表

下拉列表用于从预定义列表中选择项目。

402402

You can use the Select Item activity to interact with list items.

SAP HTML 内容

HTML 控件用于在 SAP WinGUI 中显示 HTML 内容。

837837

To interact with an HTML page inside the SAP WinGUI, you need to use the AA element detection framework. UIAutomation activities can be used to build processes for SAP HTML content.

SAP 输入字段

代表接受用户输入的特定字段。

642642

You can use the Type Into activity to interact with input fields.

SAP 登录

“SAP 登录”是本地安装的程序,可用于直接登录到 SAP 系统。

694694

You can use the SAP Logon activity to open SAP.

该活动需要 2 个参数:

  • “SAP 登录”或“SAP 登录板”窗口中用于登录到 SAP 系统的确切 SAP 连接名称。
  • “SAP 登录”或“SAP 登录板”程序的路径。默认路径是从相应的系统注册表项获得的。
827827

📘

备注:

“在屏幕上指定”功能非必需。SAP 脚本编写界面用于连接到 SAP 系统。

SAP 登录

提供登录到 SAP 系统的可能性。

634634

You can then use the SAP Login activity.

768768

“多重登录选项”下拉菜单使您可以决定,如果用户在多次尝试登录系统的同时,系统多次弹出许可证信息窗口,则应当执行哪项操作。您可以从以下选项中进行选择:

  • Continue with this logon and end any other logons in system
  • Continue with this logon, without ending any other logons in system
  • Terminate this logon

SAP 菜单

允许您从 SAP 菜单中选择项目。SAP 菜单仅在 SAP WinGUI 主窗口中可用。

528528

You can use the SAP Select Menu Item activity to interact with a menu item.

535535

📘

备注:

Studio 中的“录制”功能不支持此 SAP 控件。

SAP 图片

在 SAP WinGUI 中显示图片。

706706

You can use the SAP Click Picture on Screen activity to click the specified image.

508508

📘

备注:

Studio 中的“录制”功能不支持此 SAP 控件。

SAP 状态栏

代表 SAP WinGUI 窗口底部的一个部分,用于显示消息。它不显示系统和登录信息。

535535

You can use the SAP Read Statusbar activity to extract the message type, text, and data from the SAP Statusbar.

507507

📘

备注:

Studio 中的“录制”功能不支持此 SAP 控件。

SAP 会话信息

显示有关当前 SAP 会话的详细信息,例如系统、客户端、登录的用户或当前打开的程序和事务。

285285

The following optional selector attributes are available in UIExplorer, and can be used with other activities such as the Get Attribute activity when you build your SAP automation:
sapClient, sapLanguage, sapProgram, sapScreen, sapSession, sapSysName, sapSysNumber, sapSysSessionId, sapTransaction, sapUser

713713

SAP 选项卡

SAP 选项卡代表一组按钮,可让您访问特定的信息和控件。

580580

You can use the Click activity to select a single tab at a time, or you can use the Select Item activity to choose the tab of interest from a list.

特殊自动化用例

当在选取器中使用通配符时,某些 SAP 事务名称中会带有斜杠 /,这可能会导致识别问题。

例如,在 SAP 事务 /COCKPIT/1 中,事务中某个 SAP 选项卡的选取器可以是:
<sap id='usr/subSUB_MAIN:/COCKPIT/SAPLDISPLAY46:0389/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

The dynamic part of selector is: SAPLDISPLAY46:0389, where the number 0389 is dynamically changing and does not allow a stable identification.

选取器的结构为:

17361736

为了稳定识别,您需要在层次结构分隔符之间使用通配符,然后需要用 ? 替换这些分隔符/斜杠之间的所有(仅限)斜杠

<sap id='usr/subSUB_MAIN:/COCKPIT/SAPLDISPLAY46:0389/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' /> 之前
<sap id='usr/subSUB_MAIN:?COCKPIT?SAPLDISPLAY46:038*/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' /> 之后

SAP 表格

SAP 表代表标准控件集,适用于以表格结构显示的元素。

常用操作

在 SAP 中,有多种类型的表可用。最常用的是标准(默认)表、网格表和 ALV 表。您可以使用 Studio 自动化所有类型的 SAP 表。

您可以使用以下活动与 SAP 表及其内容进行交互:

SAP 标准表格

如上所述,“SAP 标准表”支持所有可用的常见操作。

19041904

SAP 网格表

如上所述,“SAP 网格表”支持所有可用的常见操作,以及“选择”/“取消选择”操作和“数据抓取”操作。

11831183

选择/取消选择

With help of the Click activity or the Check activity you are able to perform all the necessary operations during your SAP automation project, such as:

  • 选择/取消选择列
  • 选择/取消选择行
  • 选择/取消选择全部
922922

数据抓取

Data scraping enables you to extract structured data from SAP Tables, as exemplified below.

如果您要自动化包含多个具有相同名称的列的表格,则抓取机制将自动增加列名称(例如,column1column2column3 等)。

The Extract Structure Data activity provides additional possibilities while extracting the data from the SAP GridView table. You can use the following values for the columns_name_source parameter to define the way you want to get the table information:

  • 最长长度 - 提取和使用列的全名。
  • 最短长度 - 提取和使用列的简短名称。
  • 已显示 - 使用 SAP WinGUI 中的可见/显示名称。
  • 技术 - 提取和使用列的技术标题名称。
  • 工具提示 - 将鼠标悬停在列名称上后显示的工具提示名称。
679679

SAP ALV 表格

如上所述,“SAP ALV 表”支持所有可用的常见操作,以及用于简单和多个标头表的“数据抓取”操作和“屏幕抓取”操作。可以在 SAP 屏幕上提取一个或多个 ALV 表格。

14111411

数据抓取

这种工作方式与上述“SAP 网格表”的“数据抓取”中提到的方式完全相同。请注意,在某些情况下,列工具提示名称可能与“SAP ALV 表格”中的显示名称不同。

使用 columns_name_source='Tooltip' 参数定义获取表格信息的正确方法。

多个标头表

UiPath Studio 可以从标头分布在两行或更多行的表格中提取适当的数据。

16731673

为此,元数据公开了以下内容:

join_type = ['LeftOuter' | 'Inner']

这些选项与具有各自名称的 SQL 联接相对应。左侧外部联接还会提取仅包含第一个标头的行。其他缺失的列值将填充 NULL 占位符文本:null_value_text = ['(null)' | 'any other user provided value']

内部联接仅提取包含完整数据的行,而忽略所有标头中不包含数据的行。

屏幕抓取

如果您决定使用“屏幕抓取”,建议使用“全文”抓取方法,并且应选中“忽略隐藏项”复选框。请注意,使用此方法只能提取 SAP 屏幕上的可见文本。

14061406

To learn more about Screen scraping, please visit this page.

颜色索引

“颜色索引”、“颜色增强”和“颜色反转”属性用于标识元素的背景颜色。

773773

这可用于机器人流程自动化和测试自动化场景。

Attribute NameObject Type
ColorIndexint32
ColorIntensifiedboolean
ColorInverseboolean

SAP ALV 层次结构表

SAP ALV 层次结构表表示在具有层次结构的表格中组织的元素列表。

15311531

You can use the Expand ALV Hierarchical Table activity to identify any cell inside SAP ALV Hierarchical Table. After the identification of the cell, all typical UI activities can be performed, such as Click, Double Click, Get Text, and others.

有两种方法可以使用活动:在设计时或在运行时。

Design time

在设计时,您必须选择表格中任何感兴趣的单元格。该活动将捕获此单元格在活动中的坐标。您可以随时进行更改。

运行时间

目标单元格设置为焦点,并且相应的用户界面元素作为输出参数返回。

在表格内导航

例如,我想获取有关特定航空公司 (AA) 和特定航班号 (17) 的航班时间 (6:01) 的信息。

15421542

级别/重点列:定义将哪个元素设置为重点。
级别 0/标题列:定义要在标题列中查找的列和值。
级别 1/位置列:定义要在位置列中查找的列和值。

包含 6:01 的单元格的坐标存储为“输出值”,变量类型为“用户界面元素”。

SAP ALV 树列表

“SAP ALV 树”表示以树状结构组织的元素列表。

13021302

You can use the Expand ALV Tree activity to select an ALV node and display the node path in the activity. This enables you to use any other supported activities to work with the specified element.

420420

SAP 文本编辑器

SAP 文本编辑器控件表示可编辑的文本字段/编辑器。

561561

您可以使用以下活动与此控件进行交互:

SAP 工具栏

SAP 工具栏代表一组按钮,您可以与这些按钮进行交互。在 SAP 中,有多种类型的工具栏,具体视 SAP 事务或 SAP 程序而定。

13201320
  • SAP 系统工具栏 (1)
  • SAP 应用程序工具栏 (2)
  • SAP 特殊工具栏 (3)
  • SAP 网格表工具栏 (4)
  • SAP 通用对象服务 (5)

You can use the Click Toolbar Button activity to interact with buttons inside the toolbars.

535535

📘

备注:

Studio 中的“录制”功能不支持此 SAP 控件。

SAP 事务代码

表示字母数字代码,使您可以访问 SAP 函数或运行 SAP 程序。

Only the transaction code is required when you use the SAP Call Transaction activity.

事务代码在当前的 SAP GUI 窗口中执行。

426426

📘

备注:

提供事务代码(例如 VA01)时,活动将发送 /nVA01 + Enter (keystroke) 命令以调用事务。

请注意,当前事务中未保存的更改将弃用且不会发出警告。

SAP 树

SAP 树表示以树结构组织的元素列表。有几种类型的 SAP 树控件可用:

  • 简单树
167167
  • 列表树
427427
  • 列树
598598

You can use the Click, Double Click, or the Get Text activity to interact with a node or an item in any of the SAP Tree control types.

📘

备注:

与 SAP 树进行交互时,建议使用“模拟单击”属性。

展开树

如果树中包含大量子元素,则选项如下:

  1. 在 SAP WinGUI 中展开树,然后选择感兴趣的元素。
  2. 使用“在屏幕上指定”选中整个 SAP 树。

所选项目的节点显示在活动中。

📘

备注:

Studio 中的“录制”功能不支持此 SAP 控件。

If the tree is collapsed and the node or item of interest is not visible, you need to use the SAP Expand Tree activity, which expands the parent tree to an active node or an active item.

426426

4 个月前更新

支持的 SAP WinGUI 元素


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

您只能建议对 Markdown 正文内容进行编辑,而不能建议对 API 规范进行编辑。