1. SuiteCloud Platform
  2. SuiteScript
  3. SuiteScript 2.x API Reference
  4. SuiteScript 2.x Modules
  5. N/currentRecord Module
  6. currentRecord.CurrentRecord
  7. CurrentRecord.setCurrentSublistValue(options)

CurrentRecord.setCurrentSublistValue(options)

Method Description

Sets the value for the field in the currently selected line.

Important:

When you edit a sublist line with SuiteScript, it triggers an internal validation of the sublist line. If the line validation fails, the script also fails. For example, if your script edits a closed catch up period, the validation fails and prevents SuiteScript from editing the closed catch up period.

Sets a numeric value for rate and ratehighprecision fields.

Returns

currentRecord.CurrentRecord

Supported Script Types

Client scripts

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

Governance

None

Module

N/currentRecord Module

Since

2016.2
Parameters
Note:

The options parameter is a JavaScript object.

Parameter

Type

Required / Optional

Description

Since

options.sublistId

string

required

The internal ID of the sublist.

This value is displayed in the Records Browser. For more information, see Working with the SuiteScript Records Browser.

2016.2

options.fieldId

string

required

The internal ID of a standard or custom sublist field.

See Finding Internal IDs of Record Fields.

2016.2

options.value

number | Date | string | array | boolean

required

The value to set the field to.

The value type must correspond to the field type being set. For example:

  • Text, Radio and Select fields accept string values.

  • Checkbox fields accept boolean values.

  • Date and DateTime fields accept Date values.

  • Integer, Float, Currency and Percent fields accept number values.

2016.2

options.ignoreFieldChange

boolean

optional

If set to true, the field change and the secondary event is ignored.

By default, this value is false.

2016.2

options.forceSyncSourcing

boolean

optional

Indicates whether to perform field sourcing synchronously.

This parameter can be used to alleviate a timing situation that may occur in some browsers when fields are sourced. For some browsers, some APIs are triggered without waiting for the field sourcing to complete which could cause incorrect results.

If set to true, sources dependent field information for empty fields synchronously.

Defaults to false – dependent field values are not sourced synchronously.

See Perform Field Sourcing Synchronously.

2019.1
Errors

Error Code

Thrown If

A_SCRIPT_IS_ATTEMPTING_TO_EDIT_THE_1_SUBLIST_THIS_SUBLIST_IS_CURRENTLY_IN_READONLY_MODE_AND_CANNOT_BE_EDITED_CALL_YOUR_NETSUITE_ADMINISTRATOR_TO_DISABLE_THIS_SCRIPT_IF_YOU_NEED_TO_SUBMIT_THIS_RECORD

A user tries to edit a read-only sublist field.

INVALID_FLD_VALUE

The options.value type does not match the field type.

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 script example, see N/currentRecord Module Script Samples.

          //Add additional code 
...
objRecord.setCurrentSublistValue({
    sublistId: 'item',
    fieldId: 'item',
    value: true,
    ignoreFieldChange: true,
    forceSyncSourcing: true
});
... 
//Add additional code

Related Topics

General Notices