Index

事件

• 记录编辑页面显示后的事件

• 在记录编辑页面更改字段值时的事件

• 记录编辑页面在执行保存之前的事件

• 记录编辑页面保存成功后的事件

可使用event对象执行的操作

• 重写字段的值

• 设置字段的可/不可编辑

• 在字段中报错

• 在记录中报错

• 自动获取Lookup

• 清空Lookup要复制的字段的值

• 获取发生了更改的字段及表格内的行对象

事件

记录编辑页面显示后的事件

记录编辑页面显示之后发生的事件。

• 可在PC专用版和移动端专用版中使用。

• 粘帖到空间中的应用不可使用。

• 如return了kintone.Promise，将等到异步处理结束后才开始之后的处理。
  

• 具有“关联记录列表”字段的应用中，事件在“关联记录列表”字段以外的字段显示后发生。
       ○ 此事件发生后，将按顺序显示“关联记录列表”字段。
  

事件

event对象的属性

PC专用版和移动端专用版的内容相同。

可使用event对象执行的操作

• 请参考重写字段的值 。

• 请参考设置字段是否可编辑。

• 请参考在字段中报错 。

• 请参考在记录中报错 。

• 请参考自动获取Lookup 。

• 请参考清空Lookup要复制的字段的值。

等到异步处理结束后才执行之后的处理

使用return kintone.Promise 对象的方法，可等待异步处理执行完后再执行可对event对象执行的操作。
同一个事件如果登记了多个事件句柄，将报错，并废弃Thenable对象，这种情况下，不会执行后续的事件句柄的处理。
关于写法请参考kintone的Promise的基本写法。

限制事项

在以下事件中无法获取附件字段的信息。

• mobile.app.record.edit.show
  ※app.record.edit.show中可以获取。

范例

记录编辑页面显示时弹出信息。

kintone.events.on('app.record.edit.show', function(event) {
    window.alert("已打开记录编辑页面");
    return event;
});

在记录编辑页面更改字段值时的事件

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

• 粘帖到空间中的应用不可使用。

事件

字段代码中可指定的字段

仅当<字段代码>存在字段代码、且指定了以下类型的字段时，才会执行句柄。不存在字段代码或指定了以下类型以外的字段时，什么也不会发生。

• 单选框

• 下拉菜单

• 复选框

• 多选

• 选择用户

• 选择组织

• 选择组
  

• 日期

• 时间

• 日期与时间

• 单行文本框*1

• 数值*2

• 表格*3

*1 在以下任一情况下，促发事件。

• 控件失去焦点时

• 通过Lookup复制值时

• 获得自动计算的结果时（仅限PC版）

*2 控件失去焦点时以及通过Lookup复制值时。

*3 表格字段的事件发生时机是点击表格的添加行、删除行的按钮时

event对象的属性

PC专用版和移动端专用版的内容相同

可使用event对象执行的操作

• 请参考重写字段的值 。

• 请参考设置字段是否可编辑。

• 请参考在字段中报错 。

• 请参考在记录中报错 。

• 请参考自动获取Lookup。

• 请参考清空Lookup要复制的字段的值。

• 请参考获取被更改的字段及表格内的行对象。

注意事项

请查看有关事件处理的一些注意事项。

限制事项

在以下事件中无法获取附件字段的信息。

• app.record.edit.change.<字段代码>

• mobile.app.record.edit.change.<字段代码>

记录编辑页面在执行保存之前的事件

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

• 粘帖到空间中的应用不可使用。

• 可通过return false来取消保存处理。

• 可像在字段中报错 及在记录中报错那样，在error属性中设置值，并return event对象来取消保存处理。

• 如return了kintone.Promise对象，将等待异步处理执行完后才开始之后的处理。

事件

event对象的属性

PC专用版和移动端专用版的内容相同。

可使用event对象执行的操作

• 请参考重写字段的值 。

• 请参考在字段中报错 。

• 请参考在记录中报错 。

等到异步处理执行完后再使用event对象执行相关操作

使用return kintone.Promise 对象的方法，可等待异步处理执行完后再执行可对event对象执行的操作。
同一个事件如果登记了多个事件句柄，将报错，并废弃Thenable对象，这种情况下，不会执行后续的事件句柄的处理。
关于写法请参考kintone的Promise的基本写法。

注意事项

请查看有关事件处理的一些注意事项。

限制事项

在以下事件中无法获取附件字段的信息。

• app.record.edit.submit

• mobile.app.record.edit.submit
  

记录编辑页面保存成功后的事件

• 可在PC专用版和移动端专用版中使用。

• 粘帖到空间中的应用不可使用。

• 如return了kintone.Promise对象，将等待异步处理执行完后才开始之后的处理。

• 保存失败时不执行事件。

事件

event对象的属性

指定url属性

给event对象指定url属性，并return event时，事件处理后页面将跳转至所指定的URL。

url属性未指定、或指定为null时，跟往常一样跳转到记录详情页面。

比如，像下面这样写的话，保存成功后将跳转至[https://www.cybozu.cn/] 。

// 保存成功后将跳转至[https://www.cybozu.cn/]
kintone.events.on('app.record.edit.submit.success', function(event) {
　　event.url = "http://www.cybozu.cn/";
    console.log("url: " + event.url);
    return event;
});

可使用event对象执行的操作

无。

范例

// 记录保存后显示更新时间    
kintone.events.on("app.record.edit.submit.success", function(ev) {    
    var record = ev.record;    
    alert("更新时间为" + record["更新时间"]["value"] + " 。");
    return event;
});

可使用event对象执行的操作

重写字段的值

在句柄中record 对象中的字段值重写后，return event 对象时，将使用此值更新字段的值。

• 可在PC专用版和移动端专用版中使用。

• 粘帖到空间中的应用不可使用。

• 即使设为不可编辑字段，也可重写值。

• 对无编辑权限的字符的值进行重写时，不会应用到表单中。

• 最后的句柄不return的情况，将不更新字段的值。

• 添加多个句柄时，将以最后的句柄return回来的值为标准进行更新。

范例

打开记录编辑页面时，给【文本框_0】字段、表格【Table】第一行的【文本框_1】字段设置初始值，并在表格的末尾添加行。
※如要添加表格的行，需要指定字段类型。可在PC专用版和移动端专用版上使用。

kintone.events.on('app.record.edit.show', function(event) {    
    var record = event.record;    
    record['文本框_0']['value'] = '用该字符串覆盖';    
    record['Table']['value'][0]['value']['文本框_1']['value'] = '覆盖表格的第一条记录';
    
    //在表格的末尾添加行    
    var newRow = {    
        value: {    
            文本框_1: {    
                ype: 'SINGLE_LINE_TEXT',    
                value: '添加到表格的行'    
            }    
        }    
    };    
    record['Table']['value'].push(newRow);  
      
    return event;    
});

不可重写的字段

以下字段即使在保存执行前事件的句柄中重写了字段的值并return，也不应用到表单中。

• 记录编号

• 创建人

• 创建时间

• 更新人

• 更新时间

• 状态

• 执行者

• 计算

• 设置为自动计算的单行文本框

• 附件

• Lookup

• 要通过Lookup复制的字段

设置字段的可/不可编辑

在句柄中对record对象的字段的disabled设置true/false，并return event 对象时，该字段将变成可编辑/不可编辑。

• 可在PC专用版和移动端专用版中使用。

• 粘帖到空间中的应用不可使用。

• 即使将无编辑权限的字段设为可编辑（disabled 设为 false），此设置也不会生效。

范例

【下拉菜单_0】字段的值发生更改时，将【文本框_0】字段设为不可编辑。

kintone.events.on('app.record.edit.change.下拉菜单_0', function(event) {    
    var record = event.record;    
    record['文本框_0']['disabled'] = true;    
    return event;    
});

无法设置可／不可编辑的字段

即使对以下字段的值设置是否可编辑，并return，设置也不应用到表单。

• 记录编号

• 创建人

• 创建时间

• 更新人

• 更新时间

• 状态

• 执行者

• 自动计算的单行文本框

• 计算

在字段中报错

在句柄中对record对象的字段的error设置了错误信息，并return event 对象时，将取消表单的值的重写和是否可编辑的设置，对字段显示错误信息。

• 可在PC专用版和移动端专用版中使用。

• 粘帖到空间中的应用不可使用。

• 字段的error 设为null，并 return event对象时，可解除该字段的错误。

范例

在【文本框_0】字段和表格【Table】第一行的【文本框_1】字段中显示错误。

kintone.events.on('app.record.edit.change.下拉菜单_0', function(event) {    
    var record = event.record;    
    record['文本框_0']['error'] = '显示此错误信息';    
    record['Table']['value'][0]['value']['文本框_1']['error'] = '表格第一条记录显示错误';    
    return event;    
});

以下字段即使设置了错误值，也不会显示错误。

• 记录编号

• 创建人

• 创建时间

• 更新人

• 更新时间

• 状态

• 执行者

• 计算
  

在记录中报错

在句柄中给event 对象的error定义错误信息后，return event对象时，将取消字段值的重写以及是否可编辑的设置，在页面顶部显示错误信息。

• 可在PC专用版和移动端专用版中使用。

• 粘帖到空间中的应用不可使用。

自动获取Lookup

Lookup字段的lookup属性设置为“UPDATE”或true时，自动执行获取Lookup。

• 只有当lookup的搜索结果仅有一条时才可自动获取。

• 可在PC专用版和移动端专用版中使用。

• 粘帖到空间中的应用不可使用。

范例

打开记录编辑页面时，在“Lookup”字段中输入值并获取数据。

kintone.events.on('app.record.edit.show', function(event) {    
    var record = event.record;    
    record['Lookup']['value'] = '0001'; // Lookup字段的值    
    record['Lookup']['lookup'] = true;  // 或 record['Lookup']['lookup'] = 'UPDATE';  
    return event;    
});

清空Lookup要复制的字段的值

Lookup字段的lookup属性设置为“CLEAR”时，清空要复制的字段的值。

• 可在PC专用版和移动端专用版中使用。

• 粘帖到空间中的应用不可使用。

范例

打开记录编辑页面时，清空“Lookup”字段的要复制的字段的值。

kintone.events.on('app.record.edit.show', function(event) {
    var record = event.record;
    record['Lookup']['lookup'] = 'CLEAR';
    return event;
});

获取发生了更改的字段及表格内的行对象

获取表格内有发生变更的行的对象、以及表格外有发生变更的字段。

• 可在PC专用版和移动端专用版中使用。

• 粘帖到空间中的应用不可使用。

• 仅可在表格内的事件发生时获取row对象。

• 删除表格内的行时，row对象为null 。

kintone.events.on('app.record.edit.change.下拉菜单_0', function(event) {    
    var row = event.changes.row;    
    var field = event.changes.field;
    return event;
});