Date Picker Element Properties

The Date Picker element enables you to select a date.

Back to Form Elements

Related topic: Element Properties

The date format property

Date values are stored internally in the "yyyy-mm-dd" date format. You can define the format for the date (for example, mm/dd/yyyy).

In addition, you can define your own date format. The Date Format property, however, is for display purposes only and is not the value being saved.

The date format can be combinations of the following:

  • d - day of month (no leading zero)

  • dd - day of month (two digit)

  • o - day of the year (no leading zeros)

  • oo - day of the year (three digit)

  • D - day name short

  • DD - day name long

  • m - month of year (no leading zero)

  • mm - month of year (two digit)

  • M - month name short

  • MM - month name long

  • y - year (two digit)

  • yy - year (four digit)

  • @ - Unix timestamp (ms since 01/01/1970)

  • ! - Windows ticks (100ns since 01/01/0001)

  • '...' - literal text

  • '' - single quote

  • anything else - literal text

Name

Value Type

Description

Name

Text

The internal name for an element in the form.

Binding

Menu selection

The name (not the label) of the form field to which an element is bound.

Element Type

TextBox | Text Area | Dropdown | ComboBox | Date Picker | Number | Email | Checkbox | Radio Button

Lets you quickly change a basic element (such as a Text Box) to another, similar type of basic element, such as a Dropdown or Combo Box.

Required

True | False

True: Requires input from the user and marks the form field with a red asterisk.

False: Element will not require user input.

Read Only

True | False

True: Element is read-only and cannot be modified.

False: Element can be modified.

Placeholder Text

Text

Placeholder text is a short description or hint that that describes the expected value of an input field. (For example, "Enter phone number xxx-xxx-xxxx"). The short hint is displayed in the input field before the user enters a value.

Rules

Special

Click to view (or create) any Rules (logic, formulas, etc.) applied to an element.

Promote to Solution Field

Text

Name of the solution field to which this field is promoted. If the field name provided here does not exist in the solution fields, then a field with provided name will be created in the solution fields.

Default Value

Number/Text

The default value for an element.

Refresh Default Value

True | False

True: Forces the element to re-evaluate any applicable default values when a field value changes.

False: (default) - Element will not re-evaluate default values when a field changes.

Date Format

Menu selection

The format style of a date entry, e.g. mm/dd/yyyy.

First Day

Menu selection

The day from which the calendar needs to be started.

Encrypt

True | False

When the Field Encryption property is set to True for a form field, data entered into the field is stored in an encrypted format in the form XML and log files.

Note: If the field is in a form view to be rendered, or the field needs to post to SAP or any 3rd party web service, the field is decrypted by the Server and sent in plain text format. In order to ensure complete security, the data transmission should occur via https.

Class Names

Text

Space separated Names of CSS classes to be used to customize the look of the element.

Propagate Changes to all Views

True | False

When you change style or properties for common labels in a Composer form with multiple views, you will be prompted by a dialog box asking if you want to apply the changes to all views. Setting this option to True automatically propagates style or property changes to all applicable views without prompting.

Converting the date format for upload

If you are using the Value Setter node in the workflow, you must use the default yyyy-mm-dd format; otherwise, the date will not be set. For uploading to SAP in the required format, see the instructions below.

If a different format is required to correctly input the date into another service, such as SAP, do the following:

  1. Add a new field to the solution tree (wherever is appropriate for your form).

  2. Bind the newly added field to the field displayed on the Form View.

  3. Add a Set Action Rule to the field displayed in the form view that sets the value of the input field of the Web service to the format required.

Example

formatDate($form.getValue('/my:myFields/my:dateString'),"mm.dd.yyyy");

Note:

To encrypt a DatePicker/Number Form element follow the steps given below.

  1. Create a solution field of text type and map it the 'Promote to Solution Field' property.

  2. Change Date/Number field to text type.

  3. Copy the value of Date/Number to another text field and apply 'Promote to Solution Field'.