NSOA.form.getName(field)

Use this function to get the parameter name of the field.

Note:

This is generally the same as the field name, that is, the required parameter to call this function. The function is useful when working with Object Fields.

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. This is the name of the field displayed in the Form Schema.

Returns

• The parameter name needed to refer to this field in user scripts.

Units Limit

• 1 unit

For more information, see Scripting Governance.

Since

• August 17, 2013

Example

• In this example the name returned is the same as the field name passed in, that is, budget_time.

                    var name = NSOA.form.getName('budget_time'); 
  
              

• In this example the name is the field name for the row and column specified for the loaded_cost object. See Object Fields for more details.

                // 'Primary loaded cost ' for the first row
  var name = NSOA.form.getName('loaded_cost')[0].cost_0; 
  
              

See Code Samples for more examples.