1. SuiteCloud Platform
  2. SuiteScript
  3. SuiteScript 2.x API Reference
  4. SuiteScript 2.x Modules
  5. N/action Module
  6. action.Action
  7. Action.executeBulk(options)

Action.executeBulk(options)

Method Description

Executes an asynchronous bulk record action and returns its task ID for status queries with action.getBulkStatus(options).

Returns

string

Supported Script Types

Client and server scripts

For more information, see SuiteScript 2.x Script Types.

Governance

50 units

Module

N/action Module

Parent Object

action.Action

Sibling Object Members

Action Object Members

Since

2019.1

Parameters

Note:

The options.params array consists of parameter objects. The values that are required in each parameter object vary for action types. The only value that is always required is options.recordId, unless the action object is qualified. An action object is qualified if it is the result of an action.get() or action.find() call that provides the recordId.

Parameter

Type

Required / Optional

Description

options.params

array

required

The options.params parameter is mutually exclusive to options.condition and options.paramCallback.

An array of parameter objects. Each object corresponds to one record ID of the record for which the action is to be executed. The object has the following form:

                    {recordId: 1, someParam: 'example1', otherParam: 'example2'}

options.condition

string

optional

The condition used to select record IDs of records for which the action is to be executed. Only the action.ALL_QUALIFIED_INSTANCES constant is currently supported.

The action.ALL_QUALIFIED_INSTANCES condition only works correctly if the author of the record action has implemented the findInstances method of the RecordActionQualifier interface. An example of such action is approve on the timebill and timesheet records.

options.paramCallback

string

optional

the name of the function that takes a record ID and returns the parameter object for the specified record ID.

Errors

Error Code

Thrown If

SSS_INVALID_ACTION_ID

The specified action does not exist on the specified record type.

– or –

The action exists, but cannot be executed on the specified record instance.

SSS_INVALID_RECORD_TYPE

The specified record type is invalid.

SSS_MISSING_REQD_ARGUMENT

A required parameter is missing.

Syntax

Important:

The following code snippet shows the syntax for this member. It is not a functional example. For a complete script example, see N/action Module Script Samples.

          // Add additional code
...
var actionObj = action.get({
         recordType: 'timebill', 
         id: 'approve'
});

var handle = actionObj.executeBulk({
    params: [
        { 
            recordId: 1,
            note: 'this is a note for 1'
        },
        { 
            recordId: 5,
            note:  'this is a note for 5'
        },
        { 
            recordId: 23,
            note:  'this is a note for 23'
        }
    ]
});
...
// Add additional code

Related Topics

General Notices