CurrentRecord.getCurrentMatrixSublistValue(options)

Note:

The content in this help topic pertains to SuiteScript 2.0.

Method Description

Gets the value for the currently selected line in the matrix.

Gets a numeric value for rate and ratehighprecision fields.

Returns

number | Date | string | array | boolean

Supported Script Types

Client scripts

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

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 that contains the matrix.

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 the matrix field.

See How to Find a Field's Internal ID.

2016.2

options.column

number

required

The column number for the matrix field.

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

          //Add additional code 
...
var matrixValue = objRecord.getCurrentMatrixSublistValue({
    sublistId: 'item',
    fieldId: 'item',
    column: 12
});
...
//Add additional code 

        

Related Topics

currentRecord.CurrentRecord
N/currentRecord Module
SuiteScript 2.x Modules
SuiteScript 2.x

General Notices