datamanager - user guide

8/13/2019 DataManager - User Guide

1/64

DATA MANAGER 2.0

USER GUIDE

November 2005


2/64

Data Manager 2.0 User Guide

DISCLAIMER : This is an unpublished work, the copyright of which vests inSEVEN TECHNOLOGIES A/S.

All rights reserved.

The information contained herein is the property of SEVENTECHNOLOGIESand is supplied without liability for errors oromissions.

No part may be reproduced or used except as authorized by contract orother written permission.

The copyright and the foregoing restriction on reproduction and use extend to all media in which theinformation may be embodied.


3/64


Page 3 of 64

CONTENTS

1

INTRODUCTION................................................................................................................. 4

1.1 TOOLBAR BUTTONS ............................................................................................71.2 MENU BAR.............................................................................................................9

2 INSTALLING DATA MANAGER .......................................................................................103 USING DATA MANAGER MENUS, SUBMENUS AND COMMANDS .......................... 11

3.1 FILE MENU........................................................................................................... 113.1.1 New Database > Access....................................................................... 113.1.2 New Database > SQL Server................................................................113.1.3 Open Database > Access .....................................................................133.1.4 Open Database > SQL Server.............................................................. 133.1.5 Import > Tag Configurations .................................................................143.1.6 Import > Time Series.............................................................................153.1.7 Export > Tag Configurations .................................................................163.1.8 Export > Time Series ............................................................................173.1.9 Reset History.........................................................................................183.1.10 Exit ........................................................................................................ 18

3.2 CONFIGURE MENU ............................................................................................193.2.1 Data Sources ........................................................................................193.2.2 Data Tags..............................................................................................243.2.3 Cyclic Buffers ........................................................................................333.2.4 Preferences........................................................................................... 34

3.3 RUN MENU .......................................................................................................... 393.3.1 Preprocessor......................................................................................... 39

3.4 TOOLS MENU...................................................................................................... 413.4.1 Reset > average values ........................................................................413.4.2 Reset > Table Locks .............................................................................413.4.3 Reset > Cyclic Buffers...........................................................................413.4.4 Initialize > Cyclic Buffers .......................................................................41

3.5 VIEW MENU......................................................................................................... 423.5.1 Measurements ......................................................................................423.5.2 Historical Data....................................................................................... 433.5.3 Data Graph............................................................................................443.5.4 Buffer graph ..........................................................................................463.5.5 Event Log ..............................................................................................473.5.6 System Log ...........................................................................................48

3.6 WINDOW MENU ..................................................................................................493.6.1 Cascade................................................................................................ 493.6.2 Tile Horizontally..................................................................................... 493.6.3 Tile Vertically......................................................................................... 49

3.7 HELP MENU.........................................................................................................493.7.1 Data Manager Help...............................................................................493.7.2 Support..................................................................................................493.7.3 About..................................................................................................... 49

4 OPC CLIENT.....................................................................................................................504.1 OPC INTRODUCTION .........................................................................................504.2 OPC BROWSER .................................................................................................. 514.3 GUIDE TO OPC CONFIGURATION....................................................................54


4/64


Page 4 of 64

APPENDIX A: DATA CONFIGURATION FILEAPPENDIX B: HISTORICAL DATA FILEAPPENDIX C: ARITHMETRIC EXPRESSIONS


5/64


Page 4 of 64

1 INTRODUCTION

This User Guide describes how to configure and operate the software Data Manager from7-Technologies.

Data Manager is an online database application for configuring, preprocessing and administrating rawdata from any data source such as supervisory control and data acquisition (SCADA) systems and DataLoggers . The data can then be used in the 7T online products AQUIS, LIQUIS,TERMIS, DemandManager and Leak Detection.

Data Manager is used in order to:

Receive data from any data source such as SCADA systems, Data Loggers etc.

Perform data conversion, data checks and data emulation for data received. These processes areperformed by the data preprocessor.

Maintain cyclic buffers of week profiles for selected SCADA tags.

Make the preprocessed data available for online simulations (real-time and historical).

Automatically backup historical data (Access databases only).

Figure 1.1 illustrates how Data Manager intercommunicates with external units, modules and programs.

Seven Technologies


6/64


Page 5 of 64

Figure 1.1 Data Manager communication overview

Seven Technologies


7/64


Page 6 of 64

Module Description

SCADA Any SCADA system with an ODBC, ADO, OPC orASCII based interface.

AQUIS AQUIS is an advanced and powerful water networksimulation platform. AQUIS is designed to improve hydraulicperformance, water quality and safety of operation, whilereducing water supply costs, leak risks, non-revenue water,capital investment and customer complaints.

LIQUIS LIQUIS is a highly advanced and cost-effective simulationplatform for transmission pipelines. LIQUIS facilitatesplanning and management within numerous areas, includingleak detection, optimization of pump operation, optimizationof pipeline planning and operation (three days planning,quality tracking, batch tracking), state estimation and surge

analysis.TERMIS TERMIS is an extensive district energy network simulation

platform for improving system design and operation. TERMISis a leading district energy network solution designed toimprove energy consumption and hydraulic performance,while reducing energy costs, operating costs, capitalinvestments and customer complaints.

Demand ManagerLeak Detection

Data Manager operates on the basis of a Microsoft SQL Server or a Microsoft Access database, which isthe default solution.

From the menu bar you can get access to all program features and functions.The toolbar contains a number of buttons for shortcut access to the most commonly used featuresand functions.In the main window, you will see the dialog boxes that you open by clicking the toolbar buttons andthe menu commands.The information window displays general static information about the current configuration.The status bar in the bottom of the screen displays general information about database and systemstatus.

Seven Technologies


8/64


Page 7 of 64

12

3

4

5Figure 1.2 The Data Manager user interface

Click the menus on the Data Manager menu bar to see the different submenus and commands. Clickinga command opens a dialog box with one or more options for configuring Data Manager and theintercommunication between the data sources and the model environment.

1.1 TOOLBAR BUTTONS

The toolbar in the upper part of the screen is an integrated part of the user interface in Data Manager,thus it is always displayed. The buttons are shortcuts to some of the most commonly used features,which are described below.

Click this button to open the Preferencesdialog box, or click the Configure menu, and then clickPreferences.

Click this button to open the Data Sourcesdialog box, or click the Configuremenu, and then clickData Sources.

Click this button to open the Data Tagsdialog box, or click the Configuremenu, and then clickData Tags.

Seven Technologies


9/64


Page 8 of 64

Click this button to open the Measurementsdialog box, or click the View menu, and then click

Measurements.

Click this button to open the Historical Datadialog box, or click the View menu, and then clickHistorical Data.

Click this button to open the Data Graphdialog box, or click the Viewmenu, and then click DataGraph.

Click this button to open the Preprocessor dialog box, or click the Run menu, and then clickPreprocessor.

Click this button to toggle scheduled import of time series on and off. This button is only available ifyou have defined one or more intervals in the Schedulerarea in the Import Time Seriesdialog box. Toopen the Import Time Seriesdialog box, click the Filemenu, point to Import, and then click TimeSeries.

Click this button to view the Data Manager User Guide(PDF file), or click the Helpmenu, and thenclick Data Manager Help.

Seven Technologies


10/64


Page 9 of 64

1.2 MENU BAR

The menu bar contains the menus, submenus and commands displayed in Figure 1.3below.

Figure 1.3 Overview of menus, submenus and commands in Data Manager

Seven Technologies


11/64


Page 10 of 64

2 INSTALLING DATA MANAGER

To install Data Manager, insert the 7T Data Manager CD-ROM in your computer and do one of thefollowing:

1. Click the Startbutton on the Windows taskbar, and click My Computer.2. In the Folders list, click the letter representing your CD-ROM drive followed by a colon,

for example d: .3. Double-click the program file setup.exeto start the installation.

or

1. Click the Startbutton on the Windows taskbar, and click Run to open the Run dialogbox.

2. Enter the letter representing your CD-ROM drive followed by a colon, for example d: , andclick OK.

3. Double-click the program file setup.exeto start the installation.

As default, Data Manager is installed in the folder C:\Program Files\7T. When theinstallation is complete, you can open Data Manager from the Windows Startmenu. Clickthe Startbutton, point to Programs > 7T > Data Manager 2.0, and then click DataManager.

Seven Technologies


12/64


Page 11 of 64

3 USING DATA MANAGER MENUS, SUBMENUS AND

COMMANDS

3.1 FILE MENU

From the Filemenu you can create new databases, open existing databases and import data to andexport data from the database that has been opened. You can also clear the database history and exitData Manager from the Filemenu.

All dialog boxes and features related to the menu commands will be described in the following sections ofthis chapter.

3.1.1 NEW DATABASE > ACCESS

By default, Data Manager uses MIcrosoft Access for creating databases.

On the Filemenu, point to New Database, and then clickAccessto open the dialog box shown in Figure3.1 below.

Select a folder from the Save inlist, and enter a database name in the File namebox.

Figure 3.1 Create an Access database

3.1.2 NEW DATABASE > SQL SERVER

If you prefer to use an SQL Server solution with Data Manager instead of Access, you will have to acquirea legal copy of SQL Server, which is not supplied by 7T. However, Data Manager is distributed withAccess, which is therefore used as default.

Seven Technologies


13/64


Page 12 of 64

On the Filemenu, point to New Database, and then click SQL Serverto open the dialog box shown in

Figure 3.3 below.

Figure 3.2 Select an SQL Server

Select a server from the SQL Serverlist, and log on to the server with the relevant user name andpassword to open the dialog box shown in Figure 3.3 below.

Figure 3.3 Create a database wi th SQL Server

Click Createto open the dialog box Create Database. Type a database name, and click OK.The new database is now listed in the dialog box Create Database on [database name].Click Close.

NOTE:To create a new database in a SQL Server requires a user with "database create" rights to log on.

Seven Technologies


14/64


Page 13 of 64

3.1.3 OPEN DATABASE > ACCESS

To open an existing Access database, point to Open Databaseon the Filemenu, and clickAccess,see section 3.2.1.

Figure 3.4 Open an Access database

3.1.4 OPEN DATABASE > SQL SERVER

If you prefer to use an SQL Server solution with Data Manager instead of Access, you will have to acquirea legal copy of SQL Server, which is not supplied by 7T. However, Data Manager is distributed withAccess, which is therefore used as default.

To open an existing SQL Server database, point to Open Databaseon the Filemenu, and click SQLServer. The dialog box shown in Figure 3.5 opens. Select the SQL Server you want to open, and clickOpen.

Seven Technologies


15/64


Page 14 of 64

Figure 3.5 Open an SQL Server database

NOTE:To open an existing database in an SQL Server requires a user with "read and write" rights on thespecific database.

3.1.5 IMPORT > TAG CONFIGURATIONS

You may import SCADA tag names and configurations from an ASCII file into the currently activedatabase. The ASCII file with the SCADA definitions must be configured as described in Appendix A.

In the Filemenu, point to Import, and then click Tag Configurationsto open the dialog box ImportTagsdisplayed in Figure 3.6.Point to a file with SCADA tag definitions, and click the Importbutton.

Figure 3.6 The Import Tags dialog box

Seven Technologies


16/64


Page 15 of 64

If the current database is empty, the file will be automatically imported to the configuration.If the database is not empty, you can specify the following parameters:

If the check box Overwr ite existing SCADA valuesis selected, existing SCADA tag definitions in thedatabase will be updated with data from the ASCII file.

3.1.6 IMPORT > TIME SERIES

You can import measurements from an ASCII file to the historical section of the database. The ASCII filecontaining the measurements must have a format as described in Appendix B.

In the Filemenu, point to Import, and then click Time Seriesto open the dialog box displayed in Figure

3.7 below. Please compare bullet points 1-7 in the following paragraphs to the corresponding numbers inFigure 3.7.

Import rulesIn theImport rules area within the Import Time Seriesdialog box, enter a Start time, anEnd time and anImport interval.

In the Start time box, only data with time tags succeeding the start time will be imported. Ifthe field is left blank, the start time of the import will equal the first time tag in the ASCII file.

In the End time box, only data with time tags preceding the end time will be imported. If thefield is left blank, the stop time of the import will equal the last time tag in the ASCII file.

In theImport interval box, you may specify the time interval in minutes between datagroups. Please note that if no import interval is defined, the time tags generated in thedatabase will equal those from the import files. If an import interval is specified, the time tagswithin the database will be generated from start time to end time with a time intervalequivalent to the import interval.

If you check theInclude preprocessor check box, the data will be imported through a datapreprocessor. For more information about the preprocessor, For more information aboutdata preprocessing, see sections 3.2.4 and 3.3.1.

Clicking the Importbutton will now start the data import from each selected ASCII file.

Scheduler In the Scheduler Settingsarea, you can set up a scheduler to automatically run a dailyimport at defined time intervals. When having defined up to four time intervals, click theSchedulebutton, if you want to close the dialog box and start the Scheduler. On theinformation bar, the status of the TSI Schedulerhas changed to display the time for the nextscheduling. If you have not selected at least one of theActivecheck boxes within theScheduler Settingsarea in the Import Time Seriesdialog box, TSI Schedulerwill displayOffas default.

Please note, that importing time series may lead to data groups with different numbers ofmeasurements in each data group. Only if each SCADA tag has a measurement at eachtime tag, all data groups will contain measurements from all SCADA tags.

Seven Technologies


17/64


Page 16 of 64

File settings

In the File settings area, choose a List separator, a Decimal sign, a Date separatoranda Date formatfrom the lists.

Files to importYou can import more than one file at a time, but the files must be located in the same folder.

In the upper list of the Files to importarea, select a drive on your computerIn the box below, browse to the folder with the files you want to import.Choose a file extension in the bottom list.In the box right above the bottom list, click the files for import while holding down the CTRLkey on your keyboard.

When you have completed defining the settings for importing time series, click Close.

14

52

7

3

6

Figure 3.7 The Import Time Series dialog box

3.1.7 EXPORT > TAG CONFIGURATIONS

If you want to export a complete list of configured SCADA tags within the current database to an ASCIIfile, point Exportin the Filemenu, and click Tag Configurationsto open the dialog box displayed inFigure 3.8

The procedure for exporting a complete list of configured SCADA tags within the current database to an

Seven Technologies


18/64


Page 17 of 64

ASCII file is identical the procedure importing SCADA tags as described in section 3.1.5.The procedureis illustrated by example in Appendix A.

Figure 3.8 The Export Tags dialog box

3.1.8 EXPORT > TIME SERIES

To export historical data for a user defined selection of SCADA tags, point to Export in the File menu,and click Time Seriesto open the dialog box displayed in Figure 3.9.

The format of the exported file resembles that of the import file as described in section 3.1.6,except thatonly one SCADA tag is included in each export file.

In the Export Historydialog box, select the SCADA tags you want to export by clicking the relevant fileswhile holding down the CTRL key on your keyboard. To start the export, click the Exportbutton, browsefor a folder in which to place the export files, and click OK. The export files will be saved with the same

names as the SCADA tags and with the file name extension .csv.

Seven Technologies


19/64


Page 18 of 64

Figure 3.9 The Export History dialog box

3.1.9 RESET HISTORY

If you want to reset the historical part of the database, click Reset Historyin the Filemenu, to open thedialog box displayed in Figure 3.10.If you want to create a backup file of the database before the historyis reset, click Yes. The backup is created according to a normal backup as described in section 3.2.4.

The backup database and the original database are both compressed during the process.Backup is only applicable for saving Access databases.

Figure 3.10 Reset history

3.1.10 EXIT

Click Exitin the File menu to close Data Manager. All changes made to the currently loaded database

Seven Technologies


20/64


Page 19 of 64

are automatically saved.

3.2 CONFIGURE MENU

The Configuremenu contains commands for configuring data sources, data tags, cyclic buffers anddefinitions of default database settings. Below you can see descriptions of the dialog boxes related tothese commands.

3.2.1 DATA SOURCES

When you configure how data are to be collected in Data Manager, you must first configure the datasources. In the Configuremenu, click Data Sourcesto open the dialog box displayed in Figure 3.11.

The following five connection types are available:

OLE DB DAIO External OPC Algorithm

You must define different parameters depending on the type of data source. There are no limitations tothe number of sources of each type as long as they have unique names.

The check boxesActiveand UTCare common settings for all types of data sources. If theActivecheckbox is selected, Data Manager will search for new data in each data preprocessing cycle. Selecting the

UTCcheck box, will make Data Manager convert the raw UTC (coordinated universal time) timestamp toa local timestamp value.

OLE DBThis connection type is used when the data source is a database that can be accessed via ActiveX DataObjects.

In the Connection typelist, select OLE DB. If data for all tags in this source can be extracted by ageneric SQL statement, the statement can be defined on data source level instead of tag level. You mayuse two substitution rules in SQL statements: $TAG and $LastTime. $TAG will be replaced by theindividual tag name, and $LastTime will be replaced by the time tag of the previous data extracted foreach individual tag. When using the $LatTime substitution rule a full substitution including the time stamp

format for the specific database is used:

#YYYY-MM-DD HH:MM:SS# for Access data sources "YYYY-MM-DD HH:MM:SS" for SQL Server data sources { ts 'YYYY-MM-DD HH:MM:SS' } for ODBC data sources

Seven Technologies


21/64


Page 20 of 64

Figure 3.11 Data sources, OLE DB

DAIOThis connection type is used if data is transferred by a separate application, which is activated by DataManager, transfers the data.

In the Connection typelist, select DAIO. You can add any parameters if needed, see Figure 3.12 forexample of the standard DMDAIO which is supplied with Data Manager..

Seven Technologies


22/64


Page 21 of 64

Figure 3.12 Data sources, DAIO

ExternalThis connection type is used if data is delivered to Data Manager by an external data source without anyaction or control made from Data Manager.

In the Connection typelist, select External. You cannot define parameters for data sources.

Seven Technologies


23/64


Page 22 of 64

Figure 3.13 Data sources, External

OPCThis connection type is used if data is to be extracted from an OPC server or uploaded to an OPC server.

In the Connection typelist, select OPC. Data will be transferred through the Data Manager OPC Client,which you must configure separately.

Seven Technologies


24/64


Page 23 of 64

Figure 3.14 Data sources, OPC

Algori thmIn the Connection typelist, selectAlgori thm. This connection type is used for calculating arithmeticexpressions or doing reductions on tags within Data Manager. You cannot define an algorithm on sourcelevel, as arithmetic expressions are entered on tag level.

Seven Technologies


25/64


Page 24 of 64

Figure 3.15 Data sources, Algorithm

3.2.2 DATA TAGS

When you have defined the data sources in a configuration, the tags in the data sources must be addedand configured. In the Configuremenu, click Data Tagsto open the dialog box displayed in Figure 3.16.

Seven Technologies


26/64


27/64


Page 26 of 64

Figure 3.17 Defining Ari thmetic on the Extract tab in the Data Tag Details dialog box

If you want perform a data reduction, select the Reductionoption. You can choose three types ofreduction expressions; that is time series minimum, average and maximum. The expressions are definedas follows:

TSmin(['Tag'], 'Period', 'Time Assignment') TSavg(['Tag'], 'Period', 'Time Assignment') TSmax(['Tag'], 'Period', 'Time Assignment')

These reduction functions will each create a time series, in which the time interval equals the 'Period' forthe selected 'Tag'. 'Time Assignment' values are "L", "C" and "R", which indicates if the reduced data timetag will be justified left, centre or right of the reduction interval.

Figure 3.18 displays the data reduction "TSmin([q1],5,C)". This expression will create a time series withfive minute intervals starting at midnight. Every five minutes the data is reduced to one value only, in thiscase to the minimum value. The reduced value is then added to the timestamp in the centre of theinterval. If an interval does not contain a value, the preceding reduced value will be reused.

Seven Technologies


28/64


Page 27 of 64

Figure 3.18 Defining Reduction on the Extract tab in the Data Tag Details dialog box

Conversion tabYou can convert raw data from any data source directly to another unit, if you enter conversion factor andoffset values on the Conversiontab as shown in Figure 3.19.

Seven Technologies


29/64


Page 28 of 64

Figure 3.19 The Conversion tab in the Data Tag Details dialog box

Check tabAfter converting the data, you can configure data checks. In theAbsolute value area, you must enter aminimum and a maximum value for data conversion. If the converted value is not within the given interval,it will be emulated. To enable theAbsolute value feature, make sure that you have selected theActivecheck box.

In the Rate of changearea, a minimum and a maximum value are used for checking that the convertedvalue has changed within the given interval since the previous converted value. If not, it will be emulated.To enable the Rate of changefeature, make sure that you have selected theActivecheck box.

When you enable both theAbsolute valueand the Rate of changeoptions by selecting theActivecheck boxes, data will be emulated, if either of the checks fails.

Seven Technologies


30/64


Page 29 of 64

Figure 3.20 The Check tab in the Data Tag Details dialog box

In Figure 3.21 below you can see an overview of the data flow in connection with data checks.

Seven Technologies


31/64


Page 30 of 64

Figure 3.21 Flow of data in the data check process

Emulation tabThree methods for emulation are available in Data Manager (see Figure 3.22):1. Default value

Measurements are substituted by a default value that remains constant.

2. Average valueEmulations are based on the average of previous values, which have not been emulated. Emulated

Seven Technologies


32/64


Page 31 of 64

or faulty data will not be used when calculating the average value. In the Periodbox within theAverage valuearea, enter the number of values to be used for calculating the average.

3. Reference tag valueMeasurements are substituted by the converted measurement from another tag chosen from theTag list. The tag selected from the Tag list is also converted directly.

If you want to enable emulations, make sure to select the relevantActiveboxes.

Figure 3.22 The Emulation tab in the Data Tag Details d ialog box

Seven Technologies


33/64


Page 32 of 64

Figure 3.23 below illustrates the data flow in data emulations.

Figure 3.23 Flow of data in data emulations

Other tabThe Store historical data check box is selected by default as displayed in Figure 3.24.The selectionensures that historical data is saved in the database, thus making it available in other applications. If youdo not want to save historical data, clear the Store historical data check box. If the check box isselected, enter an interval in minutes in the Storage interval (minutes)box, and select the Store

histor ical data in packets check box, if you want Data Manager to save the preprocessed data incompressed data packets in the database.

Check the Update client box in the OPCarea, if you want the converted data from a tag to be availablefor the OPC Client.

Seven Technologies


34/64


Page 33 of 64

Figure 3.24 The Other tab in the Data Tag Details dialog box

3.2.3 CYCLIC BUFFERS

A cyclic buffer is a time series dynamically maintained by the data preprocessor (see section 3.3.1). Thetime series is made up of time tags of identical intervals, for example one hour. When enabled, thepreprocessor maintains all enabled buffers by updating the minimum, maximum and average value wherethe time tag corresponds to the actual time. A buffer may contain any number of SCADA tags to bemaintained as a uniform time series. If you define a historical period in weeks, the buffer tags arecalculated based on minimum, maximum and averages over this period. A historical offset may bedefined, e.g. a historical period of 2 and a historical offset of 3 will go 3 weeks back in time and then usethe 2 weeks before that to calculate the buffer.

In the Configuremenu, click Cyclic Buffersto open the dialog box displayed in Figure 3.25.

In the Cyclic Buffersdialog box, you can:Select a buffer from the Buffer name list, which contains all defined buffer namesClick the Newbutton and type a name, if you want to add a new buffer to the configurationClick the Renamebutton to type a new name for an existing bufferClick the Copy Asbutton to use an existing buffer as a "template" for creating a new buffer

TheBuffer container box includes a list of all the SCADA tags included in the displayed buffer. If youwant to delete a tag from the current buffer, select the relevant tag in the Buffer containerbox, and clickthe Remove selected tags from buf ferbutton. If you want to delete more than one tag, hold down theCTRL key while you select the tags to be deleted, and then click Remove selected tags from buf fer.

To add a SCADA tag to the current buffer, select the tag from the Select tag to add to buffer list, and

Seven Technologies


35/64


Page 34 of 64

clickAdd.

In the Buffer Settingsarea, you can define the time series intervals for the buffer and set the historicalaveraging period. To enable the buffer and make the buffer time series reinitialize when closing the bufferconfiguration, select the Buffer enabledcheck box.

If needed, you may add a descriptive comment to the buffer in theComment field.

Click the Initializebutton to initialize the current buffer, and clickApply, if you want to save changes tothe buffer without closing the dialog box. When you have clickedApply, the action(s) cannot be undone.

Click Closeto close the dialog box and automatically save the changes, whereas clicking the Cancelbutton closes the dialog box without saving any changes, unless you previously clickedApply.

Please note that clicking the Deletebutton will remove all information from the Cyclic Buffersdialog box.However, you can restore the original buffer settings by clicking Reset.

Figure 3.25 The Cycl ic Buffers dialog box

3.2.4 PREFERENCES

In the Configurationmenu, click Preferences to open the dialog box displayed in Figure 3.26.In the Preferencesdialog box, you must define a number of general parameters on the four tabs beforethe system can be configured, such as system log, auto start, default substitution rules and historical dataand backup definitions. The most important parameters are described below.

Seven Technologies


36/64


37/64


38/64


Page 37 of 64

On the Othertab in the Data Tag Detailsdialog box (see Figure 3.24), you decided whether or not tosave historical data for the individual tag. Select the Store historical datacheck box in the Preferences

dialog box displayed in Figure 3.28 to save historical data for those tags. If you regret clearing the Storehistorical datacheck box on the Othertab in the Data Tag Detailsdialog box for one or more tags, youcan now choose to save historical data for all tags. Click the Select allbutton to save historical data forall tags, or click the Clear allbutton to save no historical tag data.

Define a default time for preprocessing the SQL statement "$LastTime" in the Default$LastTimearea byclicking one of the three options Start of day, Start of w eekor Start of month .

Select the Write raw data to ASCII filecheck box, if you want Data Manager to save raw data to an

ASCII file. Type a file name in the box below the check box, or click the browse button to select a file.The file is overwritten in connection with each preprocessing cycle.

Select the Write preprocessed datacheck box, if you want Data Manager to save preprocessed data toan ASCII file. Type a file name in the box below the check box,

or browse for a file by clicking the button . The file is overwritten in connection with eachpreprocessing cycle.

For more information about data preprocessing, see section 3.3.1.

Figure 3.28 The Preprocessor tab in the Preferences dialog box

Executable Files tabYou must define, if you want to execute the file(s) prior to or after each preprocessing cycle. Type the filename(s) in the Filebox(es) within the Pre-executable filesarea, to have the file(s) executed prior to a

Seven Technologies


39/64


Page 38 of 64

preprocessing cycle. On the other hand, if you want the file(s) to be executed after a preprocessing cycle,type the file name(s) in the Filebox(es) within the Post-executable filesarea. You may also browse for

files by clicking the button(s) .

In theArguments boxes, you may add program specific parameters, which will be used when therelevant file is executed.

Select the Enabled check box for each file to enable the settings for that file.

Selecting the Wait for process to finishcheck box indicates that the preprocessor will temporarily stopbefore handling measurements.

You can select the Halt on errors check box to ensure that Data Manager stops the preprocessor, if theexecutable file generates errors.

Figure 3.29 The Executables tab in the Preferences dialog box

Backup tabTo prevent poor performance and loss of data you can set Data Manager to automatically back up thedatabase in a compressed format and reset the current database. As the database is not available duringfile compression, the preprocessor will temporarily stop during the process.

Select theAutomatic Access database backup check box, if you want Data Manager to automaticallybackup the Access database.

In the Backup directorybox, type a folder name or browse for a folder by clicking the button .

In theBackup in tervalarea, select one of the three options to set a regular backup interval. Data

Seven Technologies


40/64


Page 39 of 64

Manager will perform a backup at midnight by the end of the selected period option. Furthermore, theadditional featureAnd i f the database reaches [XXX] MB ensures backup action, if the database

exceeds the database size selected in the list. Please note that this feature does not overrule the otherbackup settings, but simply creates an extra backup when reaching the specified limit.

In the Historical overlap (days)box, you can define how many days back you want Data Manager tobackup the database. When backing up the database or resetting history (see section 3.1.9) only datathat goes back further than the number of days specified will be deleted.

Figure 3.30 The Backup tab in the Preferences dialog box

3.3 RUN MENU

3.3.1 PREPROCESSOR

In the Run menu, click Preprocessorto open the dialog box displayed in Figure 3.31.If you do not seethe Schedulearea, click the Scheduler button.

Seven Technologies


41/64


Page 40 of 64

Figure 3.31 The Run Preprocessor dialog box

Select the Scheduleoption if you want to run the preprocessor in scheduler mode. In Scheduler, youcan define up to four times daily for the preprocessor to start. Scheduling is typically used if you want totransfer data in groups from a SCADA system to Data Manager.

In the Interval (in minutes)box, specify the interval between each preprocessing cycle. If you set the

time to "0", the preprocessor will run only once when enabled. If an s follows the numerical value, DataManager will interpret the interval as seconds. If the number entered is a negative, the preprocessor willrun with no delay between the preprocessing cycles.

If you want to define a start time for the preprocessor, select the Start at check box and specify a starttime and date by selecting from the three lists within the Start atarea. When the preprocessor is running,a status window with process details is displayed. Click the Startbutton to start the preprocessor.

Double-clicking the Run Preprocessor dialog box opens the Preprocessor Status dialog box displayedin Figure 3.32.

For more information about data preprocessing, see section 3.2.4.

Seven Technologies


42/64


Page 41 of 64

Figure 3.32 The Preprocessor Status dialog box

3.4 TOOLS MENU

3.4.1 RESET > AVERAGE VALUES

When the preprocessor is running, it maintains average values for each individual tag on the basis of theamount of data specified on the Checktab in the Data Tag Detailsdialog box.You can reset calculation of average values by using this feature for resetting the values.

Point to Resetin the Toolsmenu, and clickAverage Valuesto delete all average values. This optionmay be used, if the system has been restarted and you want to reload the average values that arecurrently running.

3.4.2 RESET > TABLE LOCKS

Point to Resetin the Toolsmenu, and click Table Locksto reset all table locks and timeout tableavailability.

3.4.3 RESET > CYCLIC BUFFERS

Point to Resetin the Toolsmenu, and click Cyclic Buffersto remove the current cyclic buffer values.

3.4.4 INITIALIZE > CYCLIC BUFFERS

Point to Initializein the Toolsmenu, and click Cyclic Buffersto initialize cyclic buffers.

Seven Technologies


43/64


Page 42 of 64

3.5 VIEW MENU

In the Viewmenu, you can choose from several table and graphic views.

Historical data cannot be displayed while the preprocessor is running.

3.5.1 MEASUREMENTS

In the View menu, click Measurements to open the dialog box displayed in Figure 3.33.The Measurements dialog box displays a simple table of all active SCADA units with the latest receivedraw measurements and the corresponding preprocessed values.

After each preprocessing cycle and when you press the Refreshbutton, the table is automatically

updated.

If you double-click a tag name in the DM Tagcolumn, a graph with a time series plot for the selected unitopens (see section 3.5.3).

Measurement details may be displayed in different ways. If you select a cell in the table and click theApply Filterbutton, only data entries with this specific text or value are displayed.

Example: In the Parametercolumn, select a cell containing the parameter Pressure. ClickApplyFilter. Now you will only see data entries that contain Pressurein the Parametercolumn.

To disable the filter, click Filter off.

Figure 3.33 The Measurements d ialog box

Clicking the Legends button opens the dialog box displayed in Figure 3.34.The Raw status legendsand the DPP status legendsboxes provides you with detailed information about the numerical codes

Seven Technologies


44/64


Page 43 of 64

representing the two legend types.

Figure 3.34 The Legends dialog box

3.5.2 HISTORICAL DATA

If you store historical data within the database, they can be displayed in the Historical Datadialog boxdisplayed in Figure 3.35.In the Viewmenu, click Historical Data. Data is displayed chronologically ingroups listing the oldest first.

The dialog box includes several options for limiting the number of rows displayed. You can define the listof historical data to be displayed by selecting one of the options in the Data Period area. For instance,select Dayto see data 24 hours back in time, or select Month to see data a month back in time (that is30 days of 24 hours). You may also define your own settings if you select the User defined option anddefine a time interval by typing date and/or time values in the Start and End boxes using the format"yyyy-mm-dd hh:mm", for example "2005-10-30 08:30".

In the Filter area, you can narrow down the list of historical data even more by selecting from the Datasourceand Parameterlists. ClickApplyto enable a filter, and click Resetto undo the selection(s).

When you have specified how historical data is to be displayed, click Refresh.

For more information about theLegends

button, see section 3.5.1 and Figure 3.34 above.

Seven Technologies


45/64


46/64


Page 45 of 64

Figure 3.36 The Data Graph dialog box and the shor tcut menu

If you double-click the graph, you can open the Main Title Customizationdialog box that contains thesame options as the shortcut menu.

Figure 3.37 The Main Title Customization dialog box (the Color tab)

Seven Technologies


47/64


Page 46 of 64

Double-clicking the Main Title Customization dialog box opens the Export Main Title dialog boxdisplayed in Figure 3.38.In this dialog box, you can specify the file format in the Export, the destination

for the export in the Export Destinationarea, and a size for the object you want to export in the ObjectSize area. When you have finished making your selections, click Export, or click Cancelto close thedialog box without exporting.

Figure 3.38 The Exporting Main Title dialog box

3.5.4 BUFFER GRAPH

When you point to the graph and click the right mouse button, a shortcut menu appears. The shortcutmenu is displayed with the Buffer Graphdialog box in Figure 3.39 below.

Seven Technologies


48/64


Page 47 of 64

Figure 3.39 The Buffer Graph dialog box and the shortcut menu

Double-clicking the Buffer Graph dialog box opens the Main Title Customization dialog box (see Figure3.37 above).

Double-clicking the Main Title Customization dialog box opens the Export Main Title dialog box (seeFigure 3.38 above)

3.5.5 EVENT LOG

In the Viewmenu, click Event Logto open the dialog box displayed in Figure 3.40.All events that are generated within Data Manager and considered relevant for the operator are stored inthe event log.

Seven Technologies


49/64


Page 48 of 64

Figure 3.40 The Event Log dialog box

Double-clicking a row in the Event Logdialog box opens the detailed Event Viewer displayed in Figure3.41.In the Event Viewer, you can copy events to the clipboard and print and delete events. Click thePreviousand Nextbuttons to see the different events.

Figure 3.41 The Event Viewer dialog box

3.5.6 SYSTEM LOG

All events generated within Data Manager are stored in the system log as a .txt file. This log is mainlyused when tracking system errors or inconsistencies. In the View menu, click System Logto open thelog file in Notepad.

Seven Technologies


50/64


51/64


Page 50 of 64

4 OPC CLIENT

4.1 OPC INTRODUCTION

The OPC communication is based on the OPC (OLE for Process Control) protocol supported by someSCADA systems. If supported, the SCADA system will include an OPC server enabling OPC clients tosubscribe on SCADA objects, which is then updated on changes (event driven). The communication istwo-ways allowing exchange of data to and from SCADA.

Figure 4-1 Overview of OPC data flow and involved applications

DMopc IDs

OPC serverDMopcclient

OPC data

Data Manager DB

Serve namItem

Send dataReceive dat

SCAD configuration Ra data

Preprocessed data Historical data Cyclic buffer

DataManagerProcessing

module

OPCBROWSEData ManagerOPC Clientconfiguration

OPC ServerData

Manager

OPC Client

OPC data

Data Manager DB

Serve namItem

Send dataReceive dat

SCAD configuration Ra data

Preprocessed data Historical data Cyclic buffer

DataManagerProcessing

module

OPC Browser

Seven Technologies


52/64


53/64


54/64


55/64


Page 54 of 64

Figur 4-4 Descr ipt ion of menu i tems in OPCBROWSE

4.3 GUIDE TO OPC CONFIGURATION

This section describes step by step how an OPC communication is established. It is assumed that theuser knows the basic concept of OPC and that an OPC server has been configured and is running.

Step 1: Configure registry

Registry must be configured manually using the following entries:

Entry Description[HKEY_CURRENT_USER\Software\7-Technologies\DMOPC] Section name[HKEY_CURRENT_USER\Software\7-Technologies\DMOPC\V2.00.00]

Section name

[HKEY_CURRENT_USER\Software\7-Technologies\DMOPC\V2.00.00\Environment]

Section name

"Workdirectory"="C:\\7t\\Databaser" Database location for Data Managerdatabase and the basic OPC database.

"Config Directory"="C:\\7t\\Databaser" Location of configuration files for DMOPCand OPCBROWSE. Specifically location ofthe CSV file.

"FileName.mdb"="DM-OPC-OKF.MDB" File name of OPC data DB.HKEY_CURRENT_USER\Software\7-Technologies\DMOPC\V2.00.00\LogLevels]

Section name

"DMOPC"=dword:00000001 Defines log level of OPC communication.The log level is defined as an integer from 0to 100.0 defines that only fatal errors are reportedin the log file.

Greater values will give increasingly moreinformation.

The log file includes two files nameddrvlog0.log and drvlogx.log located in theconfiguration directory.

[HKEY_CURRENT_USER\Software\7-Technologies\DMOPC\V2.00.00\OPCCLIENT]

Section name

"ActivationInterval"=dword:0000000a Internal setting."NumberOfBuffers"=dword:000000c8 Internal setting."DBObjectNumber"=dword:00000000 Internal setting."DBAtomNumber"=dword:00000000 Internal setting."DBMask"=dword:00000000 Internal setting.

Seven Technologies


56/64


57/64


58/64


Page 57 of 64

6. Tag names may be deleted via a selection of a tag in the right column followed by a right clickand selection of Delete or activation of the Delete key.

7. Activate menu item Save CSV to save all configured data.

Please observe that the stored CSV file will replace earlier stored data in the database (OPC data DB) assoon as the preprocessing cycle is started in Data Manager.

Step 5: Start Data Manager

Start the Data Manager preprocessing cycle.

Step 6: Check communication

Cross check the data communication from SCADA to the Data Manager (view measurements). A typicalerror is conflicting tag names between Data Manager and the OPC Browser.

Seven Technologies


59/64


Page 58 of 64

APPENDIX A DATA CONFIGURATION FILE

Data configuration files can be imported into or exported from the database. The files must be configuredas described in Table A1 below.

1. The first data line is a header line displaying each column name as text.

2. Lines starting with a number sign (#) or an exclamation point (!) are ignored during import.Such lines are used for specifying comments.

3. All text must be enclosed in double quotes (").

4. Semicolons (;) separate all data.

5. When the data type "Yes/No" is used, 1represents "Yes" and 0represents "No".

Name Type Size Descrip tion

ScadaID Text 80 SCADA tag name.AdaptionZoneID Text 1 Dummy parameter, always P.ObjectName Text 40 Name of object in AQUIS/TERMIS where

SCADA unit is placed.ObjectTypeID Integer 2 Type of object.DataTypeID Integer 2 Measurement data type.LczName Text 40 Name of leakage control zone in

AQUIS/TERMIS where SCADA unit isplaced.

MinValue Single 4 Minimum value used for absolute rangecheck.

MaxValue Single 4 Maximum value used for absolute rangecheck.

ApplyAbsCriteria Yes/No 1 Defines if absolute range check is enabled ordisabled.

DefaultValue Single 4 Default value for data emulation.ConvFac Single 4 Data conversion factor.Offset Single 4 Data conversion offset.SudStatusID Integer 2 Status of SCADA unit.AdapFlowCor Single 4 Pressure adaptation factor.MaxAdapFlowCor Single 4 Max. flow to be moved by pressure adaption.MinChange Single 4 Min. value for absolute range check.MaxChange Single 4 Max. value for absolute range check.ApplyChangeCriteria

Yes/No 1 Defines if rate of change check is enabled ordisabled.

AveragingCycles Integer 2 Number of averaging cycles to be used indata emulation.

SubstituteScadaID Text 80 Substitute SCADA unit used for emulations.SubstituteOffset Single 4 Offset applied to substitute measurement.SudstituteFactor Single 4 Factor applied to substitute measurement.EmulationMethodID Integer 2 Selected emulation method.Comment Memo - Optional text.

Table A1 Data line specif ications

Seven Technologies


60/64


Page 59 of 64

Below you can see an example of how data line configurations are specified.

# SCADA UNIT DEFINITION EXPORTED BY 7T-DM Version 1.1 Rev.42 - 20/09/2001 13:40:42# TOTAL NUMBER OF UNITS:11

"ScadaID";"AdaptionZoneID";"ObjectName";"ObjectTypeID";"DataTypeID";"LczName";"MinValue";"MaxValue";"ApplyAbsCriteria";"DefaultValue";"ConvFac";"Offset";"SudStatusID";"AdapFlowCor";"MaxAdapFlowCor";"MinChange";"MaxChange";"ApplyChangeCriteria";"AveragingCycles";"SubstituteScadaID";"SubstituteFactor";"SubstituteOffset";"EmulationMethodID";"Comment"

"P702-01Q";"P";"6166";1;1;"702";-40;-1;1;-9;-1;0;0;1;0;-1000;1000;0;12;"P702-01Q";1;0;1;"""P709-01NQ";"P";"L-4286";2;1;"709";999;1000;1;0;1;0;0;1;0;-1000;1000;0;12;"P709-01Q";-1;0;2;"""P709-01Q";"P";"L4286";2;1;"713";1;40;1;25;1;0;0;1;0;-1000;1000;0;12;"P709-01Q";1;0;1;"""P709-02NQ";"P";"P-2192";2;1;"721";999;1000;1;0;1;0;0;1;0;-1000;1000;0;12;"P709-02Q";-1;0;2;"""P709-02Q";"P";"P-2192";2;1;"709";0.1;20;1;1.5;1;0;0;1;0;-1000;1000;0;12;"";1;0;1;""

"P710-01Q";"P";"1000";1;1;"710";-100;-5;1;-50;-1;0;0;1;0;-1000;1000;0;12;"P710-01Q";1;0;1;"""P711-01NQ";"P";"L-0391";2;1;"711";999;1000;1;0;1;0;0;1;0;-1000;1000;0;12;"P711-01Q";-1;0;2;"""P711-01Q";"P";"L-0391";2;1;"710";1;70;1;30;1;0;0;1;0;-1000;1000;0;12;"";1;0;1;"""P712-01NQ";"P";"P-2185";2;1;"712";999;1000;1;0;1;0;0;1;0;-1000;1000;0;12;"P712-01Q";-1;0;2;"""P712-01Q";"P";"P-2185";2;1;"711";1;20;1;8;1;0;0;1;0;-1000;1000;0;12;"P712-01Q";1;0;1;"""P713-01Q";"P";"4000";1;1;"713";-80;-1;1;-35;-1;0;0;1;0;-1000;1000;0;12;"";1;0;1;""

Seven Technologies


61/64


Page 60 of 64

APPENDIX B HISTORICAL DATA FILEThe historical data file containing logger data and other time series data that can be imported to thedatabase must be formatted as described in Table B1 below.

1. All texts are enclosed in double quotes (").

2. All data are separated by semicolons (;).

3. The first data line is a header line containing TIME and the relevant number of SCADA unitnames as texts. See the format specifications below.

4. Line starting with a number sign (#) or an exclamation point (!) are ignored during import.Such lines are used for specifying comments.

Name Type Size Descrip tion

TIME Date/Time

8 Time tag for data line. Must have the formatDD-MM-YYYY HH:MM

SCADA unit 1 Single 4 Measurement value for the first SCADA unit... .. .. ..SCADA unit N Single 4 Measurement value for the Nth SCADA unit.

Table B1 Header line format

Below you can see an example of how logger data line files are specified.

"TIME";"M16KALNPRE";"M14KALNFLO";"M15KALNFL;"M11LBYPRE";"M18KALNFLO";"M2LBYFLO"

01/06/2001 00:00;53.685;5.179;-5.208;60.637;1.537;1.52601/06/2001 00:05;53.578;5.209;-5.167;60.776;1.529;1.52501/06/2001 00:10;53.798;5.177;-5.179;60.261;1.53;1.53201/06/2001 00:15;53.609;5.178;-5.208;60.686;1.529;1.52301/06/2001 00:20;53.993;5.203;-5.192;60.744;1.531;1.53201/06/2001 00:25;53.923;5.2;-5.214;60.731;1.534;1.5301/06/2001 00:30;53.741;5.188;-5.168;60.303;1.523;1.52701/06/2001 00:35;53.936;5.192;-5.184;60.393;1.522;1.53401/06/2001 00:40;53.902;5.167;-5.174;60.793;1.525;1.52401/06/2001 00:45;53.858;5.193;-5.169;60.71;1.529;1.52701/06/2001 00:50;54.148;5.207;-5.205;60.743;1.531;1.52601/06/2001 00:55;54.311;5.201;-5.184;60.729;1.534;1.537

01/06/2001 01:00;54.356;2.862;-2.883;60.428;1.178;1.17401/06/2001 01:05;54.367;2.859;-2.868;59.957;1.17;1.1701/06/2001 01:10;54.268;2.866;-2.87;60.249;1.175;1.1701/06/2001 01:15;54.361;2.871;-2.87;60.165;1.174;1.16901/06/2001 01:20;54.44;2.866;-2.856;59.966;1.17;1.16801/06/2001 01:25;54.115;2.856;-2.866;60.184;1.169;1.17501/06/2001 01:30;54.485;2.863;-2.882;59.9;1.17;1.17601/06/2001 01:35;54.04;2.878;-2.873;60.165;1.174;1.16801/06/2001 01:40;54.484;2.873;-2.882;60.109;1.177;1.17301/06/2001 01:45;54.446;2.861;-2.864;60.275;1.175;1.171

Seven Technologies


62/64


Page 61 of 64

APPENDIX C ARITHMETIC EXPRESSIONS

The arithmetic expressions recognizes the mathematical and physical operators, functions and constantslisted in Table C1, Table C2 and Table C3 below.

Operator Descrip tion Note

+ Addition- Subtraction* Multiplication/ Division% Percentage\ Integer division^ Raise to power

|| Absolute value! Factorial> Greater than>= Greater than or equal< Less than


63/64


Page 62 of 64

Function Descrip tion Note

abs(x) Absolute valueatn(x), atan(x) Inverse tangentcos(x) Cosinesin(x) Sineexp(x) Exponentialfix(x) Integer part, no roundingint(x) Integer part, roundingdec(x) Decimal partln(x) Logarithm naturallog(x) Logarithm decimalrnd(x) Randomsgn(x) Signsqr(x) Square rootcbr(x) Cube roottan(x) Tangentacos(x) Inverse cosineasin(x) Inverse sinecosh(x) Hyperbolic cosinesinh(x) Hyperbolic sinetanh(x) Hyperbolic tangentacosh(x) Inverse hyperbolic cosineasinh(x) Inverse hyperbolic sineatanh(x) Inverse hyperbolic tangentroot(x;n) N'th rootmod(a;b) Integer division remainderfact(x) Factorialcomb(n;k) Combinationsperm(n;k) Permutationsmin(a;b) Minimum of two numbersmax(a;b) Maximum of two numbersmcd(a;b), gcd(a;b) Maximum common divisor of two numbersmcm(a;b), lcm(a;b) Minimum common multiple of two numberserf(x) Error, Gausssgamma(x) Gammagammaln(x) Logarithm gammadigamma(x) Digammabeta(x;y) Betazeta(x) Zeta, Riemmans

ei(x) Exponential integralcsc(x) Cosecantsec(x) Secantcot(x) Cotangentacsc(x) Inverse cosecantasec(x) Inverse secantacot(x) Inverse cotangentcsch(x) Hyperbolic cosecantsech(x) Hyperbolic secantcoth(x) Hyperbolic cotangentacsch(x) Inverse hyperbolic cosecantasech(x) Inverse hyperbolic secantacoth(x) Inverse hyperbolic cotangent

Seven Technologies


64/64


Page 63 of 64

Function Descrip tion Note

rad(x) Radiant conversion

deg(x) Degree (90) conversiongrad(x) Degree (100) conversionround(x;d) Rounding with d decimals

Table C2 Arithmetic functions

Constant Descript ion Note

h# Planck 6.6260755e-34 JsK# Boltzmann 1.380658e-23 J/Kq# Elementary charge 1.60217733e-19 CA# Avogadro 6.0221367e23 mol-1

c# Speed of light 2.99792458e8 m/s

mu# Permeability of vacuum 12.566370614e-7 Tm/Jeps# Permittivity of vacuum 8.854187817e-12 C/Jmme# Electron rest mass 9.1093897e-38 kgmp# Proton rest mass 1.6726231e-27 kgmn# Neutron rest mass 1.6749286e-27 kgR# Gas constant 8.31451 mkg/sk molG# Gravitational constant 6.672e-11 m/kg sg# Acceleration due to gravity 9.80665 m/s

Table C3 Arithmetic constants

datamanager - user guide

Documents