setFieldsValues

Description

Sets the values for more than one form control.

Parameters

The method input is an object with these parameters, and a callback function.

Output

A result object that gives the status, data, and error details.

Example

var options = {};
// Sets the values for more than one form control.
// The Number1 and Date1 are the internal names of the form controls.
options.fields = [{
    id: 'Number1', 
    value: '0112345678'
  }, 
  {
    id: 'Date1', 
    value: '01/09/2023'
}]; 

// Set the values for all rows in a Subform form control.
// The Subform1 is an internal name of the Subform form control.
// The Number1 and Date1 are the internal names of the form controls.
// The Number1 and Date1 controls exist in the Subform1 form control.
// The value Subform1/Number1 shows the path of Number1.
// The value Subform1/Date1 shows the path of Date1.
// You can also use this format:
// options.fields = [{
    // id: 'Subform1/Number1', 
    // value: '0112345678'
  // }, 
  // {
    // id: 'Subform1/Date1', 
    // value: '01/09/2023'
}]; 

// Alternatively, you can specify rowIndex as an asterisk '*' 
// to set the values for all rows in a Subform1 form control.
// options.fields = [{
    // id:'Subform1/Number1: [*]', 
    // value: '0112345678'
  // }, 
  // {
    // id: 'Subform1/Date1: [*], 
    // value: '01/09/2023'
}]; 

// You can specify the row number to set 
// the values for specific rows 
// in a Subform1 form control.
// options.fields = [{
    // id: 'Subform1/Number1: [rowindex]', 
    // value: '0112345678'
  // },
  // {
    // id: 'Subform1/Date1: [rowindex]', 
    // value: '01/09/2023'
}];
		
eFormHelper.setFieldsValues(options, function (result)
{
  // Checks if the method is successful.
  if (result.isSuccess) 
      
  {
    // Logs the data that has the empty object.
    console.log(result.data); 
  }
  else 
    {
      // Logs errors and error descriptions.
      console.log(result.error); 
    }
});

Supported Versions

AgilePoint NX v8.0 Software Update 2 and higher.

Other Examples

• (Example) Use Custom JavaScript in an eForm
• JavaScript Methods for eForm Builder - Examples for JavaScript methods that are available out-of-the-box (OOTB) in AgilePoint NX.