Table Of Contents

Acquiring Test Results

Version:
Last Modified: November 7, 2019

Create test steps to record your tests and measurement data.

What to Use

You can find the SystemLink Test Monitor and Configuration APIs on the Data Communication palette in LabVIEW 2018 or later.
spd-note-note
Note  

The SystemLink Configuration API is available in LabVIEW 2016 or later.

What to Do

On the client, create the following code in a VI to create test results and steps, run a test sequence, structure your data to render it correctly in the Test Monitor UI, and acquire results. The code is split into three images to highlight specific functions throughout the VI. Therefore, you must add all the code captured in this topic to a single diagram in a VI.

Customize the gray sections for your unique programming goals.

  1. Add the following code to initialize and create test results on the server.
    Open Configuration initiates a connection to the server.
    Initialize Test Result configures a local reference of the new test result on the client test system.
    spd-note-note
    Note  

    The local reference does not exist on the server until you wire this VI to Create Test Result.

    The Property Node sets properties to the test result. You can see these properties in the Test Monitor UI.
    Create Test Result adds the local test result reference to the server with the properties you set.
  2. Add the following code to the diagram to initialize and create test steps associated with the test results, and generate named values to format test data.
    Initialize Test Step From Result configures and associates a local reference of a test step to the test result you created.
    spd-note-note
    Note  

    You must add the test result to the server before you can associate any test step(s) with it. Therefore, call this VI after you call Create Test Result. Furthermore, since this VI creates only a local reference to the test step, you must call Create Test Step after this VI to add it to the server.

    Generate Named Value converts the data you want to add to the test step as a named value object. Wire Build Array to the named value this VI generates to format the test data.
    The Property Node sets the inputs for the test step using the named values the Build Array returns.
    Create Test Step adds the local test step reference to the server with the properties you set. You can run a test VI after Create Test Step.
    spd-note-note
    Note  

    In a more advanced test sequence, you may determine a standard VI prototype and load test VIs from a directory on disk.

  3. Add the following code to collect data, update the test step data, and update the test results.
    Build a cluster structure for the TestStand data model so data displays correctly in the Test Monitor UI. Refer to Structuring Your Test Data to create the subVI you need to display your data correctly in Test Monitor.
    Generate Named Value converts the test data into outputs. Wire Build Array to the named value this VI generates to format the test data.
    The Property Node reads the outputs and data for the test step.
    spd-note-note
    Note  

    You must set the Data Model as TestStand for your data to display correctly in the Test Monitor UI.

    Update Test Step modifies the test step with the properties and data set by the Property Node.
    Update Test Result sets the result status based on the result of the test step. You can see the results in the Test Monitor UI.

Troubleshooting

  • If your test data does not display correctly in the Test Monitor UI, verify if your cluster structure for the TestStand Data Model object is correct. Refer to Structuring Your Test Data for more information.

Recently Viewed Topics