Back Forward Harness, Section, and Flow Action forms
Adding a Calendar control

About Harness rules

 zzz Show all 

A cell in a layout can present the value of a property, as display-only or as an input field. Follow these instructions to control the presentation of a property value as a Date or DateTime value.

 zzz 1. Drag and drop the Calendar control

Click the down-arrow (Arrow) at the right end of the Basic control group (Basics) and select the Calendar control (Calendar). 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 the cell is not empty, the dropped control replaces the current contents of the cell.

 zzz 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 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.

Complete the top fields of the Cell Properties panel.

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 and has a Property Type of DateTime. (If you are only prototyping a form and the property you want to reference is not yet defined, use the template property .pyTemplateCalendar.)

Alternatively, you can drag a property name from the lists of properties visible in the Application Explorer. Typically, this works for Single Value properties belonging to in the Applies to class of the current rule (or a higher class). If the container in which this field sits has a non-blank Using Page value, you can drag a Single Value property from within that embedded page property.

Click the pencil icon (Pencil) to review the property rule (if the reference is to an existing property in the Applies To class of this rule or a parent of that class). If the property is not found, the New dialog box for the property form appears.

You can reference properties on any page identified on the Pages & Classes tab, using the normal notation pagename.propertyname for pages other than the page corresponding to the Applies To class of the rule.

If this field is in a cell of a section that includes parameter declarations on the Parameters tab, you can enter the notation param.NAME here, to use a parameter value for the field, where NAME identifies a string parameter. Make sure that the NAME parameter is declared on the Parameters tab, and that your application provides a non-blank value for the parameter value in all possible situations where the section appears. See Section rules — Completing the Parameter tab.

Display As

SmartPromptTo represent the property as a date and time with a pop-up calendar, keep the value DateTime-Calendar.

Click the magnifying glass icon (Magnifying glass)to supply parameter values for this HTML property rule. All parameters are optional.

Parameter

Description

ReadOnlySmartInfo Optional. Identify the Purpose key part of a section to present as a SmartInfo pop-up for this control when the field is read-only.
ReadWriteSmartInfo Optional. Identify Purpose key part of a section to present as a SmartInfo pop-up for this control when the field is read-only.
SmartInfoHeader Optional. Enter text to appear in a SmartInfo header.
Width

Width in characters of the calendar control.

Some DateTime properties control have an Expected Length (in characters) defined on the Advanced tab of the Property form. Enter the special value auto for the Width parameter of the Default HTML property rule to cause the width of the input box to be set at runtime based on the Expected Length.

The auto overrides the column width restrictions of Smart Layouts.

Click OK to save parameter values.

If this DateTime property is within a section that itself has parameters (defined on the Parameters tab of the Section form), you can reference a section parameter to supply an HTML Property parameter value, with the normal notation PARAM.Name.

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 (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.

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.

 zzz 3. Complete the Cell properties panel — General tab

Complete the General tab.

The General tab for a DateTime field identical to the General tab for an Input box. See Adding an Input Box — Complete the Cell Properties Panel — General tab.

 zzz 4. Complete the Cell properties panel — Advanced tab

Complete the Advanced tab.

The Advanced tab for a DateTime field is identical to the Advanced tab for an Input box. See Adding an Input Box — Complete the Cell Properties Panel — Advanced tab.

 zzz Copying, deleting, duplicating, or moving a Calendar field

TipUse these Windows operations to speed development:

zzz About Flow Action rules

zzz About Harness rules

zzz About Section rules