Finding Subrecord Details in the Records Browser
As with records, you can find important information about subrecords in the SuiteScript Records Browser. The Records Browswer includes details about each subrecord type. It also includes information about record types that can be parents to subrecords. For more information, see the following sections:
Finding Details About Parent Record Types
Every subrecord instance must have a parent record. An instance of a subrecord exists only to provide information about an instance of a record.
The parent record includes a field that contains, or references, the subrecord. To create a subrecord instance on a record, you must reference this field. These fields are always identified in the Records Browser as fields of type summary. For example:
Summary fields can occur either on the body of the parent record or in a sublist. It is important to know where the field occurs, because it affects how you instantiate the subrecord. In the reference page for each record type in the Records Browser, the Fields table lists all of the record type’s body fields. The tables listed under the heading Sublists shows sublist fields. See also Body Field Subrecords and Sublist Subrecords.
In some cases, the values set for other fields on a record can affect the availability or behavior of the summary field. For example:
-
On an assembly build record, the availability of the inventorydetail summary field varies depending on the value of the record’s item field. The summary field is available only if the item field references a serialized or lot-numbered assembly item. For an example of working with this record-subrecord combination, see Creating an Inventory Detail Subrecord on a Body Field Example.
-
On a vendor bill record, the landedcost summary field is available only if the landedcostperline body field is set to true. For an example of working with this record-subrecord combination, see Creating a Landed Cost Sublist Subrecord Example.
-
On a sales transaction, the value of the shippingaddress summary field is affected by the shipaddresslist field. For general details about shipping and billing addresses, see Scripting Transaction Shipping and Billing Addresses. For a script example, see Using SuiteScript 2.x to Create a New Shipping Address Example.
Finding Details About Subrecord Types
As with record types, the Records Browser includes a reference page for each subrecord type. Subrecords are listed alphabetically with records.
Each subrecord is identified by a label displayed beneath the internal ID. For example:
As with record types, the reference page shows the subrecord’s scriptable fields and sublists.
Note that in the UI, the sublists of subrecords typically are not labeled. However, the Records Browser displays the name of each sublist.