Custom List

A custom list is a list of values that you can use in custom fields on your forms and records. Custom lists enable you to set up predefined choices for your employees and customers to select when entering transactions and records.

For more information about working with this record in the UI, see Custom Lists.

The custom list record is defined in the setupCustom (customization) XSD.

Supported Operations

The following operations can be used with custom list.

Note:

You can also use the asynchronous equivalents of SOAP web services list operations. For information about asynchronous operations, see SOAP Web Services Asynchronous Operations. For more information about request processing, see Synchronous Versus Asynchronous Request Processing.

Field Definitions

The SOAP Schema Browser includes definitions for all body fields, sublist fields, search filters, and search joins available to this record. For details, see the SOAP Schema Browser’s custom list reference page.

Note:

For information about using the SOAP Schema Browser, see SOAP Schema Browser.

Usage Notes

The following Java sample shows how to create a custom list with three values using SOAP web services.

                CustomListCustomValue Beginner = new CustomListCustomValue();
      Beginner.setValue("Beginner");
      CustomListCustomValue Intermediate = new CustomListCustomValue();
      Intermediate.setValue("Intermediate");
      CustomListCustomValue Advanced = new CustomListCustomValue();
      Advanced.setValue("Advanced");
      
      
      CustomListCustomValueList customValueList = new CustomListCustomValueList();
      customValueList.setCustomValue(new CustomListCustomValue[]{Beginner, Intermediate, Advanced});
      
      CustomList customList = new CustomList();
      customList.setName("IT Proficiency Levels");
      customList.setDescription("List of IT proficiency levels");
      customList.setCustomValueList(customValueList);
      
      c.addRecord(customList);

The following SOAP sample shows how to set a value from a custom list onto a record (in this case a Contact record) using SOAP web services.

          <soapenv:Body> <platformMsgs:add xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:s0="urn:relationships_2017_1.lists.webservices.netsuite.com" xmlns:platformMsgs="urn:messages_2017_1.platform.webservices.netsuite.com" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com"> <platformMsgs:record xsi:type="s0:Contact"> <s0:entityId>Clint Eastwood</s0:entityId> <s0:customFieldList> <platformCore:customField xsi:type="platformCore:SelectCustomFieldRef" scriptId="custentity6"> <platformCore:value typeId="7" internalId="2" /> </platformCore:customField> </s0:customFieldList> </platformMsgs:record> </platformMsgs:add> </soapenv:Body>

Where:

scriptId="custentity6" is the name of the custom list as it appears on the Contact record.
typeId="7" is the custom list internal id (Customization > Lists, Records, & Fields > Lists - Internal ID)
internalId="2" is the internal id of the second item on the custom list (Customization > Lists, Records, & Fields > Lists > List - ID)

Also note that when working with custom lists in SOAP web services, you can update specific values in a custom list using valueId as the key field for the CustomListCustomValue sublist and setting replaceAll flag to FALSE.

Supported Operations

Field Definitions

Usage Notes

Related Topics