API Docs

Field Change Event

Field Change Event - app.record.create.change.(fieldcode)

An event triggered when a specified field value changes when creating a new record.

Function

Desktop

app.record.create.change.(fieldcode)

Mobile

mobile.app.record.create.change.(fieldcode)

Fields that can be Specified

  • Radio button
  • Drop-down
  • Check box
  • Multi-choice
  • User selection
  • Department selection
  • Group selection
  • Date
  • Time
  • Date and time
  • Single-line text
  • Number
  • Table

Make sure to specify the field codes of these fields. Nothing will happen if the field code does not exist, or a field that is not in the above list is specified.

*The timing of the event for the Single-line text is as below:

  • when the focus leaves the field.
  • when the Lookup field mappings have been run.
  • For PC, after calculations have been applied to a Single-line text field that has the Calculate automatically option turned on.

*The timing of the event for the Number is as below:

  • when the focus leaves the field.
  • when the Lookup field mappings have been run.

*The timing of the event for the Table is as below:

  • when a new row is added to the table
  • when a row is deleted from the table

Properties of the Event Object

PROPERTY TYPE DESCRIPTION
appId Number The App ID.
record Object A record object including data inputted by the user at the time of the event..
changes Object An object including data of changed fields and rows.
changes.field Object An object of the changed field.
changes.row Object An object of the changed row.
  • If a row is added to a table: changes.row will reference the new row object.
  • If a row is deleted from a table: changes.row will be null.
  • If a field outside of a table is changed: changes.row will be null.
type String The event type.

Available Event Object Actions

Notes

  • When comma-separated values, whitespaces, or double-byte characters are sanitized, as long as the final value does not change, the event will not be triggered. For example, if the user enters a value of 1000 into a field, and then proceeds to manually change the value to 1,000, 1000, or １０００, the value will be sanitized back to 1000 (the same number), and the field change event will not be triggered.

Limitations