Back Forward Harness, Section, and Flow Action forms
Fields — Adding a Data Field for a composite application

About Harness rules

  Show all 

When you build a Pega composite application with Internet Application Composer, you embed the application on an external Web page as a gadget in a <DIV > element. A Data Field is an invisible field that makes the value of a scalar, single-value property from the composite application available to the external page. For example, say you want to display the operator's organization in a heading at the top of the external Web page. In such a case you add a Data Field for .pyOrganization to the harness or one of the sections or flow actions.

The external page hosting a composite application can access only those properties that are represented by a Data Field control somewhere in the harness displayed by the <DIV >. The values of these properties are read-only.

  1. Drag and drop the Data Field control

Click the down-arrow (Arrow) at the right end of the Advanced control group (Properties) and select the Data Field control (Data Bind). Drag the control to the cell or header that is to contain the property value. When the pointer changes shape to indicate that a single cell is selected, release the mouse button to drop the control.

If you drop the control into a cell that already has contents, it replaces the current contents of the cell.

  2. Complete the Cell properties panel — Top fields

Click the magnifying glass (Magnifying glass) icon to display the Cell Properties panel.

Your updates to this panel can update the rule form immediately or upon clicking Apply, depending on the Property Panel settings in your Edit preferences. See Setting your preferences. If the panel is pinned(pin), the wireframe on the rule form changes immediately to reflect your inputs. If the panel is not pinned(pin), click Apply to apply your inputs.GRP-229

Field

Description

Pencil

(Appears only when this field is in a section included within the current open rule.) Click to open the section that immediately contains the field.

Property

SmartPromptSelect or type a property reference that identifies a single text value. (If you are prototyping a form and the property you want to reference is not yet defined, use the template property .pyTemplateDatafield.)

Control SmartPrompt Accept the default control property rule DataField. This rule uses no parameters.
Behavior

Optional. Leave blank if no dynamic form actions to other parts of the form are to occur based on user updates or values for this field. C-1990

To establish a dynamic form action, click the magnifying glass icon (Magnifying glass) to open the Client Event Editor in a new dialog window. Complete the Client Event Editor to select an event (OnBlur, OnChange, or OnClick) and the resulting form action. C-2526

Click the help icon ( Help) on the Client Event Editor for assistance. For general information on this capability, see Implementing dynamic form actions and the Client Event Editor.

Client event support is not available for harness, section, or flow action rules that use directives.

  3. Complete the Cell properties panel — General tab

Complete the General tab.

The General tab for a Data Field is identical to the General tab for a Text Input control. See Adding a Text Input control — Complete the Cell Properties Panel — General tab.

  3. Complete the Cell properties panel — Advanced tab

Complete the Advanced tab.

The Advanced tab for a Data Field is identical to the Advanced tab for a Text Input control. See Adding a Text Input control — Complete the Cell Properties Panel — Advanced tab.

Up About Flow Action rules

Up About Harness rules

Up About Section rules