NetSuite Record Listener

You can use the NetSuite Record Listener activity to listen to the Create, Edit, Delete, Paybills, Approve, Cancel, Pack, and Ship user events triggered on a specified record and then publish an XML message encapsulating the data of the record on which the event was triggered.

This activity supports custom fields and custom records. It also supports publishing custom records if the custom records are associated with parent records that are using:

  • Entity records, such as Customer record, Contact record, and Vendor record.
  • Transaction records, such as Sales Order record and Purchase Order record.

This activity does not support publishing custom records if the custom records are associated with parent records that are using sublist.

For more information, see Customization.

Note: The NetSuite Record Listener activity supports the same list of trusted third-party certificate authorities (CAs) as Microsoft.

General

On the General tab, you can specify a NetSuite connection and record category. The General tab contains the following fields:

Field Module Property? Description
Name No (Required) Specify a name for the activity in the process definition.
NetSuite Connection Yes (Required) Select a shared connection resource.

Click the icon to select a space connection. If no matching NetSuite connections are found, click Create Shared Resource in the Select NetSuiteConnectionResource Resource Template dialog to create one. See Creating a NetSuite Connection Shared Resource for more details.

Record Category No (Required) Select the top-level category of the record type.
Record Subcategory No (Required) Select the subcategory of the record type.
Record No (Required) Select the record type.
Event No (Required) Select the user event triggered on the record that is listened to for data modification:

  • Create: Triggered only when the specified record is created.
  • Edit: Triggered only when the specified record is edited.
  • Delete: Triggered only when the specified record is deleted.
  • Approve: Triggered only for applicable record types when they are approved.
  • Cancel: Triggered only for applicable record types when they are canceled.
  • Pack: Triggered only for applicable record types when they are marked as packed.
  • Ship: Triggered only for applicable record types when they are marked as shipped.
  • PayBills: Triggered only for afterSubmit user events for Vendor Payments from the Pay Bill page.

Note: To successfully receive the messages triggered by user events in the NetSuite system, the record type specified in the Record field must be deployed with the identical event type specified in the Record field in the NetSuite system. See Running User Event Script in NetSuite for more information about running scripts.

HTTPConnection Yes (Required) Select an HTTP Connector shared resource.

Click the icon to select an HTTP connection.

Note: Do not set a custom value for host and port in the httpConnection shared resource. After the application is pushed to TIBCO Cloud™ Integration, an endpoint is created by TIBCO Cloud Integration.
Relative Path Yes (Required) Select a path relative to the current working directory.
Note: The value specified in this field must be appended to the value of the <httpPath> element in the RecordListenerHTTPConfig.xml file, which you upload to the NetSuite website.
Username Yes (Optional) Select the username that is used to pass the basic authentication of the runtime Record Listener activity.

Note:

  • When a user event is raised on a record in the NetSuite system, if the listener username and listener password specified in the configuration file, which is deployed on the record, are the same as the ones specified in this activity, this activity receives the messages triggered by the user event.
  • The value of the <listenerUsername> element in the RecordListenerHTTPConfig.xml file, which you uploaded to the NetSuite website, must be consistent with the value specified in this field.

Password Yes (Optional) Select the password that is used to pass the basic authentication of the runtime Record Listener activity.

Note: The value of the <listenerPassword> element in the RecordListenerHTTPConfig.xml file, which you uploaded to the NetSuite website, must be consistent with the value specified in this field.

Description

On the Description tab, you can enter a short description for the activity.

Advanced

On the Advanced tab, you can specify the following fields:

Field Module Property? Description
Sequence Key N/A This field can contain an XPath expression that specifies the processes that must run in a sequence. Process instances with sequence keys that evaluate to the same value are run sequentially in the order the process instances were created.
Custom Job Id N/A This field can contain an XPath expression that specifies a custom job ID for the process instance.

Conversations

You can initiate or join the conversation here.

Conversations receive messages after the creation of the process instance, which is initiated or joined by an activity. This activity can be used to initiate a conversation. Click the Add New Conversation icon to initiate multiple conversations. For more information about conversations, see TIBCO ActiveMatrix BusinessWorks™ Application Design.

Output

On the Output tab, you can check the response information. On the Output tab, you can find the following fields:

Output Item Data Type Description
eventType String The type of the event. Permissible values are: Create, Edit, Delete, PayBills, Approve, Cancel, Pack, and Ship.
recordName String The name of the record on which the event was raised.
recordInternalID String The internalId of the record on which the event was raised.
triggerDateTime DataTime The date and time when the event is triggered in the NetSuite system.
userName String The name of the user who triggered the event in the NetSuite system.
userRoleID String The role ID of the user who triggered the event in the NetSuite system.
userCompanyID String The company ID of the user who triggered the event in the NetSuite system.
userEmailAddress String The email address of the user who triggered the event in the NetSuite system.
userDepartmentID String The department ID of the user who triggered the event in the NetSuite system.
userLocationID String The location ID of the user who triggered the event in the NetSuite system.
timezone String The time zone where the user triggered the event in the NetSuite system.
recordData N/A The attributes and corresponding values of the record on which this event was raised. It varies in record type. For the meaning of each attribute, see NetSuite related documentation.

Note: In some cases, some of the field values that cannot be retrieved by the SuiteScript API are not included on the Output tab.

Note: All the fields in recordData that end with 'List' or 'Matrix' except 'customFieldList' are considered as sub-lists. All sub-lists of a record have an element named lineItemFieldsExtensionList that will contain line item fields of the sub-lists that are not part of metadata for that sub-list.

Fault

The Fault tab lists exceptions that might occur when you use this activity. For more detailed information, see Error Codes.

Error Schema Element Data Type Description
NetSuiteEventSourceException
msg String The error message if an error occurred when running the NetSuite Record Listener activity.
msgCode String The error code if an error occurred when running the NetSuite Record Listener activity.