Logging Additional Results to a Database in TestStand

Updated Feb 26, 2026

Environment

Software

  • TestStand

This tutorial explains how to add additional results to a database in TestStand. Select the section that corresponds to your TestStand version for detailed instructions.

 

 

Table of Contents

 

 

Before You Start

 

Before using any of the methods described below, ensure that the Database model plugin is enabled.

 

Go to Configure » Results Processing, and verify that the Enabled checkbox for the Database plugin is selected.

 

Also confirm that the plugin is configured with a valid connection string and schema. By default, TestStand provides:

  • A valid connection to an Access database (TestStand Results.mdb)
  • A valid schema named Generic Recordset (NI)

 

If you keep these defaults, you should be able to complete the steps below without issues.

 

For instructions on configuring the example database connection, refer to the following articles:

 

 

Method 1: Additional Results Step Type

 

 

In this method, you add a dedicated step that logs a custom result directly to the database.

Results created this way are stored in the PROP_RESULT table.

 

Follow these steps to configure the MainSequence:

  1. Add an Additional Results step type to your sequence file.

  2. Select Add Custom Result.


    Add Custom Result button
  3. Fill in the Name field with a string literal (using double quotes), and set Value to Log to the data you want to store.


    Name and Value to Log fields
    Note: You may also use the value of a string variable to populate the Name field.

     

  4. Run the sequence using Single Pass or Test UUT. After execution, the custom result will appear in the PROP_RESULT table.

  5. Go to Configure » Result Processing…

  6. Click Options.

  7. In the Logging/Data Link Options tab, select View Data to open the TestStand Database Viewer.

  8. Right‑click the PROP_RESULT table and select View Data.


    TestStand Database viewer - selecting the option to view data from PROP_RESULT

  9. (Optional) Hide unwanted columns so only NAME and DATA remain (right‑click a column → Hide This Column).


    Hide This Column shortcut menu

  10. Alternatively, run the query below in the top panel of the viewer to return only the NAME and DATA fields:

    SELECT NAME, DATA FROM [PROP_RESULT]
    

    Use the Execute button (green play icon) to run the query. The results appear in the Results tab.

     

    SQL and returned results in the TestStand Database Viewer

 

[Back to TOC]

 

Method 2: Additional Results Property of a Step

 

 

  1. Select the step you want to log additional results from.

  2. In the Step Settings pane, go to the Properties tab and select Additional Results.

  3. Click +, then enter the Name and Value to Log fields as in Method 1.


    Additional Result property of an Action Step

  4. Run the sequence using Single Pass or Test UUTs.

  5. To view the logged data, follow the same steps used in Method 1:

    • Configure » Result Processing…
    • Options
    • Logging/Data Link Options » View Data
    • Open the PROP_RESULT table
  6. You should now see a table containing both new and previously logged custom properties.

     

    PROP_RESULTS Table

     

     

  7. Note that the STEP_RESULT column shows the same value (e.g., 4) for both custom results, since they belong to the same step.

  8. To filter results for that specific step, run:

    SELECT NAME, DATA FROM [PROP_RESULT] WHERE STEP_RESULT = 4
    

    (Your STEP_RESULT value may differ; confirm it in Step 6.)

  9. You will now see only the results associated with that step.


    results returned by the query above.

 

[Back to TOC]

 

Method 3: Adding Additional Results from Code Module Parameters

 

 

  1. Select the step.

  2. In the Step Settings pane, go to the Module tab and configure your code module.

  3. If the code module contains an output parameter you want to log, enable the checkbox under the Log column.

    The step will now automatically include a corresponding Additional Result entry.



    Scaling Factor output with LOG checked for a LabVIEW code module

  4. (Optional) Switch to the Properties tab and open Additional Results. You’ll see that the parameter has already been added.

    TestStand appends the suffix [Out] to indicate this value comes from a code module output.

  5. Run the sequence using Single Pass or Test UUTs.

  6. To view the logged data, follow these steps (same as Method 1):

    • Configure » Result Processing…
    • Options
    • Logging/Data Link Options » View Data
    • Open the PROP_RESULT table
  7. Use this query to locate your code‑module output result:

    SELECT NAME, DATA FROM [PROP_RESULT] WHERE NAME = "Scaling Factor [Out]";
    
  8. Observe the returned value.


    result returned by the query above.

 

[Back to TOC]