Use the JDBC-ODBC Bridge with the Salesforce.com ODBC Driver to connect Jaspersoft to Salesforce.com and provide real time access to your Salesforce.com objects, enabling you to analyse Salesforce.com data from your Jaspersoft dashboard.
Jaspersoft is a Java application. To interact with a data source such as Salesforce.com, a Java application uses a JDBC driver. (JDBC is a Java application programming interface (API) that connects Java to relational databases and other tabular data such as spreadsheets and flat files.)
The Salesforce.com ODBC driver uses ODBC to connect to Salesforce.com. ODBC is another data access technology, the Microsoft implementation of which is included with Windows.
The JDBC-ODBC Bridge allows a Java application using JDBC to access an ODBC driver. The JDBC-ODBC Bridge and ODBC driver do not have to be installed on the same machine.
The components necessary to connect Jaspersoft to Salesforce.com are therefore:
Jaspersoft <-> JDBC-ODBC Bridge <-> Salesforce.com ODBC Driver <-> Salesforce.com
The JDBC-ODBC Bridge and Salesforce.com ODBC Driver are available to download from the Easysoft web site.
For installation instructions, see the Salesforce.com ODBC Driver documentation.
Before you can use the Salesforce.com ODBC Driver to connect Jaspersoft to Salesforce, you need to configure a System ODBC data source. An ODBC data source stores the connection details for the target database (e.g. Salesforce.com) and the ODBC driver that is required to connect to it (e.g. the Salesforce.com ODBC driver).
To run ODBC Administrator on 32-bit Windows, open Administrative Tools in Control Panel, and then open Data Sources (ODBC). (On older versions of Windows, the Control Panel applet that launches ODBC Administrator is labelled Data Sources.)
To run ODBC Administrator on 64-bit Windows, in the Windows Run dialog box, type:
%windir%\syswow64\odbcad32.exe
If you are not sure whether your version of Windows is 32-bit or 64-bit, follow the instructions for running ODBC Administrator on 64-bit Windows. If you get an error, follow the instructions for 32-bit Windows instead.
Use ODBC Administrator to create your Salesforce.com ODBC Driver data source:
Setting | Value |
---|---|
DSN | Salesforce.com |
User Name | The name of your Salesforce.com user. For example, myuser@mydomain.com. |
Password | The password for your Salesforce.com user. |
Token | The security token for your Salesforce.com user, if required. To find out whether you need to supply a security token, choose the Test button. If the connection attempt fails with an error which contains Salesforce.com emails the security token to the email address associated with your Salesforce.com user account. If you have not received a security token, you can regenerate it. Salesforce.com will then email the new security token to you. To regenerate your security token, log in to Salesforce.com and then choose Setup from the user menu. Search for "security token" in the Quick Find box. Click Reset Security Token in the Reset Security Token page. When you receive the token in your email client, copy it and then paste it into the Token field. |
For installation instructions, see the JDBC-ODBC Bridge documentation.
You can now connect Jaspersoft to Salesforce.com:
EJOB.jar is installed in the following location on the machine where you installed the JDBC-ODBC Bridge:
<easysoft_install>\Jars
On 32-bit Windows, the default location for <easysoft_install> is <drive>:\Program Files\Easysoft Limited\Easysoft JDBC-ODBC Bridge.
On 64-bit Windows, the default location for <easysoft_install> is <drive>:\Program Files (x86)\Easysoft Limited\Easysoft JDBC-ODBC Bridge.
Setting | Value |
---|---|
Name | Salesforce |
Description | Connect Jaspersoft to Salesforce.com with Easysoft. |
JDBC Driver | Choose Other from the list, and then type easysoft.sql.jobDriver in the space provided. |
URL | jdbc:easysoft://<my_host>/<my_salesforce_system_dsn> Replace <my_host> with the hostname or IP address of the machine where you installed the JDBC-ODBC Bridge. Replace <my_salesforce_system_dsn> with the name of your Salesforce.com ODBC driver. |
Username | Your Salesforce.com user name. |
Password | Your Salesforce.com password. |
If the JDBC-ODBC Bridge has authentication turned on, which it has by default, you will need to add these parameters to the JDBC URL:
:logonuser=<my_windows_user>:logonpassword=<my_windows_password>
Replace <my_windows_user> and <my_windows_password> with a valid Windows user name and password for the machine on which the JDBC-ODBC Bridge is running.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates.