Back Forward Correspondence form
Completing the Corr tab

  1. About 
  2. New 
  3. Corr 
  4. Prompts 
  5. Pages & Classes 
  6. Security 
  7. History 
  8. More... 

Complete the Corr  tab to define the text, formatting, property values, and, included correspondence fragments, and appearance of the correspondence.

Note If this correspondence rule is to be used with the Work-.AttachandHold flow action and a Word template rule, enter only plain text (as well as directives or JSP tags if desired) in the text area. Do not include any HTML tags such as <P> or <H3>; the Word template file provides the formatting.

HTML Email

NoteWhen the Correspondence Type key part of the rule is Email, all correspondence produced for outgoing email includes HTML formatting, even if no HTML elements appear within in the source. The recipient's mail client must have the capability to accept and display HTML-formatted email.

Text Messages

NoteWhen the Correspondence Type key part of the rule is PhoneText, the correspondence produced for outgoing email includes no HTML formatting. The destination may be a digital cell phone that supports Short Message Services (text messaging) or an email client program.

Linked Property references

AdvancedIn source mode, you can use references based on linked properties. For example, in a work object, the property Work-.pxCreateOperator is a linked property identifying a key to a unique instance of the Data-Admin-Operator-ID class. To include the full name of the create operator, enter the reference as:

<pega:reference name=".pxCreateOperator.pyUserName"></pega:reference>

Note the leading . before the linked property name.

Security

CautionFor highest quality and security, minimize the use of source mode in correspondence rules you create in application RuleSets. While such rules are necessary for specific features, use of generated correspondence is preferable when possible. If your application contains correspondence rules, use the Guardrails landing page to assess guardrail compliance, and use the Rule Security Analyzer to check for security vulnerabilities.

Field

Description

(no label)

Enter rich text for the correspondence. In Design mode, a wide variety of tools are available in the toolbar including fonts, font sizes, colors, lists formatting, graphic elements and alignments. Certain controls are available only in Design mode, and only when text is selected.

Upper toolbar

Icon

Result

(Arial)

Change the font of selected text.

(8)

Change the font size of selected text

(normal)

Convert the selected paragraph to a normal paragraph (<p> tag) or one of six heading levels (<h1> to <h6>).

Unordered list

Convert the selected paragraphs to an unordered list (<ul> tag).

Ordered list

Convert the selected paragraphs to an ordered list (<ol> tag).

Indent

Indent, increase space at the beginning of the selected lines.

Outdent

Outdent, reduce space at the beginning of the selected lines.

Make Link

Make the selected text an HTML link (<a> tag). In a pop-up window, enter the HREF= value in the Name field. Select the Open in new window box if desired. Optionally, enter ToolTip text in the Description field. Click Save.

Add Image

Insert a reference to an image, a binary file rule. If this correspondence is sent as an HTML-formatted email message, the message includes the image.

Add Property

Include the value of a scalar property at the selected insertion point. Complete the pop-up window to supply the property Name, an optional Format (control) and an optional When condition rule. You may type in a full property reference. Click Save.

The system generates a <pega:reference > JSP tag from the information you provide.

Include

Include the value of a section or paragraph rule at the selected insertion point.

Complete the pop-up window to identify the rule type (section or paragraph), the Purpose key part, an optional When condition rule, and (if the included rule is based on a page other than the page of this paragraph), a Using Page page name value. Click Save.

The system creates a <pega:include ..> JSP tag from the information you supply.

Lower toolbar

Icon

Result

Bold

Bold the selected text using the <strong> HTML tag.

Italic

Make the selected text italics.

Underscored

Make the selected text underscored.

Subscript

Convert the selected text to a subscript.

Superscript

Convert the selected text to a superscript.

Font color

Change the font color of the selected text. Choose a color from the palette.

Background color

Set the background color of the selected area. Choose a color from the palette.

left align

Left-align the lines in the selected paragraph.

Center

Center the lines in the selected paragraph.

Right align

Right=-align the lines in the selected paragraph.

Full align

Justify the lines in the selected paragraph by adding spaces.

Design

Switch to design mode.

Source

Switch to source mode. As always when composing HTML code, avoid use of the angle bracket characters (< and >, less-than and greater than) except as part of an HTML syntax element. Use the HTML entities &lt; and &gt; instead.

Spell check

Spell check the correspondence.

Designated Printer

SmartPrompt Optional. For print only. To print correspondence from this rule on a COS printer identified in your system, enter the Printer Name value of a COS Printer data instance.

Before you attempt to print correspondence, install COS. See About the Correspondence Output Server.

If the correspondence is to be printed on a printer not known at this time, leave this field blank. The operator can select a printer, or your application can compute a destination printer. See More about COS Printer data instances.

Special Print Activity

SmartPrompt Advanced featureOptional. For print only. By default, the system uses the standard activity named Data-Corr-Letter.Send to send correspondence items to a COS printer. To use another activity, create an activity with Data-Corr-Letter as the Applies To key part. Enter the Activity Name key part here.

Display Width

Optional. Enter a display width as a percentage value between 10 and 100. If your application presents the correspondence item to a user for editing, the system sets the initial correspondence display window to this percentage of the user's full monitor width (in pixels). The user can adjust the window size.

Select a percentage that suits the correspondence. The default is 60 percent.

Display Height

Optional. Enter a display height as a percent value between 10 and 100. If your application presents the correspondence item to a user for editing, the system sets the initial correspondence display window to this percent of the user's full monitor height in pixels.

Select a percentage that suits the correspondence. The default is 80 percent.

After Create

SmartPromptSelect the initial disposition of correspondence items created by this rule:

  • Send — When correspondence can be sent out without review and approval by a second user.
  • Verify — When correspondence is verified by a second user before being sent out. The second user can update and send the correspondence or reject it. This choice is useful for highly sensitive documents. At runtime, the system starts an additional flow named VerifySendCorr. The standard flow Work-.VerifySendCorr routes the correspondence item to the work group manager for verification, but your application can override this flow or portions of it. For background, see PDN article PDN24089 How to enable verification in correspondence rules.
  • Attach and Hold — When correspondence is to be attached to a work item but is not sent out, or is sent out by a later utility activity such as Work-CorrNew. You can use this option with correspondence started with the standard flow action Work-.AttachandHold, which creates attachments assigned to a category.
User Edit

SmartPromptIndicate what degree of editing is available at runtime to an application user for correspondence items produced by this rule:

  • Select No Edit to prevent any editing by the user.
  • Select May Edit to allow editing by users who update the work item.
  • Select May Display if the application is to display the correspondence to users who process the work item, but the correspondence cannot be altered by these users.
  • Select Must Edit if users processing the work item must complete information in correspondence items produced from this rule.

Select Must Edit if the user edits correspondence in conjunction with the flow action Work-.AttachAndHold to support sending Microsoft Word files in DOC format as email attachments.

Generate For Typically, the system sets this field to HTML or JSP, to indicate whether the HTML source is to contain HTML directives or JSP tags. For new rules, the initial value is JSP.

Tip Use of JSP tags offers superior performance and other advantages over directives. Although both directives and JSP tags are supported, JSP tags are recommended for new development.

NoteIf this rule is circumstance-qualified or time-qualified, make this Generate For value match the Generate For value of the base rule. The base rule and the qualified rules must all use JSP tags or all use directives.

NoteDo not save the rule form if you have composed HTML that contains both JSP tags and directives.

Up About Correspondence rules