Use the JDBC-ODBC Bridge with an Easysoft ODBC Driver to connect Yellowfin to an ODBC Database, enabling you to analyse data stored in data stores such as MongoDB and Salesforce.com from your Yellowfin views, dashboards and reports.
Yellowfin 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.)
By default, Yellowfin expects to use Oracle's JDBC-ODBC bridge. However, the Oracle® bridge has been removed from more recent versions of Java, and was never intended for production use anyway. It is a simple process, however, to install the Easysoft bridge under Yellowfin.
The components necessary to connect Yellowfin to Salesforce.com are:
Yellowfin <-> JDBC-ODBC Bridge <-> Salesforce.com ODBC Driver <-> Salesforce.com
The components necessary to connect Yellowfin to MongoDB are:
Yellowfin <-> JDBC-ODBC Bridge <-> MongoDB ODBC Driver <-> MongoDB
Before you can use the Easysoft ODBC Driver to connect Yellowfin to Salesforce.com or MongoDB, 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:
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.
|User Name||The name of your Salesforce.com user. For example, email@example.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.
|Description||Easysoft MongoDB ODBC Driver|
|Server||The name or IP address of the host where your MongoDB instance is running.|
|User Name||If you need to supply a user name to access your MongoDB database, enter it here.|
|Password||The password for your MongoDB user name.|
For installation instructions, see the JDBC-ODBC Bridge documentation.
You can now connect Yellowfin to Salesforce.com or MongoDB:
EJOB.jar is installed in the following location on the machine where you installed the JDBC-ODBC Bridge:
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.
web.xml is located in the <YELLOWFIN_install_dir>\appserver\webapps\ROOT\WEB-INF folder.
easysoft.sql.jobDriver, to the
JDBCDriverslist. For example:
<init-param> <param-name>JDBCDrivers</param-name> <param-value> easysoft.sql.jobDriver, com.connectioncloud.jdbc.Driver, com.ddtek.jdbc.openedge.OpenEdgeDriver, com.filemaker.jdbc.Driver, . . .
|Database||Generic JDBC Data Source|
|I want to author the view using||Drag and Drop Editor|
|The data I need for my view is sourced from||Easysoft|
|Category List||General Views|
Oracle is a registered trademark of Oracle Corporation and/or its affiliates.