本次向大家介绍2019年12月8日定期维护时更新的kintone API信息。
另外，还将依次更改受API更新影响的API文档。

cybozu.cn共通

更改规格

• 在开启了SecureAccess的环境里，使用密码验证来执行REST API时，可以用与客户端证书绑定的用户以外的用户验证信息（Administrator等）来执行

  • 对象 API
    ○ kintone REST API
    ○ User API
    

  • 内容：
    设置了SecureAccess的环境里，登录用户在进行JavaScript自定义时如要执行 cybozu.cn提供的REST API，
    可用登录用户（和客户证书绑定的用户）以外的用户验证信息，通过密码验证来执行 API。
    在使用前，需要在“.cn共通管理”的“系统管理”下的“登录”设置页面里，勾选“即使通过密码验证的用户与客户证书关联的用户不同，也允许访问”。

kintone JavaScript API

更改规格

在lookup字段的设置页面里，“其他要复制的字段”中可以指定多选框字段和复选框字段。受此更改影响，API规格更改如下。

• 用对象API进行自动获取或清空处理时，“其他要复制的字段”中指定的多选框字段或复选框字段也可进行自动获取或清空。 

  • 对象 API
    ○ 可进行自动获取lookup的事件
    ○ 可进行清空lookup复制目标字段的值的事件
    ○ 给记录设置值 kintone.app.record.set()　kintone.mobile.app.record.set()

  • 内容：
    使用对象 API进行自动获取lookup或清空lookup复制目标字段的值的处理时，也可自动获取或清空“其他要复制的字段”中指定的多选框字段或复选框字段。

本次修复的缺陷

• 消除了以下现象：PC专用版里，在特定条件下促发值被更改的事件时，将在浏览器的开发者工具的console里报错，无法正常执行处理

  • 对象 API
    ○ 记录添加页面的字段值发生更改时的事件 app.record.create.change.<字段代码>
    ○ 在记录编辑页面更改字段值时的事件 app.record.edit.change.<字段代码>
    

  • 修改内容：
    PC专用版里，以下条件全部符合的应用里发生值被更改的事件时
    ○ 条件
           1. 对lookup的“其他要复制的字段”里指定的字段设置了值更改事件时
           2. 使用该事件进行删除表格行的处理时（包括清空）
    ○ 修改前：在浏览器的开发者工具的console里报错，值不会复制到放在“要删除行的表格”下面的“其他要复制的字段”里
    ○ 修改后：在浏览器的开发者工具的console里不报错，可正常处理。

• 消除了以下现象：智能手机版里，用应用的分享功能添加记录时，添加了记录的应用里无法执行“字段的显示/隐藏”API以及“组合字段的关闭”API
  

  • 对象 API
    ○ 记录添加页面的字段值发生更改时的事件 mobile.app.record.create.change.<字段代码>
    ○ 切换字段的显示/隐藏 kintone.mobile.app.record.setFieldShown()
    ○ 组合字段的开闭 kintone.mobile.app.record.setGroupFieldOpen()

  • 修改内容
    ○ 智能手机版里，用应用的分享功能添加记录时，添加了记录的应用里在记录添加页面的字段值发生更改时的事件发生时
    ○ 修改前：不可执行切换字段的显示/隐藏API和组合字段的开闭 API
    ○ 修改后：可执行切换字段的显示/隐藏API和组合字段的开闭 API

kintone REST API

更改规格

在lookup字段的设置页面里，“其他要复制的字段”中可以指定多选框字段和复选框字段。受此更改影响，API规格更改如下。

• 在给lookup字段添加或更新值时，“其他要复制的字段”中指定的多选框字段或复选框字段也可进行自动获取或清空
  

  • 对象 API
    ○ 添加记录 / 更新记录 /k/v1/record.json、/k/v1/records.json
    

  • 内容：
    使用对象 API 添加或更新lookup的值时，“其他要复制的字段”中指定的多选框字段或复选框字段也可进行自动获取或清空。

• 表单的设置 API里，lookup字段的属性中添加了“其他要复制的字段”中选择的多选框字段或复选框字段的设置。

  • 对象 API
    ○ 获取表单的设置 /k/v1/app/form/fields.json　/k/v1/preview/app/form/fields.json
    ○ 添加字段 / 更改字段的设置 /k/v1/preview/app/form/fields.json
    

  • 内容：
    ○ 使用获取表单的设置可从lookup的“其他要复制的字段”的数组※中获取多选框字段和复选框字段相关的设置。
    ○ 使用添加字段 / 更改字段的设置可指定lookup的“其他要复制的字段”数组内※的多选框字段和复选框字段相关的设置。
       ※ properties.<字段代码>.lookup.fieldMappings

• 在筛选设置里可使用in运算符（等同于“以下任意一个”）来指定“单行文本框”和“链接”

  • 对象 API
    ○ 创建游标 /k/v1/records/cursor.json
    ○ 更改记录的访问权限 /k/v1/record/acl.json　/k/v1/preview/record/acl.json
    ○ 添加字段 /k/v1/preview/app/form/fields.json
    ○ 更改字段的设置 /k/v1/preview/app/form/fields.json
    ○ 更改列表的设置 /k/v1/preview/app/views.json
    ○ 更改应用流程管理的设置 /k/v1/preview/app/status.json
    

  • 内容：
    在筛选设置里可使用in运算符（等同于“以下任意一个”）来指定“单行文本框”和“链接”。
    但是，不可用于表格或关联记录列表里的“单行文本框”和“链接”字段。

• 可使用多个API令牌来获取/添加/更新跨多个应用的记录

  • 对象 API
    ○ 获取记录 / 添加记录  / 更新记录 /k/v1/record.json /k/v1/records.json

  • 内容：
    使用多个API令牌可跨多个应用进行记录的获取 / 添加 / 更新。
    不如，可获取 / 添加 /更新lookup字段的值或获取关联记录列表的筛选结果。

本次修复的缺陷

• 修改的问题：在对包含了表格的记录进行更新时，即使未对表格的数据进行更新，更改的历史记录里包含了表格的内容

  • 对象 API
    ○ 更新记录 /k/v1/record.json、/k/v1/records.json
    

  • 修改内容：
    执行符合以下所有条件的处理时
    ○ 条件
       1. 更新含有表格的记录，但不更新表格内的字段的值
       2. 请求参数里，记录信息的对象中未指定表格的行id
    
    ○ 修改前：历史记录中包含了表格的内容（历史记录显示删除所有表格的行再添加行）
    ○ 修改后：历史记录中仅包含进行了更改的字段的内容

以下更新内容是在2019年12月17日进行系统维护时针对2019年12月定期维护后出现的缺陷所作的修改。

修复kintone REST API缺陷

• 修改的问题：使用API令牌从游标获取记录时，有时获取不到数据

  • 对象 API
    ○ 从游标获取记录 [GET] /k/v1/records/cursor.json
    

  • 修改内容
    ○ 条件
       1. 在获取记录的应用中，“Adiministrator”没有记录的查看权限
       2. 使用API令牌验证来执行从游标获取记录 API
    ○ 修改前：返回空数组，不能获取记录
    ○ 修改后：可以获取记录。