API Updates for February 2024
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:
- New rules will be set for values that can be retrieved or changed to in Number fields
-
#INVALID
will be returned in event objects if non-numeric values are set in Number fields - Errors occur if invalid values are set in Number fields
-
Values inside Number fields will not change if
#INVALID
is specified for updating Number fields - Trailing whitespaces in Number fields will be sanitized in the mobile view
- Events will not trigger if there are no value changes from sanitizing whitespaces in the mobile view
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!
.
Related Events/APIs
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:
-
Get Record Details
kintone.app.record.get()
kintone.mobile.app.record.get()
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.
Related Events/APIs
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:
-
Field Change Event
app.record.index.edit.change.(fieldcode)
Set Record:
-
Set record value
kintone.app.record.set()
kintone.mobile.app.record.set()
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.
Related Events/APIs
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:
-
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)
Set Record:
-
Set record value
kintone.app.record.set()
kintone.mobile.app.record.set()
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.
Target Events/API
Record Create Events:
-
Onload Events
mobile.app.record.create.show
-
Field Change Event
mobile.app.record.create.change.(fieldcode)
-
Save Event
mobile.app.record.create.submit
Record Edit Events:
-
Onload Event
mobile.app.record.edit.show
-
Field Change Event
mobile.app.record.edit.change.(fieldcode)
-
Save Event
mobile.app.record.edit.submit
Get Record:
-
Get Record Details
kintone.mobile.app.record.get()
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.
Target Events/API
Record Create Events:
-
Onload Events
mobile.app.record.create.show
-
Field Change Event
mobile.app.record.create.change.(fieldcode)
Record Edit Events:
-
Onload Event
mobile.app.record.edit.show
-
Field Change Event
mobile.app.record.edit.change.(fieldcode)
Set Record:
-
Set Record Value
kintone.mobile.app.record.set()
Product News
Be sure to check out the Kintone Product Updates over at the product website for the latest news on feature improvements and important notices!