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:
|
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:
-
Add a new field to the solution tree (wherever is appropriate for your form).
-
Bind the newly added field to the field displayed on the Form View.
-
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");
To encrypt a DatePicker/Number Form element follow the steps given below.
-
Create a solution field of text type and map it the 'Promote to Solution Field' property.
-
Change Date/Number field to text type.
-
Copy the value of Date/Number to another text field and apply 'Promote to Solution Field'.