Purpose

This example demonstrates how to use the Property Loader step to dynamically load step limits from different text files depending on user input.

In the Setup step group of the MainSequence, the Message Popup step launches a dialog box to prompt the user to choose which file TestStand uses to load limits values. The Select Limit File Statement step in the Setup step group selects the limit file. The expression for this step uses a conditional operation in which TestStand loads limits from RevisionALimits.txt when the value of the Result.ButtonHit property equals 1. The expression specifies that TestStand loads limits from RevisionBLimits.txt for all other cases.

When you write a sequence in which the user must choose between three or more limit files, use a Property Loader step for each limit file and use a precondition for each step that checks for user input. For example, when the Message Popup step specifies four buttons, each Property Loader step can check which button was clicked in the precondition.

Example File Location

<TestStand Public>\Examples\Built-In Step Types\Property Loader Step Type\Property Loader - Loading Limits From Different Files.seq

Highlighted Features

  • Property Loader steps
  • ReportOptions callback

Major API

None

Prerequisites

None

How to Use This Example

Complete the following steps to review the sequence functionality.

  1. On the Steps pane, select the Property Loader step in the Setup step group.
  2. On the Step Settings tab of the Step Settings pane, confirm that the source location in the sources table specifies the Locals.LimitFileToLoad variable. The value of this variable at run time determines which file TestStand loads.
  3. Navigate to the <TestStand Public>\Examples\Built-In Step Types\Property Loader Step Type directory and review the RevisionALimits.txt and RevisionBLimits.txt files. Each file specifies a different set of limit values for the sequence.
  4. On the Steps pane, select the Select Limit File step, which is an instance of a Statement step type. This step sets the Locals.LimitFileToLoad variable to the correct value depending on which file the user selects.

Complete the following steps to run this example.

  1. Select Execute»Single Pass to run the sequence.
  2. When prompted, select the Revision A Limits option.
  3. When execution completes, review the report on the Report pane. The report indicates that all steps passed.
  4. Select Execute»Single Pass to run the sequence again.
  5. When prompted, select the Revision B Limits option.
  6. When execution completes, review the report on the Report pane. The report indicates that not all steps passed because of the different set of limit values. The step results have not changed.