wiki:OpendasDescriptionSupervision

Supervision

Description

The supervision panel allows the display of one or more "supervisor" that update automatically when they receive a new value from its source (Material, Topic, other supervisor, etc).

A historic of the received data can be kept and be show under the form of charts by a click on the related supervisor.

Graphical Overview

Panel :

Discrete or Continuous Charts :

Liste Charts :

Configuration

The elements of supervision panel are essentially customizable in the field mapping of the table das_template_supervision.

  • name
    For call this supervision configuration : In the table das_functional_configuration, field function_xml, with the line <supervision name="supervision_name"></supervision>
  • image
    A image can be used as background.
  • size
    Multiple fields allow to define the size/scale of the supervision panel (As a grid : horizontal case number, horizontal case width, vertical... [etc])
  • mapping
    This field appears under the following shape:
    <?xml version="1.0" encoding="UTF-8"?>
    <case>  
            <sup>
                    <!-- Define the source of the supervisor to a specific variable in context or a supervisor-->
                    <!-- <mappingdata>valeur1</mappingdata> -->
                    <!-- <mappingsupervision>sup1</mappingsupervision> -->
                    
                    <!-- Define the source of the supervisor to a specific material -->
                    <code>1</code>
                    <material>GUITEST</material>
                    
                    <!-- Define the source of the supervisor to a specific material -->
                    <listentopic>supervision_1</listentopic>
                    
                    <!-- Define the name of activemq's queue where the values from the material are send -->
                    <!-- <sendtopic>topic_name</sendtopic> -->
                    
                    <!-- Generate link from the supervisor with the code number to this supervisor -->
                    <!-- <linkedfrom>1</linkedfrom> -->
    
                    <!-- Define location of the component relative to the grid. A n.n value can be use (ex : 1.5) -->
                    <positionX>6</positionX>
                    <positionY>1</positionY>
                    
                    <!-- Define size of the component : By default, the value is case width/height of the grid.  A n.n value can be use (ex : 1.5) -->
                    <sizeW>1</sizeW>
                    <sizeH>3</sizeH>
                    
                    <!-- Define the shape of the component : square/circle/triangle -->
                    <shape>square</shape>
                    
                    <!-- Define the orientation of the shape. 
                    - Value : horizontal/vertical/top/right/bottom/left
                    - can be combined (for 'complex' link : "top/left", or for arrow direction "horizontal/left") 
                    -->
                    <orientation>default</orientation>
    
                    <!-- Define if the component's is filled with the color define below, or stay white -->
                    <filled>1</filled>
                    
                    <!-- Define if the component's value is showed -->
                    <displayvalue>1</displayvalue>
                    
                    <!-- Define if the data are saved and can be showed as a graphic in the futur -->
                    <savedata>1</savedata>
                    
                    <!-- Define a color for values between min and max. No min or max means infini.
                    <cmm colorr="0" colorg="100" colorb="0" min="200"></cmm>
                    <cmm colorr="0" colorg="210" colorb="0" min="150" max="200"></cmm>
                    <cmm colorr="255" colorg="255" colorb="0" min="100" max="150"></cmm>
                    <cmm colorr="230" colorg="100" colorb="0" min="50" max="100"></cmm>
                    <cmm colorr="210" colorg="0" colorb="0" min="0" max="50"></cmm>
                    <cmm colorr="100" colorg="0" colorb="0" max="0"></cmm>  
                    -->
                    <!-- Define a specific color(r/g/b) to a value (ie : 0 = red and 1 = green) -->
                    <cv colorr="100" colorg="0" colorb="0" value="0"></cv>
                    <cv colorr="250" colorg="250" colorb="0" value="1"></cv>
                    <cv colorr="0" colorg="100" colorb="0" value="2"></cv>
    
                    <!-- Generate value for simulate real-situation -->
                    <inputGenerator min="0" max="2" continue="0" valueinterval="1" timeinterval="30000"></inputGenerator>           
    
                    <!-- Defaut discrete, no line, 3 minutes of range -->
                    <!-- Define the type of the historic graph discrete/continuous/liste-->
                    <graphtype>discrete</graphtype>
                    
                    <!-- Define if the line between to input is paint -->
                    <graphline>0</graphline>
                    
                    <!-- Define if the line is normal or not -->
                    <graphlinetype>normal</graphlinetype>
                    
                    <!-- Open the graph with the last number of second/minute/day/Month/Year(s,m,d,M,Y) in the graph. (ie : "5m" = show the last 5 minutes-->
                    <graphtime>3m</graphtime>
                    
                    <!-- Define the range of historic size -->
                    <nbsaveddata>50</nbsaveddata>                           
            </sup>
            <!-- <sup> : Define a dynamic link (which color updated with supervision parent value) between two supervisor (with <linkedfrom> and <linkedto> balises -->
            <sup>
                    <refcode>1</refcode>
                    <linkedfrom>1</linkedfrom>
                    <linkedto>2</linkedto>
                    <cmm colorr="255" colorg="0" colorb="0" max="0"></cmm>
                    <cmm colorr="0" colorg="255" colorb="0" min="0"></cmm>
            </sup>
            <!-- <other> : Define a static link between two supervisor -->
            <other>
                    <linkedfrom>1</linkedfrom>
                    <linkedto>2</linkedto>
            </other>
    </case>
    

Attachments