OnBeforeTestRun Trigger

NoteNote

The content in this topic only applies to Microsoft Dynamics NAV 2009 SP1. For Microsoft Dynamics NAV 2009 content, see Developer and IT Pro Help for Microsoft Dynamics NAV 2009.

Executes before a test function of a test codeunit is run.


OnBeforeTestRun(CodeunitID : Integer;CodeunitName : Text[30];FunctionName : Text[30]) Ok : Boolean

Parameters

CodeunitID

Type: Integer

The ID of the codeunit to be run.

CodeunitName

Type: Text

The name of the test codeunit to be run.

FunctionName

Type: Text

The name of the test function to be run.

NoteNote

This parameter is empty when the OnBeforeTestRun trigger is called for the entire test codeunit.

Ok

Type: Boolean

true to run the test function; otherwise, false. This value is checked after each function call.

Test runner codeunits. Test runner codeunits have the SubType Property (Codeunit) set to TestRunner.

NoteNote

This trigger is optional and not available on a test runner codeunit by default. To implement this trigger, you must manually add it as a function.

A test runner codeunit manages the execution of test codeunits that are run from its OnRun function. When a test codeunit runs, it executes each test function in the codeunit, one at a time. The OnBeforeTestRun trigger is called before the test codeunit, the OnRun function, and each test function.

The OnBeforeTestRun trigger is run in its own database transaction.

You can use the OnBeforeTestRun triggers to perform preprocessing, such as general initialization and logging, or to automate tests by integrating the test runner codeunit with a test management framework.

For more information, see Testing the Application and How to: Create a Test Runner Codeunit.

The following OnBeforeTestRun trigger code initializes a logging variable and returns true to indicate that the test function should execute. This example requires that you create the following global variable.

Name DataType

Before

DateTime

Before := CURRENTDATETIME;
EXIT(true);

Community Additions

ADD
Show: