July 30, 2023

tNetsuiteOutput – Docs for ESB 7.x

tNetsuiteOutput

Invokes the NetSuite SOAP service and inserts, updates, or removes data on the
NetSuite SOAP server.

tNetsuiteOutput Standard properties

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

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

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

Basic settings

Connection Component

Select a tNetsuiteConnection component to reuse its
connection details to set up the connection to the NetSuite server.

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.

As of version 7.1, API versions 2014.2 and 2016.2 have been
deprecated.

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

Application ID

Enter the NetSuite application ID generated for your account.

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

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.

You can find more details about how to
verify default values in retrieved schema in Talend Help Center (https://help.talend.com).

 

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.

Warning:

The schema of this component is prefilled with
columns corresponding to the NetSuite service fields, which vary
depending on the Record Type
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.

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.

Advanced settings

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.

This option is enabled by default. You can disable it if you don’t need
custom record types or custom fields.

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

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

Usage rule

This component is usually used as an end component in a

Talend
flow and it requires an input component.

Related scenario

For a related scenario, see Handling data with NetSuite.


Document get from Talend https://help.talend.com
Thank you for watching.
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x