# tNetSuiteInput (v2019)

Invokes the NetSuite SOAP service and retrieves data according to the conditions you specify.

This component is not shipped with your Talend Studio by default. You need to install it using the Feature Manager. For more information, see [Installing features using the Feature Manager](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/install-features-to-talend-studio).

## tNetSuiteInput Standard properties (v2019)

These properties are used to configure tNetsuiteInput running in the Standard Job framework.

The Standard tNetsuiteInput component belongs to the Business and the Cloud families.

The component in this framework is available in all Talend products.

Information noteNote: This component is incorporated into the tNetSuiteInput component if you have installed the 8.0.1-R2023-02 Talend Studio Monthly update or a later one delivered by Talend. To access this component in this case, select NetSuite Deprecated from the Version drop-down list in the Basic settings view of the tNetSuiteInput component and click Apply. For more information, check with your administrator.

## Basic settings

| Properties | Description |
| --- | --- |
| Version | Select the NetSuite component you want to use from the drop-down list:<br>NetSuite Deprecated for the NetSuite version 2019 component<br>and Netsuite SOAP for the NetSuite version 2019/2021/2025<br>component.<br><br>Click the Apply button to validate your<br>selection.<br><br>Information noteNote: The Version drop-down list and the<br>Apply button are available only when you have installed<br>the 8.0.1-R2023-02 Talend Studio<br>monthly update or a later one delivered by Talend. For more information, check with your administrator. |
| Connection Component | Select a tNetsuiteConnection component to reuse its connection details to set up the connection to the NetSuite server.<br><br>With a tNetsuiteConnection selected, the settings related to connection setup will not be displayed. |
| Endpoint | Enter the WebService URL required to connect to the NetSuite server. |
| API version | Select the version of the NetSuite API you are connecting to. |
| E-mail and Password | Enter your user credentials to access the NetSuite SOAP service.<br><br>To enter the password, click the [...] button<br>next to the password field, enter the password in double quotes in the pop-up dialog box,<br>and click OK to save the settings. |
| Role | Enter your NetSuite role ID. |
| Account | Enter your NetSuite web services account number (also called account ID). |
| Application ID | Enter the NetSuite application ID generated for your account.<br><br>An application ID is required starting from NetSuite version 2015 and above. You can find your application ID or create a new one on NetSuite's Manage Integration page. |
| Record type | Click the [...] button next to the field to open a dialog box, and then select a record type you want to retrieve or select the Use custom object check box and specify a custom record type in the Object Name field. |
| Schema and Edit schema | <ul> <li> <p>A schema is a row description. It defines the number of fields            (columns) to be processed and passed on to the next component. When you create a Spark            Job, avoid the reserved word <kbd>line</kbd> when naming the            fields.</p> </li> <li> <p> <span>Built-In</span>: You create and store the schema locally for this component                only.</p> </li> <li> <p> <span>Repository</span>: You have already created the schema and stored it in the                Repository. You can reuse it in various projects and Job designs.</p> </li> <li> <p>Click <span>Edit        schema</span> to make changes to the schema. If the current schema is of the <span>Repository</span> type, three options are available:</p> <ul> <li> <p> <span>View schema</span>: choose this                option to view the schema only.</p> </li> <li> <p> <span>Change to built-in property</span>:                choose this option to change the schema to <span>Built-in</span> for local changes.</p> </li> <li> <p> <span>Update repository connection</span>:                choose this option to change the schema stored in the repository and decide whether                to propagate the changes to all the Jobs upon completion.</p> <p>If you just want to                propagate the changes to the current Job, you can select <span>No</span> upon completion and choose this schema metadata                again in the <span>Repository Content</span>                window.</p> </li> </ul> <div><span>Information note</span><span>Warning:</span> <p>The schema of this component is dynamically filled with columns								corresponding to the NetSuite service fields, which vary depending								on the <span>Record Type</span> selected.								You can delete columns that are not relevant to your operation, but								do not rename any schema columns or this may cause execution								errors.</p> </div> </li> </ul> |
| Search conditions | Define search conditions to match fields for data<br>retrieval. Click the [+] button<br>to add as many rows as you need, each row for a condition, and define<br>each of your conditions:<br><br><ul> <li> <p> <span>Field</span>: select a field to									search based on the condition.</p> </li> <li> <p> <span>Operator</span>: select an									operator for the field search condition.</p> </li> <li> <p> <span>Value</span>: enter the value									for the field search condition.</p> </li> <li> <p> <span>Value 2</span>: enter the second									value for the field search condition, if relevant depending on									the operator you select.</p> </li> </ul> |

## Advanced settings

| Properties | Description |
| --- | --- |
| Body fields only | Select this check box to retrieve only body fields; clear this check box to retrieve body fields and sublist values.<br><br>See [bodyFieldsOnly](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_4170181850.html) for related information.<br><br>Information noteNote:<br><br><ul> <li>Be sure to clear this check box if you also want to retrieve sublist values                        in addition to values in the body fields.</li> <li>Selecting this check box improves the performance significantly.</li> </ul> |
| Enable customizations | Select this check box to instruct the component to retrieve customizations - custom record types and custom fields. With this option enabled, custom record types will be retrieved and can be selected in the Record Type dialog box, and custom fields will be retrieved and included into the schema.<br><br>This option is enabled by default. You can disable it if you don't need custom record types or custom fields.<br><br>Information noteNote: Transactional custom body fields for these transactions are not supported: *Assembly Unbuild*, *Bin Putaway Worksheet*, *Bin Transfer*, *Paycheck*, and *Work Order*. |
| tStatCatcher Statistics | Select this checkbox to gather the Job processing metadata at the Job level<br>as well as at each component level. |

## Global Variables

| Variables | Description |
| --- | --- |
| Global Variables | NB\_LINE:<br>the number of rows processed. This is an After variable and it returns an integer.<br><br><br>ERROR\_MESSAGE: the error message generated by the<br>component when an error occurs. This is an After variable and it returns a string. This<br>variable functions only if the Die on error checkbox is<br>cleared, if the component has this checkbox.<br><br>A Flow variable functions during the execution of a component<br>while an After variable functions after the execution of the component.<br><br>To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from<br>it.<br><br>For more information about variables, see [Using contexts and variables](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/contexts-and-variables). |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component is usually used as a start component in a<br>Talend<br>flow and it requires an output component. |
| Limitation | The NetSuite components do not support the Microservice and OSGI build types<br>yet. |

**Related concepts**

* [Handling data with NetSuite](https://help.qlik.com/talend/en-US/components/8.0/netsuite/tnetsuiteinput-tnetsuiteoutput-tmap-tlogrow-handling-data-with-netsuite-standard-component-this)
* [Removing a record using NetSuite V2019/2021/2025 components](https://help.qlik.com/talend/en-US/components/8.0/netsuite/removing-record-using-netsuitev2019-components-overview)
* [Adding a record using NetSuite V2019/2021/2025 components](https://help.qlik.com/talend/en-US/components/8.0/netsuite/adding-record-using-netsuitev2019-components-overview)