Edit C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\win32_x86\odbc\7.0.1\help\userguide\salesforce.27.03.html
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xml:lang="en" lang="en" xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <!-- MOTW-DISABLED saved from url=(0014)about:internet --> <title>Configuring and Connecting to Data Sources</title> <link rel="StyleSheet" href="css/salesforce.css" type="text/css" media="all" /> <link rel="StyleSheet" href="css/webworks.css" type="text/css" media="all" /> <script type="text/javascript" language="JavaScript1.2" src="wwhdata/common/context.js"></script> <script type="text/javascript" language="JavaScript1.2" src="wwhdata/common/towwhdir.js"></script> <script type="text/javascript" language="JavaScript1.2" src="wwhdata/common/wwhpagef.js"></script> <script type="text/javascript" language="JavaScript1.2"> <!-- var WebWorksRootPath = ""; // --> </script> <script type="text/javascript" language="JavaScript1.2"> <!-- // Set reference to top level help frame // var WWHFrame = WWHGetWWHFrame("", true); // --> </script> <script type="text/javascript" language="JavaScript1.2" src="scripts/expand.js"></script> </head> <body class="" style="background-color: #FFFFEE;" onload="WWHUpdate();" onunload="WWHUnload();" onkeydown="WWHHandleKeyDown((document.all||document.getElementById||document.layers)?event:null);" onkeypress="WWHHandleKeyPress((document.all||document.getElementById||document.layers)?event:null);" onkeyup="WWHHandleKeyUp((document.all||document.getElementById||document.layers)?event:null);"> <br /> <div class="WebWorks_Breadcrumbs" style="text-align: left;"> <a class="WebWorks_Breadcrumb_Link" href="salesforce.27.01.html#1228661">21 The Salesforce Driver</a> : Configuring and Connecting to Data Sources</div> <hr align="left" /> <blockquote> <div class="head_1"><a name="1228661">Configuring and Connecting to Data Sources</a></div> <div class="Body"><a name="1650815">After you install the driver, you configure data sources to connect to the database. See </a><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'quikstart.04.1.html#106107', '');">Chapter 1 â??Quick Start Connectâ??</a></span><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'quikstart.04.1.html#106107', '');"> </a></span>for an explanation of different types of data sources. The data source contains connection options that allow you to tune the driver for specific performance. If you want to use a data source but need to change some of its values, you can either modify the data source or override its values at connection time through a connection string.</div> <div class="Body"><a name="1228670">If you choose to use a connection string, you must use specific connection string attributes. </a>See <span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.03.html#1229558', '');">â??Using a Connection Stringâ??</a></span> for an alphabetical list of driver connection string attributes and their initial default values.</div> <div class="head_2"><a name="1228685">Data Source Configuration in the UNIX/Linux odbc.ini File</a></div> <div class="Body"><a name="1228688">On UNIX and Linux, you must set up the proper ODBC environment before configuring data </a>sources. See <span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'quikstart.04.3.html#106174', '');">â??Setting the Library Path Environment Variable (Salesforce Driver on UNIX/Linux)â??</a></span><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'quikstart.04.3.html#106174', '');"> </a></span>for basic setup information and <span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'unixenv.07.2.html#106206', '');">â??Environment Variablesâ??</a></span><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'unixenv.07.2.html#106206', '');"> </a></span>for more detailed information about this procedure.</div> <div class="Body"><a name="1228697">Data sources for UNIX and Linux are stored in the system information file (by default, </a>odbc.ini). </div> <div class="Body"><a name="1228702">You can configure and modify data sources directly by editing the odbc.ini file and storing </a>default connection values there. See <span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'unixenv.07.4.html#106368', '');">â??Configuration Through the System Information (odbc.ini) Fileâ??</a></span> for detailed information about the specific steps necessary to configure a data source.</div> <div class="Body"><a name="1580645"> lists driver connection string attributes that must be used in the odbc.ini file to set the value </a>of the attributes. Note that only the long name of the attribute can be used in the file. The default listed in the table is the initial default value when the driver is installed.</div> <div class="head_2"><a name="1228715">Data Source Configuration through a GUI</a></div> <div class="Body"><a name="1228726">On Windows, data sources are stored in the Windows Registry. You can configure and </a>modify data sources through the ODBC Administrator using a driver Setup dialog box, as described in this section.</div> <div class="Body"><a name="1228737">When the driver is first installed, the values of its connection options are set by default. </a>These values appear on the driver Setup dialog box tabs when you create a new data source. You can change these default values by modifying the data source. In the following procedure, the description of each tab is followed by a table that lists the connection options for that tab and their initial default values. This table links you to a complete description of the options and their connection string attribute equivalents. The connection string attributes are used to override the default values of the data source if you want to change these values at connection time.</div> <div class="Body" style="color: #000000; font-style: normal; font-variant: normal; font-weight: bold; text-transform: none; vertical-align: baseline;"><span class="Action_bold"><a name="1228739">To configure a Salesforce data source:</a></span></div> <div class="list_procedure_first_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_first_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">1 </span> </div> </td> <td width="100%"> <div class="list_procedure_first_inner"><a name="1574716">Start the ODBC Administrator by selecting its icon from the DataDirect Connect </a>program group. </div> </td> </tr> </table> </div> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">2 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1228767">Select a tab:</a></div> </td> </tr> </table> </div> <div class="list_bulleted_proc_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_bulleted_proc_inner" style="width: 18pt; white-space: nowrap;">â? </div> </td> <td width="100%"> <div class="list_bulleted_proc_inner"><span class="Action_bold"><a name="1228768">User DSN</a></span>: If you are configuring an existing user data source, select the data source name and click <span class="Action_bold">Configure</span> to display the driver Setup dialog box.</div> </td> </tr> </table> </div> <div class="Body_Indent_Sub"><a name="1228769">If you are configuring a new user data source, click </a><span class="Action_bold">Add</span> to display a list of installed drivers. Select the driver and click <span class="Action_bold">Finish</span> to display the driver Setup dialog box.</div> <div class="list_bulleted_proc_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_bulleted_proc_inner" style="width: 18pt; white-space: nowrap;">â? </div> </td> <td width="100%"> <div class="list_bulleted_proc_inner"><span class="Action_bold"><a name="1574721">System DSN</a></span>: If you are configuring an existing system data source, select the data source name and click <span class="Action_bold">Configure</span> to display the driver Setup dialog box.</div> </td> </tr> </table> </div> <div class="Body_Indent_Sub"><a name="1574722">If you are configuring a new system data source, click </a><span class="Action_bold">Add</span> to display a list of installed drivers. Select the driver and click <span class="Action_bold">Finish</span> to display the driver Setup dialog box.</div> <div class="list_bulleted_proc_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_bulleted_proc_inner" style="width: 18pt; white-space: nowrap;">â? </div> </td> <td width="100%"> <div class="list_bulleted_proc_inner"><span class="Action_bold"><a name="1228780">File DSN</a></span>: If you are configuring an existing file data source, select the data source file and click <span class="Action_bold">Configure</span> to display the driver Setup dialog box.</div> </td> </tr> </table> </div> <div class="Body_Indent_Sub"><a name="1228781">If you are configuring a new file data source, click </a><span class="Action_bold">Add</span> to display a list of installed drivers; then, select a driver. Click <span class="Action_bold">Advanced </span>if you want to specify attributes; otherwise, click <span class="Action_bold">Next</span> to proceed. Specify a name for the data source and click <span class="Action_bold">Next</span>. Verify the data source information; then, click <span class="Action_bold">Finish</span> to display the driver Setup dialog box.</div> <div class="Body_Indent"><a name="1228785">The General tab of the Setup dialog box appears by default.</a></div> <div class="picture"><a name="1574738"><img class="procedure" src="images/sfgeneral.gif" width="426" height="580" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The General tab of the ODBC Salesforce Driver Setup dialog box" /></a></div> <div class="Body_Indent"><a name="1228798">NOTE: The General tab displays only fields that are required for creating a data source. </a>The fields on all other tabs are optional, unless noted otherwise.</div> <div class="Body_Indent"><a name="1228800">On this tab, provide values for the options in the following table; then, click </a><span class="Action_bold">Apply. </span>The table provides links to descriptions of the connection options.</div> <table class="Format_D" cellspacing="0" summary=""> <caption></caption> <tr style="vertical-align: top;"> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1228803">Connection Options: General</a></div> </td> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1228805">Default</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1329246', '');" name="1329232">Data Source Name</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1329234">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1254997', '');" name="1329468">Description</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1329470">None </a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1225847', '');" name="1228810">Host Name</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1228812">login.salesforce.com</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1061996', '');" name="1329496">Database</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1329498">None</a></div> </td> </tr> </table> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">3 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1309133">Optionally, click the </a><span class="Action_bold">SQL Engine</span> tab to specify additonal data source settings.</div> </td> </tr> </table> </div> <div class="picture"><a name="1574755"><img class="procedure" src="images/sfproxy.gif" width="426" height="580" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The SQL Engine tab of the ODBC Salesforce Driver Setup dialog box" /></a></div> <div class="Body_Indent"><a name="1309142">On this tab, provide values for any of the options in the following table; then, click </a><span class="Action_bold">Apply. </span>The table provides links to descriptions of the connection options.</div> <table class="Format_D" cellspacing="0" summary=""> <caption></caption> <tr style="vertical-align: top;"> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1628688">Connection Options: SQL Engine</a></div> </td> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1628690">Default (Direct Mode)</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1226399', '');" name="1628716">JVM Arguments</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1628718">-Xmx256m</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1226669', '');" name="1628723">JVM Classpath</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1628725">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1227698', '');" name="1628730">Proxy Host</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1628732">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1243243', '');" name="1628737">Proxy Port</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1628739">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1227867', '');" name="1628744">Proxy User</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1628746">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1227802', '');" name="1628751">Proxy Password</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1628753">None</a></div> </td> </tr> </table> <div class="Body_Indent"><a name="1617993">By default, the Salesforce driver operates in direct mode, with both the driver and its </a>SQL engine running in the ODBC application's address space. Some applications may experience problems loading the JVM because the process exceeds the available heap space. You can configure the Salesforce driver to operate in server mode. Server mode allows the driver to connect to a 32-bit SQL engine JVM running as a separate service.</div> <div class="Body_Indent"><a name="1608602">To run the driver in server mode, set </a><span class="Action_bold">SQL Engine Mode</span> to 1-Server. Additional configuration settings appear on the SQL Engine tab. All fields except SQL Engine Mode are read only. </div> <div class="picture"><a name="1618019"><img class="procedure" src="images/sqlenginemode.gif" width="426" height="580" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The SQL Engine tab of the ODBC Salesforce Driver Setup dialog box with the SQL Engine Mode field set to 1 - Server." /></a></div> <div class="Body_Indent"><a name="1618081">To define the settings for server mode, click </a><span class="Action_bold">Edit Server Settings </span>from the SQL Engine tab. The SQL Engine Service Setup dialog box appears. </div> <div class="Body_Indent"><a name="1627403">NOTE: You must be an administrator to modify the server mode settings. Otherwise, the </a>Edit Server Settings button does not appear on the SQL Engine tab.</div> <div class="Body_Indent"><a name="1627375">You use the SQL Engine Service Setup dialog box to configure server mode and to start </a>or stop the service. See <span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.16.html#1579806', '');">â??Configuring Server Modeâ??</a></span> for detailed information.</div> <div class="picture"><a name="1607732"><img class="procedure" src="images/sqlengineservermode.gif" width="390" height="534" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The SQL Engine Service setup dialog of the ODBC Salesforce Driver Setup dialog box" /></a></div> <table class="Format_D" cellspacing="0" summary=""> <caption></caption> <tr style="vertical-align: top;"> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1634008">Configuration Options: SQL Engine </a>Service</div> </td> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1634010">Default</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1226399', '');" name="1638798">JVM Arguments</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1638800">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1226669', '');" name="1638805">JVM Classpath</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><span class="EquationVariables"><a name="1638807">install_dir</a></span>\java\lib\sforce.jar</div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1227698', '');" name="1638860">Proxy Host</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1638862">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1243243', '');" name="1638867">Proxy Port</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1638869">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1227867', '');" name="1638874">Proxy User</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1638876">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1227802', '');" name="1638881">Proxy Password</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1638883">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1597132', '');" name="1634015">Server Port Number</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1634017">19928</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a name="1634022">Java Path (see </a></span><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.16.html#1579806', '');">page 735</a></span><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;">)</span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1634024">Fully qualified path to the J2SE 5 or higher </a>JVM executable (java.exe)</div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a name="1634529">Server DB Directory (see </a></span><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.16.html#1579806', '');">page 735</a></span><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;">)</span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1634531">Path of the working directory for the SQL </a>Engine service</div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a name="1634594">Services (see </a></span><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.16.html#1579806', '');">page 735</a></span><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;">)</span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1634596">Progress DataDirect Salesforce SQL </a>Engine</div> </td> </tr> </table> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">4 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1228859">Optionally, click the </a><span class="Action_bold">Advanced</span> tab to specify additional data source settings.</div> </td> </tr> </table> </div> <div class="picture"><a name="1574772"><img class="procedure" src="images/sfadvanced.gif" width="426" height="580" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The Advanced Tab of the ODBC Salesforce Driver Setup dialog box" /></a></div> <div class="Body_Indent"><a name="1228869">On this tab, provide values for any of the options in the following table; then, click </a><span class="Action_bold">Apply. </span>The table provides links to descriptions of the connection options.</div> <table class="Format_D" cellspacing="0" summary=""> <caption></caption> <tr style="vertical-align: top;"> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1228872">Connection Options: Advanced</a></div> </td> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1228874">Default</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1170916', '');" name="1322633">Create Database</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1322635">2 -NotExist</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1171082', '');" name="1228879">Transaction Mode</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1228881">0 - No Transactions</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1233118', '');" name="1323703">Application Using Threads</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1323705">Enabled</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1056795', '');" name="1324770">Fetch Size</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1324772">100</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1243646', '');" name="1325837">Refresh Dirty Cache</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1325839">Enabled</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1242764', '');" name="1228886">Read Only</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1228888">Disabled</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1284893', '');" name="1326904">Login Timeout</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1326906">15</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1232781', '');" name="1228914">Report Codepage Conversion Errors</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1228916">0 - Ignore Errors</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1072430', '');" name="1327971">Log Config File</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1327973">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1043315', '');" name="1329038">Initialization String</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1329040">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#982269', '');" name="1228928">Config Options</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1228930">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1225619', '');" name="1228935">Extended Options</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1228937">None</a></div> </td> </tr> </table> <div class="Body_Indent"><span class="Action_bold"><a name="1650848">Translate: </a></span>Click <span class="Action_bold">Translate</span> to display the Select Translator dialog box, which lists the translators specified in the ODBC Translators section of the Registry. Progress DataDirect provides a translator named OEM to ANSI that translates your data from the IBM PC character set to the ANSI character set.</div> <div class="Body_Indent"><a name="1650849">Select a translator; then, click </a><span class="Action_bold">OK</span> to close this dialog box.</div> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">5 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1229005">Optionally, click the </a><span class="Action_bold">Security</span> tab to specify security data source settings.</div> </td> </tr> </table> </div> <div class="picture"><a name="1574789"><img class="procedure" src="images/sfsecurity.gif" width="426" height="580" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The Security tab of the ODBC Salesforce Driver Setup dialog box" /></a></div> <div class="Body_Indent"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.3.html#160782', '');" name="1229019">See </a><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.4.html#118526', '');">â??Using Securityâ??</a></span> for a general description of authentication and encryption and their configuration requirements.</div> <div class="Body_Indent"><a name="1229020">On this tab, provide values for any of the options in the following table; then, click </a><span class="Action_bold">Apply. </span>The table provides links to descriptions of the connection options.</div> <table class="Format_D" cellspacing="0" summary=""> <caption></caption> <tr style="vertical-align: top;"> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1332485">Connection Options: Security</a></div> </td> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1332487">Default</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1296699', '');" name="1332492">User Name</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1332494">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1298582', '');" name="1332499">Logon Domain</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1332501">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1185343', '');" name="1332506">Security Token</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1332508">None</a></div> </td> </tr> </table> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">6 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1312277">Optionally, click the </a><span class="Action_bold">Web Service </span>tab to specify additional data source settings.</div> </td> </tr> </table> </div> <div class="picture"><a name="1574806"><img class="procedure" src="images/sfwebsrvce.gif" width="426" height="580" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The Web Service Tab of the ODBC Salesforce Driver Setup dialog box" /></a></div> <div class="Body_Indent"><a name="1312292">On this tab, provide values for any of the options in the following table; then, click </a><span class="Action_bold">Apply. </span>The table provides links to descriptions of the connection options.</div> <table class="Format_D" cellspacing="0" summary=""> <caption></caption> <tr style="vertical-align: top;"> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1312295">Connection Options: Web Service</a></div> </td> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1312297">Default</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#993902', '');" name="1312302">Statement Call Limit</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1312304">20</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1038545', '');" name="1312309">Stmt Call Limit Behavior</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1312311">1- ErrorAlways</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1045595', '');" name="1312316">WSFetch Size</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1312318">0</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1189539', '');" name="1312323">WSRetry Count</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1312325">0</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1105606', '');" name="1312330">WSTimeout</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1312332">120</a></div> </td> </tr> </table> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">7 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1229238">Optionally, click the </a><span class="Action_bold">Pooling </span>tab to specify connection pooling data source settings.</div> </td> </tr> </table> </div> <div class="picture"><a name="1574823"><img class="procedure" src="images/sfpooling.gif" width="426" height="580" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The Pooling tab of the ODBC Salesforce Driver Setup dialog box" /></a></div> <div class="Body_Indent"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.5.html#113515', '');" name="1229252">See </a><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.5.html#113515', '');">â??Using DataDirect Connection Poolingâ??</a></span> for a general description of connection pooling.</div> <div class="Body_Indent"><a name="1229253">On this tab, provide values for any of the options in the following table; then, click </a><span class="Action_bold">Apply. </span>The table provides links to descriptions of the connection options.</div> <table class="Format_D" cellspacing="0" summary=""> <caption></caption> <tr style="vertical-align: top;"> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1229256">Connection Options: Pooling</a></div> </td> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1229258">Default</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1297442', '');" name="1229263">Connection Pooling</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1229265">Disabled</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1288340', '');" name="1229270">Connection Reset</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1229272">Disabled</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1227266', '');" name="1229277">Max Pool Size</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1229279">100</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1227296', '');" name="1229284">Min Pool Size</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1229286">0</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1226747', '');" name="1229291">LoadBalance Timeout</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1229293">0</a></div> </td> </tr> </table> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">8 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1229306">Optionally, click the </a><span class="Action_bold">Bulk </span>tab to specify DataDirect Bulk Load data source settings.</div> </td> </tr> </table> </div> <div class="picture"><a name="1574840"><img class="procedure" src="images/sfbulk.gif" width="426" height="580" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The Bulk tab of the ODBC Salesforce Driver Setup dialog box" /></a></div> <div class="Body_Indent"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.6.html#109749', '');" name="1229320">See </a><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.6.html#109749', '');">â??Using DataDirect Bulk Loadâ??</a></span> for a general description of DataDirect Bulk Load.</div> <div class="Body_Indent"><a name="1229321">On this tab, provide values for any of the options in the following table; then, click </a><span class="Action_bold">Apply. </span>The table provides links to descriptions of the connection options.</div> <table class="Format_D" cellspacing="0" summary=""> <caption></caption> <tr style="vertical-align: top;"> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1229324">Connection Options: Bulk</a></div> </td> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="1229326">Default</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1184416', '');" name="1229331">Enable Bulk Load</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1229333">Disabled</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1167850', '');" name="1338577">Bulk Load Asynchronous</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1338579">Disabled</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1175244', '');" name="1336965">Bulk Load Concurrency Mode</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1336967">1 (Parallel)</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1167988', '');" name="1439378">Bulk Load Threshold</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1439380">4000</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1224254', '');" name="1340186">Bulk Load Timeout</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1340188">0</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1236666', '');" name="1233187">Bulk Load Batch Size</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1233189">1024</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1175525', '');" name="1233179">Bulk Load Poll Interval</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1233181">10</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1568552', '');" name="1568807">Field Delimiter</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1568809">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text" style="color: #0000ff; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><span style="color: #0000ff; font-size: 10.0pt; font-style: normal; font-variant: normal; font-weight: normal; text-transform: none; vertical-align: baseline;"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1568422', '');" name="1568800">Record Delimiter</a></span></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="1568802">None</a></div> </td> </tr> </table> <div class="Body_Indent"><a name="1650855">If your application is already coded to use parameter array batch functionality, you can </a>leverage DataDirect Bulk Load features through the Enable Bulk Load connection option. Enabling this option automatically converts the parameter array batch operation to use the database bulk load protocol.</div> <div class="Body_Indent"><a name="1650856">If you are not using parameter array batch functionality, you can export data to a bulk </a>load data file, verify the metadata of the bulk load configuration file against the structure of the target table, and bulk load data to a table. Use the following steps to accomplish these tasks.</div> <div class="list_procedure_sub_first_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_sub_first_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">a </span> </div> </td> <td width="100%"> <div class="list_procedure_sub_first_inner"><a name="1229362">To export data from a table to a bulk load data file, click </a><span class="Action_bold">Export Table </span>from the Bulk tab. The Export Table dialog box appears.</div> </td> </tr> </table> </div> <div class="picture"><a name="1581142"><img class="procedure_sub" src="images/sfexport.gif" width="390" height="347" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The Export Table dialog of the ODBC Salesforce Driver Setup dialog box" /></a></div> <div class="Body_Indent_Sub"><a name="1650860">Both a bulk data file and a bulk configuration file are produced by exporting a table. </a>The configuration file has the same name as the data file, but with an XML extension. See<span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.6.html#109749', '');"> </a></span><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.6.html#109749', '');">â??Using DataDirect Bulk Loadâ??</a></span> for details about these files.</div> <div class="Body_Indent_Sub"><a name="1650865">The bulk export operation can create a log file and can also export to external files. </a>See<span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.6.html#109988', '');"> </a></span><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.6.html#109988', '');">â??External Overflow Filesâ??</a></span> for more information. The export operation can be configured such that if any errors or warnings occur:</div> <div class="list_embedded2_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_inner"><a name="1650870">The operation always completes.</a></div> </td> </tr> </table> </div> <div class="list_embedded2_single_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_single_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_single_inner"><a name="1650871">The operation always terminates.</a></div> </td> </tr> </table> </div> <div class="list_embedded2_single_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_single_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_single_inner"><a name="1650872">The operation terminates after a certain threshold of warnings or errors is </a>exceeded.</div> </td> </tr> </table> </div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1581159">Table Name</a></span>: A string that specifies the name of the source database table and, optionally, the columns containing the data to be exported. The driver uses the table name in the FROM clause of a <span class="Syntax">SELECT * FROM </span><span class="EquationVariables">tablename</span> SQL statement. If you want to only export certain columns from your Salesforce table, then you can enter a SELECT statement in this field using the format:</div> <div class="syntax_embed_sub_first"><a name="1482780">(SELECT column1, column2, ... FROM </a><span class="EquationVariables">tablename</span>)</div> <div class="Body_Indent_Sub"><a name="1482782">For example, to export data from the Salesforce ACCOUNT table excluding some </a>of the audit columns, enter the following SQL in the Table Name field:</div> <div class="syntax_embed_sub_first"><a name="1482777">(SELECT SYS_NAME, TYPE, BILLINGSTREET, BILLINGCITY, BILLINGSTATE, </a>BILLINGPOSTALCODE, BILLINGCOUNTRY, SHIPPINGSTREET, SHIPPINGCITY, SHIPPINGSTATE, SHIPPINGPOSTALCODE, SHIPPINGCOUNTRY, PHONE, FAX, WEBSITE, INDUSTRY, ANNUALREVENUE, NUMBEROFEMPLOYEES, DESCRIPTION FROM ACCOUNT)</div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1346141">Export Filename</a></span>: A string that specifies the path (relative or absolute) and file of the bulk load data file to which the data is to be exported. It also specifies the file name of the bulk configuration file. These files must not already exist; if one of both of them already exists, an error is returned.</div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1346142">Log Filename</a></span>: A string that specifies the path (relative or absolute) and file name of the bulk log file. The log file is created if it does not exist. Events logged to this file are:</div> <div class="list_embedded2_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_inner"><a name="1346143">Total number of rows fetched</a></div> </td> </tr> </table> </div> <div class="list_embedded2_single_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_single_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_single_inner"><a name="1346144">A message for each row that failed to export</a></div> </td> </tr> </table> </div> <div class="list_embedded2_single_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_single_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_single_inner"><a name="1346145">Total number of rows that failed to export</a></div> </td> </tr> </table> </div> <div class="list_embedded2_single_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_single_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_single_inner"><a name="1346146">Total number of rows successfully exported</a></div> </td> </tr> </table> </div> <div class="Body_Indent_Sub"><a name="1346147">Information about the load is written to this file, preceded by a header. Information </a>about the next load is appended to the end of the file.</div> <div class="Body_Indent_Sub"><a name="1346150">If you do not supply a value for Log Filename, no log file is created.</a></div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1346151">Error Tolerance</a></span>: A value that specifies the number of errors to tolerate before an operation terminates. A value of 0 indicates that no errors are tolerated; the operation fails when the first error is encountered.</div> <div class="Body_Indent_Sub"><a name="1346152">The default of -1 means that an infinite number of errors is tolerated.</a></div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1346153">Warning Tolerance</a></span>: A value that specifies the number of warnings to tolerate before an operation terminates. A value of 0 indicates that no warnings are tolerated; the operation fails when the first warning is encountered.</div> <div class="Body_Indent_Sub"><a name="1346154">The default of -1 means that an infinite number of warnings is tolerated.</a></div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1346155">Code Page</a></span>: A value that specifies the code page value to which the driver must convert all data for storage in the bulk data file. See<span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.6.html#122965', '');"> </a></span><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'advanced.06.6.html#122965', '');">â??Character Set Conversionsâ??</a></span> for more information.</div> <div class="Body_Indent_Sub"><a name="1346160">The default value on Windows is the current code page of the machine. </a></div> <div class="Body_Indent_Sub"><a name="1346161">Click </a><span class="Action_bold">Export Table</span> to connect to the database and export data to the bulk data file or click <span class="Action_bold">Cancel</span>.</div> <div class="list_procedure_sub_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_sub_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">b </span> </div> </td> <td width="100%"> <div class="list_procedure_sub_inner"><a name="1341792">To bulk load data from the bulk data file to a database table, click </a><span class="Action_bold">Load Table </span>from the Bulk tab. The Load File dialog box appears.</div> </td> </tr> </table> </div> <div class="picture"><a name="1574870"><img class="procedure" src="images/sfloadtable.gif" width="390" height="509" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The Load File dialog of the ODBC Salesforce Driver Setup dialog box" /></a></div> <div class="Body_Indent_Sub"><a name="1650876">The load operation can create a log file and can also create a discard file that </a>contains rows rejected during the load. The discard file is in the same format as the bulk load data file. After fixing reported issues in the discard file, the bulk load can be reissued using the discard file as the bulk load data file.</div> <div class="Body_Indent_Sub"><a name="1650877">The export operation can be configured such that if any errors or warnings occur:</a></div> <div class="list_embedded2_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_inner"><a name="1650878">The operation always completes.</a></div> </td> </tr> </table> </div> <div class="list_embedded2_single_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_single_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_single_inner"><a name="1650879">The operation always terminates.</a></div> </td> </tr> </table> </div> <div class="list_embedded2_single_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_single_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_single_inner"><a name="1650880">The operation terminates after a certain threshold of warnings or errors is </a>exceeded.</div> </td> </tr> </table> </div> <div class="Body_Indent_Sub"><a name="1650881">If a load fails, the Load Start and Load Count options can be used to control which </a>rows are loaded when a load is restarted after a failure.</div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1352742">Table Name</a></span>: A string that specifies the name of the target database table and, optionally, the columns into which the data is loaded.</div> <div class="Body_Indent_Sub"><a name="1482842">The fields defined in the load data file must have the same ordering of the fields </a>defined in the Salesforce destination table. Because Salesforce defines additional audit columns that are managed by the database, your load data file may not contain data to load into these fields.</div> <div class="Body_Indent_Sub"><a name="1482844">In this case, you can specify the exact columns that you want for the data to be </a>inserted into using a Table Name string of the format:</div> <div class="syntax_embed_sub_first"><span class="EquationVariables"><a name="1482845">table</a></span>(<span class="EquationVariables">column1</span>, <span class="EquationVariables">column2</span>, ...)</div> <div class="Body_Indent_Sub"><a name="1482847">For example, if your load data file contains only five fields of billing data that you </a>wanted to load into the Salesforce ACCOUNT table, then the Table Name field would contain:</div> <div class="syntax_embed_sub_first"><a name="1482832">ACCOUNT(BILLINGSTREET, BILLINGCITY, BILLINGSTATE, BILLINGPOSTALCODE, </a>BILLINGCOUNTRY)</div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1352743">Load Data Filename</a></span>: A string that specifies the path (relative or absolute) and file name of the bulk data file from which the data is loaded.</div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1352744">Configuration Filename</a></span>: A string that specifies the path (relative or absolute) and file name of the bulk configuration file.</div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1352746">Log Filename</a></span>: A string that specifies the path (relative or absolute) and file name of the bulk log file. Specifying a value for Log Filename creates the file if it does not already exist. Events logged to this file are:</div> <div class="list_embedded2_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_inner"><a name="1352747"> </a>Total number of rows read</div> </td> </tr> </table> </div> <div class="list_embedded2_single_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_single_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_single_inner"><a name="1352748"> </a> Message for each row that failed to load</div> </td> </tr> </table> </div> <div class="list_embedded2_single_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_single_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_single_inner"><a name="1352749">Total number of rows that failed to load</a></div> </td> </tr> </table> </div> <div class="list_embedded2_single_outer" style="margin-left: 36pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_embedded2_single_inner" style="width: 14.399999999999998pt; white-space: nowrap;">â??</div> </td> <td width="100%"> <div class="list_embedded2_single_inner"><a name="1352750"> </a>Total number of rows successfully loaded</div> </td> </tr> </table> </div> <div class="Body_Indent_Sub"><a name="1352751">Information about the load is written to this file, preceded by a header. Information </a>about the next load is appended to the end of the file.</div> <div class="Body_Indent_Sub"><a name="1352754">If you do not specify a value for Log Filename, no log file is created.</a></div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1352755">Discard Filename</a></span>: A string that specifies the path (relative or absolute) and file name of the bulk discard file. Any row that cannot be inserted into the database as result of bulk load is added to this file, with the last row rejected added to the end of the file.</div> <div class="Body_Indent_Sub"><a name="1352756">Information about the load is written to this file, preceded by a header. Information </a>about the next load is appended to the end of the file.</div> <div class="Body_Indent_Sub"><a name="1352759">If you do not specify a value for Discard Filename, a discard file is not created.</a></div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1352760">Error Tolerance</a></span>: A value that specifies the number of errors to tolerate before an operation terminates. A value of 0 indicates that no errors are tolerated; the operation fails when the first error is encountered.</div> <div class="Body_Indent_Sub"><a name="1352761">The default of -1 means that an infinite number of errors is tolerated.</a></div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1352762">Load Start</a></span>: A value that specifies the first row to be loaded from the data file. Rows are numbered starting with 1. For example, when Load Start is 10, the first 9 rows of the file are skipped and the first row loaded is row 10. This option can be used to restart a load after a failure.</div> <div class="Body_Indent_Sub"><a name="1352763">The default value is 1.</a></div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1352764">Read Buffer Size (KB)</a></span>: A value that specifies the size, in KB, of the buffer that is used to read the bulk data file for a bulk load operation.</div> <div class="Body_Indent_Sub"><a name="1352765">The default value is 2048.</a></div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1352766">Warning Tolerance</a></span>: A value that specifies the number of warnings to tolerate before an operation terminates. A value of 0 indicates that no warnings are tolerated; the operation fails when the first warning is encountered.</div> <div class="Body_Indent_Sub"><a name="1352767">The default of -1 means that an infinite number of warnings is tolerated.</a></div> <div class="Body_Indent_Sub"><span class="Action_bold"><a name="1568828">Load Count</a></span>: A value that specifies the number of rows to be loaded from the data file. The bulk load operation loads rows up to the value of Load Count from the file to the database. It is valid for Load Count to specify more rows than exist in the data file. The bulk load operation completes successfully when either the number of rows specified by the Load Count value has been loaded or the end of the data file is reached. This option can be used in conjunction with Load Start to restart a load after a failure.</div> <div class="Body_Indent_Sub"><a name="1568836">The default value is the maximum value for SQLULEN. If set to 0, no rows are </a>loaded.</div> <div class="Body_Indent_Sub"><a name="1568830">Click </a><span class="Action_bold">Load Table</span> to connect to the database and load the table or click <span class="Action_bold">Cancel</span>.</div> <div class="Body_Indent_Sub"><a name="1351895">At any point during the configuration process, you can click </a><span class="Action_bold">Test Connect</span> to attempt to connect to the data source using the connection options specified in the driver Setup dialog box. A logon dialog box appears (see <span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.03.html#1229589', '');">â??Using a Logon Dialog Boxâ??</a></span> for details). Note that the information you enter in the logon dialog box during a test connect is not saved.</div> <div class="list_bulleted_proc_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_bulleted_proc_inner" style="width: 18pt; white-space: nowrap;">â? </div> </td> <td width="100%"> <div class="list_bulleted_proc_inner"><a name="1229550">If the driver can connect, it releases the connection and displays a </a><span class="Syntax">Connection </span><span class="Syntax">Established</span> message. Click <span class="Action_bold">OK</span>.</div> </td> </tr> </table> </div> <div class="list_bulleted_proc_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_bulleted_proc_inner" style="width: 18pt; white-space: nowrap;">â? </div> </td> <td width="100%"> <div class="list_bulleted_proc_inner"><a name="1229551">If the driver cannot connect because of an incorrect environment or connection </a>value, it displays an appropriate error message. Click <span class="Action_bold">OK</span>.</div> </td> </tr> </table> </div> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">9 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1229554">Click </a><span class="Action_bold">OK</span> or <span class="Action_bold">Cancel</span>. If you click <span class="Action_bold">OK</span>, the values you have specified become the defaults when you connect to the data source. You can change these defaults by using this procedure to reconfigure your data source. You can override these defaults by connecting to the data source using a connection string with alternate values.</div> </td> </tr> </table> </div> <div class="head_2"><a name="1229558">Using a Connection String</a></div> <div class="Body"><a name="1650885">If you want to use a connection string for connecting to a database, or if your application </a>requires it, you must specify either a DSN (data source name), a File DSN, or a DSN-less connection in the string. The difference is whether you use the DSN=, FILEDSN=, or the DRIVER= keyword in the connection string, as described in the ODBC specification. A DSN or FILEDSN connection string tells the driver where to find the default connection information. Optionally, you may specify <span class="Emphasis">attribute=value</span> pairs in the connection string to override the default values stored in the data source.</div> <div class="Body"><a name="1650886">The DSN connection string has the form:</a></div> <div class="syntax_first"><a name="1650887">DSN=</a><span class="EquationVariables">data_source_name</span>[;<span class="EquationVariables">attribute=value</span>[;<span class="EquationVariables">attribute=value</span>]...]</div> <div class="Body"><a name="1650888">The FILEDSN connection string has the form:</a></div> <div class="syntax_first"><a name="1650889">FILEDSN=</a><span class="EquationVariables">filename.</span><span class="Syntax">dsn</span>[;<span class="EquationVariables">attribute=value</span>[;<span class="EquationVariables">attribute=value</span>]...]</div> <div class="Body"><a name="1650890">The DSN-less connection string specifies a driver instead of a data source. All connection </a>information must be entered in the connection string because the information is not stored in a data source.</div> <div class="Body"><a name="1650891">The DSN-less connection string has the form:</a></div> <div class="syntax_first"><a name="1650892">DRIVER=[{]</a><span class="EquationVariables">driver_name</span>[}][;<span class="EquationVariables">attribute=value</span>[;<span class="EquationVariables">attribute=value</span>]...]</div> <div class="Body"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.04.html#1234692', '');" name="1650896">Table 21-1, â??Salesforce Attribute Namesâ??</a></span> lists the long and short names for each attribute, as well as the initial default value when the driver is first installed. You can specify either long or short names in the connection string.</div> <div class="Body"><a name="1593609">An example of a DSN connection string with overriding attribute values for Salesforce for </a>Linux/UNIX/Windows is:</div> <div class="syntax_first"><a name="1229578">DSN=Salesforce;UID=JOHN@MYCOMPANY.COM;PWD=XYZZY</a></div> <div class="Body"><a name="1229579">A FILEDSN connection string is similar except for the initial keyword:</a></div> <div class="syntax_first"><a name="1229580">FILEDSN=Salesforce;UID=JOHN@MYCOMPANY.COM;PWD=XYZZY</a></div> <div class="Body"><a name="1229581">A DSN-less connection string must provide all necessary connection information:</a></div> <div class="syntax_first"><a name="1229584">DRIVER=DataDirect 7.0 Salesforce;UID=JOHN@MYCOMPANY.COM;PWD=XYZZY</a></div> <div class="head_2"><a name="1229589">Using a Logon Dialog Box</a></div> <div class="Body"><a name="1229590">Some ODBC applications display a logon dialog box when you are connecting to a data </a>source. In these cases, the host name has already been specified.</div> <div class="picture"><a name="1574885"><img class="Default" src="images/salesforce.27.03.12.gif" width="622" height="247" style="display: block; float: none; left: 0.0; top: 0.0;" alt="Logon to Salesforce dialog box" /></a></div> <div class="Body"><a name="1229602">In this dialog box, provide the following information:</a></div> <div class="list_procedure_first_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_first_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">1 </span> </div> </td> <td width="100%"> <div class="list_procedure_first_inner"><a name="1229603">In the Host Name field, type the root of the Salesforce URL to which you want to </a>connect. The default is login.salesforce.com.</div> </td> </tr> </table> </div> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">2 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1229618">Type the file name prefix the driver uses to create or locate the set of files that define </a>the embedded database per connection. See <span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'salesforce.27.07.html#1348631', '');">â??Mapping Objects to Tablesâ??</a></span> for an explanation of embedded database.</div> </td> </tr> </table> </div> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">3 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1229619">Type your logon ID in the User Name field.</a></div> </td> </tr> </table> </div> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">4 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1229620">Type your password in the Password field.</a></div> </td> </tr> </table> </div> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">5 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="1229621">Click </a><span class="Action_bold">OK</span> to complete the logon.</div> </td> </tr> </table> </div> <script type="text/javascript" language="JavaScript1.2"> <!-- // Clear related topics // WWHClearRelatedTopics(); document.writeln(WWHRelatedTopicsInlineHTML()); // --> </script> </blockquote> <script type="text/javascript" language="JavaScript1.2"> <!-- document.write(WWHRelatedTopicsDivTag() + WWHPopupDivTag() + WWHALinksDivTag()); // --> </script> </body> </html>
Ms-Dos/Windows
Unix
Write backup
jsp File Browser version 1.2 by
www.vonloesch.de