NetSuite Record Syntax for SuiteScript 2.x Operations

The following section explains the syntax for managing records within NetSuite using SuiteScript 2.x, emphasizing how to handle records effectively for various operations.

What is Record Syntax?

Record syntax in SuiteScript 2.x refers to the structured way of interacting with NetSuite records. This includes creating, copying, loading, and transforming records using object-oriented principles.

How Do Standard and Dynamic Modes Differ?

When working with records, SuiteScript 2.x offers two modes: standard mode and dynamic mode.

Standard Mode

• Description: In standard mode, a record's body fields and sublist line items are not sourced or validated until the record is saved using the Record.save(options) method. This means developers can set field values without concern for the order during script execution.
• Best Practice: Take advantage of the flexibility this mode provides, especially in scenarios where field ordering is complex or non-linear.

Dynamic Mode

• Description: In dynamic mode, field values are sourced and validated in real-time, mimicking the behavior of the record in the NetSuite user interface. Values must be set in a specific order to ensure the expected results.
• Best Practice: Always set field values in the same sequence as they appear in the UI to avoid inconsistencies.

Methods for Working with Records

The following methods can be utilized for record operations:

• Creating: Use record.create(options) to instantiate a new record.
• Copying: Use record.copy(options) to duplicate an existing record.
• Loading: Use record.load(options) to access a specific record by ID.
• Transforming: Use record.transform(options) to convert one record type into another.

Important Method Details

To activate dynamic mode for any of these methods, pass the argument isDynamic: true:

var objRecord = record.load({
    type: record.Type.SALES_ORDER, 
    id: '6',
    isDynamic: true
});

Related Resources

For further reference, visit:

• N/record Module
• SuiteScript 2.x Script Types
• SuiteScript 2.x Modules

Who This Affects

This information is particularly relevant for:

• Developers: Scripting record interactions effectively.
• Administrators: Understanding record management practices.

Key Takeaways

• Record syntax follows object-oriented principles in SuiteScript 2.x.
• Use standard mode for flexibility, dynamic mode for UI-like behavior.
• Always follow the correct order of setting values in dynamic mode.
• Familiarity with N/record module is essential for effective scripting.