User interface(用户交互)

本类别介绍用于用户交互的 test step(测试步骤)。

Info

除 Image dialog test step 外, 这些 test step 在使用 ecu.test Runner 执行测试时 无法使用,因为它们需要用户交互,而 ecu.test Runner 无法进行用户交互。

此时,这些 test step 在报告中判定为 ERROR。

Select list(选择列表)

该 test step 会在程序运行期间向用户显示一个选择对话框,并要求用户选择一定数量的元素。

../../../_images/Utility_Auswahlliste.png
  • Dialog title 用于指定显示窗口的标题(文本或变量)。

  • 下一行可向用户显示一个 Description(文本或变量)。

  • Save user input in 用于指定变量名,用户选择的元素会以列表形式保存到该变量中。

  • Maximize 用于指定对话框是否以全屏方式显示。

  • Minimum and maximum selection 用于指定用户至少和至多必须选择的元素数量。如果两个数值都为 0,则可以任意选择元素数量。

  • Preselection 确保指定的元素会被预先选中。 用户可在测试执行期间修改该选择。 预选元素由值或索引列表定义。 预选中的整数输入既按列表索引、也按元素值进行解析。 例如,预选“[0]”会同时选中列表的第一个元素和数值 “0”(如果存在)。

  • Read items from variable 用于在程序运行期间从变量中读取指定元素。为此,该变量必须以列表形式包含这些元素。

  • 也可以直接输入元素。第一个按钮用于创建新元素,第二个按钮用于删除选中的元素,箭头按钮用于调整元素顺序。可输入字符串(用单引号括起)或变量。

Image dialog(图像对话框)

该 test step 用于显示一张图片。

../../../_images/Utility_Bilddialog.png
  • Dialog title 用于指定显示窗口的标题(文本或变量)。

  • 下一行可向用户显示一个 Description(文本或变量)。

  • Save user input in 用于指定变量名,用户按下的按钮会保存到该变量中。

  • Maximize 用于指定对话框是否以全屏方式显示。

  • Image file 用于指定要显示的图像名称(包含路径,可为文本或变量)。选择按钮可直接在硬盘上选取文件。

  • Timeout 用于指定超时时间(毫秒)。超时后,对话框会通过标准按钮自动关闭(始终是第一个按钮,并以粗体显示)。

  • 下方窗口中可配置要显示的按钮。单击第一个图标会打开用于新增按钮的对话框。在该对话框中,需要输入按钮标签(Identifier)和 Return value(即按下按钮时要保存到 Save user input in 中的值)。这些输入既可以是固定值,也可以是变量。后续图标用于删除或重新排序按钮;双击即可编辑按钮。

Input dialog(输入对话框)

该 test step 提供一个对话框,用户可以在其中输入各种内容。

../../../_images/Utility_Eingabedialog.png
  • Dialog title 用于指定显示窗口的标题(文本或变量)。

  • 下一行可向用户显示一个 Description(文本或变量)。

  • Save user input in 用于指定变量名,所有输入值都会以列表形式保存到该变量中。

  • Maximize 用于指定对话框是否以全屏方式显示。

  • Automatically abort after 用于指定一个可选超时时间,超过该时间后该 test step 会被中止。

  • 下方可配置不同的输入字段。第一个红色图标用于删除输入字段,但至少保留两个输入字段时该图标才可用。可通过下方的绿色图标新增输入字段。字段 Identifier 用于输入输入框标签,然后选择输入类型(选择、单行、多行等)。后续图标可用于配置具体设置,例如默认文本。当用户将鼠标移到输入字段上方时,会显示工具提示。Save as 用于建议保存该输入值的变量名称。字段 Identifier 和 Tooltip 支持输入文本(用单引号括起)或变量。

Infoblock(信息块)

在执行 Infoblock 的子 test step 期间,会显示一个包含用户自定义且可能动态变化内容的对话框(也称运行时对话框)。该对话框的外观可尽可能通过 HTML 标记进行定制,因此可以嵌入图片和超链接。

Infoblock 中要显示的内容在 test step 对话框的 Display text 字段中输入。可以在花括号中嵌入 Python 表达式,例如测试用例变量。由于运行时对话框会周期性刷新,因此这些变量在 Infoblock 内被子 test step 修改后,也会同步反映到显示内容中。

当 test step 执行离开 Infoblock 时,运行时对话框会自动关闭。还可以选择在对话框中添加用于手动中止 Infoblock(或整个测试用例)的中止按钮。此外,也可以通过指定超时时间启用自动中止。

如果 Infoblock 不包含任何子 test step,运行时对话框中会显示一个 Next 按钮。执行会暂停,直到用户按下该按钮。

../../../_images/Utility_Infoblock_TsDialog.png
  • Block name 用于定义运行时对话框的标题(仅支持文本)。

  • Display text 用于指定在运行时对话框中显示并周期性更新的文本。支持 HTML 标记,例如可用 “<br>” 表示换行;Python 表达式则写在花括号中。

  • Dialog size 用于定义运行时对话框尺寸(宽度 x 高度,单位为像素)。

  • Maximized 用于指定是否以最大化方式显示对话框。

  • Allow block abort 用于显示或隐藏手动中止该 block 的按钮。

  • Automatically after 用于在达到用户定义的超时时间(秒)后自动中止该 block。

  • Allow test abort 用于显示或隐藏手动中止整个测试用例的按钮。

示例(各截图对应的 Display text 配置见下方):

  • 未格式化显示变化中的变量值:
    utility_info_image1
Current velocity: {Speed} km/h
  • 格式化显示变化中的变量值:
    utility_info_image2
<font color="{getRpmColor(Rpm)}">
  Current Rpm: {Rpm} rpm
</font>
<br>
<br>
Current velocity: {Speed} km/h
  • 带嵌入图片和超链接的用户提示:
    utility_info_image3
<html>
  <body bgColor="#F29100">
    <center>
      <div>
        <font size="24">
          Please start engine!
        </font>
      </div>
      <div>
        <img src="Packages\User Feedback\InfoBlockDemo.png">
      </div>
      <div>
        <a href="http://www.tracetronic.de">
          Click here for further information
        </a>
      </div>
    </center>
  </body>
</html>

Message dialog(消息对话框)

该 test step 向用户显示信息、问题、警告或错误。用户必须通过某个按钮关闭该显示,在此期间执行会暂停。

../../../_images/Utility_Meldung.png
  • Dialog title 用于指定显示窗口的标题(文本或变量)。

  • 下一行可向用户显示一个 Description(文本或变量)。

  • Save user input in 用于指定变量名,用户按下的按钮会保存到该变量中。

  • Maximize 用于指定对话框是否以全屏方式显示。

  • Type of message 用于指定消息类型,例如 information、question、warning 或 error。

  • Timeout 用于指定超时时间(毫秒)。超时后,对话框会通过标准按钮自动关闭(始终是第一个按钮,并以粗体显示)。

  • 下方窗口中可配置要显示的按钮。单击第一个图标会打开用于新增按钮的对话框。在该对话框中,需要输入按钮标签(Identifier)和 return value(即按下按钮时要保存到 Save user input in 中的值)。这些输入既可以是固定值,也可以是变量。后续图标用于删除或重新排序按钮;双击即可编辑按钮。