Skip to content

DataSplice Support Website

Sections
Personal tools
You are here: Home » Product Manuals DataSplice 3.x » DataSplice 3.1 Basic Administration » ADO.NET Data Source Configuration

ADO.NET Data Source Configuration

This plug-in is used by the DataSplice server to connect to standard relational database servers and provide access to that data to mobile users.

Select the ADO.NET Data Source from the list of available Server Plug-ins to display its options:

ADO.NET Data Source Options

Basic Settings

The following settings control various aspects of how the ADO.NET plug-in operates. The default options are fairly reasonable and rarely need to be changed:

Query Cache Timeout Specifies the time, in seconds, that schema information for a query is cached.
Stored Procedure Cache Timeout Specifies the time, in seconds, that information regarding stored procedures is cached.
Maximum Records Fetched Controls the maximum number of records that can be returned by any single query. This is used primarily to prevent runaway offline that transfer unreasonably large amounts of data to a handheld. Increase this value to the maximum number of records that are needed offline for any particular view.

Connection Profiles

The DataSplice Server uses connection profiles to define the settings used to connect to external data sources. Each view specifies a particular connection profile to use.

Connection profiles allow settings for multiple views to be quickly changed, since the details only need to be modified for the connection profile once. Note that it is strongly recommended that connection profile names refer to the generic application being accessed (maximo, tools, etc.) and not include any stage information (maxdev). Each view will reference the connection profile by name, and this allows the settings to be clear when copying views to the various stage instances.

To create a new connection profile, click the Add New Section button to create a new entry. This has the following options:

Name This is the unique name used by DataSplice to identify this connection profile. This name is referenced by all DataSplice views to specify the data source to gather data from. The name is case-sensitive.
Driver This drop-down menu contains the available native database drivers. Select the corresponding driver describing the specific platform in use.
Database Server This is the server entry in a valid ADO.NET connection string. For Oracle, the server entry usually corresponds to a tns entry. In SQL Server, the server entry is usually the name of the machine where the database resides.
User Name
This is the user name that the DataSplice Server will use to connect to the data source. This user should have sufficient permissions to access the target data.
Password The password associated with the specified User Name.
Initial Catalog
When applicable, this is the database instance to use when multiple databases are present. For SQL Server this specifies the name of the database to use. For Oracle connections this specifies the default connection schema.
Trusted Connection
When this check box is enabled, the same credentials used to launch the DataSplice Server application will be used to authenticate against the database. The User Name and Password fields are ignored in this case.
Extra Options
This allows additional connection settings to be passed to the database in the connect statement by appending this value to the basic connect statement generated by DataSplice. Consult the documentation for the database provider for a list of valid parameters.
Pass-Through Authentication
When this check box is enabled, the plug-in will pass-through to the database the user name and password supplied by the user in the Remote Client. This requires the accounts used by DataSplice to have valid corresponding accounts in the database. This will usually cause the server to keep more connections to the database open, so it should only be used if a single connection account will not work for some reason.
Verify Connection
When this check box is enabled, upon saving the connection profile settings, DataSplice attempts to connect to the data source to ensure that the settings are correct. This is useful for saving profile settings when the database server is currently unavailable.

ADO.NET Drivers

Several different drivers are available to allow DataSplice to connect to various back-end databases. In practice the most important are

Microsoft SQL Server
This provider is installed with the .NET framework and uses native connections to ensure the highest performance and functionality available. If supports both SQL Server 2000 and SQL Server 2005.
Oracle ODP.NET 10/11
There are several options for connecting to Oracle, but the best choice is to use the latest version of ODP.NET. This driver supports database versions 8.1.7 through 11g and is available for download from Oracle's website.

Other drivers are available (MySql, DB2, etc) but are not enabled by default and cannot be guaranteed to support the range of functionality supported with SQL Server and Oracle.

 
Created by ron.rzepkowski
Last modified 2009-10-13 01:12 PM
 

Powered by Plone

This site conforms to the following standards: