Awaken Scripting User Guide

Please email helpdesk@awaken.io for omissions or errors.
×
Menu

Date

 
The Date control provides a calendar picker to agents to allow them to easily find and select a date, and optionally a time picker too.
 
It appears similarly to a Text Box until selected, at which point the picker pops out from it. The agent can then select the desired date and/or time from the picker.
 
 
 
This control is part of the Basic control pack, and will always be available.
 
 

How To

Add a Date control to the Workflow Page. The control's options and style can be configured in the Options and Styling tabs of the Field Properties, and Validation can be applied if desired.
 
The Date control has one unique option available in its Options tab:
Option
Description
Date Format
This specifies how the date selected from the calendar picker is then displayed to the agent and stored within Scripting. It offers a range of options to suit different cultural and usage scenarios.
Minimum Date
Specify the minimum selectable date in YYYY-MM-DD format. Leave blank to not restrict the minimum date. Can reference a Field or Variable, and the value will be inserted at Page load.
Maximum Date
Specify the maximum selectable date in YYYY-MM-DD format. Leave blank to not restrict the maximum date. Can reference a Field or Variable, and the value will be inserted at Page load.
Allow Weekends
Choose whether weekend dates (Saturday and Sunday) are selectable.
Change Month
Choose whether a drop-down list is offered to select the month.
Change Year
Choose whether a drop-down list is offered the select the year.
Years In Past
How many years in the past to allow in the year-selection list, back to 1st January of that year. Permissible values can be found in the jQuery API. Note that if the value isn't set to the "c-nn" format, then this can also restrict the Minimum Date. Can reference a Field or Variable, and the value will be inserted at Page load.
Years In Future
How many years in the future to allow in the year-selection list, up to 31st December of that year. Permissible values can be found in the jQuery API. Note that if the value isn't set to the "c+nn" format, then this can also restrict the Maximum Date. Can reference a Field or Variable, and the value will be inserted at Page load.
Time Picker
Choose whether to display a time picker for the agent to select the time as well as date.
 
 

Notes

Despite its initial appearance, it's not possible to directly type into the Field itself.
 
If both Minimum Date/Maximum Date and Years In Past/Years In Future are set simultaneously, then the most restrictive range produced from all of the combined options is the one that is used.