处理 TestStand 运行时错误

更新 Oct 28, 2024

环境

软件

  • TestStand

操作系统

  • Windows

当TestStand 运行时发生错误,用户需要着重注意错误讯息以及错误窗口提供了哪些措施或建议来处理错误。 TestStand 不止拥有自带的默认内置错误报告机制,同时也为用户提供自定义错误报告机制所需的工具。本教程将展示三种不同的错误处理方法。

通过 Run-Time Error 对话框处理错误

默认情况下,TestStand 会在发生错误时显示Run-Time Error 对话框。这允许您以交互方式处理运行时错误,并且在构建和排除测试序列时非常有用。

Run-Time Error 对话框列出了错误的步骤和原因,然后提示您处理错误的选项。提供的四个选项如下:
  • Run Cleanup - 一般推荐。运行 Cleanup 步骤通常会关闭在 sequence file 步骤可能已打开的资源。若这些资源并未及时关闭或清理,可能会导致进一步的软件或硬件问题。
  • Retry - 重试该步骤以确认这次运行结果是否正确。例如,您的 sequence file 需要测试硬件调用,由于之前忘了启动该硬件导致出现错误,再次启动该硬件并需要重新运行,可使用此选项。
  • Ignore - 忽略步骤抛出的任何错误并继续执行 sequence。
  • Abort Immediately (no cleanup) - 通常不推荐。如果没有需要关闭的资源或者在紧急情况下需要立即退出程序,可选择此选项。
有关这些选项的更多说明,请参阅TestStand API Reference: Run-Time Error Dialog Box


通过 Station Options 定义 On Run-Time Error

您可以通过配置 On Run-Time Error 设定来选择您需要的错误处理方式。如果不是开发人员操作 TestStand,通常建议设定 On Run-Time Error。
  1. 在 TestStand Sequence Editor 中,导航到 Configure >> Station Options
Station Options 对话框将出现。
  1. 导航到“Execution”选项卡。
  2. On Run-Time Error下拉列表中选择所需的行为。有关选项的更多信息,请参阅TestStand API Reference: Execution Tab - Station Options Dialog box
手机截图描述已自动生成
  1. 单击确定

 

自定义错误处理

如果您想完全控制如何向用户显示错误,请使用SequenceFilePostStepRuntimeError engine callback来创建一个在发生错误时执行的自定义序列。错误信息将通过序列参数提供给此 callback。

请参阅 TestStand User Manual: Overriding Engine Callback - SequenceFilePostStepRuntimeError 示例,了解如何自定错误处理。

注意:在 TestStand 2013 及之前的版本中,此示例名为ErrorHandlerExample.seq ,位于<TestStand Public>\Examples\Callbacks\PostStepRuntimeErrorCallback\中。