在此向大家介绍 2023 年 11 月定期维护时与 kintone API 相关的更新信息。
如更新通知的内容有需要添加或更改，届时将在本文章后面追加更改或新增的内容。
另外，还将依次更改受 API 更新影响的 API 文档。

kintone

预计在今后发布的 API 更改内容，会作为更新选项提前向大家公开。
关于详细的更改内容，将择日发布。

以下于 10 月 17 日新追加

关于在2023年11月12日之后可提前试用的更新

预定于2024 年 2 月 11 日进行定期维护时，对kintone JavaScript API 中与数值字段相关的部分进行更改。
主要更改点是在获取数值字段中非数值的值时，以及用非数值的值对数值字段进行改写时的处理。

而在2023 年 11 月 12 日的定期维护之后，可通过更新选项预先试用以上更新内容。

更改背景

一直以来，通过 kintone JavaScript API 对数值字段进行操作时，可以获取非数值的值，也可以用非数值的值进行改写。
因此，在进行自定义时，需要先判断获取到的值是否是数值，再进行后续处理。

在本次更新后，将定下可在数值字段中使用的值。
因此，当使用 kintone JavaScript API 对数值字段的值进行操作时，如果使用的是非数值的值，其处理将发生如下变化。

• 获取非数值的值时，将返回 “#INVALID!”。

• 值要更改为非数值的值时，会报错。

更改之后，在值为非数值的情况下，自定义的处理将变得更加简洁，不需要考虑那么多事情。

发布日程表

• 2023 年 11 月版：通过 “提前使用计划发布的新功能” 更新选项可预先使用。

• 2024 年 2 月版：正式发布。可通过 “禁用新功能” 来禁用它。

• 2024 年 5 月版：不可通过 “禁用新功能”来禁用。

提前使用时需要的设置

在 kintone 系统管理的更新选项页面，如下设置选项。
kintone 帮助： 切换新功能启用/禁用的步骤

• 提前使用计划发布的新功能

  • 勾选 “通过 JavaScript 获取或设置数值字段的值时，如果存在不正确的值，更改程序的处理方法” 。

• 禁用新功能

  • 取消勾选 “禁用添加/编辑记录页面的数值字段中的更改：可使用带千位分隔符（逗号）的数字和全角数字”。

更改点

通过 kintone JavaScript API 可对数值字段进行获取或改写的值

• 数值

  • 可使用的符号有 “+” 或 “-” 。

  • 可使用小数点 “.”。

  • 可使用指数符号。指数符号中可以使用 “e” 或者 “E” 。

• 空字符

数字或者符号仅可使用半角。

另外，对数值字段的值进行改写的 API 或者事件可以使用以下值。

• undefined null
  指定这个值时，数值字段的值为空。

• #INVALID!
  指定这个值时，数值字段的值不可改写。

除了以上值，其他的一律认为是数值字段的不正确值。

获取数值字段中输入的不正确的值时

如果数值字段中输入了不正确的值，记录对象中其值置为 “#INVALID!”。

对象事件／API

• 记录添加页面显示后的事件
  app.record.create.show mobile.app.record.create.show

• 记录添加页面的字段值发生更改时的事件
  app.record.create.change.字段代码 mobile.app.record.create.change.字段代码

• 记录添加页面在执行保存之前的事件
  app.record.create.submit mobile.app.record.create.submit

• 记录编辑页面显示后的事件
  app.record.edit.show mobile.app.record.edit.show

• 在记录编辑页面更改字段值时的事件
  app.record.edit.change.字段代码 mobile.app.record.edit.change.字段代码

• 记录编辑页面在执行保存之前的事件
  app.record.edit.submit mobile.app.record.edit.submit

• 获取记录的值
  kintone.app.record.get() kintone.mobile.app.record.get()

备注

在判断是否是不正确值时，先进行以下处理。

• PC 页面：转化成半角字符、删除分隔符、删除前后空白

• 手机版页面：删除前后空白

在改写数值字段的值时如果输入了不正确的值

使用事件或 API 对数值字段的值进行改写时，如果输入了不正确的值，将报错。

对象事件／API

• 记录添加页面显示后的事件
  app.record.create.show mobile.app.record.create.show

• 记录添加页面的字段值发生更改时的事件
  app.record.create.change.字段代码 mobile.app.record.create.change.字段代码

• 记录添加页面在执行保存之前的事件
  app.record.create.submit mobile.app.record.create.submit

• 记录编辑页面显示后的事件
  app.record.edit.show mobile.app.record.edit.show

• 在记录编辑页面更改字段值时的事件
  app.record.edit.change.字段代码 mobile.app.record.edit.change.字段代码

• 记录编辑页面在执行保存之前的事件
  app.record.edit.submit mobile.app.record.edit.submit

• 记录列表页面的行内编辑字段值更改时的事件
  app.record.index.edit.change

• 设置记录的值
  kintone.app.record.set() kintone.mobile.app.record.set()

在更改数值字段的值时如果输入了 “#INVALID!”

使用事件或者 API 对数值字段进行改写时，如果输入了 “#INVALID!”，将不会重写值，保持原来的值不变。
数值以外的字段，指定 “#INVALID!” 值进行改写时，和以前一样可以正常重置。

对象事件／API

• 记录添加页面显示后的事件
  app.record.create.show mobile.app.record.create.show

• 记录添加页面的字段值发生更改时的事件
  app.record.create.change.字段代码 mobile.app.record.create.change.字段代码

• 记录编辑页面显示后的事件
  app.record.edit.show mobile.app.record.edit.show

• 在记录编辑页面更改字段值时的事件
  app.record.edit.change.字段代码 mobile.app.record.edit.change.字段代码

• 设置记录的值
  kintone.app.record.set() kintone.mobile.app.record.set()

手机版上值其前后空白的处理方法

手机版上，数值字段中输入的值如果前后含有空白，将获取去除空白后的值。
另外，去除空白之后，如果输入前后的值一样，则更改字段值时的事件不会触发。

对象事件／API

• 记录添加页面显示后的事件
  mobile.app.record.create.show

• 记录添加页面的字段值发生更改时的事件
  mobile.app.record.create.change.字段代码

• 记录添加页面在执行保存之前的事件
  mobile.app.record.create.submit

• 记录编辑页面显示后的事件
  mobile.app.record.edit.show

• 在记录编辑页面更改字段值时的事件
  mobile.app.record.edit.change.字段代码

• 记录编辑页面在执行保存之前的事件
   mobile.app.record.edit.submit

• 获取记录的值
  kintone.mobile.app.record.get()

• 设置记录的值
  kintone.mobile.app.record.set()

cybozu.cn 共通管理

本次无 API 相关的更新信息。
关于整个 cybozu.cn 的更新信息，请参考维护信息页面。
11月的定期维护将在稍后发布。