获取记录详细信息

aki发表于:2016年09月16日 16:54:43更新于:2019年08月01日 16:00:53

Index

获取记录ID

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

  • PC端和智能手机端都可以使用。

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

函数

环境函数
PC端kintone.app.record.getId()
智能手机端kintone.mobile.app.record.getId()

参数

返回值

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

范例

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

可使用的页面 (PC)

  • 记录详情

  • 记录编辑

  • 记录打印

可使用的页面(智能手机)

  • 记录详情

  • 记录编辑

获取记录的值

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

  • PC端和智能手机端都可以使用。但是需要注意的是,可使用的函数不一样。

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

函数

环境函数
PC端kintone.app.record.get()
智能手机端kintone.mobile.app.record.get()

参数

返回值

  • 返回表示记录数据的对象或者 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)。

  • 如果改变了DOM内部构造,在kintone版本升级后,有可能无法正常运行

函数

kintone.app.record.getFieldElement(fieldCode)

参数

参数名称要指定的值必须
说明
fieldCode字符串
必须
指定获取的字段的字段代码。

返回值

  • 字段元素或者 null

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

范例

kintone.app.record.getFieldElement(fieldCode);

无法取得字段

  • 指定以下字段的时候,或者指定没有查看权限的字段的时候,返回 null。

    • 状态

    • 执行者

    • 表格里包含的字段

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

可使用的页面

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

  • 记录打印

设置记录的值

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

  • 可以执行以下处理。

    • 重写字段的值

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

    • 指定字段错误信息

    • 自动获取Lookup的值

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

  • PC端和智能手机端都可以使用。需要注意的是,可使用的函数是不同的。

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

函数

环境函数
PC端kintone.app.record.set(record)
智能手机端kintone.mobile.app.record.set(record)

参数

参数名称要指定的值必须
说明
recordJSON必须
通过用JSON指定设置的记录数据。
※格式和kintone.app.record.get()的返回值一样。

返回值

无。

范例

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端使用。

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

  • 因为元素的外观有时会受到kintone的CSS的影响,所以不能保证外观不会发生改变。

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

00157e4ef74e85180f4df267436b5b3

函数

kintone.app.record.getHeaderMenuSpaceElement()

参数

返回值

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

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

范例

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

可使用的页面

  • 记录详情

  • 记录添加

  • 记录编辑

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

获取空白栏的元素

  • PC端和智能手机端都可以使用。

00157e4f04c8cd31ae33cc5ed09be42

函数

环境函数
PC端kintone.app.record.getSpaceElement(id)
智能手机端kintone.mobile.app.record.getSpaceElement(id)

参数

参数名称要指定的值必须
说明
id字符串
必须
空白栏的元素ID

返回值

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

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

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

范例

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

可使用的页面(PC)

  • 记录详情

  • 记录添加

  • 记录编辑

  • 记录打印 

可使用的页面(智能手机)

  • 记录详情

  • 记录添加

  • 记录编辑

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

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

  • PC端和智能手机端都可以使用。

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

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

函数

环境函数
PC端kintone.app.getRelatedRecordsTargetAppId(fieldCode)
智能手机端kintone.mobile.app.getRelatedRecordsTargetAppId(fieldCode)

参数

参数名称要指定的值必须
说明
fieldCode字符串
必须
指定关联记录列表字段的字段代码。

返回值

  • 返回应用 ID或者 null。

  • 以下的情况返回 null。

    • 指定字段不存在

    • 指定字段没有查看权限

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

范例

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

可使用的画面 (PC)

  • 记录列表

  • 记录添加

  • 记录编辑

  • 记录详情

  • 记录打印

  • 图表

  • 导入文件

  • 导出文件

  • 各个插件的设置页面

可使用的页面(智能手机)

  • 记录列表

  • 记录添加

  • 记录编辑

  • 记录详情

  • 图表

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

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

  • PC端和智能手机端都可以使用。

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

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

函数

环境函数
PC端kintone.app.getLookupTargetAppId(fieldCode)
智能手机端kintone.mobile.app.getLookupTargetAppId(fieldCode)

参数

参数名称要指定的值必须说明
fieldCode字符串必须指定Lookup字段的字段代码。

返回值

  • 返回应用 ID或者 null。

  • 以下的情况返回 null。

    • 指定字段不存在

    • 指定字段没有查看权限

    • 指定字段不是Loopup字段

范例

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

可使用的画面 (PC)

  • 记录列表

  • 记录添加

  • 记录编辑

  • 记录详情

  • 记录打印

  • 图表

  • 导入文件

  • 导出文件

  • 各个插件的设置页面

可使用的页面(智能手机)

  • 记录列表

  • 记录添加

  • 记录编辑

  • 记录详情

  • 图表

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

  • 只可在智能手机端使用。

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

00157e4f1d6cc1d29a82ec14e1b764d

函数

kintone.mobile.app.getHeaderSpaceElement()

参数

返回值

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

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

范例

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

可使用的画面

  • 记录列表

  • 记录详情

  • 记录添加

  • 记录编辑


回复(2)

  • 充满愤怒的人生你快乐吗

    kintone.app.record.getFieldElement(fieldCode)获取字段元素的这个方法,在记录编辑页面并不能使用,获取到的是null,请问还有其他方法吗?

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

  • betsy_yan

    非常好

注意:贴代码时请注意格式并使用"代码语言",与本文无关的问题请至“讨论社区”提问。
您需要登录后才可以回复