...
In order to help you retrieve the selected value(s) faster, we have created more app-specific SIL routines.
Category | Used with | Routine | Return value |
---|---|---|---|
Single value fields |
| BA_getSingleValue(argv, label) | String representing the value entered or the selected option for the given label. For a checkbox it will return "checked" if the checkbox was selected or an empty string if not. |
Multi value fields |
| BA_getMultiValues(argv, label) | String array representing the selected options. |
| String array containing pairs of original filename and uploaded path. Even indices will contain original filenames, while odd indices will contain an uploaded path. See Examples for usage. | ||
Checkbox |
| BA_isChecked(argv, label) | A method for checking whether a checkbox is selected or not. Returns a boolean: true if the box was checked, false otherwise. |
Date (since v2.0.8 and 2.6.1) |
| BA_getDateValue(argv, label) | This will retrieve a date value from the argv array. Note that for the date time picker, the value in the argv variable uses the user's time zone. BA_getDateValue will convert this value from the user's time zone to the server time zone. |
Note |
---|
These methods are only available in versions 1.0.1 and 2.0.1 and above. |
Let's take the following Screen Script as example.
...
Anchor | ||||
---|---|---|---|---|
|
...
Action Script
Once you have a screen that requires an additional user input, it is necessary to validate that input and let the user know if they did something wrong. This can be done by returning values from the script.
...