tSalesforceGetUpdated – Docs for ESB 5.x

Component family

Business/Cloud

Function

tSalesforceGetUpdated recovers
updated data from a Salesforce object over a given period of
time.

Purpose

This component can collect all updated data from a given
Salesforce object during a specific period of time.

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.

Timeout (milliseconds)

Type in the intended number of query timeout in
Salesforce.com.

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.

Start Date

Type in between double quotes the date at which you want to start
the search. Use the following date format: “yyyy-MM-dd
HH:mm:ss”.

End Date

Type in between double quotes the date at which you want to end
the search. Use the following date format:”yyyy-MM-dd
HH:mm:ss”.

Advanced settings

Use Soap Compression

Select this check box to activate the SOAP compression.

Client ID

Set the ID of the real user to differentiate between those who use
the same account and password to access the Salesforce
website.

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.

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

You can use this component as an output component. tSalesforceGetUpdate requires an input
component.

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

n/a