Dynamically Set the Client Sequence File

TestStand 2017 Help

Edition Date: November 2017

Part Number: 370052W-01

»View Product Info

Download Help (Windows Only)
NI TestStand 2014 Help
NI TestStand 2014 SP1 Help
TestStand 2016 Help
TestStand 2016 SP1 Help
TestStand 2017 Help

Purpose

This example demonstrates how to dynamically specify a client sequence file. This example uses the Execution.ClientFile property to set the client sequence file of the process model.

Example File Location


Open Example

<TestStand Public>\Examples\Modifying Process Models\Dynamically Setting the Client Sequence File\Dynamically Set the Client Sequence File.seq

Highlighted Features

Major API

Prerequisites

None

How to Use This Example

When you run this example, TestStand prompts you to select Sequence A or Sequence B to run as the client sequence file of the process model. Run the example several times using the Test UUTs or Single Pass Execution entry points and review the report, which includes information relevant to the sequence file you selected.

Open the process model plug-in file, DynamicClientFileExampleModelPluginAddon.seq, associated with this example. Notice that the Model Plugin - Pre UUT sequence sets the Execution.ClientFile property to the file you select at run time.

Note Note  By default, TestStand might not unload dynamically selected client files before execution completes. For more information, review the comment on the Unload Unused Client File step in the Model Plugin - Pre UUT and Model Plugin - Pre Batch sequences in DynamicClientFileExampleModelPluginAddon.seq.

Complete the following steps to use this example.

  1. Open <TestStand Public>\Examples\Modifying Process Models\Dynamically Setting the Client Sequence File\Example -Dynamically Set the Client Sequence File.seq, read the dialog box that appears, and dismiss the dialog box.
  2. Select Execute»Single Pass. Select the sequence you want to run when prompted.
  3. Review the report that TestStand displays when execution completes.
  4. Repeat steps 2-3 but select Execute»Test UUTs to run the sequence using the Test UUTs Execution entry point.

The example copies the DynamicClientFileExampleModelPluginAddon.seq file from the <TestStand Public>\Examples directory to the <TestStand Public>\Components\ModelsPlugins\Addons directory so that the process model automatically executes the Model Plugin - Pre UUT sequence in the file. If you want to set a breakpoint in the Model Plugin - Pre UUT sequence, set the breakpoint in the copy of the file in the <TestStand Public>\Components\ModelsPlugins\Addons directory. If you make any changes to the file in the Addons directory you must change the name of the file because the Example - Dynamically Set the Client Sequence File.seq file overwrites the DynamicClientFileExampleModelPluginAddon.seq file in the Addons directory when you load the Example - Dynamically Set the Client Sequence File.seq file and deletes the DynamicClientFileExampleModelPluginAddon.seq file from the Addons directory when you unload the Example - Dynamically Set the Client Sequence File.seq file.

To select Test UUTs and Single Pass without requiring any sequence file to initially be open, enable the Entry Point Ignores Client File option and the Show Entry Point for All Windows option on the Model tab of the Sequence Properties dialog box for each execution entry point sequence in the custom process model or in a copy of the TestStand process model. Sample Process Model for initiating Testing Without an Active Sequence File Window.seq is an example of a custom model that does this.

WAS THIS ARTICLE HELPFUL?

Not Helpful