NetSuite Async Get List

NetSuite Async Get List

On this Page

Snap type:

Read

Description:

This Snap asynchronously fetches records from NetSuite. 
If the Get async results property is selected, the Snap submits a job, checks the job status and gets the results. If the Get async results property is deselected, the Snap submits a job and returns a job ID at the output view.

 

  • Expected upstream Snaps: Any Snap that provides a document output view, such as Mapper or Structure or a JSON Generator Snap. 

  • Expected downstream Snaps: [None] or any Snap that has a document input view, such as Filter or Mapper or JSON Formatter.

  • Expected input: This Snap provides schema on its input view for the selected object that can then be used in a Mapper Snap to map the required fields.

  • Expected output: This Snap provides the result of the operation for the given criteria on the output view. Errors can be routed to the error view if enabled or cause the Snap to fail during execution.

 

Empty number values should be given as 0.0, not as null.

Prerequisites:

Make sure the data to be added maps correctly to the fields where it is being directed and is of the correct data type.

Support and limitations:

Works in Ultra Tasks.

Known Issues:

This Snap currently does not support custom records.

Account: 

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See NetSuite Account for information on setting up this type of account.

Views:

Input

This Snap has exactly one document input view.

Output

This Snap has at most one document output view.

Error

This Snap has at most one document error view and produces zero or more documents in the view.

Settings

Label

 

Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Batch size

 

Required. The maximum number of input documents to batch in a single request. Set to 1 to make a separate request for each input document.  

Default value: 1000  

Get async results

 

Required. If selected, the Snap submits a job, checks the job status and gets the results when finished. If not selected, the Snap submits a job and produces a job ID information at the output view.

Default value: Selected  

Pass through

 

Required. If selected, the Snap passes the input document to the output view under the 'original' key.

Default value: Selected  

 

Request timeout

 

Required. Timeout for the web service call (in seconds). 0 indicates no timeout.
Default value: 0
 

Maximum request attempts

 

Required. The maximum number of requests to attempt in case of failure.

Default value: 3

 

Retry request interval

 

Required. Specifies the interval between two successive SOAP requests. A retry happens only when the previous attempt resulted in an exception.

Default value: 2

 

Snap execution

 

Default ValueExecute only
Example: Validate & Execute

Select one of the following three modes in which the Snap executes:

  • Validate & Execute: Performs limited execution of the Snap, and generates a data preview during pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.

  • Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.

  • Disabled: Disables the Snap and all Snaps that are downstream from it.

This Snap does not currently support custom records.

Troubleshooting

 

Example


This pipeline gets the records asynchronously from a NetSuite object, and routes the valid records to the output view and the invalid records to the error view.

The JSON Generator Snap passes the values to be retrieved from the NetSuite Object. In this example, we are passing a set of four values for the records to be retrieved.

 

The Mapper Snap maps the values to the records to be retrieved.

The NetSuite Async Snap gets the records from the Label object 'Purchase Order-NetSuite Async Getpertaining to the values passed and mapped via the upstream Snaps.

Successful execution of the pipeline gives the displayed output preview:

The invalid records are routed to the error view as displayed: