Bulk Request

The Bulk Request API allows multiple API requests to run on multiple kintone apps.
The below API can be used with the Bulk Request API:

  • Add Record
  • Add Records
  • Update Record
  • Update Records
  • Delete Records
  • Update Status
  • Update Statuses
  • Update Assignees

Constructor

Parameter

Name Type Required Description
params Object (optional) Constructor params.
params.connection Connection yes The connection module of this SDK.

Sample code

Init bulk request module

  const kintone = require('@kintone/kintone-wechat-miniprogram-sdk');
  let kintoneBulkRequest = new kintone.BulkRequest({connection});

Methods

All below methods (excluded execute() method) will add request to queue, you must execute the execute() function to get result of BulkRequest.

addRecord({app, record})

Parameter

See at Record - addRecord

Return

BulkRequest

addRecords({app, records})

Parameter

See at Record - addRecords

Return

BulkRequest

updateRecordByID({app, id, record, revision})

Parameter

See at Record - updateRecordByID

Return

BulkRequest

updateRecordByUpdateKey({app, updateKey, record, revision})

Parameter

See at Record - updateRecordByUpdateKey

Return

BulkRequest

updateRecords({app, records})

Parameter

See at Record - updateRecords

Return

BulkRequest

deleteRecords({app, ids})

Parameter

See at Record - deleteRecords

Return

BulkRequest

deleteRecordsWithRevision({app, idsWithRevision})

Parameter

See at Record - deleteRecordsWithRevision

Return

BulkRequest

updateRecordAssignees({app, id, assignees, revision})

Parameter

See at Record - updateRecordAssignees

Return

BulkRequest

updateRecordStatus({app, id, action, assignee, revision})

Parameter

See at Record - updateRecordStatus

Return

BulkRequest

updateRecordsStatus({app, records})

Parameter

See at Record - updateRecordsStatus

Return

BulkRequest

execute()

Execute the bulk request and get data response

Parameter

(none)

Return

[Promise]

Sample code

Execute bulk request

  const responseBulkRequest = kintoneBulkRequest
    .addRecord({/*[Args]*/})
    .addRecords({/*[Args]*/})
    .updateRecords({/*[Args]*/})
    .deleteRecords({/*[Args]*/})
    .execute();

  responseBulkRequest.then((resp) => {
    console.log(resp);
  }).catch((errors) => {
    // write error to console
    console.log(errors);
    errors.forEach((err) => {
      if (typeof err.get === 'function') {
        console.log(err.get());
      }
    });
  });

Reference