Record.findSublistLineWithValue(options)

Method Description	Returns the line number for the first occurrence of a field value in a sublist. Note that line indexing begins at 0 with SuiteScript 2.0. (dynamic and standard mode — see SuiteScript 2.x Standard and Dynamic Modes)
Returns	A line number as a number, or -1 if not found.
Supported Script Types	Client and server scripts For more information, see SuiteScript 2.x Script Types.
Governance	None
Module	N/record Module
Sibling Object Members	Record Object Members
Since	2015.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.	2015.2
options.fieldId	string	required	The internal ID of a standard or custom sublist field. See, Finding Internal IDs of Record Fields.	2015.2
options.value	number | Date | string | array | boolean	optional	The value to search for.	2015.2

Errors

Error Code	Thrown If
SSS_MISSING_REQD_ARGUMENT	A required argument is missing or not defined.

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/record Module Script Samples.

          // Add additional code
...
var lineNumber = objRecord.findSublistLineWithValue({
    sublistId: 'item',
    fieldId: 'item',
    value: 233
});
...
// Add additional code 

        

Related Topics

• record.Record
• N/record Module
• SuiteScript 2.x Modules
• SuiteScript 2.x

General Notices