|
|
More about HarnessesLinked property references
For fields that are always displayed as read-only, you can enter a linked property reference, of the form .AAAA.BBBB, where AAAA is the linked property and BBBB is any property reference in the object identified by the value of AAAA as a key. For example, if the property AAAA has a value corresponding to a key of a Data-Admin-Operator-ID instance, then .AAAA.pyUserName presents that Operator ID's full name. This allows values from that object to appear (read-only) in the run-time display of the section, although your processing does not explicitly load the object onto the clipboard.
Activities and clipboard page names
Use the standard activity @baseclass.Show-Harness to display harness forms. This activity and the standard harnesses expect to find (by convention) objects on the following page names:
pyWorkPage— Conventional name for the page that contains a work item. This page usually has a class derived from the Work-Object- class.pyWorkCover— Conventional name for the page that contains a covering work item, if one exists. This page has a class derived from the Work-Cover- class.NewAssignPage— Conventional name for the page that contains an assignment object. This page has a class derived from the Assign- base class.
These page name conventions need not apply to applications that do not depend on harnesses; the work item page may have any name established in the flow.
Java code display
When you save a harness, 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.
Click the Show Java toolbar button (
) to see the system-generated Java code that implements the harness. 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 executes at runtime, which includes Java code inlined from other rule instances and reflects rules in the requestor's RuleSet list.
Preview and Run
After you save this rule form, click the Preview toolbar button (
) or type the equivalent keyboard shortcut CTRL+ALT+P to see a more faithful split-screen presentation of the runtime appearance of the harness. (Many harnesses depend on context. Even when the rule is correctly configured, the Preview display may fail and report JSP errors if this harness depends on clipboard contents that do not exist or other rules that cannot be found.)
Click the Run toolbar button (
) to test the harness with data from the clipboard. See How to test a harness.
Parent class
Through directed inheritance, the immediate parent class of the Rule-HTML-Harness class is the Rule-Obj-HTML class.
Security
If your application RuleSets contain harnesses that are not auto-generated, run the Rule Security Analyzer before locking a RuleSet Version, to look for possible security issues.
Related PDN articles
26029 How to remove standard icons on the work form header by editing the harness rule- 25931 How to override the default tab order of input fields on forms
About Harnesses