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.