在TestStand中以编程方式创建File Global Variables

更新 Nov 6, 2023

环境

软件

  • TestStand

此文档将介绍如何通过编程方式在 TestStand sequence 中创建一个 Sequence File Global variables。

您可以在TestStand sequence 或在代码模块(code module)中使用TestStand API创建序列文件全局变量(Sequence File Global variable)。下列TestStand API方法可用于创建各自类型的新变量:
  • SetValNumber()
  • SetValBoolean()
  • SetValString()
  • SetValVariant()
  • SetValIDispatch()

可以将以下指令插入TestStand序列文件中 Statement 步骤中,以创建新的File Global变量:
RunState.Main.SequenceFile.FileGlobalsDefaultValues.SetValNumber("Numeric1",PropOption_InsertIfMissing,5)

其中
  • Numeric1是变量的名称
  • PropOption_InsertIfMissing属于“Property Option(属性选项)”的其中一个类,若变量名称不存在,这方法将通过  SetVal 和/或 GetVal插入新的变量或属性。
  • 代表变量的值

对于其他解决方案,您可以按照此教程:Programmatically Creating Variables in TestStand 在TestStand中编程方式创建变量


附加信息

此方法会将 file global 添加到当前执行的 TestStand sequence 中。但是,它不会成为原始 TestStand sequence file 的一部分。如果要将 file global 添加到原始 sequence file 中,请在code module 中或使用ActiveX / COM适配器在 sequence 中使用以下API调用:
  1. 获取对 sequence file 的FileGlobalsDefaultValues
    ActiveX / COM reference: Sequence File
    Automation Server: TestStand API (您的当前版本号 #)
    Object Class: Sequence File
    Action: Get Property
    Property: FileGlobalsDefaultValues
    Return Value: Locals.FileGlobalsReference
  2. 使用此引用,通过SetVal*方法之一(上面列出的任何函数,例如 SetValNumber() )并将options设置为1(如果缺少则插入)插入新 file global 。通过 FileGlobalsDefaultValues 创建 file global,该值将存储在原始 TestStand sequence file 中。

    ActiveX / COM reference: Locals.FileGlobalsReference
    Automation Server: TestStand API (您的当前版本号 #)
    Object Class: Property Object
    Action: Call Method
    Method: SetVal*
    lookupString: "FileGlobals.NewFileGlobal"
    Options: 1
    newValue: 123