You are here: Reference > Rule types > Message rules > Message form - Completing the Definition tab

Message form
Completing the Definition tab

  1. About 
  2. New 
  3. Definition 
  4. Parameters 
  5. History 

Use this tab to configure your message and define the text it contains. You can include placeholders in your text for parameter values that are populated at run time.

 

Message details

Use the following fields in the Details section to configure your message.

 

Field

Description

Category

Select an option from the list that describes the type of information this message conveys to users.

Options include: Alert, Error, Tip, Warning, blank, and any custom categories defined in your application. The Warning category indicates a guardrail message.

As a best practice, specify a category. SmartPrompt results include messages with a blank category, which can lead to confusion.

Tip category messages are transient. They are not saved to the database and you cannot justify them. When you add this category of message to a rule, the message text is not visible until you save the rule.

Severity

This field is visible for Warning category messages.

Select an option from the list that describes the level of impact to the application if you do not resolve or justify to the warning.

The value that you select appears as part of the message text displayed to users.

For guardrail messages, the severity is used to calculate the guardrail score.

Application Impact

This field is visible for Warning category messages.

Select an application area from the list that is adversely affected if you do not resolve or justify the warning.

The value that you select appears as part of the message text displayed to users.

Message text

Enter clear and concise text in the Message field. Use curly braces and the numbers 1-10 to represent dynamic text. For example, you can enter message using this format:

Rule {1} was processed on the {2} thread with data from page {3}.

At run time, the system evaluates the values of parameters passed to the message, which can be property references, literal text, or another message. Each number in curly braces is replaced with a value to form a complete message.

Use the options on the Parameters tab to define data types and default values for your message input parameters.

As a best practice for Warning category messages, enter text that explains why the warning is present and at least one suggested action to clear it.