Validation reports

Reviewing validation messages
Customizing validation behavior

Workbench automatically checks for problems and potential problems in the process design and displays the results as messages in the Validation Report view. To find and fix problems as they occur, look at the Validation Report view during the development of processes.

You typically check for validation messages after you perform the following tasks:

Substantially change a process or other application asset. You check the validation messages to find any problems that you have introduced.
Address existing problems. You check the validation messages to see if the problems are fixed.

The Validation Report provides tools for investigating validation messages.

You can also customize some of the behavior of the validation features.

For a description of the validation messages that can appear in the Validation Report view, see Validation message reference.

Note: When validating operation property values, problems can be detected only for properties that use simple data types as values. Simple data types are those that Foundation defines.

Note: Validation does not occur for property configurations of operations that use a property editor that the operation’s service defines.

Reviewing validation messages

Use the Validation Report view to read validation messages and investigate their causes. The Validation Report view provides three columns of information for each validation message:

Description:

Describes the validation issue and provides the severity level.

Error Code:

Provides the code that identifies the message.

Asset:

Identifies the asset to which the message applies.

Path:

Identifies the location of the asset to which the message applies.

Location:

Identifies the element in the process diagram or other asset that caused the validation message.

The severity level is either Error, Warning, or Information:

Error messages indicate problems that must be fixed to enable the successful execution of the process version.

Note: Workbench does not prevent you from deploying or executing assets that generate validation errors.
Warning messages indicate potential problems that do not prevent the execution of the process but could cause unwanted behavior.
Information messages indicate benign behavior.

The View Menu allows you to select how messages are grouped and which messages appear. Expand and collapse message groups using the plus sign beside the name of the group.

For a description of the validation messages that can appear in the Validation Report view, see Validation message reference.

The following procedures describe how to use the tools that the Validation Report view provides for investigating the cause of messages.

To see documentation for a validation message:

In the Validation Report view, select the message and then click the Help button or press F1.
In the Help view, click the link for the validation message.

To change the way that validation messages are grouped:

In the Validation Report view, click the View Menu button

and select one of the following:

Group By > Severity
Group By > Application

To change which validation messages appear:

In the Validation Report view, click the View Menu button

and select one of the following:

Show > All Errors (no warnings are displayed)
Show > Problems on Selection (only messages for the currently selected item are displayed)
Show > Show All

Note: To hide warnings for assets that are not currently selected, select both All Errors and Problems on Selection.

To display the location of the problem:

In the Validation Report view, double-click the message. The asset that is the source of the problem appears or is selected. (For example, the element where the problem occurs is selected.) In some cases, a dialog box you can use to fix the problem appears.

To copy validation messages:

In the Validation Report view, click the Copy button . The text for all validation messages can then be pasted elsewhere, such as an email message.

To refresh the validation messages for a process:

If the validation messages do not reflect the current contents of your process, you can manually update the Validation Report view.

In the Application view, right-click the process and click Validate.

Customizing validation behavior

Preferences can be configured to control some of the behavior of the validation features. The following table describes the preferences that you can configure.

Preference	Default value	Description
-Dcom.adobe.process.validation.warn.numactions	50	The number of operations that causes warning WBP-105 to occur. (See WBP-105.)
-Dcom.adobe.process.validation.warn.numvars	20	The number of variables that causes warning WBP-104 to occur. (See WBP-104.)

To configure preferences, modify the workbench.ini file. Each line in the file contains a preference setting in the following format:

preference_name = value

For example, the following preference setting specifies that the warning WBP-104 is generated when 20 variables are created for a process version:

-Dcom.adobe.process.validation.warn.num_variables=20

The workbench.ini file is located in the [install directory]/Adobe LiveCycle Workbench ES3/Workbench directory, where [install directory] is the location where you installed Workbench.

To customize validation behavior:

Open the workbench.ini file in a text editor.
Modify the values of preferences as required.
Save workbench.ini and restart Workbench.