API Updates for February 2024

API Updates

The next Kintone update is on 13th February 2024. The release also includes the following API updates.

Update Summary

On this update, spec changes will be made for the Event Object and JavaScript APIs when handling non-numeric values in the Number field. This option was available in the Update Options of the November 2023 update.

Before the update:

  • When using Event Objects and JavaScript APIs to work with Number fields, users could retrieve or rewrite with non-numeric values. Therefore, it was necessary to implement codes to determine whether the value retrieved was a number or not.

After the update:

The feature can be disabled from the Disable New Features settings until May 2024.

Spec Changes

New rules will be set for values that can be retrieved or changed to in Number fields

  • Numbers
    • "+" or "-" can be used to express positive and negative values
    • "." can be used to express decimals
    • "e" or "E" can be used to express exponentials
  • Whitespaces

Only single-byte characters can be used for numbers and symbols.

In addition, the following values can be used for Event Objects and JavaScript APIs when changing the value in the Number fields:

  • undefined null: The value in the Number field will become empty.
  • #INVALID!: The value in the Number field will not be changed.

Values that are not specified above are treated as invalid values in the Number field.

#INVALID will be returned in event objects if non-numeric values are set in Number fields

Entering an invalid value in the Number field will return #INVALID!.

Record Create Events:

  • Onload Events
    app.record.create.show mobile.app.record.create.show
  • Field Change Event
    app.record.create.change.(fieldcode) mobile.app.record.create.change.(fieldcode)
  • Save Event
    app.record.create.submit mobile.app.record.create.submit

Record Edit Events:

  • Onload Event
    app.record.edit.show mobile.app.record.edit.show
  • Field Change Event
    app.record.edit.change.(fieldcode) mobile.app.record.edit.change.(fieldcode)
  • Save Event
    app.record.edit.submit mobile.app.record.edit.submit

Get Record:

Notes

Before determining whether the value is invalid, the following actions are performed:

  • PC screen:
    • Conversion to Single-byte characters
    • Elimination of comma separators
    • Removal of spaces
  • Mobile screen:
    • Removal of spaces

Errors occur if invalid values are set in Number fields

Setting the value of the Number field with an invalid value using Event Objects or JavaScript API will result in an error.

Record Create Events:

  • Onload Events
    app.record.create.show mobile.app.record.create.show
  • Field Change Event
    app.record.create.change.(fieldcode) mobile.app.record.create.change.(fieldcode)
  • Save Event
    app.record.create.submit mobile.app.record.create.submit

Record Edit Events:

  • Onload Event
    app.record.edit.show mobile.app.record.edit.show
  • Field Change Event
    app.record.edit.change.(fieldcode) mobile.app.record.edit.change.(fieldcode)
  • Save Event
    app.record.edit.submit mobile.app.record.edit.submit

Record List Event:

Set Record:

Values inside Number fields will not change if #INVALID is specified for updating Number fields

When changing the value to #INVALID! using Event Objects or JavaScript API, the value will not change.

Record Create Events:

  • Onload Events
    app.record.create.show mobile.app.record.create.show
  • Field Change Event
    app.record.create.change.(fieldcode) mobile.app.record.create.change.(fieldcode)

Record Edit Events:

Set Record:

Trailing whitespaces in Number fields will be sanitized in the mobile view

In the mobile view, if whitespaces are entered before or after a value, they will be sanitized.

Record Create Events:

Record Edit Events:

Get Record:

Events will not trigger if there are no value changes from sanitizing whitespaces in the mobile view

When whitespaces are sanitized, as long as the final value does not change, an event will not be triggered.

Record Create Events:

Record Edit Events:

Set Record:

Product News

Be sure to check out the Kintone Product Updates (External link) over at the product website for the latest news on feature improvements and important notices!