Acciones de objetos de evento

Documentos de API

Acciones de objetos de evento

Contenido

Acciones de objetos de evento
Eventos de la lista de registros
Evento de detalles de registro
Registrar eventos de creación
Grabar eventos de edición
Notas
Usar promesas

Acciones de objetos de evento

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 campo	no	no	Sí	Sí	no	no
Activar/desactivar las ediciones de campo	no	Sí	Sí	no	no	no
Mostrar errores de campo	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í

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 siguientes se sobrescriben en el controlador y se devuelven, no surtirá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á.

Muestra

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

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 siguientes campos se devuelven con el atributo disabled como verdadero/falso, no surtirán efecto en el registro en sí.

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:

Sobrescribir valores de campo
Activar/desactivar las ediciones de campo

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 siguientes tienen mensajes de error introducidos por el controlador y se devuelve el objeto, no surtirá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:

Sobrescribir valores de campo
Activar/desactivar las ediciones de campo

Muestra

Muestra un mensaje de error para el registro al cambiar un campo desplegable durante una edición en línea de un registro.

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 campo	no	no	Sí
Mostrar errores de campo	no	Sí	Sí
Usar promesas	Sí	Sí	Sí

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 progresado, sobrescriba el campo text_0 con una cadena especificada, sobrescriba la primera línea de la tabla y agregue valores a text_in_table y number_in_table que están dentro de una tabla, 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;
});

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

Incluso si los campos siguientes se sobrescriben en el controlador y se devuelven, no surtirá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:

Sobrescribir valores de campo

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 campo	Sí	Sí	Sí	no
Activar/desactivar las ediciones de campo	Sí	Sí	no	no
Mostrar errores de campo	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í

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 agregar un nuevo registro, sobrescriba el campo text_0 con una cadena especificada, sobrescriba la primera línea de la tabla y agregue valores a text_in_table y number_in_table que están dentro de una tabla, 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

Incluso si los campos siguientes se sobrescriben en el controlador y se devuelven, no surtirá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á.

Muestra

Al agregar un nuevo registro, deshabilite la edición de la text_0 cuando se selecciona un valor en el campo 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 siguientes campos se devuelven con el atributo disabled como verdadero/falso, no surtirán efecto en el registro en sí.

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

Sobrescribir valores de campo
Activar/desactivar las ediciones de campo

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 siguientes tienen mensajes de error introducidos por el controlador y se devuelve el objeto, no surtirá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

Sobrescribir valores de campo
Activar/desactivar las ediciones de campo

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

Muestra

Mostrar un mensaje de error para el registro al cambiar un campo desplegable durante la creación de un nuevo registro.

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 agregar un nuevo registro, el valor de búsqueda se establece en el campo Búsqueda y se busca el valor. También se realizan las asignaciones de campos que se establecieron en la configuración de campos de búsqueda.

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 del campo Búsqueda, 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.

Muestra

Al editar un registro, se borran los valores copiados de la aplicación de origen debido a la configuración del campo de búsqueda.

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 del objeto de la fila de la tabla de la tabla 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 campo	Sí	Sí	Sí	no
Activar/desactivar las ediciones de campo	Sí	Sí	no	no
Mostrar errores de campo	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í

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

Después de abrir la página de edición de registros, sobrescriba el campo text_0 con una cadena especificada, sobrescriba la primera línea de la tabla y agregue valores a text_in_table y number_in_table que están dentro de una tabla, 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

Incluso si los campos siguientes se sobrescriben en el controlador y se devuelven, no surtirá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á.

Muestra

Al editar un registro, deshabilite la edición de la text_0 cuando se selecciona un valor en el campo 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 siguientes campos se devuelven con el disabled como true/false, no surtirá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

Sobrescribir valores de campo
Activar/desactivar las ediciones de campo

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 siguientes tienen mensajes de error introducidos por el controlador y se devuelve el objeto, no surtirá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

Sobrescribir valores de campo
Activar/desactivar las ediciones de campo

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

Muestra

Muestra un mensaje de error para el registro al cambiar un campo desplegable durante una 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 lookup de la propiedad 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 editar un registro, la búsqueda de un valor se establece en el campo Búsqueda y se busca el valor. También se realizan las asignaciones de campos que se establecieron en la configuración de campos de búsqueda.

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 lookup de la propiedad Lookup , 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, se borran los valores copiados de la aplicación de origen debido a la configuración del campo de búsqueda.

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 de objeto de la fila de la tabla de la dropdown_0 , cuando el valor de dropdown_0 Cambia 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.