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.

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.

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
• Estado
• 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

Si el controlador de eventos ingresa true/false en el archivo disabled de un campo del objeto de registro y devuelve el objeto de evento, la edición de esos campos se habilitará/deshabilitará.
No pasará nada si esto se aplica a un campo en el que no tiene permisos de edición.

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
• Estado
• Cesionario
• Calculado
• Campos de texto con la opción "Calcular automáticamente"

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, el Sobrescribir valores de campo y el Activar/desactivar las ediciones de campo se cancelan.
Para eliminar los mensajes de error de los campos, introduzca null en el archivo error del campo y devuelve 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
• Estado
• Cesionario
• Calculado

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, el Sobrescribir valores de campo y el Activar/desactivar las ediciones de campo se cancelan.

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;
});

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;
});

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

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.

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
• Estado
• 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

Notas

• Si se especifica una cadena vacía para el campo del botón de opción, se introducirá el valor predeterminado del campo.
• Los valores de los campos se pueden sobrescribir, incluso si se ha desactivado la edición del campo.
• Si no tiene permiso para agregar valores a un campo en particular, el cambio de campo escrito en el script no surtirá efecto para ese campo.
• Si el controlador no devuelve el objeto de evento, los campos no se actualizarán.
• Si hay varios controladores, los valores devueltos del último controlador surtirán efecto.

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, el Sobrescritura de valores de campo se cancela.
Para quitar los mensajes de error de los campos, escriba null en el error del campo y devuelva el objeto de evento.

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.

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
• Estado
• 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

Notas

• Si se especifica una cadena vacía para el campo Botón de opción, se introducirá el valor predeterminado del campo.
• Los valores de los campos se pueden sobrescribir, incluso si se ha desactivado la edición del campo.
• Si no tiene permiso para agregar valores a un campo en particular, el cambio de campo escrito en el script no surtirá efecto para ese campo.
• Si el controlador no devuelve el objeto de evento, los campos no se actualizarán.
• Si hay varios controladores, los valores devueltos del último controlador surtirán efecto.

Si el controlador de eventos ingresa true/false en el archivo disabled de un campo del objeto de registro y devuelve el objeto de evento, la edición de esos campos se habilitará/deshabilitará.
No pasará nada si esto se aplica a un campo en el que no tiene permisos de edición.

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
• Estado
• Cesionario
• Calculado
• Campos de texto con la opción "Calcular automáticamente"

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, el Sobrescritura de valores de campo y el Habilitación/deshabilitación de ediciones de campo se cancelan.
Para eliminar los mensajes de error de los campos, introduzca null en el archivo 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.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
• Estado
• Cesionario
• Calculado

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, el Sobrescritura de valores de campo y el Habilitación/deshabilitación de ediciones de campo se cancelan.

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;
});

Si true se introduce en el archivo lookup , el campo Lookup se ejecuta cuando se devuelve el evento.

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;
});

Si CLARO 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;
});

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

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;
});

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;
});

• #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.

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.

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
• Estado
• 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

Notas

• Si se especifica una cadena vacía para el campo Botón de opción, se introducirá el valor predeterminado del campo.
• Los valores de los campos se pueden sobrescribir, incluso si se ha desactivado la edición del campo.
• Si no tiene permiso para agregar valores a un campo en particular, el cambio de campo escrito en el script no surtirá efecto para ese campo.
• Si el controlador no devuelve el objeto de evento, los campos no se actualizarán.
• Si hay varios controladores, los valores devueltos del último controlador surtirán efecto.

Si el controlador de eventos ingresa true/false en el archivo disabled de un campo del objeto de registro y devuelve el objeto de evento, la edición de esos campos se habilitará/deshabilitará.
No pasará nada si esto se aplica a un campo en el que no tiene permisos de edición.

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 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
• Estado
• Cesionario
• Calculado
• Campos de texto con la opción "Calcular automáticamente"

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, el Sobrescritura de valores de campo y el Habilitación/deshabilitación de ediciones de campo se cancelan.
Para quitar los mensajes de error de los campos, escriba null en el 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.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
• Estado
• Cesionario
• Calculado

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, el Sobrescritura de valores de campo y el Habilitación/deshabilitación de ediciones de campo se cancelan.

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;
});

Si ACTUALIZAR o true se introduce en la propiedad de búsqueda de la propiedad Lookup , el campo Búsqueda se ejecuta cuando se devuelve el evento.

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;
});

Si CLARO se introduce en la propiedad de búsqueda de la propiedad Lookup , los valores copiados de la aplicación de origen debido a la configuración del campo de 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;
});

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

Muestra

Recupere 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 modificada_0 campo, cuando el valor de dropdown_0 cambios durante la edición de 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;
});

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;
});

• #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.

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.

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.