Use the controls at the top of this tab and drag and drop operations to review or update this harness and associated sections.
The tab presents a real-time preview of the user form, allowing you to adjust the contents, position, style, and other aspects of the elements in the form quickly. As a best practice, build your application skin, using the Skin rule form, before you develop harnesses.
Areas of the layout that correspond to sections (or other elements) that you cannot update appear with a gray background. This may mean that the rule needs to be checked out by you, or belongs to a locked ruleset version, or belongs to a ruleset version that you are not allowed to update.
Note: When you save this rule form, any other sections you have open that this rule references are also saved and validated as they are saved.
Note: At runtime, the initial state of each collapsible element on a user form — collapsed or expanded — is determined by the state on the Harness form when you save the form.
Caution: Using the Harness form to review or update a harness creates a clipboard page and initializes properties. This may in turn cause declarative processing to execute. Use caution before implementing any OnChange declarative processing that produces database updates.
The preview area of this tab holds an approximate visual presentation of the runtime appearance of the harness. These buttons do not affect the contents of the rule, only the display on this tab:
Click the Show wireframes icon to present the wireframe preview. Blue wireframe rectangles help you understand the structure of the section, names of rules referenced in this rule, and the size and other relationships of elements in the section.
Click the Hide wireframes icon to hide wireframes, providing a less busy and more faithful preview.
These controls operate on layout structures. Select one or more cells first, then click the control to apply the operation. When a control is not available (grayed), it cannot be applied to the current selection. Hover over a control to display a tool tip with information about the control.
You can also use keyboard shortcuts and right-click context menus to cut, copy, paste, and delete. Select a layout, section include, column, row, or cell and then:
CTRL + X), Copy (CTRL + C), Paste (CTRL + V), or Delete. For the full set of keyboard shortcuts that are supported, refer to the Shortcut definition. If the section contains deprecated controls for which there are auto-generated alternatives available, an Update Controls option displays.
Click Update Controls to automatically update the deprecated controls. Buttons with custom settings must be manually converted to use the pxButton control. To add controls to those automatically updated, see Upgrading deprecated and outdated controls on the PDN.
| Deprecated | Replacement | |
|---|---|---|
| TextArea TextAreaSmall TextAreaWithExpandSmall TextAreaExpanded |
TextAreaWithExpand
TextAreaInTable TextAreaExpandedOverflow TextAreaWithExpandExpanded |
pxTextArea |
| Date-Calendar
DateTime-Calendar DateTime- CalendarHarness DateCalendarForDataGrid Export_Date Export_DateTime SecondsToHours SelectDate SelectDateTime DateTime DateTime-Default DateTime-Full DateTime-Long DateTime-Medium DateTime-Short DateTime-Full-i18n DateTime-Long-i18n DateTime-Medium-i18n |
DateTime-Short-i18n
|
pxDateTime |
| PromptSelect DynamicSelect |
pxDropDown | |
| RichTextEditor | pxRichTextEditor | |
| Autocomplete | pxAutoComplete | |
| URL | pxLink | |
| Checkbox | pxCheckbox | |
| RadioButtons | pxRadioButton | |
| Button | pxButton | |
Areas of the layout that correspond to sections (or other elements) that you cannot update appear with a gray background. This may mean that the rule needs to be checked out to you, or belongs to a locked ruleset version, or a ruleset version you are not allowed to update.
Sections in a harness may be presented as horizontal elements or as clickable tabs. These are "live" in the Design tab; click a tab to bring it to the front, or click a plus sign to expand a section.
When you save a Harness rule form, the state of these controls is saved as well, and determines the initial presentation of the form. To achieve the desired results, before you save the Harness rule form:
Structurally, every harness consists of one or more containers. (The container structure is not required for those harnesses that are defined through handcrafted HTML code.) A container can provide a visual grouping of multiple sections.
Headers belong to containers. A container may have a horizontal header, a set of tabs identifying the (top-level) sections it contains, or no header.
Each container can contain one or more sections, which in turn can contain layouts, repeating layouts, and other sections. Sections contain layouts.
You can rapidly mock up the layout, labels, and controls on this tab before all properties it ultimately will reference are defined. The development effort you make in designing layout is not wasted, as the resulting harness is a valid starting point for further evolution after the properties are created.
When you first drop a control dragged from the Basic Group, the control initially references a standard placeholder property, for example @baseclass.pyTemplateInputBox. You can save and preview the Harness form (although these properties are not part of your application's work items).
To produce a harness with the appropriate layout, drag and drop the controls, adjust the labels, but do not complete the Cell Properties panel. Reopen the Harness form and update each Cell Properties panel later, when the real properties are defined.
For an example of this approach, see PDN article Use pyTemplate properties and controls to rapidly prototype user forms.
The Layout control group has the following options.
Control |
Description |
| Screen Layout |
Add a screen layout to this harness. See Adding a screen layout. |
| Container |
Add a container to the harness form. Every harness must contain at least one container, and every container must contain at least one section. See Adding a container. |
| Layout |
Add a layout to the section included in a harness container — a <TABLE> element containing one or more rows and one or more columns. You can then change the number and size of rows and columns, and set up the contents of each cell (a <TD> HTML element). See: |
| Section |
Add a section to a harness container. See Adding a section. |
| Layout Group |
Add a layout group to a harness container. See Adding a layout group. |
| Tab |
Add a tabbed container to a harness. See Adding a tabbed container. |
| Accordion |
Add an accordion container to a harness. See Adding an accordion container. |
| Dynamic Container |
Add a dynamic container to a harness. See Adding a dynamic container. |
A cell can hold a label or property value or a form field that accepts a user-entered property value. The property value uses a control to present the value in read-only or read-write mode.
The Basic control group has the following options.
Control |
Description |
| Text Label |
Add a static read-only text label into a cell. See Adding a label. |
| Formatted Text |
Add formatted text to a cell. See Adding formatted text. |
| Text Input |
Add a Text Input, which corresponds to .pxTextInput control. See Adding a Text Input control. |
| Text Area |
Add a TextArea, which can contain more than one line of text. Corresponds to the.pxTextArea control. See Adding a Text Area control. |
| Icon/Image |
Add an icon or image to the form, in a cell or on a header. When clicked at runtime, the icon starts an action. Corresponds to the .pxIcon control. See Adding an icon or image. |
| Button |
Place a button into a cell or at the bottom of the form. When clicked at runtime, the button starts an action. Corresponds to the .pxButton control. See Adding a button. |
| Check Box |
Add a check box representing a |
| Radio Buttons |
Add a radio button group representing a property value. Corresponds to the.pxRadioButtons control. See Adding a radio button control. |
| Link |
Place a text link in a cell. When clicked at runtime, the link starts an action. Corresponds to a .pxLink control. See Adding a Link control. |
| Date & Time |
Add a text box containing a |
| Dropdown |
Add a Dropdown control to present a list of values. Corresponds to the .pxDropdown control. |
The Advanced control group has the following options.
Control |
Description |
| Paragraph |
Reference, in a cell, a paragraph rule that presents only read-only text and images using rich text. Optionally, you can link a SmartInfo pop-up section with the paragraph. See Adding a paragraph. |
| Auto Complete |
Use an Autocomplete text box to present a drop-down list of dynamic choices computed by an activity. See Adding an Autocomplete field. |
| Smart Label |
Add a red label that opens a pop-up SmartInfo section when the user hovers the mouse pointer over the label. See Adding a Smart Label. |
| Chart |
A cell can contain a chart. See Adding a chart. |
| Data Field |
For harnesses that are part of a composite application built with Internet Application Composer only. Add a hidden field to expose a property value, making it available to the external page that displays the composite application. See Adding a Data Field control. |
| Menu |
Add a menu to a composite portal. See Adding a Menu Bar. |
| Rich Text Editor |
Add a rich text editor control. Corresponds to the .pxRichTextEditor control. See Adding a Rich Text Editor control. |
| Signature Capture |
Used to capture a user signature, either by using a mouse or through touch input on a mobile device. Corresponds to the pxSignatureCapture control. See Adding a Signature Capture control. |
| Address Map |
Used to specify an address or location in Google Maps from within an application. Corresponds to the pxAddressMap control. See Adding an Address Map control. |
| Information Mashup | Used to connect to an external application and delegate access to OAuth 2.0-resources. Corresponds to the pxInformationMashup section. See Adding an Information Mashup section. |
| Video | Add a video control. See Adding a video. |
Note: In addition to these Advanced controls, you can add interactive data displays to support quick review or editing for a Page List or Value List. Adding a Tree, Adding a Grid, Adding a Tree Grid.
You can complete two cells of a layout in one step if the left cell is to contain a text label and the right cell is to contain a field corresponding to a property on the Application Explorer.
Single Value property to be placed in the field. Drag and drop the dot into the desired cell.Note: You cannot use this tab to modify sections (referenced in the harness) with the Auto-generated HTML check box cleared (on the Advanced tab). These are marked Manual HTML on this tab. Similarly, you cannot use this tab to modify sections are in the legacy format. These are marked Not Upgraded on this tab.