Scadamanual Us

8/9/2019 Scadamanual Us

1/338


2/338


3/338


4/338


5/338

18.

OPCSERVER ...................................................................................................... ......................................... 209

18.1. GENERAL PROPERTIES OF OPCSERVER ...................................................................................................... 210 18.2. OPC T AGS .................................................................................................................................................. 212 18.3. OPC GROUPS ............................................................................................................................................. 216 18.4.

QUALITY ........................................................................................... ........................................................... 217

19.

SCRIPTS ......................................................................................... ......................................................................... 219 19.1. GENERAL CONSIDERATIONS......................................................................................................................... 219

19.2. APPBROWSER AND CROSSED REFERENCE .................................................................................................. 220 19.3.

OPERATORS AND CONSTANTS ..................................................................................................................... 222 19.4.

FLOW CONTROL .......................................................................................................................................... 224 19.4.1. If…Else…ElseIf…EndIf Command ........................................................................................... ........... 224 19.4.2. For…Next Command .......................................................................................................................... 224 19.4.3. While…Wend Command .............................................................................................. ....................... 225 19.4.4. Repeat…Until Command .................................................................................................................... 225 19.4.5.

Return Command ....................................................................................... ......................................... 225

19.5.

SPECIAL FUNCTIONS ........................................................................................... ......................................... 226 19.5.1. Global Manager Functions .................................................................................................................. 226 19.5.2. Application Functions ................................................................................................ .......................... 249 19.5.3.

Tag Functions ..................................................................................................................................... 251

19.5.4.

Screen Functions ................................................................................................................................ 255

19.5.5.

Screen Objects Functions ........................................................................................................ ........... 256 19.5.6. Alarms Functions.................................................................................................... ............................. 263

19.5.7. Recipes Functions ............................................................................................................................... 266 19.5.8. Historic Functions ................................................................................................................................ 268

19.5.9.

HAnalysis Functions .......................................................................................... ....................... 270

19.5.10.

SPC Functions ................................................................................................ .......................... 271

19.5.11. Report Functions ................................................................................................................................. 271 19.5.12. Query Functions .................................................................................................................................. 273 19.5.13.

Plotter Functions ................................................................................................................................. 273

19.5.14. Drivers Functions ................................................................................................................................ 274

19.5.15. Database Functions ........................................................................................... ....................... 276

19.5.16.

Remote Applications Functions ........................................................................................................... 282

19.5.17.

OPCServer Functions ....................................................................................... ....................... 283

19.6. ATTRIBUTES ................................................................................................................................................ 283 19.6.1. Global Manager Attributes ............................................................................................ ....................... 284 19.6.2. Application Attributes.................................................................................. ......................................... 284 19.6.3.

Tags Attributes .................................................................................................................................... 288

19.6.4. Screen Attributes ........................................................................................ ......................................... 294 19.6.5. Attributes of Screen Objects ......................................................................................... ....................... 296 19.6.6. Plotter Attributes ......................................................................................... ......................................... 317 19.6.7. Alarms Attributes ........................................................................................ ......................................... 321 19.6.8.

Recipe Attributes ................................................................................................................................. 322

19.6.9.

Historic Attributes ................................................................................................................................ 322

19.6.10. HAnalysis Attributes ........................................................................................... ....................... 323

19.6.11.

Query Attributes ....................................................................................................................... ........... 324

19.6.12.

SPC Attributes ................................................................................................ ........................... 325

19.6.13. Batches Attributes ............................................................................................................................... 326 19.6.14. Reports Attributes................................................................................................................................ 326 19.6.15. Drivers Attributes ........................................................................................ ......................................... 327

19.6.16.

Database Attributes ........................................................................................... ....................... 329

19.6.17.

Attributes of the Users List ........................................................................................... ....................... 329

19.6.18. Remote Application Attributes .................................................................................................. ........... 329

19.6.19. Watcher Attributes ............................................................................................. ....................... 333

19.6.20.

Steeplechase Attributes ................................................................................................. ........... 335

19.6.21.

OPCServer Attributes ........................................................................................ ....................... 335


6/338


7/338


8/338


9/338

Introduction 9

Welcome to Elipse SCADA! Elipse Software is proud of presenting this powerfultool for the development of supervision systems and process control.

Elipse SCADA combines high performance to strong versatility, represented by itsseveral features, which facilitate and speed up the task of developing yourapplication. Totally configurable by the user, it allows the monitoring of variables in

real time through graphs and objects related to the physical variables in the field. Itis also possible to make activations and to send or receive information from dataacquisition equipment. Besides that, through its exclusive programming language,Elipse Basic, it is possible to make various tasks become automatic; in order tofulfill the specific needs of your company.

We thank you for your preference for our products, and we wish you success withyour new working tool!

Elipse Softw are Team

1.1. Elipse SCADA Packages

Elipse SCADA is available in different packages, fulfilling the demands ofcustomization of our clients. Next, you can see the characteristics of each one:

Elipse View

It is indicated for simple applications, such as an interface with the operator formonitoring and activations. Elipse View enables variables visualization, including

the use of animations, setpoints programming, access control, and special functionsfor touchscreen. This pack includes:

Communication with equipment via drivers (DLLs) and OPC (Server andClient);

Screen Objects;

Visualization of active alarms;

Block communication;

Scripts;

DDE server and client;

Elipse network server;

Chapter

1. Introduction


10/338


11/338


12/338

User Manual

12 Introduction

processes from any part of the world.


13/338


14/338

User Manual

14 What Is On Screen?

the applications that will run in the version Windows CE must be necessarilycreated in the version Windows, Set Up mode.

2.1. Menu Options

It is through the menu options that you can access the software‟s features andfunctions. Next, we describe the options of Elipse SCADA.

2.1.1. File Menu

Picture 2: File Menu


15/338

User Manual

What Is On Screen? 15

Options for File Menu

OPTION DESCRIPTION

New application Creates a new application.

Open application Opens an application already existing.Save application Saves the current application.

Save application as Saves a copy of the current application in a new file.

Close application Closes the current application.

Run Runs the current application.

Organizer Calls the Organizer.

Options… It allows you to configure some options of Elipse SCADA,

such as the creation of a backup file (.BAK ) when saving theapplication; protection mechanism settings, and language

library file name (the default is INTLUS32.DLL).It is also possible to specify an application to be executed

when Elipse SCADA is activated remotely via OPC.

1, 2, 3 and 4 Lists the four files recently open

Exit Closes Elipse SCADA.

2.1.2. Screen Menu

Picture 3: Screen Menu


16/338

User Manual


Options for Screen Menu

OPTION DESCRIPTION

New Creates a new screen (blank).

Delete Deletes an already existing screen.Close Closes the current screen.

Monitor Monitors the current screen.

Properties Shows the properties of the current screen, where you candefine a background image and window style, among other

features.

Redraw Redraws the loaded screens.

2.1.3. Objects Menu

Picture 4: Objects Menu


17/338


18/338


19/338

User Manual

What Is On Screen? 19

Options for Help Menu

OPTION DESCRIPTION

Index Shows the help index.

Using Help Explains how Help should be used. About Elipse SCADA... Shows information related to Elipse SCADA, such as

version, number of hardkey and copyrights.

2.2. Toolbars

Toolbars offer a quick access to Elipse SCADA‟s functions. These functions aredistributed in four groups, as follows: Application, Screen Objects, Arrange, andScreens, as follows.

2.2.1. Application Toolbar

Picture 8: Application Toolbar


20/338

User Manual


Buttons for Application Toolbar

BUTTON ACTION

Creates a new application.

Creates a new screen.

Opens an application that already exists.

Saves the current application.

Cuts out the selected object, copying it to the clipboard.

Copies the selected object to the clipboard.

Pastes the object in the clipboard to the place indicated on

screen.

Calls the Organizer.

Shows the properties of the selected object.

Shows the properties of the selected screen.

Runs the current application, starting with open screens.

Runs current application.

Opens the system help.

Activates the help related to the context.

2.2.2. Objects Toolbar

Picture 9: Objects Toolbar


21/338


22/338

User Manual


Buttons for Arrange Bar

BUTTON ACTION

Sends the selected object to the background of the screen.

Brings the selected object to the front of the screen.

Aligns the selected objects to the left side.

Aligns the selected objects to the right side.

Aligns the selected objects to the top.

Aligns the selected objects to the bottom.

Centralizes the selected objects horizontally to the screen.

Centralizes the selected objects vertically to the screen.

Applies the same width to all objects.

Applies the same height to all objects.

Applies the same size to all objects.

Groups the selected objects.

Ungroups the selected objects.

2.2.4. Screens Toolbar

The Screens Toolbar shows the name of current screen, and allows you to switchscreens through a list showing the name of all screens existing in the application.

Picture 11: Screen Toolbar


23/338


24/338

User Manual


Editing reports

OPTIONS DESCRIPTION

Ctrl + F4 Closes the reports editor

Esc Unselects objectCtrl + A Selects all objects

Del Erases object

2.4. Command Line Options

It is possible to call Elipse SCADA directly from the command line. The executable

ELIPSE32.EXE has the following syntax:

ELIPSE32.EXE [-DEMO] [-SETUP] [-EDIT] []

Where:

-DEMO (Optional) Forces Elipse SCADA to run in demonstration mode withoutchecking the protection mechanisms (hardkey). This option rewrites the .INI file,

by setting the[ProtectionType] section.

-SETUP (Optional) Forces Elipse SCADA to run the Setup program, which allows you toconfigure the options in the file of preferences (.INI).

-EDIT (Optional) Forces Elipse SCADA to run in Configuration mode. If the name ofan application is informed in the command line, this application will be opened

for configuration.

NameApp (Optional) The name of the application that will run automatically or will beopened for configuration (when -EDIT is specified).

In the version Windows CE, the only command line available is NameApp.


25/338

Organizer 25

The development of an application in Elipse SCADA is based on the Organizer tool.It allows a simple and organized view of the whole application, helping in the

edition and configuration of all objects involved in the system through a hierarchicaltree.

Organizer ‟s structure can be compared to directory tree of Windows File Manager.

So, the structure of the application starts in the top left corner, with the application ‟s root. All objects of the application descend from the root, grouped according to theirtype: Tags, Screens, Alarms, Recipes, Historic, Reports, Drivers, Databases andothers, which constitute the main elements of your application. By selecting any ofthe branches of the application tree, it will expand, showing its content; therefore,

you can easily navigate through the application by having available all options ofconfiguration, from the creation of Tags to the resizing of objects in a specificscreen.

Organizer ‟s basic structure is:

Picture 12: Organizer

You can call the Organizer only when there is an open application, by selecting theOrganizer command in the File menu, or by pressing the Organizer button in theToolbar. The following window will appear:

Chapter

3. Organizer


26/338

User Manual

26 Organizer

Picture 13: Organizer Window

From the Organizer, you can create your whole application simply by navigatingthrough the application tree. By selecting any of its branches, the properties of theselected object will be shown on the right side of the window, where they can be

edited. For example, if you select Tags in the Organizer tree, you can create newTags and edit their properties by selecting the page wanted from the tabs on top ofthe window.


27/338


28/338

User Manual

28 Organizer

Organizer Tools

ICON COMMAND ACTION

DeleteErases one or more items selected in the

Organizer.

DuplicateDuplicates the item selected in the Organizer

tree.

AppBrowserCalls the AppBrowser.

Cross referenceCalls Cross Reference.

CompileCompiles the script being edited.

Compile allCompiles all scripts that are not compiled.

Recompile all

Recompiles all scripts in the application,

enabling the user to access each script with adouble click. It is generated a list of compiled

scripts, by showing in red the ones with error.

IfInserts the IF...ENDIF command to theselected script, in the point where the cursor is.

Else…If Inserts the ELSE...IF command to the selected

script, in the point where the cursor is.

ElseInserts the ELSE command to the selectedscript, in the point where the cursor is.

For…Next

Inserts the FOR...NEXT command to the

selected script, in the point where the cursor is.

While…Send

Inserts the WHILE...WEND (end of While)

command to the selected script, in the point

where the cursor is.

Repeat…Until Inserts the REPEAT...UNTIL command to the

selected script, in the point where the cursor is.

3.1. AppBrowser

The AppBrowser is an important Organizer tool. It is composed of a window presenting the application tree with its objects. By clicking any object, it is possible

to view the functions and attributes related to this object. When we are writing a

script, a Copy in Script --> button stays available on this window, allowing for thecopy of the attribute or function focused to the programming rows, thus making thistask to be easier.


29/338

User Manual

Organizer 29

Picture 15: AppBrowser

3.2. Creating new application

The creation of an application is the starting point for the assembly of a system by

using Elipse SCADA. With an application, the user gathers all objects necessary forthe execution of wanted tasks. Information referring to this application is stored in afile having APP extension.

In order to create a new application, do the following:

Choose in the File menu the New Application option, or click thecorresponding button in the toolbar.

In the Save New Application! Frame, choose a name and the place where theapplication will be saved.

Besides the files with APP extension, there are others that are generated andused by Elipse SCADA:

NOTE: Windows XP users must pay attention to System Restore tool. This tool alsotracks .APP files changes, and if you restore the system, the tool will reverse the

new version files into older ones.


30/338

User Manual

30 Organizer

App extension

EXTENSION DESCRIPTION

.APX File having the settings of the users list.

.BAK Backup of application

.DAT File of historic

.HDR Headers of historic files in batch

.RCP Recipes file

.DLL, .SO Communication drivers

.BMP, .JPG, .GIF Image files

In CE, only .BMP is currently avaliable.

3.2.1. General Properties of the Application

When you select the root of the Application in the Organizer tree, its properties areshown on the right side of the tree. The page of general properties appears when theApplication tab is selected on top of the Application pages. This page is shown

below, and its respective fields are described in the following table.

Picture 16: Properties of Application


31/338

User Manual

Organizer 31

Properties of the Application form

OPTIONS DESCRIPTION

Description Defines the name of the application (which will appear onthe title bar) in case the TitleBar option is enabled.

Title bar Enables the title bar in the application window.

In CE, the title bar observes this property only for

windowed screens. Full screens observe CE‟s pattern;some platforms never appear, others always appear.

Properties of the Application form (four Styles)

OPTIONS DESCRIPTION

Disables task switching Disables the switching between tasks, i.e., disables the[Alt+Tab] shortcut of Windows.

Disables screen saver Disables any screen protector ( screen saver ) while ElipseSCADA is running.

Close Button Enables the Close button on the title bar of the applicationwindow.

Minimize Button Enables the Minimize button on the application window.

Maximize Button Enables the Maximize button on the application window.

Allow Close If switched-off, makes the execution to be ended only

when the StopRunning() function is called. If switched-

on, allows the closing of the application (and ElipseSCADA) via other media, as through a click on the Close,

switch-off button of Windows, etc.

Properties of the Application form (Buttons)

OPTIONS DESCRIPTION

Statistics… Opens a window which shows statistical information ofthe application, like: total time for editing the application,

number of items of the application, total number of tags,

number of revisions, and version of Elipse SCADA in

which the application has been generated.Find Item… Opens a window that allows the search of an item (object,

property) in any place of the application, and to present itfor edition.

Import… Opens a window that allows the choice of an applicationfor import. After choosing the application of origin, anew window is open having the tree of both applications,

so that the user can drag the objects of the application of

origin to the application of destination. Note: Theapplication of origin is not modified.

Protection… It opens a window for protecting the application. Thereare two protections: for configuration (to edit and makeany type of modification), and for execution. In case of


32/338


33/338

User Manual

Organizer 33

Properties of the Window form

OPTIONS DESCRIPTION

Start Maximized

/Minimized /Normal

Defines the initial configuration of the application

window.

X, Y, Width, Height Defines the position and size of the window in pixels.

Centralize Window Indicates that the window should initiate in central position on screen.

3.2.3. Touch Screen

Elipse SCADA has special support on the use of touch (Touch Screen), allowing a

more intuitive interface for the use of your application.

Picture 18: Touch Screen Properties


34/338

User Manual

34 Organizer

Properties of the Touch Screen

OPTIONS DESCRIPTION

Enable “Key Pad” Enables the use of Key Pad in running time.

SCADA CE currently uses Win CE‟s

keypad, so it is not possible to choose its colorsand dimensions.

Save “Key Pad” window

coordinates

Enables saving of new coordinates of Key Pad as

its window changes positions.

“Key Pad” Background color Defines the background color of Key Pad

“Key Pad” key color Defines the color of Key Pad text.

Don’t Show mouse pointer Disables the mouse pointer while the Key Pad is

being shown.Use large buttons Increases the size of Key Pad buttons.

Properties of Key Pad and Numeric Pad

OPTIONS DESCRIPTION

Show window title bar Shows the title bar of the window of Key Padand/or Numeric Pad.

Override default title bar text Allows the definition of a new title for the title barof the window of Key Pad and/or Numeric Pad.

Show close button Shows the close button of the window of Key Padand/or Numeric Pad.

3.2.4. Elipse Web

Through the Elipse Web plug-in, Elipse SCADA can generate documents to be

visualized through the Internet, together with some commercial Web Server as theMicrosoft Internet Information Server (IIS) or Microsoft Personal Web Server(PWS).


35/338

User Manual

Organizer 35

Picture 19: Elipse Web

Properties of Elipse WebOPTIONS DESCRIPTION

Enable Elipse Web data

serverEnables Elipse Web.

Default Web Pages

Directory

Allows to choose, through the [Browse…] button, thedirectory where the documents to be visualized

through the Internet will appear. The directory should

be in the tree of documents of the Web server.

Port Allows the definition of the port which the Webserver will be associated to.

3.3. Scripts

During the execution of an application, several procedures can be triggered throughevents. These procedures are described by scripts associated to these events. Moredetails about scripts will be discussed in a further chapter. Here, we have a list ofevents/scripts available in an application.


36/338

User Manual

36 Organizer

Events/Scripts of an Application

EVENT DESCRIPTION

OnKeyPress runs when a given key is pressed.

OnKeyRelease runs when the key is released.OnStartRunning runs when the application begins running.

OnStopRunning runs when the application ends running.

OnUserLogin runs when an user begins the session in theapplication.

OnUserLogout runs when an user ends the session in the application.

WhileKeyPressed runs while a given key is pressed.

WhileRunning runs while the application is running. The script willrun as many times as you define it in the text box

called Run at each (it only appears forWhileRunning scripts).


37/338

Tags 37

The supervision of a process with Elipse SCADA occurs through the reading of process variables in the field. The values of these variables are associated to objects

of the system called Tags.

To each object inserted on screen, we should associate at least a tag or attribute.Tags are all variables (numeric or alphanumeric) involved in an application.

Attributes are data supplied by Elipse SCADA about parameters of the system andcomponents of the application.

When creating tags, the user can freely organize them in groups in a way as tofacilitate search and identification during the process of configuration. For thecreation of a group, just select the Tags item in the Organizer, and click New Group.

You can create groups within other groups, without restrictions. In order to modifythe hierarchy of groups and change their position (for example, to include a groupinside another group), just drag the group focused to the desired place.

You can create and edit tags from the Organizer by selecting the Tags branch in theapplication tree and pressing the New Tag button. On the Organizer window, you

can double click the Tags option to see the tags that are already defined for the

application, in the same way as you do with a directory tree. As the applicationgrows, the tags can be grouped in order to better organize and edit the application.

4.1. Tags Group

When you select the Tags option in the application tree of the Organizer, thefollowing page will appear on the right side of the tree. By using the buttons of this

page, you can create a new group of tags or a new tag for your application. The new

group or tags that is created will automatically appear in the application tree belowthe Tags option.

Chapter

4. Tags


38/338

User Manual

38 Tags

Picture 20: Tags Group Screen

Options of Tag Group

OPTIONS DESCRIPTION

NameDefines the name of the selected group of tags. Agroup of tags works in the same way as a directory

where various tags will be defined.

Description A brief description of the selected group.

New Group Creates a new group of tags from the current group.

New Tag Creates a new tag.

Report… Opens a window for the configuration of a reportwith all tags existing in the application. Only

properties we want to print can be selected for each

type of tag. The report will be printed in a text file

which is specified in the Print box for the file.

4.2. New Tag

When you press the New Tag button, the following window will appear. In thiswindow, you can define the tag name, the quantity of tags you want to create, and

their type. All tags specified in the Quantity field will be of the same type

defined in the Tag Type field.


39/338

User Manual

Tags 39

Picture 21: Create a new tag

Available options

OPTIONS DESCRIPTION

Name Tag Name. Spaces and special characters are both allowed whenTags are used in Scripts.

Quantity Defines the number of Tags that will be created with the samecharacteristics specified.

PLC PLC Tags are used to exchange values with data acquisitionequipment.

DDE Allow exchanging data with programs that are DDE Servers. DDE(Data Dynamic Exchange) is a protocol developed by Microsoft

for communication of Windows based applications.

Demo Demo Tags are used to generate random data.

Matrix Matrix Tags allow the creation of matrixes or data vectors.

Expression Expression Tags allow the input of a numeric or alphanumericexpression (they allow the concatenation of strings, for example).

Block Block Tags are used in order to simultaneously read a block ofvalues.

RAM RAM Tags are used to store values in memory.


40/338

User Manual

40 Tags

4.3. Chrono Tag

Creates a new chronometer.

Picture 22: Properties of Chrono tags


41/338

User Manual

Tags 41

Properties of Chrono tags

OPTIONS DESCRIPTION

Name Tag Name. You can use as many characters as youwish, but spaces and special characters are not

allowed when the Tags are used in Scripts.

Description A brief description of the Tag.

Increment Determines the increment of the tag.

Preset Determines the preset time of tag.

Start Timer at ApplicationStart up

Enables the initialization of the timer when starting upthe application.

Always reset acum when

the timer starts

Enables for resetting the accumulator when starting

the timer

Save acum when exiting

application Enables for saving the accumulator when exiting

Restart on preset (loopexecution)

Enables the automatic restart in loop execution.

4.4. PLC Tag

The PLC Tag is used in order to exchange information with data acquisition

equipment by using I/O drivers supplied by Elipse depending on the type of

equipment. A help file is supplied with each driver, containing importantinformation relative to its configuration.

You can install a new driver by pressing the New button in the Drivers page and

selecting one or more drivers from the list. The Configure… button opens thewindow of properties of the driver, allowing the configuration of “P”communication parameters according to the information contained in the help file.The option of Abort in error, ends communication in case there is any problem,

impeding an application to be “locked”.


42/338

User Manual

42 Tags

Picture 23: Properties of PLC tags


43/338

User Manual

Tags 43

Properties of PLC tags

OPTIONS DESCRIPTION

Name Tag Name. You can use as many characters as you wish, butspaces and special characters are not allowed when Tags are used

in Scripts.

Change type to ... It allows the change of Tag type.

Expand bits… It allows dismembering the Tag in bits, by creating Bit Tags foreach bit or group of bits in the Tag.


Driver It allows the selection of a Communication Driver for the currentTag. The drivers should be installed through the Drivers window

in order to be available.

Driver Help It shows the Help of the selected Driver.

“N” Parameters It allows the configuration of parameters of “N” address forcurrent Tag according to the selected driver. This configuration is

contained in the Driver‟s Help, which can be accessed by pressingthe "Help" button. The values can be expressed in decimal [-

32768, 65535], octal [0o, 177777o], or hexadecimal [0000h,

FFFFh].

Scan Defines what will be the updating periodicity of tag values (inmilliseconds)

Scaling By marking this option, the Tag values will be converted into anew Scaling of values determined by the user in relation to the

limits defined in Low and High PLC, and Low and High System.

PLC Low Defines the minimum value to be read from the PLC.

System Low Defines the new minimum value for the conversion of valuesread.

PLC high Defines the maximum value to be read from the PLC.

System high Defines the new maximum value for the conversion of valuesread.

Test Connection Here Tests the communication with the PLC server, allowing for thereading and writing of values.

Enable scan reading Enables PLC tag scan reading, that is, the tag value is always

updated on the time specified inScan field.

Enable automatic reading When enabled, the tag value is read when needed only. IfEnablescan reading is enabled, this option is ignored.

Enable automatic writing Enables PLC tag automatic writing (see topic below).

Scan reading vs. autom atic reading

When the option Enable scan reading is enabled, Elipse SCADA updates the tag

value continuously, according to the frequency specified in the field Scan. This

value is also used by the option Enable automatic reading to check if the value isold, which establishes the need for forcing tag value reading. So, if the option


44/338

User Manual

44 Tags

Enable scan reading is enabled, the option Enable automatic reading will beirrelevant, because tag value is always updated.

The option Enable automatic reading can be used to optimize specific processes.

For example, if one tag is used by in a specific script, you can turn on Enableautomatic reading and turn off Enable scan reading. In this case, the tag will beread only when is necessary.

Autom at ic w ri t ing in PLC tags

When directly attributing a value to a PLC tag or block element that has the property

of automatic writing enabled, the command is directly sent to the communicationdriver, which in turn transmits it to the associated equipment. Such action does notoccur only when the attributed value is equal to the content that was already in the

tag. In case you anyway want to force writing, the Write() function of the tag should

be executed in some script (see the Chapter of Scripts).

4.5. DDE Tag

The DDE Tag is used for exchanging data between Elipse SCADA and other

applications (Excel, Access, Word, etc.) by using DDE ( Dynamic Data Exchange).In order to do so, you need to specify the server application, the topic and the item,as you can see in the window below.


45/338

User Manual

Tags 45

Picture 24: DDE Tag


46/338


47/338

User Manual

Tags 47

4.6. Demo Tag

The Demo tag is used for the simulation of values. It allows you to generate defined

curves or random values according to the type of curve selected in the six buttons ofthe General page of the Demo tag (see picture below).

Demo Tags can help you in testing your application, or can be used for examplewith an object of animation screen to show the animation frames in accordance withthe tag variation.

Picture 25: Properties of Demo tags


48/338

User Manual

48 Tags

Properties of Demo tags

OPTIONS DESCRIPTION

Name Tag Name. Spaces and special characters are bothallowed when Tags are used in Scripts.

Change type to It allows for changing the Tag type.

Expand bits… It allows the dismembering of the Tag into bits, bycreating Bit Tags for each bit.


Type Defines the type of curve to be used by the currentDemo Tag.

Low Limit Defines a minimum value for the Demo Tag.

High Limit Defines a maximum value for the Demo Tag.

Increment Defines the increment for the Demo Tag in a sawtooth type curve.

Delay Defines the number of periods between eachgeneration of value for the Demo Tag. For instance, ifit is 1, a value is generated at each period, if it is 2, a

value is generated at each two periods, and so on. It is

used together with the period attribute to control thetime interval for the variation of data.

Period Defines the number of milliseconds between thegeneration of each new value for the Demo Tag. It isused together with the delay attribute to control the

time interval for the variation of data.Enabled Defines the initial condition of the Demo Tag:

Enabled or Disabled. The values of the Demo Tag are

generated only when this option is marked; in case

not, the value of the Tag remains the same.

4.7. Expression Tag

The Expression tag allows you to attribute a numeric or alphanumeric expression toa tag. You can create equations involving other tags and strings. The same functions,operators, and constants used in Scripts can be used with Expression Tags.


49/338

User Manual

Tags 49

Picture 26: Properties of Expression tags

Properties of Expression tags

OPTIONS DESCRIPTION


Change type to It allows for changing Tag type.

Expand Bits… It allows the dismembering of the Tag into bits, bycreating Bit Tags for each bit.


Expression Allows the input of any valid expression for the tag.

Errors Lists syntax errors found in the expression. The errorsare shown during the edition of the expression, and in

order to have a valid expression, the message of “Noerrors” should appear in this field.


50/338

User Manual

50 Tags

4.8. Block Tag

Block Tags allow block communication with data acquisition equipment by using

I/O drivers supplied by Elipse depending on the type of device. A help file issupplied with each driver, containing important information relative to itsconfiguration.

You can install a new driver by pressing the New button in the Drivers page andselecting one or more drivers from the list. The Configure… button opens the

window of properties of the driver, allowing the configuration of “P”communication parameters according to the information contained in the help file.The option of Abort in error ends communication in case there is any problem,impeding an application to be “locked”.

Picture 27: Properties of PLC Block tags


51/338

User Manual

Tags 51

Properties of PLC Block tags

OPTIONS DESCRIPTION



Change type to It allows for changing Tag type.


Driver It allows the selection of a Communication Driver forthe current Tag. The drivers should be installedthrough the Drivers window to be available.

Help It shows the Help of the selected Driver.

“B” Parameters It allows the configuration of parameters of “B”address for current Tag according to the selected

driver. This configuration is contained in the DriverHelp, which can be accessed by pressing the "Help"

button. The values can be expressed in decimal [-

32768, 65535], octal [0o, 177777o], or hexadecimal

[0000h, FFFFh].

Scan Defines what will be the updating periodicity of Tagvalues (in milliseconds).

Change size Changes the size of the block to be monitored byElipse SCADA.

Add Element Allows you to add a add element to the selected Tag.

Enable scan reading Enables block reading.Enable automatic reading Enables automatic reading for the block.

Enable automatic writing Enables automatic writing for the block.

Size Configures the size of the block tag.

Add element... Add element in the block tag.


52/338

User Manual

52 Tags

4.8.1. Block Element

Each element of Block tag has its properties, which can be accessed by selecting thedesired element in the application tree in Organizer. Following page will be then

shown on the right side of the window.

Picture 28: Properties of block elements


53/338

User Manual

Tags 53

Properties of block elements

OPTIONS DESCRIPTION




Change type to... It allows for changing Tag type.

Expand Bits… It allows dismembering the Tag in bits, by creatingBit Tags for each bit or group of bits in the Tag.

Index block Allows changing the order of the element in the block by typing the index wanted.

Scaling By marking this option, Tag values are converted intoa new scale of values determined by the user

according to the limits defined at PLC Low, SystemLow, PLC High, and System High.

PLC Low Defines the minimum value to be read from the PLC.

System Low Defines the new minimum value for the conversionof values read.

PLC High Defines the maximum value to be read from the PLC.

System High Defines the new maximum value for the conversionof values read.

Test connection here Tests connection with the PLC by reading andwriting some values.

4.9. Ram Tag

Ram Tags are internally used to store values in memory. This tag type is é volatile;therefore, it maintains its values only while the application is running.

Picture 29: Properties of RAM tags


54/338

User Manual

54 Tags

Properties of RAM tags

OPTIONS DESCRIPTION




Change type to... It allows for changing Tag type.

Expand Bits… It allows dismembering the Tag into bits, by creatingBit Tags for each bit or group of bits in the Tag.

Initial value Defines an initial value for the tag. This value can bea number or a string between double quotation marks

(ex.: “abc”).

4.10. Matrix Tag

The Matrix Tag allows the creation of matrixes or data vectors that can be used incalculations, storages, etc. It is possible to map each cell of a matrix as if it was a tagor property. Operations over matrixes always have row and column starting withindex 1.

Picture 30: Properties of Matrix tags


55/338

User Manual

Tags 55

Properties of Matrix tags

OPTIONS DESCRIPTION




Columns Defines the number of columns of the matrix

Rows Defines the number of rows of the matrix

Map Maps all or just some cells of the matrix into a tag.

Asso ciating cel ls to tags

You can associate a cell of the matrix or vector to a tag by pressing the Associate…

button in the General page of the Matrix tag and specifying what or which cells youwant to associate.

Each associated cell appears below the Matrix tag in the application tree inOrganizer. When selecting a specific cell, its properties are shown on the right sideof the tree. Each associated cell has 4 pages of properties: General, Alarms, Scriptsand Tags. The 3 first pages are the same of any tag, and the page of tags allowsassociating a tag or property to the matrix cell in the same way that tags and

properties are associated to screen objects.

4.11. Bit Tag

The Bit Tag can only be created from another tag, and allows the individual accessto each bit of it. Tags allowing splitting into bits are: PLC, Demo, Expression, BlockElement, Ram, and Remote.

You can create a Bit tag from the General page of any tag cited above. By clicking

the Expand Bits… button, the following window will appear, in which you canselect the bits you want to map. The selection of bits is done by using the mouse and[Shift] or [Ctrl] keys, in the same way as items are selected in a list box of Windows.

Picture 31: Create a new Bit tag


56/338

User Manual

56 Tags

The Bit tag can be both a single bit as well as a set of bits, as long as they arecontinuous. This means that you can map for a single Bit tag, for example, bits 0, 1,and 2, but not bits 10, 11 and 24. The check box that exists in this window allowsspecifying if a tag should be created for each selected bit, or if continuous bits that

are selected should be grouped in a single tag.

In the example above, five Bit tags will be created in the following way:

TAGS bitField1 bitField2 bitField3 bitField4 bitField5

BITS 0, 1, 2 5 8 12 20, 21, 22

The Bit tags created appear below the respective tag in the application tree in

Organizer. When selecting a specific Bit tag, its properties are shown on the right

side of the tree.

The page of General Properties of the Bit tag appears when the General card isselected on top of the pages of the Bit tag. This page is shown below, and itsrespective fields are described in the following table.

Picture 32: Properties of Bit tags


57/338

User Manual

Tags 57

Properties of Bit tags

OPTIONS DESCRIPTION



Lo word bits and highword bits

Defines what are the bits or bit being a part of thattag.

4.12. Alarm Page

Each tag you define has a page of Alarms like the one shown below, where it is possible to configuration 4 intervals of values and priorities for Alarms. Alarms areused to sign some problem and then to take the appropriate actions by using scripts.In order to view the Alarms configured for a tag, you must create an Alarm screen

object and attribute the tag to it. This object can show also, already occurring alarmsthat are registered in a file of historic or alarms that are active in the system. In orderto print the alarms occurring in the system, you can define a report through the

Organizer, and run the special function Print() in a script.

The page of Tag Alarms appears when the Alarms card is selected on top of tag pages. This page is shown below, and its respective fields are described in thefollowing table.

Picture 33: Properties of Tag Alarms


58/338

User Manual

58 Tags

Properties of Alarms (associated to Tags)

OPTIONS DESCRIPTION

LoLo Critical Low Alarm. Defines an interval of values(lesser or equal) in which the Tag is considered in a

state of Critical Low Alarm. It is used when the valueof the tag is below a minimum, i.e., extremely low.

Low Low Alarm. Defines an interval of values (lesser orequal) in which the Tag is considered in a state of

Low Alarm. It is used when the tag value is belownormal.

High High Alarm. Defines an interval of values (bigger orequal) in which the Tag is considered in a state ofHigh Alarm. It is used when the tag value is higher

than normal.

HiHi Critical High Alarm. Defines an interval of values(bigger or equal) in which the Tag is considered in a

state of Critical High Alarm. It is used when the value

of the tag is above a maximum, i.e., extremely high.

Value Defines the cap for each possible situation of alarm(lolo, low, high, hihi).

Pri Defines the priority for each situation of alarm. Smallnumbers indicate high priority (the priority should be

a number between 0 and 999). For a better control,

alarms of higher priority will appear in first place inthe alarm window (Alarm screen object).

Comments A comment or message can be defined for eachalarm.

Log Alarm Return Enables the recording (log) of messages of alarmreturn.

Alarm Group Defines the group of Alarms of the current tag. Thegroup of Alarms should be defined in the Alarmsoption of Organizer.

Always in Advise Defines that the system will constantly supervise thetag, even if it is not used in any place in theapplication, in order not to loose any alarm of this tag.

Use alternate tag name Allows defining an alternative name for tags in therecording (log) of alarms.


59/338


60/338


61/338

Screens 61

A Screen can be defined as a window for the monitoring of a process. Eachapplication can have an unlimited number of Screens.

You can create a new Screen by pressing the New Screen button in the Toolbar or by using the New command in the Screen menu. In this new Screen, you can defineScreen Objects, a background drawing, and other specific characteristics.

For a better visualization of the system you are monitoring, some background bitmaps can be defined for Screens. A bitmap of Windows is a graphic file withBMP extension that can be created in several Windows applications that are specificfor drawing, as for example, Paintbrush. You can create your drawings (bitmaps)with any size and colors; the Elipse SCADA will automatically import them without

needing any conversion process.

In order to view or edit the properties of current Screen, double click an empty spacein the Screen or use the Properties command of the Screen menu. When the Screensoption is selected in the Organizer tree, the following window appears, containing alist of all Screens of your application. You can create a new Screen by using the

New button at the right of the page, or remove an existing Screen by selecting it inthe list and pressing the delete button.

Chapter

5. Screens


62/338

User Manual

62 Screens

Picture 34: Screen Window

Screen Options

OPTIONS DESCRIPTION

List Shows a list of all Screens existing in your application. Thesame Screens appear in the Organizer tree right below the

Screens option, and when selected, their respective propertiesare shown.

New Creates a new screen.

Delete Erases the selected Screen from the List.

Go to Closes the Organizer and shows current Screen.

Show Shows current Screen without selecting it.

Hide Hides current Screen, but keeps it in the application.


63/338

User Manual

Screens 63

5.1. General Properties of Screen

Each screen you create for the application appears below the Screens option in the

application tree in Organizer. When selecting a specific cell, its properties are shownon the right side of the tree.

The page of general properties of screens appears when the General tab is selectedon top of the screen pages. This page is shown below, and its respective fields aredescribed in the following table.

Picture 35: Properties of screens


64/338

User Manual

64 Screens

Properties of screens

OPTIONS DESCRIPTION

Name Defines a name for current screen. By using this name, you canopen the screen from any part of the application by using buttons

or function keys, as well as associate it to scripts.

Title Defines a title for the screen, also used as its description.

Color Defines the background color for current screen. This parameteris used when there is no bitmap selected, or when the bitmap

doesn't fill the whole screen.

Bitmap Enables or disables the use of a bitmap as background forcurrent screen.

Browse... Allows for navigating the structure of directories in order to findthe BMP files to be used as background for the screen. The path

and name of the bitmap appear below.

Access level Defines the access level for the screen.

5.2. Style Properties of Screen

The page of screen style properties appears when the Style tab is selected on top ofthe screen properties. This page is shown below, and its respective fields are

described in the following table.

Picture 36: Style Properties of Screen


65/338

User Manual

Screens 65

Style Properties of Screen

OPTIONS DESCRIPTION

Full Screen Determines that the Screen occupies the whole applicationwindow.

Windowed Determines that the Screen appears within a windowwithout occupying the whole Screen of the application as

specified in the Size and Position options.

Width Defines the width of the Screen in pixels.

Height Defines the height of the Screen in pixels.

X Determines the X coordinate for the top left corner of theScreen in pixels. For example, if you are using a resolutionof 640x480 (VGA) in Windows, your X coordinate can

vary from 0 (zero) to 640 pixels for a window without scroll

bar.

Y Determines the Y coordinate for the top left corner of theScreen in pixels. For example, if you are using a resolutionof 640x480 (VGA) in Windows, your Y coordinate can

vary from 0 (zero) to 480 pixels for a window without scroll bar.

Scroll-Bars Never: determines that the window has no scroll bars, evenwhen necessary. Automatic: scroll bars will automatically

appear when necessary.

Don’t show objectsfocus

Doesn't show the focus of screen objects in running time.

Show BorderShows a border of one pixel of width surrounding the

screen. Only for windowed screens with a fixed size.

ResizeableAllows the re-dimensioning of the window in running time.

Movable Allows the window to be moved in running time.

Title bar Shows or hides the Title Bar.

Initial Screen Makes the Screen to be visible in running time.

Modal Valid only for windowed Screens. Defines the window asmodal, i.e.., it should be closed so that the focus can pass to

other open windows.

Popup Valid only for windowed Screens. Defines the window as popup; this means that it is automatically closed when

loosing the focus.

Clip Children Defines the use of clipping for redrawing screen objects inrelation to the background, then optimizing the redrawing.

This option should be enabled only if the screen objects arenot overlapped and will not move; otherwise, the desired

effect may not occur.

Close Button Enables the close button in the window (button of top rightcorner). This button can only be seen in running time.


66/338

User Manual

66 Screens

5.3. Screen Scripts

Screen scripts are generally associated to an action that is executed on screen. This

means, for example, that they can be executed when opening or closing the screen,or even when a key is pressed while the screen is monitored. Scripts available forscreens are described in the table below.

SCRIPTS AVAILABLE

You can associate scripts to screens and execute them in one of the following

situations:

EVENTS DESCRIPTION

OnHide Executed after a screen has been closed.

OnKeyPress Executed when the key that is specified in the New

key button is pressed.

OnKeyRelease Executed when the key that is specified in the Newkey button is released.

OnKillFocusExecuted when the screen loses focus of keyboard or

mouse

OnPreHide Executed before the screen is closed. Call theShow() function in this script to maintain the screen open.

OnPreShow Executed before the screen is shown. Call the Hide() function in this script to cancel the opening of the

screen.

OnSetFocusExecuted when the screen gains focus of keyboard ormouse

OnShow Executed when the screen is shown.

WhileKeyPressed Executed while the key that is specified in the Newkey button is pressed.

WhileRunning Executed while the screen is active.


67/338

Screen Objects 67

When the programmer is developing your application, many times he/she needs toshow some result, make an alert, or receive information and actions from the user.

This interaction with the user happens through what we call interface. For the programmer to be able to build up the interface of your application, Elipse SCADA

offers a series of features called “Screen Objects”.

Screen objects are graphic elements and representations of real objects in the processthat help the user to interact and follow up the application being executed in ElipseSCADA.

In this chapter, we will see the screen objects available in Elipse SCADA, theirmeaning, usefulness, and operation. For a better comprehension, we have organized

the screen objects in two categories: visualization and interaction objects.

6.1. Editing of Screen Objects

Screen objects can be created from the Objects toolbar, already described in a

previous section, or through the Objects menu. Once the object you want to create isselected, keep the left mouse as pressed in the screen area while you movement themouse (a doted rectangle shows the size and form of the object). When releasing the button, the object will be positioned within the specified area.

The edition of objects on screen, like alignment, size, position, and grouping is donethrough the Arrange toolbar already described or through the menu. The last objectto be selected stays with a red focus to be used as reference. To deselect an object,use the combination of keys: [Shift]+[Ctrl]+[LeftMouse].

6.2. Properties of Screen Objects

In general, screen objects have several common properties that are grouped in the pages next described.

Chapter

6. Screen Objects


68/338

68 Screen Objects

6.2.1. Size and Pos Page

Picture 37: Properties of Size and Position


69/338

User Manual

Screen Objects 69

Properties of Size and Position

OPTIONS DESCRIPTION

X Defines the X coordinate for the top left corner of theobject in pixels. It is used together with the Y attributeto define the position of the object from the origin ofscreen (0,0).

Y Defines the Y coordinate for the top left corner of theobject in pixels. It is used together with the X attributeto define the position of the object from the origin ofscreen (0,0).

Width Determines the width of the object in pixels. It is usedtogether with the height attribute to define the size ofthe object.

Height Determines the height of the object in pixels. It is

used together with the width attribute to define thesize of the object.

Unmoveable during

development

Determines that the object cannot be moved during

configuration (blocks the changing of position for theobject).

Visible on applicationstartup

Defines that the object will be visible when the

application starts.

Enabled (receive mouseand keyboard input)

Enables the access for the keyboard and mouse to theobject (valid only for objects that allow inputs via

mouse or keyboard. Example: slider).

Show tips during run-time Enables the object to show a tip when the mouse isover it.

Access level Allows the association of an access level for theobject (0 for free access).


70/338

70 Screen Objects

6.2.2. Frame Page

Picture 38: Frame Properties


71/338

User Manual

Screen Objects 71

Frame Properties

OPTIONS DESCRIPTION

Visible Enables or disables a frame around the object.

Color Defines the color of the frame for the object.Title Enables or disables a title in the object frame.

Text Defines the text of the title.

Font Defines font, color, and size of Title font.

Text Line separator Enables or disables a separator row between text andobject.

Border Enables or disables a border to the frame.

Thickness Defines the thickness of the frame in pixels.

Color Defines the color of the frame border.

3D effect Selects a 3D effect inside or outside the object frame.

Thickness Defines the thickness in pixels for the 3D effect.

6.2.3. Tags Page

Picture 39: Tags Page


72/338

72 Screen Objects

Properties of the Tags Page

OPTIONS DESCRIPTION

Objects Shows the application tree. Depending on the object selected,its property will appear in the window of Properties.

Properties Allows the selection of any property of the object selected inthe tree.

Tags Selected Lists the Tags that are associated to the object.

Add Adds up the marked Tags to the list of selected Tags.

Remove Removes the selected Tags from the list.

6.3. Scripts of Screen Objects

There are some scripts available for all screen objects; these scripts are described inthe table below. Scripts that are specific for an object are further described in therespective section of the object. For more details regarding the use of scripts, see thespecific chapter.

Picture 40: Window of script edition


73/338

User Manual

Screen Objects 73

SCRIPTS AVAILABLE

You can associate scripts in any screen object for these events:

EVENTS DESCRIPTION

OnKillFocus Executed when the object loses focus of keyboard or mouseOnLButtonDblClk Executed when the left mouse is pressed twice over the

object.

OnLButtonDown Executed when the left mouse is pressed over the object.

OnLButtonUp Executed when the left mouse is released over the object.

OnMouseMove Executed when the mouse is moved over the object.

OnRButtonDblClk Executed when the right mouse is pressed twice over theobject.

OnRButtonDown Executed when the right mouse is pressed over the object.

OnRButtonUp Executed when the right mouse is released over the object.

OnSetFocus Executed when the object receives the focus of keyboard ormouse

6.4. Cross-Reference

The Cross-Reference page lists all links for current object, and its properties, i.e.,

which other objects refer to it and what properties or values are being used. If you

want to go to the selected item just double-click it. The Box of Show children

items allows to view in the list, the “children” items associated to the “father” items

listed.

Picture 41: Cross-Reference


74/338


75/338

User Manual

Screen Objects 75

Text Zones

Picture 44: Window of edition of zones


76/338

76 Screen Objects

Properties of Text Zones

OPTIONS DESCRIPTION

Zones Lists all Zones defined, and allows their edition.

Add Adds up a new Zone to the list.

Delete Removes the selected Zone from the list.

Autorange Automatically adjusts the interval of Zones.

Message Text associated to a selected zone. This message will beshown when the value of the Tag associated to the Text objectis within the zone.

Alignment Defines the alignment of characters for the Text object.

Transparent Defines that the background of the object will be transparent.

Default zone Defines the selected Zone as standard (default ), i.e., a zonecontaining all values not defined in other zones.

Blinking Enables the Blinking for the zone. Once activated and definedas “Blinker”, the zone alternates with the default zone, inaccordance with the time set inBlinking every.

Blinking every Defines the interval for Blinking between Blinking and defaultzones.

Tip Allows the configuration of a tip for each zone. If the zonedoesn't have a tip, the system uses the description of theobject.

Minimum Defines a minimum value for the selected Zone.

Maximum Defines a maximum value for the selected Zone.

Background Defines the background color of the Text

Font Defines font, color, and size for the text of the message.

6.5.2. Display

The Display object is used to show tag values in real time.

The properties of display allow the definition of the size, color, font, alignment, 3Deffects, and other characteristics. You can edit the display properties by double-

clicking it.

Picture 45: Display


77/338


78/338


79/338

User Manual

Screen Objects 79

6.5.3. Browser

The Browser object allows viewing your database files. These files should be inElipse SCADA format, i.e., should have been created by Elipse. In order to browse

these files, you should look for .DAT (Historic or Alarms) or .HDR (Batch)extensions. You can edit the browser properties by double-clicking it.

Picture 48: Browser

General Properties of Browser

Picture 49: General Properties of Browser


80/338

80 Screen Objects

Properties of the Browser object

OPTIONS DESCRIPTION

Name Defines the name of the Browser that will be used inthe Organizer tree and in the scripts.

Description A brief description of the Browser.Font Defines the font, color and size of the text to be

shown in the Browser.

Order Defines the order (ascending or descending) ofBrowser records.

Title Background Defines the background color for the Browser title.

Title Text Defines the text color for the Browser title.

Row Background Defines the background color of Browser text rows.

Row Text Defines the Browser rows text color.

Selection Background Defines the background color for the selected rows ofBrowser.

Selection Text Defines the text color for the selected rows ofBrowser.

Grid Defines the color of the Browser grid.

Background Defines the color of the Browser external area.

Settings of Browser

Picture 50: Properties of Browser


81/338

User Manual

Screen Objects 81

Setting of Browser

OPTIONS DESCRIPTION

Source Filename Defines the name of the file to be shown in theBrowser object. This file should have DAT or HDR

extension.

Browse Allows the localization of the font file to be used bythe Browser.

All Batches Selects all batches to be printed. This option isavailable only if the font file (Source Filename) is aHistoric file with batch process enabled.

Last batches Selects the last batch to be printed. This option isavailable only if the font file (Source Filename) is aHistoric file with batch process enabled.

Specific BatchSelects a specific batch to be printed, according to the

specification of the Field and Criteria fields. Thisoption is available only if the font file (Source

Filename) is a Historic file with batch process

enabled.

Field Lists the fields available for the selection of a specific batch. Only string type fields will be listed.

Criteria Defines the value to be searched when a specific batch is selected.


82/338

82 Screen Objects

Browser Query

Picture 51: Settings of query for the Browser


83/338

User Manual

Screen Objects 83

Settings of query for the Browser

OPTIONS DESCRIPTION

No query date A filter will not be used, i.e., all data is selected.

Time range Select data base data between two times.Newest data Only selects newer data.

Initial Date Determines the initial date of the time interval.

Final Date Determines the final date of the time interval.

Initial Time Determines the initial time of the time interval.

Final Time Determines the final time of the time interval.

Last Defines the number of units for selecting most recent data.

Unit Defines the unit used for selecting most recent data.

Browser Database

Picture 52: Database Properties


84/338

84 Screen Objects

Database Properties

OPTIONS DESCRIPTION

Fields Lists available fields.

Move Up Moves the selected field one position up.

Move Down Moves the selected field one position down.

Enable Allows the selected field to be printed.

Reload file structure Reloads the current list of fields of the file in the browser fields. When some modification is done tothe structure of the file used by the browser, this

button should be pressed for updating fields.

Size Defines the number of digits to be shown, includingthe decimal point.

Precision Defines how many digits of size will be decimal.

Prefix Adds up a prefix of string type to the value shown.

Suffix Adds up a suffix of string type to the value shown.

Date format Defines the format of the time marking (timestamp)of browser.

Label Allows the changing of the name of the selected field.

Lines Defines the number of lines the selected field willhave in the browser.

Browser Scripts

The events available for exclusive Scripts of the Browser are described in the table below. For more details regarding the use of scripts, see the specific chapter.

SCRIPTS AVAILABLE

You can associate Scripts to the Browser and execute them in one of the following

situations:

EVENTS DESCRIPTION

OnDrawRow Executed right before each Browser row is drawn. It allowsthe modification of the background color and the row text

through the functions SetTempRowColor() and

SetTempRowTextColor(), depending on the value of therow fields (this value can be taken with functionGetField()).


85/338

User Manual

Screen Objects 85

6.5.4. Bitmap

The Bitmap object allows the insertion of images, figures or drawings in the screens

of your application, as long as they are in BMP, GIF or JPEG format. This object can be re-dimensioned to have the same size of the picture, and has support totransparence, being enough just to enable and select a color. You can edit the

Bitmap properties by double-clicking it.

Picture 53: Bitmap

Note: In Elipse SCADA CE, only .BMP is currently avaliable.

General Properties of Bitmap

Picture 54: General Properties of Bitmap


86/338

86 Screen Objects

General Properties of Bitmap

OPTIONS DESCRIPTION

Name Defines the name of the Bitmap that will be used inthe Organizer tree and in the scripts.

Description A brief description of the Bitmap.Bitmap Name Defines the name of the corresponding file.

Browse... Allows the indication of the localization of the file to be used.

Transparent Determines that the color specified in the Backgroundis transparent.

Background Defines the background color of the Bitmap

Fit to Image Adjusts the Bitmap object so that it has the same sizeof the original picture.

6.5.5. Animation

The Animation object is an easy way of creating an animation by using images(bitmaps) associated to frames defined by the user, which are shown in sequence. ATag should be associated to the animation, so that the Tag value determines whatanimation frame will be shown. The Tag values are associated to Zones, which

correspond to a given frame.

It is possible to use images of any size and color, as long as they are files in the

supported formats: GIF, JPEG and Bitmap (.BMP). You can edit the Animation properties by double-clicking it.

Picture 55: Animation

Note: In Elipse SCADA CE, only .BMP is currently avaliable.


87/338

User Manual

Screen Objects 87

General Properties of Animation

Picture 56: General Properties of Animation

General Properties of AnimationOPTIONS DESCRIPTION

Name Defines the animation name.

Description A brief description of the object.

Transparent Defines that the color specified in the Backgroundoption will be transparent, allowing the background

of the screen to be shown.

Border Enables a border (black row) around frames.

Background Defines a background color for the animation.

Blinking every Interval in milliseconds for the Blinking between theBlinking and Default Zones.

Fit to Image Adjusts the animation object so that it has the samesize of the first frame of the animation.


88/338

88 Screen Objects

Animation Zones

Picture 57: Definition of Animation Zones


89/338

User Manual

Screen Objects 89

Properties of Animation Zones

OPTIONS DESCRIPTION

Bitmap Lists the bitmaps of animation frames. Select one bitmap tosee and edit its properties.

Location Shows the bitmaps path.

Add Used to add a bitmap or a group of bitmaps to the list.

Delete Removes a bitmap or a group of bitmaps from the list.

Autorange... Automatically adjusts the zones, by equally dividing thetotal of the interval between defined zones.

Change Location Used to change the localization ( path) of the bitmap.

Default Zone Defines the frame selected in the list as standard; therefore,it will be shown when the tag value is outside other defined

zones.

Minimum Defines a minimum value for the selected Zone.

Maximum Defines a maximum value for the selected Zone.

Blinking Indicates that the Blinker will use this zone.

Tip Allows the configuration of a tip for each zone. If the zonedoesn't have an enabled tip, the system uses the description

of the object.

Preview Shows a forecast of the selected frame.

6.5.6. AVI

The AVI object is used for visualizing files with AVI extension in the system.

Through this object, it is possible to Browse the AVI file in the system, and show iton screen when the project runs. This object only accepts AVI files.

Picture 58: AVI


90/338

90 Screen Objects

General Properties of AVI

Picture 59: General Properties of AVI

General Properties of AVI

OPTIONS DESCRIPTION

Name Defines the name of the object in the system.

Description A brief description of the video.

AVI file Shows the path of the AVI file in the system.

Browse... Allows navigation in directories in order to Browse theAVI file.

6.5.7. Video

The Video object is used for visualizing a video image. Through this option, it is possible to view system files, or those created by the Watcher option.

Picture 60: Video


91/338

User Manual

Screen Objects 91

General Properties of Video

Picture 61: General Properties of Video

General Properties of Video

OPTIONS DESCRIPTION


Description A brief description of the video.

Video Source Determines the font video will use for thevisualization of the object

AutoPlay (play video whenthe screen is opened)

Enables the visualization of the video when the object

is executed

Stretch Video to fitwindow size

Enables the adjustment of the video according to theobject size.


92/338

92 Screen Objects

6.5.8. Preview

The Preview object is used for the video display files generated through theXPressPlayer board. Through this object, it is possible to configure it in theXPressPlayer board to be connected to a given camera, or to indicate theXPressPlayer file. The visualization of the object will be shown during the execution

of the project.

Picture 62: Preview

General Properties of Preview

Picture 63: General Properties of Preview


93/338

User Manual

Screen Objects 93

General Properties of Preview

OPTIONS DESCRIPTION


Description A brief description of the video.XPressPlus Board Indicates the object of XPressPlus of Watcher to be

associated to the Preview object.

Camera number Indicates the number of the camera that is connectedto the object.

Window Size Indicates the size of the window for the visualizationof the object.

Camera Number Shows the path of the video file in the system.

Auto size Automatically adjusts the visualization window

according to the specifications of the Window Size

option.

Enable Large Preview Enables the visualization in "full screen".

6.5.9. Trend

This object is used to view a trend graphic with up to 16 tags. The graphic isconstantly refreshed as the process evolves and tag values change.

By using trends, you can make graphs like Value x Time and Value x Value. Due tothese characteristics, it is possible to make the analysis of data as the process

evolves.

The trend object has various aspects that can be modified through various pages of properties, which will be next seen.

Picture 64: Trend


94/338

94 Screen Objects

General Properties of Trend

Picture 65: Trend Properties


95/338

User Manual

Screen Objects 95

Trend Properties

OPTIONS DESCRIPTION

Name Defines the name for the identification of the trendobject.

Description A brief description of the trend.

XY Enables a graph in real time as a function of twovariables, each one in an axle of coordinates. The

variables can be grouped in pairs, so that an object

can show various XY functions.

Time x Data Defines a data graph as a function of time.

Show labels Shows a legend with meaning for each pen of trend.

New data appears on the: Defines from where new data of trend will come.

Time Span Defines the total interval of time for the sampling of

the graph (in seconds). This option is disabled if thetrend is historic.

Refresh Trend every Defines the interval of time between each graphupdating. This option is disabled if the trend is

historic.

Buffer Size Defines the number of points (from 1 to 1.000.000)the trend will store for each pen (each point occupies

20 bytes). This option is disabled if the trend is

historic.

Add Mark Adds up a horizontal or vertical row, or a point for

reference to the trend graph.


96/338

96 Screen Objects

Advanced Properties of Trends

Picture 66: Advanced Properties of Trends

Advanced Properties of Trends

OPTIONS DESCRIPTION

Real time, only when the trend

is on screen

Refreshes the values of the trend in real time

only if the trend is visible.

Real time, data collect data inbackground

Refreshes the values of the trend in real timeeven when the trend is not visible.

Load historic data from disk Refreshes the trend by loading data from aselected Historic.

Configure Query… Opens up a window that allows theconfiguration of the Historic trend Query.


97/338

User Manual

Screen Objects 97

Properties of the trend Graph


98/338

98 Screen Objects

Properties for Axis X and Y

OPTIONS DESCRIPTION

(Scale) The first combo box indicates the scale type to beused in the axis, as follows: normal scale, logarithmicscale, or power-factor scale.

Limit Defines the left limit of the X axle in the graph. Thisoption is available only if the graph is of XY type.

Right limit Defines the right limit of the X axle in the graph. Thisoption is available only if the graph is of XY type.

Show top ruler Shows a ruler on top of the graph, with values from Xaxle.

Show bottom ruler Shows a ruler on the base of the graph, with valuesfrom X axle.

High Limit Defines the top limit of the Y axle in the graph.

Low Limit Defines the bottom limit of the Y axle in the graph.

Show left ruler Shows a ruler on the left side of the graph, withvalues from Y axle.

Show right ruler Shows a ruler on the right side of the graph, withvalues from Y axle.

Scrolling Grid Makes the graph grid to accompany the movementgenerated by the input of data in the trend.

Text Allows the placement of a legend for axis X and Y.

Date/Time Format Allows the definition of the data and hour format forTendencies of Value x Time type.

Properties of Graph Colors

OPTIONS DESCRIPTION

Ruler background Defines the background color for the graph rulers.

Ruler text Defines the color for the text that will be shown inrulers.

Chart background Defines the background color for the graph.

Grids and Axis Defines the color of the grid and of the graph axis.

Properties of the Graph Grid

OPTIONS DESCRIPTION

Grid Enables the grid in the graph (orientation rows).

X Rows Defines the number of horizontal rows of the grid

Y Rows Defines the number of vertical rows of the grid

Ruler font… Defines font, size, and color for the graph characters.


99/338

User Manual

Screen Objects 99

Colors of Trend Pens

Picture 67: Color of Trend Pens

Availables Options

OPTIONS DESCRIPTION

Inserts a pen associated to a tag.

Inserts a p

Documents

Scadamanual Us