tSalesforceBulkExec – Docs for ESB 5.x

Component family

Business/Cloud

Function

tSalesforceBulkExec executes the
intended actions on the prepared bulk data.

Purpose

As a dedicated component, tSalesforceBulkExec gains performance while carrying
out the intended data operations into your Salesforce.com.

Basic settings

Use an existing connection

Select this check box and in the Component List click the
relevant connection component to reuse the connection details you already defined.

Login Type

Two options are available:

Basic: select this option to log
in to Salesforce.com by entering your Username/Password on tSalesforceConnection.

OAuth2: select this option to
access Salesforce.com by entering your Consumer key/Consumer Secret
on tSalesforceConnection. This way,
your Username/Password will not be exposed to tSalesforceConnection but extra work is required:

Salesforce Webservice URL

Enter the Webservice URL required to connect to the Salesforce
database.

Salesforce Version

Enter the Salesforce version you are using.

Username and
Password

Enter your Web service authentication details.

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.

Consumer Key and Consumer
Secret

Enter your OAuth authentication details. Such information is
available in the OAuth Settings
area of the Connected App that you have created at
Salesforce.com.

To enter the consumer secret, click the […] button next
to the consumer secret field, and then in the pop-up dialog box enter the consumer secret
between double quotes and click OK to save the
settings.

For what a Connected App is, see Connected Apps. For how to create a Connected App, see
Defining Remote Access Applications.

Callback Host and Callback
Port

Enter your OAuth authentication callback url. This url (both host
and port) is defined during the creation of a Connected App and will
be shown in the OAuth Settings area
of the Connected App.

Token File

Enter the token file name. It stores the refresh token that is
used to get the access token without authorization.

Bulk file path

Directory where are stored the bulk data you need to
process.

Action

You can do any of the following operations on the data of the
Salesforce object:

Insert: insert data.

Update: update data.

Upsert: update and insert
data.

Upsert Key Column

Specify the key column for the upsert operation.

Available when Upsert is selected
from the Action list.

Module

Select the relevant module in the list.

Schema and Edit
Schema

A schema is a row description. It defines the number of fields to be processed and passed on
to the next component. The schema is either Built-In or
stored remotely in the Repository.

Since version 5.6, both the Built-In mode and the Repository mode are
available in any of the Talend solutions.

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

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

Advanced settings

Rows to commit

Specify the number of lines per data batch to be processed.

Bytes to commit

Specify the number of bytes per data batch to be processed.

Concurrency mode

The concurrency mode for the job.

Parallel: process batches in
parallel mode.

Serial: process batches in serial
mode.

Wait time for checking batch
state(milliseconds)

Specify the wait time for checking whether the batches in a Job
have been processed until all batches are finally processed.

Use Socks Proxy

Select this check box if you want to use a proxy server. Once
selected, you need provide the connection parameters that are host,
port, username and password.

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at a
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.

NB_SUCCESS: the number of rows successfully processed.
This is an After variable and it returns an integer.

NB_REJECT: the number of rows rejected. This is an After
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

Used as an output component. An Input component is required.

Log4j

The activity of this component can be logged using the log4j feature. For more information on this feature, see Talend Studio User
Guide.

For more information on the log4j logging levels, see the Apache documentation at http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html.

Limitation

The bulk data to be processed should be .csv
format.

Due to license incompatibility, one or more JARs required to use this component are not
provided. You can install the missing JARs for this particular component by clicking the
Install button on the Component tab view. You can also find out and add all missing JARs easily on
the Modules tab in the Integration perspective
of your studio. For details, see https://help.talend.com/display/KB/How+to+install+external+modules+in+the+Talend+products
or the section describing how to configure the Studio in the Talend Installation and Upgrade
Guide.