Single-Value Picker
Single-value picker is quick tool to develop a dialog box for collecting single value from user input. A single-value picker can be used in base forms and grid views.
The best practice is to invoke single-value picker dialog boxes from buttons or menu items' scripts (apply to base forms and grid views). See the following JavaScript piece for example; here param and defaultValue are optional arguments. param is only applicable for lookup and select types; Using defaultValue will override the single-value picker's Default Value.
function MyButtonClicked([parm, defaultValue])
{
   var userInput = OpenSingleValuePicker('my-ref-key'[,parm,defaultValue]);
   if(userInput)
   {
      // value1 is available for all types of single-value pickers;
      // value2 is only available for daterange type as End Date.
      alert(userInput.value1);
      alert(userInput.value2); 
   }
}
Single-value pickers can be also used in grid views to bulk update selected row records. When creating a grid view menu, select the following Command Script:
doBulkUpdate('{gridId}', ?[, ?]);

Replace the first question mark with the single-value picker's reference key, and optionally replace the second optional question mark with param value as discussed in the above case.
Common Single-Value Picker Attributes
  • Name / Title: Picker name and the dialogbox title;
  • Reference Key: Unique reference key;
  • Field Title: Display text in the front of the web field;
  • Field Type: UI type of the input web field;
  • Description: Picker description and the dialogbox message;
  • Default Value: Default value; it may be overridden by HTTP query;
Special Attributes
Lookup Field Type Additional Attribute
  • Lookup: Lookup picker's reference key;
Number Field Type Additional Attributes
  • Number Type: Integer number or float number;
  • Accuracy: Only applicable to float type number;
Select Field Type Additional Attributes
  • Database: Integer number or float number;
  • Select SQL: Only applicable to float type number; precision digits.