Documentos de API

Acciones de objetos de evento

Contenido

Acciones de objetos de evento

Objeto de Evento es un objeto JavaScript que contiene datos y contexto sobre las interacciones del usuario dentro de una aplicación Kintone.
Es posible realizar acciones como deshabilitar un campo o mostrar un error en un campo cambiando las propiedades del objeto de evento y devolviéndolo. En esta sección se explican las acciones disponibles.

Eventos de la lista de registros

Evento Onload Evento de edición en línea Evento de cambio de campo Guardar evento Guardar evento de éxito Evento de eliminación
Sobrescribir valores de campos *1 no no Sí Sí no no
Activar/Desactivar las ediciones de campos *2 no Sí Sí no no no
Mostrar errores de campo *3 no no Sí Sí no no
Mostrar errores de registro no no Sí Sí no Sí
Establecer una URL de redireccionamiento no no no no Sí no
Usar promesas Sí Sí no Sí no Sí

*1 Algunos campos no pueden tener sus valores sobrescritos en los eventos de la Lista de Registros. Véase Campos que no pueden ser sobrescritos . ^

*2 Algunos campos no pueden estar habilitados o desactivados en eventos de la Lista de Registros. Véase Campos que no muestran mensajes de error . ^

*3 Algunos campos no pueden mostrar mensajes de error en los eventos de la Lista de Registros. Véase Campos que no muestran mensajes de error . ^

Sobrescribir valores de campo

Si el controlador de eventos sobrescribe los valores de los campos del objeto de registro y devuelve el objeto de evento, el registro se guarda con esos valores en el objeto.

  • Se requiere permiso de edición de registros para cambiar un valor.
  • Incluso cuando el campo está configurado para estar deshabilitado para la edición, el valor aún se puede sobrescribir:
    Activar/desactivar las ediciones de campo
  • Si se registran varios controladores del mismo tipo de evento, se usará el valor devuelto por el último controlador. Si el último controlador no devuelve un objeto de evento, el valor del campo no se cambiará.
Muestra

Al guardar una edición en línea de un registro, sobrescriba el campo text_0 y text_in_table_0 con una cadena especificada. text_in_table_0 es un campo que se encuentra dentro de una tabla con el código de campo de table_0.

1
2
3
4
5
6

kintone.events.on('app.record.index.edit.submit', function(event) {
  var record = event.record;
  record.text_0.value = 'Overwrite with this string';
  record.table_0.value[0].value.text_in_table_0.value = 'Overwrite first record in table';
  return event;
});
Campos que no se pueden sobrescribir

Incluso si los campos de abajo se sobrescriben en el manejador y se devuelven, no tendrán efecto en el propio registro

  • Número de registro
  • Creado por
  • Fecha y hora creada
  • Actualizado por
  • Fecha y hora actualizada
  • Status
  • Cesionario
  • Calculado
  • Campos de texto con la opción "Calcular automáticamente"
  • Archivo adjunto
  • Búsqueda
  • Los destinos de asignaciones de campos del campo Búsqueda

Activar/desactivar las ediciones de campo

Si el controlador de eventos ingresa true/false en el archivo true de un campo del objeto de registro y devuelve el objeto de evento, la edición de esos campos se habilitará/deshabilitará.
Aunque el disabled La propiedad de un campo sin permiso de edición se establece en false, el campo no se volverá editable.

Muestra

Desactiva la edición de la text_0 campo cuando se selecciona un valor en el desplegable dropdown_0, durante una edición en línea de un disco.

1
2
3
4
5

kintone.events.on('app.record.index.edit.change.dropdown_0', function(event) {
  var record = event.record;
  record.text_0.disabled = true;
  return event;
});
Campos en los que no se puede activar/desactivar la edición

Incluso si los campos de abajo se devuelven con disabled como true/false, no tendrán efecto en el propio registro.

  • Número de registro
  • Creado por
  • Fecha y hora creada
  • Actualizado por
  • Fecha y hora actualizada
  • Status
  • Cesionario
  • Calculado
  • Campos de texto con la opción "Calcular automáticamente"

Mostrar errores de campo

Si el controlador de eventos introduce un mensaje de error en el archivo error de un campo del objeto de registro y devuelve el objeto de evento, se muestra un mensaje de error para el campo correspondiente.
En este caso, se cancela lo siguiente:

Para eliminar los mensajes de error de los campos, introduzca null en error del campo y devuelva el objeto de evento.

Muestra

Mostrar un mensaje de error para los campos text_0 y dropdown_0 Al guardar una edición en línea para un registro.

1
2
3
4
5
6

kintone.events.on('app.record.index.edit.submit', function(event) {
  var record = event.record;
  record.text_0.error = 'This is an error message';
  record.dropdown_0.error = 'This is also an error';
  return event;
});
Campos que no muestran mensajes de error

Incluso si los campos de abajo tienen mensajes de error configurados por el manejador y el objeto se devuelve de vuelta, no tendrán efecto sobre el propio registro.

  • Número de registro
  • Creado por
  • Fecha y hora creada
  • Actualizado por
  • Fecha y hora actualizada
  • Status
  • Cesionario
  • Calculado

Mostrar errores de registro

Si el controlador de eventos introduce un mensaje de error en el archivo error del objeto de evento y devuelve el objeto de evento, se muestra un mensaje de error para el registro.
En este caso, se cancela lo siguiente:

Muestra

Mostrar un mensaje de error para el registro al cambiar un Desplegable durante una edición en línea de un disco.

1
2
3
4

kintone.events.on('app.record.index.edit.change.dropdown_0', function(event) {
  event.error = 'This is an Error Message!';
  return event;
});

Establecer una URL de redireccionamiento

Si se especifica una dirección URL de redireccionamiento, el controlador de eventos redirigirá la página a la dirección URL especificada después de devolver el objeto de evento.

Si null , la página no redirigirá.

Muestra

Redirija el navegador web del usuario a "https://kintone.dev" después de guardar el registro.

1
2
3
4

kintone.events.on('app.record.index.edit.submit.success', (event) => {
  event.url = 'https://kintone.dev';
  return event;
});

Limitaciones de acción

Estas acciones solo están disponibles en el escritorio y no en el móvil.

Evento de detalles de registro

Evento Onload Evento de eliminación Evento de estado de actualización
Sobrescribir valores de campos *4 no no Sí
Mostrar errores de campo no Sí Sí
Usar promesas Sí Sí Sí

*4 Algunos campos no pueden tener sus valores sobrescritos en eventos de Detalles de Registro. Véase Campos que no pueden ser sobrescritos . ^

Sobrescribir valores de campo

Si el controlador de eventos sobrescribe los valores de los campos del objeto de registro y devuelve el objeto de evento, los campos del registro se actualizan con esos valores en el objeto.

  • Se requiere permiso de edición de registros para cambiar un valor.
  • Si se especifica una cadena vacía para el Botón de radio el campo, se introducirá el valor predeterminado del campo.
  • Si se registran varios controladores del mismo tipo de evento, se usará el valor devuelto por el último controlador. Si el último controlador no devuelve un objeto de evento, el valor del campo no se cambiará.
Muestra

Cuando el proceso haya avanzado, sobrscribe el campo text_0 con una cadena especificada, sobrescribe la primera línea de la tabla y añade valores en text_in_table y number_in_table que están dentro de una mesa, como una nueva línea.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

kintone.events.on('app.record.detail.process.proceed', function(event) {
  var record = event.record;
  record.text_0.value = 'Overwrite with this value';
  record.Table.value[0].value.text_in_table.value = 'Overwrite first line of the table';

  // Add a row to the end of a Table field
  var newRow = {
    value: {
      text_in_table: {
        type: 'SINGLE_LINE_TEXT',
        value: 'New value for new row'
      },
      number_in_table: {
        type: 'NUMBER',
        value: '777'
      }
    }
  };
  record.Table.value.push(newRow);
  return event;
});

Ten en cuenta que al añadir una nueva fila a la tabla, deben especificarse todos los campos de la tabla y el tipo de cada uno.

Campos que no se pueden sobrescribir

Aunque los campos de abajo se sobrescriban en el manejador y se devuelvan, no tendrán efecto en el propio registro.

  • Número de registro
  • Creado por
  • Fecha y hora creada
  • Actualizado por
  • Fecha y hora actualizada
  • Status
  • Cesionario
  • Calculado
  • Campos de texto con la opción "Calcular automáticamente"
  • Archivo adjunto
  • Búsqueda
  • Los destinos de asignaciones de campos del campo Búsqueda

Mostrar errores de campo

Se muestra un mensaje de error de campo, si el controlador par ingresa un mensaje en el error de un campo en el objeto de registro y se devuelve el objeto. En este caso, se cancela lo siguiente:

Para eliminar mensajes de error de los campos, ingrese null en el error del campo y devuelve el objeto de evento.

Registrar eventos de creación

Evento Onload Evento de cambio de campo Guardar evento Guardar evento de éxito
Sobrescribir valores de campos *5 Sí *6 Sí Sí no
Activar/Desactivar las ediciones de campos *7 Sí Sí no no
Mostrar errores de campo *8 Sí Sí Sí no
Mostrar errores de registro Sí Sí Sí no
Ejecutar campos de búsqueda Sí Sí no no
Borrar los valores de campo de búsqueda copiados Sí Sí no no
Obtener el objeto del campo editado o de la fila de la tabla no Sí no no
Establecer una URL de redireccionamiento no no no Sí
Usar promesas Sí no Sí Sí

*5 Algunos campos no pueden tener sus valores sobrescritos en los eventos de Crear registros. Véase Campos que no pueden ser sobrescritos . ^

*6 En los valores de los campos de sobrescribir, tras mostrar la página de creación de registro, se pueden cambiar los valores del campo de búsqueda. ^

*7 Algunos campos no pueden activarse o desactivarse en los eventos de Crear registros. Véase Campos donde la edición no puede estar habilitada o deshabilitada . ^

*8 Algunos campos no pueden mostrar mensajes de error en los eventos de Crear registros. Véase Campos que no muestran mensajes de error . ^

Sobrescribir valores de campo

Si el controlador de eventos sobrescribe los valores de los campos del objeto de registro y devuelve el objeto de evento, los campos del registro se actualizan con esos valores en el objeto.

  • Se requiere permiso de edición de registros para cambiar un valor.
  • Incluso cuando el campo está configurado para estar deshabilitado para la edición, el valor aún se puede sobrescribir:
    Activar/desactivar las ediciones de campo
  • Si se registran varios controladores del mismo tipo de evento, se usará el valor devuelto por el último controlador. Si el último controlador no devuelve un objeto de evento, el valor del campo no se cambiará.
  • Si se especifica una cadena vacía para el Botón de radio el campo, se introducirá el valor predeterminado del campo.
Muestra

Al añadir un nuevo registro, sobrescribe el campo text_0 con una cadena especificada, sobrescribe la primera línea de la tabla y añade valores en text_in_table y number_in_table que están dentro de una mesa, como una nueva línea.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

kintone.events.on('app.record.create.show', function(event) {
  var record = event.record;
  record.text_0.value = 'Overwrite with this value';
  record.Table.value[0].value.text_in_table.value = 'Overwrite first line of the table';

  // Add a row to the end of a sub-table
  var newRow = {
    value: {
      text_in_table: {
        type: 'SINGLE_LINE_TEXT',
        value: 'New value for new row'
      },
      number_in_table: {
        type: 'NUMBER',
        value: '777'
      }
    }
  };
  record.Table.value.push(newRow);
  return event;
});

Tenga en cuenta que al agregar una nueva fila a la tabla, se deben especificar todos los campos de la tabla y el type de cada campo.

Campos que no se pueden sobrescribir

Aunque los campos de abajo se sobrescriban en el manejador y se devuelvan, no tendrán efecto en el propio registro.

  • Número de registro
  • Creado por
  • Fecha y hora creada
  • Actualizado por
  • Fecha y hora actualizada
  • Status
  • Cesionario
  • Calculado
  • Campos de texto con la opción "Calcular automáticamente"
  • Archivo adjunto
  • Búsqueda
  • Los destinos de asignaciones de campos del campo Búsqueda

Activar/desactivar las ediciones de campo

Si el controlador de eventos ingresa true/false en el archivo true de un campo del objeto de registro y devuelve el objeto de evento, la edición de esos campos se habilitará/deshabilitará.
Aunque el disabled La propiedad de un campo sin permiso de edición se establece en false, el campo no se volverá editable.

Muestra

Al añadir un nuevo registro, desactiva la edición de la text_0 campo cuando se selecciona un valor en el desplegable dropdown_0.

1
2
3
4
5

kintone.events.on('app.record.create.change.dropdown_0', function(event) {
  var record = event.record;
  record.text_0.disabled = true;
  return event;
});

Campos en los que no se puede activar/desactivar la edición

Incluso si los campos de abajo se devuelven con el disabled como true/false, no tendrán efecto en el propio registro.

  • Número de registro
  • Creado por
  • Fecha y hora creada
  • Actualizado por
  • Fecha y hora actualizada
  • Status
  • Cesionario
  • Calculado
  • Campos de texto con la opción "Calcular automáticamente"

Mostrar errores de campo

Si el controlador de eventos introduce un mensaje de error en el archivo error de un campo del objeto de registro y devuelve el objeto de evento, se muestra un mensaje de error para el campo correspondiente.
En este caso, se cancela lo siguiente:

Para eliminar los mensajes de error de los campos, introduzca null en error del campo y devuelva el objeto de evento.

Muestra

Mostrar un mensaje de error para los campos text_0 y dropdown_0 al cambiar el valor de un campo desplegable.

1
2
3
4
5
6

kintone.events.on('app.record.create.change.dropdown_0', function(event) {
  var record = event.record;
  record.text_0.error = 'This is an error';
  record.Table.value[0].value.text_in_table.error = 'This is another error';
  return event;
});

Campos que no muestran mensajes de error

Incluso si los campos de abajo tienen mensajes de error configurados por el manejador y el objeto se devuelve, no tendrán efecto en el propio registro.

  • Número de registro
  • Creado por
  • Fecha y hora creada
  • Actualizado por
  • Fecha y hora actualizada
  • Status
  • Cesionario
  • Calculado

Mostrar errores de registro

Si el controlador de eventos introduce un mensaje de error en el archivo error del objeto de evento y devuelve el objeto de evento, se muestra un mensaje de error para el registro.
En este caso, se cancela lo siguiente:

Está disponible tanto para escritorio como para dispositivos móviles.

Muestra

Mostrar un mensaje de error para el registro al cambiar un Desplegable durante la creación de un nuevo récord.

1
2
3
4

kintone.events.on('app.record.create.change.dropdown_0', function(event) {
  event.error = 'Your error message here!';
  return event;
});

Ejecutar campos de búsqueda

Si UPDATE o true se introduce en el lookup , el campo Búsqueda se ejecuta cuando se devuelve el evento.

  • El Búsqueda solo se puede ejecutar si solo hay un resultado de búsqueda.
  • Está disponible tanto para escritorio como para dispositivos móviles.
Muestra

Al añadir un nuevo registro, el valor de consulta se establece en el Consulta y se busca el valor. Cualquier mapeo de campos que se haya establecido en el Consulta También se realizan ajustes de campo.

1
2
3
4
5
6

kintone.events.on('app.record.create.show', function(event) {
  var record = event.record;
  record.lookup_0.value = '0001'; // The Lookup field value
  record.lookup_0.lookup = true;
  return event;
});

Borrar los valores de campo de búsqueda copiados

Si CLEAR se introduce en el lookup Propiedad de la Consulta campo, los valores copiados de la aplicación de origen debido a que Consulta La configuración de campos se borra cuando se devuelve el evento.

Muestra

Al editar un registro, los valores copiados de la aplicación de origen se deben a la Consulta La configuración de campos está borrada.

1
2
3
4
5

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

Obtener el objeto del campo editado o de la fila de la tabla

Se recupera un objeto que contiene datos de un campo editado y una fila de tabla editada.

  • El row solo se puede recuperar cuando se produce un evento dentro de la tabla.
  • Cuando se elimina una fila de la tabla, el row propiedad se convierte en null.
Muestra

Recuperar los datos del objeto del campo dropdown_0 que existe dentro de una tabla, y los datos objeto de la fila de la tabla de los cambiados dropdown_0 campo, cuando el valor de dropdown_0 Cambios al crear un nuevo registro.

1
2
3
4

kintone.events.on('app.record.create.change.dropdown_0', function(event) {
  var row = event.changes.row;
  var field = event.changes.field;
});

Establecer una URL de redireccionamiento

Si se especifica una dirección URL de redireccionamiento, el controlador de eventos redirigirá la página a la dirección URL especificada después de devolver el objeto de evento.

Si null , la página no redirigirá.

Muestra

Redirija el navegador web del usuario a "https://kintone.dev" después de guardar el registro.

1
2
3
4

kintone.events.on('app.record.create.submit.success', (event) => {
  event.url = 'https://kintone.dev';
  return event;
});

Notas sobre valores no numéricos en el campo Número

  • #INVALID se devolverá en los objetos de evento si se establecen valores no numéricos en Número Campos
  • Si se establece el valor con un valor no válido mediante objetos de evento o la API de JavaScript, se producirá un error.
  • Si el valor se establece en #INVALID!, el valor no cambiará.
  • En la vista móvil, si se introducen espacios en blanco antes o después de un valor, se limpiarán.
  • Cuando se sanear los espacios en blanco, siempre que el valor final no cambie, no se activarán eventos.

Grabar eventos de edición

Evento Onload Evento de cambio de campo Guardar evento Guardar evento de éxito
Sobrescribir valores de campos *9 Sí *10 Sí Sí no
Activar/Desactivar las ediciones de campos *11 Sí Sí no no
Mostrar errores de campo *12 Sí Sí Sí no
Mostrar errores de registro Sí Sí Sí no
Ejecutar campos de búsqueda Sí Sí no no
Borrar los valores de campo de búsqueda copiados Sí Sí no no
Obtener el objeto del campo editado o de la fila de la tabla no Sí no no
Establecer una URL de redireccionamiento no no no Sí
Usar promesas Sí no Sí Sí

*9 Algunos campos no pueden tener sus valores sobrescritos en los eventos de Edición de Registros. Véase Campos que no pueden ser sobrescritos . ^

*10 En los valores del campo de sobreescritura tras mostrar la página de edición del registro, se pueden cambiar los valores del campo de búsqueda. ^

*11 Algunos campos no pueden activarse o desactivarse en los eventos de Edición de Registros. Véase Campos donde la edición no puede estar habilitada o deshabilitada . ^

*12 Algunos campos no pueden mostrar mensajes de error en los eventos de Edición de Registros. Véase Campos que no muestran mensajes de error . ^

Sobrescribir valores de campo

Si el controlador de eventos sobrescribe los valores de los campos del objeto de registro y devuelve el objeto de evento, los campos del registro se actualizan con esos valores en el objeto.

  • Se requiere permiso de edición de registros para cambiar un valor.
  • Incluso cuando el campo está configurado para estar deshabilitado para la edición, el valor aún se puede sobrescribir:
    Activar/desactivar las ediciones de campo
  • Si se registran varios controladores del mismo tipo de evento, se usará el valor devuelto por el último controlador. Si el último controlador no devuelve un objeto de evento, el valor del campo no se cambiará.
  • Si se especifica una cadena vacía para el Botón de radio el campo, se introducirá el valor predeterminado del campo.
Muestra

Tras abrir la página de edición de registros, sobrescribe el campo text_0 con una cadena especificada, sobrescribe la primera línea de la tabla y añade valores en text_in_table y number_in_table que están dentro de una mesa, como una nueva línea.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

kintone.events.on('app.record.edit.show', function(event) {
  var record = event.record;
  record.text_0.value = 'Overwrite with this value';
  record.Table.value[0].value.text_in_table.value = 'Overwrite first line of the table';

  // Add a row to the end of a subtable
  var newRow = {
    value: {
      text_in_table: {
        type: 'SINGLE_LINE_TEXT',
        value: 'New value for new row'
      },
      number_in_table: {
        type: 'NUMBER',
        value: '777'
      }
    }
  };
  record.Table.value.push(newRow);
  return event;
});

Tenga en cuenta que al agregar una nueva fila a la tabla, se deben especificar todos los campos de la tabla y el type de cada campo.
Además, si la primera línea de la tabla no existe cuando comienza a editar, el código no podrá encontrar la primera línea y detendrá el script.

Campos que no se pueden sobrescribir

Aunque los campos de abajo se sobrescriban en el manejador y se devuelvan, no tendrán efecto en el propio registro.

  • Número de registro
  • Creado por
  • Fecha y hora creada
  • Actualizado por
  • Fecha y hora actualizada
  • Status
  • Cesionario
  • Calculado
  • Campos de texto con la opción "Calcular automáticamente"
  • Archivo adjunto
  • Búsqueda
  • Los destinos de asignaciones de campos del campo Búsqueda

Activar/desactivar las ediciones de campo

Si el controlador de eventos ingresa true/false en el archivo true de un campo del objeto de registro y devuelve el objeto de evento, la edición de esos campos se habilitará/deshabilitará.
Aunque el disabled La propiedad de un campo sin permiso de edición se establece en false, el campo no se volverá editable.

Muestra

Al editar un registro, desactiva la edición de la text_0 campo cuando se selecciona un valor en el desplegable dropdown_0.

1
2
3
4
5
6
7

(function() {
  kintone.events.on('app.record.edit.change.dropdown_0', function(event) {
    var record = event.record;
    record.text_0.disabled = true;
    return event;
  });
})();

Campos en los que no se puede activar/desactivar la edición

Incluso si los campos de abajo se devuelven con el disabled como true/false, no tendrán efecto en el propio registro.

  • Número de registro
  • Creado por
  • Fecha y hora creada
  • Actualizado por
  • Fecha y hora actualizada
  • Status
  • Cesionario
  • Calculado
  • Campos de texto con la opción "Calcular automáticamente"

Mostrar errores de campo

Si el controlador de eventos introduce un mensaje de error en el archivo error de un campo del objeto de registro y devuelve el objeto de evento, se muestra un mensaje de error para el campo correspondiente.
En este caso, se cancela lo siguiente:

Para eliminar mensajes de error de los campos, ingrese null en el error del campo y devuelve el objeto de evento.

Muestra

Mostrar un mensaje de error para los campos text_0 y dropdown_0 al cambiar el valor de un campo desplegable.

1
2
3
4
5
6

kintone.events.on('app.record.edit.change.dropdown_0', function(event) {
  var record = event.record;
  record.text_0.error = 'This is an error';
  record.Table.value[0].value.text_in_table.error = 'This is another error';
  return event;
});

Campos que no muestran mensajes de error

Incluso si los campos de abajo tienen mensajes de error configurados por el manejador y el objeto se devuelve de vuelta, no tendrán efecto sobre el propio registro.

  • Número de registro
  • Creado por
  • Fecha y hora creada
  • Actualizado por
  • Fecha y hora actualizada
  • Status
  • Cesionario
  • Calculado

Mostrar errores de registro

Si el controlador de eventos introduce un mensaje de error en el archivo error del objeto de evento y devuelve el objeto de evento, se muestra un mensaje de error para el registro.
En este caso, se cancela lo siguiente:

Está disponible tanto para escritorio como para dispositivos móviles.

Muestra

Mostrar un mensaje de error para el registro al cambiar un Desplegable durante la edición de un registro.

1
2
3
4

kintone.events.on('app.record.edit.change.dropdown_0', function(event) {
  event.error = 'Your have selected the wrong option!';
  return event;
});

Ejecutar campos de búsqueda

Si UPDATE o true se introduce en la propiedad de consulta de la Consulta campo, el campo de Búsqueda se ejecuta cuando se devuelve el evento.

  • El Búsqueda solo se puede ejecutar si solo hay un resultado de búsqueda.
  • Está disponible tanto para escritorio como para dispositivos móviles.
Muestra

Al editar un registro, la búsqueda de un valor se establece en el Consulta y se busca el valor. Cualquier mapeo de campos que se haya establecido en el Consulta También se realizan ajustes de campo.

1
2
3
4
5
6

kintone.events.on('app.record.edit.show', function(event) {
  var record = event.record;
  record.lookup_0.value = '0015'; // The Lookup field value
  record.lookup_0.lookup = true; // or record.'lookup_0'.'lookup' = 'UPDATE';
  return event;
});

Borrar los valores de campo de búsqueda copiados

Si CLEAR se introduce en la propiedad de consulta de la Consulta los valores copiados de la aplicación de origen debido a la configuración del campo Búsqueda se borran cuando se devuelve el evento.

  • Está disponible tanto para escritorio como para dispositivos móviles.
Muestra

Al editar un registro, los valores copiados de la aplicación de origen se deben a la Consulta La configuración de campos está borrada.

1
2
3
4
5

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

Obtener el objeto del campo editado o de la fila de la tabla

Se recupera un objeto que contiene datos de un campo editado y una fila de tabla editada.

  • El row solo se puede recuperar cuando se produce un evento dentro de la tabla.
  • Cuando se elimina una fila de la tabla, el row propiedad se convierte en null.
Muestra

Recuperar los datos del objeto del campo dropdown_0 que existe dentro de una tabla, y los datos objeto de la fila de la tabla de los cambiados dropdown_0 campo, cuando el valor de dropdown_0 cambios al editar un registro.

1
2
3
4

kintone.events.on('app.record.edit.change.dropdown_0', function(event) {
  var row = event.changes.row;
  var field = event.changes.field;
});

Establecer una URL de redireccionamiento

Si se especifica una dirección URL de redireccionamiento, el controlador de eventos redirigirá la página a la dirección URL especificada después de devolver el objeto de evento.

Si null , la página no redirigirá.

Muestra

Redirija el navegador web del usuario a "https://kintone.dev" después de guardar el registro.

1
2
3
4

kintone.events.on('app.record.edit.submit.success', (event) => {
  event.url = 'https://kintone.dev';
  return event;
});

Notas sobre valores no numéricos en el campo Número

  • #INVALID se devolverá en los objetos de evento si se establecen valores no numéricos en Número Campos
  • Si se establece el valor con valores no válidos mediante objetos de evento o la API de JavaScript, se producirán errores.
  • Si el valor se establece en #INVALID!, el valor no cambiará.
  • En la vista móvil, si se introducen espacios en blanco antes o después de un valor, se limpiarán.
  • Cuando se sanear los espacios en blanco, siempre que el valor final no cambie, no se activarán eventos.

Notas

Campos numéricos

Los siguientes valores no numéricos se pueden utilizar al actualizar el valor en el archivo Número Campos:

  • undefined, null: El valor de la variable Número se vaciará.
  • #INVALID!: El valor de la variable Número no se cambiará.

Otros valores no numéricos se tratan como valores no válidos en el Número campo.

Usar promesas

Al regresar al navegador web Promise, las siguientes operaciones se pueden procesar después de esperar procesos asíncronos. Cuando se registran varios controladores de eventos para el mismo evento Kintone, si se produce un error y el Thenable objeto, se cancelarán los controladores de eventos posteriores.