Server Reference Guide - Wizconsupport.wizcon.com/Data/Wizcon Supervisor/WizReport... · Setting up DeltaV ... an OPC Server name and the name of a tag. The syntax is: Name

Server Reference Guide

Version 7.00

Information in this document is subject to change without notice. WizCon or SyTech assumes no responsibility for any errors or omissions that may be in this document. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the prior written permission of WizCon or SyTech WizReportTM XL is a trademark of Wizcon Systems SAS. WizReportTM XL is based on XLReporterTM from SyTech, Inc. Copyright 2000 - 2006 SyTech, Inc. All rights reserved. XLReporter and XLR are trademarks of SyTech, Inc. Microsoft® is a registered trademark of Microsoft, Inc. All registered names are the property of their respective owners..

Contents

Wizcon Systems - Wizcon 9 Overview....................................................................................................................................9 Setting up Wizcon......................................................................................................................9 Real Time Data ..........................................................................................................................9

OPC Tag Names ..........................................................................................................9 OPC Tag Browser........................................................................................................9

History Group ............................................................................................................................9 Main Dialog...............................................................................................................10 Select History Group Dialog......................................................................................10 History Group Dialog ................................................................................................11 Columns Tab..............................................................................................................11 Time Period Tab ........................................................................................................13

History Data Quality ................................................................................................................15 Database Group........................................................................................................................15

Connecting to the Database .......................................................................................15 Alarm and Event Data..............................................................................................................15 Accessing Remote Data ...........................................................................................................15

Real Time ..................................................................................................................15 Historical ...................................................................................................................15

GE Fanuc Proficy – FIX and iFIX 16 Overview..................................................................................................................................16 Setting up FIX and iFIX...........................................................................................................16 Real Time Data ........................................................................................................................16 History Group ..........................................................................................................................17

Main Dialog...............................................................................................................17 History Group Dialog ................................................................................................17 Columns Tab..............................................................................................................17 Time Period Tab ........................................................................................................19

Database Group........................................................................................................................21 Alarms and Event Data ............................................................................................................21 Remote Data Access ................................................................................................................21


Starting the Scheduler ..............................................................................................................22 Using the WizReport XL Programming Interface ...................................................................22

Issuing Commands from iFIX ...................................................................................22 Issuing Commands from FIX ....................................................................................22

Troubleshooting .......................................................................................................................22

GE Fanuc - Proficy Historian 23

Overview..................................................................................................................................23 History Group ............................................................................................................23 Database Group..........................................................................................................23

Setting up Proficy Historian.....................................................................................................24 History Group ..........................................................................................................................24

Main Dialog ...............................................................................................................24 History Group Type Dialog .......................................................................................24 History Group Dialog ................................................................................................25 Setup Tab ...................................................................................................................26 Columns Tab..............................................................................................................26 Time Period Tab ........................................................................................................29 Filters Tab – Raw and Calculated Values ..................................................................30 Filters Tab -Sampled Values......................................................................................32 Order Tab...................................................................................................................34

Database Group........................................................................................................................35 Connecting to the Proficy Historian Server ...............................................................35

Accessing Remote Data ...........................................................................................................35 Troubleshooting .......................................................................................................................35

Rockwell Software - RSLinx 36 Overview..................................................................................................................................36 Setting up RSLinx ....................................................................................................................36

RSLinx configuration for OPC ..................................................................................36 Real Time Data ........................................................................................................................36

OPC Tag Browsing ....................................................................................................36 Tag Name Syntax.......................................................................................................37

Remote Data Access ................................................................................................................37 Troubleshooting .......................................................................................................................37

Rockwell Software - RSView 38 Overview..................................................................................................................................38 Setting up RSView32...............................................................................................................38

Enabling the OPC Server ...........................................................................................38 Real Time Write Access ............................................................................................39 Configuring a Data Log Model..................................................................................39 Alarm Log and Activities Log ...................................................................................39

Real Time Data ........................................................................................................................39 History Group ..........................................................................................................................39

Main Dialog ...............................................................................................................39 History Group Type Dialog .......................................................................................40 History Group Dialog ................................................................................................41 Setup Tab ...................................................................................................................41 Columns Tab..............................................................................................................42 Time Period Tab ........................................................................................................44 Filters Tab –Calculated Values, Raw Values and Raw Text .....................................46 Filter Tab –Alarms and Activities..............................................................................47 Order Tab...................................................................................................................48

Database Group........................................................................................................................49 Accessing Remote Data ...........................................................................................................50

Real Time...................................................................................................................50

Historical ...................................................................................................................50 Starting the Scheduler ..............................................................................................................50 Using the WizReport XL Programming Interface ...................................................................50

Emerson Process - DeltaV 51 Overview..................................................................................................................................51 Setting up DeltaV.....................................................................................................................51

Remote OPC and OPC HDA Connections ................................................................51 OSI-PI History...........................................................................................................52

Real Time Data ........................................................................................................................52 Application Station ....................................................................................................52 Pro Plus Station..........................................................................................................52

History Group - OSI-PI............................................................................................................53 Main Dialog...............................................................................................................53 History Group Dialog ................................................................................................54 Columns Tab..............................................................................................................54 Time Period Tab ........................................................................................................55

History Group – OPC-HDA.....................................................................................................57 Setup Tab...................................................................................................................57 Columns Tab..............................................................................................................57

Database Group........................................................................................................................58 Accessing Remote Data ...........................................................................................................58


Starting the Scheduler ..............................................................................................................58 Using the WizReport XL Programming Interface ...................................................................58

Issuing Commands from Delta V versions with iFIX................................................59 Issuing Commands from Delta V versions with FIX.................................................59

OPC-HDA Servers 60 Overview..................................................................................................................................60 History Group ..........................................................................................................................60

Main Dialog...............................................................................................................60 History Group Type Dialog .......................................................................................60 History Group Dialog ................................................................................................61 Setup Tab...................................................................................................................62 Columns Tab..............................................................................................................62 Time Period Tab ........................................................................................................65

Retrieving Raw Values ............................................................................................................67 Adding to the History Group Mode List ..................................................................................67 Remote Data Access ................................................................................................................67

OPC Servers 68 Overview..................................................................................................................................68 Real Time Data ........................................................................................................................68

OPC Tag Names ........................................................................................................68 OPC Tag Browser......................................................................................................68

Remote Data Access ................................................................................................................69

Wonderware - InTouch 71 Overview..................................................................................................................................71 Setting up InTouch...................................................................................................................71

Configuration Settings ...............................................................................................71 Histdata.EXE .............................................................................................................71

Real Time Data ........................................................................................................................71 History Group ..........................................................................................................................72

Main Dialog ...............................................................................................................72 History Group Dialog ................................................................................................72 Columns Tab..............................................................................................................73 Time Period Tab ........................................................................................................75

Accessing Remote Data ...........................................................................................................76 Real Time...................................................................................................................76 Historical....................................................................................................................76

Starting the Scheduler ..............................................................................................................76 Using the WizReport XL Programming Interface....................................................................76 Troubleshooting .......................................................................................................................77

Wonderware - Industrial SQL Server 78 Overview..................................................................................................................................78 Setting up InSQL......................................................................................................................78

Connecting to Summary Tables from InSQL ............................................................78 History Group ..........................................................................................................................79

Main Dialog ...............................................................................................................79 History Group Type Dialog .......................................................................................79 History Group Dialog ................................................................................................80 Setup Tab ...................................................................................................................80 Columns Tab..............................................................................................................81 Time Period Tab ........................................................................................................83 Retrieval Tab..............................................................................................................85 Filters Tab..................................................................................................................87

Adding Summary Custom Durations .......................................................................................88 Database Group........................................................................................................................88

Connecting to the InSQL Server................................................................................88 Considerations for Configuring a Database Group ....................................................88

Intech Instruments - MicroScan2000 90 Overview..................................................................................................................................90 Setting up MicroScan...............................................................................................................90 Real Time Data ........................................................................................................................90

Tag Browser...............................................................................................................90

Using Cell References in History Groups 92 Overview..................................................................................................................................92 Cell Reference Format .............................................................................................................92 Cell References for Date and Time ..........................................................................................92 The Iterator...............................................................................................................................92

Using Variables in History Groups 95

Overview..................................................................................................................................95 Variable Format .......................................................................................................................95 Variable Usage.........................................................................................................................95

Register Functions .....................................................................................................95 DateTime Functions...................................................................................................95

Server Reference Guide Wizcon Systems - Wizcon •••• 9

Wizcon Systems - Wizcon

Overview Wizcon provides a number of data sources for reporting:

Real-time data using OPC Real time data access is by the standard OPC interface. Historical data using the native interface Historical data is accessed from the local historian. Historical data using the Database interface Historical data can be accessed from a relational database.

Setting up Wizcon No setup is required.

Real Time Data Real Time data is accessed through the OPC Server provided with Wizcon.

OPC Tag Names In %Product%, the full specification of an OPC tag name consists of a node (if the tag is from a remote node), an OPC Server name and the name of a tag. The syntax is:

<<Node>><Server>Name The <<Node>> is not required if the OPC Server is local. Real time connections defined in the Connection Configurator (see the User Reference Guide) only display the Name, after the tag has been selected from the OPC tag browser. However, by hovering over the tag, a tool tip will appear showing full name in the format shown above, e.g., <<>><Axeda.OPCDA.1>System000000.WIZSYS_DATE.

OPC Tag Browser See the OPC chapter for more information

History Group History Groups are the interface for extracting information from a History Server. Groups can be defined for raw values as well as calculations. In both cases, the group is configured with a time duration (span) over which the history data is retrieved.

10 •••• Wizcon Systems - Wizcon Server Reference Guide

In the case of calculations, an interval is also specified which defines the calculations. The calculation is repeated for each interval in the time duration. For example, if the time duration (span) is one day, and the interval is one hour, then the group calculation is performed 24 times, once for each hour of the day.

Main Dialog The History Group is opened by right-clicking and the History Groups folder in the Project Explorer. It can also be opened in the Connection Configurator by setting the Source Type to History Group and clicking the browse button. Content

Configured Displays a list of all the configured history groups.

Controls New Configure a new history group. Modify Modify the selected history group. Delete Delete the selected history group.

Select History Group Dialog Opened by clicking New in the Main dialog. The dialog is used to select the type of history group required.

The history group type determines the type of data retrieved from the History Server when the group is used for retrieval. Content

Raw Values Raw numeric values, as stored in the Historical Server. Sampled Values Sampled values or interpolated values. Returns sampled values at the interval specified. Calculated Values Calculated values from raw samples in the Server over the interval; specified.. Calculations such as, average, total, maximum, minimum, etc., are provided. Raw Text Raw text values, as stored in the Historical Server.


History Group Dialog Opened by clicking OK from the Select History Group dialog or by clicking Modify from the Main dialog. Content

Name The name of the history group.

Controls OK Saves the History Group configuration a file with extension GRP. Preview Displays a preview of the output of the History Group.

Columns Tab The Columns tab shows the server tags that have been selected for the group, along with other settings. Each selected tag will produce a column in the output of the group.

Content

Selected Columns Name The list of tags configured for the group. Selecting this column brings up the historical tag browser for tag selection. The name can also be a cell reference, a variable or left blank. In the case of a blank name, the output column will also be blank. For more information, see the chapters on Using Variables in History Groups and Using Cell References in History Groups. Mode Defines the calculation to apply to the selected Name. All calculations are performed over an interval specified in the Time Period tab. The following modes are supported:


Interpolated The raw value at the beginning of the interval. Average The arithmetic mean. Maximum The maximum value. Time of Maximum The date and time when the maximum occurred. Minimum The minimum value. Time of Minimum The date and time when the minimum occurred.

Heading Displays a heading for each row configured that will be displayed in the output when the Custom setting under Headings is used. The heading can be text, a cell reference or a variable. For more information, see the chapters on Using Variables in History Groups and Using Cell References in History Groups.

Layout Automatically adjust column widths If checked, the output columns are adjusted based on their content. Empty rows between records Determines the row spacing between the resulting output rows i.e., the number of blank rows. The default is 0 to indicate no row spacing.

Column Options Timestamp on first column The leftmost column is displayed with a time stamp. Timestamp on all columns All the columns are displayed with a time stamp. Timestamp, quality on all columns All the columns are displayed with a time stamp and quality indicator.

Headings None Headings will not displayed. Custom The Headings configured for each column will be displayed in the top row of the output.


Time Period Tab The Time Period and Interval settings are configured to define how the historical data retrieval is performed.

Content

Time Period Start Time The start of the time period over which to retrieve historical values. The following modes are available:

Now The Start Time is the current date and time minus the specified Offset. Today The Start Time is the current date minus the specified Offset with a specific Time. Specific The Start Time is the specific Date and Time set. Variable The Start Time is set from the values of the variables specified for the Date and Time. For more information, see the Using Variables in History Groups chapter. Cell The Start Time is set from the values in Excel cells specified for the Date and Time. For more information, see the Using Cell References in History Groups chapter.

End Time The end of the time period over which to retrieve historical values. See the Start Time.

Interval The Start Time and End time determine the time period (span) of the group. The Interval defines how the period is divided into intervals, and what the size of each interval is. The following choices are available.


Number of samples Determines the number of values in the output. In the case of calculations, the calculation is performed over the samples from the derived interval. All samples All the values between the Start Time and End Time are output. Not applicable to calculations Sample values every Divides the time between Start Time and End Time in intervals based on the number of minutes, hours or days specified. Not applicable to raw values.

Time Ordering Specifies how the data values are returned. Choices are:

Ascending Oldest to newest from top to bottom. Descending Newest to oldest from top to bottom.

Bounds to include Specifies which boundary values to include in the output of the group. Boundary values are the first value before the Start Time or the first value after the End Time.

None No boundary values are included in the output of the group. Previous The first value before the Start Time is included in the output of the group. Next The first value after the Start End is included in the output of the group. Previous and Next Both the value before the Start Time and value after the End Time is included in the output of the group.

Endpoints to include Specifies which endpoint values to include in the output of the group. Endpoint values are those that occur at the Start Time and the End Time.

None No endpoint values are included in the output of the group. Start Time The value at the Start Time is included in the output of the group. End Time The value at the End Time is included in the output of the group. Start and End Time Both the values at the Start Time and End Time are included in the output of the group.


History Data Quality Quality is associated with data values in the Server and can be included in the output of the group by selection from the Columns tab. Quality is a measure of the reliability of the data. The following values are returned for quality: Good The value is of good quality. Suspect This is associated with calculations. The value of suspect quality means that some, but not all of the samples contributing to a calculation have bad quality. Bad The value is of bad quality. For calculated values, this means that all the samples contributing to the calculation have bad quality. No Value The value cannot be calculated because there are no samples in the interval. The value is shown as “!!!”.

Database Group Data stored in a relational database can be accessed using Database Groups (see the User Reference Guide). A Database Group provides a host of calculations and sub calculations. Database Groups can also be used by the Layout Expert to design very sophisticated reports. To set up Historical data logging in Wizcon, you first enable ODBC Connections in the Wizcon Application Studio.

Connecting to the Database The connection to the Wizcon historical database is done as part of the definition of a Database Group (see the User Reference for more information).

Alarm and Event Data Alarm and event data is accessed using a database group.

Accessing Remote Data

Real Time Wizcon Real Time data can be accessed with remote OPC access. This may require DCOM settings of the Wizcon Server to be opened up. See the Remote Data Access section of the OPC Chapter.

Historical Not supported with Wizcon.

16 •••• GE Fanuc Proficy – FIX and iFIX Server Reference Guide

GE Fanuc Proficy – FIX and iFIX

Overview FIX and iFIX provide a number of data sources for reporting:

Real-time data using the FIX and iFIX native interface Real time data access is by the native interface. Historical data using the FIX and iFIX native interface Historical data is accessed from the classic historian. Historical data using the Database interface Alarm logs, event logs and custom data can be accessed from a relational database.

Setting up FIX and iFIX No setup is required.

Real Time Data Real Time data is accessed through a native interface with iFIX. Real-time connections to the iFIX database are configured in the Connection Configurator. Select Real Time as the Type. Specify the tag name or click the browse button for Name.

The tag browser shows all available tags. Note that iFIX must be running to allow tag browsing. Select your tag and complete the configuration of this connection.

Server Reference Guide GE Fanuc Proficy – FIX and iFIX •••• 17

History Group

Main Dialog Opened by right-clicking the History Groups folder in the Project Explorer. Also opened in the Connection Configurator by clicking the browse button when the Type setting under Source is set to History Group. Content

Configured A list of all the configured history groups of the project.

Controls New Opens the Group Builder to configure a new history group. Modify Opens the Group Builder loading it with the settings of the selected history group. Delete Deletes the selected history group. OK Closes the application and returns the name of the selected history group. Cancel Closes the application without returning the name of the selected query.

History Group Dialog Opened by clicking OK from the Select History Group dialog or by clicking Modify from the History Group dialog. Content

Name The name of the history group configured.

Controls OK Saves the configuration and closes the application. Cancel Closes the application without saving.

Columns Tab The Columns tab presents the configuration settings for each column of the History Group. The tag names and calculation modes are specified in this menu.


Content

Selected Columns Name The Name of the tag to retrieve data for. Selecting a field under this column brings up the historical tag browser for tag selection. Mode Defines the calculation to apply to the selected Name. All calculations are performed over a time interval or series of time intervals. The following are supported:

Average The arithmetic mean of all sample values over the interval Maximum The highest value recorded over the interval Minimum The lowest value recorded over the interval. Sample The calculated sample value at the beginning of the interval. Manual The manual value stored at the beginning of the interval. Accumulation The accumulated total of the Interval samples. Difference The calculated difference between the end value and the start value of the Interval. Acc. Difference The accumulated total of the difference calculated over the Interval, i.e., the difference between the start of the span and the end of each interval.


Column Value The value will be returned. Date + value The timestamp and value will be returned. Value + quality The value and quality will be returned. Date + value + quality The timestamp, value and quality will be returned.

Heading Sets specific headings for each Name selected.

Layout Adjust data placement Automatically adjusts the Accumulate, Difference or Accumulated Difference values returned by the group so that they match the time frames consistent with the other calculations in the group.

Connection Defines the path to the historical data files.

Default When checked, the path to the historical data files will be the default path defined in the System Configuration of iFIX.

Headings None Headings will not be returned as part of the history group. Custom The Headings configured for each selected column will be returned as the top row from the history group.



Content


Now When the history group is updated, the Start Time will be calculated as the current date and time minus the specified Offset. Today When the history group is updated, the Start Time will be calculated as the current date minus the specified Offset with the Time being what is specified. Specific When the history group is updated, the Start Time will be the specific Date and Time set. Variable When the history group is updated, the Start Time will be the values of the variables specified for the Date and Time. For more information, see the Using Variables in History Groups chapter.

Span The overall time period over which to retrieve historical values. The following modes are available:

Specific When the history group is updated, the Span will be the specific Duration set in minutes, hours or days. Variable When the history group is updated, the Span will be the value of the variable specified. Note, the variable must be set in the format “DD:hh:mm:ss”. For more information, see the Using Variables in History Groups chapter.


Interval Defines how the time period is to be divided in intervals, and what the size of each interval is. The following choices are available:

Sample values every Divides the total time span between Start Time and End Time in intervals based on the number of minutes, hours or days specified. Number of samples The value entered divides the total time span between Start Time and End Time in equal intervals.

Defining the interval to be a divider of the total time span causes the history group to return multiple values. For instance, if the Span is 1 day, and the interval is specified as 1 hour, the history group returns 24 rows of calculated values.

Database Group The database connection allows you access to relational (ODBC) databases as well as OLE-DB Providers such as Proficy Historian. The Alarms and Events log of iFIX can be collected in either a relational database or in the Proficy Historian. Alarm and Event data can be queried and filtered in many ways, as they contain many fields to filter on. In the Reference Guide, refer to the Configuring a Database Query chapter, for detailed information on the use of the Database connection. For information on connecting to the Proficy Historian, see the Proficy Historian chapter of this manual.

Alarms and Event Data iFIX can store its alarm and event data either in a relational (ODBC complaint) database or in the Proficy Historian. Using either method, data can easily be retrieved via a Database Group connection.

Remote Data Access

Real Time With version 3.5 and higher of iFIX you may use an OPC connection to retrieve data from a remote iFIX database. Install WizReport XL for OPC. When configuring your report, open the Tag Browser, specify the Node and click Connect. Select Intellution.OPCiFIX.1 as the Server. You should now be able to browse all the tags available from that node.

Historical iFIX classic historian data can be retrieved from a remote station. A local installation of iFIX is required, however the iFIX system does not need to be licensed. In the History Group configuration, specify the Connection path, e.g., “\\Scada1\c\dynamics\htrdata”, to point to the location of the data. If the local iFIX is not licensed, tag browsing is disabled, but you can manually enter the tag names for all the tags required in the History Group.


It is recommended that if you wish to access remote historical data that you use the Windows OS to network map to the directory where that historical data is logged on the remote machine.

Starting the Scheduler The Report Scheduler can be included in the startup configuration to automatically start up when iFIX or FIX starts. Start the System Configuration Utility (SCU) and select CONFIGURE /TASKS. Add program XLRschedule.exe to the list of tasks.

Using the WizReport XL Programming Interface A complete programming interface is provided with WizReport XL. Using this interface it is possible to issue any command provided to produce a report from a FIX or iFIX display. For more information on the commands supported, see the Commands chapter of the WizReport XL Reference Guide.

Issuing Commands from iFIX Using the Visual Basic for Applications environment provided with iFIX, any report command can be executed using the following syntax: Call Shell XLRrequest “Command ‘Parameter 1’ ‘Parameter2’” For more information on issuing commands from a Visual Basic environment, see the Programming Interface chapter of the WizReport XL Reference Guide.

Issuing Commands from FIX In the scripting environment of FIX, any report command can be executed using the RUNTASK command using the following syntax: RUNTASK XLRrequest “Command ‘Parameter 1’ ‘Parameter 2’”

Troubleshooting If you are experiencing issues when browsing Real Time tags or retrieving Real Time values, it may be because multiple copies of dlls provided by iFIX or FIX have been installed. To remedy the problem, search the machine for “eda.dll”. There should only be 1 copy of this file and it should be located in the installation directory of the iFIX or FIX system.

Server Reference Guide GE Fanuc - Proficy Historian •••• 23

GE Fanuc - Proficy Historian

Overview Proficy Historian (formerly iHistorian) is a historical data server. With WizReport XL you can access data one or more Proficy Historian servers simultaneously. Two methods of retrieving data from Proficy Historian are provided, either a History Group or a Database Group. A description of each is as follows.

History Group A History Group is designed specifically for Proficy Historian to provide an easy to use interface that simplifies data retrieval. The user performs the configuration without any custom scripting or programming. A History Group represents a selection of tags together with their attributes. In addition, the group contains information such as time period, filters and calculation modes. When executed, a history group returns a table of values over the configured time period. When associated with a cell in a report, this table is placed with its upper left value in the specified cell. The types of data that can be retrieved are as follows:

• Live values. • Raw values. • Sampled values. • Calculated values, such as Average, Min, Max, etc., over time intervals.

Database Group A Database Group (see Database Group chapter in the User Reference Guide) is designed for any relational database (including the OLE DB interface of Proficy Historian) to provide an easy to use interface that simplifies data retrieval. The user performs the configuration without any custom scripting or programming. Using a database group, the user has greatly flexibility in how data is accessed but will need to know more detail on how the Proficy Historian database is organized. When executed, a database group returns a table of values over the configured time period. When associated with a cell in a report, this table is placed with its upper left value in the specified cell. One advantage of using a database group is that Layouts (see Layout chapter in the User Reference Guide) can be used. With Layouts, full control over every aspect of the final report, from formatting and data placement to Excel charting and formulas, is possible.

24 •••• GE Fanuc - Proficy Historian Server Reference Guide

Setting up Proficy Historian In order to access Proficy Historian from a Local or Remote node, you must install the following from GE Fanuc:

• Proficy Historian Client Tools: These tools are available from the Proficy Historian installation CD. When you run the installation CD, check the Client Tools option.

• Proficy Historian OLE DB Provider: This is provided on CD from GE Fanuc to provide access to the Proficy Historian data through its OLE DB interface.

History Group




History Group Type Dialog Opened by clicking New in the History Group dialog.


Content Live Values This group retrieves the most current sample values collected by Proficy Historian. Raw Values Raw values as stored in the historical database are retrieved. Sampled Values Calculated sample values derived from stored samples in the database are retrieved. Calculated Values Aggregate values, calculated from the stored samples in the database are retrieved. Aggregates such as, average, total, maximum, minimum, etc., are provided.

Controls OK Opens the Group Builder based on the type selected. Cancel Returns to the Group Builder.



Controls OK Saves the configuration and closes the application. Preview Executes the currently configured history group displaying the results. Cancel Closes the application without saving.


Setup Tab

Content

Connection Server The name of the Server to connect to. If left blank, the default Server specified when installing the Proficy Historian Client Tools is used. User ID The User ID to connect to the Server. Password The Password of the User ID to connect to the Server. Quality Threshold % A percentage, by which the quality percentage of the calculated value retrieved must meet or exceed in order to write it in the report. Calculated values that do not reach this quality threshold appear as bad values (“BADQ”) in the report.

Controls Connect Connects to the Proficy Historian server based on the Connection settings.



Content

Selected Columns Name The Name of the tag to retrieve data for. Selecting a field under this column brings up the historical tag browser for tag selection. This can be a specific tag, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter. Mode Defines the calculation to apply to the selected Name. All calculations are performed over a time interval or series of time intervals. The following are supported:

Interpolated The calculated sample at the beginning of the interval. Count The sample count over the interval. Average The time-weighted arithmetic mean of all sample values over the interval Maximum The highest value recorded over the interval Time of Maximum The date/time when the maximum occurred over the interval. Minimum The lowest value recorded over the interval. Time of Minimum The date/time when the minimum occurred over the interval. Standard dev. The square root of the arithmetic mean of deviations from the time-weighted arithmetic mean of all the values over the Interval.


Total The time-weighted total of all the values in the group over the Interval. Note that Engineering Units are assumed to be in Units/Day. If the Engineering Units were not measured in Units/Day, the total must be scaled to the actual time units of the measurement. Lab samples A computed intermediate value between two data points by using the last actual value over the Interval. This type of sampling displays as a stair step type of curve. Raw average The non-weighted arithmetic mean of all values over the Interval. Raw standard dev. The square root of the arithmetic mean of deviations from the non-weighted arithmetic mean of all the values over the Interval. Raw total The non-weighted total of all values over the Interval.

Column .value The value of the selected tag will be returned. .quality The quality of the selected tag will be returned.

Heading Sets specific headings for each Name selected. This can be a text, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter.

Layout Automatically adjust column widths If checked, each column is made as wide as the widest value in the column. Empty rows between records Controls the number of blank rows between each returned row. The default is 0, meaning all rows are packed.

Output Do not display duplicate records When checked, only unique records will be returned from the server. Show Time Stamp in report When checked, the left-most column returned from the server will contain the timestamp.




Content


Now When the history group is updated, the Start Time will be calculated as the current date and time minus the specified Offset. Today When the history group is updated, the Start Time will be calculated as the current date minus the specified Offset with the Time being what is specified. Specific When the history group is updated, the Start Time will be the specific Date and Time set. Variable When the history group is updated, the Start Time will be the values of the variables specified for the Date and Time. For more information, see the Using Variables in History Groups chapter. Cell When the history group is updated, the Start Time will be the values of the Excel cells specified for the Date and Time. For more information, see the Using Cell References in History Groups chapter.

End Time The end of the time period over which to retrieve historical values. The modes available are the same as the Start Time.



Number of samples The value entered divides the total time span between Start Time and End Time in equal intervals. All samples Every value between Start Time and End Time is returned. Sample values every Divides the total time span between Start Time and End Time in intervals based on the number of minutes, hours or days specified.

Defining the interval to be a divider of the total time span causes the history group to return multiple values. For instance, if the span between the specified Start and End time is 1 day, and the interval is specified as 1 hour, the history group returns 24 rows of calculated values. Time Ordering Specifies how the data values are returned. Choices are:


Endpoints to exclude None The values recorded at the Start Time and End Time will be retrieved as part of the history group. Start Time The value recorded at the Start Time will not be retrieved as part of the history group. End Time The value recorded at the End Time will not be retrieved as part of the history group. Start and End Time Neither the value recorded at the Start Time nor the End Time will be retrieved as part of the history group.

Controls No Time Period When checked, disables all Time settings.

Filters Tab – Raw and Calculated Values The Calculated Values group, and the Raw values group support a filter tab, in which the Proficy Historian Filter Tag is supported. For in-depth information on the Proficy Historian Filter Tag, please refer to the Proficy Historian OLE DB Provider documentation.


Content

Filter Condition Filter Tag The name of the tag that is used in the filter. A tag browser has been provided. This can be a specific tag, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter. Filter Mode

Exact Time Retrieves data for the exact times that the filter condition is true. Before Time Retrieves data from the time of the last False filter condition up until the time of the True condition. After Time Retrieves data from the time of the True filter condition up until the time of the next False condition. Before and After Time Retrieves data from the time of the last False filter condition up until the time of the next False condition.

Filter Condition Equal Filter condition is True when the value of the filter tag is equal to the filter value. Equal First Filter condition is True when the value of the filter tag is equal to the first filter value. Equal Last Filter condition is True when the value of the filter tag is equal to the last filter value.


Not Equal Filter condition is True when the value of the filter tag is NOT equal to the filter value. Less Than Filter condition is True when the value of the filter tag is less than the filter value. Less Than Equal Filter condition is True when the value of the filter tag is less than or equal to the filter value. Greater Than Filter condition is True when the value of the filter tag is greater than the filter value. Greater Than Equal Filter condition is True when the value of the filter tag is greater than or equal to the filter value.

Value The value that the Filter Tag is tested against. This can be a number, text, a cell reference or a variable. Note that single quotes are required text values; even if a text is retrieved from a cell reference, single quotes need to be applied. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter.

Filters Tab -Sampled Values The Sampled Values history group type provides a different filter tab. This group type supports filtering with multiple filter tags and conditions. The filter tab supports up to 12 filter conditions to be applied to the History Group. Conditions may be “anded” or “orred” to get the desired filter effect.


Content Selected Filters

A/O The A/O setting stands for And/Or. This setting forms the logical connection between two filter conditions, specifically, between the filter condition and the condition on the line above it. The following are available:

AND Logically “ands” two conditions. Both conditions have to be true to retrieve data. OR Logically “ors” two conditions. One of the conditions has to be true to retrieve data. )AND( Logically “ands” two condition groups. Both condition groups have to be true to retrieve data. The parenthesis combines the conditions above this row in a group and “ands” the combined result with the condition group starting at this row. )OR( Logically “or” two condition groups. One of the condition groups has to be true to retrieve data. The parenthesis combines the conditions above this row in a group and “ors” the combined result with the condition group starting at this row.

Column Name of the tag to be used in the filter condition. Selecting a field under this column brings up the historical tag browser for tag selection. This can be a specific tag, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter. Type

.value The value of the selected tag will be returned. .quality The quality of the selected tag will be returned.

Condition The condition describes the relationship between the value of the tag and the entered value. Choose from “=”, “<>”, “>”, “>=”, “<”, “<=”, “LIKE”, and “NOT LIKE”. The “LIKE” and “NOT LIKE” are used for text comparisons where an approximate match is needed. Value The value to compare the tag against. This can be a number, text, a cell reference or a variable. Note that single quotes are required text values; even if a text is retrieved from a cell reference, single quotes need to be applied. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter.

Filter Conditions The completed filter statement that will be submitted to the server.


Order Tab Controls how the returned data is ordered. Typically, the data is ordered by time stamp, either ascending or descending. But, it can also order by any of the tags configured in the Columns tab.

Content

Order By Column Name of the tag to order by. Selecting a field under this column brings up the historical tag browser for tag selection. This can be a specific tag, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter. Order

Ascending Historical data will be ordered from smallest to largest based on the Column specified. Descending Historical data will be ordered from largest to smallest based on the Column specified.

Order By Conditions The completed order by statement that will be submitted to the server.


Database Group The Database Group allows you access to OLE DB databases such as Proficy Historian. The Proficy Historian server provides many tables from which you can query data. For more information on the tables available in the Proficy Historian server and Proficy Historian query syntax, please see the Proficy Historian OLE DB Provider documentation.

Connecting to the Proficy Historian Server To connect to the Proficy Historian server in the Database Query Builder, under the Setup tab, click New Connect. This opens the Data Link Properties Window. Under OLE DB Provider(s), select the iHistorian OLE DB Provider. Click Next. In the Connection tab, for Data Source, specify the name of your Proficy Historian server. If the server requires it, specify the User name and Password, otherwise leave Blank password checked. Please note that if you do specify a User name and Password, you must check Allow saving password. Click Test Connection to make sure you can successfully connect to your server. Click OK. All the tables available in your Proficy Historian server are now listed allowing you to select and configure a query.

Accessing Remote Data Using both the History Group and Database Group, data can be retrieved from any Proficy Historian server located on the network. From the History Group, specify the Proficy Historian server you wish to retrieve data from as part of the Connection tab. From the Database Group, specify the Proficy Historian server you wish to retrieve data from as part of the Database Connection. Please note, you may be required to provide a user name and password in order to connect with the server. For more information, see the manuals provided with Proficy Historian.

Troubleshooting Proficy Historian provides the Historian Interactive SQL program as part of its Client Tools. Using this program, you can submit queries directly to Proficy Historian. If you are experiencing issues with the History Groups or Database Queries configured, use this tool to both confirm connection to the Proficy Historian Server and data retrieval.

36 •••• Rockwell Software - RSLinx Server Reference Guide

Rockwell Software - RSLinx

Overview RSLinx provides a data source for reporting:

Real-time data using the OPC interface Real time data access is by the native interface.

Setting up RSLinx RSLinx is available in a number of versions:

• RSLinx Lite does NOT include OPC support and CANNOT BE USED. • RSLinx Single Node (incl. OPC support) • RSLinx OEM (incl. OPC support) • RSLinx Professional (incl. OPC support) • RSLinx Gateway (incl. OPC support)

RSLinx configuration for OPC In order for an OPC Client to exchange data with RSLinx, first a TOPIC has to be configured in RSLinx. Please refer to the RSLinx documentation.

Real Time Data

OPC Tag Browsing In the tag browser you first select the Server combo box and then select the Server name. For RSLinx, the following Servers are available: RSLinx OPC Server (RSLinx OEM, Professional, Single Node and Gateway) RSLinx Remote OPC Server (used with RSLinx Gateway only) Select the server. Then, in the tag browser select the topic; this gives two new choices: On Line and Off Line. Off Line provides you with the tag symbols that are stored in the Symbol File, while On Line shows all tag names that are retrieved from the “live” PLC. Typically, you select On Line. Then select your tag and press OK

Server Reference Guide Rockwell Software - RSLinx •••• 37

Tag Name Syntax The format of an RSLinx OPC tag name is: <<Node>><Server>[Topic]Tag where the Node is not required if the server is on the local machine. In the Connection Configurator, just the [Topic]Tag appears when you select a tag for the Name field. Hover over that tag name with your mouse and a tool tip appears showing you the full name of the tag, e.g., “<RSLinx OPS Server>[MyTopic]N7:1”. Always use the tag browser to select a tag name, do not enter tag names manually.

Remote Data Access RSLinx Gateway supports OPC connectivity for local and remote clients. In other words, the OPC client does not have to reside on the same PC as the OPC Server. Configure the Remote Node name in the Node field of the tag browser and select from the Server list: RSLinx Remote OPC Server Along with complete remote data access, remote tag browsing has been included. This allows you to choose tags from your OPC server on a remote client using the provided tag browser. This makes report configuration on your client machine that much easier. If the remote connection fails, you may need to make some modifications to DCOM settings. Please review the section on Remote Connections in the OPC Server chapter of this manual for details.

Troubleshooting RSLinx provides an OPC Test Client as part of its installation. If you are experiencing issues connecting to the RSLinx OPC Server, use this Test Client to ensure connectivity to the OPC Server as well as data access.

38 •••• Rockwell Software - RSView Server Reference Guide

Rockwell Software - RSView

Overview RSView provides a number of data sources for reporting:

Real-time data using OPC Support for retrieval from multiple servers concurrently is provided. RSView SE does not have a built-in OPC server. For applications with RSView SE you can retrieve real-time data from a RSLinx system. Historical data using the History interface Historical data is accessed from the Data Log models of RSView that have been set up to log to a relational database. Activity and Alarm data set up to log to a relational database can also be accessed using the history interface. Historical data using the Database interface Historical data can be accessed from a relational database. Activity and Alarm data set up to log to a relational database can also be accessed using the database interface.

Setting up RSView32

Enabling the OPC Server To start the OPC server in an RSView32 project, the OPC/DDE Server Option must be enabled first. Without this option set, the report is not able to retrieve any data from RSView32.

Server Reference Guide Rockwell Software - RSView •••• 39

Real Time Write Access By default, RSView32 does not accept values from external client programs, and programs like XLRsetvalue that attempt to write values to Real Time tags fail. However, you can overcome this by executing an RTDATAWRITEENABLE command in RSView32. Add this command to the Startup macro and it is executed every time RSView32 starts.

Configuring a Data Log Model Under the Setup tab, select ODBC as your storage format, and specify the ODBC Data Source by entering it or selecting it from the browse button provided. Enter table names for your database (or use the defaults provided) and click the Create Tables button. This creates the tables in your selected data source.

Alarm Log and Activities Log The alarm and activity log information is stored by default in DBF files. The date is embedded in the file name, and as a result, the constantly changing file name makes automated access virtually impossible. However, RSView supports the following commands: AlarmLogSendtoODBC and ActivityLogSendtoODBC, which copies the data to an ODBC database, such as Access or SQL-Server. If you would like to make this data available, you may want to execute these commands from within an RSView event macro, and periodically store the latest alarms and activities in your database. You can run these commands on a periodic or event basis from a configured event in RSView, which should be timed before the automated report execution takes place. This makes the alarms and activities available in your ODBC database, ready for queries.

Real Time Data Real-time connections to the RSView32 database are configured in the Connection Configurator. Select Real Time as the Type. Specify the tag name or click the browse button for Name. In the tag browser, select RSI.RSView32OPCTagServer as the server name. The tag browser shows all available tags in RSView32. Note that RSView32 must be running to allow tag browsing. Select your tag and complete the configuration of this connection.

History Group






Content

Calculated Values Aggregate values, calculated from the stored samples in the database are retrieved. Aggregates such as, average, total, maximum, minimum, etc., are provided. Raw Values Raw values as stored in the historical database are retrieved. Before the value is returned, the status of the record is checked. If the status is bad, the status designation is copied into the value field, to show that the value is bad. The following status indications exist:

• D, if a node is disabled. • E, if a communications error occurred while acquiring the tag value. • S, the value is Stale, meaning it was acquired before, but not updated. • U, the value is uninitialized.

The number of records returned may be restricted when specifying a limit in the configuration settings. The order in which samples are returned can be in ascending time order (start time on top) or descending time order (end time on top). Raw Text Raw text values as stored in the historical database are retrieved. The same notes provided in the Raw Values group type above apply to the Raw Text group. Alarms Records stored in the alarms table of the historical database are retrieved.


Activities Records stored in the activities table of the historical database are retrieved.





Setup Tab

Controls

Connect… Launches the Data Link Properties dialog to connect to the database.


View Connect… Launches the Connection String dialog to view the current connection to the database.

Content Tables Used – Calculated Values and Raw Values

Tag Table Name of the table containing the tag names in the database. Float Table Name of the table containing the numeric data in the database.

Tables Used – Raw Text Tag Table Name of the table containing the tag names in the database. String Table Name of the table containing the text data in the database.

Tables Used – Alarms Alarms Table Name of the table containing the alarm records in the database.

Tables Used – Activities Activities Table Name of the table containing the activity records in the database.



Content Selected Columns – Calculated Values, Raw Values and Raw Text

Name The Name of the tag to retrieve data for. Selecting a field under this column brings up the historical tag browser for tag selection. This can be a specific tag, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter. Mode Note, this column only appears for the Calculated Values history group. Defines the calculation to apply to the selected Name. All calculations are performed over a time interval or series of time intervals. The following are supported:

Average The arithmetic mean of all sample values over the interval Minimum The lowest value recorded over the interval. Maximum The highest value recorded over the interval Total The total of all the values in the group over the Interval. Good Count The count of good values over the interval. Bad Count The count of bad values over the interval. Standard dev. The square root of the arithmetic mean of deviations from the arithmetic mean of all the values over the Interval. Variance The square of the standard deviation. Time of Minimum The date/time when the minimum occurred over the interval. Time of Maximum The date/time when the maximum occurred over the interval. Closest Sample The raw sample value on or closest to the selected interval time stamp.


Selected Columns – Alarms and Activities Column The database column to retrieve. Selecting a field under this column drops down a list of available columns from the selected table.




Output Do not display duplicate records When checked, only unique records will be returned from the server. Show Time Stamp in report When checked, the left-most column returned from the server will contain the timestamp.




Content Time Period

Start Time The start of the time period over which to retrieve historical values. The following modes are available:






Ascending Oldest to newest from top to bottom.


Descending Newest to oldest from top to bottom.



Filters Tab –Calculated Values, Raw Values and Raw Text The Calculated Values group, the Raw Values group and the Raw Text group support a filter tab, in which a specific tag can be used to filter the data returned for the history group.

Content

Filter Condition Name The name of the tag that is used in the filter. A tag browser has been provided. This can be a specific tag, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter.


Condition 1 The condition and value for the filter. Valid conditions include “=”,. “<>”, “>”, “>=”, “<”, “<=”, “LIKE” and “NOT LIKE”. The “LIKE” and “NOT LIKE” are used for text comparisons where an approximate match is needed. This can be a specific value, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter. AND/OR Logically combines Condition 2 with Condition 1.

AND Logically “ands” two conditions. Both conditions have to be true to retrieve data. OR Logically “ors” two conditions. One of the conditions has to be true to retrieve data.

Condition 2 A second condition and value for the filter. Valid conditions are the same as Condition 1.

Filter Tab –Alarms and Activities The Sampled Values history group type provides a different filter tab. This group type supports filtering with multiple filter tags and conditions. The filter tab supports up to 12 filter conditions to be applied to the History Group. Conditions may be “anded” or “orred” to get the desired filter effect.

Content

Selected Filters A/O The A/O setting stands for And/Or. This setting forms the logical connection between two filter conditions, specifically, between the filter condition and the condition on the line above it. The following are available:


AND Logically “ands” two conditions. Both conditions have to be true to retrieve data. OR Logically “ors” two conditions. One of the conditions has to be true to retrieve data. )AND( Logically “ands” two condition groups. Both condition groups have to be true to retrieve data. The parenthesis combines the conditions above this row in a group and “ands” the combined result with the condition group starting at this row. )OR( Logically “or” two condition groups. One of the condition groups has to be true to retrieve data. The parenthesis combines the conditions above this row in a group and “ors” the combined result with the condition group starting at this row.

Column Name of the database column to be used in the filter condition. Selecting a field under this column drops down a list of all available columns from the selected table. Condition The condition describes the relationship between the value of the column and the entered value. Choose from “=”, “<>”, “>”, “>=”, “<”, “<=”, “LIKE”, and “NOT LIKE”. The “LIKE” and “NOT LIKE” are used for text comparisons where an approximate match is needed. Value The value to compare the tag against. This can be a number, text, a cell reference or a variable. Note that single quotes are required text values; even if a text is retrieved from a cell reference, single quotes need to be applied. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter.

Filter Conditions The completed filter statement that will be submitted to the server.

Order Tab Controls how the returned data is ordered. Typically, the data is ordered by time stamp, either ascending or descending. But, it can also order by any of the database columns configured in the Columns tab. Note, this tab is only available for Alarms and Activities history groups.


Content

Order By Column Name of the database column to order by. Selecting a field under this column drops down a list of selected columns from the Columns tab. Order

Ascending Historical data will be ordered from smallest to largest based on the Column specified. Descending Historical data will be ordered from largest to smallest based on the Column specified.

Order By Conditions The completed order by statement that will be submitted to the server.

Database Group The Database Group allows you access to relational databases. The RSView Data Log model stores data to a relational database in 3 tables: FloatTable, StringTable and TagTable. Typically, you can retrieve all data for your report via the History Group; it accesses the data log model while not requiring you to configure any SQL. If however, you require very specific data that just can’t be accessed using a history group, you can utilize the Database Group to connect to the database and retrieve data. For more information, see the Database Group chapter of the WizReport XL Reference Guide.



Real Time RSView Real Time data can be accessed with remote OPC access. This may require DCOM settings of the RSView OPC Tag Server to be opened up. See the Remote Data Access section of the OPC Chapter.

Historical Since RSView history data is logged to a relational database, it can be accessed from any machine that is networked to the machine where WizReport XL is installed.

Starting the Scheduler To start the Report Scheduler as part of the RSView setup, configure an AppStart command as part of the Startup macro. The syntax should be: AppStart C:\Program Files\WizReport XL\XLRschedule.exe

Using the WizReport XL Programming Interface Using the Visual Basic for Applications environment provided with RSView, any report command can be executed using the following syntax: Call Shell XLRrequest “Command ‘Parameter 1’ ‘Parameter2’” For more information on issuing commands from a Visual Basic environment, see the Programming Interface chapter of the WizReport XL Reference Guide.

Server Reference Guide Emerson Process - DeltaV •••• 51

Emerson Process - DeltaV

Overview Delta V provides a number of data sources for reporting:

Real-time data using OPC Support for retrieval from multiple servers concurrently is provided. Real-time data using FIX interface Support for retrieval from a Pro Plus Delta V installation. Historical data using the OSI PI interface Historical data is accessed from the OSI PI historian. Historical data using the OPC-HDA interface Historical data is accessed from the OPC-HDA historian. Historical data using the Database interface Batch Journal can be accessed from a relational database.

Setting up DeltaV

Remote OPC and OPC HDA Connections Remote Connection to a DeltaV OPC Server requires DCOM to allow the connection. The following guidelines show you how to open up connections for the “Everyone” Account. After the connection shave been established, you may refine the settings to just allow certain accounts to communicate:

• On the OPC Server station allow DCOM connection in the XP-Service Pack 2 by enabling DCOM in the Windows Firewall Setting in the Control Panel. If a port needs to be added, use port number 135 as default.

• Run DCOMCNFG on the server. Open up “Component Services, Computers” and select My Computer. Right click and select Properties. Under tab Default Properties, make sure that DCOM is enabled . Under tab COM Security, click on both Edit Default buttons and add accounts “Everyone”, “Network”, “Interactive” and “System” (if not yet set). Select OK.

• Double click My Computer and double click on DCOM Config. In the open folder, select program OPCEnum. Right click to select its Properties. On tab General, set the Authentication Level to “Default”. Select the tab named Security. Under Launch and Activation Permissions, select Default and do the same for the Access Permissions and the Configuration Permissions. Select OK.

• In the open folder, select program DeltaV OPC HDA Server. Right click to select its Properties. Under tab General, set the Authentication Level to “Default”. Select tab Security. Under Launch and Activation Permissions, select Default and do the same for the Access Permissions and the Configuration Permissions. Select OK. Close DCOMCNFG.

52 •••• Emerson Process - DeltaV Server Reference Guide

• In the DeltaV User Manager on the server system, add an account that is identical to the account name (and password) on the remote computer from where you wish to access the OPC server in DeltaV.

• On the client machine, use Windows to map a drive to the server machine. This opens up communication between the client and server machines.

OSI-PI History Through the use of the History Group connection, you can retrieve data from DeltaV’s historian. In order to retrieve data from the DeltaV OSI-PI historian, the DeltaV History server name must be provided. In the Project Explorer, open the Configuration program, and select the DeltaV History tab. The Server name defaults to the local computer name, meaning it assumes a local DeltaV History server. If you do not wish to use the local server, right-click the server name value, select Modify and enter a new name and click OK. Close the Configuration program. Note that if the OSI-PI server resides on a remote node, the local station requires a copy of file PIAPI32.DLL to be in folder C:\Windows\System32.

Real Time Data There are two methods of communication with the Real-time server of DeltaV:

1. OPC, this is the preferred method. It works on each DeltaV station type, but it may require an additional license on the DeltaV station. The “Application Station” always has OPC enabled, while a “Pro Plus Station” typically needs a license.

2. FIX interface. This interface is not supported on the “Application Station”. It is only supported on the “Pro Plus Station”.

Application Station Tag names are entered in the Name field of the Connection Configurator or Schedule Designer by clicking on the browse button , which provides the tag browser. Tag Browser The Tag Browser lets you conveniently select a tag from the DeltaV server database. By default, the node name is set to Local. If the server is on another node, uncheck the Local box and enter the name in the Node field and press the Connect button. This shows you the servers on that node in the Server list. In here, select “OPC.DeltaV.1”. The tags typically are under the “Modules” group. Drill down until you get to your tag name and select the parameter, e.g., “CV”. The OK button copies the selected tag to the configuration menu.

Pro Plus Station The DeltaV Fix interface presents a tag as a 3 tiered name: THISNODE : DELTAV_NAME . FIELD (e.g., THISNODE : REACTOR/TEMP/OUT.CV . F_CV) Tag names can be entered manually in the Name field, or easier, can be entered by clicking on the browse button , which brings up the tag browser.


Tag Browser The Tag Browser provides the ability to conveniently select a tag from the database. Wait for the DeltaV browser to open automatically and overlay the report tag browser. (Be patient, the first time after a reboot this may take up to a minute.)

After selecting the tag in the DeltaV browser and pressing OK, both browsers are closed and you are returned to the original display. Note that "THISNODE" and "F_CV" have been appended automatically. If the tag contains text data, change the “F_CV” to “A_CV”.

History Group - OSI-PI









Content


Average The arithmetic mean of all sample values over the interval Maximum The highest value recorded over the interval


Minimum The lowest value recorded over the interval. Sample The calculated sample value at the beginning of the interval. Manual Not supported with this server. Accumulation The accumulated total of the Interval samples. Difference The calculated difference between the end value and the start value of the Interval. Acc. Difference The accumulated total of the difference calculated over the Interval, i.e., the difference between the start of the span and the end of each interval.




Connection Displays the Node where the OSI-PI history server is located. Headings

None Headings will not be returned as part of the history group. Custom The Headings configured for each selected column will be returned as the top row from the history group.



Content




Specific When the history group is updated, the Span will be the specific Duration set in minutes, hours or days. Variable When the history group is updated, the Span will be the value of the variable specified. Note, the variable must be set in the format “DD:hh:mm:ss”. For more information, see the Using Variables in History Groups chapter.




Defining the interval to be a divider of the total time span causes the history group to return multiple values. For instance, if the Span is 1 day, and the interval is specified as 1 hour, the history group returns 24 rows of calculated values.

History Group – OPC-HDA With DeltaV version 7.4 and higher, data can be retrieved from DeltaV’s historian using OPC HDA using a the OPC-HDA history group interface. The following settings are specific to DeltaV:

Setup Tab The OPC-HDA server name for DeltaV is DeltaV.OPCHDAsvr.1.

Columns Tab DeltaV supports the following Mode types:

Interpolated The interpolated value at the start of the interval. Average The time-weighted average value over all the data in the interval. Count The number of raw samples collected in the interval. Maximum The maximum value of all data over the interval. Minimum The minimum value recorded over the interval. Time of maximum The timestamp of the maximum value of all data in the interval. Time of minimum The timestamp of the minimum value recorded in the interval. Start value The value and associated timestamp of the first raw sample in the interval. End value The value and associated timestamp of the last raw sample in the interval.


Database Group Using the Database group, DeltaV data logged to relational database can be retrieved. A rich set of database access tools have been provided to add batch or journal information to any report. For more information on accessing a relational database, please refer to the Database Group chapter in the WizReport XL Reference Guide.

Accessing Remote Data It is possible to access both Real Time and Historical data remotely from a Delta V machine. Before attempting, please see the Setting up Delta V section of this chapter.

Real Time Real Time data can be accessed remotely through OPC. See the Setup In order to access remote Real Time data, the DeltaV Remote program to be installed on the remote (client) machine. In addition, you must set up a DeltaV account on the server identically named to the accessing account on the client system. Once this has been established, on the client machine, connect to the local machine. The Delta V OPC server should be available. Connect to that and all the tags from the Delta V server should be available.

Historical OPC-HDA Server In order to access remote data, the DeltaV Remote program to be installed on the remote (client) machine. In addition, you must set up a DeltaV account on the server identically named to the accessing account on the client system. Once this has been established, on the client machine, in the History Group Builder, specify the Node as the name of the Server and connect. The historical data should now be available. OSI-PI Historian In order to access remote data from the OSI-PI historian, the file PIAPI32.dll must be resident on remote machine in the System32 subfolder of the Windows folder. You should then configure the PI History server name in Configuration to be the node name of the node that has the PI database.

Starting the Scheduler The Scheduler can be started up automatically with the start of Delta V. To do so, add the program XLRSchedule.exe (located in the installation directory) to the list of tasks to be executed. This list can be accessed in the Graphic Subsystem Configuration Utility by selecting Configure, Tasks.

Using the WizReport XL Programming Interface A complete programming interface is provided with WizReport XL. Using this interface it is possible to issue any command provided to produce a report from a Delta V display. For more information on the commands supported, see the Commands chapter of the WizReport XL Reference Guide.


Issuing Commands from Delta V versions with iFIX Using the Visual Basic for Applications environment provided with iFIX, any report command can be executed using the following syntax: Call Shell XLRrequest “Command ‘Parameter 1’ ‘Parameter2’” For more information on issuing commands from a Visual Basic environment, see the Programming Interface chapter of the WizReport XL Reference Guide.

Issuing Commands from Delta V versions with FIX In the scripting environment of FIX, any report command can be executed using the RUNTASK command using the following syntax: RUNTASK XLRrequest “Command ‘Parameter 1’ ‘Parameter 2’”

60 •••• OPC-HDA Servers Server Reference Guide

OPC-HDA Servers

Overview An OPC-HDA server is a program that has access to historical data and can provide that data to other programs that are OPC HDA clients. The History group is provided in order to retrieve data from your OPC-HDA server. The History Group connection allows you to quickly configure a group of tags together with their attributes. In addition, configure the time period over which you would like to see the historical values. This chapter describes the techniques and methods that are provided to you in order to configure your reports with an OPC-HDA server.

History Group





Server Reference Guide OPC-HDA Servers •••• 61

Content

Raw Values Raw values as stored in the historical database are retrieved. Sampled Values Calculated sample values derived from stored samples in the database are retrieved. Calculated Values Aggregate values, calculated from the stored samples in the database are retrieved. Aggregates such as, average, total, maximum, minimum, etc., are provided.






Setup Tab

Content

Connection Server The name of the OPC-HDA Server to connect to. Node The Node where the Server is located. For the local node, leave this setting blank. Password The Password to connect to the Server.

Controls Connect Connects to the OPC-HDA Server based on the Connection settings.



Content

Selected Columns Name The Name of the tag to retrieve data for. Selecting a field under this column brings up the historical tag browser for tag selection. This can be a specific tag, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter. Mode Defines the calculation to apply to the selected Name. All calculations are performed over a time interval or series of time intervals. The following may be available based on the Server connected to:

Interpolated The calculated sample at the beginning of the interval. Average Adds up the values of all good raw data in a given interval and divides the sum by the number of good values. Maximum The maximum good raw value over the interval. Time of Maximum The date/time when the maximum occurred over the interval. Minimum The minimum value good raw value over the interval. Time of Minimum The date/time when the minimum occurred over the interval. Range The difference between the maximum and minimum values over the interval. Standard dev The calculated standard deviation of all the good values in the interval.


Variance The calculated square of the deviation. Total The time weighted average time the interval length in seconds. Count A count of all the raw values within an interval that are good quality. Average (raw) Adds up the values of all good raw data in a given interval and divides the sum by the number of good values. Start value The first raw value within the interval. End value The last raw value within the interval. Delta value The difference between the earliest and latest good raw sample in an interval. Regression slope The method used to determine this is server dependent. Regression constant The method used to determine this is server dependent. Regression dev. The method used to determine this is server dependent. Annotation count A count of all the annotations within an interval. Duration good The total amount of time (in seconds) of good values within an interval. Duration bad The total amount of time (in seconds) of good values within an interval. Percentage good The percentage of duration good divided by the length of the interval. Percentage bad The percentage of duration bad divided by the length of the interval. Worst quality The worst quality of the raw values in the interval.


Layout Automatically adjust column widths If checked, each column is made as wide as the widest value in the column.


Empty rows between records Controls the number of blank rows between each returned row. The default is 0, meaning all rows are packed.

Column Options Timestamp on first column The timestamp returned the historical database will be the leftmost column of the returned data. Timestamp on all columns The timestamp from the historical database will be returned for every column selected. Timestamp, quality on all columns The timestamp and quality from the historical database will be returned for every column selected.



Content










Retrieving Raw Values When retrieving raw values, the values are returned where the timestamp >= Start Time and timestamp < End Time. For example, if the raw values between 11:00:00 AM and 12:00:00 PM are requested, the value collected at 11:00:00 AM is returned, but the value collected at 12:00:00 PM is not.

Adding to the History Group Mode List Because not all OPC-HDA servers support all the available calculation modes, a list of supported calculation modes specific to the server can be configured. To do so, the following must be done:

1. Open file opchdaconfig.ini in Notepad. This file is located in the Installation directory.

2. Select [Generic.OPCHDA] and all the aggregates listed under it and copy it to the clipboard.

3. At the bottom of the file, paste the contents of the clipboard. 4. Replace “Generic.OPCHDA” with the exact server name of the specific OPC-HDA

server. 5. Underneath the server name, remove any aggregates that are not supported by the

server. 6. Renumber the aggregate list so that it is sequential. 7. Save opchdaconfig.ini and exit.

The list of calculation modes for the server should now reflect the content of the list.

Remote Data Access Remote Connection to an OPCHDA Server requires DCOM to allow the connection. Please review the Remote Data Access section in the OPC Servers chapter for guidance on settings.

68 •••• OPC Servers Server Reference Guide

OPC Servers

Overview OLE for Process Control (OPC) is a standard inter-application communication protocol built into Microsoft Windows operating systems. OPC takes data from one application and gives it to another application. It allows Windows programs that support OPC to exchange data between themselves.

Real Time Data

OPC Tag Names In WizReport XL, the full specification of an OPC tag name consists of a node (if the tag is from a remote node), an OPC Server name and the name of a tag. The syntax is:

<<Node>><Server>Name The <<Node>> is not required if the OPC Server is local. Real time connections defined in the Connection Configurator (see the User Reference Guide) only display the Name, after the tag has been selected from the OPC tag browser. However, by hovering over the tag, a tool tip will appear showing full name in the format shown above e.g., “<<MyRemoteNode>><Matrikon.OPC.Simulation.1>Random.Boolean”.

OPC Tag Browser The Tag Browser lets you conveniently select a tag from the server database. The Tag Browser is used from all places where tag names are selected from the database. On all configuration windows is a browse button . Click this to see the Tag Browser display.

Server Reference Guide OPC Servers •••• 69

The Tag Browser defaults to the Local Node. If you want to browse tags on another node, uncheck the Local box, and type the name in the Node field, and press the Connect button. Select the name of the Server, and the tags of the server will be displayed. Some servers require you to select a category or topic first before showing the tags. Select the tag name of choice, and press OK to enter it in the configuration.

Remote Data Access Remote Connection to an OPC Server requires DCOM to allow the connection. The following guidelines show you how to open up connections for the “Everyone” Account on a Windows system. After the connection shave been established, you may refine the settings:

• On the OPC Server station allow DCOM connection in the XP-Service Pack 2 by enabling DCOM in the Windows Firewall Setting in the Control Panel. If a port needs to be added, use port number 135 as default.

• Run DCOMCNFG on the server. Open up “Component Services, Computers” and select My Computer. Right click and select Properties. Under tab Default Properties, make sure that DCOM is enabled . Under tab COM Security, click on both Edit Default buttons and add accounts “Everyone”, “Network”, “Interactive” and “System” (if not yet set). Select OK.

• Double click My Computer and double click on DCOM Config. In the open folder, select program OPCEnum. Right click to select its Properties. On tab General, set the Authentication Level to “Connect”. Select the tab named Security. Under Launch and Activation Permissions, select Default and do the same for the Access Permissions and the Configuration Permissions. Select OK.

• In the list of programs, select the name of the OPC Server. Right click to select its Properties. On tab General, set the Authentication Level to “Default”. Select tab Security. Under Launch and Activation Permissions, select Default. Do the same for the Access Permissions and the Configuration Permissions. On tab Identity, select “The interactive user”. Select OK. Close DCOMCNFG.

On a Windows 2000 system, DCOMCNFG is slightly different: • Run DCOMCNFG on the server. Make sure that DCOM is enabled on tab Default

Properties and that the Default Authentication Level is set to “Connect”. On tab Default Security, add account “Everyone” to the Launch Permission and Access Permission Defaults (They should have at least: Interactive, Network, System and Everyone). Select OK.

• Select tab Applications. In the list of programs, select program “OPCEnum”. Select its Properties. On tab General, set the Authentication Level to “Default”. Select the tab named Security. Under Launch and Activation Permissions, select Default. Do the same for the Access Permissions and the Configuration Permissions. On tab Identity, select “The interactive user”. Select OK.

• In the list of programs, select the name of the OPC Server you wish to connect to. Select its Properties. On tab General, set the Authentication Level to “Connect”. Select tab Security. Under Launch and Activation Permissions, select Default. Do the same for the Access Permissions and the Configuration Permissions. On tab Identity, select “The interactive user”. Select OK. Close DCOMCNFG.

70 •••• OPC Servers Server Reference Guide

On the client machine, use Windows to map a drive to the server machine. This opens up communication between the client and server machines. You need to reboot your system to make these DCOM settings active.

Server Reference Guide Wonderware - InTouch •••• 71

Wonderware - InTouch

Overview InTouch provides a number of data sources for reporting:

Real-time data using the InTouch native interface Real time data access is by the native interface. Historical data using the InTouch native interface Historical data is accessed from the classic historian.

Setting up InTouch

Configuration Settings In the Project Explorer open the Configuration program and select the InTouch History tab. All settings have been defaulted during installation. To change any setting configured, right-click the setting and select Modify to edit it. The DB Path setting requires a path to your Intouch project’s database. The Default Log path setting requires a path to the Intouch history log files. The Resolution setting provides the number of samples you want to include in the calculation of average, minimum and maximum, over each interval. The Wait Time setting indicates how long the Report will wait for the historian to pass back the data. This setting is in seconds. This value should be increased if historical requests do not return data.

Histdata.EXE In order to retrieve InTouch history data, the program Histdata.EXE must be running. The HistData.exe program is provided by Wonderware as part of the InTouch installation. To start up HistData.exe, select it from the Wonderware program group and minimize it. It should appear on you Windows taskbar. You may consider configuring this program to start up as part of your InTouch startup routine.

Real Time Data Real-time connections to the InTouch database are configured in the Connection Configurator. Select Real Time as the Source Type. Click the browse button for Name.

72 •••• Wonderware - InTouch Server Reference Guide

The Tag Browser shows all available tags of the current project in InTouch. Note that the InTouch WindowViewer must be running to allow tag browsing. Select your tag and complete the configuration of this connection.

History Group




History Group Dialog Opened by clicking OK from the Select History Group dialog or by clicking Modify from the History Group dialog.


Content Name The name of the history group configured.



Content


Average The arithmetic mean of all sample values over the interval Maximum The highest value recorded over the interval Minimum The lowest value recorded over the interval.


Sample The calculated sample value at the beginning of the interval. Manual This is not supported by InTouch. Accumulation The accumulated total of the Interval samples. Difference The calculated difference between the end value and the start value of the Interval. Acc. Difference The accumulated total of the difference calculated over the Interval, i.e., the difference between the start of the span and the end of each interval.




Connection Defines the path to the historical data files.

Default When checked, the path to the historical data files will be the default path defined in the Configuration program.




Content




Specific When the history group is updated, the Span will be the specific Duration set in minutes, hours or days.


Variable When the history group is updated, the Span will be the value of the variable specified. Note, the variable must be set in the format “DD:hh:mm:ss”. For more information, see the Using Variables in History Groups chapter.



Defining the interval to be a divider of the total time span causes the history group to return multiple values. For instance, if the Span is 1 day, and the interval is specified as 1 hour, the history group returns 24 rows of calculated values. Note that the maximum number of intervals supported is 5000.


Real Time Not supported with InTouch.

Historical To retrieve Historical data from a remote machine, in the History Group Builder uncheck the Use Default checkbox on the Columns tab. This enables the Directory browser where you can configure the directory on the network where the history data resides. The data in that directory will be retrieved when the history group is updated.

Starting the Scheduler To start the Report Scheduler as part of the InTouch setup, configure an Application Script. Set the Condition to On Startup and set the script to StartApp “XLRschedule”. Now, when the Window Viewer is started, the Scheduler will start.

Using the WizReport XL Programming Interface A complete programming interface is provided with WizReport XL. Using this interface it is possible to issue any command provided to produce a report from a Delta V display. For more information on the commands supported, see the Commands chapter of the WizReport XL Reference Guide. The StartApp command may be generated for a display action in a user display. The syntax of the StartApp command is:


StartApp “XLRrequest Command ‘Parameter 1’ ‘Parameter 2’

Troubleshooting Real-time Data If the Real-time connection values are incorrectly reported as “0.0”, you may need to change the setting of the parameter Initial Wait in the Configuration program. In the Configuration program, select the WizReport XL Tab. Select the Initial Wait setting, right-click and select Modify. Enter “1000” and click OK. This causes a wait of 1000 ms before the values are read. You may need to experiment with different settings, based on throughput of I/O. History Data If the history connection causes error “Err019: Failed to connect to history server” to appear, check the following settings.

1. InTouch program Histdata.exe must be running (minimized). If it is not, first shut down the Collector program on the task bar. Then, restart the Histdata.exe program.

2. The Default Log Path field must point to the directory where the data files are stored. Verify the field in the Configuration program.

3. The DB Path field (Intouch project database) must point to the directory where the project is installed. Verify the field in the Configuration program.

4. A tag in your history group does not have any historical data collected over the time period specified or is not configured for historical data collection in Intouch.

5. The Wait Time field in the Configuration program may not allow enough time for the history query to complete. Increase the value, which is specified in seconds.

If all of these settings appear OK, do the following: 1. Close Excel if it is open. 2. Close the Report Collector program if it is running. 3. Close HistData.exe. 4. Restart HistData.exe. 5. Attempt to update the report again.

78 •••• Wonderware - Industrial SQL Server Server Reference Guide

Wonderware - Industrial SQL Server

Overview Industrial SQL Server (InSQL) provides a historical data source to report on. This chapter describes the techniques and methods available to you, in order to configure reports with Industrial SQL Server. There are 2 options available for retrieving data from InSQL. This is done via a History Group connection or through a Database query. History Group Connection The History Group connection allows you to quickly configure a group of tags together with their attributes. In addition, configure the time period over which you would like to see the historical values. When executed, the history group returns a table of values over the configured time span, originating from the start cell of the connection in the report worksheet. Types of data retrieved include:

• Raw values, including textual and discrete values. • Summary values configured by InSQL. • Calculated values, such as Average, Min, Max, etc. over time intervals.

Typically, the History Group easily accommodates the majority of historical reporting requirements. Database Query The Database connection allows you to fully specify each aspect of a query for the database, thus providing you with the utmost flexibility. The built-in query builder makes it easy for you to create the right query, giving you the data view you want. Typically, you would use a database connection for queries that require specific filtering, queries that are too customized for the History Group or queries that include data from an outside database. Another advantage to using a Database query is that you can utilize the Layout features, allowing you full control over every aspect of your report from formatting to data placement to Excel charting and formulas.

Setting up InSQL

Connecting to Summary Tables from InSQL InSQL provides Summary Tables that you can connect to in order to report on Summary information from data collected in InSQL. In order to access these Summary Tables, you must first configure the Summary Tables within InSQL Console, located within your InSQL program group. For detailed information on how to configure the Summary Tables within InSQL, please see your InSQL documentation.

Server Reference Guide Wonderware - Industrial SQL Server •••• 79

History Group





Content

Live Values Retrieves the most current sample values collected by InSQL Server. Raw Text Raw text values as stored in the historical database are retrieved. Raw Values Raw values as stored in the historical database are retrieved. Calculated Values Aggregate values, calculated from the stored samples in the database are retrieved. Aggregates such as, average, total, maximum, minimum, etc., are provided.






Setup Tab

Controls

Connect… Launches the Data Link Properties dialog to connect to InSQL. View Connect… Launches the Connection String dialog to view the current connection to InSQL.


Content Tables Used – Live Values

Tag Table Name of the table containing the tag names in the database. Live Table Name of the table containing the live values.

Tables Used – Raw Values, Raw Text, Calculated Values Tag Table Name of the table containing the tag names in the database. History Table Name of the table containing the history data in the database.

Tables Used – Summary Values Tag Table Name of the table containing the tag names in the database. History Table Name of the table containing the summary data in the database.


Content

Selected Columns – Live Values, Raw Values Raw Text and Calculated Values Name The Name of the tag to retrieve data for. Selecting a field under this column brings up the historical tag browser for tag selection. This can be a specific tag, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter. Mode Note, this column only appears for the Calculated Values history group.


Defines the calculation to apply to the selected Name. All calculations are performed over a time interval or series of time intervals. The following are supported:

Average The arithmetic mean of all sample values over the interval Minimum The lowest value recorded over the interval. Maximum The highest value recorded over the interval Total The total of all the values in the group over the Interval. Standard dev. The square root of the arithmetic mean of deviations from the arithmetic mean of all the values over the Interval. Variance The square of the standard deviation. Good Count The count of good values over the interval. Bad Count The count of bad values over the interval.


Selected Columns – Summary Values Name The Name of the tag to retrieve data for. Selecting a field under this column brings up the historical tag browser for tag selection. This can be a specific tag, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter. Mode Defines the calculation to apply to the selected Name. All calculations are performed over a time interval or series of time intervals. The following are supported:

Average The arithmetic mean of all sample values over the interval Minimum The lowest value recorded over the interval. Maximum The highest value recorded over the interval Total The total of all the values in the group over the Interval.

Duration Defines the duration of the summary calculation. The following durations are provided:

• 1 Hour


• 12 Hours • 1 Day • 7 Days • 30 Days

In addition, custom duration values can be added to the list. For more information, see Adding Summary Custom Durations later on in this chapter. Heading Sets specific headings for each Name selected. This can be a text, a cell reference or a variable. For more information, see the Using Variables in History Groups chapter and the Using Cell References in History Groups chapter.


Output Show Time Stamp in report When checked, the left-most column returned from the server will contain the timestamp.




Content











Retrieval Tab The Retrieval tab allows you to specify how much data you want to retrieve.


There are two distinct methods of retrieving data from InSQL, Cyclic Retrieval and Delta Retrieval. They are described as follows: Content

Cyclic Retrieval Retrieving values in Cyclic mode means that rows will be returned at equal time intervals. Cyclic Retrieval mode requires either Value spaced every or Number of values.

Value spaced every A time resolution for the returned values as a number of seconds, minutes, hours, days or weeks as the interval. This number divides the total timeframe specified in the Time tab to produce the data returned. For example, if the timeframe is one day and “1 hour” is specified, the values returned are the values recorded for every hour of the day. Number of values The exact number of values to return. The number specified is divided into the total timeframe set in the Time tab to produce the data returned. For example, if the timeframe is one day and “24” is specified, the values returned are the values recorded for every hour of the day. Note that for Calculated Values history groups, the Number of values setting defines the amount of data that is used for each interval calculation.

Delta Retrieval Delta Retrieval mode provides settings to reduce the number of values returned.

Limit to rows This setting limits the total number of rows returned by the group. If this is set to “0”, there is not limit set. Time Deadband This setting limits the total number of rows returned by only returning records where the date stamp has changed by more than what has been specified. This setting is in milliseconds. Value Deadband This setting limits the total number of rows returned by only returning records where the value has changed by more than the percentage specified.


Filters Tab Filtering can limit the number of records returned in the group. There are two different filters available, the Value Filter and the Quality Filter plus settings to specify how these filters affect the returned data.

Content

Value Filter Numeric Condition 1 and Condition 2 are numeric. Text Condition 1 and Condition 2 are text. Condition 1 The condition and value for the filter. Valid conditions include “=”,. “<>”, “>”, “>=”, “<” and “<=” for Numeric and “LIKE” and “NOT LIKE” for Text. AND/OR Logically combines Condition 2 with Condition 1.

AND Logically “ands” two conditions. Both conditions have to be true to retrieve data. OR Logically “ors” two conditions. One of the conditions has to be true to retrieve data.

Condition 2 A second condition and value for the filter. Valid conditions are the same as Condition 1. Exclude NULL values Eliminates any null values that may be returned.

Quality Filters the data based on quality. The condition is either “=” or “<>”. The value can either be Good, Bad or Doubtful.


Return Data when conditions are Sets the Edge Detection for the InSQL query. The following are supported:

First True The rows returned are only those that are the first to successfully meet the criteria specified. No Longer True The rows returned are only those that are the last to successfully meet the criteria specified. True All the rows that successfully meet the criteria specify are returned. First True and No Longer True The rows returned are those that are the first and the last to successfully meet the criteria specified.

Adding Summary Custom Durations To add a custom duration value to the list of Durations for a Summary history group, open insql_config.ini in the Installation directory and follow the instructions.

Database Group The database group allows you access to OLE DB databases such as InSQL. The InSQL server provides many tables from which you can query data for your reports. In the WizReport XL Reference Guide, refer to the Configuring a Database Query chapter for detailed information on the use of the Database connection.

Connecting to the InSQL Server To connect to the InSQL server in the Database Query Builder, under the Setup tab, click New Connect. This opens the Data Link Properties Window. There are two distinct methods for connecting to the InSQL server. You can either connect using the SQL Server OLE-DB provider from Microsoft, or if you have a Data Source Name (DSN) configured that already connects to the InSQL server, you can use the Microsoft OLE DB Provider for ODBC Drivers and specify the DSN when prompted to.

Considerations for Configuring a Database Group The following InSQL User Stored Procedures can be set from a query to the v_History view:

• ww_SetTimeDeadband Controls the time resolution of data returned in delta (exception) mode. Any changes that occur within the time deadband (in milliseconds) will not be returned.

• ww_SetValueDeadband Controls the value resolution of data returned in delta (exception) mode. Any data values that change less than the specified deadband will not be returned. The value is a percentage of the tag’s full scale engineering units.

• ww_SetEdgeDetection Returns a set of values that can be used to trigger events.


• ww_SetAnalogCyclic Specifies to query analog data cyclically or by exception (delta).

• ww_SetRowCount A row count determines the number of rows to be retrieved from any of the InSQL history tables.

• ww_SetResolution Sets the resolution, or sampling interval, in milliseconds, for retrieving data in any of the InSQL analog and discrete history tables.

90 •••• Intech Instruments - MicroScan2000 Server Reference Guide

Intech Instruments - MicroScan2000

Overview MicroScan provides a data source for reporting:

Real-time data using the MicroScan native interface Real time data access is by the native interface.

Setting up MicroScan In order to retrieve tag names and values from MicroScan's tag database, the Tag Monitor must be running. To set the Tag Monitor to run automatically when MicroScan is started, open MicroScan's Setup Manager. In the Setup Manager, select System Setup. This will open the System Settings dialog. Under the Accessories section, select the Tag Monitor accessory. Tag Monitor should appear with an X in its checkbox. Click OK to close the System Settings dialog and start MicroScan.

Real Time Data A MicroScan tag name consists of a tag number and a tag name. Tags appear in the following manner: Tag Number - Tag Name (e.g., 1 - Pipe Pressure) The tag number refers to the number of the tag in Micro Scan's tag database and the tag name refers to the name corresponding with that number.

Tag Browser The Tag Browser provides the ability to conveniently select a tag from the tag database.

Tag Names are numerically organized. If the name is not in view, scroll downward to select it. Alternatively, select any name in the list by left clicking on it (this will highlight the selection). Then, type the number of the tag you want. The list will automatically scroll to that tag number.

Server Reference Guide Intech Instruments - MicroScan2000 •••• 91

Press the OK button to accept your choice and return to the place where a tag name was required. When it is not convenient to use the tag browser for entering a tag, simply enter the tag number corresponding with the desired tag in MicroScan's database where the tag name is needed.

92 •••• Using Cell References in History Groups Server Reference Guide

Using Cell References in History Groups

Overview As part of the History Group configuration, Excel cell references can be entered for certain settings. This can make for a more flexible reporting solution as data from other sources or manually entered in cells can become part of the overall history group configuration.

Cell Reference Format The format of a cell reference must be either “$A$1” or “Sheet!$A$1” where Sheet is the specific Excel worksheet for the cell reference. If no worksheet is specified, the value of the cell reference will come from the worksheet being updated.

Cell References for Date and Time If a cell reference is used for a date or time, the format of the cell must be in accordance with what the history server expects. For example, a cell reference for a time should be in the format “HH:mm:ss” where HH is in the range “0-23” rather than the 12 hour clock with AM/PM. In addition, if both date and time are in the same cell, specify the same cell reference for Date and Time. Make sure the cell is formatted to display “HH:mm:ss” for the time, as the default format in Excel for date and time does not show seconds.

The Iterator The Iterator expands on the concept of cell-based configuration. It operates on a range of cells, e.g., a column of tag names. When a History Group configured for the Iterator is invoked, it reads the first cell from the range, executes the data retrieval, places the retrieved data in the sheet and reads the next cell from the range to place its retrieved data one row lower. As a result, the History Group is executed multiple times, until the cells in the range are exhausted (when a blank cell is encountered). This feature allows the History Group to operate with variable sized input ranges.

Server Reference Guide Using Cell References in History Groups •••• 93

Example of tag names used by Iterator

The reference cell in the group invoking the Iterator is denoted with a trailing “:*”, e.g., “$B$32:*”.

Configuring the Start cell for the Iterator

The Iterator reads the cells downward and places the results accordingly for each individual (tag name) value it reads.

After the History Group with the Iterator has been executed

Typically, the input cells are in a column, and the next value is found in the adjacent row. However, if the input cells are evenly spaced in the column, e.g., 3 rows between each input cell,

94 •••• Using Cell References in History Groups Server Reference Guide

the Iterator recognizes this pattern and calculates its internal increment as 4. This increment is applied to an offset from the reference cell, after each execution. In addition, the results of the Group are placed with the same offset from the cell where the connection originated. In other words, each History Group execution places the results 4 rows down. Again, the execution stops when an empty cell is encountered when reading the settings from the worksheet. A History Group may have multiple cell-based settings, each with an Iterator configured. With each execution of the History Group, all Iterator offsets are incremented with the same calculated increment until one of the input ranges is exhausted. Thus the smallest range controls the end of execution. Also, all input ranges should have the same (even) spacing. The Iterator can still be used even if the size of the data set to be returned is unknown. The Iterator always “jumps over” the last returned data set, so the next group execution automatically places its data below the previous data, leaving one blank row in between.

Server Reference Guide Using Variables in History Groups •••• 95

Using Variables in History Groups

Overview As part of the History Group configuration, variables can be entered for certain settings. This can make for a more flexible reporting solution as data from other sources or manually entered in cells can become part of the overall history group configuration. Variables are provided as Register and DateTime functions. For more information, see the Functions chapter in the Reference Guide.

Variable Format The format of a variable must be either “{RGxxx}” or “{DTxxx:yyyy}” where RGxxx is an available Register function from 0-99, DTxxx is an available DateTime function from 0-19 and yyyy is the Date or Time field of the function.

Variable Usage

Register Functions Register functions should be used as variables where tag names, headings or filter conditions are required.

DateTime Functions DateTime functions should be used as variables for Date and Time values.

Documents

Server Reference Guide - Wizconsupport.wizcon.com/Data/Wizcon Supervisor/WizReport... · Setting up DeltaV ... an OPC Server name and the name of a tag. The syntax is: Name