record.create.promise(options)

Method Description

Creates a new record asynchronously.

Note:

The parameters and errors thrown for this method are the same as those for record.create(options). For more information about promises, see Promise Object.

Returns

Promise Object

Synchronous Version

record.create(options)

Supported Script Types

Client scripts

For more information, see SuiteScript 2.x Client Script Type.

Governance

Transaction records: 10 units

Custom records: 2 units

All other records: 5 units

Module

N/record Module

Since

2015.2

Parameters
Note:

The options parameter is a JavaScript object.

Parameter

Type

Required / Optional

Description

Since

options.type

string

required

The record type.

This value determines the Record.type property of the record that is created. This property is read-only on an existing record.

Use the following guidelines:

  • When creating an instance of a standard NetSuite record type, set this value by using the record.Type enum.

  • When creating an instance of a custom record type, set this value by using the custom record type’s string ID. For help finding this ID, see Custom Record.

2015.2

options.isDynamic

boolean

optional

Determines whether the new record is created in dynamic mode.

  • If set to true, the new record is created in dynamic mode.

  • If set to false, the new record is created in standard mode.

By default, this value is false.

Note:

For additional information about standard and dynamic mode, see record.Record and SuiteScript 2.x Standard and Dynamic Modes.

2015.2

options.defaultValues

Object

optional

Name-value pairs containing default values of fields in the new record.

By default, this value is null.

2015.2

Errors

Error Code

Thrown If

SSS_MISSING_REQD_ARGUMENT

A required argument is missing or undefined.

Syntax

Important:

The following code sample shows the syntax for this member. It is not a functional example. For a complete promise script example, see Promise Object.

          // Add additional code
...
function createRecord() {
// Create an instance of a standard record record type.
    var createRecordPromise = record.create.promise({
        type: record.Type.PHONE_CALL,
        isDynamic: true
    });

    // Note: To create an instance of a custom record type,
    // use the record type's string ID instead of the record
    // module's Type enum. For example:
    // type: 'customrecord_feature'  

    createRecordPromise.then(function(objRecord) {
        objRecord.setValue({
         fieldId: 'title',
         value: 'sprint planning'
     });      
        var recordId = objRecord.save();          
        log.debug({
            title: 'New record saved', 
            details: 'New record ID: ' + recordId
        });
                 
    }, function(e) {
        log.error({
            title: 'Unable to create record', 
            details: e.name
        });
    });
}
...
// Add additional code 

        

Related Topics

General Notices