Objects

Returns a link to the field for which the custom script has been opened.

Example:
['Document Section 1', 'Group[10]','Field3'],
where [10] is the number of the instance of the repeating group.

• namesPath is an array containing field and group names that form the path to the field or a link to a field object.

Returns:

• a string for a TextField field;
• a checkmark value for a Checkmark field;
• a string array for a Checkmark Group field.

namesPath | fieldObject:

• an array containing field and group names that form the path to the field or a link to a field object,
• or a link to the field object.

Modifies the field value for which the custom script has been opened.

Parameters:

• value – the field value.
• forced – updates the field value and records new data. This parameter is optional.
• false – the field value in the Document Definition will be updated only after the save() function has been called.
• true – the field value in the Document Definition will be updated immediately.
  
  For a custom script, an update will occur regardless of the mode.
  By default, this parameter is set to false.

• onSaved – callback function. Called if the forced parameter is set to true. This parameter is optional.

Modifies the field value.

Parameters:

• namesPath | fieldObject:
• an array containing field and group names that form the path to the field,
• or a link to the field object.
• value – value of the corresponding field.
• forced – updates the field value and records new data. This parameter is optional.
• false – the field value in the Document Definition will be updated only after the save() function has been called.
• true – the field value in the Document Definition will be updated immediately.
  
  For a custom script, an update will occur regardless of the mode.
  By default, this parameter is set to false.

• onSaved – A callback function. Called if the forced parameter is set to true. This parameter is optional.

(*) For some functions listed above, the path to the field is specified as an input parameter. It comprises the field name and the names of the parent elements (field group, section). For tables, repeating tables, and repeating groups, you need to specify the instance number starting at 0 (zero).

Example:
['Document Section 1', 'Group[10]','Field3'],

where [10] is the number of the instance of the repeating group.

addEntity(entityInfo: {cacheName, columns, values}, onResult(newId))

Adds an entry to the data set.

Parameters:

• entityInfo – an object:
• cacheName – a name for the data set.
• columns – names for the columns where data will be recorded. Array of strings.
• values – the values for the corresponding columns. Array of strings.
• onResult – a callback function that receives the ID of the record created in the data set.

Edits an entry in the database.

Parameters:

• entityInfo – an object:
• cacheName – a name for the data set.
• columns – names for the columns where data will be recorded. Array of strings.
• values – the values for the corresponding columns. Array of strings.
• onResult – a callback function.

Carries out a data set search for a specified value or for a part of it. Returns the matching strings in the following format:

[{FieldName
FieldValue
BoldMask}].

Parameters:

• cacheName – the data set name.
• filters – search parameters:
• FieldName – the field name. Leave empty to search all fields.
• FieldValue – the field value.
• cursorPos – the position of the cursor in the entry field.
• If a value was entered partially and the cursor is positioned after the typed symbols, they will be considered as a prefix for the value that is being searched for.
• If the cursor is positioned before a partially typed word, those symbols will be considered as the ending of the value that is being searched for.
  
  For example, if, when searching for a company name, you type in "ADO" and the cursor is positioned after it, the value "AVOCADO" will be selected.
  If you type in "ADO" and the cursor is positioned in front of it, the value "ADONIS" will be selected.

• allowMultipleColumnResults – Returns the values of the fields that have been found.
  The data set may contain entries for which one field name (FieldName) corresponds to multiple field values (FieldValue). For example, two or more variations of a company's name may be specified in the CompanyName column.
  
  In this case:
• true – returns and records all field values that satisfy the search conditions,
• false – returns and records a single result that best fits the search conditions.
• onResult – a callback function that returns a search result array. Each result is a single string from the data set, which is a string array. Each string comprises the field name, its value, and the BoldMask parameter.
  
  BoldMask – a string of ‘0’ and ‘1’ the same length as the value found during the search. '1' represents a symbol from the found value that matches the corresponding symbol in the search field, and '0' represents a symbol that does not.

If, for example, the following is present in a data set:

CompanyName: ABBYY

Let's assume that a search is carried out for the symbols "ABB".

Then, the following will be returned:

[

  [

     {

           FieldName: ‘CompanyName’,

           FieldValue: ‘ABBYY’,

           BoldMask: ‘11100’

      },

  ]

]

Note: The returned array can contain several values, including those that did not initially fit the search conditions. The search results in the array will be sorted by BoldMask parameter value in descending order (i.e. starting with strings that best match the search conditions).

Carries out a database search for the entire value specified. Returns the values of all fields that have been found.

Parameters:

• cacheName – the data set name.
• Filters – an object array:
• FieldName – the field name. In order to search on all fields, this should be left blank.
• FieldValue – the field value.
• onResult – a callback function that returns a search result array. Each result is a single string from the data set, which is itself a string array. Each string comprises the field name, its value, and the BoldMask parameter.
  
  BoldMask – a string of ‘0’ and ‘1’ the same length as the value found during the search. '1' represents a symbol from the found value that matches the corresponding symbol in the search field, and '0' represents a symbol that does not.
  
  
  If, for example, the following is present in a data set:
  
  CompanyName: ABBYY
  
  Let's assume that a search is carried out for the symbols "ABB".
  
  Then, the following will be returned:

[

  [

     {

           FieldName: ‘CompanyName’,

           FieldValue: ‘ABBYY’,

           BoldMask: ‘11100’

      },

  ]

]

Note: The returned array can contain several values, including those that did not initially fit the search conditions. The search results in the array will be sorted by BoldMask parameter value in descending order (i.e. starting with strings that best match the search conditions).

Marks a table row as selected.

• tablePath | fieldObject:
• an array of field and group names that form the path to the table field,
• or a link to a table object.
• rowNumber – the number of the row to select, zero-based.

Removes selection from a table row.

• tablePath | fieldObject:
• an array of field and group names that form the path to the table field,
• or a link to a table object.
• rowNumber – the number of the row to deselect, zero-based, if omitted the selection is removed from all rows in the table.

Scrolls the form editor to get the field into view.

• namesPath | fieldObject:
• an array of field and group names that form the path to the table field,
• or a link to a table object.

Gets the position of an element in the form editor window and returns the result of a callback function.

• domId – element ID in DOM format.
• onResult – a callback function that receives the object with the DOM coordinates of the element (width, height, top, left, right, bottom) relative to the top left corner of the browser window.

Adds CSS styles to the custom action frame window.

• styles – an object with CSS property names and values.
  
  example:
  {
  display: 'block',
  position: 'absolute',
  top: '0px',
  bottom: '0px',
  left: '0px',
  right: '0px',
  width: '100%',
  height: '100%',
  border: '0',
  overflow: 'hidden',
  'overflow-x': 'hidden',
  'overflow-y': 'hidden',
  'z-index': '10000'
  }
• callback – a callback function.

(*) For some functions listed above, the path to the field is specified as an input parameter. It comprises the field name and the names of the parent elements (field group, section). For tables, repeating tables, and repeating groups, you need to specify the instance number starting at zero.

Example:
['Document Section 1', 'Group[10]','Field3'],

where [10] is the number of the instance of the repeating group.

Field type. Possible value:

4 – field group

Array of regions.

• Id – region ID.
• Status – status of the region.
• 0 – region not superimposed (or region is deleted)
• 1 – region is not recognized
• 2 – the value from the region is substituted in the field
• PageId – ID of the page on which the region is located.
• IsNew – flag to indicate new regions.
• Coordinates – coordinates of the region in the image.

Field type. Possible value:

6 – section

Array of regions.

• Id – region ID.
• Status – status of the region.
• 0 – region not superimposed (or region is deleted)
• 1 – region is not recognized
• 2 – the value from the region is substituted in the field
• PageId – ID of the page on which the region is located.
• IsNew – flag to indicate new regions.
• Coordinates – coordinates of the region in the image.

List of table rows.

The parameters of the object line in the table:

• Id – row ID.
• RowNumber – the sequence number of the row, counting from zero.
• TableBlockId – identifiers of sections, tables, table blocks forming the path to the table block..
• Cells – fields in table cells. Fields can be of the following types: picture, checkmark, checkmark group, text.

Field type. Possible value:

7 – table

Array of regions.

• Id – region ID.
• Status – status of the region.
• 0 – region not superimposed (or region is deleted)
• 1 – region is not recognized
• 2 – the value from the region is substituted in the field
• PageId – ID of the page on which the region is located.
• IsNew – flag to indicate new regions.
• Coordinates – coordinates of the region in the image.

array of the same length as the field Value. Consists of 0 and 1.

0 – a character that is in Value in the same position as 0 in Flags, requires verification.

Type of text field. Possible value:

• 0 – text field.
• 1 – numeric field.
• 2 – currency amount fields.
• 3 – DateTime field.
• 4 – Date field.
• 5 – Time field.
• 6 – Code field.

Field type. Possible value:

0 – text field

Array of regions.

• Id – region ID.
• Status – status of the region.
• 0 – region not superimposed (or region is deleted)
• 1 – region is not recognized
• 2 – the value from the region is substituted in the field
• PageId – ID of the page on which the region is located.
• IsNew – flag to indicate new regions.
• Coordinates – coordinates of the region in the image.

Field type. Possible value:

2 – checkmark

Array of regions.

• Id – region ID.
• Status – status of the region.
• 0 – region not superimposed (or region is deleted)
• 1 – region is not recognized
• 2 – the value from the region is substituted in the field
• PageId – ID of the page on which the region is located.
• IsNew – flag to indicate new regions.
• Coordinates – coordinates of the region in the image.

List of possible field values:

• Id – record ID
• Name – record name

Field type. Possible value:

3 – checkmark group

Array of regions.

• Id – region ID.
• Status – status of the region.
• 0 – region not superimposed (region is deleted)
• 1 – region is not recognized
• 2 – the value from the region is substituted in the field
• PageId – ID of the page on which the region is located.
• IsNew – flag to indicate new regions.
• Coordinates – coordinates of the region in the image.

Field type. Possible value:

1 – picture

Array of regions.

• Id – region ID.
• Status – status of the region.
• 0 – region not superimposed (or region is deleted)
• 1 – region is not recognized
• 2 – the value from the region is substituted in the field
• PageId – ID of the page on which the region is located.
• IsNew – flag to indicate new regions.
• Coordinates – coordinates of the region in the image.

Field type.

Possible value:

8 – recurring section group.

Build errors in the document where:

• DocumentNodeRef – list of links as an array of field IDs to fields in the form
• Description – error description
• SectionName – list of sections involved in the error

Errors in the document where:

• DocumentNodeRef – list of links as an array of field IDs to fields in the form
• Severity:
• 1 – Error,
• 0 – Warning
• Message – error text
• RuleName – the name of the rule that caused the error

List of document pages containing the following:

• Id – page ID
• Modification – the revision number of the page
• HasColorImage –specifies the color of the page
• ImageResolution – image resolution
• KeyValue – the value of the key field page
• SectionTemplateId – ID section of the page
• SectionTemplateName – page section name
• SectionTemplatePageNumber – the page number in the section
• Comment – review of the page
• ImageWidth –width of the image page
• ImageHeight – height of the page image