More about HTML rules
|
|
Your HTML rule can include HTML text and JSP tags or directives. It can reference other HTML, style sheets and scripts that are defined in rules of these types:
These rule types support the HTML rule type. None by itself defines an entire user interface display. Rules of these types can be included, referenced, or linked into your HTML rule. HTML rules are the only user interface rules that run directly from an activity. Also, HTML rules are the only user interface rules for which class inheritance applies:
<pega:include>
JSP tag to incorporate HTML fragments, and other HTML rules, into your main HTML rule. The HTML fragment may also reference Web server files, extracted from a binary file rule or text file rule.<pega:reference >
JSP tag to incorporate property values.At runtime, the system processes HTML rules in the context of a user's current clipboard (a source of values for properties). It interprets directives and retrieves clipboard values to create HTML for the server to send to the browser using either the HTTP or HTTPS protocol. This is known as stream processing.
After you save the form, click the Preview toolbar button () or type the equivalent keyboard shortcut CTRL+ALT+P
to view an approximate runtime rendering of the HTML rule.
Using the Preview function may cause the system to create a clipboard page and initialize properties on that page. This may in turn cause declarative processing to be executed. Use caution before implementing any on-change declarative processing that updates a database. F-174 APAP SR-866 GROVS 10/11/05
To trace the start and end of HTML rule executions, select the Stream Rules checkbox in the Rule Types to Trace area of the Trace Options panel. See Tracer — Setting Options.
After you complete and save an HTML rule, you can cause the system to evaluate and display it in any of several ways:
<INPUT TYPE="submit" NAME="pyStream=myStream">
<INPUT TYPE="submit" NAME="pyStream=myStream &pyPrimaryPageName="otherPrimaryPage">
PRIMARY
keyword option in the URL directive. When you save an HTML rule, the system converts your HTML and JSP tags or directives to Java source code. As a learning or debugging aid, you can review this Java code.
C-1665Click the Show Java toolbar button () to see the system-generated Java code that implements the HTML rule. The window presents a read-only preview of the Java that implements this rule instance. This Java code is not identical to the Java that is executed at runtime, which includes Java code inlined from other rule instances and reflects rules in the requestor's RuleSet list.
Through directed inheritance, the immediate parent class of the Rule-Obj-HTML class (and of several other classes containing HTML text) is the Rule-Stream class, not the Rule-Obj- class.
If your application RuleSets contain HTML rules, run the Rule Security Analyzer before locking a RuleSet Version, to look for possible security issues.
stream processing | |
Introducing JavaServer Pages tags
How to set up an HTML or XML editor Property references in expressions Using the Rules Inspector |
|
Atlas — Standard HTML rules |