User's Guide 0 21/12/ /03/ /02/ /03/ /02/ /05/ MS1-7428

Transcription

1 User's Guide 0 21/12/ /03/ /02/ /03/ /02/ /05/ MS1-7428

2 Contents CONTENTS... 2 I. ARCHITECTURE OF THE E.ONLINE SYSTEM... 6 II. TECHNICAL ARCHITECTURE OF E.ONLINE... 7 III. QUICK PRESENTATION... 8 IV. INSTALLATION OF THE SOFTWARE... 9 V. ACTIVATION OF THE SOFTWARE VI. MODIFYING THE LICENCE OPTIONS VII. SERVICES ACTIVATED BY THE E.ONLINE APPLICATION VIII. STOPPING / RESTARTING E.ONLINE IX. DESCRIPTION OF THE E.ONLINE MENU X. CREATING E.ONLINE USER ACCOUNTS XI. CONFIGURING AND USING THE DASHBOARD: E.ONLINEBOARD XII. CREATING A COMMUNICATION LINK XIII. CREATING AN FTP SERVER COMMUNICATION LINK XIV. CREATING A COMMUNICATION LINK WITH AN ELOG CONCENTRATOR XV. CREATING THE ARCHITECTURE OF THE DEVICES XVI. CREATING THE ENERGY USE FOR THE DEVICES XVII. CREATING COMMUNICATING JBUS MODBUS DEVICE XVIII. CREATING A RADIO FREQUENCY DEVICE

3 XIX. CREATING A DEVICE OR VARIABLE WITH MANUAL DATA INPUT XX. MANUAL DATA INPUT XXI. CREATING A CONSTANT XXII. VIEWING THE QUANTITIES MEASURED BY THE DEVICES XXIII. CREATING AN AUTOMATIC AND PERIODIC DATA-RETRIEVAL OF DEVICES AND VARIABLES XXIV. VIEWING THE LOG OF DATA-RETRIEVALS XXV. CREATING AN ENERGY ANALYSIS XXVI. CREATING A GRAPHIC ANALYSIS XXVII. CREATING A CONVERSION RULE FOR THE UNITS XXVIII. CREATING A CALCULATION (MATHEMATICAL OPERATIONS) XXIX. CREATING AN ENPI (ENERGY PERFORMANCE INDICATOR) XXX. ADDING A THRESHOLD TO A PHYSICAL OR VIRTUAL DEVICE XXXI. VIEWING THE HISTORY OF THRESHOLD OVERSHOOTS XXXII. ADDING A GENERIC DRIVER XXXIII. CREATING A DEVICE WITH A GENERIC DRIVER XXXIV. CREATING AN AUTOMATIC PERIODIC TASK FOR SENDING THE ANALYSES AND ALERTS XXXV. PLANNING A MEASUREMENT CAMPAIGN XXXVI. CREATING A PERSONALIZED PAGE TO VIEW DATA IN REAL-TIME XXXVII. CREATING AN ANALYSIS BETWEEN TWO INDICES READ REMOTELY XXXVIII. CREATING A LOAD PROFILE ANALYSIS FOR A DEVICE

4 XXXIX. DISPLAYING THE HISTORY OF RECORDINGS XL. ANALYZING THE LOG OF THRESHOLD OVERRUNS ON U, I AND P XLI. ANALYZING THE LOG OF EXTREME VALUES REACHED ON THE QUANTITIES XLII. CONFIGURING A TARIFF CONTRACT FOR ENERGY UNITS XLIII. CONFIGURING A TARIFF CONTRACT FOR ENERGY INDEX-TYPE UNITS XLIV. CREATING YOUR PERSONALIZED DOCUMENT AREA XLV. CONSULTING AN ANALYSIS IN YOUR DOCUMENT AREA XLVI. PRODUCING AN ANALYSIS REPORT XLVII. DEFINING "HEADERS" AND "FOOTERS" FOR REPORTS XLVIII. ADDING CONTACTS TO THE ADDRESS BOOK XLIX. MODIFYING THE PARAMETER SETTINGS OF THE SOFTWARE L. MODIFYING THE PARAMETER SETTINGS FOR AN ACCOUNT LI. SQL CONNECTOR LII. PRINCIPLE OF AN SQL CONNECTOR / DATA ACCESS LIII. CREATING THE ODBC LINKS LIV. ADDING SQL CONNECTORS LV. DELETING SQL CONNECTORS LVI. MODIFYING SQL CONNECTORS LVII. UPDATING THE SQL CONNECTOR DATA LVIII. DIAGRAM OF THE TABLES OF CALCULATED DATA

5 LIX. DIAGRAM OF THE TABLES OF RETRIEVED DATA LX. DATABASE BACKUP LXI. EONLINE 2 DATABASE RESTORATION LXII. AUTOMATIC BACKUP OF THE DATABASE LXIII. CONTACT APPENDICES

6 I. Architecture of the E.online System This paragraph describes the architecture of an E.online system 6

7 II. Technical Architecture of E.online This paragraph gives details of the various technical elements of E.online USERS HTTP Apache WEB Server (static content) HTTP WEB LAYER Tomcat 6 Application Server WebApp Module (dynamic content) JAVA 6 Remote Data-retrieval Engine Windows layer XML-RPC DB BDD MySQL 5 (display and calculations) (raw data) BUSINESS LAYER RS 485 Ethernet Modem GPRS / STN Radiofrequency Sensor Network SENSOR LAYER 7

8 III. Quick Presentation Here is the general interface of E.online: Drop-down menu Action bar The main elements are: - A drop-down menu allowing you to navigate within the application and go to any page with a single click. - An action bar containing all the actions possible on the page, with access on a "Select and click" basis. 8

9 IV. Installation of the Software This paragraph gives details on how to install E.online on a dedicated machine Prerequisite - Before doing anything else, make sure that you are connected to Windows with an account with administrator rights for the machine. - The latest Microsoft updates must be installed on the PC. - The latest version of Flash Player must be installed. - The WEB browser(s) used must also be up to date. - The ports 8080, 8005 (http), (TCP/UDP), (TCP/UDP) and 3306 (MySQL) must be free. (See EonlineII installation prerequisites) - No other MySQL server or IIS-type Web server installed on the machine). Method - With Windows 7, Windows 2008 Server R2, Windows 8 or Windows Server 2012 Right-click on "setup" and then "Execute as administrator". Accept the conditions of the user licence. 32-bit version: Choose an installation directory (by default "C:\Program Files\Eonline II"). 64-bit version: Choose an installation directory (by default "C:\Program Files x86\eonline II"). Confirm. Click on "End" to confirm and exit from the E.online installation program. 9

10 V. Activation of the Software This paragraph describes how to activate E.online once it has been installed - E.online must have been installed correctly. Method Once installation has been completed, log on to E.online with the Web browser of your choice by going to the following address: (on the PC in local mode only) The default LOGIN / Password pairing is "administrateur / administrateur". Once you are logged on, enter the E.online licence key supplied with the CD. E.online then generates a product key which you have to communicate to the Support Service in order to receive an activation key. By support.logiciels@chauvin-arnoux.com By telephone: (+33) and ask for the "Support Service" Enter the software activation key provided by the Support Service. 10

11 VI. Modifying the Licence Options This paragraph describes the procedure for modifying the E.online licence option - E.online must have been installed correctly. Method Click on the icon and then select the "Licence" menu. (on the PC in local mode only) The default LOGIN / Password pairing is "administrateur / administrateur" Once you are logged on, enter the E.online licence key supplied with the CD. E.online then generates a product key which you have to communicate to the Support Service in order to receive an activation key. By support.logiciels@chauvin-arnoux.com By telephone: (+33) and ask for the "Support Service" Enter the software activation key provided by the Support Service. 11

12 VII. Services Activated by the E.online Application This paragraph gives details of the services used by E.online during action The following services are used by E.online: - MTREngine.exe : Remote Data-Retrieval Engine (\Eonline II\MTR\ MTREngine.exe) - MTRService.exe : Windows Service to launch the remote data-retrieval engine (\Eonline II\MTR\ MTRService.exe) - MTRServer.exe : XMP RPC Server of the remote data-retrieval engine (\Eonline II\MTR\ MTRServer.exe) - mysql-nt.exe : MySQL Database Connector (\Eonline II\MySQL\MySQL Server 5.0\bin\ mysql-nt.exe) - tomcat7.exe : Tomcat Web Application Server (\Eonline II\Tomcat7\bin\ tomcat7.exe) 12

13 VIII. Stopping / Restarting E.online This paragraph describes the procedure for Stopping and Restarting the E.online application manually - Access to the E.online directory. - Administrator rights on the machine. Method For Windows 7, Windows Server 2008 R2, Windows 8 or Windows Server 2012: Right-click and execute the "stopall.bat" script as administrator (\Eonline II \ stopall.bat ) to stop all E.onlineII services. For Windows 7, Windows Server 2008 R2, Windows 8 or Windows Server 2012: Right-click and execute the "startall.bat" script (\Eonline II \ startall.bat ) as administrator to start all E.onlineII services (wait for the services to launch before using E.online). 13

14 IX. Description of the E.online Menu This paragraph describes the E.online menu and functions BY RIGHT-CLICKING ON YOUR MOUSE, YOU CAN ACCESS A CONTEXTUAL MENU ALLOWING YOU TO CHOOSE THE MOST FREQUENTLY-USED MENUS MORE QUICKLY. software EONLINE2 Menu under Menu function Profile "Restricted user" Profile "Standard user" Profile "Administrator" "Home" Board Eonline Customise a w ebpage to view and use real-time and recorded data and alarms yes yes yes Devices Manage: - ENERDIS measurement devices from w hich data can be retrieved - measurement devices from other manufacturers from w hich data can be retrieved (generic driver) - manually-entered digital variables (constants, analogue, index) - alarm thresholds for recorded data no yes (consultation mode) yes Device explorer Manage the graphic representation of devices and variables in a tree structure no yes (consultation mode) yes Configuration - Installation Netw orks and communication View the devices associated w ith communication accessories no Energy use Define the nature and types of use for variables and devices no yes (consultation mode) yes (consultation mode) yes yes Generic drivers Manage drivers to use devices from other manufacturers no no yes Communication Links Manage communication accessories for data retrieval from devices no yes (consultation mode) yes FTP Collector Manage the parameters of FTP servers for the retrieval of data from files in xml format no yes (consultation mode) yes Elog Concentrator Manage the logging parameters of the ELOG Data Logger / concentrator no yes (consultation mode) yes Configuration - Energy Cost Tariff Contracts Tariff Contracts by index Define the tariff contracts applicable to the load curves for the calculation of energy expenditure Define the tariff contracts applicable to the indexes for the calculation of energy expenditure no no yes (consultation mode) yes (consultation mode) yes yes Configuration - Automatic tasks Analyses and Alerts Data retrievals Configure the automatic sending out of analyses and alarms by Configure the automatic retrieval of data from communicating equipment no yes yes no yes yes My address book Manage the address book yes yes yes Accounts Configure the user profiles no no yes Configuration - Setting up License License key management no no yes Softw are settings Configure the settings for display, view ing, etc. no no yes My account Account settings for the user logged on yes yes yes About Access the version number yes no yes Real time Display the data measured by devices in real-time no yes yes View - Measurements Personnalised pages Events Configure personalized pages to view the data measured by one or more devices in real-time Analyze the history of overshoots of U, I and P values for CDTpr and RECDIGIT products no yes yes no yes yes Extremes Analyze the history of minimum and maximum values for CDTpr and RECDIGIT products no yes yes Visualisation - Journals Data-retrieval history Historises of thresholds View the history of communication errors w ith the devices detected during automatic data retrieval Display / Acknow ledge / Delete alarms and threshold overshoots no no yes yes yes yes 14

15 software EONLINE2 Menu under Menu function Data analysis Analyze and display the data recorded in the Database, in the form of tables and charts Profile "Restricted user" Profile "Standard user" Profile "Administrator" yes yes yes Charts analysis Analyze and display the data recorded in the Database, in the form of charts yes yes yes Analysis - Data management Load profil analysis Analyze and display the data of load profiles, in the form of tables and charts yes yes yes Index analysis Analyze and display the difference betw een tw o index values, in the form of tables yes yes yes Enregistrements history Display the data recorded in the database for a Device yes yes yes My documents Manage private and public folders for the storage of analyses yes yes yes Analysis - Edit Production of reports Assemble several analyses to display, print out and export a report yes yes yes Page headers and footers Configure Headers and Footers for the generation of reports yes yes yes Calcul and energy performance Advanced Functions indicator - Tools Conversion of unities Advanced Functions Manual data input - Data Imports Advanced Functions - Data export Mesurements surveys Create arithmetic combinations (+, -, /) for the variables and Devices Define rules for the conversion of measurement units into standardized units (Primary Energy, TCO2, etc.) Manage the variables w hich are not automatically retrieved from devices (e.g.: reading of an index from a counter) Schedule recording periods for measured variables for devices from w hich data can be retrieved no no yes (consultation mode) yes (consultation mode) no yes yes no yes (consultation mode) SQL Connector Access the data recorded in the Database via an ODBC link no no yes Deconnection Exit the w eb pages of the application yes yes yes Context Menu Right-click on the mouse Shortcut for access to the application menu yes yes yes yes yes yes 15

16 X. Creating E.online User Accounts This paragraph describes how to create E.online user accounts - E.online must have been installed correctly. Method Log on to E.online with an account that gives you E.online administrator rights. Click on the icon and then select Accounts. Click on "Add". Complete all the fields in the page : o "General page" is the max. Number of lines displayed on screen in the lists, before pagination (default value: 50). o "Analysis page" is the max. Number of lines displayed on screen in a data analysis table before pagination (default value: 50). o "Role" is the role played by the account: "Restricted user", "Shared user" or "Administrator" refer to the "Description of the E.online menu" paragraph to choose the suitable profile (ENERDIS recommends only having an Administrator account). o "Position" is the position held by the account added: User or Administrator (ENERDIS advises you to create only one Administrator account). o "Inherit authorizations from": the account added will be authorized to view the Devices of the reference account (the Administrator account sees all the Devices). Click on "Confirm" to record the parameter setting and then jump to the list of users You can "Add", "Delete" and "Modify" user accounts or "Log in as a client" on a user account. 16

17 XI. Configuring and Using the Dashboard: E.onlineBoard This paragraph describes how to configure and use the E.onlineBoard dashboard - To use all the dashboard functions, you must have: o Created devices. o Performed periodic data-retrievals (preferably hourly or daily). o Creating personalized display pages. o Performed data analyses and/or graphic analyses. o Had threshold overruns on the devices. Method Log on to E.online. Click on the icon to display the E.onlineBoard dashboard. The screen page comprises the 5 following areas: My Quantities Direct access to the selected personalized display pages My Analyses Direct access to the selected data analyses and graphic analyses Alarms Display of active alarms as they occur. Access to the alarms log Comparison ( xxxxxxx) My Devices Display in graphic form of the sum of the current consumption and the consumption over a period of reference for the devices selected. Display in graphic form of the consumption on each selected device over the period being analyzed. 17

18 Configuration and use of the "My Quantities" area: o In the "View" menu, click on "Personalized Pages". o Check the box for the personalized page to "add" or "delete". o Click on "Modify E.onlineBoard". o Click on the icon to return to the E.onlineBoard. o The personalized page selected has been added to or deleted from the "My Quantities" page. o Click on the icon to display one or more personalized pages. Configuration and use of the "My Analyses" area: o In the "Analyses" menu, click on "Data Analyses" or "Graphic Analyses". o Check the box for the "data analysis" or "graphic analysis" to "add" or "delete". o Click on "Modify E.onlineBoard". o Click on the icon to return to the E.onlineBoard. o The selected data analysis or graphical analysis has been added to or deleted from the "My Analyses" area. o Click on the icon to display one or more graphic or data analyses. Use of the "Alarms" area: o This area is filled as new threshold overruns are detected in the data analyses. o Click on the icon to display the full list of events on an alarm. o In the list of events, you can "Acknowledge" or "Delete" events selected by checking the corresponding box. o Click on the icon to return to the E.onlineBoard. o The "Alarm" area has been updated. Configuration and use of the "Comparison" and "My Devices" areas: o Click on and position yourself in the "Data for plotting histograms" tab. o Select the unit for display on the left-hand axis of the "Comparison" graph; only devices with the selected unit will be displayed in the list. o Use the check boxes to select the required devices. o Click on "Add" to update the graphs in the "Comparison" and "My Devices" areas o Click on the "Data for plotting histograms" tab. o Select the unit for display on the right-hand axis of the "Comparison" graph; only devices with the selected unit will be displayed in the list. o Use the check boxes to select the required devices. o Click on "Add" to superimpose the curves on the graphs in the "Comparison" area. o Click on "Close" to return to the E.onlineBoard. o There are two colours in the histograms: Blue for current data from the period analysed. Grey for historical reference data. 18

19 o The curves on the graphs are displayed in two different ways: Continuous line for current data from the period analysed. Dotted line for historical reference data. o The window for analyzing the current data graphs is selected by clicking on: for the current day (unit: hour). for the current week (unit: day). for the current month (unit: day). o The reference data for the comparison are selected by clicking on: for the previous day, week or month. for the same day, week or month in the previous year. o The command can be used to display or delete the curves in the "Comparison" graph. IMPORTANT: The graphs in the "Comparison" and "My Devices" areas are updated every time there is a dataretrieval from the devices displayed. If you choose hourly data-retrievals, the data in the graphs, analyses and alarms will be updated every hour. 19

20 XII. Creating a Communication Link This paragraph describes how to create a communication link with your products - Communication links connect the devices to the data-retrieval engine. Each device must be equipped with a communication link. Method Log on to E.online with an account that gives you E.online administrator rights. Click on the icon and then select "Communication link". Click on the "Add" action. Enter : o A "Label" for your Communication Link. o The Link Type and associated parameters. For the "PSTN Modem" type, you must complete the following fields: o Label o Transmission mode: RTU (default value) or ASCII o Call number o HangUp (ms) o Timeout (ms) o Attempts For the "Serial port RS485/RS232", you must complete the following fields: o Label o Transmission mode: RTU (default value) or ASCII o Communication port o Timeout (ms) o Attempts o Speed (bauds) o Parity o Data bits (bits) o Stop bits (bits) For the "Ethernet/LAN" type, you must enter the following fields: o Label o Transmission mode: RTU (default value) or ASCII o IP address o TCP port o Timeout (ms) o Attempts Click on "Confirm" to record the parameter settings and then jump to the list of communication links. You can "Add", "Delete", "Modify" or "Copy" communication links. 20

21 XIII. Creating an FTP Server Communication link This paragraph describes how to create a communication link with an FTP Server - FTP Server Communication links allow you to use data stored on an FTP server. Operating Mode Log on to Eonline with an account with Eonline administrator rights. Click on the icon, then select "FTP Collector". Click on the "Add" action. Enter : o A "Label" for your Communication Link. o Select the network type "FTP". o FTP data: WD RF Collector (for the Radio Frequency communication mode). o RF address of the WD Radio Frequency data collector. o FTP mode: passive o IP Address of the FTP server. o Port of FTP server commands (21 by default). o Login for access to the FTP server. o Password for access to the FTP server. o FTP Server Data-Retrieval Period: programmable from 5 min to 24 hours or cyclic programming (Every Day or the first day of the month). o Data directory in the FTP server: directory access path. o Configuration directory in the FTP server: directory access path. o Alarms directory in the FTP server: directory access path. Check the "Activate" box to activate periodic data-retrieval from the Radio Frequency data collector. Click on "Confirm" to save the parameter settings and jump to the list of communication links. You can "Add", "Delete", "Modify", "Copy", conduct a "Communication Test", or "Reset" a communication link with an FTP server. The use of the "reset" command enables the "Status" of the communication to be forced to idle. 21

22 XIV. Creating a communication link with an ELOG Concentrator This paragraph describes how to create a communication link with an ELOG Data Logger / concentrator - The communication link with ELOG is operational. - The ELOG concentrator is configured. Operating Mode Log on to Eonline with an account with Eonline administrator rights. Click on the icon, then select "ELOG Concentrator". Click on the "Add" action. Enter : o A "Label" for your ELOG concentrator. o Specify the "URI" of the ELOG (IP address or hostname). o Click on the "Scan" command to read the serial number of the ELOG. o Choose an "ELOG data-retrieval period" to retrieve the data recorded in the ELOG (from every 5 minutes to every 24 hours) - usual values: 1h or 24h or cyclic programming (Every Day or the first day of the month). o Check the "Activate" box to activate the automatic and periodic data-retrieval of the ELOG, or uncheck the "Activate" box to stop the automatic and periodic dataretrieval of the ELOG. Click on "Confirm" to save the parameter settings and jump to the ELOG list. Click on the "Synchronize" command to retrieve the configuration of Devices and associated variables, configured in the ELOG. o The list of retrieved variables and Devices are visible in the " - Installation Devices" menu. o During the synchronization, only the label of the variable is retrieved. To assign levels to the Devices of the ELOG, use the " - Installation Devices" menu). o You can "Delete", "Modify", "Copy", "Move", "Monitor" a device, as well as conduct a "Communication test", configure "Thresholds" for a variable with the " Installation Devices" menu). You can "Add", "Delete", "Modify", "Copy", conduct a "Communication Test", or "Reset" a communication link with an ELOG. The use of the "reset" command enables the "Status" of the communication with an ELOG to be forced to idle. NOTE: During each periodic or cyclic data-retrieval in an ELOG by Eonline, a synchronization of Devices and variables is also performed. 22

23 REMINDERS for ELOG: In an ELOG, variables are connected to a Driver which is associated with a Device. Two types of variables are managed: index and analogue. Two types of access to a variable: viewing the instantaneous and/or periodic recordings (data recorded by ELOG) for this variable. Behaviour of E.online with regards to modifications in ELOG: Deletion of a variable in a Driver: o The variable will no longer be accessible for viewing and data-retrieval by E.online. o The variable is not deleted in E.online. Deletion of a Device: o The variables will no longer be accessible for viewing and data-retrieval by E.online. o The Device is not deleted in E.online. Adding of a variable in a Driver: o During the first data-retrieval, during the synchronization stage, the variable is automatically added to E.online. Adding of a Device: o During the first data-retrieval, during the synchronization stage, the Device is automatically added to E.online. Modification of the label of a variable of a Driver or a digital input: o During the first data-retrieval, during the synchronization stage, the label of the variable is automatically modified in E.online. Modification of the label of a Device o No modification of the label of the Device in E.online. Modification of the recording period in a Device: o The recordings of the variables of a Device continue to be retrieved by E.online. 23

24 XV. Creating the Architecture of the Devices This paragraph describes how to build the architecture of the Devices - You must first consider how you wish your Devices to be displayed in an architecture based on the model "directory / subdirectory 1 / subdirectory 2 /...". - For example, this architecture may represent the geographical or functional organization of the Devices on the installation. Method Log on to E.online with an account that gives you E.online administrator rights. Click on the icon and then select "Device explorer". Click on the directory of your choice or on the "Topology" root directory. Click on "Add" (up to 4 levels of directories max.). Enter: o A "Label" for your directory. Click on "Confirm" to record the parameters settings and then jump to the Devices treestructure. You can "Delete", "Rename" or "Move" directories. 24

25 XVI. Creating the Energy Use for the Devices This paragraph describes how to add labels for the Energy Use on the installation - You must have already entered the list of the different types of Energy handled on the installation. Method Log on to E.online with an account that gives you E.online administrator rights. Click on the icon and then select "Energy Use". Click on "Add". Enter: o A "Label" for the Energy Uses (e.g. lighting treated water, heating, etc.). o Select an icon (the image of the icon corresponding to the Energy Type is placed beforehand in the directory EonlineII\tomcat7\webapps\eonline2\images\cat). Click on "Confirm" to record the parameter settings and then jump to the list of energy types You can "Add", "Modify" or "Delete" Energy Use. 25

26 XVII. Creating Communicating Jbus Modbus Device This paragraph describes how to add an ENERDIS-brand device to E.online - You must have added a "communication link" for products connected via an RS485 JBUS serial bus. Operating Mode Log on to E.online with an account that gives you E.online administrator rights. Click on the icon and then select "Devices". Click on "Add". Enter: o A "Label" for your device o Levels 1 to 4 of the device display architecture by means of drop-down lists. o Select the "Energy Use" associated with the device. Choose the "JBus" or "ModBusTCP" protocol: o "Communication" Depending on the Type of Protocol: JBus: Choose the communication link associated with the Device then specify the JBus address of the Device. Modbus/TCP: Enter the IP address, the TCP port (502 by default), the Modbus slave address, the timeout (1000 ms by default) and the number of tries (1 by default) for the device. Uncheck the "Active" box if you wish to deactivate the product in the E.online application. For "JBus" and "ModBusTCP" type protocols, perform a scan by clicking on the "Scan" button. The type of device should be displayed. The automatic Scan function only works for ENERDIS devices (you can force the type of product by selecting it in the list of available drivers). Drag and drop into the "Authorized users" window the names of the people authorized to view the device. Click on "Confirm" to record the parameter settings and jump to the list of devices. You can "Add", "Delete", "Modify", "Copy" or "Move" a device, as well as "Test communication", "Monitor" the device and "Add a threshold" to the device. 26

27 XVIII. Creating a Radio Frequency Device This paragraph explains how to add a Radio Frequency Device - You must have added an FTP type "communication link". Operating Mode Log on to E.online with an account with E.online administrator rights. Click on the icon, then select "Devices". Click on the "Add" action. Enter : o A "Label" for your Device. o Levels 1 to 4 of the Device presentation architecture from the scroll-down lists. o Select the "Energy Use" associated with the Device. Choose the "FTP" Protocol. Choose "WD RF Collector" as the type of FTP Data. Select the FTP server in type of communication. Uncheck the "Active" box if you want to deactivate the product in the E.online application. Choose "xmldevice x.x All versions" as Type. Fill in the RF address of the module "RF address of the module". Caution, for all modules of the following type: o Pulse: Fill in the address in decimal (e.g.: ). o 4-20 ma and Temperature: Fill in the address in hexadecimal (e.g.: 18190B300908). (The values of the RF addresses must be identical to those specified in the xml file generated by the WD RF data collector). Fill in the RF address of the first Repeater "RF Address of repeater 1". Fill in the RF address of the second Repeater "RF Address of repeater 2". Fill in the RF address of the third Repeater "RF Address of repeater 3". "Data-retrieval mode periodicity": Select hours, days or months o Times: the data nearest to the hour shall be selected for analyses of tables and charts. o Days: the data nearest to midnight shall be selected for analyses of tables and charts. o Months: the data nearest to the first of each month at midnight shall be selected for analyses of tables and charts. All points recorded by the Radio Frequency modules (if the recording frequency is less than the hour, e.g.: 10 minutes) can be accessed in the "Records Histories" menu. "Module measurement type", select the type of measurement for the RF module: 27

28 o "RF pulse". o "RF Dallas temperature sensor". o "RF analogue (ma) ". "RF module label": specify the name defined in the "label" cell of the measured channel defined in the Radio Frequency module through the configuration software. (Please note: the names must be strictly identical to those in the xml file generated by the WD RF data collector). Specify the "measurement unit" of the variable measured by the Radio Frequency module. "Coefficient": multiplying coefficient to apply to the measurement. "Offset" applied to the measurement. You can "Add", "Delete", "Modify", "Copy", "Move" a Device, conduct a "Communication test", "Monitor" a Device and "Add a Threshold" to a Device. 28

29 XIX. Creating a Device or Variable with Manual Data Input - This paragraph describes how to add a non-communicating device or a variable with manual data input Method Log on to E.online with an account that gives you E.online administrator rights. Click on the icon and then select "Devices". Click on "Add". Enter: o A "Label" for your device. o Levels 1 to 4 of the device display architecture by means of drop-down lists. o Select the "Energy Use" associated with the device. Choose "non-communicating" as the protocol. Uncheck the "Active" box if you wish to deactivate the product in the E.online application. Select the Type "ManualDevice x.x All versions". Select the "Calculation type" to be applied according to the type of values entered: o "cumulated index": for the index values read on a meter. o "difference between 2 indices": for input of the difference between two index values read on a meter. o "instantaneous or average value": for physical quantities or statistical data (production data, etc.). Indicate the "unit" of the value entered. Drag and drop into the "Authorized users" window the names of the people authorized to view the device Click on "Confirm" to record the parameter settings and jump to the list of devices. You can "Add", "Delete", "Modify", "Copy" or "Move" a device, as well as "Test communication", "Monitor" the device and "Add a threshold" to the device. 29

30 XX. Manual Data Input This paragraph describes how to input data manually for non-communicating devices or variables You must have added a device or variable with manual data input. Method Log on to Eonline with an account that gives you E.online administrator rights. In the "Advanced Functions" menu, click on "Manual input". Click on "Add". Enter a "label" for the manual data input task. Select the input periodicity in "Type": hourly, daily, monthly or annual for hourly, daily, monthly or annual data input. Use the check boxes to select the devices or variables requiring periodic processing (devices or variables with manual data input are identified by an index in the "type" column, e.g. I for index input). Click on "Next" to jump to "Data input". Check that you are within the required input period (see time/date stamp in the top lefthand corner of the input form). You can enter or modify the data in the table cells subject to the following rules: o "cumulated index": value read on a meter and cumulated over time (E.online will automatically calculate the precise value between two cells by calculating the difference between two indices). o "difference between 2 indices: cumulated value over the input period (hour, day, month or year E.online does not perform any calculations on these manually-input data). o "instantaneous or average value": instantaneous values for the hour, day, month or year, or average values over the hour, day; month or year (E.online does not perform any calculations on these manually-input data). Click on "Confirm" to save the input and jump to the list of manual input tasks or on "Reinitialize" to return to the initial values prior to modification. You can "Add", "Delete", "Modify" or "Complete" a manual input task. 30

31 XXI. Creating a Constant This paragraph describes how to add a constant in E.online - Method Log on to E.online with a user or administrator account. Click on the icon and then select "Devices". Click on "Add". Enter: o A "Label" for your Constant o Levels 1 to 4 of the device presentation architecture by means of drop-down lists. o Select the "Energy Use" associated with the Constant. Choose the "non-communicating" protocol. Select the Type "ConstantDevice x.x All versions". Select the Type "ConstantDevice". Indicate the value of the constant. Indicate the unit of the constant. Drag and drop into the "Authorized users" window the names of the people authorized to view the device. Click on "Confirm" to save the parameter settings and jump to the list of devices. You can "Add", "Delete", "Modify", "Copy" or "Move" a device, "Test communication", "Monitor" the device and "Add a threshold" to the device. 31

32 XXII. Viewing the Quantities Measured by the Devices This paragraph describes how to display the quantities measured by an E.online device. - You must have already added at least one "Device". Method Log on to E.online with a user or administrator account. In the "Display" menu, click on "Real time". In the architecture, click on the label of a Device (expand the tree-structure of the directories if necessary). Click on one of the shortcuts for access to the quantities measured, on the right-hand side of the screen (e.g. instantaneous and average values, meters, etc.). The selected group of measured quantities is then displayed on the screen. 32

33 XXIII. Creating an automatic and periodic Data-Retrieval of Devices and variables This paragraph specifies how to create an automatic and periodic data-retrieval of Devices and variables from ENERDIS devices (Specific ENERDIS device driver) and other devices (Generic Driver) - E.online must communicate correctly with the Devices on the installation. Method Log on to E.online with an account that gives you E.online administrator rights. Click on the icon and then select "Automatic Tasks - Data-retrievals". Click on "Add". Enter a "Label" for your data-retrieval action. Click on "Next" to jump to "Choice of Devices". Check the relevant boxes to choose the Devices for which you require data-retrieval. Click on "Next" to jump to "Choice of actions". Check the relevant boxes to choose the actions that you wish to perform: o "LC data-retrieval": the data-retrieval and recording of load curve variables for Devices with a specific ENERDIS device driver (e.g.: ENERIUM 200). o "LC Reset": the deletion of the data of load curve variables, at each data-retrieval, for Devices with specific ENERDIS device drivers (e.g.: ENERIUM 200). o "Index Data-retrieval": retrieval and recording of the values of index-type variables for Devices with specific ENERDIS device drivers and Generic Driver for other devices. o "Index Reset": reset of the index values, at each data-retrieval, for Devices with a specific ENERDIS device driver. o "Analogue Data-Retrieval": retrieval and recording of the values of analogue-type variables for Devices with a Generic Driver. o "Extremes Data-Retrieval": retrieval and recording of the minimum and maximum values for U, I and P stored on ENERDIS devices (CDTpr, recdigit 1800, recdigit POWER Management). o "Extremes Reset": reset, at each data-retrieval, of the minimum and maximum values for U, I and P stored on ENERDIS devices (CDTpr, recdigit 1800, recdigit POWER Management). o "Events Data-Retrieval and Reset": retrieval and recording then reset of threshold overshoots on U, I and P stored on ENERDIS devices (CDTpr, recdigit 1800, recdigit POWER Management). o "Synchronize with server time: reset of the server time and internal clocks for Devices with specific ENERDIS device drivers. Click on "Next" to jump to "Programming". 33

34 Program the periodicity of the data-retrieval action (ENERDIS advises you to select Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday at 5 am (05.00 hrs) for example) and/or click directly on "Next". Click on "Next" to jump to " ": o Enter the "Mail subject" if you choose to send o Choose "No sent" (default value) or "Sending at end of data-retrieval" (to send an every time there is a remote data-retrieval from the devices) or "Sending in case of error" ( sent if a communication error occurs on a device). o Select one or more contacts in the list of contacts. Check the boxes corresponding to the recipients. Click on "Next" to jump to "Summary". Check or uncheck "Activate" for data-retrieval (default value: Activate). Click on "Confirm" to record the parameter settings and then jump to the list of dataretrieval actions. You can "Add", "Delete" or "Modify" a data-retrieval, "Monitor" execution of the dataretrieval, "Execute" or "Stop" a data-retrieval immediately, view the "Log" of a data-retrieval, "Reinitialize" the log of a data-retrieval and "Reinitialize" a data-retrieval. IMPORTANT: the tolerance of the query window for a retrieved data value to be validated in the E.online database can be configured (see paragraph on "Modifying the parameter settings of the software"). 34

35 XXIV. Viewing the Log of Data-Retrievals This paragraph describes how to view the log of data-retrievals - Data-retrievals must have been performed. Method Log on to E.online with an account that gives you E.online administrator rights. In the "View" menu, click on "Data-retrieval log". Choose the date of the last data-retrieval to view. Indicate the number of data-retrievals to view from the date indicated. Select the label of the data-retrieval in the list of data-retrievals. The list of data-retrievals is displayed. Check the box for a data-retrieval and then click on "Consult" to analyze the details of the data-retrieval. Click on "Delete" if you want to delete the content of the journal before a given date. Indicate the date and then click on "Delete data". 35

36 XXV. Creating an Energy Analysis This paragraph describes how to analyze the data-retrieved from the Devices. - At least one data-retrieval must have been performed on the Devices analysed. - If you wish to analyze the Devices recording the "Load Curve" data, use the "Data Analysis" submenu in "Analysis". - If you wish to analyze the Devices recording "Consumption Index" data, use the "By index" submenu in "Analysis". Method Log on to E.online with a user or administrator account. In the "Analysis" menu, choose "Data Analysis. Click on "Add". Enter a "Label" for your Analysis. Select a type of analysis from the list of possible analyses. Click on "Next" to jump to "Choice of Variables". Check the boxes of the variables of Devices that you wish to analyse. Click on "Next" to jump to "Choice of dates". Use the calendars to choose the period covered by your analysis. Click on "Next" to jump to "Parameters of analysis". Select the energy units that you want to analyze and the tariff contracts to be linked to them if you want to convert the values into financial data. Click on "Next" to jump to "Summary". Click on "Execute" to execute and record the configuration of the analysis or on "Confirm" to record the configuration; you will then jump to the list of analyses. You can "Add", "Delete", "Modify" or "Execute" an analysis or view the "Result" of an analysis executed previously. 36

37 XXVI. Creating a Graphic Analysis The paragraph describes how to create graphics from the data retrieved remotely from the devices - Data retrieval must have been performed at least once on the devices analysed. Method Log on to E.online with a user or administrator account. In the "Analysis" menu, choose "Graphics". Click on "Add". Enter a "Label" for your analysis. Select a type of analysis from the list of possible analyses. Click on "Next" to jump to "Choice of Variables". Check the boxes of the variables of Devices that you wish to analyse. Click on "Next" to jump to "Graphic analysis". If necessary, use the calendars to choose the period (Analysis start date and Analysis end date) covered by your analysis. Click on "OK" and the graphics will be displayed. You can "Cancel" the configuration, "Export" the graphics as images or "Save" the configuration. In the list of graphic analyses, you can "Add", "Delete", "Modify" or "View" graphic analyses. 37

38 XXVII. Creating a Conversion Rule for the Units This paragraph describes how to create a virtual Device (arithmetic combination of several variables) - Method Log on to E.online with an account that gives you E.online administrator rights. In the "Advanced functions" menu, choose "Conversion of units". Click on "Add". Enter: o A "Label" for your unit conversion law. o Drag and drop into the "Authorized Users" window the names of the people authorized to view the device. Click on "Next" to jump to "Conversion formula". Indicate the "source unit" (e.g. kwh); this is the unit of a device, so you must enter the exact label of the source unit. Enter the conversion formula; the unit to be processed is represented by "x" (e.g. x*2.583: the source unit will be multiplied by to obtain a result in the target unit). You can also use formulae: o See link Indicate the "target unit" obtained after applying the conversion law (e.g. TCO2). Click on "Next" to jump to "Summary". Click on "Confirm" to record the parameter settings and jump to the list of conversion laws. Check the box for one of the conversion laws in the list. Click on the command "Link to list of variables". Check the variables of Devices to associate with the selected units conversion law. Click on "Confirm" to record the parameter settings and jump to the list of conversion laws. You can "Add", "Delete" or "Modify" a unit conversion law, and you can also link a list of devices to a unit conversion law. 38

39 XXVIII. Creating a Calculation (Mathematical Operations) This paragraph describes how to create a Calculation (arithmetical combination of variables) - At least one data-retrieval must have been performed on the devices to be selected. Method Log on to E.online with an account that gives you E.online administrator rights. In the "Advanced functions" menu, choose "Calculations and EnPI ". Click on "Add". Enter: o A "Label" for your device. o Select "Totalizer" as the device type. o Levels 1 to 4 of the device presentation architecture by means of drop-down lists. o Select the "Energy Use" linked to the device. o Drag and drop into the "Authorized users" window the names of the people authorized to view the device. Click on the "Next" to jump to "Choice of Variables". Select the energy unit of Devices from the list of available energy units. A list of the variables of Devices is displayed Check the boxes of the variables of Devices that you wish to use for the virtual Device. Click on "Next" to jump to "Equation". Select a sign and enter a multiplying coefficient (default value: 1) for each device in the list. Click on "Next" to jump to "Summary". Click on "Confirm" to record the parameter settings and jump to the list of Calculations and EnPI. You can "Add", "Delete", "Modify", "Copy" or "Move" a Calculation, as well as add a "Threshold" to a Calculation. 39

40 XXIX. Creating an EnPI (Energy Performance Indicator) This paragraph describes how to create an EnPI (Energy Performance Indicator) - At least one data-retrieval must have been performed on the devices to be selected. Method Log on to E.online with an account that gives you E.online administrator rights. In the "Advanced functions" menu, choose "Calculations and EnPI". Click on "Add". Enter: o A "Label" for your device. o Select "Ratio" as the device type. o Levels 1 to 4 of the device presentation architecture by means of drop-down lists. o Select the "Energy Use" linked to the device. o Drag and drop into the "Authorized users" window the names of the people authorized to view the device. Click on "Next" to jump to "Choice of Variables". Indicate the "unit" for the result of the division (free input, e.g. kwh/m²). Select a "numerator" in the list of available variables. Select a "denominator" in the list of available variables. Click on "Next" to jump to "Equation". Select the "numerator unit" in the list of possible units (a given variable may have several units in E.online, e.g. kwh, kwh oe, TCO2, etc.) (See paragraph on "Unit conversion"). Select the "denominator unit" in the list of possible units. Click on "Next" to jump to "Summary". Click on "Confirm" to save the parameter settings and jump to the list of Calculations and EnPI. You can "Add", "Delete", "Modify", "Copy" or "Move" an EnPI and you can also add a threshold to an EnPI. 40

41 XXX. Adding a Threshold to a Physical or Virtual Device This paragraph describes how to add an overrun alert threshold on the retrieved data (e.g. consumption) from a physical or virtual device - You must have added at least one "Device". Method Log on to E.online with an account that gives you E.online administrator rights. Click on the icon and then select "Devices" or open the "Advanced functions" menu and choose "Calculations and EnPI". Select a device or a virtual device (Calculations or EnPI) by checking the corresponding box. Click on "Threshold" to jump to the list of thresholds for the device selected. Click on "Add" to create a threshold. Proceed as follows: o Enter a "Label" for your threshold. o Select the threshold's operating mode: "Normal" or "Exception" ("Exception" mode means that the threshold takes priority over all the other thresholds for the period when the threshold is applicable). o Select the Threshold Type: "Hours", "Day", "Month" or "Year" in "Max" or "Min" value trigger mode. o Enter the threshold value (numerical value). o Select a variable from the proposed list. o Select the period of application of the Threshold (start date and end of application). o Select the periodicity for application of the threshold over the period. o Activate the threshold by checking the relevant box. Click on "Add" to jump to the list of thresholds for the device. You can "Add", "Delete" or "Modify" thresholds. 41

42 XXXI. Viewing the history of threshold overshoots This paragraph explains how to view the log of overshoots for thresholds programmed for the Devices - Thresholds must have been programmed for the device. - At least one data-retrieval must have been performed on the devices analysed. - Threshold overruns must have been recorded. Method Log on to E.online with an account. In the "'View" menu, click on "Threshold log". You can view the list of all the threshold overruns recorded in E.online. Check the corresponding boxes for the overruns that you wish to "Acknowledge" or "Delete". 42

43 XXXII. Adding a Generic Driver This paragraph describes how to add and configure a generic driver for ModBus and ModBus TCP devices - You must possess the mapping of the table of quantities to be used. Method Log on to E.online with an account that gives you E.online administrator rights. Click on the icon and then select "Generic drivers". Click on "Add". Enter: o A "Label" for your generic driver o A "Version" reference for the generic driver o The product's "Reversal time" in ms. o The maximum "Return time" authorized ins ms. Click on "Next" to jump to "Choice of mapping variables". In the "Add or modify a mapping variable" part, enter: o A "Label" for the mapping variable to be used. o A "Type" for the variable: Index: if it is a variable to measure a cumulated value over time (example: index of a counter). Instantaneous value: if it is a simple measurement variable (example: analogue signal of a temperature). Character String : if it is a data string. o For "Index" and "Instantaneous value" mapping variables, enter: The "Address" in the mapping to read the variable. The Unit of the variable. The "Nature" of the variable (uint32: unsigned 32-bit value, int32: signed 32- bit value). "Order" for reading the variable: - Big Endian: most significant byte with the lowest address. - Little Endian: least significant byte with the lowest address. The "Mask" allows you to use only part of the variable (e.g. the mask to be used to process the first 8 bits of a 32-bit Big Endian is in binary, i.e FF in hexadecimal). Example: 43

44 Let V1 be a voltage in kv coded on 12 bits. Data access is only performed byte by byte (read, write, etc.). You must therefore read 2 bytes (i.e. 16 bits) and only process the 12 useful bits. Part to be "masked" Useful value && logical "AND" Byte 2 Byte Byte 2 Byte 1 V1 encoded on 12 bits Mask to be applied V1 = 3309 kv A multiplying coefficient called "Gain" to be applied to the variable (default value 1). An "offset" added to the value of the variable (default value 0). Check the "Visibility" box if the variable has to be displayable in the E.online application. o For the "Character string" type, enter: The "Address" in the mapping for reading the variable. "Order" for reading the variable: - Big Endian: most significant byte with the lowest address. - Little Endian: least significant byte with the lowest address. Check the "Visibility" box if the variable needs to be displayed in the E.online application in the instantaneous viewing pages. Check the "Breakdown (Month, Day, hour)" box if the periodic recording of the variable, using the automatic data-retrieval function, must be used to calculate the values over the entire periods of the hour, day and month. Use the "Add a variable" command to add variables to the list of mapping variables. The "Test a mapping variable" part can be used to check that the variable is read correctly: o Select a "Variable" from the list of available variables. 44

45 o Choose the communication protocol used (JBus or ModBus/TCP): JBus mode: select the "Communication" gateway to reach the product (configured beforehand in Installation --> Communication link) and then indicate the "JBus address" of the product. ModBus/TCP: select the "Communication" gateway to reach the product (configured beforehand in Installation --> Communication link) and then indicate the "JBus address" if necessary (useful for the JBus/TCP gateways integrated in the products - default value 1). o Click on the "Mapping variable test" command and check that the variable is displayed correctly in the "Variable" cell. You can "Delete a variable" or "Edit a variable" to modify it. Click on "Next" to jump to "Choice of composite variables" (this part can be used to create variables which are the result of a combination of simple variables defined during the "'Choice of mapping variables"). In "Add or modify a composite variable", enter: o A "Label" for the composite variable to be created. o A "Type" for the variable: Index: if it involves an energy consumption measurement variable. Instantaneous variable: if it involves a simple measurement variable. The "Unit" for the composite variable. Select "Operand 1" from the list of available variables. Select an "Operation" (+, -, x, /). Select "Operand 2" from the list of available variables. Check the "Breakdown (Month, Day, hour)" box if the periodic recording of the two variables, using the automatic data-retrieval function, must be used to calculate the values over the entire periods of the hour, day and month. Use the "Add a variable" command to add variables to the "List of composite variables". You can "Delete a variable" or "Edit a variable" to modify it. Click on "Next" to jump to "Summary". Click on "Confirm" to record the parameter settings and then jump to the list of Generic Drivers. You can "Add", "Delete", "Modify" or "Copy" generic drivers. 45

46 XXXIII. Creating a Device with a GENERIC DRIVER This paragraph describes how to add a device of any brand to E.online - You must have added a "communication link" for the products connected via an RS485 JBUS serial bus and you must have defined the parameters of a generic driver. Method Log on to E.online with an account that gives you E.online administrator rights. Click on the icon and then select "Devices". Click on "Add". Enter: o A "Label" for your device. o Levels 1 to 4 of the device presentation architecture by means of drop-down lists. o Select the "Energy Use" for the device. o Choose the "JBus" or "ModBusTCP" protocol. "Communication" according to the type of protocol JBus: choose the communication link associated with the device and then indicate the device's JBus address. Modbus/TCP: enter the IP address, the TCP port (502 by default), the Modbus slave address, the timeout (1000 ms by default) and the number of tries (1 by default) for the device. Uncheck the "Active" box if you want to deactivate the product in the E.online application. For the "JBus" and "ModBusTCP" protocols. There is no automatic scan for a "Generic driver". You have to force the product type by selecting "GenericDevice x.x All versions". Select the "Generic driver" in the list of available generic drivers. Drag and drop into the "Authorized users" window the names of the people authorized to view the device. Click on "Confirm" to save the parameter settings and then jump to the list of devices. 46

47 XXXIV. Creating an Automatic Periodic Task for Sending the Analyses and Alerts - You must have added at least one analysis in "Data analyses" or "Index analyses ", you must have created at least one threshold on a Device and you must have added addresses in "Administration - My Address Book". Method Log on to E.online with an administrator or user account. Click on the icon and then select "Automatic tasks - Analyses and alerts". Click on "Add" Enter: o A "Label" for the Task to be automated. o Select the "Type of analysis": This paragraph describes how to create an automatic periodic task for sending the Analyses and Alerts by "Energy Analysis": data from the data-retrieval of Recording curves. "Index Analysis": data from the periodic data-retrieval of index values. Click on "Next" to jump to "Available analyses". From the possible options, select the moment and periodicity for the triggering of the automatic task (the shall be sent at 5 a.m., configurable in a conf file). Click on "Next" to jump to "Programming". From the list of analyses, select which one you wish to receive periodically and automatically by . Click on "Next" to jump to "Mail". Enter: o "Mail subject". o Export "Format" of the analysis (pdf, csv or html). o Check the box "Activate mail sending in case of overrun" if you want to receive the threshold overrun log along with the analyses. o Check the boxes corresponding to the recipient(s) of the information. Click on "Next" to jump to "Summary". Click on "Confirm" to record the parameter settings and then jump to the list of automated analyses. You can "Add", "Delete" or "Modify" automatic analyses. 47

48 XXXV. Planning a Measurement Campaign - You must have added at least one Device (note: this function does not work with a modem connection). Method Log on to E.online with an account that gives you E.online administrator rights. From the "Advanced functions" menu, click on "Campaign of measurements". Click on "Add". Enter: o A "Label" for the measurement campaign. o Use the calendar to select an "Analysis start date". o Use the calendar to select an "Analysis end date". o A "Periodicity" for recording the measurements. Click on "Next" to go to the stage of "Choice of Devices" for authorized devices (the variables from ELOG concentrators are not accessible). Select the Devices to be used by checking the corresponding boxes in the list. Click on "Next" to jump to "Choice of quantities". Select: o In the list of "Chosen devices", select: This paragraph describes how to parameterize triggering and execution of a measurement campaign The "variables" to be recorded in the list of accessible variables for each of the devices, by clicking on "Add the quantity". The quantity is added to the "Choice of quantities" list. You can remove quantities from the "Choice of quantities" list by clicking on "Remove the quantity". Click on "Next" to jump to "Summary". Click on "Activate" to trigger the measurement campaign. Click on "Confirm" to record the parameter settings and then jump to the list of measurement campaigns. You can "Add", "Delete", "Modify", "Deactivate", "Delete the data" and "Export the data": o To export the data from a measurement campaign, check the box corresponding to the measurement campaign and use the "Export the data" command. The data will be exported into a file in CSV format. o To delete the data from a measurement campaign, check the box corresponding to the measurement campaign and use the "Delete the data" command. 48

49 XXXVI. Creating a Personalized Page to View data in real-time This paragraph describes how to parameterize a page for viewing quantities on devices chosen by the user - You must have added at least one device. Method Log on to E.online with an administrator or user account. In the "View" menu, click on "Personalized Pages". Click on "Add". Enter: o A "Label" for the personalized page. Click on "Next" to go to the stage of "Choice of Devices" for authorized devices (the variables from ELOG concentrators are not accessible). Select the devices to be used by checking the corresponding boxes in the list. Click on "Next" to jump to "Choice of quantities". Select: o In the "Chosen devices" list: The "variables" to be recorded in the list of accessible variables for each of the devices, by clicking on "Add the quantity". The quantity is then added to the "Choice of quantities" list. You can remove quantities from the "Choice of quantities" list by clicking on "Remove the quantity". Click on "Next" to jump to Summary". Click on "Confirm" to record the parameter settings and then jump to the list of Personalized Pages. You can "Add", "Delete", "Modify" or "Consult" the personalized page selected: o The "Consult" command can be used to view the Quantities in the personalized page. 49

50 XXXVII. Creating an Analysis between two Indices read remotely This paragraph describes how to analyze energy consumption in the basis of the consumption indices retrieved remotely from the devices. - Data retrieval of the Indices must have been performed at least once for the devices analysed. Method Log on to E.online with an administrator or user account. In the "Analysis" menu, click on "Index Analysis". Click on "Add". Enter: o A "Label" for the analysis. o Select the "Type": Analysis of two indices read remotely. Click on "Next" to jump to "Choice of dates": o Use the calendar to choose an "Analysis start date" and "Analysis end date". o Indicate the "Tolerance on Data-retrieval date (in days)" with regard to the analysis start and end dates for an Index value to be taken into account. o Indicate the "Tolerance on Data-retrieval date (in hours)" with regard to the analysis start and end dates for an Index value to be taken into account. Click on "Next" to jump to "Choice of devices". Check the boxes of the variables of Devices that you wish to analyse. Click on "Next" to jump to "Setup". Select the "Units" to be used in the report and the "Charge table" to express the data in monetary units if necessary. Click on "Next" to jump to "Summary". Click on "Execute" to execute and record the configuration of the analysis or on "Confirm" to record the configuration and then jump to the list of analyses. You can "Add", "Delete", "Modify" or "Execute" an analysis or view the "Result" of an analysis executed previously. 50

51 XXXVIII. Creating a Load Profile Analysis for a device This paragraph describes how to analyze the load profile analysis for a device - Data retrieval of load chart must have been performed at least once for the devices analysed. Method Log on to E.online with an administrator or user account. In the "Analysis" menu, click on "Load Profile Analysis". Click on "Add". Enter: o A "Label" for the analysis. Click on "Next" to jump to "Choice of Variable". Check the box of the variable of Devices that you wish to analyse. Click on "Next" to jump to "Choice of dates": o Use the calendar to choose an "Analysis start date" and "Analysis end date" (max. difference: 1 month). Click on "Next" to jump to "Summary". Click on "Execute" to execute and record the configuration of the analysis or on "Confirm" to record the configuration and then jump to the list of analyses. You can "Add", "Delete", "Modify" or "Execute" an analysis or view the "Result" of an analysis executed previously. 51

52 XXXIX. Displaying the history of recordings This paragraph describes how to display the history of recorded analogue or index values (dataretrievals, xml data, manual input) - Index or analogue values must have been recorded. Method Log on to E.online with an administrator or user account. In the "Analysis" menu, click on "History of Recordings". Click on "Add". Enter: o A "Label" for the analysis. Click on "Next" to jump to "Choice of devices". Check the box of the variable of the Device that you wish to analyse. Click on "Next" to jump to "Choice of dates": o Use the calendar to set an "Analysis start date" and an "Analysis end date". Click on "Next" to jump to "Summary". Click on "Execute" to execute and record the configuration of the analysis or on "Confirm" to record the configuration and then jump to the list of analyses. You can "Add", "Delete", "Modify" or "Execute" an analysis or view the "Result" of an analysis executed previously. 52

53 XL. Analyzing the Log of Threshold Overruns on U, I and P This paragraph describes how to analyze the log of threshold overruns on the quantities U, I and P programmed in ENERDIS CDTpr and RECDGIT instruments - A data-retrieval concerning the overruns must have been executed at least once on the CDTpr and/or RECDIGIT devices. Method Log on to E.online with an account. In the "View" menu, click on "Events". Click on "Add". Enter: o A "Label" for the analysis. Click on "Next" to jump to "Choice of devices". Check the boxes for the device that you wish to analyse. Click on "Next" to jump to "Choice of dates": o Use the calendar to select an "Analysis start date" and an "Analysis end date". Click on "Next" to jump to "Analysis parameters". Check the boxes of the overruns to be analysed. Click on "Next" to jump to "Summary". Click on "Execute" to execute and save the analysis configuration or on "Confirm" to save the configuration and jump to the list of analyses. You can "Add", "Delete", "Modify" or "Execute" an analysis, as well as view the "Result" of an analysis executed previously. 53

54 XLI. Analyzing the Log of Extreme Values Reached on the Quantities This paragraph describes how to analyze the log of the extreme values reached on the quantities measured by ENERDIS CDTpr, RECDGIT and ENERIUM devices - A data retrieval on the extreme values must have been executed at least once on the CDTpr, RECDIGIT and/or ENERIUM devices. Method Log on to E.online with an account. In the "View" menu, click on "Extremes". Click on "Add". Enter: o A "Label" for analysis. Click on "Next" to jump to "Choice of devices". Check on the boxes of the device that you want to analyse. Click on "Next" to jump to "Choice of dates": o Use the calendar to select an "Analysis start date" and an "Analysis end date". Click on "Next" to jump to "Analysis parameters". Check the boxes for the quantities to be analysed. Click on "Next" to jump to "Summary". Click on "Execute" to execute and save the analysis configuration or on "Confirm" to save the configuration and then jump to the list of analyses. You can "Add", "Delete", "Modify" or "Execute" an analysis, as well as view the "Result" of an analysis executed previously. 54

55 XLII. Configuring a Tariff contract for energy units This paragraph describes how to configure an energy tariff contract. A tariff contact allows you to apply an energy price which varies over time (e.g. day-tariff, night-tariff, etc.). This type of contract is applied to the Load Curve data. - A Load Curve data-retrieval must have been performed on the devices configured in E.online. Method Log on to E.online with an administrator account. Click on the icon and then select "Energy Costs - Tariff contracts". Click on "Add". Enter: o A "Label" for the tariff contract. o Select the energy "unit" for the tariff contract from the list or create a new unit if it is not already in the list. o Select the "monetary unit" for the tariff contract or create a new unit if it is not already in the list. o Transfer the users authorized to use this tariff contract from the "Not authorized users" side to the "Authorized users" side. Click on "Next" to jump to "Tariff slots". Enter: o A "Label" for the tariff slot to be added or select one from the list of tariff slot labels already available. o Select the energy "unit" for the tariff contract from the list or create a new unit if it is not already in the list. o Select a "Start date" and "End date" for application of the unit cost for this tariff slot. A period of validity of this sort is particularly useful for taking into account the evolution of the unit cost over time. o Indicate the "Unit cost" for this tariff slot. o Indicate a multiplying coefficient for the unit cost if necessary (otherwise, set 100 for 100% by default). o Select a colour to be associated with this tariff slot (for graphic representations). o Click on "Add". o You can "Modify" or "Delete" a tariff slot (after first checking the corresponding box) o Repeat the operations starting with the "label" step for each of the tariff slots in the energy contract. 55

56 Example of an A5 MU contract with basic options covering 2009 and 2010 PTE HPH HCH HPE HCE Peak Rate Winter Day Rate Winter Night Rate Summer Day Rate Summer Night Rate (on 15/08/2009) (on 15/08/2010) (on 15/08/2009) (on 15/08/2010) (on 15/08/2009) (on 15/08/2010) (on 15/08/2009) (on 15/08/2010) (on 15/08/2009) (on 15/08/2010) November to March April to October 9.00 am to 11 am 6.00 pm to 8.00 pm Dec, Jan & Feb 6.00 am to 9.00 am am to 6.00 pm 8.00 pm to pm 6.00 am to pm (Nov & Mar) pm to 6.00 am 6.00 am to pm pm to 6.00 am Sundays and public holidays: Night Rate - You need to create 5 tariff slots (PTE, HPH, HCH, HPE and HCE) with the costs associated with each tariff slot for 2009 and Click on "Next" to jump to "Standard days". A standard day corresponds to a specific profile for application of the tariff slots in the day. You must create as many standard days are there are different tariff days. In the example of the A5 MU basic option tariff contract, there are 7 different tariff days. 56

57 Click on "Next" to jump to "Calendar": The calendar can be used to apply the relevant standard day to each day in the year: o Select the relevant standard day from the drop-down list. o Use the "Copying tool" to define a standard week and duplicate over a longer period. Click on "Next" to jump to "Summary". 57

58 Click on "Confirm" to record the parameter settings and then jump to the list of tariff contracts. You can "Add", "Delete" or "Modify" tariff contracts. 58

59 XLIII. Configuring a Tariff contract for energy index-type units This paragraph describes the procedure for configuring a tariff contract on the Energy Indices, setting a fixed energy price. This type of contract is applied to the Index data, rather than to the Load Curve data. - A data-retrieval by index must have been performed on the devices configured in E.online. Method Log on to E.online with an administrator account. Click on the icon and then select "Energy cost - Tariff contracts by index". Click on "Add". Enter: o A "Label" for the tariff contract. o Transfer the users authorized to use this tariff contract from the "Not authorized users" side to the "Authorized users" side. Click on "Next" to jump to "Units". Enter: o In the "Add or modify an entry" part: Select the energy "unit" for the tariff contract from the list or create a new unit if it is not already in the list. Indicate the "Unit cost" for this unit. Select the "monetary unit" for the contract from the list or create a new unit. o Select a "Start date" and "End date" for application of the unit cost for this tariff slot. A period of validity of this sort is particularly useful for taking into account the evolution of the unit cost over time. o Click on the "Add" command. o Repeat the operations, starting with the step for adding other energy units. o You can "Delete" and "Modify" entries (after checking the corresponding box). Click on "Next" to jump to "Summary". Click on "Confirm" to record the parameter settings and then jump to the list of tariff contracts by index. You can "Add", "Delete" or "Modify" tariff contracts by index. 59

60 XLIV. Creating your personalized document area This paragraph describes how to create your personalized document area where the results of your analyses will be stored - Analyses must have been performed. Method Log on to E.online with an account. In the "Analyses" menu, click on "My documents". Click on the "Personal" directory to display the tree-structure of the backup directories. Click on a directory to "Add", "Rename", "Move" or "Delete" a directory. The analyses are file in the different directories by using the "Save" action available in the analysis result. When you click on "Save", you jump to the tree-structure of the backup directories where you can: o Click on the backup directory of your choice. o Modify the label of the analysis to be saved. o Drag and drop into the "Authorized users" window the names of the people authorized to view the analysis. 60

61 XLV. Consulting an analysis in your document area This paragraph describes how to consult and manage your document area - Analyses must have been saved in your document area. Method Log on to E.online with an account. In the "Analyses" menu, click on "My documents". Click on the "Personal" directory to display the tree-structure of the backup directories. Select your analysis by browsing the directories in the tree-structure. You can: o "View" the result of the analysis. o "Add" the analysis to the shopping basket to produce a report. o "Modify" the backup parameters for the analysis. o "Delete" the analysis. o "Refresh" your document-area page. 61

62 XLVI. Producing an Analysis Report This paragraph describes how to produce a report on one or more analyses - Analyses must have been saved in your document area. Method Log on to E.online with an account. In the "Analyses" menu, click on "Print and reports". Select an analysis by browsing the directories in the tree-structure. Click on "Add" to add the analysis to the shopping basket. Complete the basket with the other analyses required. You can remove an analysis from the basket by checking the box corresponding to the analysis in the document area and then clicking on "Delete". Check the box(es) of the analysis or analyses in the basket which should appear in your report. Use the "Export" command to jump to the basket export page. Select: o The "report export format": PDF, HTML or CSV. o A "header" and "footer" in the list of available headers and footers. Click on "Generate" to produce the report. You can "save" the report before opening it with the application of your choice. 62

63 XLVII. Defining "Headers" and "Footers" for Reports This paragraph describes how to add "footers" and "headers" to a library - Method Log on to E.online with an account. In the "Analyses" menu, click on "Page headers and footers". Click on "Add". Enter a "Label" for the page header. Select the image of the header by using the "Browse" command. Choose the position of the header on the page. Click on "Confirm". You then jump to the list of headers and footers. Click on "Add". Enter a "Label" for the page footer. Use the "Brows" command to select the image of the footer. Choose the position of the footer on the page. Click on "Confirm". You then jump to the list of headers and footers. You can "Add", "Delete", "Modify", "View" or "Set as default" a page header or footer. 63

64 XLVIII. Adding Contacts to the Address Book This paragraph describes the procedure for adding, modifying or deleting contacts in the list in the address book. - Method Log on to E.online with an administrator or user account. Click on the icon and then select "Setting Up - My address book". Click on "Add". Enter: o A "First name". o A "Last name". o An " address". Click on "Confirm" to record the parameter settings and then jump to the list of contacts. You can "Add", "Delete" or "Modify" a contact. 64

65 XLIX. Modifying the Parameter Settings of the Software This paragraph describes the procedure for modifying the operating parameters of the E.online software. - Method Log on to E.online with an administrator account. Click on the icon and then select "Setting Up - Software settings". Click on "Modify". Enter: o MTR level of detail: "normal" is the default value ("Debug" mode is only used at the request of the support service). o Data-retrieval level of detail: the default value is "All". o List refresh time: the default value is "30 sec"; this is the time between refreshes of the lists on screen. o Measurement refresh time: the default value is "5 sec", this is the time between refreshes of the display pages for the values measured in real time. o Data retrieval display refresh time: the default value is "5 sec", this is the time between refreshes of the page for monitoring execution of data-retrievals ("Automatic Tasks Data-retrieval: "Monitor"). o Number of entries displayed in the log: the default value is "50", this is the max. number of data-retrievals displayed in the history ("Automatic Tasks Dataretrieval history). o Delay before redirecting for analysis results: the default value is "30 sec", if the result of an analysis is displayed more than 30 seconds after execution, the user is redirected towards the list of analyses. o Minimum log conservation minimum (in months): the default value is "1 month", this is the depth of the data-retrieval history kept in the data-retrieval log ("Automatic Tasks Data retrieval history). o Errors tolerated for analyses allocated by hour: the default value is "not checked"; if an 'x minutes' point is missing in the one-hour load curve, the hour cell will have a coloured background in the consumption analysis table (Analysis Data analysis). o Errors tolerated for analyses allocated by day: the default value is 0; if an 'x minutes' point is missing in the one-day load curve, the day cell will have a coloured background in the consumption analysis table (Analysis Data analysis). 65

66 o Errors tolerated for analyses allocated by month: the default value is 0; if an 'x minutes' point is missing in the one-month load curve, the month cell will have a coloured background in the consumption analysis table (Analysis Data analysis). o Errors tolerated for analyses allocated by year: the default value is 0; if an 'x minutes' point is missing in the one-year load curve, the year cell will have a coloured background in the consumption analysis table (Analysis Data analysis). o Maximum number of devices to generate charts: the default value is "50"; this is maximum number of lines displayed in a table before pagination (e.g. 3 pages for 130 lines). o Tolerated for monthly index consolidation: Tolerance in days (default value: 1 day) around the precise scheduled date and time for data-retrieval. Outside this window, the value retrieved will not be stored in the database. o Tolerated for daily index consolidation: Tolerance in hours (default value: 2 hours) around the precise scheduled date and time for data-retrieval. Outside this window, the value retrieved will not be stored in the database. o Tolerated for hourly index index: Tolerance in minutes (default value: 1 minute) around the precise scheduled date and time for data-retrieval. Outside this window, the value retrieved will not be stored in the database. o Tolerated for one-minute index consolidation: Tolerance in seconds (default value: 5 seconds) around the precise scheduled date and time for data-retrieval. Outside this window, the value retrieved will not be stored in the database. o Authorize manual modification of all the devices: authorizes modification of the data stored in the E.online database, using the "Advanced functions Manual input" menu. o IP address of SMTP server: enter the mail server address. o Sender's address of the user account. o Administrator's address of the administrator. Click on "Confirm" to record the modifications. 66

67 L. Modifying the Parameter Settings for an Account This paragraph describes how to modify the parameter settings for an account - At least one account must have been created (administrator or user). Method Log on to Eonline with an account (administrator, shared user or restricted user). Click on the icon and then select "Setting Up - My account". Click on "Modify". Modify the elements in the list. Click on "Confirm" to record the modifications. 67

68 LI. SQL Connector Here is the E.online main interface and the menu giving access to the connectors. You can access the page for managing the SQL Connectors via the "Advanced Functions - Data Export - Automatic Tasks" menu. The action bar can be used to manage your various connectors. 4 actions are then available: - Add - Delete - Modify - Update 68

69 LII. Principle of an SQL Connector / Data Access This paragraph explains the principle of an SQL connector Description An SQL connector is an automatic task which is executed periodically (e.g.: every day at 4 a.m.) or upon an event (e.g.: end of execution of a periodic retrieval of data from communicating devices), and which enables values (consumption, index, average values, financial data, etc.) from different devices and variables to be exported into specific tables. Only the data of variable selected to be "part" of a connector is visible in the export tables. To be selectable, a variable must have its measurement unit associated with a tariff contract (see paragraph "Configuring a Tariff contract for energy units"). A variable can be associated with several tariff contracts configured on the same devices. However, the "Device / Variable" and "Tariff contract" couple is still unique (it is impossible to create the same "Device / Variable" and "Tariff contract" couple in two different connectors, to prevent duplicates in the database). For automatic tasks executed automatically following an event (e.g.: end of the execution of a periodic data-retrieval from communicating devices). The data available in the export tables is automatically replaced by the new retrieved values, without having to create an SQL connector beforehand. 69

70 LIII. Creating the ODBC Links This paragraph describes how to create an ODBC link - You must have installed the "MySQL ODBC 3.51 driver" with the setup program located in the directory "\Eonline II\Drivers\odbc". This driver must be installed on the machine where you wish to process the data. Method For Microsoft Windows 32-bit operating systems: Go to Control Panel / Administrative Tools / Data Sources (ODBC). o Go to "Administrative tools". o o o o o Select "Data Sources (ODBC)". Select the "System DSN" tab. Click on "Add". Select "MySQL ODBC 3.51 driver". Click on "OK". For Microsoft Windows 64-bit operating systems: The control panels for 64-bit and 32-bit drivers are separate. To access the panel for 32-bit drivers, you have to go into the following directory: C:\Windows\SysWOW64\odbcad32.exe 70

71 Complete the following fields: o Database Source Name (e.g. SQL1Connector). o Server (address of the machine where E.online is implemented, e.g ). o o User: eonline Password: eonline To access the allocated consumption data: o Choose "webapp_eonline_3_0_0" as the "database". To access the raw data "average power values x minutes" o Choose "mtr_eonline_3_0_0" as the "database". Click on "TEST" to check that the link is configured correctly. Click on "OK". Repeat the operation if the 2 types of data interest you. 71

72 LIV. Adding SQL Connectors This paragraph describes how to create an SQL connector - There must be a tariff contract configured (see paragraph "Configuring a Tariff contract for energy units"). - There must be at least 1 device read remotely. Method After going to the "SQL Connector pages" via the "Automatic Tasks" menu: Click on Add. Name your connector and click on "End". Choose the "Device / Variable and Tariff Contract" pairs that you wish to add to the connector and then click on "Next". Use the "Summary" to check your choices and then click on "Confirm". 72

73 LV. Deleting SQL Connectors This paragraph describes how to delete an SQL Connector - An SQL connector must have been created. Method Select the SQL connector to be deleted. Click on "Delete". IMPORTANT NOTE: If you delete a connector, ALL THE ASSOCIATED DATA will disappear from the Export tables. To makes these data available again (after updating the connector), however, all you have to do is add the "Device / Variable and Tariff Contract" pair again. 73

74 LVI. Modifying SQL Connectors This paragraph describes how to modify an SQL Connector - There must be an existing SQL connector. Method Select the connector to be modified. Click on "Modify". The steps are the same as for creation of a new SQL connector. IMPORTANT NOTE: If you unselect a "Device / Variable and Tariff Contract", the data linked to the pair will be deleted from the export tables. 74

75 LVII. Updating the SQL Connector Data This paragraph describes how to update the data of an SQL Connector By updating the data of an SQL connector, you can: Update the data when the tariff contract has been modified. Calculate / recalculate the data and cost for all the "Device / Variable and Tariff Contract" pairs linked to the connector. - There must be an existing SQL connector. Method Select the connector to be modified. Click on "Update". IMPORTANT NOTES: The Update will only be applied the next time the connector is triggered (the next day at am). After modifying a connector (particularly by adding "Device / Variable and Tariff Contract" pairs), it is advisable to update the SQL connector You do NOT need to update a connector if you have deleted a "Device / Variable and Tariff Contract" pair. PRINCIPLE For ALL the "Device / Variable and Tariff Contract" pairs: Calculation of values (cumulated and average) for ALL the available days following the various data-retrievals. If the Tariff contract period corresponds to the value calculation period (cumulated and average), calculation of the cost; otherwise the cost is set to 0. 75

76 LVIII. Diagram of the Tables of calculated data Login: eonline Password: eonline Access: read mode Access to the data calculated based on the load curves of ENERDIS devices, and those generated based on analogue and index-type quantities The calculated values are updated every day at 4 a.m. 76

77 Description of tables The data in the tables are from: The data-retrieval from ENERDIS devices and other types of devices via the generic driver (XML RPC function) - Load Curve, index and analogue-type data (generating a Load Curve). The data-retrieval of xml files from the Radio Frequency collector - index and analoguetype data (generating a Load Curve). The retrieval of data from the ELOG data logger / concentrator - index and analogue-type data (generating a Load Curve). The manual input of data - index, difference between two indices and analogue-type data (generating a Load Curve). web_connector ID label type_id table of SQL connectors SQL connector identifier SQL connector label Type of SQL connector: Day after Day connector_status_id Status of the executed task of the SQL Connector: - Value 0 : Active task - Value 1 : Inactive task - Value 2 : Scheduled task - Value 3 : End of the execution of the Task - Value 4 : Task under execution - Value 6 : Failure during execution of the Task periodicity date_declenchement date_analyse ideventsconnector web_connector_device_contract_join connector_id device_id device_mode variable_id Every day Every day at 4 a.m. Date of last recording Identifier of the crontab table of tariff contracts associated with variables SQL connector identifier Device identifier Type of Device: - Value 1 : Physical Device - Value 2 : Virtual Device Variable identifier 77

78 variable_mode contract_id web_connector_result_contract_day ID connector_id device_id device_mode variable_id variable_mode contract_id date valuefilo valuecost web_connector_result_filo_day ID connector_id device_id device_mode variable_id variable_mode contract_id labeltariff Nature and origin of the variable: - Value 1 : static (ENERDIS products) - Value 2 : generic driver - simple variable - Value 3 : generic driver - composite variable - Value 4 : Radio Frequency (xml) - ELOG (web service) Identifier of the tariff contract associated with the variable table of results of calculations and costs Primary key SQL connector identifier Device identifier Type of Device: - Value 1 : Physical Device - Value 2 : Virtual Device Variable identifier Nature and origin of the variable: - Value 1 : static (ENERDIS products) - Value 2 : generic driver - simple variable - Value 3 : generic driver - composite variable - Value 4 : Radio Frequency (xml) - ELOG (web service) Identifier of the tariff contract associated with the variable Date and time of the result Add new available data (hours, days, months, years) Add new available data (hours, days, months, years) table of results of calculations and costs by tariff item Primary key SQL connector identifier Device identifier Type of Device: - Value 1 : Physical Device - Value 2 : Virtual Device Variable identifier Nature and origin of the variable: - Value 1 : static (ENERDIS products) - Value 2 : generic driver - simple variable - Value 3 : generic driver - composite variable - Value 4 : Radio Frequency (xml) - ELOG (web service) Identifier of the tariff contract associated with the variable Label of an item of the tariff contract associated with the variable 78

79 date valuefilo valuecost web_connector_result_devices ID connector_id device_id device_mode variable_id variable_mode contract_id device_name device_energy device_level1 device_level2 device_level3 device_level4 device_description variable_name variable_unit contract_name money_unit Date and time of the result Add new available data (hours, days, months, years) Add new available data (hours, days, months, years) Device and Variable description table Primary key SQL connector identifier Device identifier Type of Device: - Value 1 : Physical Device - Value 2 : Virtual Device Variable identifier Nature and origin of the variable: - Value 1 : static (ENERDIS products) - Value 2 : generic driver - simple variable - Value 3 : generic driver - composite variable - Value 4 : Radio Frequency (xml) - ELOG (web service) Identifier of the tariff contract associated with the variable Label of the Device Label of the type of Device Label of level 1 of Device architecture Label of level 2 of Device architecture Label of level 3 of Device architecture Label of level 4 of Device architecture Value of the description field of the Device Name of the variable Name of the variable unit Label of the tariff contract associated with the variable Name of money unit 79

80 LIX. Diagram of the Tables of retrieved data Login: eonline Password: eonline Access: read mode Access to index and analogue-type retrieved data The values are updated at each data-retrieval 80

81 Description of tables The data in tables are from: The data-retrieval from ENERDIS devices and other types of devices via the generic driver (XML RPC function) - index and analogue-type data. The data-retrieval of xml files from the Radio Frequency collector - index and analoguetype data. The retrieval of data from the ELOG data logger / concentrator - index and analogue-type data. The manual input of data - index, difference between two indices and analogue-type data. web_device_variable_config id device_id device_mode variable_id variable_mode variable_type web_data_mapping_result_hour config_id retrieve_data retrieve_value web_data_mapping_config config_id device_name device_energy device_level 1 variable identification table SQL connector identifier Device identifier Type of Device: - Value 1 : Physical Device - Value 2 : Virtual Device Variable identifier Nature and origin of the variable: - Value 1 : static (ENERDIS products) - Value 2 : generic driver - simple variable - Value 3 : generic driver - composite variable - Value 4 : Radio Frequency (xml) - ELOG (web service) Type of the variable : - Value 4 : Cumulated index - Value 5 : Instantaneous or average value - Value 6 : Difference between 2 index Table of results of raw data (INDEX+ANALOGUE+CONSUMPTION) Unique identifier (reference to the id column of the web_device_variable_config table) Date of retrieval of the last values in GMT Value of the last retrieval Table for the configuration of the variables of data retrievals Unique identifier (reference to the id column of the web_device_variable_config table) Label of the Device Label of the type of Device Label of level 1 of Device architecture 81

82 device_level 2 device_level 3 device_level 4 device_description variable_name variable_unit Label of level 2 of Device architecture Label of level 3 of Device architecture Label of level 4 of Device architecture Value of the description field of the Device Name of the variable Name of the variable unit 82

83 LX. Database Backup This paragraph describes how to back up the E.online application Important Backing up the database is essential for any operation or new installation or correction made to Eonline2. Backing up enables the database to be reconstructed if necessary, in the event of data loss or corruption. MySQL has a specific command: "mysqldump". This triggers a "dump" of the database, in the form of a file with an extension of ".sql". - Have access rights to the E.online installation directory. Operating Mode On the data partition, and if necessary the system partition, create a data backup directory: Create a directory: "backup Eonline II" (for example). Go to the Eonline 2 installation directory. Go into the binary directory of the MySQL server: "EonlineII\MySQL\MySQL Server 5.0\bin". Copy the "backup.bat" database backup file if it does not exist. Edit the "backup.bat" file. Enter the backup path already created, "C:\ backup Eonline II" in the variable: "vardir" as follows: 83

84 In the same edited file, add the following command at the end of the line: "pause". This command enables you to see if there is an error message in the database backup: Save the changes made to the "backup.dat" file and exit. Execute the "backup.bat" script as administrator: 84

85 Launch a command from the command line as follows : When execution of the script is complete, the following message will be displayed: "Press any key to continue...": (Press the "Enter" command for the command window to disappear) : 85

86 Go into the Eonline 2 backup directory, "C:\ backup Eonline II". Check that the backup file has been created, in the following format: "backup_eonlineii_yyyymmdd-hhmm.sql". The filename created may be truncated, in particular in the section containing the backup date; in this case contact application support. To check the concordance of data, the backup file should not be empty (size of the file different to 0 KB). 86

87 To check the backup is not corrupted, execute a new backup as outlined above: A second backup file is created: Check that both backup files take up the same disk space: 87

88 Delete one of the files after checking: Edit the "backup.bat" backup script and delete the "pause" command at the end of the line: Save and exit the file. 88

89 LXI. Eonline 2 Database Restoration This paragraph describes the restoration procedure for the E.online application - Have access rights to the E.online installation directory. Operating Mode Go into the database backup directory: "C:\backup Eonline II": Go into the Eonline2 installation directory. Go into the binary director of the MySQL server: "C:\Program Files\EonlineII\MySQL\MySQL Server 5.0\bin". Copy the database restoration file, "restore.bat", if it does not exist. Edit the "restore.bat" file. Enter the full name of the database backup file (restoration path + the filename) "C:\ backup Eonline II\backup_EonlineII.sql" in the variable: "varfile" as follows : 89

90 In the same edited file, add the following command at the end of the line: "pause". This command enables you to see if there is an error message during the restoration of the database: Save the changes made to the "restore.bat" file and exit. Execute the "restore.bat" script as administrator: 90