Home : Products : Hach WIMS : Interfaces : Hach WIMS Direct Server-Side Interface to Narrow Format OLEDB Source : Documentation : Topics specific to the operation of this interface : Supported variable configurations for interface Q12160
Q12202 - HOWTO: Supported variable configurations for interface Q12160

Supported variable configurations for the Hach WIMS Direct Server-Side Interface to Narrow Format OLEDB Source.

To configure a variable to get values from a Narrow Format OLEDB source, select Edit/View Variables in the client and select the Interface tab.

Then click Interface To radio button. The drop down box next to the option is now enabled, click the drop down arrow and choose the Narrow Format OLEDB interface name (name given when configuring the interface).

Now you are ready to configure a tag from the Narrow Format OLEDB. The Tag name and a statistic are all that are mandatory.

  • TAG:  The identifier for the records to summarize for this variable.  Format is Tablename@@Tag.  The following example LOG@@Finish Water PH will query the Log table for the tag Finish Water PH.  Note, each table needs to be configured

Clicking on the question mark will bring up the following screen:

The above screen contains a list of all the available tags that the interface can gather data from. To pick a tag, double click on it and it will then take you back to the Edit Variable screen. If the above screen is blank then you need to make sure that you generated an OPSDATAXML definition file from the Source Configuration screen in the Interface.

  •  This is a listing of all the statistics supported by this interface. This includes the following statistics for a specified time period:

AVERAGE Take the average of the data points in the time period
TOTAL Take the sum total of all values in the specified time period
MINIMUM Take the minimum value in the specified time period
MAXIMUM Take the maximum value in the specified time period.
FIRST Take the first reading in the time period
LAST Take the last reading in the time period.
DIFF This statistic calculates the difference between the first value and the last value for the period requested (i.e., if the variable is defined as an hourly variable, DIFF will get the first and last values for each hour and subtract them)
RANGE This calculates the range of your values for a specified period. It calculates the difference between the minimum and maximum values for the period requested.
INVENTORY Returns the total use based on a tank level signal.  For example, the level is 10 feet at midnight and slowly goes down to 2 feet at 2:00PM then gets filled to 15 feet and slowly goes down to 8 feet at midnight.  The inventory function would return 15
TIMEEQ(x) Returns the number of minutes the value was equal than x (i.e. value specified in parentheses). Example TIMEEQ(5), returns number of minutes tag = 5.
TIMEGT(x) Returns the number of minutes the value was greater than x (i.e. value specified in parentheses). Example TIMEGT(5), returns number of minutes tag > 5.
TIMELT(x) Returns the number of minutes the value was less than n (i.e. value specified in parentheses). Example TIMELT(5), returns number of minutes tag < 5.
TWA Returns the Time Weighted Average.  Typically used when data is logged on change (not on a fixed frequency).  See Tech Notes for example.
MAXHOLD Returns the maximum value in the time range.  If no values are logged for the time range it will return the most recent value prior to the time range. 
MINHOLD Returns the minimum value in the time range. If no values are logged for the time range it will return the most recent value prior to the time range.
FIRSTHOLD Returns the first value in the time range. If no values are logged for the time range it will return the most recent value prior to the time range.
LASTHOLD Returns the last value in the time range. If no values are logged for the time range it will return the most recent value prior to the time range.

  •  This is the value to multiply the result by when using parameter variable types. Commonly used to convert from one unit base to another. For example to convert gallons per minute (GPM) to gallons per day (GPD), set the scale factor to 1440 (1440 minutes per day).

  •  All three fields must have numeric values or the word None (as shown). The Low Range and High Range will crop data from the source. For example to eliminate negative numbers from a particular tag, set the Low Range to 0 (zero) - this will get any values equal to or greater than 0 (zero). The Deadband is used for the statistic Inventory and will elliminate noise levels up to the value specified. For example, if you enter .5 next to Deadband, any value change of .5 or less, will be ignored.

    • Start Time will set the beginning of the time slot for this variable.
    • Stop Time will set the ending time for the time slot.
    • Same Day as Start is only used by daily variables and it means the stop time is on the same day as the start time.
    • Day After Start is also only used by daily variables and it means the stop time is a day after the start time.
    •  
      • Node Tag Field is the signal tag to filter by from the Narrow Format OLEDB. You can find tag names using the ? the same way you found the signal tag above.
      • The second field is the filter operator drop down. This includes the following:
        SYMBOL DESCRIPTION
        < Less than, true if the value returned is less than the filter value
        > Greater than, true if the value returned is greater than the filter value
        = Equal to, true if the value returned is equal to the filter value
        <= Less than or equal to, true if the value returned is less than or equal to the filter value
        >= Greater than or equal to, true if the value returned is greater than or equal to the filter vaue
        <> Not equal, true if the value returned is not equal to the filter value
      • The last field is the filter value. The value returned from the filter tag is compared to this value.

    NOTE: Filtering is ignored (not supported) for the following Statistics:

    • TIMEEQ, TIMEGT, TIMELT
    • TWA
    • MAXHOLD, MINHOLD
    • FIRSTHOLD, LASTHOLD
    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/12/2009 11:03 AM.
    Last Modified on 11/17/2014 4:05 PM.
    Last Modified by Scott Dorner.
    Article has been viewed 3570 times.
    Rated 5 out of 10 based on 3 votes.
    Print Article
    Email Article