Section form - Completing the HTML tab

Each time that you save an auto-generated section, Pega Platform derives source HTML from your entries on the Design tab.

Field Description
Auto-generated HTML Select in most cases to allow Pega Platform to generate HTML text for the section based on information in the Design tab.

Hand-edited HTML in sections can introduce complex, difficult-to-debug processing into your application. Clear this check box only when necessary. Following the guardrails, avoid hand-edited HTML in sections when other approaches can achieve the same result. As a best practice, use the Rule Security Analyzer to detect and correct for security vulnerabilities.

If this rule is later saved with the Auto-Generated HTML box selected, your HTML changes are overwritten.
Portlet compliant Select to generate portlet-compliant HTML that can be displayed by a portal server. Portlet-compliant HTML meets the requirements of Java Specification Request 168, which defines the portlet standard.

This box is available only when the Auto-Generated HTML box is selected.

A portlet-compliant section form can be sent to an external portal server through Service Portlet rules and displayed in a portlet window.
Localize Select to indicate that at runtime, user presentation of this section is to be localized based on field value rules in a language-specific ruleset text elements.

This check box is available only when Auto-Generated HTML is selected and Generate for is set to JSP.

For each locale, you must add field value rules in such a ruleset to support presentation of this section. Typically, use the Localization wizard and the Rules Inspector tool to identify, create, and maintain these field value rules.

When selected, the generated HTML calls the PublicAPI Java function getLocalizedTextForString() at runtime to convert text in the pyCaption, pyButtonLabel, pyActionLabel, pyActionPrompt and other properties to a locale-specific value.

Omit extra spaces  
Specialty Component

Select to use this section as a custom user interface component built with third-party JavaScript libraries such as JQuery, Adobe Flash/Flex, or FusionCharts. You can include this section as a layout or inside a cell. This section cannot be autogenerated; the Auto-generated HTML , Portlet compliant and Localize fields are disabled. The Generate for , Browser Support , and Accessibility options are available.

Enter your code using HTML, CSS, JS, Flash, Flex, and so on in the HTML Source area.

When you select this option, the Parameters tab displays an array for entering the names and descriptions of Single Value, Page Value, or Page List parameters that you want to pass to this section. You can enter literal values in the array and retrieve them as regular parameters using unique specialty component IDs and API functions to:

  • Set data to the clipboard before submitting the page.
  • Get clipboard data when loading a page.

This feature requires advanced JavaScript skills. See Notes: in the HTML Source area for details.

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 sections, the initial value is JSP.

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

If the Auto-generated HTML box is not selected, use only JSP tags or directives — not both — in the custom HTML you add to this rule. Set this field to reflect your choice.

  • If 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.
  • Do not save the rule form if you have composed HTML that contains both JSP tags and directives.
  • The setting on this rule may differ in other sections referenced in this section. For example, a section that uses JSP tags may include a section that uses directives.
Browser Support This field indicates which browsers and versions can correctly process the HTML code from this rule.

If the Auto-generated HTML option is selected, the value is All Supported Browsers and is read-only. Pega Platform includes only those tags and features that can be displayed in supported browsers, which include Internet Explorer, Firefox, Safari for Windows, and Chrome. For the exact list of supported browsers and versions, consult the Platform Support Guide on the PDN.

If the Auto-generated HTML option is not selected, and you edit the generated code or manually provide the code for the rule, select All Supported Browsers or IE only. When you do not use auto-generated code, Pega Platform does not validate your HTML code. You must verify that it can be displayed by the browsers you specify.

Accessibility This field is available when Auto-Generated HTML is not selected.

Select On to indicate that you have designed and implemented your HTML to meet your accessibility requirements.

The Accessibility Report evaluates this field on each rule in an application that displays it, when calculating application accessibility compliance levels. For more information, see Using the Accessibility report.

HTML Source At runtime, Pega Platform uses stream processing to evaluate the JSP tags or directives in this source HTML (which reference properties and other rules such as HTML fragment rules, HTML rules, controls and sections) in the context of current clipboard contents and static files. Pega Platform then sends the resulting HTML to the HTTP server, which transmits it and the associated static files (images, scripts, and style sheets) to the Internet Explorer browser on the client workstation.

To edit the generated source:

  1. Save the rule form once with the Auto-generated HTML check box selected.
  2. Clear the Auto-generated HTML check box.
  3. In the HTML editor, override generated HTML code with custom code.
  4. Exit from the HTML editor and save the rule form again.

When you select Specialty Component , the system populates this area with a template containing sample JavaScript that is required for integrating this component with a harness.