tNetsuiteOutput Standard properties

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.

To enter the password, click the [...] button next to the password field, and then in the pop-up dialog box enter the password between double quotes 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).

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

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 line when naming the fields.

Built-In: You create and store the schema locally for this component only.

Repository: You have already created the schema and stored it in the Repository. You can reuse it in various projects and Job designs.

When the schema to be reused has default values that are integers or functions, ensure that these default values are not enclosed within quotation marks. If they are, you must remove the quotation marks manually.

For more information, see the related description of retrieving table schemas in Talend Studio User Guide.

Click Edit schema to make changes to the schema. If the current schema is of the Repository type, three options are available:

• View schema: choose this option to view the schema only.

• Change to built-in property: choose this option to change the schema to Built-in for local changes.

• Update repository connection: choose this option to change the schema stored in the repository and decide whether to propagate the changes to all the Jobs upon completion. If you just want to propagate the changes to the current Job, you can select No upon completion and choose this schema metadata again in the Repository Content window.

Click Sync columns to retrieve the schema from the previous component connected in the Job.

Action

Select an action to perform from the list.

• Add: Adds a new record to your data. If a duplicate is found and the Die on error check box is selected, the Job stops; if the Die on error check box is cleared, the duplicate is ignored and the Job continues.

• Update: Makes changes to an existing record.

  If the record corresponding to the specified Internal ID does not exist, and the Die on error check box is selected, the Job stops.

  To use this option, the InternalId column must exist in the schema and set as Key.

• Upsert: Updates the record corresponding to the specified ID, or inserts a new record if it does not exist.

  To use this option, a column for record ID must exist in the schema and set as Key.

• Delete: Removes an existing record.

  If the record corresponding to the specified Internal ID does not exist and the Die on error check box is selected, the Job stops.

  To use this option, the InternalId column must exist in the schema and set as Key.

Sync outgoing schema

After the component schema is updated, click this button propagate the schema to the outgoing flow(s), which can be a normal flow, a reject flow, or both, if the component has any.

Enable customizations

Use native Upsert operation

Select this check box to use the Upsert operation provided by NetSuite.

To use NetSuite's Upsert operation, the ExternalId column must exist in the schema and set as Key.

This option is available when Upsert is selected from the Action list in Basic settings.

By default, for compatibility reasons, this option is disabled and the component performs the Add or Update action for an upsert depending on whether the record ID is specified.

Batch size

Specify the number of records to be processed in each batch.

Note that batching will be disabled if the output component has an outgoing flow.

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at the Job level as well as at each component level.

Global Variables

NB_LINE: the number of rows read by an input component or transferred to an output component. This is an After variable and it returns an integer.

CURRENT_INTERNALID: The internal ID of the record currently inserted or processed. This is a Flow variable and it returns an integer.

ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error check box is cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable functions after the execution of the component.

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 it.

For further information about variables, see Talend Studio User Guide.

Usage rule

This component is usually used as an end component in a Talend flow and it requires an input component.