Home : Products : Hach WIMS : Interfaces : Hach WIMS Indirect Server-Side Interface to Custom Q13073 CSV SCADA : Documentation : Topics specific to the operation of this interface : Configuration - Source Configuration Q13073
Q13083 - INFO: Configuration - Source Configuration Q13073

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

  • 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.

  • 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
  • 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 6/28/2010 2:18 PM.
Last Modified on 6/29/2010 2:51 PM.
Last Modified by No Author Name Available!.
Article has been viewed 2053 times.
Rated 0 out of 10 based on 0 votes.
Print Article
Email Article