NSOA.form.getValue(field)
Use this function to get the value of the field on the OpenAir form. Keep in mind, any pick lists (for example Customer:Project, Employee, Expense item) will return an internal_id and not a text value. In this release, only fields directly related to the form are available (for example no related table lookups are available now). See also NSOA.form.getAllValues() and NSOA.form.get_value(field).
Parameters
-
field {string} [required] — The name of the field on the form.
Note:This is not the label the user sees displayed next to the field on the form. Use the Form Schema to find the correct field name value.
Returns
-
The value in the specified field. Use the Form Schema to find the data type of the returned value.
Note:Some fields return an object. See Object Fields for more details.
Units Limit
-
1 unit
For more information, see Scripting Governance.
Since
-
August 17, 2013
Example
-
This example creates a local variable called receiptDate and sets its value to the content of the date field on the form the script is attached to.
var receiptDate = NSOA.form.getValue('date');
-
This sample gets a value from a field that returns an object. See Object Fields for more details.
// First get the object variable for the field and then get the cost_0 value for the first row var loaded_cost_obj = NSOA.form.getValue("loaded_cost"); var value = loaded_cost_obj[0].cost_0; // You can combine these two steps into one line var value = NSOA.form.getValue("loaded_cost")[0].cost_0;
See Code Samples for more examples.