API Docs

Field Change Event

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

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

Function

Desktop

app.record.create.change.(fieldcode)

Mobile

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

Triggered Timing

  • When the value of a field specified in the fieldcode is changed on the Add Record or Duplicate Record Page.
  • After an App Action is executed, the value of a field specified in the fieldcode is changed on the Add Record page of the copy destination App.
  • When the value of a field specified in the fieldcode is overwritten using the following API or events:

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
  • Lookup

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

  • The timing of the event for the Lookup is as below:

    • when the source record is confirmed by clicking Lookup. This includes both automatic retrieval and when clicking Set on the lookup picker dialog.
    • when the Lookup field is cleared.
    • when the focus leaves the field.

    The event is triggered only when the search keyword or the selected source record changes. The Lookup field change event is triggered before the change events of its field mapping destinations.

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

  • Events are not triggered for fields not listed in the following section:
    Fields that can be Specified
  • Values from the Attachment field cannot be retrieved.
  • Refer to the Limitations section of the following article:
    Event Handling