支持的 SAP GUI for Java 元素

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

SAP 按钮

表示 SAP GUI for Java 窗口中的任何按钮。有几种类型，每种类型由特定元素来定义：

图标

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

普通按钮

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

单选按钮

单选按钮显示一组选项。列表中至少包含两个单选按钮，您只能选择一个。

可以使用“单击”活动与按钮交互。

SAP 复选框

复选框元素显示包含多个选项的列表。您可以选择一个或多个选项，也可以不选择任何选项。

可以使用“单击”活动与复选框交互。

SAP 上下文菜单

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

您可以使用 Java 选取器和“单击”活动与 SAP 上下文菜单交互。

SAP 对话框

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

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

如果要使用“ 关闭” 按钮关闭对话框，则需要使用 AA 元素检测框架。

可以使用 UIAutomation 活动（例如“单击”或“输入信息”）与对话框交互。

SAP 下拉列表

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

可以使用“选择项目”活动与列表项目交互。

SAP 输入字段

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

您可以使用“输入信息”活动与输入字段交互。

SAP 登录

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

您可以使用“单击”活动打开 SAP。

SAP 状态栏

表示 SAP GUI for Java 窗口底部显示消息的部分。此部分不显示系统和登录信息。

你可以使用“获取属性”活动从 SAP 状态栏读取状态属性。

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

SAP 会话信息

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

UI Explorer 中提供了以下可选的选取器属性，在构建 SAP 自动化时，可以将这些可选属性与其他活动配合使用，例如“获取属性”活动：

sapClient、sapLanguage、sapProgram、sapScreen、sapSession、sapSysName、sapSysNumber、sapSysSessionId、sapTransaction、sapUser

SAP 选项卡

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

可以使用“单击”活动一次选择一个选项卡，也可以使用“选择项目”活动从列表中选择相关选项卡。

特殊自动化用例

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

例如，在 SAP 事务 /COCKPIT/1 中，事务中某个 SAP 选项卡的选取器可以是：

<sap id='usr/subSUB_MAIN:/COCKPIT/SAPLDISPLAY46:0389/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

选取器的动态部分为 SAPLDISPLAY46:0389，其中数字 0389 会不断变化，因此无法稳定识别出来。

选取器的结构为：

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

在 <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 表。所有类型的 SAP 表格都可以使用 Studio 进行自动化。

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

• 单击
• 获取文本
• 键入
• 选中

SAP 标准表格

SAP 标准表支持以下通用操作：

• 单击
• 获取文本
• 键入
• 选中

SAP 网格表

SAP 网格表支持“选中/取消选中”操作、数据抓取和以下常见操作：

• 单击
• 获取文本
• 键入
• 选中

选择/取消选择

使用“单击”活动或“选中”活动，您可以在 SAP 自动化项目中执行以下操作：

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

数据抓取

数据抓取用于从 SAP 表中提取结构化数据。

如果您正在对包含多个名称相同的列的表格进行自动化，抓取机制会自动增加列名称（例如：column1，column2，column3 等）。

从 SAP 网格视图表提取数据时，“提取结构化数据”活动提供了更多可能性。您可以将以下值用于 columns_name_source 参数，以定义获取表格信息的方式：

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

SAP ALV 表格

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

数据抓取

它的工作原理与之前提到的 SAP 网格表数据抓取类似，以下情况除外：

备注：

• 不支持水平滚动。表格必须屏幕上水平排列，并且完整显示。任何超出可见范围的列都不会被抓取。

• 一个单元格不支持多行。

• 在某些情况下，列工具提示名称可能与 SAP ALV 表中的显示名称不同。

屏幕抓取

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

如需了解有关屏幕抓取的更多信息，请访问此页面。

SAP 文本编辑器

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

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

• 文本字段的“输入信息”活动。
• 支持热键的按钮的“发送热键”活动或按钮的“单击图像”活动。

SAP 工具栏

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

• SAP 系统工具栏
• SAP 应用程序工具栏
• SAP 特殊工具栏
• SAP 网格表工具栏
• SAP 通用对象服务

可以使用“单击”活动与工具栏中的按钮交互。

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

SAP 树

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

• 简单树

  

• 列表树

  

• 列树

  

您可以使用“ 单击 ”或“ 获取文本” 活动与任何 SAP 树控件类型中的节点或项目交互。

注意：我们建议您在与 SAP 树交互时使用“模拟单击”属性。