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.)
Easysoft ODBC drivers use ODBC to connect to the database for which they provide access. 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.
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
The JDBC-ODBC Bridge, Salesforce.com ODBC Driver and MongoDB ODBC driver are available to download from the Easysoft web site.
For installation instructions, see the Salesforce.com ODBC Driver documentation or MongoDB ODBC Driver documentation.
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, in the Windows Run dialog box, type:
%windir%\syswow64\odbcad32.exe
Use ODBC Administrator to create your 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. |
Setting | Value |
---|---|
DSN | MongoDB |
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:
install_dir\Jars
The default location for install_dir 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 JDBCDrivers
list. 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, . . .
Setting | Value |
---|---|
Source Name | Easysoft |
Connection Method | JDBC |
Database | Generic JDBC Data Source |
JDBC Driver | easysoft.sql.jobDriver |
Connection String | jdbc:easysoft://localhost:8831/my_odbc_system_dsn:logonuser=my_windows_user:logonpassword=my_windows_password |
Setting | Value |
---|---|
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 |