Customize UUT Information Dialog Box in TestStand

I want to customize the Unit Under Test (UUT) Information dialog box in TestStand to include fields such as a part number or other custom information.

To customize the UUT Information dialog box, you first need to understand the PreUUT Model Callback. The default UUT dialog box appears in the shipping Sequential (shown below), Batch, and Parallel process models as part of the DoPreUUT sequence, which is located in the PreUUT Model Callback.

To become more familiar with this model callback, follow the Viewing Model Callbacks tutorial in the TestStand Help.

While examining the PreUUT callback, pay attention to the parameters of this subsequence.

Parameters.UUT contains fields that your custom UUT dialog can populate. For example, your dialog can set the value of Parameters.UUT.PartNumber. You can also populate Parameters.UUT.AdditionalData to include more detailed information about the UUT, as demonstrated in the Adding Items to a TestStand Report Header at Run-Time KnowledgeBase article and the Adding Custom Data to a Report TestStand example.

Another important parameter to highlight is Parameters.ContinueTesting. Your custom dialog must set this boolean value to indicate whether TestStand should continue executing the test sequence. For example, if the user clicks Cancel or closes the dialog without entering the Serial Number or Part Number, this parameter should be set to False, causing the execution to stop.

Regarding how to implement the UUT dialog, there are essentially two approaches:

1. Create a Custom Dialog Box
2. Customize the Existing UUT Information Dialog Box

Create a Custom Dialog Box

You can create your own dialog box using any programming language supported by TestStand.

1. Create the UI for the custom dialog box.

   • You may refer to the Creating Quality Dialog Boxes in LabVIEW for best practices.

   • Here is an example VI for your reference.

     
     
     
     
     
     

2. Add the PreUUT Model Callback subsequence to your sequence file.

   1. On the Sequences Pane, right-click and select Sequence File Callbacks…
   2. Check PreUUT and click OK.
   3. Delete or Skip the DoPreUUT step, because you want to modify the default behavior.

3. Add an action step to the PreUUT sequence and configure it to use your custom dialog code as the module.

   1. Make sure you connect the outputs of the code module to the correct parameters.

      
      
      
      
      

4. Go to Execute >> Test UUTs and observe your dialog showing up.

Customize the Existing UUT Information Dialog Box

You can directly modify the source code for the stock dialog box included with TestStand.

1. Navigate to the TestStandModels directory in the TestStand Public directory.

    

   If you have not done so already, copy the folder from:

   <TestStand>\\Components\\Models\\TestStandModels
   

   to:

   <TestStand Public>\\Components\\Models\\

    

    

2. Open the modelsupport2.prj LabWindows™/CVI™ project, located at <TestStand Public>\\Components\\Models\\TestStandModels\\modelsupport2

   • This project builds modelsupport2.dll, which implements the default UUT Information dialog box.

3. In the project, open modelpanels.uir to modify the dialog box layout.

   
   
   
   
   

4. To change dialog box behavior, edit the DisplayUUTInformationDialog() function in uutdlg.c.

   
   
   
   
   
   

5. To customize default text strings in the dialog box:

   • In uutdlg.c, comment out the relevant function calls in the Get internationalized strings section (lines 47–55).

   • This prevents the DLL from loading strings from the Program Files .ini file and instead uses the strings defined in modelpanels.uir.

     
     
     
     
     
     

Additional Information

Customizing the dialog box source code requires rebuilding modelsupport2.dll. Ensure you maintain backups of the original source and understand the deployment implications of modifying model components.

The codes used in the Create a Custom Dialog Box section are available at the bottom of the page on versions 2022 and 2025 of LabVIEW and TestStand.