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

kintone

在 2024 年 2 月版的 kintone 中，将重新定义用 kintone JavaScript API 对数值字段进行操作时可使用的值。
因此，对于无法使用的值，其处理将发生变化。

在 2023 年 11 月的定期维护之后，通过更新选项可试用以上更改。

关于更改背景，请参考以下文章。
2023/11 定期维护时的API更新信息

至 2024 年 5 月之前，您可以通过以下选项禁用此新功能。
切换新功能的启用/禁用

• 禁用“更改JavaScript API在获取或设置数值字段的值时对于无效值的处理方式”

kintone JavaScript API

规格变更

重新定义了使用 kintone JavaScript API 给数值字段设置或更新值时可使用的值。

用 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()

使用事件或者 API 对数值字段进行改写时，如果输入了 “#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()

备注

数值以外的字段，指定 “#INVALID!” 值进行改写时，和以前一样可以正常重置。

手机版上，数值字段中输入的值如果前后含有空白，将获取去除空白后的值

对象事件／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()

手机版中，如输入的值去除空白前后一样，则更改字段值时的事件不会触发

对象事件／API

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

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

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

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

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

产品的更新信息

API 以外的 kintone 的更新信息请参考 维护信息页面。
2 月的定期维护将在稍后发布。

cybozu.cn 共通管理

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