LabVIEW Unit Test Framework Toolkit API Reference

Test Cases Page (Test Properties Dialog Box)

  • Updated2023-02-21
  • 5 minute(s) read

Requires: Unit Test Framework Toolkit

Select Test Cases from the Category list of the Test Properties dialog box to display this page.

Use this page to configure the settings for each test case, including the input values, expected values, and comparison types.

Note  LabVIEW lists the controls and indicators from the VI under test on this page. If the Input/output values setting on the Unit Test Framework page of the Project Properties dialog box is Include controls and indicators from connector pane, make sure you select a connector pane pattern and assign the terminals for the VI under test.

This page includes the following components:

  • Test Case—Specifies the test case you want to display and configure. Use this control to switch between test cases. You also can use this control to rename test cases.
  • New—Creates a new test case.
  • Duplicate—Duplicates the current test case.
  • Delete—Deletes the current test case. A test file must have at least one test case. If you click the Delete button on the only test case, LabVIEW resets the input values, expected values, and comparison types.
  • Run—Executes the current test case.
  • Export Values to VIExports the input and expected values of the current test case to the corresponding terminals of the VI under test, setup VI, and teardown VI.
    Note  If the VI under test is a reentrant VI and no clones of the VI under test are in memory, Export Values to VI exports the values to the VI under test. If exactly one clone of the VI under test is in memory, Export Values to VI exports the values to that clone VI. If multiple clones of the VI under test are in memory, LabVIEW prompts you to choose a clone VI to export values to.
  • Import Values from VIImports the input and expected values from the VI under test, setup VI, and teardown VI to the corresponding terminals of the current test case.
    Note  If the VI under test is a reentrant VI and no clones of the VI under test are in memory, Import Values from VI imports the values from the VI under test. If exactly one clone of the VI under test is in memory, Import Values from VI imports the values from the clone VI. If multiple clones of the VI under test are in memory, LabVIEW prompts you to choose a clone VI to import values from.
  • Rearrange—Displays the Rearrange Test Cases dialog box. Use this dialog box to change the order of test cases.
  • Update—Updates the inputs and outputs of each test case. If you modify a VI after creating a test, the Update button updates the inputs and outputs of the VI on this page. Refer to the KnowledgeBase at ni.com for more information about when LabVIEW applies original values and comparison types.
  • Connector Pane Image—Displays the connector pane image of the VI under test.
  • Comment—Adds a comment to the current test case.
  • Input Values Table—Lists the name, data type, and input value of each control for the current test case.
    • Input Name—Displays the names of each control from the VI under test and from the setup VI.
      Note  LabVIEW displays arrays and clusters as trees. Expand each tree to view the individual elements.
    • Input Name Checkbox—Specifies whether to use the value you specify in the Input Value of each control during test execution. If you remove the checkmark from an input terminal, LabVIEW uses the default value for front panel controls and the current values for global variables and shared variables during test execution.
    • Data Type—Displays the data type of the corresponding control or indicator.
    • Input Value—Specifies the input value or test vector LabVIEW uses for each control during test execution.
  • Expected Values Table—Lists the name, data type, comparison type, and expected value of each indicator for the current test case.
    • Output Name—Displays the name of each indicator from the VI under test and from the teardown VI.
      Note  LabVIEW displays arrays and clusters as trees. Expand each tree to view the individual elements.
    • Output Name Checkbox—Specifies whether to check each indicator for functional correctness during test execution. If you remove the checkmark from an output terminal, LabVIEW does not check the corresponding indicators.
    • Data Type—Displays the data type of the corresponding control or indicator.
    • Comparison—Specifies the comparison type LabVIEW uses to compare the resulting value of each indicator with the expected value.
    • Expected Value—Specifies the indicator value or test vector that LabVIEW uses to compare with the corresponding resulting values.
Note  LabVIEW displays some data types, such as LabVIEW class objects, images, and refnums, as binary data. LabVIEW represents these data types by using […] on this page. You cannot edit these data types on this page. However, you can configure the input and expected values of these data types by using the front panel of the VI under test, setup VI, and teardown VI, accessible by clicking the Export Values to VI button, and importing the updated values from the VI under test, setup VI, and teardown VI to the current test case, accessible by clicking the Import Values from VI button.

Log in to get a better experience