|
|
Harness, Section, and Flow Action formsWhen 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 (
) at the right end of the Advanced control group (
) and select the Data Field control (
). 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 (
) 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(
), the wireframe on the rule form changes immediately to reflect your inputs. If the panel is not pinned(
), click Apply to apply your inputs.
Field |
Description |
|
(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 |
|
| Control |
 Accept the default control property 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. To establish a dynamic form action, click the magnifying glass icon ( Click the help icon ( Client event support is not available for harnesses, sections, or flow actions that use directives. |
) to open the Client Event Editor in a new dialog window. Complete the Client Event Editor to select an event (
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.
4. 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.