Index

• 获取记录ID

• 获取记录的值

• 获取字段元素

• 设置记录的值

• 获取菜单上侧的空白部分的元素

• 获取空白栏的元素

• 获取关联记录列表的参照对象的应用ID

• 获取Lookup字段的参照对象的应用ID

• 获得Header下侧的空白部分的元素

获取记录ID

获取现在打开着的记录的ID。

• PC端和移动端都可以使用。

• 贴在空间里的应用无法使用。

函数

参数

无

返回值

• 返回数字或者 null。 如果是不可使用的页面，则返回 null。

范例

var recordId = kintone.app.record.getId();
console.log(recordId);

可使用的页面 （PC）

• 记录详情

• 记录编辑

• 记录打印

可使用的页面（移动端）

• 记录详情

• 记录编辑

获取记录的值

用JSON格式获取现在打开着的记录数据。

• PC端和移动端都可以使用。但是需要注意的是，可使用的函数不一样。

• 贴在空间里的应用无法使用。

函数

参数

无

返回值

• 返回表示记录数据的对象或者 null。 如果是不可使用的页面，返回 null。

• 记录添加或编辑页面上，返回编辑中的记录数据。

• 记录添加或编辑页面上，附件信息一般为空数组。

范例

var record = kintone.app.record.get();
console.log(record);

// 取得值的例子
// {
//     "record": {
//         "updated_time": {
//             "type": "UPDATED_TIME",
//             "value": "2011-09-14T06:31:00Z"
//         },
//         "creator": {
//             "type": "CREATOR",
//             "value": {
//                 "code": "Administrator",
//                 "name": "Administrator"
//             }
//         },
//         "radiobutton_0": {
//             "type": "RADIO_BUTTON",
//             "value": "January"
//         },
//         "attached_file": {
//             "type": "FILE",
//             "value": []
//         },
//         "created_time": {
//             "type": "CREATED_TIME",
//             "value": "2011-09-14T06:31:00Z"
//         },
//         "record_id": {
//             "type": "RECORD_NUMBER",
//             "value": "1"
//         },
//         "updater": {
//             "type": "MODIFIER",
//             "value": {
//                 "code": "Administrator",
//                 "name": "Administrator"
//             }
//         },
//         "checkbox": {
//             "type": "CHECK_BOX",
//             "value": [
//                 "Sunday",
//                 "Monday"
//             ]
//         }
//     }
// }

可使用的页面（PC）

• 记录详情

• 记录添加

• 记录编辑

• 记录打印

可使用的页面（移动端）

• 记录详情

• 记录添加

• 记录编辑

注意事項

• 在kintone.events.on 的事件句柄里无法执行 kintone.app.record.get() 和 kintone.mobile.app.record.get() 。 在上述的事件句柄里获取记录数据时请使用参数的event对象，记录数据的更新请使用event对象的return。

获取字段元素

指定字段代码，获取记录对应的字段元素。

• 可在PC端和移动端上使用。

• 贴在空间里的应用无法使用。

• 可通过更改DOM的style属性，来改变字体颜色或则背景色。

• 如果改变了DOM内部构造，可能会导致标准功能无法正常运行，或在kintone版本升级后无法正常运行。

函数

参数

返回值

• 字段元素或者 null

• 如果是不可使用的页面，则返回 null。

范例

kintone.app.record.getFieldElement(fieldCode);

无法获取的字段（PC）

指定以下字段时，或指定没有查看权限的字段时，返回 null。

• 状态

• 执行者

• 表格里包含的字段

• 关联记录列表里包含的字段

无法获取的字段（移动端）

指定以下字段时，或指定没有查看权限的字段时，返回 null。

• 状态

• 执行者

• 表格和表格里包含的字段

• 关联记录列表和关联记录列表里包含的字段

• 组
  

可使用的页面

• 记录详情
  ※包含应用的试用环境里的页面，和空间内的应用页面。
  ※不包含记录的编辑页面，或者通知的详情页面。

• 记录打印
  

设置记录的值

设置现在打开着的记录值。

• 可以执行以下处理。
  

  • 重写字段的值

  • 字段编辑的启用/禁用设置

  • 指定字段错误信息

  • 自动获取Lookup的值

  • 清空Lookup复制目标字段的值

• PC端和移动端都可以使用。需要注意的是，可使用的函数是不同的。

• 贴在空间里的应用无法使用。

函数

参数

返回值

无。

范例

var record = kintone.app.record.get();    
// 重写字段的值  
record['record']['字段代码']['value'] = '重写字符串';    
// 字段编辑的启用/禁用设置
record['record']['字段代码']['disabled'] = true;    
// 指定字段错误信息    
record['record']['字段代码']['error'] = '错误';    
// 自动获取Lookup的值   
record['record']['字段代码']['value'] = '42'; // Lookup字段的值   
record['record']['字段代码']['lookup'] = true;    
kintone.app.record.set(record);

不可更改值的字段

无法更改以下字段的值。

• 附件

可使用的页面（PC）

• 记录添加

• 记录编辑

可使用的页面（移动端）

• 记录添加

• 记录编辑

注意事项

• 在kintone.events.on 的事件句柄里无法执行 kintone.app.record.set() 和 kintone.mobile.app.record.set()。在上述的事件句柄里获取记录数据时请使用参数的event对象，记录数据的更新请使用event对象的return。

获取菜单上侧的空白部分的元素

• 只可在PC端使用。

• 贴在空间里的应用无法使用。

• 在使用该API获取的元素内新添加的元素，可能会受kintone 的 CSS影响。
  因此，kintone升级后，所添加的元素可能在显示效果上会发生变化。

• 在记录添加・编辑页面之类场景的时候，TYPE属性是"submit"的INPUT元素，在空元素里添加的BUTTON元素，点击时kintone本身可能会发生无法预计的动作，所以不推荐使用这些元素。

函数

kintone.app.record.getHeaderMenuSpaceElement()

参数

无

返回值

• 返回菜单（在详情页面上菜单是编辑/重复利用/删除等，在添加或编辑页面是保存/取消等）上侧的空白部分的元素。

• 如是不可使用的页面，则返回 null。

范例

var el = kintone.app.record.getHeaderMenuSpaceElement();

可使用的页面

• 记录详情

• 记录添加

• 记录编辑

　　※在记录打印页面上不可使用。

获取空白栏的元素

• PC端和移动端都可以使用。

函数

参数

返回值

• 返回指定元素ID的空白栏的元素。

• 当指定元素ID的空白栏不存在时，返回 null。

• 如是不可使用页面的话，就返回 null。

范例

var el = kintone.app.record.getSpaceElement('space1');

可使用的页面（PC）

• 记录详情

• 记录添加

• 记录编辑

• 记录打印 

可使用的页面（移动端）

• 记录详情

• 记录添加

• 记录编辑
  

获取关联记录列表的参照对象的应用ID

指定关联列表的字段代码，取得参照对象的应用ID。

• PC端和移动端都可以使用。

• 贴在空间里的应用无法使用。

• 如果对指定字段有访问权限的话，那么即便没有对象应用的查看权限，也可以取得应用ID。

函数

参数

返回值

• 返回应用 ID或者 null。

• 以下的情况返回 null。

  • 指定字段不存在

  • 指定字段没有查看权限

  • 指定字段不是关连记录列表字段

范例

// 获取关联记录列表的参照对象应用ID
var related = kintone.app.getRelatedRecordsTargetAppId('reference');

可使用的画面 （PC）

• 记录列表

• 记录添加

• 记录编辑

• 记录详情

• 记录打印

• 图表

• 导入文件

• 导出文件

• 各个插件的设置页面

可使用的页面（移动端）

• 记录列表

• 记录添加

• 记录编辑

• 记录详情

• 图表
  

获取Lookup字段的参照对象的应用ID

指定Lookup字段的字段代码，取得参照对象的应用ID。

• PC端和移动端都可以使用。

• 贴在空间里的应用无法使用。

• 如果对指定字段有访问权限的话，那么即便没有对象应用的查看权限，也可以获取应用ID。

函数

参数

返回值

• 返回应用 ID或者 null。

• 以下的情况返回 null。

  • 指定字段不存在

  • 指定字段没有查看权限

  • 指定字段不是Loopup字段

范例

// 取得Lookup字段的参照对象应用ID
var related = kintone.app.getLookupTargetAppId('reference');

可使用的画面 （PC）

• 记录列表

• 记录添加

• 记录编辑

• 记录详情

• 记录打印

• 图表

• 导入文件

• 导出文件

• 各个插件的设置页面

可使用的页面（移动端）

• 记录列表

• 记录添加

• 记录编辑

• 记录详情

• 图表

获得Header下侧的空白部分的元素

• 只可在移动端使用。

• 贴在空间里的应用无法使用。

函数

kintone.mobile.app.getHeaderSpaceElement()

参数

无

返回值

• 返回Header和内容间的空白部分的元素。

• 如是不可使用的页面，则返回 null。

范例

var el = kintone.mobile.app.getHeaderSpaceElement();

可使用的画面

• 记录列表

• 记录详情

• 记录添加

• 记录编辑