RecordActionTask.submit()

Note:

The content in this help topic pertains to SuiteScript 2.0.

Method Description

Submits a record action task script deployment for processing and returns its task ID.

The record action task is processed by a background process which executes the specified record action for each record ID provided in the parameters. The overall task status as well as individual action results can be queried using the task.checkStatus() method.

Returns

string

The task ID.

Supported Script Types

Server scripts

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

Governance

50 units

Module

N/task Module

Sibling Object Members

RecordActionTask Object Members

Since

2019.1

Errors

Error Code

Message

Thrown If

FAILED_TO_SUBMIT_JOB_REQUEST_1

Failed to submit job request: {reason}

The task cannot be submitted.

Syntax
Important:

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

          //Add additional code ...
var recordActionTask = task.create({
    taskType: task.TaskType.RECORD_ACTION
});
recordActionTask.recordType = 'timebill';
recordActionTask.action = 'approve';
recordActionTask.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"}]; 

var handle = recordActionTask.submit();
var res = task.checkStatus({taskId: handle}); // returns a RecordActionTaskStatus object 

log.debug('Initial status: ' + res.status);
}); ...
//Add additional code 

        

Related Topics

N/task Module
SuiteScript 2.x Modules
SuiteScript 2.x

General Notices