Documentos de API

Guardar evento

Contenido

Guardar evento - app.record.create.submit

Un evento que se desencadena cuando se hace clic en el botón Guardar en la página de creación de registros.
Este evento no contiene el ID de registro en el objeto de evento: use la siguiente API en su lugar para obtener el ID de registro del registro creado:
Guardar evento de éxito

Función

Escritorio

app.record.create.submit

Móvil

mobile.app.record.create.submit

Propiedades del objeto Event

PROPIEDAD TIPO DESCRIPCIÓN
appId Número El identificador de la aplicación.
record Objeto Objeto de registro que contiene los datos introducidos por el usuario.
type Cuerda El tipo de evento.

Acciones de cancelación

Las acciones se pueden cancelar realizando una de las siguientes acciones:

Acciones de objeto de evento disponibles

Ejecución de acciones después de esperar a que finalicen las operaciones asincrónicas

Al devolver un archivo Promise , puede ejecutar acciones después de esperar a que finalicen las operaciones asincrónicas. Si se produce un error y el Thenable objeto, el evento será cancelado.

Solicitud de ejemplo usando el objeto Promise devuelto por el kintone.api()

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

kintone.events.on('app.record.create.submit', function(event) {
  var record = event.record;
  var companyName = record.company_name.value || '';
  var masterAppId = 21; // App ID of a different app
  var query = 'company_name="' + companyName + '"';
  var params = {app: masterAppId, query: query};

  return kintone.api('/k/v1/records', 'GET', params).then(function(resp) {
    // Check that the company name exists in the master app
    if (!resp.records.length) { // Set an error message on the field
      record.company_name.error = 'Company name does not exist.';
    } else { // The record will save when the alert window closes
      alert('Found company');
    }
    return event;
  }, function(resp) { // Dealing with errors received by the system
    var errmsg = 'There was an error when retrieving the data.';
    if (resp.message) {
      errmsg += '\n' + resp.message;
    }
    alert(errmsg);
  });
});

Solicitud de ejemplo usando el Constructor de Promesas

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

kintone.events.on('app.record.create.submit', function(event) {
  var record = event.record;
  var companyName = record.company_name.value;
  var masterAppId = 21; // App ID of a different app
  var query = 'company_name="' + companyName + '"';
  return new Promise(function(resolve, reject) {
    var params = {app: masterAppId, query: query};
    kintone.api('/k/v1/records', 'GET', params, function(resp) {
      resolve(resp);
    });
  }).then(function(resp) {
    if (!resp.records.length) {
      record.company_name.error = 'Company name does not exist.';
    }
    return event;
  });
});

Limitaciones

  • Los valores de la clase Archivo adjunto no se puede recuperar.
  • Consulte la sección Limitaciones del siguiente artículo para obtener más detalles:
    Control de eventos