Documents Client SDK

Class: FormModel

documents.sdk FormModel

Constructors

The FormModel is the abstract model for forms. It provides various methods to inspect and manipulate the form model data.
It should be used as the base model for models containing collections of fields such as FileFormModel or ExtendedSearchFormModel.
The initialize function should be overridden, if you plan to use a different Collection than the Backbone.Collection.

Every FormModel is a Backbone.Model.
It contains a Collection of FieldModels representing the fields.

Methods

getFieldById(id){FieldModel}

Searches for and returns a field model by its id.

Name Type Description
id String

the id of the field model to be searched for
Returns:
Type Description
FieldModel the field model if it could be found, null otherwise

getFieldByName(name){FieldModel}

Searches for and returns a field model by its name.

Name Type Description
name String

the name of the field model to be searched for
Returns:
Type Description
FieldModel the field model if it could be found, null otherwise

getFields()

Returns a Backbone.Collection of all field models containing this form model.

Returns:
Backbone.Collection the collection of all field models
Examples
//You can use the different methods from Backbone.Collection on the return value. Following are some examples for the most common ones.
// forEch method: Iterates over the fields and calls a function with each field as a param
form.getFields().forEach(function(field){
  console.log(field.toJSON());
});
// filter method: Looks through each field and tests each with a conditioning function, returns an array of fields where the function returns true
// this example returns an array of all the date-fields
form.getFields().filter(function(field){
return field.getType() == documents.sdk.FieldModel.Types.DATE;
});
// find method: Looks through the fields and returns the first field where the function returns true
// this example returns an array of all the date-fields
form.getFields().find(function(field){
  return field.getName === "Customer";
});
// map method: Iterates over each field and collects the return value of the inner function as an Array.
form.getFields().map(function(field){
  return field.getName();
});
// countBy method: Groups the fields into different categories and returns the amount of entries within the categories.
form.getFields().countBy(function(field){
  if(field.getValue() >= 0){
    return 'positivSaldo';
  }
  return 'negativSaldo';
});

getFieldsById(ids){Array.<FieldModel>}

Searches for and returns an array of all field models by its ids.

Name Type Description
ids Array.<String>

the array of all field model ids to be searched for
Returns:
Type Description
Array.<FieldModel> the array of all fields models that could be found

getFieldsByName(names){Array.<FieldModel>}

Searches for and returns an array of all field models by its names.

Name Type Description
names Array.<String>

the array of all field model names to be searched for
Returns:
Type Description
Array.<FieldModel> the array of all fields models that could be found

setFieldValuesById(object)

Sets the values of multiple fields. A key of the parameter-object defines the field-id and the corresponding value the new value.

Name Type Description
object Object

the objects keys is defines the fields and the values define the values.

setFieldValuesByName(object)

Sets the values of multiple fields. A key of the parameter-object defines the field-name and the corresponding value the new value.

Name Type Description
object Object

the objects keys is defines the fields and the values define the values.
Example
//usage of setFieldValuesByName on fileForm:
documents.sdk.exitRegistry.registerFileFieldExitCallback("crmAccount", "crmCompany", function(documentsContext, options) {
	var fileForm = options.fileForm;
	fileForm.setFieldValuesByName({
		crmCompany: "otris software AG",
		crmStreet: "Königswall 21",
		crmCity: "Dortmund"
		crmCountry: "Germany",
		crmRegion: "NRW"
	}); 	
});