Purpose

The module FieldValueTestCaseGenerator allows for generating XML or CSV files that contain parameterization sets for test cases to be used for the current network in the test center.

Usage

Insert FieldValueTestCaseGenerator to a network that will be used in the test center. Saving it afterwards is not recommended.

  • Drag&Drop fields to the Parameterization list that should have different parameter sets for each test run.
  • Modify the values or the value range for this parameter depending on its type in the box below. Allowed types are Bool, Float, Double, Integer, String, Enum.
  • Click apply to transfer the modified values to the parameter list.
  • If your parameter list is complete, click Update in the Permutation box to generate a list with all parameter permutations.
  • Add fields that shall be checked during each test run by dragging them into the ‘Expected Results’ tab.
  • Add fields that shall be saved after each test run by dragging them into the ‘Results to Save’ tab.
  • Export your cases to XML or CSV using the Output tab.

Details

The generated files can be further edited with the module FieldValueTestCaseEditor. This is necessary for specifying different results per test case, because FieldValueTestCaseGenerator will only generate the same result value for each test case.

Tips

You do not have to save the test network file containing FieldValueTestCaseGenerator for using it in the test center.

Windows

Default Panel

../../../Modules/Macros/Tests/FieldValueTests/mhelp/Images/Screenshots/FieldValueTestCaseGenerator._default.png

fileDirectoryWindow

../../../Modules/Macros/Tests/FieldValueTests/mhelp/Images/Screenshots/FieldValueTestCaseGenerator.fileDirectoryWindow.png

loadFileList

../../../Modules/Macros/Tests/FieldValueTests/mhelp/Images/Screenshots/FieldValueTestCaseGenerator.loadFileList.png

Parameter Fields

Field Index

CSV Filename: String Parameter Factor: Float XML Filename: String
currentType: String Parameter Max: Integer  
Decimal Places: Enum Parameter Min: Integer  
Delete all: Trigger Parameter Step Size: Integer  
Delimiter: Enum Permutation: String  
Filename: String Preview: String  
Parameter Bool False: Bool Separator: Enum  
Parameter Bool True: Bool User defined:: String  

Visible Fields

CSV Filename

name: csvFilename, type: String

Sets the filename of the generated CSV file.

Delimiter

name: delimiter, type: Enum, default: ;

Defines the delimiter character that is used to separate all values in the generated CSV file. You can choose between ‘;’ ‘,’ ‘:’

XML Filename

name: xmlFilename, type: String

Sets the filename of the generated XML file.

Filename

name: fileListFilename, type: String

Sets the filename of a text file that contains a list of filenames that are used for parameterization of a string field.

User defined:

name: userDefinedSeparator, type: String

Sets a user-defined character that is used to separate filenames in the given text.

Separator

name: fileListSeparator, type: Enum, default: newline

Defines the character that is used to separate filenames in the given text. You can choose between ‘newline’ ‘;’ ‘,’ ‘:’ or ‘user-defined’

Delete all

name: reset, type: Trigger

When pressed, all parameterized fields are removed from the parametrization list.

Parameter Min

name: parameterMin, type: Integer, default: 0

Sets the minimum integer value of the parametrization range of the selected numerical parameter.

Parameter Max

name: parameterMax, type: Integer, default: 10

Sets the maximum integer value of the parametrization range of the selected numerical parameter.

Parameter Factor

name: parameterFactor, type: Float, default: 0.1

Sets a factor to multiply every integer value in the current range to generate a float value range.

Decimal Places

name: parameterDecimalPlaces, type: Enum, default: 2

Defines the fixed number of decimal places for the parametrization entries of float fields.

Parameter Step Size

name: parameterStepSize, type: Integer, default: 1

Sets the step size for iterating values in parametrized number fields

Parameter Bool True

name: parameterBoolTrue, type: Bool, default: FALSE

If checked, the selected bool field shall be parametrized with TRUE value.

Parameter Bool False

name: parameterBoolFalse, type: Bool, default: FALSE

If checked, the selected bool field shall be parametrized with FALSE value.

Preview

name: preview, type: String, persistent: no

Shows an editable preview of the current parametrization settings of the selected parameter.

Permutation

name: permutation, type: String, persistent: no

Shows the editable list of all possible parametrization settings per test case.

Hidden Fields

currentType

name: currentType, type: String, persistent: no