Testing a business rule

After you configure a business rule, it is recommended that you test it. You can create new documents or change the field contents of a document before testing. This topic describes the options.

Tip: You can also check business rule performance.

1. Using the XBOUND Management Center, open a console containing the Validation Designer. (For information about working with consoles, see XBOUND Help.)
2. Under Process Navigation, select a process.

3. Select Edit > Test.

4. The Test business logic dialog is displayed.

   Open an existing test document or create a new document.

   1. Select Document > Open.

   2. In the Open document dialog, select the process step and select the test document to open.

   1. Select Document > New.

   2. In the New document dialog, select the process step and specify a unique name for the document.

   3. The test document is saved when you click OK.

5. Enter or edit field values or statuses in order to configure a suitable test document:

   Task	Procedure
   Change a field value	Click in the Value column and specify a value.
   Simulate that the document is in focus in Verification	Right-click a field () or table () in the list and select Focus.
   Simulate that the user forced a field to be valid	Right-click a field or table and select Property 'ValidForced' set.
   Simulate that a field was displayed in Verification	Right-click a field or table and select Property 'ShownInVerifier' set.
   Simulate that a field was confirmed	Right-click a field or table and select Property 'Confirmed' set.
   Change a field's initial validation status	Right-click a field or table and select Valid status.

6. Click Test to apply the business rule to the test document.

7. A line is displayed below each field that shows the values and messages produced by the validation. Check whether the result is as intended. The business rule may need to be adjusted.

Note: Changes you make to your test document are not saved unless you click Save ().

During testing, you can also do the following

• To use the results from the last validation for the next test, click Transfer ().

• Click View Log () to view the log, where you will find one record per business rule. Rules that were filtered out by conditions are not displayed. For each rule, these details are displayed.

  Method	The name of the business rule (which is the same as the template name, unless it was changed).
  Business rule template	The name of the template.
  Method executed	Indicates whether the business rule was executed in the current validation cycle. The business rule is executed again only if the value of at least one trigger field is changed.
  Execution failed	Indicates whether the business rule failed to execute.
  Valid	Indicates whether the business rule had a positive result.
  Trigger fields	A list of the fields that—when changed—cause the rule to be executed.
  Validated fields	A list of the fields that assume the rule's "ValidStatus" property.
  Focus	The name of the field that gets focus after the business rule is executed.
  Message	The message that is displayed when the rule did not produce a positive result. This is the same as Original message, unless another message is configured.
  Original message	The original error message of the business rule.
  For each business rule parameter, these details are also displayed
  Argument	The name of the business rule argument.
  Type	The type of the argument.
  Assignment	The type of the assigned element. If it is a field or table cell, the name and row are also shown. ValidationContext: Validation context Constant: Constant value Field: Field assignment Table: Table cell assignment
  Value	Value of the assigned element before execution.

• Click Reload document data from XBOUND () to revert to the original version.

• Click Test again to see the effects of your changes.

• Click View Details () to view additional columns.

  Available columns:

  Document	Name of the document or field.
  Value	Field contents before executing the business rule. To change a value, click the cell in this column and change the value there.
  Status	Status of the document or field before executing the business rule. Unknown: No business rule was executed. Valid: The document or field is valid. Invalid: The document or field is invalid.
  Message	Messages from the business rule.
  ShownInVerifier	Indicates whether the field was already shown in Verification.
  Confirmed	Indicates whether the field was confirmed in Verification.
  ValidForced	Indicates whether the field was overruled.
  ValidForced ChangePoint	ChangePoint at which the ValidForced status was set.
  ChangePoint	Current ChangePoint of the field.
  CustomValue	Content of the CustomTag field property. This property can be used, for example, in business rules. To change a custom value, click the cell in this column and change the value there.