|
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:
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
|
|
The number of operations that causes warning
WBP-105 to occur. (See
WBP-105
.)
|
-Dcom.adobe.process.validation.warn.numvars
|
|
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]
/AEM
forms Workbench/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.
|
|
|
