CHECKTYPE (ENUM) ¶ TYPE CHECKTYPE : This enum defines the possible checks in a test manager check. Attributes: qualified_only InOut: Name Initial Comment NONE 1 Do no check for the target column during this cycle. We intentionally start the enum values with 1 to catch uninitialized variables. EQUAL The target variable needs to be equal to the reference column. DIFFERENT The target variable needs to be different than the reference column. SMALLER The target variable needs to be smaller than the reference column. SMALLEREQUAL The target variable needs to be smaller or equal than the reference column. BIGGER The target variable needs to be bigger than the reference column. BIGGEREQUAL The target variable needs to be bigger or equal than the reference column. RANGE The target variable needs to be in the range defined by the reference column and the upper reference column. CONST The target variable needs to be the same as in the last cycle. FALLING The target variable needs to be the same or lower than in the last cycle. INCREASING The target variable needs to be the same or bigger than in the last cycle. STRICTLY_INCREASING The target variable needs to be the lower than in the last cycle. STRICTLY_FALLING The target variable needs to be the biggerthan in the last cycle. LINEAR The target variable needs exhibit linear behaviour as defined by the linear reference columns. EDGE The target variable needs to exhibit an edge to the value in the reference column.

FAILUREMODE (ENUM) ¶ TYPE FAILUREMODE : This enum defines the possible failure modes in a test manager check. This enum is synchronized to to the .NET FailureMode enum, so all changes here need to be replicated there. Attributes: qualified_only InOut: Name Initial Comment Warning 1 The problem is only reported as a warning in the test report, but execution continues normally. We intentionally start the enum values with 1 to catch uninitialized variables. AbortTestCase The current test case is aborted (and directly following tests of TestCaseType.Consecutive are skipped). This is the default when no mode is explicitly defined nor inherited. AbortUnitTesting The whole IEC Unit Test element is aborted when this failure occurs. AbortTestRun The whole test script run is aborted when this failure occurs.

Function Blocks ¶ BaseMultiTest (FunctionBlock) HandleAssertResult (Method) HasError (Method) SetErrorVars (Method) prvAbort (Method) prvDone (Method) prvError (Method) prvResetOutputs (Method) PrintfOne (FunctionBlock) FB_Init (Method) Print (Method) SetText (Method) Text (Property) Testcase (FunctionBlock) Execute (Method) HandleAssertResult (Method) HasError (Method)

BaseMultiTest (FB) ¶ FUNCTION_BLOCK PUBLIC BaseMultiTest EXTENDS CBM.ETrigA IMPLEMENTS IBaseIecUnitTest This FB is the base for the multi-test POUs and contains the additional inputs and outputs. InOut: Scope Name Type Comment Inherited from Input xExecute BOOL Rising edge: Action starts Falling edge: Resets outputs If a falling edge occurs before the function block has completed its action, the outputs operate in the usual manner and are only reset if either the action is completed or in the event of an error. In this case, the corresponding output values ( xDone , xError , iError ) are present at the outputs for exactly one cycle. ETrigA xAbort BOOL TRUE : Action is stopped immediately and all outputs are reset to their initial values. ETrigA Output xDone BOOL TRUE : Action successfully completed ETrigA xBusy BOOL TRUE : Function block active ETrigA xError BOOL TRUE : Error occurred, function block aborts action FALSE : No error ETrigA xAborted BOOL TRUE : Action aborted by user ETrigA Input diTestCaseIndex DINT Index of the test case which will be executed. In combination with xGetTestInfo = TRUE you can fetch the following information about the multi-test POU: name of the test case categories time-out for the test case If the test case index is -1 then you get the count of test cases in the multi-test POU. xGetTestInfo BOOL If set to TRUE the outputs return the basic information about the test case. Output diTestCaseCount DINT If xGetTestInfo = TRUE and diTestCaseIndex = -1 then you get the count of test cases in the multi-test POU. wsTestCaseName WSTRING(Constants.WSTRING_LENGTH) Name of the current test case wsTestCaseCategories WSTRING(Constants.WSTRING_LENGTH) Test categories diTestCaseTimeout DINT Timeout of the test case. In milliseconds. wsInfo WSTRING(Constants.WSTRING_LENGTH) Info about the test case. It can contain the description of the test step if used by a test table with the necessary column. eError UT_ERROR Error ID wsError WSTRING(Constants.WSTRING_LENGTH) Error message wsWarning WSTRING(Constants.WSTRING_LENGTH) Warning message eFailureMode FAILUREMODE Failure mode informs how to proceed after the test case failed. Methods: HandleAssertResult HasError SetErrorVars prvAbort prvDone prvError prvResetOutputs Structure: HandleAssertResult (Method) HasError (Method) SetErrorVars (Method) prvAbort (Method) prvDone (Method) prvError (Method) prvResetOutputs (Method)

BaseMultiTest.HandleAssertResult (METH) ¶ METHOD HandleAssertResult : BOOL InOut: Scope Name Type Return HandleAssertResult BOOL Input eAssertion_Result ASSERTION_RESULT wsErrorMsg WSTRING(Constants.WSTRING_LENGTH)

BaseMultiTest.HasError (METH) ¶ METHOD HasError : BOOL InOut: Scope Name Type Return HasError BOOL

BaseMultiTest.SetErrorVars (METH) ¶ METHOD PUBLIC SetErrorVars InOut: Scope Name Type Input eError UT_ERROR wsError WSTRING(Constants.WSTRING_LENGTH) eFailureMode FAILUREMODE

BaseMultiTest.prvAbort (METH) ¶ METHOD prvAbort : BOOL InOut: Scope Name Type Return prvAbort BOOL

Assert_ArrayOfLReal_Contains (FUN) ¶ FUNCTION Assert_ArrayOfLReal_Contains : BOOL Assertion function to check that an ARRAY OF LREAL contains a specific value InOut: Scope Name Type Initial Comment Return Assert_ArrayOfLReal_Contains BOOL TRUE if the assertion passes succesfully, FALSE otherwise Input context IBaseIecUnitTest The instance of the test function block calling this function. This instance can be provided by using THIS^ . referenceValue LREAL The value that should be contained actualArray POINTER TO LREAL The array to check precision LREAL 0.0 A value to specify an allowed deviation. Default is 0.0 wsErrorMsg WSTRING(Constants.WSTRING_LENGTH) “” A custom error message, that is added to the error message of the assertion itself. If this parameter is used, it is recommended to adapt the value of the library parameter Constants.WSTRING_LENGTH .

Assert_ArrayOfLReal_ContainsAllOf (FUN) ¶ FUNCTION Assert_ArrayOfLReal_ContainsAllOf : BOOL Assertion function to check that an ARRAY OF LREAL contains all specified values. Important: only unique values are checked, the quantity of values is not considered. InOut: Scope Name Type Initial Comment Return Assert_ArrayOfLReal_ContainsAllOf BOOL TRUE if the assertion passes succesfully, FALSE otherwise Input context IBaseIecUnitTest The instance of the test function block calling this function. This instance can be provided by using THIS^ . referenceValues POINTER TO LREAL An array with all values that should be contained. actualArray POINTER TO LREAL The array to check precision LREAL 0.0 A value to specify an allowed deviation. Default is 0.0 wsErrorMsg WSTRING(Constants.WSTRING_LENGTH) “” A custom error message, that is added to the error message of the assertion itself. If this parameter is used, it is recommended to adapt the value of the library parameter Constants.WSTRING_LENGTH .