Step 1 - Download QODBC
If you haven't already downloaded QODBC by modem, do it now by going to the download page.
Don't forget to read the "Readme" file during installation for the latest information on QODBC setup, new features and other driver information.
Save the self-extracting executable "QODBC.exe" in a temporary directory or your "My Documents" folder to extract the installation files.
Step 2 - Running the Installer
Unload Microsoft Office toolbar from memory, as well as any other Windows applications that can impair installation. Click on the Install program from within Windows to install the driver. Select the destination directory to install the QODBC support files. Click "OK" to continue.
The FLEXquarters QODBC Driver for QuickBooks has been successfully installed onto your computer. You can begin to use it immediately, because it will immediately run as a 30 day evaluation version.
To install a full purchase or evaluation QODBC registration code, see the Icons that have been added to your Start Menu under QODBC Driver for QuickBooks
The first step in configuring the driver is to click on the ODBC Setup Screen icon and the following screen will be become available.
QODBC General Setup Screen
Use the company file that's now open in QuickBooks allows QODBC to use the company file that you have open and allows you to switch between files without having to create separate DSN's for each file.
Locate a company file is the path where your QuickBooks data file resides. For example: "C:\Program Files\Intuit\QuickBooks Pro\Myapp.qbw". The browse button (…) will let you choose your QuickBooks company file from the folder it is in.
Data Source Name is a display name for your QuickBooks data (QuickBooks Data, QBPRO, My QB Data, etc.)
Mode when opening includes multiple ways of opening a QuickBooks file, and this setting allows you to determine how QODBC should open each company file.
Test Connection to QuickBooks will determine if you have a proper installation and settings with QuickBooks and a company file open. The following popup screen should appear:
Messages allows you to review message logs from QODBC regarding errors and issues communicating with QuickBooks, Clear these messages, and review messages produced by the QuickBooks SDK interface.
Detail Tracing (Slow) creates a trace log of exactly what QODBC is doing in the background with the application using it for debugging purposes. Make sure the log is turned off when not needed as these logs can use up large amounts of disk space.
Display Optimizer Status Panel will display the progress of optimization on the data, this is especially helpful on large data files being reloaded in their entirety.
Display Driver Status Panel when selected shows exactly what QODBC is doing when accessing the QuickBooks data and provides a good assessment of speed using optimized data and non-optimized data.
Use Optimizer brings some data to a local cache to increase retrieval performance for queries. Here you can adjust where optimizations are stored and when they are updated. Check to activate the Optimizer.
Optimizer Database Folder specifies where the local data store will be saved on disk. The default location is under the folder where you specified QODBC to be installed. The data will be stored in a file in this folder with a name similar to the company file name. If you opt to store that data somewhere other than the default click the browse button and select the destination folder. With very large company files we suggest running synchronization after hours.
Keep my optimized data up to date as of when you choose the optimizer to synchronize itself with your Company data. Depending on how static your data need is and the size of the file, you can opt for various time frames of synchronization. The farther down the list you go the less synchronization will occur and your queries will run much faster, but will be using less current data than the company file itself.
Use DCOM Servers for Web editions of QODBC require QuickBooks to be running on the Server Console. They are more secure and require no extra overhead but are more rigid on how it is setup and it can be difficult to configure the security of the DCOM servers. The other option for web configuration is the Remote Connector. See http://www.qodbc.com/QODBCweb.htm for detailed information for Web Edition setup.
Remote Connector Tab
Connect to n/Software's IBiz Integrator for QuickBooks allows QODBC and an application to access copy(s) of QuickBooks running anywhere over the Internet, or over a local area network. This feature is built-in and requires no additional charge for the non-encrypted (plain text) version.
If you are using this feature over the open Internet with live data, for security it is strongly recommended purchasing the SSL encrypted version of the Remote Connector by n/Software or use Intuits free Web Connector. For more details on remote setup see http://www.qodbc.com/qodbcremote.htm
QuickBooks Online Edition Tab
Connect To QuickBooks Online Edition with QODBC and a front-end application such as MS Excel, MS Access or Visual Basic to name a few applications, to Read and or Write data to your "QBOE" data file. See http://www.qodbc.com/qodbconline.htm for additional setup instructions.
The selected defaults in the Advanced settings should apply to most users and need not be changed.
Reconnect Delay Is an amount of time to wait after a disconnect when using the remote connector. This allows QuickBooks to fully unload it if it is being loaded in the background on the Host Remote Connector, before you connect again.
Maximum Field Name Length is set to the QuickBooks limitation but certain applications like Delphi can not handle this limit and must be set accordingly.
Use Case Sensitive RefNumber Searches when checked means a refnumber of 'ABC' and 'abc' will be different, but means QuickBooks can use an index internally for a search instead of a complete table scan. (Note: this feature applies to versions of QuickBooks 2005 and higher)
Include Raw File if checked will display both filtered and raw data formats. QODBC formats data into SQL field types more easily used in programming languages for math and comparison operations. The Raw tables return the data as it is returned to QODBC without modification.
Run 2.1 ODBC Compatibility is checked for certain applications that require ODBC 2.1 Compatibility to use QODBC. Anything that uses the Java ODBC library, like ColdFusion, requires this option turned on or recordsets will be returned with no rowsets or only 1 rowset.
Simulate Transaction Support for SQL Server will turn transaction support on so that SQL Server will allow updates when using QODBC as a linked server. QODBC still does not support transactions, but simulates the turning on and off of transactions.
Use Iterators and Interator or Chunk Size fields allows you to turn off iterators. This is needed on systems like MS-SQL and Web Servers that use multiple threads.
Integrated Application Defaults are the defaults set in the integrated applications dialog within QuickBooks and are available in the US versions of QuickBooks 2005 and beyond.
This tab allows you to purchase a CD Key, activate a license with the CD Key, deactivate an active license or find out additional information about the driver that is currently installed.
Activate is the online option for entering the CD Key that was issued to you upon purchasing the product to fully activate QODBC from the evaluation version to either the full Read Only, Read/Write or Web Edition that has been purchased. If you do not have internet access to activate the product, you can use the phone option to supply your reseller or distributor with the information to activate the product for you.
Deactivate is the online method of deactivating a currently registered version of QODBC for the transfer of the product to another machine. This process will take 24 to 48 hours before your CD Key account is credited with the deactivated license and you can reactivate the license on a different machine. If internet access is not available from the registered machine, you can use the phone option to supply your reseller or distributor with the information to deactivate the product CD Key for you.
About screen shows the QODBC version currently installed, whether it is an evaluation copy or fully registered. The first letter in the serial number denotes what type of license is installed, the 3rd digit the QODBC version and the fourth denotes what version of QuickBooks (US, CA, UK, AU) the license is compatible with. (The serial number may be required for upgrades, rebate offers, technical installation support or the Help Desk system.)
Check Website for Updates will launch your internet browser to our web site and check to see if you have the latest available version of QODBC installed on your machine. You can view the Readme file for the list of all the latest features in the current version of QODBC and download the latest updater should you be using an older version of the driver.
Next: Connecting to QuickBooks for the First Time
Did you find the answer you were looking for on this page? If not, please Contact Us or click on the Live Help icon at the bottom right. We are happy to help you find the solution you are looking for. Thanks!
FLEXquarters North America Sales
All rights reserved
QuickBooks and the Gold and Silver Developer Logos are trademarks and/or registered trademarks of Intuit Inc., displayed with permission. What is RSS?