Additional Results Edit Tab

TestStand 2019 Help

Edition Date: May 2019

Part Number: 370052AA-01

»View Product Info
Download Help (Windows Only)

Use the Additional Results edit tab in the TestStand Sequence Editor to add and configure additional results. An additional result is a value TestStand adds to the result list of a step when the step executes and when you skip a step or force the step to pass or fail. An additional result can be a module parameter or a custom additional result in which you specify the name and value of the result. You can configure TestStand to automatically include additional results in reports and when logging results to a database. The default TestStand report generation sequences and XML style sheets do not display additional results for skipped steps.

The Additional Results edit tab contains the following options:

  • Additional Results—Lists the additional results TestStand logs when you execute the step. The list contains any additional results you have added. If the step calls a code module, the list also contains all parameters passed to the module. Use the following controls to modify an additional result:
    • Name—An expression that specifies the name of the additional result. TestStand logs only the additional results you select by using the checkbox next to the additional result name. For custom additional results, you normally use a literal string or the ResStr expression function to specify a localized name. If the expression you specify as the Value to Log evaluates to a property object with a name, you can leave the Name field empty to use the name of the property object the Value to Log expression evaluates to as the name of the additional result. For parameter additional results, TestStand uses the name of the parameter, and you cannot change this value.
      • Select Result From List—For a custom additional result, select an item from the list to set all columns to a value the item defines. The list contains items that apply to any step and might also contain items specific to the step type.
    • Value to Log—An expression that specifies the value of the additional result. For a parameter additional result, TestStand uses the value passed to or from the code module. You can log the additional result for an output parameter not stored in a variable.
    • Type—The type of the additional result.

      For parameter additional results, the Type column shows the type of the parameter and you cannot change the value. For custom additional results, you can click the Change Result Type button to change the expected type of the additional result. When you click the Change Result Type button and select <Any Type>, the Value to Log expression can evaluate to any type and the Type column displays the type of the Value to Log expression.

      When you click the Change Result Type button and select a type, you can expand the Name column of the Additional Results list to view the subproperties of the selected type and specify settings for each subproperty. For example, you can specify a Value to Log expression for each individual subproperty and leave the Value to Log expression for the top-level object empty, or remove the checkmark next to the Name column for an additional result to not log that subproperty.

      When you click the Change Result Type button and select an array type, you can expand the Name column of the Additional Results list to view the subproperties of the array elements of the selected type and specify settings for each individual subproperty of the array elements. The settings you specify apply to every element of the array. For example, you can remove the checkmark next to the additional result name to not log that subproperty for every array element. You cannot specify a Value to Log expression for each individual array element subproperty. You must specify a Value to Log expression for the array itself.

    • Condition—If you specify a condition that evaluates to False, TestStand does not log the additional result.
    • Include in Report—Enable this option to set the PropFlags_IncludeInReport flag on the additional result, which indicates that the report displays the additional result.
    • Is Measurement—Enable this option to set the PropFlags_IsMeasurementValue flag on the additional result, which indicates that the additional result is a measurement.
    • Is Limit—Enable this option to set the PropFlags_IsLimit flag on the additional result, which indicates that the additional result is a test limit.
  • Add Result From List—Behaves the same as the Select Result From List button, except the Add Result From List button inserts a new custom result before setting the column values.
  • Add Custom Result—Adds a new custom additional result.
  • Remove Selected Result—Removes the currently selected custom additional result.
  • Move Selected Result Up—Moves the currently selected custom additional result up in the Additional Results list.
  • Move Selected Result Down—Moves the currently selected custom additional result down in the Additional Results list.

See Also

Built-In Step Types

PropertyFlags

WAS THIS ARTICLE HELPFUL?

Not Helpful