Directives

As a best practice for improved performance and debugging, use JSP tags rather than directives in new development, except for in deprecated list view rules. Use of directives in new development is deprecated. Accept the default value JSP in the Generate for field of the HTML tab of harness, section, flow action, control, and correspondence rules. Automatic conversion of directives to equivalent JSP tags is fast and reliable. See About JavaServer Page tags and Converting from directives to JavaServer Page tags.

Directives are used in rules that support:

The twelve directives govern how the system's stream processing facility converts and assembles a text stream for a user's browser, for outgoing correspondence, or for outgoing XML text.

Directive

Purpose

Assert

Use to make processing more efficient when working with one or more concrete classes and the Obj-List method.

Binary

Incorporates a binary file reference into an HTML stream. See How to support Word Merge.

Comment

Use for troubleshooting and debugging, to inhibit directive processing within the scope of the comment. This is not a replacement for HTML comments.

Delimiters

Change the syntax used for all the other directives.

Foreach

Looping and iteration.

Include

Incorporate another HTML text instance into the current HTML text.

Java

Inline Java to be executed to produce the final HTML.

Literal

Bypass curly brace characters when preprocessing HTML.

Lookup

Retrieve a property value from an instance not present on the clipboard.

Reference

Incorporate a property value on the clipboard as output text.

Save

Copy a name and value pair to temporary scratchpad during HTML processing.

URL

Support Submit and Back navigation in HTML forms.

When

Test a true-false condition and include one of two HTML text segments based on the outcome.

With

Designate a clipboard page other than the primary page for a portion of HTML.