Home : Configuration - Source Configuration Q13429
Q13435 - INFO: Configuration - Source Configuration Q13429

In order to configure the source connection from the interface, click Configuration and select Source Configuration.

The next screen will display parameters such as Data Source, UsernamePasswordConnection and Command Timeouts, and allow you to Test Connection. The Source Configuration screen has two tabs: one to setup the connection to the database and the other to define the table mappings/cross references.

Database Connection - Configure the settings needed to connect to your database

  • Configuration Template - no templates are currently defined. Choose 'User Defined' to setup a connection to your database.
  • Data Source - this field specifies, in loose terms, the "Database/Datasource server name" where your database system is configured to store data. "Database/Datasource server name" means different things depending on whether you are running against Oracle or MS SQL:
    • Oracle - you can type in either the Oracle TNS name or a string in the form of host:port/SID, if using the Oracle HOSTNAME adapter.
    • MS SQL - this is in the form of host\sql_instance_name
  • Database Name - the name of the database that you are connecting to.
  • DBMS Type -select the appropriate type of your Hach WIMS database
  • OLE DB Provider - this specifies which "database driver" the interface will use when connecting to your database and again depends on the database type:
    • Oracle - the default string should be fine
    • MS SQL - if connecting to MS SQL 2005 or later, use the native client to connect. Specify SQLNCLI as the provider. NOTE: You will need to have the Microsoft SQL Native Client installed for this to work. If connecting to MS SQL 2000, specify SQLOLEDB as the provider.
    • MS Access - add the full path and file name of the MS Access MDB file to Data Source
    • ODBC - need to create a System DSN (Data Source Name) to connect to MS Access-type database
  • Username - The username you want to use to connect to the database. This user should have permission to access the database and tables that contain data.
  • Password - The password that will be used to connect to the database
  • Connection Timeout in Seconds - how many seconds the program should wait when establishing a connection to the Hach WIMS database before aborting.
  • Command Timeout in Seconds - specifies how many seconds the program should wait for a query to complete before aborting the operation.
    WARNING: Large values for these two settings can cause the program to not respond for a long period of time! Do NOT use 0 unless you know what you are doing - it will cause the program to wait indefinitely, and if your database server is down, the only way to cancel the operation is to forcefully quit the program.
  • Customizations - this should be left empty unless you were told otherwise by a Hach Support Engineer or you know what you are doing.

Table Mappings - Allows you to tell the interface which fields in the database table contain the Date, Tag, Value and optionally Source. The interface needs to know which column in the table contains the date field, which column contains the tag, which column contains the value/data and if the tag is not unique then a table column that contains the source. The interface allows you to retrieve data from one or more tables. Each table that you configure needs to define the column mappings.

  • Select Table - Allows you to pick a table that you want to modify or test
  • Add Table - Adds another table that the interface can collect data from. You need to click 'Add Table' before beginning to type in your table mappings. When you click 'Add Table' it will create a table that you are then able to edit.
  • Remove Table - Removes the currently selected table
  • Narrow Table Format - The interface supports two types of table configurations: one with date, tag and value columns and one with date,source,tag and value columns. If your tag is unique across the system then choose date,tag, value. If your tag is not unique then choose date, surce, tag, value.
  • Table Name - The name of the database table that you are configuring
  • Table Owner/Schema - The database owner of the table that you are configuring. Typically, for sql, this is 'dbo'.
  • [DATE] Column Name - The name of the column that contains the date/time
  • [TAG] Column Name - The name of the column that contains the tag/variable/identifier
  • [VALUE] Column Name - The name of the column that contains the value/data
  • [SOURCE] Column Name - The name of the column that contains the source. Only available if you chose the Table Format: data, source, tag, value
  • [BUTTON] Generate OPSDATAXML Definition File to use with Browser in Hach WIMS Client - After you have configured the tables you want the interface to connect to you need to click this button. Clicking the button allows you to generate an XML file that the Hach WIMS client uses when you configure your variables. This file will contain a list of the available tags in the tables that you defned.
  • [BUTTON] Test Mappings - This button allows you to test your settings and to see if the interface is able to get data from the table mapping that you defined.

Advanced - Allows you tweak advanced configuration parameters

  • Connection Alive Test Strategy - Allows you to pick what query the interface should run against source. The default (Test with SELECT TOP ROW Query) behavior is valid for most cases other than when using database views instead of tables. In case of views, you may need to select Test with GET DATE TIME Query
Related Articles
No Related Articles Available.

Article Attachments
No Attachments Available.

Related External Links
No Related Links Available.
Help us improve this article...
What did you think of this article?

poor 
1
2
3
4
5
6
7
8
9
10

 excellent
Tell us why you rated the content this way. (optional)
 
Approved Comments...
No user comments available for this article.
Created on 5/23/2011 10:55 AM.
Last Modified on 5/23/2011 11:47 AM.
Last Modified by No Author Name Available!.
Article has been viewed 2368 times.
Rated 0 out of 10 based on 0 votes.
Print Article
Email Article