Você está na página 1de 361

ELIPSESCADA

HMI/SCADA SOFTWARE

MANUAL DO
USURIO

2015 Elipse Software Ltda. Todos os direitos reservados


7/1/2015 - Verso 2.29

ndice
1.

INTRODUO ............................................................................................................................................................. 9
1.1.
1.2.

PACOTES DO ELIPSE SCADA .................................................................................................................................. 9


MDULOS DE OPERAO ...................................................................................................................................... 11

1.3.

PLUG-INS

2.

.................................................................................................................................................... 11

O QUE H NA TELA ................................................................................................................................................. 13


2.1.

OPES DE MENU ................................................................................................................................................ 14


2.1.1.
Menu Arquivo ........................................................................................................................................ 14
2.1.2.
Menu Tela ............................................................................................................................................. 15
2.1.3.
Menu Objetos ........................................................................................................................................ 16
2.1.4.
Menu Arranjar ....................................................................................................................................... 18
2.1.5.
Menu Visualizar ..................................................................................................................................... 19
2.1.6.
Menu Ajuda ........................................................................................................................................... 19
2.2.
BARRA DE FERRAMENTAS ..................................................................................................................................... 20
2.2.1.
Barra de Ferramentas Aplicao ........................................................................................................... 20
2.2.2.
Barra de Ferramentas Objetos .............................................................................................................. 21
2.2.3.
Barra de Ferramentas Arranjar ............................................................................................................. 22
2.2.4.
Barra de Ferramentas Telas ................................................................................................................. 23
2.3.
TECLAS DE ATALHO .............................................................................................................................................. 23
2.4.
OPES DE LINHA DE COMANDO........................................................................................................................... 24
3.

ORGANIZER .............................................................................................................................................................. 25
3.1.
3.2.

3.3.
4.

APP BROWSER ..................................................................................................................................................... 29


CRIANDO A SUA APLICAO .................................................................................................................................. 30
3.2.1.
Propriedades Gerais da Aplicao ........................................................................................................ 31
3.2.2.
Janela de Aplicao .............................................................................................................................. 33
3.2.3.
Touch Screen ........................................................................................................................................ 34
3.2.4.
Elipse Web
.................................................................................................................................. 36
SCRIPTS ............................................................................................................................................................... 37
TAGS.......................................................................................................................................................................... 39

4.1.
4.2.
4.3.
4.4.

GRUPO DE TAGS ................................................................................................................................................... 40


NOVO TAG ............................................................................................................................................................ 41
TAG CRONO.......................................................................................................................................................... 42
TAG PLC .............................................................................................................................................................. 43

4.5.
4.6.
4.7.
4.8.

TAG DDE
.................................................................................................................................................... 45
TAG DEMO ............................................................................................................................................................ 48
TAG EXPRESSO .................................................................................................................................................. 50
TAG BLOCO .......................................................................................................................................................... 51
4.8.1.
Elemento de Bloco ................................................................................................................................ 53
4.9.
TAG RAM ............................................................................................................................................................. 55
4.10.
TAG MATRIZ .................................................................................................................................................. 55
4.11.
TAG BIT ......................................................................................................................................................... 57
4.12.
PGINA DE ALARMES ..................................................................................................................................... 58
4.13.
SCRIPTS DE TAGS.......................................................................................................................................... 61
5.

TELAS ........................................................................................................................................................................ 63
5.1.
5.2.
5.3.

6.

PROPRIEDADES GERAIS DA TELA .......................................................................................................................... 65


PROPRIEDADES DE ESTILO DE TELAS .................................................................................................................... 66
SCRIPTS DE TELA ................................................................................................................................................. 68
OBJETOS DE TELA .................................................................................................................................................. 69

6.1.
6.2.

EDIO DOS OBJETOS DE TELA............................................................................................................................. 69


PROPRIEDADES DOS OBJETOS DE TELA ................................................................................................................ 70
6.2.1.
Pgina Tamanho e Pos ......................................................................................................................... 70
6.2.2.
Pgina Moldura ..................................................................................................................................... 72
6.2.3.
Pgina de Tags ..................................................................................................................................... 73

6.3.
6.4.
6.5.

SCRIPTS DE OBJETOS DE TELA ............................................................................................................................. 74


REFERNCIA CRUZADA ......................................................................................................................................... 75
OBJETOS DE VISUALIZAO .................................................................................................................................. 75
6.5.1.
Texto ..................................................................................................................................................... 75
6.5.2.
Display .................................................................................................................................................. 78
6.5.3.
Browser ................................................................................................................................................. 81
6.5.4.
Bitmap ................................................................................................................................................... 87
6.5.5.
Animao .............................................................................................................................................. 88
6.5.6.

AVI

6.5.7.

Video

............................................................................................................................................... 92
........................................................................................................................................... 93

6.5.8.
Preview
........................................................................................................................................ 94
6.5.9.
Tendncia ............................................................................................................................................. 95
6.5.10.
Grfico de Barras ................................................................................................................................ 102
6.5.11.
Gauge ................................................................................................................................................. 107
6.6.
OBJETOS DE INTERAO..................................................................................................................................... 109
6.6.1.
Slider ................................................................................................................................................... 109
6.6.2.
Boto................................................................................................................................................... 111
6.6.3.
Setpoint ............................................................................................................................................... 115
6.6.4.
Alarmes ............................................................................................................................................... 119
7.

ALARMES ................................................................................................................................................................ 127


7.1.
7.2.

8.

PROPRIEDADES GERAIS DOS ALARMES ............................................................................................................... 127


SCRIPTS DOS ALARMES ...................................................................................................................................... 128
RECEITAS ............................................................................................................................................................... 129

8.1.
8.2.
9.

PROPRIEDADES GERAIS DA RECEITA................................................................................................................... 129


EDITANDO RECEITAS .......................................................................................................................................... 131
HISTRICOS ........................................................................................................................................................... 133

9.1.

PROPRIEDADES GERAIS DOS HISTRICOS........................................................................................................... 133

9.2.

ANLISE HISTRICA

9.3.
10.

11.

.................................................................................................................................. 134

CONTROLE ESTATSTICO DE PROCESSOS

.................................................................................................. 143

RELATRIOS .......................................................................................................................................................... 157


10.1.
10.2.
10.3.
10.4.
10.5.
10.6.
10.7.
10.8.
10.9.

PROPRIEDADES GERAIS............................................................................................................................... 159


CONFIGURAES ........................................................................................................................................ 160
CONSULTA .................................................................................................................................................. 162
BANCO DE DADOS ....................................................................................................................................... 163
BATELADA ................................................................................................................................................... 165
GRFICO ..................................................................................................................................................... 167
PENAS......................................................................................................................................................... 169
SCRIPTS ...................................................................................................................................................... 170
RELATRIO FORMATADO ............................................................................................................................. 171

10.10.

RELATRIO ANLISE HISTRICA

......................................................................................................... 171

DRIVERS.................................................................................................................................................................. 173
11.1.
CONFIGURANDO DRIVERS ............................................................................................................................ 174
11.1.1.
Drivers PLC ......................................................................................................................................... 174
11.1.2.
Drivers de Rede .................................................................................................................................. 179
11.2.
SCRIPTS DE DRIVERS .................................................................................................................................. 181
11.3.
LISTA DE TAGS ASSOCIADOS ....................................................................................................................... 181

12.
13.

DATABASE.............................................................................................................................................................. 183
USURIOS............................................................................................................................................................... 189
13.1.
13.2.

14.

FUNES E ATRIBUTOS ............................................................................................................................... 191


SCRIPTS DE LOGIN ...................................................................................................................................... 191

APLICAES REMOTAS ....................................................................................................................................... 193

14.1.
14.2.
15.
16.

ELIPSE WEB............................................................................................................................................................ 199


WATCHER ............................................................................................................................................................... 201
16.1.

17.

18.

OBJETOS DO W ATCHER ............................................................................................................................... 202

STEEPLECHASE ..................................................................................................................................................... 215

OPC SERVER
18.1.
18.2.
18.3.
18.4.

19.

PROPRIEDADES GERAIS............................................................................................................................... 195


SCRIPTS DE APLICAES REMOTAS ............................................................................................................. 197

.............................................................................................................................................. 217

PROPRIEDADES GERAIS DO OPC SERVER ................................................................................................... 218


TAGS OPC .................................................................................................................................................. 220
GRUPO OPC ............................................................................................................................................... 224
QUALIDADE.................................................................................................................................................. 225

SCRIPTS .................................................................................................................................................................. 227


19.1.
19.2.
19.3.
19.4.
19.4.1.
19.4.2.
19.4.3.
19.4.4.
19.4.5.
19.5.
19.5.1.
19.5.2.
19.5.3.
19.5.4.
19.5.5.
19.5.6.
19.5.7.
19.5.8.

CONSIDERAES GERAIS ............................................................................................................................ 227


APPBROWSER E REFERNCIA CRUZADA ...................................................................................................... 229
OPERADORES E CONSTANTES ..................................................................................................................... 230
CONTROLE DE FLUXO .................................................................................................................................. 231
Comando If...Else...ElseIf...EndIf ........................................................................................................ 231
Comando For...Next ............................................................................................................................ 232
Comando While...Wend ...................................................................................................................... 232
Comando Repeat...Until ...................................................................................................................... 233
Comando Return ................................................................................................................................. 233
FUNES ESPECIAIS ................................................................................................................................... 233
Funes do Gerenciador Global ......................................................................................................... 234
Funes da Aplicao ......................................................................................................................... 260
Funes de Tags................................................................................................................................. 263
Funes de Tela.................................................................................................................................. 267
Funes dos Objetos de Tela ............................................................................................................. 268
Funes de Alarmes ........................................................................................................................... 275
Funes das Receitas ......................................................................................................................... 279
Funes de Histricos ......................................................................................................................... 281

19.5.9.

Funes da Anlise Histrica

.................................................................................................... 284

19.5.10.
19.5.11.
19.5.12.
19.5.13.
19.5.14.

Funes do CEP
........................................................................................................................ 284
Funes de Relatrios ........................................................................................................................ 284
Funes de Consultas......................................................................................................................... 286
Funes da Plotagem ......................................................................................................................... 287
Funes de Drivers ............................................................................................................................. 288

19.5.15.
19.5.16.

Funes de Database
................................................................................................................ 291
Funes de Aplicaes Remotas ........................................................................................................ 298

19.5.17.
Funes do OPCServer
............................................................................................................. 299
19.6.
ATRIBUTOS .................................................................................................................................................. 300
19.6.1.
Atributos do Gerenciador Global ......................................................................................................... 300
19.6.2.
Atributos da Aplicao......................................................................................................................... 301
19.6.3.
Atributos de Tags ................................................................................................................................ 305
19.6.4.
Atributos da Tela ................................................................................................................................. 311
19.6.5.
Atributos dos Objetos de Tela ............................................................................................................. 314
19.6.6.
Atributos da Plotagem ......................................................................................................................... 337
19.6.7.
Atributos de Alarmes ........................................................................................................................... 341
19.6.8.
Atributos das Receitas ........................................................................................................................ 342
19.6.9.
Atributos dos Histricos ....................................................................................................................... 342
19.6.10.
19.6.11.

Atributos da Anlise Histrica


.................................................................................................... 343
Atributos da Consulta .......................................................................................................................... 344

19.6.12.
19.6.13.
19.6.14.
19.6.15.

Atributos do CEP (SPC)


............................................................................................................ 346
Atributos da Batelada .......................................................................................................................... 347
Atributos dos Relatrios ...................................................................................................................... 347
Atributos dos Drivers ........................................................................................................................... 348

20.

19.6.16.
19.6.17.
19.6.18.

Atributos do Banco de Dados


.................................................................................................... 349
Atributos da Lista de Usurios ............................................................................................................ 350
Atributos da Aplicao Remota ........................................................................................................... 350

19.6.19.

Atributos do Watcher

19.6.20.

Atributos do Steeplechase

19.6.21.

Atributos do OPCServer

................................................................................................................. 354
......................................................................................................... 356
............................................................................................................ 357

SUPORTE A DDE .................................................................................................................................................... 359


20.1.
20.2.

ELIPSE SCADA COMO CLIENTE ................................................................................................................... 359


ELIPSE SCADA COMO SERVIDOR ................................................................................................................ 361

Convenes
Estas so convenes utilizadas neste manual:

EXEMPLO
SILO6.BMP

DESCRIO
Nomes de arquivos e outros termos no nvel do
sistema operacional so indicados com o tipo de letra
Tahoma, em maisculas.

Geral

Nomes de campos e opes que devem ser


procurados na tela, em menus ou nas abas dos objetos
so indicados com tipo de letra Tahoma.

Agitao

Caracteres entre aspas devem ser digitados no lugar


mencionado, sem a presena das aspas.

Tela1.Show()

Partes de programas (scripts) so indicadas com o


tipo de letra Courier. Eles devero ser digitados
nos lugares reservados e depois compilados para a
verificao de erros.

Tank01.High

Caracteres em negrito indicam nomes de objetos do


Elipse SCADA ou suas propriedades.

<nome do arquivo>

Expresses entre os sinais < > devem ser substitudas


pelo nome do objeto em questo.

[Ctrl+Enter]

Expresses entre colchetes indicam nomes de teclas.


Quando estiverem acompanhadas de um sinal +, voc
deve pressionar a segunda tecla enquanto pressiona a
primeira.
Este cone sozinho significa que o recurso no est
disponvel para a verso Elipse SCADA CE;
acompanhado de nota, significa que h restries a
sua utilizao.

Captulo

1.

Introduo

Bem-vindo ao Elipse SCADA! A Elipse Software sente-se orgulhosa em apresentar


esta poderosa ferramenta para o desenvolvimento de sistemas de superviso e
controle de processos.
O Elipse SCADA alia alto desempenho e grande versatilidade, representados em
seus diversos recursos que facilitam e agilizam a tarefa de desenvolvimento de sua
aplicao. Totalmente configurvel pelo usurio, permite a monitorao de variveis
em tempo real, atravs de grficos e objetos que esto relacionados com as variveis
fsicas de campo. Tambm possvel fazer acionamentos e enviar ou receber
informaes para equipamentos de aquisio de dados. Alm disto, atravs de sua
exclusiva linguagem de programao, o Elipse Basic, possvel automatizar
diversas tarefas a fim de atender as necessidades especficas de sua empresa.
Agradecemos a sua preferncia por nossos produtos e desejamos sucesso com sua
nova ferramenta de trabalho!
Equipe Elipse Software

1.1. Pacotes do Elipse SCADA


O Elipse SCADA est disponvel em pacotes diferentes, atendendo as demandas de
personalizao de nossos clientes. A seguir, podemos observar as caractersticas de
cada pacote:
Elipse View
O Elipse View indicado para aplicaes simples, como por exemplo uma interface
com o operador para monitorao e acionamentos. Permite a visualizao de
variveis, inclusive com a utilizao de animaes, programao de setpoints,
controle de acesso e funes especiais para touch-screen. Este pacote inclui:
Comunicao com equipamentos via drivers (DLLs) e OPC (Servidor e
Cliente);
Objetos de Tela;
Visualizao de alarmes ativos;
Comunicao em bloco;
Introduo

Manual do Usurio

Scripts;
Servidor e cliente DDE;
Servidor de rede Elipse;
Controle de acesso atravs de lista de usurios.
O pacote no inclui ferramentas para o registro de dados histricos, alarmes ou
relatrios, alm de outras funcionalidades que venham a surgir em pacotes mais
avanados.
Elipse MMI (Man Machine Interface)
um software de superviso completo. Possui banco de dados proprietrio,
relatrios formatados, histricos, receitas, alarmes e Controle Estatstico de
Processos, facilmente implementveis. Pode, ainda, ser um servidor da dados para
outras estaes Elipse. Inclui todos os recursos do pacote View, e mais:
Histricos, receitas e relatrios.
Controle Estatstico de Processos (Mdulo CEP);
Objetos de tela Browser (histricos) e alarmes histricos;
Registro de alarmes em disco.
O Elipse MMI indicado para sistemas de qualquer porte, onde no sejam
necessrias conexes com bancos de dados externos (ODBC e DAO) ou aplicaes
de rede, e quando o usurio precisa enxergar outras estaes de superviso.
Elipse Pro
a mais avanada ferramenta do Elipse SCADA. Permite trocar dados em tempo
real com outras estaes, transferir/atualizar bancos de dados, realizar comandos e
programar setpoints atravs de rede local ou linha discada. Inclui todos os recursos
do pacote MMI, e mais:
ODBC (Open DataBase Connectivity) e DAO (Data Access Objects);
Cliente e servidor de rede Elipse (TCP/IP);
O Elipse Pro a soluo ideal para a comunicao com sistemas corporativos, pois
suporta ODBC, DAO e diversos protocolos de rede. Alm disso, este mdulo
permite a troca de informaes com software dedicado a controle (SoftPLC).
Elipse SCADA CE
Este pacote permite executar aplicaes Elipse SCADA em dispositivos baseados no
sistema operacional Windows CE, como IHMs, dispositivos sem disco em geral e
outros dispositivos mveis. O Elipse SCADA CE no comporta todas as
funcionalidades dos pacotes anteriores; quando for este o caso, ser indicado no
decorrer do manual.
10

Introduo

Manual do Usurio

1.2. Mdulos de Operao


O Elipse SCADA possui trs mdulos para sua operao: Configurador, Runtime
e Master (inclui os mdulos Configurador e Runtime). O mdulo ativo definido a
partir do dispositivo de proteo (hardkey) acoplado ao computador. Enquanto que
os mdulos Configurador e Master foram especialmente desenvolvidos para a
criao e o desenvolvimento de aplicativos, o mdulo Runtime permite apenas a
execuo destes. Neste mdulo, no possvel qualquer alterao no aplicativo por
parte do usurio.
Na ausncia da hardkey, o software pode ser executado em modo Demonstrao,
que pode ser utilizado para avaliao do software. O modo Demo possui quase todos
os recursos existentes no mdulo Configurador, com as seguintes diferenas:
No permite salvar aplicaes com mais de 20 tags;
Permite at cinco (5) conexes simultneas do Elipse Web;
Permite a execuo de uma aplicao e comunicao com equipamentos de
aquisio de dados por at duas horas.
Nesse modo, o software pode ser livremente reproduzido e distribudo.
Os mdulos Runtime e Master esto tambm disponveis em verses Lite que
possuem as mesmas caractersticas, porm so limitadas em nmero de tags
(variveis): Lite 75 com 75 tags, e Lite 300 com 300 tags.
Na verso Windows CE, apenas o modo Runtime est disponvel, em licenas
de 75, 300 ou 1500 tags.

1.3. Plug-Ins
Plug-ins so ferramentas adicionais que permitem a expanso dos recursos do Elipse
SCADA, acrescentando funcionalidades no software. Eles podem ser adquiridos
separadamente e trabalham em conjunto com qualquer verso do software.
Atualmente, esto disponveis os seguintes plug-ins:
Permite a monitorao de sistemas atravs de
recursos de captura, registro e transmisso digital de
imagens em tempo real. Suporta diversos padres
(inclusive MPEG), possibilitando a visualizao em
janelas com tamanho e qualidade programveis pelo
usurio. Permite a criao de um banco de imagens
com busca por perodo ou evento e transmisso de
imagens em tempo real para estaes remotas via
TCP/IP ou linha discada.

Introduo

11

Manual do Usurio

Sistema para superviso de processos atravs da


Internet. Utilizando qualquer navegador (Internet
Explorer, Netscape e outros) possvel conectar-se a
uma estao de superviso remota, recebendo dados
em tempo real. Com este recurso possvel visualizar
processos de qualquer parte do mundo.

12

Introduo

Captulo

2.

O Que H na Tela

Uma maneira fcil de compreender o funcionamento do Elipse SCADA partir das


ferramentas disponveis e sua apresentao em tela.
A ilustrao a seguir mostra a tela principal do Elipse SCADA quando uma
aplicao est aberta, no mdulo Configurador, identificando seus elementos.

A Barra de Ttulo mostra o caminho e o nome de sua aplicao, bem como o ttulo
da tela corrente que est sendo mostrada na rea de trabalho. A rea de trabalho o
espao onde desenvolvemos a aplicao. A edio de telas e de relatrios feita
nessa rea. A Barra de Telas mostra o ttulo da tela corrente e permite que voc
alterne entre uma tela e outra. A Barra de Menus permite a escolha das diversas
opes para a configurao da aplicao. Os botes da Barra de Ferramentas
permitem que voc execute determinadas tarefas rapidamente sem usar os menus.
Assim, com apenas um clique, voc pode criar objetos de tela ou chamar o
Organizer, por exemplo. A Barra de Status mostra vrias informaes auxiliares
quando editando uma aplicao, como por exemplo indicadores da ativao do
teclado numrico (NUM), letras maisculas (CTRL) e rolagem de tela (SCRL) e
coordenadas do ponteiro do mouse. Ela tambm mostra uma pequena descrio de
um determinado objeto, por exemplo um Boto da Barra de Ferramentas ou um item
de menu.
O que h na Tela

13

Manual do Usurio

As aplicaes que rodaro na verso Windows CE precisam ser


necessariamente criadas na verso Windows, modo Configurador.

2.1. Opes de Menu


atravs das opes de menu que podemos acessar os recursos e funes do
software. Descrevemos as opes do Elipse SCADA a seguir.

2.1.1.

Menu Arquivo

Figura 1: Menu Arquivo

14

O que h naTela

Manual do Usurio

Opes do Menu Arquivo

2.1.2.

COMANDO
Nova aplicao

AO
Cria uma nova aplicao.

Abrir aplicao

Abre uma aplicao j existente.

Salvar aplicao

Salva a aplicao corrente.

Salvar aplicao como

Salva uma cpia da aplicao corrente em um novo


arquivo.

Fechar aplicao

Fecha a aplicao corrente.

Rodar

Executa a aplicao corrente.

Organizer

Chama o Organizer.

Opes

Permite configurar algumas opes do Elipse SCADA,


como criar um arquivo de backup (.BAK) quando salvar a
aplicao; configuraes do mecanismo de proteo; e o
nome do arquivo da biblioteca de lngua (o default
INTLBR32.DLL).
Nesta opo, tambm possvel especificar uma
aplicao a ser carregada automaticamente quando o
Elipse SCADA ativado remotamente via OPC.

1, 2, 3 e 4

Lista dos quatro arquivos recentemente abertos

Sair

Encerra o Elipse SCADA.

Menu Tela

Figura 2: Menu Tela

Opes do Menu Tela

O que h na Tela

COMANDO
Nova

AO
Cria uma nova tela (tela em branco).

Deletar

Apaga a tela corrente.

Fechar

Fecha a tela corrente.

Monitorar

Permite monitorar a tela corrente.

Propriedades...

Mostra as propriedades da tela corrente, onde voc pode definir


uma imagem de fundo e o estilo da janela, entre outras
caractersticas.
15

Manual do Usurio

Redesenhar

2.1.3.

Redesenha as telas carregadas.

Menu Objetos

Figura 3: Menu Objetos

16

O que h naTela

Manual do Usurio

Opes do Menu Objetos


COMANDO
Desselecionar

AO
Desseleciona o objeto corrente.

Selecionar tudo

Seleciona todos os objetos da tela.

Recortar

Recorta o objeto selecionado.

Copiar

Copia o objeto selecionado para a rea de


transferncia (clipboard).

Colar

Cola o objeto contido na rea de transferncia no


local indicado.

Deletar

Apaga os objetos selecionados. Para selecionar mais


de um objeto, use a tecla [Ctrl].

Propriedades

Mostra as propriedades do objeto selecionado. A


mesma funo pode ser ativada com um duplo clique
sobre o objeto.

Modo de seleo

Liga o modo de seleo, permitindo que o usurio


selecione todos os objetos dentro de uma rea
delimitada pelo mouse.

As demais opes criam objetos de acordo os respectivos nomes. Depois de escolher


o Objeto de Tela desejado, deve-se selecionar uma regio da tela para colocar o
objeto mantendo-se pressionado o boto esquerdo do mouse enquanto ele
movimentado. Um retngulo pontilhado mostra o tamanho e a forma do objeto.
Soltando-se o boto do mouse, o objeto ser colocado dentro da rea especificada.

O que h na Tela

17

Manual do Usurio

2.1.4.

Menu Arranjar

Figura 4: Menu Arranjar

Opes do Menu Arranjar

18

COMANDO
Agrupar

AO
Agrupa os objetos selecionados.

Desagrupar

Desagrupa o grupo de objetos selecionados.

Levar para o fundo

Envia o objeto selecionado para o ltimo plano


(fundo da tela).

Trazer para frente

Traz o objeto selecionado para o primeiro plano


(frente da tela).

Comandos de alinhamento

Alinha objetos selecionados pela esquerda, pela


direita, pelo topo ou pela base.

Mesmo tamanho

Faz com que os objetos selecionados tenham o


mesmo tamanho.

Centralizar na tela

Centraliza na tela os objetos selecionados.

O que h naTela

Manual do Usurio

2.1.5.

Menu Visualizar

Figura 5: Menu Visualizar

Opes do Menu Visualizar

2.1.6.

COMANDO
Barra de Ferramentas

AO
Mostra ou esconde a Barra de Ferramentas.

Barra de Status

Mostra ou esconde a Barra de Status.

Barra da Tela

Mostra ou esconde a Barra de Telas.

Menu Ajuda

Figura 6: Menu Ajuda

Opes do Menu Ajuda


COMANDO

O que h na Tela

ndice

AO
Mostra o ndice da ajuda.

Usando Ajuda

Explica como a Ajuda deve ser usada.

Sobre o Elipse SCADA...

Mostra informaes a respeito do Elipse SCADA,


como a verso, o nmero do hardkey e direitos de
cpia.

19

Manual do Usurio

2.2. Barra de Ferramentas


A Barra de Ferramentas oferece um acesso rpido s funes do Elipse SCADA.
Essas funes so distribudas em quatro conjuntos, a saber: Aplicao, Objetos de
Tela, Arranjar e Telas. Vejamos cada um deles.

2.2.1.

Barra de Ferramentas Aplicao

Figura 7: Barra de Ferramentas Aplicao

Opes da Barra de Ferramentas Aplicao


BOTO

DESCRIO
Cria uma nova aplicao.
Cria uma nova tela.
Abre uma aplicao j existente.
Salva a aplicao corrente.
Recorta o objeto selecionado copiando para a rea de transferncia.
Copia o objeto selecionado para a rea de transferncia.
Cola o objeto que est na rea de transferncia no local indicado na tela.
Chama o Organizer.
Mostra as propriedades do objeto selecionado.
Mostra as propriedades da tela selecionada.
Executa a aplicao corrente iniciando pelas telas que esto abertas.
Executa a aplicao corrente.
Abre a ajuda do sistema.
Ativa a ajuda sensvel ao contexto.

20

O que h naTela

Manual do Usurio

2.2.2.

Barra de Ferramentas Objetos

Figura 8: Barra de Ferramentas Objetos

Opes da Barra de Ferramentas Objetos


BOTO

DESCRIO
Liga o modo de seleo, permitindo que o usurio selecione todos os
objetos dentro de uma rea delimitada pelo mouse.
Cria um novo objeto Slider.
Cria um novo objeto Grfico de Tendncia.
Cria um novo objeto Boto.
Cria um novo objeto Gauge (medidor).
Cria uma nova rea de texto (objeto Texto).
Cria um novo objeto Grfico de Barra.
Cria um novo objeto Display.
Cria uma nova Animao.
Cria um novo objeto Setpoint.
Cria um novo objeto Alarme.
Cria um novo objeto Browser.
Cria um novo objeto Bitmap.
Cria um novo objeto Vdeo.
Cria um objeto AVI.
Cria um novo objeto Preview.

O que h na Tela

21

Manual do Usurio

2.2.3.

Barra de Ferramentas Arranjar

A Barra de Ferramentas Arranjar possui comandos para edio de Telas agindo


sobre os Objetos de Tela que estiverem selecionados; os mesmos comandos esto
disponveis no menu Arranjar. Para selecionar mais de um Objeto de Tela, utilize o
boto esquerdo do mouse mantendo a tecla [Ctrl] pressionada; o ltimo objeto
selecionado ficar com o foco em vermelho para ser usado como referncia. Para
desselecionar um objeto use a combinao de teclas: [Ctrl]+[Shift]+BotoEsq.

Figura 9: Barra de Ferramentas Arranjar

Opes da Barra de Ferramentas Arranjar


BOTO

DESCRIO
Envia o objeto selecionado para o ltimo plano (fundo da tela).
Traz o objeto selecionado para o primeiro plano (frente da tela).
Alinha os objetos selecionados pelo lado esquerdo.
Alinha os objetos selecionados pelo lado direito.
Alinha os objetos selecionados pelo topo.
Alinha os objetos selecionados pela base.
Centraliza horizontalmente os objetos selecionados em relao tela.
Centraliza verticalmente os objetos selecionados em relao tela.
Faz com que os objetos selecionados tenham a mesma largura.
Faz com que os objetos selecionados tenham a mesma altura.
Faz com que os objetos selecionados tenham o mesmo tamanho.
Agrupa os objetos selecionados.
Desagrupa os objetos selecionados.

22

O que h naTela

Manual do Usurio

2.2.4.

Barra de Ferramentas Telas

A Barra de Ferramentas Telas mostra o nome da tela corrente e permite trocar de


tela atravs de uma lista que mostra o nome de todas as telas existentes na aplicao.

Figura 10: Barra de Ferramentas Telas

2.3. Teclas de Atalho


Outra maneira para acessar rapidamente as funes do Elipse SCADA so as teclas
de atalho. Listamos abaixo as teclas disponveis, agrupadas por funo.
Opes Gerais
TECLAS
Ctrl + O

Abre a aplicao

DESCRIO

Ctrl + Shift + V

Informaes Sobre o Elipse SCADA

F1

Chama a ajuda

Shift + F1

Chama a ajuda de contexto


Editando uma aplicao

TECLAS
Ctrl + S

Salva a aplicao

DESCRIO

F10

Roda (executa) a aplicao

Alt + O

Chama o Organizer

Ctrl + N

Nova tela.

F8

Monitorar tela

Ctrl + Alt + Shift + I

Conta o nmero de itens da aplicao

Ctrl + Shift + F10

Chama a janela de configurao da fonte do Editor de Scripts


Editando Relatrios

TECLAS
Ctrl + F4

DESCRIO
Fecha o editor de relatrios

Esc

Desseleciona o objeto

Ctrl + A

Seleciona todos objetos

Del

Apaga o objeto

O que h na Tela

23

Manual do Usurio

Editando Telas
TECLAS
Ctrl + F4

Fechar tela

DESCRIO

Esc

Desselecionar objeto

Ctrl + A

Selecionar todos objetos

Del

Apagar objeto

Ctrl + X

Recortar objeto

Ctrl + C

Copiar objeto

Ctrl + V

Colar objeto

Shift + Del

Recortar objeto

Ctrl + Ins

Copiar objeto

Shift + Ins

Colar objeto

2.4. Opes de Linha de Comando


possvel chamar o Elipse SCADA diretamente da linha de comando. O executvel
ELIPSE32.EXE possui a seguinte sintaxe:
ELIPSE32.EXE [-DEMO] [-SETUP] [-EDIT] [<NomeApp>]

Onde:
-DEMO

-SETUP

-EDIT

NomeApp

(Opcional) Fora o Elipse SCADA a rodar em modo de


demonstrao, sem verificar os mecanismos de proteo (hardkey).
Esta opo reescreve o arquivo .INI configurando a seo
[ProtectionType].
(Opcional) Fora o Elipse SCADA a rodar o programa de Setup, que
permite a voc configurar as opes no arquivo de preferncias
(.INI).
(Opcional) Fora o Elipse SCADA a rodar no modo Configurador.
Se o nome de uma aplicao for informado na linha de comando, esta
aplicao ser aberta para configurao.
(Opcional) O nome da aplicao que ir rodar automaticamente ou
ser aberta para configurao (quando o -EDIT especificado).

Na verso Windows CE, a nica linha de comando disponvel NomeApp.

24

O que h naTela

Captulo

3.

Organizer

O desenvolvimento de uma aplicao no Elipse SCADA baseado na ferramenta


Organizer. Ele permite uma viso simples e organizada de toda a aplicao,
ajudando na edio e configurao de todos os objetos envolvidos no sistema atravs
de uma rvore hierrquica.
A estrutura do Organizer pode ser comparada rvore de diretrios do Gerenciador
de Arquivos do Windows. Desta forma, a estrutura da aplicao comea no canto
superior esquerdo com a raiz da aplicao. Todos os objetos da aplicao descem a
partir da raiz agrupados de acordo com seu tipo: Tags, Telas, Alarmes, Receitas,
Histricos, Relatrios, Drivers, Databases, que constituem os principais elementos
de sua aplicao. Selecionando-se qualquer um dos ramos da rvore da aplicao,
ele ir se expandir, mostrando seu contedo; desta forma, voc pode facilmente
navegar pela aplicao tendo disponveis todas as opes de configurao desde a
criao de Tags at o redimensionamento de objetos em uma tela especfica.
A estrutura bsica do Organizer apresentada a seguir:

Figura 11: rvore de classes de objetos no Organizer

Voc pode chamar o Organizer somente quando existir uma aplicao aberta
selecionando o comando Organizer do menu Arquivo ou pressionando o boto do
Organizer na Barra de Ferramentas. A seguinte janela ir aparecer:
Organizer

25

Manual do Usurio

Figura 12: Organizer

A partir do Organizer voc pode criar toda a sua aplicao, simplesmente navegando
atravs da rvore da aplicao. Selecionando-se qualquer um de seus ramos, as
propriedades do objeto selecionado sero mostradas no lado direito da janela, onde
podero ser editadas. Por exemplo, se voc selecionar Tags na rvore do Organizer
voc poder criar novos Tags e editar suas propriedades selecionando a pgina
desejada a partir das abas no topo da janela.

26

Organizer

Manual do Usurio

Figura 13: Menu de aes

Ao clicar com o boto direito sobre os objetos do Organizer, as seguintes opes


aparecem:
Procurar e Substituir: permite procurar e substituir textos em scripts e
propriedades do objeto selecionado e seus filhos. Esta procura case sensitive
(diferencia maisculas de mnsculas).
Relatrio de Referncias: produz um relatrio com as referncias cruzadas do
objeto selecionado e seus filhos.
Relatrio de Scripts: auxilia o usurio na organizao e documentao dos scripts
da aplicao.
Ferramenta de Traduo: auxilia na traduo de uma aplicao, mostrando e
permitindo editar propriedades com textos.
Os botes na Barra de Ferramentas do Organizer permitem realizar determinadas
tarefas rapidamente sem utilizar os menus. Existem 13 botes como pode ser
verificado na tabela a seguir:

Organizer

27

Manual do Usurio

Ferramentas do Organizer
ICONE

28

NOME
Deletar

AO
Apaga um ou mais itens selecionados no
Organizer.

Duplicar

Duplica o item selecionado na rvore do


Organizer.

AppBrowser

Chama o AppBrowser.

Referncia Cruzada

Chama a Referncia Cruzada.

Compilar

Compila o script que est sendo editado.

Compilar tudo

Compila todos os scripts que no esto


compilados.

Recompilar tudo

Recompila todos os scripts da aplicao,


possibilitando ao usurio acessar cada
script com um duplo clique. gerada uma
lista dos scripts compilados, mostrando
em vermelho os que esto com erro.

If

Insere o comando IF...ENDIF no script


selecionado, no ponto onde est o cursor.

ElseIf

Insere o comando ELSE...IF no script


selecionado, no ponto onde est o cursor.

Else

Insere o comando ELSE no script


selecionado, no ponto onde est o cursor.

ForNext

Insere o comando FOR...NEXT no script


selecionado, no ponto onde est o cursor.

WhileWend

Insere o comando WHILE...WEND (fim


de While) no script selecionado, no ponto
onde est o cursor.

RepeatUntil

Insere o comando REPEAT...UNTIL no


script selecionado, no ponto onde est o
cursor.

Organizer

Manual do Usurio

3.1. App Browser


O AppBrowser uma importante ferramenta do Organizer. Ele composto de uma
janela que apresenta a rvore da aplicao com seus objetos. Clicando em qualquer
objeto, pode-se visualizar as funes e atributos relacionados a este objeto. Quando
estamos escrevendo um script, um boto Copia no Script --> fica disponvel nesta
janela, permitindo a cpia do atributo ou funo em questo para as linhas de
programao, facilitando essa tarefa.

Figura 14: App Browser

Organizer

29

Manual do Usurio

3.2. Criando a sua Aplicao


A criao de uma aplicao o ponto de partida para montagem de um sistema
utilizando o Elipse SCADA. Em uma aplicao, o usurio rene todos os objetos
necessrios para execuo das tarefas desejadas. As informaes referentes a esta
aplicao ficam armazenadas em um arquivo de extenso APP.
Para criar uma nova aplicao, faa isso:

Escolha no menu Arquivo a opo Nova Aplicao, ou clique no boto


correspondente na barra de ferramentas.

No quadro Salvar Aplicao Nova! escolha um nome e o lugar onde a


aplicao ser salva.

Alm dos arquivos de extenso APP, existem outros gerados e utilizados pelo Elipse
SCADA:
Extenses disponveis
EXTENSO
.APX

DESCRIO
Arquivo com configuraes da lista de usurios.

.BAK

Backup da aplicao

.DAT

Arquivo de histricos

.HDR

Cabealhos de arquivos de histricos por batelada

.RCP

Arquivo de receitas

.DLL, .SO

Drivers de comunicao

.BMP, .GIF, .JPG

Arquivos de imagens.
No CE, apenas .BMP est disponvel.

NOTA: Usurios de Windows XP devero ter ateno quanto ferramenta de


restaurao do sistema. Esta ferramenta tambm monitora os arquivos .APP, ou seja,
se for feita uma restaurao, verses mais antigas dos arquivos sero recuperadas,
sobreescrevendo os arquivos mais recentes.

30

Organizer

Manual do Usurio

3.2.1.

Propriedades Gerais da Aplicao

Quando voc seleciona a raiz Aplicao, na rvore do Organizer, suas propriedades


so mostradas ao lado direito da rvore. A pgina de propriedades gerais da
Aplicao aparece quando selecionada a aba Aplicao no topo das pginas da
Aplicao. Esta pgina mostrada abaixo e seus respectivos campos so descritos na
tabela que segue.

Figura 15: Propriedades da Aplicao

Organizer

31

Manual do Usurio

Propriedades da Aba Aplicao


OPO
Descrio

DESCRIO
Define o nome da aplicao (que aparecer na barra de
ttulo) caso a opo Barra de Ttulo esteja habilitada.

Barra de ttulo

Habilita a barra de ttulo na janela da aplicao.

No CE, a barra de ttulo obedece essa propriedade


apenas para telas janeladas. As telas cheia obedecem o
padro do prprio CE, algumas plataformas nunca
aparecem, outras sempre aparecem.
Propriedades da Aba Aplicao (Quadro Estilo)
OPO
Desabilita troca de
aplicao

DESCRIO
Desabilita a troca entre programas, ou seja, desabilita o
atalho [Alt+Tab] do Windows.

Desabilita proteo
de tela
Boto de Fechar

Desabilita qualquer protetor de tela (screen saver) enquanto


o Elipse SCADA estiver sendo executado.

Boto de Minimizar

Habilita o boto de Minimizar na janela da aplicao.

Boto de Maximizar

Habilita o boto de Maximizar na janela da aplicao.

Permite Fechar

Desligado, faz com que a execuo termine apenas quando


for chamada a funo StopRunning(). Ligado, permite que
a aplicao (e o Elipse SCADA) seja terminado via outros
meios, como um clique no boto Fechar, desligar do
Windows, etc.

Habilita o boto de Fechar na barra de ttulo da janela da


aplicao.

Propriedades da Aba Aplicao (Botes)

32

OPO
Estatsticas

DESCRIO
Abre uma janela que mostra informaes estatsticas da
aplicao, como: tempo total de edio da aplicao,
nmero de itens na aplicao, nmero total de tags, nmero
de revises e verso do Elipse SCADA em que foi gerada a
aplicao.

Procura Item

Abre uma janela que permite buscar um item (objeto,


propriedade) em qualquer lugar da aplicao e apresent-lo
para edio.

Importar

Abre uma janela que permite escolher uma aplicao para a


importao. Aps a escolha da aplicao origem, uma nova
janela aberta com a rvore das duas aplicaes, de modo
que o usurio pode arrastar os objetos da aplicao origem
para a aplicao destino. OBS: a aplicao-origem no
modificada.

Proteo

Abre uma janela para proteo da aplicao. Existem duas


protees: para configurao (para editar e fazer qualquer
Organizer

Manual do Usurio

tipo de modificao) e para execuo. No caso da utilizao


de senha para a configurao, o usurio final no poder
alterar a aplicao, a no ser que conhea a senha utilizada.
O mesmo vale para a execuo, sendo que s pode haver
esta senha, se houver uma para a configurao.

3.2.2.

Janela de Aplicao

A pgina Janela permite a configurao da janela principal para execuo da


aplicao.

Figura 16: Janela da Aplicao

Organizer

33

Manual do Usurio

Propriedades da Aba Aplicao

3.2.3.

OPO
Comea Maximizado
/Minimizado
/Normal
X, Y, Largura, Altura

DESCRIO
Define a configurao inicial da janela da aplicao.

Centralizar Janela

Indica que a janela dever iniciar em posio central


na tela.

Define a posio e tamanho da janela em pixels.

Touch Screen

O Elipse SCADA possui suporte especial para a utilizao de telas de toque (Touch
Screen), permitindo uma interface mais intuitiva para o uso de sua aplicao.

Figura 17: Touch Screen

34

Organizer

Manual do Usurio

Propriedades da Aba Touch Screen


OPO
Habilitar Key Pad

DESCRIO
Habilita o uso do Key Pad em tempo de execuo.

Atualmente o SCADA CE usa o KeyPad do


prprio Win CE ento no possivel escolher cor e
dimenses para ele.
Salvar coordenadas do
Key Pad
Cor de fundo do Key
Pad
Cor das teclas do Key
Pad
Cor do texto do Key Pad

Habilita o salvamento das novas coordenadas do Key


Pad medida que sua janela mudada de posio.

Esconder mouse

Desabilita o ponteiro do mouse enquanto o Key Pad


est sendo mostrado.

Usar botes grandes

Aumenta o tamanho dos botes do Key Pad.

Define a cor de fundo do Key Pad.


Define a cor das teclas do Key Pad.
Define a cor do texto do Key Pad.

Propriedades do Key Pad e do Numeric Pad

Organizer

OPO
Show window title bar

DESCRIO
Mostra a barra de ttulo da janela do Key Pad e/ou
Numeric Pad.

Override default titlebar


text
Show close button

Permite definir um novo ttulo para a barra de ttulo


da janela do Key Pad e/ou Numeric Pad.
Mostra o boto de fechar na janela do Key Pad e/ou
Numeric Pad.

35

Manual do Usurio

3.2.4.

Elipse Web

Atravs do plug-in Elipse Web, o Elipse SCADA pode gerar documentos para serem
visualizados pela Internet, em conjunto com algum Servidor Web comercial, como o
Internet Information Services (IIS) ou o Microsoft Personal Web Server (PWS).
O Elipse Web pode ser habilitado atravs do Organizer selecionando o item
Aplicao, conforme figura abaixo:

Figura 18: Elipse Web

Propriedades do Elipse Web


OPO
Habilitar servidor de dados
para Web
Diretrio das pginas Web

DESCRIO
Habilita o Elipse Web.

Porta

Permite definir a porta a qual o servidor Web est


associado.

Permite escolher atravs do boto [Localizar...] o


diretrio onde sero gerados os documentos a serem
visualizados pela Internet. O diretrio dever estar na
rvore de documentos do servidor Web.

Nota: Para maiores informaes, veja o captulo Elipse Web.

36

Organizer

Manual do Usurio

3.3. Scripts
Durante a execuo de uma aplicao, diversos procedimentos podem ser disparados
atravs de eventos. Estes procedimentos so descritos por scripts associados a estes
eventos. Maiores detalhes sobre scripts sero discutidos em captulo posterior. Aqui,
temos uma lista de eventos/scripts disponveis em uma aplicao.
Eventos/Scripts de uma Aplicao
EVENTO
OnKeyPress

Organizer

Executa quando
pressionada.

DESCRIO
uma determinada

tecla

for

OnKeyRelease

Executa quando a tecla solta.

OnStartRunning

Executa quando a aplicao iniciar a execuo.

OnStopRunning

Executa quando a aplicao terminar a execuo.

OnUserLogin

Executa quando um usurio inicia a sua seo na


aplicao.

OnUserLogout

Executa quando um usurio encerra a sua seo na


aplicao.

WhileKeyPressed

Executa enquanto uma determinada tecla estiver


sendo pressionada.

WhileRunning

Executa enquanto a aplicao estiver executando. O


script ir executar tantas vezes quantas voc definir na
caixa de texto rodar a cada (aparece somente para
scripts whilerunning).

37

Captulo

4.

Tags

A superviso de um processo com o Elipse SCADA ocorre atravs da leitura de


variveis de processos no campo. Os valores dessas variveis so associados a
objetos do sistema chamados Tags.
Para cada objeto inserido na tela, devemos associar pelo menos um tag ou atributo.
Os tags so todas as variveis (numricas ou alfanumricas) envolvidas numa
aplicao. Os atributos so dados fornecidos pelo Elipse SCADA sobre parmetros
de sistema e componentes da aplicao.
Ao criar tags, o usurio poder organiz-los livremente em grupos, de forma a
facilitar a procura e identificao durante o processo de configurao. Para a criao
de um grupos, basta selecionar o item Tags no Organizer e clicar em Novo Grupo.
Voc pode criar grupos dentro de outros grupos, sem restries. Para modificar a
hierarquia dos grupos e mud-los de posio (por exemplo, incluir um grupo em
outro grupo) basta arrastar o grupo em questo para o lugar desejado.
Voc pode criar e editar tags a partir do Organizer, selecionando o ramo Tags na
rvore da aplicao e pressionando o boto Novo Tag. Na janela do Organizer voc
pode dar um duplo clique na opo Tags para ver os tags j definidos para a
aplicao, da mesma forma que voc faz em uma rvore de diretrios. A medida que
a aplicao cresce os tags podem ser agrupados para melhor organizar e editar a
aplicao.

Tags

39

Manual do Usurio

4.1. Grupo de Tags


Quando voc seleciona a opo Tags na rvore da aplicao no Organizer a seguinte
pgina ir aparecer ao lado direito da rvore. Usando os botes desta pgina voc
pode criar um novo grupo de tags ou um novo tag para a sua aplicao. O novo
grupo ou tag que for criado ir aparecer automaticamente na rvore da aplicao
abaixo da opo Tags.

Figura 19: Grupo de Tags

Propriedades da Aba Grupo de Tags


OPO
Nome

40

DESCRIO
Define o nome do grupo de tags selecionado. Um
grupo de tags trabalha da mesma forma que um
diretrio onde vrios tags sero definidos.

Descrio

Uma breve descrio sobre o grupo selecionado.

Novo Grupo

Cria um novo grupo de tags a partir do grupo atual.

Novo Tag

Cria um novo tag.

Relatrio

Abre uma janela para configurao de um relatrio de


todos os tags existentes na aplicao. Podem ser
selecionadas apenas as propriedades que se deseja
imprimir para cada tipo de tag. O relatrio ser
impresso em um arquivo-texto especificado na caixa
Imprime para o arquivo.

Tags

Manual do Usurio

4.2. Novo Tag


Quando voc pressiona o boto Novo Tag, a janela a seguir ir aparecer. Nesta
janela voc poder definir o nome do tag, a quantidade de tags que voc deseja criar
e o seu tipo. Todos os tags especificados no campo Quantidade sero do mesmo
tipo definido no campo Tipo do Tag.
Opes de Tags
OPO
Nome

Tags

DESCRIO
Nome do Tag. Espaos e caracteres especiais no so
permitidos quando os Tags so usados em Scripts.

Quantidade

Define o nmero de Tags que sero criados com as


mesmas caractersticas especificadas.

PLC

Tags PLC (CLP) so usados para trocar valores com


os equipamentos de aquisio de dados.

DDE

Permite trocar dados com programas que sejam


Servidores DDE. DDE (Data Dynamic Exchange)
um protocolo desenvolvido pela Microsoft para
comunicao entre aplicaes baseadas em Windows.

Demo

Tags Demo so usados para gerar dados randmicos.

Matriz

O Tags Matriz permitem criar matrizes ou vetores de


dados.

Expresso

Tags Expresso permitem a entrada de uma


expresso numrica ou alfanumrica (permitem
concatenao de strings, por exemplo).

Block

Tags Bloco so usados para ler um bloco de valores


simultaneamente.

RAM

Tags RAM so usados para armazenar valores na


memria.

41

Manual do Usurio

4.3. Tag Crono


O Tag Crono cria um novo cronmetro.

Figura 20: Propriedades do Tag Crono

Propriedades do Tag Crono


OPO
Nome

42

DESCRIO
Nome do Tag. Voc pode usar tantos caracteres
quanto queira mas espaos e caracteres especiais no
so permitidos quando os Tags forem usados nos
Scripts.

Descrio

Uma breve descrio sobre o Tag.

Incremento

Determina o incremento do tag.

Preset

Determina o tempo de preset do tag.

Iniciar cronmetro ao
rodar aplicao
Zerar o acumulador ao
ligar o cronmetro
Salvar acumulador ao sair

Habilita a inicializao do cronmetro ao rodar a


aplicao.

Reincio automtico
(execuo em loop)

Habilita o reincio automtico em execuo de loop.

Habilita zerar o acumulador ao ligar o cronmetro.


Habilita salvar acumulador ao sair.

Tags

Manual do Usurio

4.4. Tag PLC


O Tag PLC usado para trocar informaes com os equipamentos de aquisio de
dados usando drivers de I/O fornecidos pela Elipse de acordo com o tipo do
equipamento. Um arquivo de ajuda fornecido com cada driver contendo
informaes importantes a respeito de sua configurao.
Voc pode instalar um novo driver pressionando o boto Novo na pgina de Drivers
e selecionando um ou mais drivers da lista. O boto Configurar abre a janela de
propriedades do driver permitindo a configurao dos parmetros de comunicao
[P] de acordo com as informaes contidas no arquivo de ajuda. A opo Abortar
em erro, encerra a comunicao caso ocorra algum problema, impedindo que uma
aplicao fique travada.

Figura 21: Propriedades do Tag PLC

Tags

43

Manual do Usurio

Propriedades do Tag PLC


OPO
Nome

44

DESCRIO
Nome do Tag. Voc pode usar tantos caracteres quanto
queira mas espaos e caracteres especiais no so
permitidos quando os Tags forem usados nos Scripts.

Mudar tipo para ...

Permite que se mude o tipo do Tag.

Acessar bits

Permite desmembrar o Tag em bits, criando Tags Bit para


cada bit ou conjunto de bits do Tag.

Descrio

Uma breve descrio sobre o Tag.

Driver

Permite a seleo de um driver de comunicao para o Tag


corrente. Os drivers devem ser instalados atravs da janela
de Drivers a fim de que estejam disponveis.

Ajuda

Mostra a Ajuda do Driver selecionado.

Parmetros N

Permite a configurao dos parmetros de endereamento


N para o Tag corrente de acordo com o driver
selecionado. Esta configurao est contida na Ajuda do
Driver que pode ser acessado pressionando-se o boto
"Ajuda". Os valores podem ser expressos em decimais [32768, 65535], octais [0o, 177777o] ou hexadecimais
[0000h, FFFFh].

Scan

Define o intervalo de tempo no qual o valor do tag ser lido


(em ms)

Escala

Marcando esta opo os valores do Tag sero convertidos


para uma nova escala de valores determinada pelo usurio
conforme os limites definidos em CLP Inferior e Superior,
e Sistema Superior e Inferior.

CLP Inferior

Define o valor mnimo a ser lido do PLC (CLP).

Sistema Inferior

Define o novo valor mnimo para a converso dos valores


lidos.

CLP Superior

Define o valor mximo a ser lido do PLC (CLP).

Sistema Superior

Define o novo valor mximo para a converso dos valores


lidos.

Testar conexo aqui

Testa a comunicao com o PLC, permitindo a leitura e


escrita de valores.

Habilita leitura pelo


scan

Habilita a leitura pelo scan, ou seja, o valor do tag sempre


ser atualizado no tempo definido no campo Scan,
independente de outras configuraes.

Habilita leitura
automtica

Quando habilitado, o valor do tag s lido quando


necessrio. Se a opo Habilita leitura pelo scan estiver
habilitada, esta opo ignorada.

Habilita escrita
automtica

Habilita escrita automtica para o tag PLC (ver tpico


abaixo).

Tags

Manual do Usurio

Leitura pelo Scan X Leitura Automtica


Quando a opo Habilita leitura pelo scan est ligada, o Elipse SCADA atualiza o
valor do tag continuamente, na freqncia especificada no campo Scan. Este valor
de Scan tambm utilizado pela opo Habilita leitura automtica para verificar
se o valor do tag PLC antigo, definindo a necessidade ou no de fazer uma
releitura. Logo, se a opo Habilita leitura pelo scan estiver ligada, a opo
Habilita leitura automtica irrelevante, pois o valor do tag estar sempre
atualizado.
A opo Habilita leitura automtica pode ser utilizada isoladamente para
otimizao em casos especficos. Por exemplo, se um tag estiver apenas sendo
requisitado por um script, pode-se ligar a opo Habilita leitura automtica e
desligar a opo Habilita leitura pelo scan. Assim o tag s ser lido quando for
necessrio.
Escrita Automtica em Tags PLC
Ao atribuir um valor diretamente a um tag PLC ou elemento de bloco que possua a
propriedade escrita automtica habilitada, o comando enviado diretamente ao
driver de comunicao, que por sua vez o repassa ao equipamento associado. Tal
ao no ocorre somente quando o valor atribudo for igual ao contedo que j
estava no tag. Caso queira forar uma escrita mesmo assim, deve ser executada a
funo Write() do tag, em algum script (ver captulo Scripts).

4.5. Tag DDE


O Tag DDE usado para troca de dados entre o Elipse SCADA e outras aplicaes
(Excel, Access, Word, etc.) usando DDE (Dynamic Data Exchange). Para tanto voc
precisa especificar a aplicao servidora, o tpico e o item, conforme voc pode ver
na janela abaixo.

Tags

45

Manual do Usurio

Figura 22: Propriedades do Tag DDE

46

Tags

Manual do Usurio

Propriedades do Tag DDE


OPO
Nome

Tags

DESCRIO
Nome do Tag. Voc pode usar tantos caracteres
quanto queira mas espaos e caracteres especiais no
so permitidos quando os Tags forem usados nos
Scripts.

Mudar tipo para

Permite que se mude o tipo do Tag.

Descrio

Uma breve descrio sobre o Tag.

Nome do Servidor

Define o nome do servidor DDE que pode ser uma


aplicao Windows (ex: Excel, Word, etc) ou um
driver DDE fornecido pelo fabricante do seu
equipamento. A lista de programas disponveis para
servidores DDE aparece quando a seta ao lado desta
caixa pressionada.

Tpico

Define o nome do Tpico do Servidor DDE,


dependendo do tipo do Servidor. Pode ser um
documento (ex: uma tabela do Excel). A lista de
Tpicos disponveis aparece quando a seta ao lado
desta caixa pressionada.

Item

Define o nome do Item do Servidor DDE,


dependendo do tipo do Servidor. Pode ser um item de
um documento (ex: uma clula em uma tabela do
Excel).

Testar Conexo

Permite que voc teste a configurao DDE. Uma


mensagem pode indicar um erro de conexo ou o
valor recebido pelo item configurado.

Escala

Marcando esta opo os valores do Tag sero


convertidos para uma nova escala de valores
determinada pelo usurio conforme os limites
definidos em Server Low, System Low, Server High
e System High.

Servidor Inferior

Define o valor mnimo a ser lido do Servidor.

Sistema Inferior

Define o novo valor mnimo para a converso dos


valores lidos.

Servidor Superior

Define o valor mximo a ser lido do Servidor.

Sistema Superior

Define o novo valor mximo para a converso dos


valores lidos.

47

Manual do Usurio

4.6. Tag Demo


O Tag Demo usado para a simulao de valores. Ele permite a voc gerar curvas
definidas ou valores randmicos conforme o tipo de curva selecionada nos seis
botes da pgina Geral do tag Demo (veja figura abaixo).
Tags Demo podem ajud-lo a testar sua aplicao ou podem ser usados, por
exemplo, em um objeto de tela animao para mostrar os quadros da animao de
acordo com a variao do tag.

Figura 23: Propriedades do Tag Demo

48

Tags

Manual do Usurio

Propriedades do Tag Demo


OPO

Tags

Nome

DESCRIO
Nome do Tag. Espaos e caracteres especiais no so
permitidos quando os Tags forem usados em Scripts.

Mudar tipo para

Permite que se mude o tipo do Tag.

Acessar bits

Permite desmembrar o Tag em bits, criando Tags Bit


para cada bit.

Descrio

Uma breve descrio sobre o Tag.

Tipo

Define o tipo de curva a ser usada pelo Tag Demo


corrente.

Limite inferior

Define um valor mnimo para o Tag Demo.

Limite superior

Define um valor mximo para o Tag Demo.

Incremento

Define o incremento para o Tag Demo para uma


curva dente de serra.

Espera

Define o nmero de perodos entre cada gerao de


valor para o Tag Demo. Por exemplo, se for 1 um
valor gerado a cada perodo, se for 2, gera um valor
a cada dois perodos, e assim por diante. usado
junto com o atributo period para controlar o intervalo
de tempo para a variao dos dados.

Perodo

Define o nmero de milisegundos entre a gerao de


cada novo valor para o Tag Demo. usado junto com
o atributo delay para controlar o intervalo de tempo
para a variao dos dados.

Habilitado

Define a condio inicial do Tag Demo: Habilitada


ou Desabilitada. Os valores do Tag Demo so
gerados somente quando esta opo estiver marcada,
caso contrrio, o valor do Tag permanece o mesmo.

49

Manual do Usurio

4.7. Tag Expresso


O Tag Expresso permite que voc atribua uma expresso numrica ou
alfanumrica a um tag. Voc pode criar equaes envolvendo outros tags e strings.
As mesmas funes, operadores e constantes usadas nos Scripts podem ser usadas
nos Tags Expresso.

Figura 24: Propriedades do Tag Expresso

Propriedades do Tag Expresso

50

OPO
Nome

DESCRIO
Nome do tag. Espaos e caracteres especiais no so permitidos
quando os tags forem usados em scripts.

Mudar tipo para

Permite que se mude o tipo do tag.

Acessar bits

Permite desmembrar o tag em bits, criando tags Bit para cada


bit.

Descrio

Uma breve descrio sobre o tag.

Expresso

Permite a entrada de qualquer expresso vlida para o tag.

Erros

Lista erros de sintaxe encontrados na expresso. Os erros so


mostrados durante a edio da expresso e para que se tenha
uma expresso vlida a mensagem No errors (Sem erros) deve
aparecer neste campo.
Tags

Manual do Usurio

4.8. Tag Bloco


Tags Blocos permitem a comunicao em bloco com os equipamentos de aquisio
de dados usando drivers de I/O fornecidos pela Elipse Software de acordo com o
tipo do equipamento. Um arquivo de ajuda fornecido com cada driver contendo
informaes importantes a respeito de sua configurao.
Voc pode instalar um novo driver pressionando o boto Novo na pgina de Drivers
e selecionando um ou mais drivers da lista. O boto Configurar abre a janela de
propriedades do driver permitindo a configurao dos parmetros de comunicao
P de acordo com as informaes contidas no arquivo de ajuda. A opo Abortar
em erro encerra a comunicao caso ocorra algum problema, impedindo que uma
aplicao fique travada.

Figura 25: Propriedades do Tag Bloco

Tags

51

Manual do Usurio

Propriedades do Tag Bloco


OPO
Nome

52

DESCRIO
Nome do Tag. Voc pode usar tantos caracteres
quanto queira mas espaos e caracteres especiais no
so permitidos quando os Tags forem usados nos
Scripts.

Mudar tipo para

Permite que se mude o tipo do Tag.

Descrio

Uma breve descrio sobre o Tag.

Driver

Permite a seleo de um driver de comunicao para


o Tag corrente. Os drivers devem ser instalados
atravs da janela de Drivers a fim de que estejam
disponveis.

Ajuda

Mostra a Ajuda do Driver selecionado.

Parmetros B

Permite a configurao dos parmetros de


endereamento B para o Tag corrente de acordo
com o driver selecionado. Esta configurao est
contida na Ajuda do Driver que pode ser acessado
pressionando-se o boto "Ajuda". Os valores podem
ser expressos em decimais [-32768, 65535], octais
[0o, 177777o] ou hexadecimais [0000h, FFFFh].

Scan

Define de quanto em quanto tempo os valores do Tag


sero atualizados (ms).

Mudar tamanho

Muda o tamanho do bloco a ser monitorado pelo


Elipse SCADA.

Adicionar Elemento

Permite que voc adicione um novo elemento ao Tag


selecionado.

Habilitar leitura pelo scan

Habilita leitura em bloco.

Habilitar leitura
automtica
Habilitar escrita
automtica
Tamanho

Habilita leitura automtica para o bloco.

Novo elemento...

Novo elemento no tag bloco.

Habilita escrita automtica para o bloco.


Configura o tamanho do tag bloco.

Tags

Manual do Usurio

4.8.1.

Elemento de Bloco

Cada elemento do tag Bloco possui suas propriedades que podem ser acessadas
selecionando-se o elemento desejado na rvore da aplicao no Organizer. A pgina
a seguir ser, ento, mostrada no lado direito da janela.

Figura 26: Propriedades do Elemento de Bloco

Tags

53

Manual do Usurio

Propriedades do Elemento de Bloco


OPO
Nome

54

DESCRIO
Nome do Tag. Voc pode usar tantos caracteres
quanto queira mas espaos e caracteres especiais no
so permitidos quando os Tags forem usados nos
Scripts.

Descrio

Uma breve descrio sobre o Tag.

Mudar tipo para

Permite que se mude o tipo do Tag.

Acessar bits

Permite desmembrar o Tag em bits, criando Tags Bit


para cada bit ou conjunto de bits do Tag.

Bloco index

Permite mudar a ordem do elemento no bloco


digitando o ndice desejado.

Escala

Marcando esta opo os valores do Tag sero


convertidos para uma nova escala de valores
determinada pelo usurio conforme os limites
definidos em CLP Inferior, Sistema Inferior, CLP
Superior e Sistema Superior.

CLP Inferior

Define o valor mnimo a ser lido do PLC (CLP).

Sistema Inferior

Define o novo valor mnimo para a converso dos


valores lidos.

CLP Superior

Define o valor mximo a ser lido do PLC (CLP).

Sistema Superior

Define o novo valor mximo para a converso dos


valores lidos.

Testar comunicao aqui

Testa a comunicao com o PLC lendo e escrevendo


alguns valores.

Tags

Manual do Usurio

4.9. Tag RAM


Tags RAM so usados internamente para armazenar valores em memria. Este tipo
de tag voltil, portanto mantm seus valores somente enquanto a aplicao est
executando.

Figura 27: Propriedades do tag RAM

Propriedades do Tag RAM


OPO
Nome

DESCRIO
Nome do tag. Voc pode usar tantos caracteres
quanto queira mas espaos e caracteres especiais no
so permitidos quando os Tags forem usados nos
Scripts.

Descrio

Uma breve descrio sobre o tag.

Mudar tipo para

Permite que se mude o tipo do tag.

Acessar bits

Permite desmembrar o tag em bits, criando tags Bit


para cada bit ou conjunto de bits do tag.

Valor inicial

Define um valor inicial para o tag. Este valor pode ser


um nmero ou um string entre aspas duplas (ex.:
abc).

4.10. Tag Matriz


O Tag Matriz permite criar matrizes ou vetores de dados que podem ser usados em
clculos, armazenamentos etc. possvel associar cada clula de uma matriz a um
tag ou propriedade. As operaes sobre matrizes sempre tem linha e coluna
comeando com o ndice 1.
Tags

55

Manual do Usurio

Figura 28: Propriedades do Tag Matriz

Propriedades do Tag Matriz


OPO
Nome

DESCRIO
Nome do tag. Voc pode usar tantos caracteres
quanto queira mas espaos e caracteres especiais no
so permitidos quando os Tags forem usados nos
Scripts.

Descrio

Uma breve descrio sobre o tag.

Colunas

Define o nmero de colunas da matriz

Linhas

Define o nmero de linhas da matriz.

Associar

Mapeia todas ou somente algumas clulas da matriz


para um tag.

Associar Clulas a Tags


Voc pode associar uma clula da matriz ou vetor para um tag pressionando o boto
Associar na pgina Geral do tag Matriz e especificando qual ou quais as clulas
que deseja associar.
Cada clula associada aparece abaixo do tag Matriz na rvore da aplicao no
Organizer. Ao selecionar uma clula especfica suas propriedades so mostradas ao
lado direito da rvore. Cada clula associada possui 4 pginas de propriedades:
Geral, Alarmes, Scripts e Tags. As 3 primeiras pginas so as mesmas de qualquer
tag e a pgina de tags permite associar um tag ou propriedade clula da matriz da
mesma forma em que tags e propriedades so associados objetos de tela.

56

Tags

Manual do Usurio

4.11. Tag Bit


O Tag Bit somente pode ser criado a partir de um outro tag e permite acessar
individualmente cada bit do mesmo. Os tags que permitem o desdobramento em bits
so: PLC, Demo, Expresso, Elemento de Bloco, Ram ou Remoto.
Voc pode criar um tag Bit a partir da pgina Geral de qualquer um dos tags citados
acima. Clicando no boto Acessar bits a seguinte janela ir aparecer, onde voc
poder selecionar os bits que deseja mapear. A seleo dos bits feita usando-se o
mouse e as teclas [Shift] ou [Ctrl], da mesma forma em que se selecionam itens em
uma list box do Windows.

Figura 29: Tag Bit

O tag Bit pode ser tanto um nico bit quanto um conjunto de bits, desde que sejam
contnuos. Isto quer dizer que voc pode mapear para um nico tag Bit, por
exemplo, os bits 0, 1, e 2 mas no os bits 10, 11 e 24. A check box existente nesta
janela permite especificar se devem ser criados um tag para cada bit selecionado ou
se os bits contnuos que estejam selecionados devem ser agrupados em um nico
tag.
No exemplo acima sero criados cinco tags Bit da seguinte forma:
TAGS
BITS

bitField
0, 1, 2

bitField2
5

bitField3
8

bitField4
12

bitField5
20, 21, 22

Os tags Bit criados aparecem abaixo do respectivo tag na rvore da aplicao no


Organizer. Ao selecionar um tag Bit especfico suas propriedades so mostradas ao
lado direito da rvore.
A pgina de Propriedades Gerais do tag Bit aparece quando selecionada a aba Geral
no topo das pginas do tag Bit. Esta pgina mostrada abaixo e seus respectivos
campos so descritos na tabela que segue.

Tags

57

Manual do Usurio

Figura 30: Propriedades gerais do Tag Bit

Propriedades do Tag Bit


OPO
Nome

DESCRIO
Nome do tag. Espaos e caracteres especiais no so
permitidos quando os tags forem usados nos scripts.

Descrio

Uma breve descrio sobre o tag.

Bit de palavra alta e bit de


palavra baixa

Define quais os bits ou bit que fazem parte daquele


tag.

4.12. Pgina de Alarmes


Cada tag que voc define possui uma pgina de Alarmes como a mostrada abaixo,
onde podem ser configurados 4 intervalos de valores e prioridades para Alarmes.
Alarmes so usados para sinalizar algum problema e ento tomar as aes
apropriadas usando scripts. Para visualizar os Alarmes configurados para um tag
voc precisa criar um objeto de tela Alarme e atribuir o tag a ele. Este objeto pode
mostrar, tambm, alarmes j ocorridos que estejam registrados em um arquivo de
histricos ou alarmes ativos no sistema. Para imprimir os alarmes ocorridos no
58

Tags

Manual do Usurio

sistema voc pode definir um relatrio atravs do Organizer e executar a funo


especial Print() em um script.
A pgina de Alarmes dos Tags aparece quando selecionada a aba Alarmes no topo
das pginas do tag. Esta pgina mostrada abaixo e seus respectivos campos so
descritos na tabela que segue.

Figura 31: Pgina de Alarmes

Tags

59

Manual do Usurio

Propriedades dos Alarmes (associados a Tags)


OPO
LoLo

60

DESCRIO
Alarme Baixo Crtico. Define um intervalo de valores
(menor igual) onde o Tag considerado em um
estado de Alarme Baixo Crtico. usado quando o
valor do tag est abaixo de um mnimo, ou seja,
extremamente baixo.

Low

Alarme Baixo. Define um intervalo de valores


(menor igual) onde o tag considerado em estado de
alarme baixo. usado quando o valor do tag est
abaixo do normal.

High

Alarme Alto. Define um intervalo de valores (maior


igual) onde o tag considerado em estado de Alarme
Alto. usado quando o valor do tag est mais alto do
que o normal.

HiHi

Alarme Alto Crtico. Define um intervalo de valores


(maior igual) onde o tag considerado em estado de
Alarme Alto Crtico. usado quando o valor do tag
est acima de um mximo, ou seja, extremamente
alto.

Valor

Define os limites para cada situao possvel de


alarme (lolo, low, hi, hihi).

Pri

Define a prioridade para cada situao de alarme.


Nmeros pequenos indicam alta prioridade (a
prioridade deve ser um nmero entre 0 e 999). Para
um melhor controle os alarmes de maior prioridade
iro aparecer em primeiro plano na janela de alarmes
(objeto de tela Alarme).

Comentrios

Um comentrio ou mensagem pode ser definido para


cada alarme.

Logar mensagens de
retorno
Grupo de Alarmes

Habilita o registro (log) das mensagens de retorno de


alarme.

Manter o valor do tag


sempre atualizado

Define que o sistema ir supervisionar o tag


constantemente, mesmo que ele no esteja sendo
utilizado em nenhum lugar da aplicao, a fim de no
perder nenhum alarme deste tag.

Usar outro nome de tag

Permite definir um nome alternativo para tag no


registro (log) de alarmes.

Define o grupo de Alarmes do tag corrente. O grupo


de Alarmes deve ser definido na opo Alarmes do
Organizer.

Tags

Manual do Usurio

4.13. Scripts de Tags


possvel executar scripts associados a mudanas nos valores dos tags e a estados
de alarmes dos tags.
Scripts Disponveis
Voc pode associar scripts a tags executando-os em uma das situaes a seguir:
EVENTOS
OnAck

Tags

DESCRIO
Executa o script quando o alarme for sinalizado como
reconhecido pelo usurio.

OnAlarmHigh

Executa o script quando o valor definido para alarme


Alto (High) for alcanado.

OnAlarmHiHi

Executa o script quando o valor definido para o


alarme HiHi for alcanado.

OnAlarmLow

Executa o script quando o valor definido para o


alarme baixo (Low) for alcanado.

OnAlarmLoLo

Executa o script quando o valor definido para o


alarme LoLo for alcanado.

OnAlarmReturn

Executa o script assim que uma situao de alarme


tiver terminado.

OnValueChanged

Executa o script quando mudar o valor do tag

OnRead

Somente para tags PLC e Bloco. Executa o script


quando o tag lido do driver.

61

Captulo

5.

Telas

Uma Tela pode ser definida como uma janela para monitoramento de um processo.
Cada aplicao pode ter um nmero ilimitado de telas.
Voc pode criar uma nova Tela pressionando o boto Nova Tela na Barra de
Ferramentas ou usando o comando Novo no menu Tela. Nesta nova tela voc pode
definir Objetos de Tela, um desenho de fundo e outras caractersticas especficas.
Para uma melhor visualizao do sistema que voc est monitorando alguns bitmaps
de fundo podem ser definidos para as telas. Um bitmap do Windows um arquivo
grfico com extenso BMP que pode ser criado em diversas aplicaes Windows
especficas para desenho, como por exemplo o Paintbrush.
Voc pode criar seus desenhos (bitmaps) em qualquer tamanho e cores que desejar,
Elipse SCADA ir import-los automaticamente sem a necessidade de qualquer
processo de converso.
Para visualizar ou editar as propriedades da tela corrente d um duplo clique em um
espao vazio da tela ou use o comando Propriedades do menu Tela.
Quando a opo Telas selecionada na rvore do Organizer, a janela a seguir
aparece, contendo uma lista de todas as telas da sua aplicao. Voc pode criar uma
nova tela usando o boto Novo direita da pgina ou remover uma tela existente
selecionando-a na lista e pressionando o boto Deletar.

Telas

63

Manual do Usurio

Figura 32: Janela de criao de Telas

Propriedades da Janela de Criao das Telas


OPO
Lista

64

DESCRIO
Mostra uma lista de todas as Telas existentes na sua
aplicao. As mesmas Telas aparecem na rvore do
Organizer logo abaixo da opo Telas e quando
selecionadas suas respectivas propriedades so
mostradas.

Nova

Cria uma nova Tela.

Deletar

Apaga a Tela selecionada da Lista.

Ir para

Fecha o Organizer e mostra a Tela corrente.

Mostrar

Mostra a Tela corrente sem selecion-la.

Fechar

Esconde a Tela corrente mantendo-a na aplicao.

Telas

Manual do Usurio

5.1. Propriedades Gerais da Tela


Cada tela que voc cria para a aplicao aparece abaixo da opo Telas na rvore da
aplicao no Organizer. Ao selecionar uma tela especfica suas propriedades so
mostradas ao lado direito da rvore. A pgina de propriedades gerais de telas
aparece quando selecionada a aba Geral no topo das pginas da tela. Esta pgina
mostrada abaixo e seus respectivos campos so descritos na tabela que segue.

Figura 33: Propriedades da Tela

Propriedades da Tela

Telas

OPO
Nome

DESCRIO
Define um nome para a tela corrente. Usando este nome voc
pode abrir a tela de qualquer parte da aplicao usando botes ou
teclas de funo, bem como associ-la a scripts.

Titulo

Define um ttulo para a tela, usado tambm como sua descrio.

Cor

Define a cor de fundo para a tela corrente. Este parmetro


usado quando no existe um bitmap selecionado ou quando o
bitmap no preenche toda a tela.

Bitmap

Habilita ou desabilita o uso de um bitmap como fundo para a


tela corrente.

Localizar...

Permite navegar na estrutura de diretrios a fim de encontrar os


arquivos BMP que sero usados como fundo para a tela. O
caminho e nome do bitmap aparecem abaixo.

Nvel de acesso

Define o nvel de acesso para a tela.

65

Manual do Usurio

5.2. Propriedades de Estilo de Telas


A pgina propriedades de estilo de telas aparece quando selecionada a aba Estilo no
topo das propriedades da tela. Esta pgina mostrada abaixo e seus respectivos
campos so descritos na tabela que segue.

Figura 34: Propriedades de Estilo da Tela

66

Telas

Manual do Usurio

Propriedades de Estilo da Tela

Telas

OPO
Tela Cheia

DESCRIO
Determina que a Tela ocupe toda a janela da aplicao.

Janelada

Determina que a Tela aparea dentro de uma janela sem


ocupar toda a Tela da aplicao conforme especificado
nas opes Tamanho e a Posio.

Largura

Define a largura da Tela em pixels.

Altura

Define a altura da Tela em pixels.

Determina a coordenada X para o canto superior


esquerdo da Tela em pixels. Por exemplo, se voc esta
usando uma resoluo no Windows de 640x480 (VGA)
a sua coordenada X pode variar de 0 (zero) a 640 pixels
para uma janela sem scroll bar.

Determina a coordenada Y para o canto superior


esquerdo da Tela em pixels. Por exemplo, se voc esta
usando uma resoluo no Windows de 640x480 (VGA)
a sua coordenada Y pode variar de 0 (zero) a 480 pixels
para uma janela sem scroll bar.

Rolagem

Nunca: determina que a janela no tenha barras de


rolagem, mesmo quando necessrio. Automtico:
barras de rolagem aparecero automaticamente quando
se fizer necessrio.

No mostra foco dos


objetos

No mostra o foco dos objetos da tela em tempo de


execuo.

Mostrar Borda

Mostra uma borda de 1 pixel de largura em volta da tela.


Somente para telas janeladas e de tamanho fixo.

Redimensionvel

Permite o redimensionamento da janela em tempo de


execuo.

Mvel

Permite que a janela seja movida em tempo de


execuo.

Barra de Ttulo

Mostra ou esconde a Barra de Ttulo.

Visvel

Torna a Tela visvel em tempo de execuo.

Modal

Somente vlido para Telas janeladas. Define a janela


como sendo modal, isto , deve ser fechada para que o
foco possa passar para outras janelas abertas.

Popup

Somente vlido para Telas janeladas. Define a janela


como sendo popup, isto significa que ela fechada
automaticamente quando perde o foco.

Recortar objeto

Define o uso do clipping para o redesenho dos objetos


de tela relativo ao fundo, otimizando o redesenho. Esta
opo deve ser habilitada somente se os objetos de tela
no esto sobrepostos e no sero movidos, caso
contrrio poder no surtir o efeito desejado.

Boto de Fechar

Habilita o boto fechar na janela (boto do canto


superior direito). Este boto s pode ser visto em tempo
67

Manual do Usurio

de execuo.

5.3. Scripts de Tela


Scripts de telas geralmente esto associados a uma ao executada na tela. Isto
significa, por exemplo, que eles podem ser executados ao abrir ou fechar a tela, ou
mesmo quando uma tecla for pressionada enquanto a tela monitorada. Os scripts
disponveis para as telas so descritos na tabela abaixo.
Scripts Disponveis
Voc pode associar scripts a tags executando-os em uma das situaes a seguir:
EVENTOS
OnHide

68

DESCRIO
Executado aps uma tela ter sido fechada.

OnKeyPress

Executado quando a tecla especificada no boto


Nova tecla for pressionada.

OnKeyRelease

Executado quando a tecla especificada no boto


Nova tecla for solta.

OnKillFocus

Executado quando a tela perde o foco de teclado ou


mouse

OnPreHide

Executado antes da tela ser fechada. Chame a funo


Show() neste script para manter a tela aberta.

OnPreShow

Executado antes da tela ser mostrada. Chame a


funo Hide() neste script para cancelar a abertura da
tela.

OnSetFocus

Executado quando a tela ganha o foco de teclado ou


mouse.

OnShow

Executado quando a tela mostrada.

WhileKeyPressed

Executado enquanto a tecla especificada no boto


Nova tecla estiver sendo pressionada.

WhileRunning

Executado enquanto a tela estiver ativa.

Telas

Captulo

6.

Objetos de Tela

Quando o programador est desenvolvendo a sua aplicao, muitas vezes ele


necessita mostrar algum resultado, fazer um alerta ou receber informaes e
acionamentos do usurio. Essa interao com o usurio feita atravs do que
chamamos interface. Para que o programador possa construir a interface de sua
aplicao, o Elipse SCADA oferece uma srie de recursos chamados Objetos de
Tela.
Objetos de Tela so elementos grficos e representaes de objetos reais do
processo que ajudam o usurio a interagir e acompanhar a aplicao que est sendo
executada no Elipse SCADA.
Neste captulo, veremos os objetos de tela que esto disponveis no Elipse SCADA,
seu significado, utilidade e funcionamento. Para uma melhor compreenso,
organizamos os objetos de tela em duas categorias: objetos de visualizao e objetos
de interao.

6.1. Edio dos Objetos de Tela


Os objetos de tela podem ser criados a partir da barra de ferramentas Objetos j
descrita em seo anterior ou atravs do menu Objetos. Uma vez selecionado o
objeto que se deseja criar mantenha o boto esquerdo do mouse pressionado na rea
da tela enquanto movimenta o mouse (um retngulo pontilhado mostra o tamanho e
a forma do objeto). Ao soltar o boto o objeto ser posicionado dentro da rea
especificada.
A edio dos objetos na tela, como alinhamento, tamanho, posio e agrupamento
feita atravs da barra de ferramentas Arranjar j descrita ou atravs do menu. O
ltimo objeto selecionado fica com o foco em vermelho para ser usado como
referncia. Para deselecionar um objeto use a combinao de teclas:
[Shift]+[Ctrl]+[BotoEsq].

Objetos de Tela

69

Manual do Usurio

6.2. Propriedades dos Objetos de Tela


Em geral, os objetos de tela possuem diversas propriedades comuns que esto
agrupadas nas pginas descritas a seguir.

6.2.1.

Pgina Tamanho e Pos

Figura 35: Pgina Tamanho e Pos

70

Objetos de Tela

Manual do Usurio

Propriedades da Pgina de Tamanho e Posio


OPO
X

Objetos de Tela

DESCRIO
Define a coordenada X para o canto superior
esquerdo do objeto, em pixels. usado juntamente
com o atributo Y para definir a posio do objeto a
partir da origem da tela (0,0)

Define a coordenada Y para o canto superior esquerdo


do objeto, em pixels. usado juntamente com o
atributo X para definir a posio do objeto a partir da
origem da tela (0,0)

Largura

Determina a largura do objeto em pixels. usado


juntamente com o atributo altura para definir o
tamanho do objeto

Altura

Determina a altura do objeto em pixels. usado


juntamente com o atributo largura para definir o
tamanho do objeto

Posio fixa durante a


configurao

Determina que o objeto no possa ser movido durante


a configurao (bloqueia a mudana de posio do
objeto).

Visvel quando iniciar


aplicao
Habilitado (aceita entrada
de mouse e teclado)

Define que o objeto ser visvel no momento em que


a aplicao iniciar.

Mostrar dica em execuo

Habilita o objeto a mostrar uma dica (tip) quando o


mouse est sobre ele.

Nvel de Acesso

Permite associar um nvel de acesso ao objeto (0 para


acesso livre).

Habilita o acesso do teclado e mouse ao objeto


(vlido somente para objetos que permitem entradas
via mouse ou teclado. Exemplo: slider).

71

Manual do Usurio

6.2.2.

Pgina Moldura

Figura 36: Pgina de Moldura

Propriedades da Pgina de Moldura

72

OPO
Visvel

DESCRIO
Habilita ou desabilita uma moldura em volta do objeto.

Cor

Define a cor da moldura do objeto.

Ttulo

Habilita ou desabilita um ttulo na moldura do objeto.

Texto

Define o texto do ttulo.

Fonte

Define fonte, cor e tamanho da fonte do Ttulo.

Separador de ttulo

Habilita ou desabilita uma linha separadora entre o texto e o


objeto.

Borda

Habilita ou desabilita uma borda na moldura.

Espessura

Define a espessura do moldura em pixels.

Cor

Define a cor da borda do moldura.

Efeito 3D

Seleciona um efeito 3D dentro ou fora do moldura do


objeto.

Espessura

Define a espessura em pixels para o efeito 3D.

Objetos de Tela

Manual do Usurio

6.2.3.

Pgina de Tags

Figura 37: Pgina de Tags

Propriedades da Pgina de Tags


OPO
Objetos

Objetos de Tela

DESCRIO
Mostra a rvore da aplicao. Conforme o objeto
selecionado, suas propriedades aparecero na janela
de Propriedades.

Propriedades

Permite a seleo de qualquer propriedade do objeto


selecionado na rvore.

Tags selecionados

Lista os Tags que esto associados ao objeto.

Adicionar

Adiciona os Tags marcados lista de Tags


selecionados.

Remover

Remove os Tags selecionados da lista.

73

Manual do Usurio

6.3. Scripts de Objetos de Tela


Existem alguns scripts disponveis para todos os objetos de tela, estes scripts so
descritos na tabela abaixo. Scripts especficos de um objeto so descritos mais
adiante na respectiva seo do objeto. Maiores detalhes a respeito do uso de scripts
veja no captulo especfico.

Figura 38: Pgina de Scripts

Scripts Disponveis
Voc pode associar scripts a tags executando-os em uma das situaes a seguir:
EVENTOS
DESCRIO
Executado quando o objeto perde o foco do teclado
OnKillFocus
ou mouse.
Executado quando o boto esquerdo do mouse
OnLButtonDblClk
pressionado duas vezes sobre o objeto.
Executado quando o boto esquerdo do mouse
OnLButtonDown
pressionado sobre o objeto.
Executado quando o boto esquerdo do mouse solto
OnLButtonUp
sobre o objeto.
Executado quando o mouse movido sobre o objeto.
OnMouseMove
Executado quando o boto direito do mouse
OnRButtonDblClk
pressionado duas vezes sobre o objeto.
Executado quando o boto direito do mouse
OnRButtonDown
pressionado sobre o objeto.
Executado quando o boto direito do mouse solto
OnRButtonUp
sobre o objeto.
Executado quando o objeto recebe o foco do teclado
OnSetFocus
ou mouse.

74

Objetos de Tela

Manual do Usurio

6.4. Referncia Cruzada


A pgina de Referncia-Cruzada (Cross-Reference) lista todos os links para o
objeto corrente e suas propriedades, ou seja, quais outros objetos se referem a este e
quais propriedades ou valores esto sendo usados. Se voc deseja ir ao item
selecionado basta dar um duplo-clique sobre. A caixa Mostrar itens filhos permite
visualizar na lista os itens filhos associados aos itens pai listados.

Figura 39: Pgina de Referncia Cruzada

6.5. Objetos de Visualizao


6.5.1.

Texto

O objeto Texto permite atribuir mensagens a intervalos de valores dos tags,


denominados Zonas. Podem ser definidas diversas zonas cada uma delas contendo
sua prpria mensagem.
Objetos de Tela

75

Manual do Usurio

Figura 40: Texto

As Propriedades do Texto permitem definir cores e mensagens para cada zona.


Tambm possvel definir uma zona padro para os valores que no pertencem a
nenhum intervalo especfico. Voc pode editar as propriedades de um texto dando
um duplo-clique sobre o mesmo.
Propriedades Gerais do Texto

Figura 41: Propriedades Gerais do Texto

Propriedades Gerais do Texto


OPO

76

Nome

DESCRIO
Define o nome do texto que ser usado na rvore do
Organizer e nos scripts.

Descrio

Uma breve descrio sobre o texto.

Objetos de Tela

Manual do Usurio

Zonas de Texto

Figura 42: Propriedades da Zona de Texto

Objetos de Tela

77

Manual do Usurio

Propriedades da Zona de Texto


OPO

6.5.2.

Zonas

DESCRIO
Lista todas as Zonas definidas e permite sua edio.

Adicionar

Adiciona uma nova Zona na lista.

Deletar

Remove da lista a Zona selecionada.

Auto Ajuste

Ajusta o intervalo das Zonas automaticamente.

Messagem

Texto associado a zona selecionada. Esta mensagem


ser mostrada quando o valor do Tag associado ao
objeto Texto estiver dentro da zona.

Alinhamento

Define o alinhamento dos caracteres para o objeto


Texto.

Transparente

Define que o fundo do objeto ser transparente.

Zona padro

Define a Zona selecionada como zona padro


(default), ou seja, uma zona que contm todos os
valores que no esto definidos em outras zonas.

Pisca

Habilita o pisca-pisca para a zona. Uma vez ativa e


definida como Pisca a zona alterna com a zona
default conforme o tempo em Piscar a cada.

Piscar a cada

Define o tempo para o pisca-pisca entre as zonas


Blinking e a default.

Dica

Permite configurar uma dica (tip) para cada zona. Se


a zona no possui uma dica, o sistema utiliza a
descrio do objeto.

Minimo

Define um valor mnimo para a Zona selecionada.

Maximo

Define um valor mximo para a Zona selecionada.

Fundo

Define a cor de fundo do Texto.

Fonte

Define fonte, cor e tamanho para o texto da


mensagem.

Display

O objeto Display usado para mostrar os valores dos tags em tempo real.
As propriedades do display permitem definir o tamanho, cor, fonte, alinhamento,
efeitos 3D e outras caractersticas. Voc pode editar as propriedades do display
dando um duplo clique sobre o mesmo.

Figura 43: Display

78

Objetos de Tela

Manual do Usurio

Propriedades Gerais do Display

Figura 44: Propriedades Gerais do Display

Propriedades Gerais do Display


OPO

Objetos de Tela

Nome

DESCRIO
Define o nome do display que ser usado na rvore
do Organizer e nos scripts.

Descrio

Uma breve descrio sobre o display.

Alinhamento

Define o alinhamento dos caracteres para o display.

Fonte

Define a fonte, cor e tamanho do texto do display.

Fundo

Define a cor de fundo do display.

Mltiplas linhas

Define o display como tendo mltiplas linhas.


Somente disponvel se o formato do setpoint (pgina
de formato) string.

79

Manual do Usurio

Formato do Display

Figura 45: Propriedades de Formato do Display

Propriedades do Formato do Display


OPO

80

Texto

DESCRIO
Mostra o valor do Tag em formato string.

Numrico

Mostra o valor do Tag em formato numrico.

Tamanho

Define o nmero de dgitos a serem mostrados


incluindo o ponto decimal.

Preciso

Define quantos dgitos do tamanho sero decimais.

Prefixo

Adiciona um prefixo tipo string ao valor mostrado.

Sufixo

Adiciona um sufixo tipo string ao valor mostrado.

Objetos de Tela

Manual do Usurio

6.5.3.

Browser

O objeto Browser permite visualizar seus arquivos de bancos de dados. Estes


arquivos devem estar no formato Elipse SCADA, ou seja, devem ter sido criados
pelo Elipse. Para localizar estes arquivos voc deve procurar pelas extenses .DAT
(Histricos ou Alarmes) ou .HDR (Batelada). Voc pode editar as propriedades do
browser dando um duplo-clique sobre o mesmo.

Figura 46: Browser

Propriedades Gerais do Browser

Figura 47: Propriedades Gerais do Browser

Objetos de Tela

81

Manual do Usurio

Propriedades Gerais do Browser


OPO
Nome

DESCRIO
Define o nome do Browser que ser usado na rvore
do Organizer e nos Scripts.

Descrio

Uma breve descrio sobre o Browser.

Fontes

Define a fonte, cor e tamanho do texto a ser mostrado


no Browser.

Ordem

Define a ordem (ascendente ou descendente) dos


registros do Browser.

Ttulo de fundo

Define a cor de fundo para o ttulo do Browser.

Texto doTtulo

Define a cor do texto para o ttulo do Browser.

Fundo das linhas

Define a cor de fundo das linhas de texto do Browser.

Texto das linhas

Define a cor do texto das linhas do Browser.

Fundo selecionado

Define a cor de fundo para as linhas selecionadas do


Browser.

Texto selecionado

Define a cor do texto para as linhas selecionadas do


Browser.

Grades

Define a cor da grade do Browser.

Fundo

Define a cor da rea externa do Browser.

Configuraes do Browser

Figura 48: Configuraes do Browser

82

Objetos de Tela

Manual do Usurio

Propriedades das Configuraes do Browser

Objetos de Tela

OPO
Arquivo Fonte

DESCRIO
Define o nome do arquivo a ser mostrado no objeto
Browser. Este arquivo deve ter extenso DAT ou
HDR.

Browser

Permite localizar o arquivo fonte a ser usado pelo


Browser.

Todas as Bateladas

Seleciona todas as bateladas para serem impressas.


Esta opo est disponvel somente se o arquivo fonte
(Source Filename) um arquivo de Histrico com
processo de batelada habilitado.

ltimas bateladas

Seleciona a ltima batelada para ser impressa. Esta


opo est disponvel somente se o arquivo fonte
(Source Filename) um arquivo de Histrico com
processo de batelada habilitado.

Batelada Especfica

Seleciona uma batelada especfica para ser impressa,


conforme o especificado nos campos Campo (Field)
e Critrio (Criteria). Esta opo est disponvel
somente se o arquivo fonte (Source Filename) um
arquivo de Histrico com processo de batelada
habilitado.

Campos

Lista os campos disponveis para seleo de uma


batelada especfica. Somente campos tipo string sero
listados.

Valor

Define o valor a ser buscado quando selecionada uma


batelada especfica.

83

Manual do Usurio

Consulta do Browser

Propriedades da Consulta do Browser

84

OPO
Sem consulta por data

DESCRIO
No ser usado filtro, ou seja, seleciona todos os
dados.

Intervalo de tempo

Seleciona os dados dentro de um intervalo de tempo


especificado.

Dados mais recentes

Seleciona apenas os dados mais novos.

Data Inicial

Determina a data inicial do intervalo de tempo.

Data Final

Determina a data final do intervalo de tempo.

Hora Inicial

Determina o horrio inicial do intervalo de tempo.

Hora Final

Determina o horrio final do intervalo de tempo.

ltimo

Define o nmero de unidades para selecionar os


dados mais recentes.

Unidade

Define a unidade usada para selecionar os dados mais


recentes.

Objetos de Tela

Manual do Usurio

Banco de Dados do Browser

Figura 49: Propriedades do Banco de Dados do Browser

Objetos de Tela

85

Manual do Usurio

Propriedades do Banco de Dados do Browser


OPO
Campos

DESCRIO
Lista os campos disponveis.

Para Cima

Move o campo selecionado uma posio para cima.

Para Baixo

Move o campo selecionado uma posio para baixo.

Habilita

Permite que o campo selecionado seja impresso.

Atualiza estrutura do
arquivo

Recarrega a lista de campos atual do arquivo nos


campos do browser. Quando feita alguma
modificao na estrutura do arquivo usado pelo
browser este boto deve ser pressionado para
atualizao dos campos.

Tamanho

Define o nmero de dgitos a serem mostrados


incluindo o ponto decimal.

Preciso

Define quantos dgitos do tamanho sero decimais.

Prefixo

Adiciona um prefixo tipo string ao valor mostrado.

Suffixo

Adiciona um sufixo tipo string ao valor mostrado.

Formato de data

Define o formato da marcao de tempo (timestamp)


do browser.

Etiqueta

Permite trocar o nome do campo selecionado.

Linhas

Define o nmero de linhas que o campo selecionado


ir ter no browser.

Scripts do Browser
Os eventos disponveis para Scripts exclusivos do Browser so descritos na tabela
abaixo. Maiores detalhes a respeito do uso de Scripts veja no captulo especfico.
Scripts Disponveis
Voc pode associar scripts a tags executando-os em uma das situaes a seguir:
EVENTOS
OnDrawRow

86

DESCRIO
Executado logo antes de cada linha do Browser ser
desenhada. Permite que a cor de fundo e do texto da
linha sejam modificadas atravs das funes
SetTempRowColor() e SetTempRowTextColor(),
de acordo com o valor dos campos da linha (este
valor pode ser pego com a funo GetField()).

Objetos de Tela

Manual do Usurio

6.5.4.

Bitmap

O objeto Bitmap permite inserir imagens, figuras ou desenhos nas suas telas de sua
aplicao, desde que estejam nos formatos BMP, GIF ou JPEG. Este objeto pode ser
redimensionado para ter o mesmo tamanho da figura e possui suporte a
transparncia, bastando habilitar e selecionar uma cor. Voc pode editar as
propriedades do Bitmap dando um duplo clique sobre o mesmo.

Figura 50: Bitmap

Nota: No Elipse SCADA CE, apenas o formato .BMP est disponvel.


Propriedades Gerais do Bitmap

Objetos de Tela

87

Manual do Usurio

Propriedades Gerais do Bitmap


OPO

6.5.5.

Nome

DESCRIO
Define o nome do Bitmap que ser usado na rvore
do Organizer e nos Scripts.

Descrio

Uma breve descrio sobre o Bitmap.

Nome do Bitmap

Define o nome do arquivo correspondente.

Localizar

Permite indicar a localizao do arquivo a ser usado.

Transparente

Determina que a cor epecificada em Fundo seja


transparente.

Fundo

Define a cor de fundo do Bitmap.

Tamanho Original

Ajusta o objeto Bitmap de forma que ele tenha o


mesmo tamanho da figura original.

Animao

O objeto Animao um meio fcil de criar uma animao usando imagens


(bitmaps) associados a quadros (frames) definidos pelo usurio que so mostrados
em sequncia. Um Tag deve ser associado animao de forma que o valor do Tag
determine qual o quadro da animao que ser mostrado. Os valores do Tag so
associados a Zonas, que correspondem a um determinado quadro.
possvel usar imagens de quaisquer tamanho e cores, desde que sejam arquivos
nos formatos suportados: GIF, JPEG e Bitmap (.BMP). Voc pode editar as
propriedades da Animao dando um duplo clique sobre o objeto.

Figura 51: Animao

Nota: No Elipse SCADA CE, apenas o formato .BMP est disponvel.

88

Objetos de Tela

Manual do Usurio

Propriedades Gerais da Animao

Figura 52: Propriedades Gerais da Animao

Propriedades Gerais da Animao


OPO

Objetos de Tela

Nome

DESCRIO
Define o nome da animao.

Descrio

Uma breve descrio sobre o objeto.

Transparente

Define que a cor especificada na opo Fundo ser


transparente, permitindo que o fundo da tela aparea.

Borda

Habilita uma borda (linha preta) ao redor dos


quadros.

Fundo

Define uma cor de fundo para a animao.

Piscar a cada

Tempo em milisegundos para o pisca-pisca entre as


zonas Pisca e Padro.

Ajustar imagem

Ajusta o objeto animao de forma que ele tenha o


mesmo tamanho do primeiro quadro da animao.

89

Manual do Usurio

Zonas da Animao

Figura 53: Propriedades da Zona de Animao

90

Objetos de Tela

Manual do Usurio

Propriedades da Zona de Animao

Objetos de Tela

OPO
Bitmap

DESCRIO
Lista os bitmaps dos quadros da animao. Selecione um
dos bitmaps para ver e editar suas propriedades.

Localizao

Mostra o caminho dos bitmaps.

Adicionar

Usado para adicionar um bitmap ou um grupo de bitmaps


lista.

Deletar

Remove um bitmap ou um grupo de bitmaps da lista.

Auto ajuste...

Ajusta automaticamente as zonas dividindo o total do


intervalo igualmente entre as zonas definidas.

Alterar Localizao

Usado para trocar a localizao (path) do bitmap.

Zona Padro

Define o quadro selecionado na lista como padro; desta


forma, ele ser mostrado quando o valor do tag estiver fora
das outras zonas definidas.

Minimo

Define um valor mnimo para a zona selecionada.

Maximo

Define um valor mximo para a zona selecionada.

Pisca

Indica que essa zona ser utilizada no pisca-pisca.

Dica

Permite configurar uma dica (tip) para cada zona. Se a zona


no possui uma dica habilitada ento utilizada a descrio
do objeto.

Preview

Mostra uma prvia do quadro selecionado.

91

Manual do Usurio

6.5.6.

AVI

O objeto AVI utilizado para visualizao de arquivos de extenso AVI no sistema.


Atravs deste objeto, possvel localizar arquivo AVI no sistema e mostr-lo na tela
no momento da execuo do projeto. Este objeto aceita somente arquivos AVI.

Figura 54: AVI

Propriedades Gerais do AVI

Figura 55: Propriedades Gerais do AVI

Propriedades Gerais do AVI


OPO

92

Nome

DESCRIO
Define o nome do objeto no sistema.

Descrio

Uma breve descrio sobre o video.

Arquivo AVI

Mostra o caminho do arquivo AVI no sistema.

Localizar...

Permite navegar nos diretrios para localizar o


arquivo AVI.

Objetos de Tela

Manual do Usurio

6.5.7.

Video

O objeto Video utilizado para visualizao de uma imagem de video. Atravs


desta opo, possvel visualizar arquivos do sistema ou criados a partir da opo
Watcher.
Propriedades Gerais do Video

Figura 56: Propriedades Gerais do Video

Propriedades Gerais do Video


OPO

Objetos de Tela

Nome

DESCRIO
Define o nome do objeto no sistema.

Descrio

Uma breve descrio sobre o video.

Fonte do Video

Determina a fonte que o video ir utilizar para a


visualizao do objeto.

Play automtico ao abrir a


tela
Ajustar video ao tamanho
do objeto

Habilita a visualizao do video no momento da


execuo do objeto.
Habilita o ajuste do video conforme o tamanho do
objeto.

93

Manual do Usurio

6.5.8.

Preview

O objeto Preview utilizado para visualizao de arquivos de video que foram


gerados atravs da placa XPressPlayer. Atravs deste objeto, possvel configur-lo
na placa XPressPlayer para conectar-se a cmera determinada ou indicar o arquivo
XPressPlayer. A visualizao do objeto ser mostrada na execuo do projeto.

Figura 57: Preview

Propriedades Gerais do Preview

Figura 58: Propriedades Gerais do Preview

94

Objetos de Tela

Manual do Usurio

Propriedades Gerais do Preview


OPO

6.5.9.

Nome

DESCRIO
Define o nome do objeto no sistema.

Descrio

Uma breve descrio sobre o video.

Placa XPressPlus

Indica o objeto do XPressPlus do Watcher a ser


associado ao objeto Preview.

Nmero da cmera

Indica o nmero da cmera que ser conectada ao


objeto.

Tamanho da Janela

Indica o tamanho da janela para a visualizao do


objeto.

Arquivo de video

Mostra o caminho do arquivo de video no sistema.

Auto Ajuste

Ajusta automaticamente a janela de visualizao


conforme as especificaes da opo Tamanho da
Janela.

Habilitar tela cheia

Habilita a visualizao em "tela cheia".

Tendncia

Este objeto usado para visualizar um grfico de tendncia com at 16 tags. O


grfico constantemente atualizado a medida que o processo evolui e os valores dos
tags mudam.
Usando tendncias, voc pode fazer grficos como Valor x Tempo e Valor x Valor.
Devido a estas caractersticas pode-se efetuar a anlise dos dados a medida que o
processo evolui.
O objeto Tendncia possui vrios aspectos que podem ser modificados atravs de
vrias pginas de propriedades, que sero vistas a seguir.

Figura 59: Tendncia

Objetos de Tela

95

Manual do Usurio

Propriedades Gerais da Tendncia

Figura 60: Propriedades Gerais da Tendncia

96

Objetos de Tela

Manual do Usurio

Propriedades Gerais da Tendncia


OPO

Objetos de Tela

Nome

DESCRIO
Define o nome para identificao do objeto
Tendncia.

Descrio

Uma breve descrio sobre a Tendncia.

XY

Habilita um grfico em tempo real em funo de duas


variveis, uma em cada eixo de coordenadas. As
variveis podem ser agrupadas aos pares, de forma
que um objeto possa mostrar vrias funes XY.

Tempo x Dado

Define um grfico de dados em funo do tempo.

Mostrar labels

Mostra uma legenda com o significado para cada


pena da Tendncia.

Novo dado aparecer

Define de onde viro os novos dados da Tendncia.

Intervalo de

Define o intervalo total de tempo para amostragem do


grfico (em segundos). Esta opo desabilitada se a
Tendncia histrica.

Atualizar tendncia a cada

Define o intervalo de tempo entre cada atualizao do


grfico. Esta opo desabilitada se a Tendncia
histrica.

Tamanho do Buffer

Define o nmero de pontos (de 1 a 1.000.000) que a


tendncia ir armazenar para cada pena (cada ponto
ocupa 20 bytes). Esta opo desabilitada se a
Tendncia histrica.

Adicionar Marca

Adiciona uma linha horizontal, uma linha vertical ou


um ponto para referncia no grfico da Tendncia.

97

Manual do Usurio

Propriedades Avanadas da Tendncia

Figura 61: Propriedades Avanadas da Tendncia

Propriedades Avanadas da Tendncia


OPO
Tempo real, somente
quando a tendncia est
no topo
Tempo real, coleta de
dados quando a tela est
no fundo
Carregar dados do
histrico em disco
Configurar consulta

98

DESCRIO
Atualiza os valores da Tendncia em tempo real
somente se a Tendncia est visvel.
Atualiza os valores da tendncia em tempo real
mesmo quando a Tendncia no est visvel.
Atualiza a Tendncia carregando dados de um
Histrico selecionado.
Abre uma janela que permite configurar a Consulta
da Tendncia Histrica.

Objetos de Tela

Manual do Usurio

Propriedades do Grfico de Tendncia

Figura 62: Propriedades da Tendncia

Objetos de Tela

99

Manual do Usurio

Propriedades para os Eixos X e Y


OPO
(Escala)

DESCRIO
A primeira caixa de seleo indica o tipo de escala a
ser usado no eixo, a saber: escala normal, escala
logartmica ou fator de potncia.

Limite

Define o limite esquerdo do eixo X no grfico. Esta


opo est disponvel somente se o grfico do tipo
XY.

Limite direito

Define o limite direito do eixo X no grfico. Esta


opo est disponvel somente se o grfico do tipo
XY.

Exibir rgua superior

Exibe uma rgua no topo do grfico, com os valores


do eixo X.

Exibir rgua inferior

Exibe uma rgua na base no grfico, com os valores


do eixo X.

Limite superior

Define o limite superior do eixo Y no grfico.

Limite inferior

Define o limite inferior do eixo Y no grfico.

Exibir rgua a esquerda

Exibe uma rgua esquerda do grfico, com os


valores do eixo Y.

Exibir rgua a direita

Exibe uma rgua direita do grfico, onde os valores


do eixo Y.

Grade Rolante

Faz com que a grade do grfico acompanhe o


movimento gerado pela entrada dos dados na
Tendncia.

Texto

Permite colocar uma legenda para os eixos X e Y.

Formato Data/Hora

Premite definir o formato de data e hora, para


Tendncias do tipo Valor x Tempo.

Propriedades de Cores do Grfico


OPO
Fundo da rgua

DESCRIO
Define a cor de fundo para as rguas do grfico.

Texto da rgua

Define a cor para o texto que ser mostrado nas


rguas.

Fundo do grfico

Define a cor de fundo para o grfico.

Grades e eixos

Define a cor da grade e dos eixos do grfico.


Propriedades da Grade do Grfico

OPO

100

Grade

DESCRIO
Habilita a grade no grfico (linhas de orientao ).

Linhas de X

Define o nmero de linhas horizontais da grade.

Linhas de Y

Define o nmero de linhas verticais da grade.

Fonte da rgua

Define fonte, tamanho e cor para os caracteres do


grfico.
Objetos de Tela

Manual do Usurio

Cores das Penas da Tendncia

Figura 63: Propriedades das Cores das Penas da Tendncia

Propriedades das Cores das Penas da Tendncia


OPO

DESCRIO
Insere uma pena associada a um tag.
Insere uma pena associada a um campo do histrico (a opo
Carrega Dados do Histrico do Disco deve estar habilitada na aba
Avanado).
Insere uma marca indicativa no grfico.
Apaga uma pena ou uma marca selecionada na lista.
Define que o desenho da pena ser do tipo Linha.
Os estilos de desenho de pena suportados pelo CE so apenas o
slido e o tracejado. Caso um estilo no suportado for solicitado pela
aplicao, ser utilizado o estilo slido.
Define que o desenho da pena ser do tipo rea.
Define que o desenho da pena ser do tipo Barra.
Muda a ordem da pena selecionada.

Objetos de Tela

101

Manual do Usurio

Label

Essa coluna lista as penas selecionadas para o grfico. Permite mudar


o texto da legenda e ativar/desativar cada pena.

Y Axis

Seleciona o tag a ser visualizado no eixo Y.

X Axis

Seleciona o tag a ser visualizado no eixo X.


Mostra o quadro Cores das Penas.

6.5.10. Grfico de Barras


O Grfico de Barras utilizado quando se deseja visualizar os dados na forma de
volume. Editando as propriedades do grfico podem ser definidas uma srie de
caractersticas como escala grfica, orientao das barras (vertical/horizontal),
rguas e cores.
Cada tag associado ao Grfico de Barras representado por uma barra com uma cor
especfica, podendo ser mostradas at um mximo de 16 barras (ou seja, 16 tags). O
objeto possui ainda um segundo modo, o Bar Gauge. Nesse modo, os valores dos
tags so indicados por uma agulha que percorre uma escala disposta sobre cada
barra.
Voc pode editar as propriedades do Grfico de Barras dando um duplo clique sobre
o mesmo. Nas propriedades do Grfico de Barras temos vrias pginas (abas ou
tabs) para a sua configurao.

Figura 64: Grfico de barras

102

Objetos de Tela

Manual do Usurio

Propriedades Gerais do Grfico de Barras

Figura 65: Propriedades Gerais do Grfico de Barras

Objetos de Tela

103

Manual do Usurio

Propriedades Gerais do Grfico de Barras


OPO
Nome

DESCRIO
Define o nome do objeto, que ser usado na rvore do
Organizer e nos Scripts.

Descrio

Uma breve descrio sobre o grfico.

Tipo

Define qual o tipo de grfico de barras: Barra


(simples) ou Bar Gauge (medidor em barra).

Limite

Define os valores mnimo e mximo para o Grfico


de Barras.

Orientao

Define a orientao do Grfico. As opes


disponveis so de baixo para cima, de cima para
baixo, da esquerda para a direita, da direita para a
esquerda.

Fundo

Define uma cor de fundo para o Grfico de Barras.

Bipolar

Determina que as barras do grfico tenham dois lados


divididos por um centro. As barras crescem do centro
em direo aos limites do grfico.

Centro

Define o centro para um Grfico de Barras bipolares.

Espaamento

Define o espao entre as barras, em pixels.

3D

Habilita ou desabilita um efeito tridimensional nas


barras do grfico. Voc tambm pode definir a
largura do efeito 3D.

Propriedades da Rgua

Figura 66: Propriedades da Rgua

104

Objetos de Tela

Manual do Usurio

Propriedades da Rgua
OPO

DESCRIO
Permite que uma rgua seja mostrada no Grfico de
Barras.

Habilita
Exibir rgua superior

Exibe uma rgua superior no Grfico de Barras, onde


so mostrados os valores dos Tags.

Exibir rgua inferior

Exibe uma rgua inferior no Grfico de Barras, onde


so mostrados os valores dos Tags.

Exibir rgua a esquerda

Exibe uma rgua a esquerda do Grfico de Barras,


onde so mostrados os valores dos Tags.

Exibir rgua a direita

Exibe uma rgua a direita do Grfico de Barras, onde


so mostrados os valores dos Tags.

Texto da unidade

Unidade a ser mostrada na rgua do Grfico de


Barras.

Divises da rgua

Define o nmero de divises da rgua.

Cores

Define as cores do fundo da rgua, do texto e da


grade (divises).

Fonte da rgua

Define fonte, tamanho e cor para os caracteres na


rgua do Grfico de Barras.

Cores da Barra
Esta aba permite habilitar legendas que ficaro ao lado do desenho das barras no
grfico. Isso feito marcando o quadro Mostrar labels. Cada nmero indica a barra
do grfico, sua respectiva legenda e cor.

Figura 67: Propriedades das Barras

Objetos de Tela

105

Manual do Usurio

Cores do Bar Gauge


Esta pgina permite ajustar as propriedades do Bar Gauge. Ela s est disponvel
quando a opo Bar Gauge especificada na pgina de propriedades gerais do
grfico.

Figura 68: Definio das cores do Bar Gauge

Propriedades do Bar Gauge


OPO
Tag

106

DESCRIO
Permite escolher qual a barra que ser editada.

Limite LOLO

Habilita a indicao da faixa de valor baixo crtico na


barra. Especifica a cor da faixa e o valor limite.

Limite baixo

Habilita a indicao da faixa de valor baixo na barra.


Especifica a cor da faixa e o valor limite.

Limite Normal

Especifica a cor da faixa de valores considerados


normais para o tag.

Limite alto

Habilita a indicao da faixa de valor alto na barra.


Especifica a cor da faixa e o valor limite.

Limite HIHI

Habilita a indicao da faixa de valor alto crtico na


barra. Especifica a cor da faixa e o valor limite.

Tamanho da marca

Define o tamanho da agulha que far a indicao do


valor do tag.

Objetos de Tela

Manual do Usurio

6.5.11. Gauge
O objeto Gauge bastante til para mostrar variveis com resultados analgicos,
funcionando como um medidor contnuo. Os valores de escala e as propriedades do
gauge podem ser definidos pelo usurio, alm de sua posio na tela que pode variar
em 0, 90, 180 ou 270 graus de rotao. Voc pode editar as propriedades do Gauge
dando um duplo clique sobre o mesmo.

Figura 69: Gauge

Propriedades Gerais do Gauge

Figura 70: Propriedades do Gauge

Objetos de Tela

107

Manual do Usurio

Propriedades Gerais do Gauge


OPO
Nome

DESCRIO
Define o nome do Gauge.

Descrio

Uma breve descrio sobre o Gauge.

Valor mnimo

Define o valor mnimo para o Gauge.

Valor mximo

Define o valor mximo para o Gauge.

Cor da moldura

Define a cor de fundo do Gauge.

Cor do fundo

Define a cor do Gauge.

Cor do texto

Define uma cor para os nmeros de escala do Gauge.

Cor da agulha

Define a cor do ponteiro do Gauge.

Posio

Define a posio do Gauge (0, 90, 180 e 270).

Mostrar limites

Mostra os nmeros-limite da escala do Gauge.

Mostrar valor

Mostra o valor nominal indicado no Gauge.

Casas decimais

Define o nmero de casas decimais para o valor nominal


do Gauge.

Total ticks

Define o nmero de divises na escala grfica usada no


Gauge.

ngulo inicial

Define o ngulo inicial para a agulha do Gauge.

Fontes

Define fonte, cor e tamanho para o texto do Gauge.

Usar ponteiro grosso

Define uma agulha mais grossa para o Gauge.

Propriedades Avanadas do Gauge

Figura 71: Propriedades Avanadas do Gauge

108

Objetos de Tela

Manual do Usurio

Propriedades Avanadas do Gauge


OPO
Mostrar marcas

DESCRIO
Exibe as marcas principais no objeto Gauge.

Marcas grossas

Determina que as marcas principais sejam grossas.

Mostrar sub-marcas

Exibe sub marcas no objeto Gauge.

Total

Define o nmero total de sub-marcas a serem


exibidas entre as marcas principais.

Mostrar valores

Exibe os valores numricos no objeto Gauge.

Mostrar bullets

Mostra as marcas em forma de bullets.

Fonte

Permite definir a fonte dos valores do Gauge.

Mostrar legenda

Exibe uma barra ao longo do Gauge onde podem ser


configuradas diferentes cores dependendo da faixa de
valores.

Mostrar moldura

Mostra um frame ao longo do percurso da agulha.

Limite alto

Define a altura da borda superior da legenda.

Limite baixo

Define a altura da borda inferior da legenda.

Cores

Define os valores e cores para os limites: LowLow,


Low, Normal, High e HighHigh a serem mostrados
na legenda.

6.6. Objetos de Interao


6.6.1.

Slider

Este objeto usado para ler ou escrever valores em um Tag selecionado. Voc pode
atribuir valores ao Tag selecionado deslizando o potencimetro (boto deslizante) ou
usando as setas de direo nas extremidades do Slider. O valor vai variar conforme
uma escala definida no objeto. Voc pode editar as propriedades do Slider dando um
duplo clique sobre o mesmo.

Figura 72: Slider

Objetos de Tela

109

Manual do Usurio

Propriedades Gerais do Slider

Figura 73: Propriedades Gerais do Slider

110

Objetos de Tela

Manual do Usurio

Propriedades Gerais do Slider


OPO

6.6.2.

Nome

DESCRIO
Define o nome do Slider.

Descrio

Uma breve descrio sobre o Slider.

Valor Mnimo

Define o valor mnimo para o Slider.

Valor Mximo

Define o valor mximo para o Slider.

Passo

Define o passo de variao do valor do Slider (Tag


associado) quando as setas de direo so pressionadas.

Fundo

Define a cor de fundo do Slider.

Cor do texto

Define a cor dos nmeros que sero mostrados no Slider.

Fontes

Permite configurar as fontes utilizadas no slider.

Limite do Slider

Habilita ou desabilita que os limites (mximos e mnimos)


do Slider sejam mostrados no objeto.

Mostrar valor

Habilita ou dasabilita que os valores do Slider sejam


mostrados.

Mostrar setas

Habilita ou dasabilita que as setas do Slider sejam


mostradas.

Posio vertical

Posiciona o Slider verticalmente.

Posio horizontal

Posiciona o Slider horizontalmente.

Mover

Permite a atualizao do valor do Slider mesmo quando o


boto est sendo movido.

Soltar

Atualiza o valor do Slider somente quando o boto


deslizante solto.

Preciso

Define o nmero de dgitos decimais a serem mostrados no


Slider.

Tamanho do boto

Modifica o tamanho do boto deslizante do Slider.

Boto

Este objeto utilizado para acionamentos ou execues de tarefas especificadas pelo


usurio atravs do mouse ou teclado e seu funcionamento igual aos dos botes
standard do Windows. O Elipse SCADA possui uma srie de modelos de boto entre
interruptores, chaves e outros, para facilitar a implementao de vrias funes
atravs de botes. O pressionamento de botes tambm gera eventos que podem ser
tratados por Scripts. Os botes so bastante flexveis e podem ser amplamente
configurados atravs das pginas de propriedades.

Figura 74: Boto

Objetos de Tela

111

Manual do Usurio

Propriedades Gerais do Boto

Figura 75: Propriedades do Boto

112

Objetos de Tela

Manual do Usurio

Propriedades do Boto
OPO
Nome

DESCRIO
Define o nome do Boto que ser usado na rvore do
Organizer e nos Scripts.

Descrio

Uma breve descrio sobre o Boto.

Momentneo

Este tipo de boto funciona como um boto de OK de


uma caixa de dilogo e usado para atribuir um valor
ao Tag associado ou trocar entre telas.

Liga/Desliga

Este tipo de boto funciona como um chave. Ele


possui dois estados (ligado e desligado) que podem
ser definidos na pgina Mensagens.

Jog

Este boto alterna entre dois valores: um quando est


pressionado e outro quando solto. Ele funciona
como o boto de reset do computador.

Botes

Conjunto de modelos que definem a aparncia do


boto. Esto disponveis chaves, interruptores e
bitmaps, alm de um quadro transparente que permite
transformar em um boto qualquer objeto sob ele.

Teclas de funo

Associa uma tecla de funo ao boto.

Ir para a tela

Define uma tela para ser chamada quando o boto


pressionado.

Mensagem do Boto

Figura 76: Propriedades das Mensagens do Boto

Objetos de Tela

113

Manual do Usurio

Propriedades da Mensagem do Boto Estado Normal


OPO
Texto

DESCRIO
Define um texto a ser mostrado no boto quando ele
est despressionado.

Fonte do texto

Define a cor, tamanho e tipo da fonte do texto quando


o boto est despressionado.

Fundo

Define uma cor de fundo para o boto quando ele est


despressionado.

Valor

Define o valor a ser atribudo ao tag associado,


quando o boto est despressionado.

Propriedades da Mensagem do Boto Estado Pressionado


OPO
Texto

DESCRIO
Define um texto a ser mostrado no boto quando ele
est pressionado.

Fonte do texto

Define a cor, tamanho e tipo da fonte do texto quando


o boto est pressionado.

Fundo

Define uma cor de fundo para o boto quando ele est


pressionado.

Valor

Define o valor a ser atribudo ao Tag associado,


quando o boto est pressionado.

Alinhamento

Alinha o texto do boto esquerda, ao centro ou


direita.

Scripts de Botes
Os scripts disponveis exclusivamente para botes so descritos na tabela abaixo.
Maiores detalhes a respeito do uso de scripts veja no captulo especfico.
Scripts Disponveis
Voc pode associar scripts a botes executando-os em uma das situaes a seguir:

114

EVENTOS
OnPress

DESCRIO
Executa o script quando o boto pressionado.

OnRelease

Executa o script quando o boto solto.

WhilePressed

Executa o script enquanto o boto est sendo


pressionado, conforme o ciclo (em ms) definido.

Objetos de Tela

Manual do Usurio

6.6.3.

Setpoint

O objeto Setpoint trabalha como uma caixa de edio do Windows, assim basta
digitar um valor e pressionar [Enter] para atribuir este valor ao tag associado. As
propriedades do setpoint permitem que voc defina o tipo do valor de entrada, a
fonte, tamanho e cor dos caracteres que sero mostrados no objeto. Voc pode editar
as propriedades do Setpoint dando um duplo clique sobre o mesmo.

Figura 77: Setpoint

Propriedades Gerais do Setpoint

Figura 78: Propriedades Gerais do Setpoint

Objetos de Tela

115

Manual do Usurio

Propriedades Gerais do Setpoint


OPO
Nome

DESCRIO
Define o nome do Setpoint que ser usado na rvore
do Organizer e nos Scripts.

Descrio

Uma breve descrio sobre o Setpoint.

Alinhamento

Define o alinhamento dos caracteres do Setpoint.

No CE, o alinhamento vertical sempre


centralizado.
Fundo

Define uma cor de fundo para o Setpoint.

Limites

Define os limites para os dados de entrada do


Setpoint.

Fontes

Define a fonte, cor e tamanho do texto do Setpoint.

Atualizar

Atualiza o valor do Setpoint sempre que o valor do


Tag mudar.

Linhas mltiplas

Define o Setpoint como tendo mltiplas linhas.


Somente disponvel se o formato do Setpoint (pgina
de Formato) texto.

Seleciona tudo ao ganhar


foco

Seleciona todos os caracteres do Setpoint quando ele


recebe o foco.

Formato do Setpoint

116

Objetos de Tela

Manual do Usurio

Figura 79: Propriedades do Formato do Setpoint

Objetos de Tela

117

Manual do Usurio

Propriedades do Formato do Setpoint


OPO
Texto

DESCRIO
Mostra o valor do Setpoint em formato string.

Numerico

Mostra o valor do Setpoint em formato numrico.

Tamanho

Define o nmero de dgitos a serem mostrados


incluindo o ponto decimal.
Mostra o valor do Setpoint em formato data e hora.

Data/Hora
Formato

Permite definir um string que descreve o formato data


e hora.

Prefixo

Adiciona um prefixo tipo string ao valor mostrado.

Sufixo

Adiciona um sufixo tipo string ao valor mostrado.

Teclas do Setpoint

Figura 80: Propriedades das Teclas do Setpoint

118

Objetos de Tela

Manual do Usurio

Propriedades das Teclas do Setpoint


OPO
Tecla de mudana de foco

DESCRIO
Permite a seleo de uma combinao de teclas ou
uma tecla para alternar o foco entre as entradas de
dados dos Objetos de Tela. Substitui a tecla [Tab]
quando o Setpoint multilinhas.

Teclas para forar valor

Permite a seleo de uma combinao de teclas ou


uma tecla para enviar os dados digitados do Setpoint
para o Tag selecionado. Substitui a tecla [Enter]
quando o Setpoint multilinhas.

Esconde keypad aps


entrada de valores

Indica que o keypad ir desaparecer depois da entrada


de valores pelo usurio.

O keypad nunca fica escondido no CE.

6.6.4.

Alarmes

O objeto Alarme permite a verificao dos alarmes ativos ou dos alarmes


registrados (logados) no arquivo de alarmes. Alarmes podem ser disparados
quando os valores dos tags associados so verificados em quatro situaes e
prioridades diferentes: LoLo (baixo crtico), Low (baixo), High (alto), HiHi (alto
crtico). Fora dessas faixas, os valores dos tags so considerados normais.

Figura 81: Janela do objeto Alarme

Na janela de alarmes, encontramos uma barra de ferramentas que permite algumas


funes, a saber:
Reconhece os alarmes selecionados com o mouse
Lista os alarmes pela data
Lista os alarmes pelo nome, usando a data como chave secundria

Objetos de Tela

119

Manual do Usurio

Lista os alarmes por prioridade (iniciando pela prioridade 1), usando a data
como chave secundria

Propriedades Gerais dos Alarmes


As propriedades dos alarmes permitem definir o formato da data, hora e mensagens,
bem como as cores para cada situao de alarme. Voc pode editar as propriedades
dando um duplo clique sobre o objeto Alarmes.

Figura 82: Propriedades Gerais dos Alarmes

Propriedades Gerais dos Alarmes


OPO

120

Nome

DESCRIO
Define o nome do objeto Alarmes.

Descrio

Uma breve descrio sobre o objeto Alarmes.

Objetos de Tela

Manual do Usurio

OPO
Tipo de alarme

DESCRIO
Resumido: mostra os alarmes ativos, ou seja, Tags
que esto em situao de alarme no momento.
Histrico: mostra os alarmes que esto registrados no
arquivo de alarmes. Obs: a opo Habilita Reg. no
objeto Alarmes no Organizar deve estar habilitada.

Objetos de Tela

Da Prioridade

Define a prioridade mais alta de alarmes a serem


mostrados no objeto.

Para Prioridade

Define a prioridade mais baixa de alarmes a serem


mostrados no objeto.

Barra de Ferramentas

Mostra ou esconde a barra de ferramentas do objeto


Alarme.

Titulos

Habilita uma barra de ttulo no objeto Alarme,


mostrando uma linha de cabealho com selecionados
na pgina Formato da Mensagem.

Botes grandes

Habilita botes grandes na barra de ferramentas do


objeto de Alarmes.

Grupo de alarmes

Seleciona o grupo de alarmes que ser mostrado no


objeto de Alarmes corrente.

121

Manual do Usurio

Cores dos Alarmes

Figura 83: Propriedades das Cores do Alarme

122

Objetos de Tela

Manual do Usurio

Propriedades das Cores do Alarme


OPO
Janela

DESCRIO
Cor de fundo da janela de alarmes.

Alm Reconhecido

Cor para alarmes reconhecidos.

Barra

Cor da barra de ttulos das colunas.

Texto

Cor dos ttulos das colunas.

Ferramentas

Cor da barra de ferramentas.

Cor padro do alarme

Cor de fundo para os alarmes no-reconhecidos.

Zona 1

Permite definir o intervalo de prioridades para a Zona 1, cores


do texto e fundo do alarme, e se a linha deve piscar ou no.

Zona 2

Permite definir o intervalo de prioridades para a Zona 2, cores


do texto e fundo do alarme, e se a linha deve piscar ou no.

Zona 3

Permite definir o intervalo de prioridades para a Zona 3, cores


do texto e fundo do alarme, e se a linha deve piscar ou no.

Piscar a cada ... ms

Permite especificar a freqncia da alternncia de cores dos


alarmes.

Objetos de Tela

123

Manual do Usurio

Formato das Mensagens dos Alarmes

Figura 84: Propriedades das Mensagens dos Alarmes

124

Objetos de Tela

Manual do Usurio

Propriedades das Mensagens dos Alarmes


OPO

Objetos de Tela

Data

DESCRIO
Habilita a visualizao da data no objeto Alarme,
conforme o formato especificado na opo Formato.

Data/Formato

Define o formato da data a ser mostrada no objeto.

Hora

Habilita a visualizao da hora no objeto Alarme,


conforme o formato especificado na opo Formato.

Hora/Formato

Define o formato da hora a ser mostrada no objeto.

AM/PM

Habilita o formato de hora americano.

Mostrar milisegundos

Mostra os milisegundos na coluna de hora do objeto


Alarme.

Evento

Habilita a visualizao da coluna de eventos no objeto.

Tipo do alarme

Habilita a visualizao da coluna do tipo do alarme (lolo,


low, high, hihi) no objeto Alarme.

Prioridade

Habilita a visualizao da coluna de prioridades de


alarmes (lolo, low, high, hihi) no objeto Alarme.

Estado do Alarme

Habilita a visualizao da coluna de status (UnAck, Ack)


dos alarmes no objeto Alarme.

Comentrios

Habilita a visualizao dos comentrios definidos para os


Tags no objeto Alarme.

Comentrios/Tamanho

Define o tamanho dos comentrios em nmeros de


caracteres.

Valor

Habilita a visualizao da coluna de valores dos tags no


objeto Alarme. Os valores sero mostrados variando para
alarmes tipo resumidos ou fixos para alarmes tipo
histrico.

Valor/Tamanho

Define o tamanho dos valores dos tags em nmero de


caracterers.

Valor/Preciso

Define quantos dgitos do tamanho sero decimais.

Nome do tag

Habilita a visualizao da coluna de valores dos Tags no


objeto Alarme.

Nome do Tag/Tamanho

Define o tamanho do nome dos tags em nmeros de


caracteres.

Limite

Habilita a visualizao dos limites definidos para os


Alarmes conforme o seu tipo (Low, LoLo, High, HiHi)

Limite/Tamanho

Define o tamanho dos valores limites de cada alarme em


nmero de caracteres.

Limite/Preciso

Define quantos dgitos do tamanho sero decimais.

Usurio

Habilita a visualizao do nome do usurio responsvel.

Usurio/Tamanho

Define o tamanho do nome do usurio em nmeros de


caracteres.

125

Captulo

7.

Alarmes

A opo Alarmes da rvore da aplicao no Organizer permite que sejam definidas


algumas caractersticas para o gerenciamento dos Alarmes do sistema. Voc pode
especificar um arquivo para gravar todos os alarmes que iro ocorrer no seu sistema,
bem como configurar sons e mensagens de alerta.
As propriedades do Gerenciador de Alarmes afetam o comportamento de todos os
Alarmes do sistema especificados na pgina de Alarmes dos Tags.

7.1. Propriedades Gerais dos Alarmes


A pgina de Propriedades Gerais dos Alarmes aparece quando selecionada a aba
Alarmes no topo das pginas dos Alarmes. Esta pgina mostrada abaixo e seus
respectivos campos so descritos na tabela que segue.

Figura 85: Propriedades Gerais dos Alarmes

Alarmes

127

Manual do Usurio
Propriedades Gerais dos Alarmes
OPO
Verifica alarmes neste
grupo
Habilitar reg.

DESCRIO
Permite habilitar ou desabilitar a verificao de
alarmes do grupo.

Registros

Define o tamanho do arquivo de Alarmes em nmero


de registros. Cada alarme um registro que ocupa 42
bytes. O tamanho do cabealho 848 bytes
determinando o tamanho inicial do arquivo. A
atualizao deste arquivo se d de forma cclica.

Arquivo

Define o nome do arquivo de Alarmes (extenso


DAT)

Localizar

Permite localizar ou definir um diretrio para o


arquivo de Alarmes.

Tocar som de aviso

Habilita um som de alerta para os Alarmes. O som


pode ser escolhido a partir da lista embaixo.

Escrever direto em disco

Fora a escrita direta dos dados no disco, sem utilizar


buffers. Isso diminui a performance, mas aumenta
muito a segurana de dados no caso de falhas.

Envia traps SNMP para


cada alarme

(Disponvel somente nos sistemas Windows NT.) Faz


com que o sistema gere um evento (trap) SNMP a
cada nova mensagem de alarme.

Novo grupo de alarmes!

Cria um novo grupo de Alarmes. O usurio pode


escolher a que grupo de alarmes um Tag ou um
objeto de tela Alarmes est associado.

Habilita o registro (log) dos alarmes do grupo atual.

7.2. Scripts dos Alarmes


Os scripts do Gerenciador de Alarmes geralmente esto associados a uma situao
de alarme. Isto significa, por exemplo, que eles podem ser executados quando um
Alarme ocorrer.
Os scripts disponveis para os alarmes so descritos na tabela abaixo. Maiores
detalhes a respeito veja no scripts.
Scripts Disponveis
Voc pode associar scripts a alarmes executando-os em uma das situaes a seguir:
EVENTOS
DESCRIO
Executa o script na ocorrncia e retorno de um
OnAlarm
alarme.

128

Alarmes

Captulo

8.

Receitas

Uma Receita um conjunto de valores pr-definidos que podem ser carregados para
um grupo de tags a fim de configurar um processo especfico. Esta lista de tags
tambm chamamos de modelo de receita.
Por exemplo, seja uma mquina que fabrica diferentes tipos de parafusos. As
variveis envolvidas no processo so sempre as mesmas, mas seus valores
provavelmente iro mudar dependendo do tipo de parafuso que se quer produzir.
Supondo que voc tem diferentes configuraes de mquina para cada tipo de
parafuso, estes valores poderiam ser gravados em uma receita e serem
posteriormente carregados em tags de controle, facilitando a tarefa do operador e
evitando erros.
Dessa maneira, podemos criar um modelo de receita Parafuso com diversas
receitas Fenda Philips, Fenda Torx, Fenda Simples e assim por diante.
Para que sejam recuperados quando necessrio, os modelos e os dados de uma
receita so armazenados em disco, em um arquivo de receitas com a extenso
.RCP.
Voc pode definir uma receita no Organizer durante a configurao da aplicao ou
em tempo de execuo usando Funes Especiais atravs de scripts.

8.1. Propriedades Gerais da Receita


Cada receita que voc cria para a aplicao aparece abaixo da opo Receitas na
rvore do Organizer. Ao selecionar uma receita especfica, suas propriedades so
mostradas ao lado direito da rvore. A seguir, podemos ver as propriedades das
receitas.

Receitas

129

Manual do Usurio

Figura 86: Propriedades Gerais da Receita

Propriedades Gerais da Receita


OPO

130

Nome

DESCRIO
Define o nome do modelo de receita.

Descrio

Uma breve descrio sobre o modelo de receita.

Arquivo Receita

Define o nome do arquivo para o modelo de receita. O nome


do arquivo pode ter at 8 caracteres e no deve conter
extenso (o Elipse SCADA ir sempre usar a extenso RCP).
Voc pode especificar tambm o caminho do arquivo, que
poder
ser
uma
localizao
absoluta
(C:\ELIPSE\RECIPES\RCP1)
ou
relativa
(RECIPES\RCP1).
Localizaes
relativas
so
recomendadas se voc deseja copiar sua aplicao para outro
computador.

Habilita cache de escrita

Permite que seja utilizado o cache do Windows para agilizar o


processo de escrita do arquivo de receitas.

Criar arquivo de backup

Habilita a criao automtica de uma cpia de backup do


arquivo .RCP, que contm as informaes da receita. Em caso
de problemas com o arquivo principal, possvel recuperar as
informaes anteriores a partir deste backup.

Editar receita
selecionada aqui
Editar Dado

Permite a edio da etiqueta que identifica o tag selecionado


na receita.

Etiquetas

Mostra os campos associados aos tags do modelo de receita.

Tag

Mostra os tags selecionados para o modelo de receita corrente.

Abre a janela Editar Receita onde se pode acrescentar e


modificar os valores das diversas receitas.

Receitas

Manual do Usurio

8.2. Editando Receitas


Para acrescentar, editar ou apagar receitas j criadas, utilizamos a janela Editar
Receita que chamada atravs do boto Editar dado... na pgina de propriedades
de receitas. Todas as receitas criadas utilizando o modelo escolhido so listadas no
campo Receitas, onde podem ser selecionados para edio. Selecionando qualquer
receita da lista voc poder editar a sua descrio e os valores de cada tag associado.
Veremos os campos dessa janela a seguir:

Figura 87: Editando Receitas

Campos da janela Editar Receitas

Receitas

OPO
Receitas

DESCRIO
Permite a seleo de uma receita no modelo corrente.

Ttulo da Receita

Nome ou descrio da receita.

Nova Receita

Cria uma nova receita. Cada modelo de receita pode ter vrias
receitas (conjunto de valores) relacionadas.

Apaga Receita

Apaga a receita selecionada.

Copia Receita

Permite copiar uma receita j definida, a fim de tornar mais


fcil a criao de receitas com muitas variveis.

Digite aqui o novo


valor para o tag
selecionado

Permite a edio do valor do tag para a receita corrente, que


so listados no quadro inferior. Os tags so identificados por
suas etiquetas associadas. Use as setas de direo do teclado
ou o mouse para selecionar o tag a ser editado.

131

Captulo

9.

Histricos

Os Histricos permitem o armazenamento da variao dos dados de um processo ao


longo do tempo, possibilitando anlises futuras. Estes Histricos podem ser gerados
de duas maneiras diferentes: de forma Contnua ou em Bateladas (em batch).
Na forma contnua, o Elipse SCADA armazena os dados continuamente durante a
execuo da aplicao. Na forma de bateladas, o histrico feito por lotes. Nessa
modalidade, necessrio enviar um comando via script para iniciar e terminar a
gerao do histrico.

9.1. Propriedades Gerais dos Histricos


A pgina de propriedades gerais dos histricos aparecem no lado direito do
Organizer, quando clicamos no item Histrico na rvore da aplicao. Esta pgina
a que segue.

Figura 88: Propriedades Gerais dos Histricos

Histricos

133

Manual do Usurio
Propriedades Gerais dos Histricos
OPO
Nome

DESCRIO
Define o nome do objeto histrico.

Descrio

Uma breve descrio do objeto.

Anlises...

Atualizar
CEP...
Arquivo

Permite a visualizao dos dados do histrico em


forma grfica. Voc pode chamar a Anlise Histrica
em tempo de execuo, atravs da funo Analysis()
do Histrico.
Recalcula a anlise histrica e o CEP para o histrico.
Chama a tela do Controle Estatstico de Processos.
Define o nome do arquivo do histrico.

Localizar...

Permite localizar ou definir um diretrio para o


arquivo de histrico.

Tempo Escr.

Define a freqncia com que os dados sero escritos


no arquivo.

Mx. Regs.

Nmero mximo de registros a serem armazenados


no arquivo. O arquivo de histrico rotativo, ou seja,
quando os dados excederem o tamanho do arquivo,
os primeiros registros sero substitudos.

Habilita histrico por scan

Habilita a escrita no arquivo de histrico a partir do


incio da execuo da aplicao segundo a taxa de
varredura definida. Deixe esta opo desmarcada se
voc deseja controlar manualmente (usando scripts) a
gerao dos dados do histrico.

Processo de Batelada

Define o tipo do histrico como sendo por batelada


(por lotes). Quando esta opo est marcada, um
arquivo de cabealho (extenso HDR) criado com o
mesmo nome que o arquivo de histrico. O arquivo
de cabealho guarda informaes sobre cada
batelada.

Suporte a rede

Habilita o suporte a rede para o histrico, isto ,


permite que o histrico seja acessado (somente para
leitura) por outras aplicaes Elipse na rede, atravs
de um browser ou relatrio do tipo Anlise Histrica.

9.2. Anlise Histrica


Quando um Histrico criado, o Elipse SCADA automaticamente associa a ele um
objeto Anlise Histrica (HAnalysis). Este objeto possui diversas caractersticas
que podem ser ajustadas em tempo de execuo.
Ao ser chamada a Anlise Histrica, uma janela Histrico aberta em sua aplicao,
mostrando a pgina Anlises com o grfico para anlise dos dados. Esta janela
possui mais seis pginas de configurao (disponveis de acordo com a programao
134

Histricos

Manual do Usurio

da aplicao). So elas: Grfico, Penas, Cores das Penas, Configuraes, Consultas e


Impresso. Cada uma destas pginas aparece quando selecionada a sua guia
correspondente do topo da janela. Vejamos, a seguir, uma descrio da cada uma.
Anlise
A pgina de Anlise mostra o grfico da Anlise Histrica e permite a configurao
das variveis a serem mostradas no mesmo. Possui recursos de zoom, rolagem e
impresso, que podem ser acessados por meio da barra de ferramentas que se
localiza na parte inferior da janela.

Figura 89: Pgina de anlise

direita, podemos ver as penas do grfico, cada uma delas associada a um tag, o
qual se quer observar a evoluo histrica. Estas penas podem ser ativadas ou
desativadas e pode-se mudar o tipo de cor e estilo de linha, de acordo com a vontade
do usurio.
Na parte superior, o Elipse SCADA mostra algumas informaes quando o mouse
est posicionado dentro da rea do grfico: coordenadas do mouse e valor do ponto
selecionado no grfico demarcado pelas linhas (horizontal e vertical) tracejadas.
Para selecionar um ponto do grfico basta clicar sobre o mesmo.
Histricos

135

Manual do Usurio

Grfico
Esta pgina permite a configurao da aparncia do Grfico da Anlise Histrica, de
acordo com o que segue:

Figura 90: Pgina de configurao do grfico

136

Histricos

Manual do Usurio

Opes para o eixo X (horizontal)


OPO
Limite esquerdo

DESCRIO
Limite esquerdo do eixo X. Disponvel se o grfico
do tipo XY.

Limite direito

Limite direito do eixo X. Disponvel se o grfico do


tipo XY.

Exibir rgua superior

Exibe uma rgua para o eixo X na parte superior do


grfico.

Exibir rgua inferior

Exibe uma rgua para o eixo X na parte inferior do


grfico.

Opes para o eixo Y (vertical)


OPO
Limite superior

DESCRIO
Limite superior do eixo Y.

Limite inferior

Limite inferior do eixo Y.

Exibir rgua esquerda

Exibe uma rgua a esquerda do grfico, com os


valores do eixo Y.

Exibir rgua direita

Exibe uma rgua a direita do grfico, com os valores


do eixo Y.
Opes comuns

Histricos

OPO
Ajuste automtico

DESCRIO
Calcula automaticamente os limites para os eixos X
e/ou Y.

Grade Rolante

Faz com que a grade de fundo se movimente


medida que os valores do grfico so atualizados.

Texto

Permite acrescentar um ttulo para as rguas.

Formato Data/Hora

Ajusta o formato de data e hora quando configurados


para o eixo.

Cores/Fundo da rgua

Define a cor de fundo para as rguas.

Cores/Texto da rgua

Define a cor para o texto que ser mostrado nas


rguas.

Cores/Fundo do grfico

Define a cor de fundo para o grfico.

Cores/Grades e eixos

Define a cor da grade e dos eixos do grfico.

Grade/Linhas de X

Define o nmero de linhas horizontais da grade.

Grade/Linhas de Y

Define o nmero de linhas verticais da grade.

Fonte da rgua

Define fonte, tamanho e cor para os caracteres do


grfico.

137

Manual do Usurio

Penas
Esta pgina permite determinar os tags que sero mostrados no grfico, associando a
cada um, uma pena que ir descrever a evoluo da varivel no processo.

Figura 91: Guia de configurao das penas

No quadro central, so listadas as penas que sero usadas no grfico. Pode-se ajustar
quais estaro ativas. Clicando-se no retngulo preto mais direita, possvel ajustar
as caractersticas da representao grfica da pena, tais como espessura da linha e
cor. Os outros campos so descritos abaixo:
Opes de configurao das penas
OPO
Label

DESCRIO
Nome ou descrio da pena. Por padro, o nome do
tag sugerido, mas pode ser mudado.

Y axis

Varivel a ser usada na coordenada Y.

X axis

Varivel a ser usada na coordenada X.

Atravs dos botes da barra de ferramentas, posicionada na parte superior da janela,


possvel:
acrescentar mais uma Pena

subir a pena de posio

acrescentar uma Marca

descer a pena de posio

apagar uma Pena ou Marca


ajustar a representao em linha para o tag selecionado
ajustar a representao em preenchimento para o tag selecionado
ajustar a representao em barra para o tag selecionado
138

Histricos

Manual do Usurio

Configuraes
Esta pgina permite especificar o arquivo de dados a ser usado na anlise. Se a
opo Processo de Batelada estiver marcada (ver propriedades gerais do
Histrico), o grupo Batelada nesta pgina estar disponvel para a escolha da
batelada.

Figura 92: Guia de configurao do arquivo de histrico

Campos de configurao do arquivo de histrico

Histricos

OPO
Nome do arquivo

DESCRIO
Define o nome do arquivo fonte para Anlise
Histrica e CEP (.DAT).

Todas Bateladas

Seleciona a impresso de todas as bateladas do


arquivo.

ltima batelada

Seleciona para ser impressa a ltima batelada


registrada.

Batelada Especfica

Seleciona uma batelada especfica para ser impressa,


conforme o especificado nos campos Campo e Valor.

139

Manual do Usurio

Consulta
Esta pgina permite criar uma consulta (query) para o arquivo de histrico. A
partir dessa consulta possvel definir um intervalo de tempo para limitar os dados
com os quais se quer trabalhar.

Figura 93: Guia de configurao da consulta no histrico

140

Histricos

Manual do Usurio

Campos de configurao da consulta no histrico

Histricos

OPO
Sem consulta por data

DESCRIO
No ser usado filtro, ou seja, seleciona todos os dados.

Intervalo de Tempo

Seleciona os dados dentro de um intervalo de tempo


especificado.

Dados mais recentes

Seleciona os dados a partir de um tempo passado at


agora.

Data inicial

Determina a data inicial do intervalo de tempo.

Hora inicial

Determina a hora inicial do intervalo de tempo.

Data final

Determina a data final do intervalo de tempo.

Hora final

Determina a hora final do intervalo de tempo.

ltimo (valor)

Define o nmero de unidades de tempo dos dados mais


recentes.

ltimo (unidade)

Define a unidade de tempo dos dados mais recentes.

Sempre carrega todo o


banco de dados

Carrega todos os dados do histrico. Os limites de


visualizao so restringidos conforme o configurado
pelo usurio.

141

Manual do Usurio

Impresso
Esta pgina permite a configurao de opes para a impresso da anlise histrica.
O desenvolvedor da aplicao poder gerar arquivos de configurao de impressora
(arquivos .PTR) que so carregados pelo usurio em tempo de execuo.

Figura 94: Configuraes de impresso

Configuraes de impresses

142

OPO
Caixa Impressora

DESCRIO
Permite a escolha da impressora onde se quer
imprimir o relatrio.

Boto Carregar

Permite carregar arquivos de configurao.

Boto Salvar

Permite salvar uma configurao especfica.

Boto Impressora

Chama a configurao da impressora corrente.

Imprimir

Comanda a impresso da Anlise Histrica.

Imprimir o ttulo do
relatrio

Permite especificar um ttulo para o relatrio (no


campo embaixo).

Histricos

Manual do Usurio

9.3. Controle Estatstico de Processos


O Controle Estatstico de Processos (ou CEP) permite uma anlise estatstica de
um processo monitorado. uma poderosa ferramenta para que voc possa verificar
se o processo est executando de acordo com as suas necessidades e controlar suas
variveis para obter um melhor resultado. Assim como a Anlise Histrica, o CEP
tambm est associado a um objeto Histrico e possvel habilitar a sua
configurao em tempo de execuo.
Quando o CEP chamado, uma Janela de Propriedade aberta. Atravs dela,
possvel configurar as opes do CEP, que possui 7 pginas: Configurar, Cores das
Penas , Grfico de Mdia, Grfico de Disperso, Grfico de Histograma,
Configuraes e Consulta.
As notaes a seguir sero usadas na explicao das frmulas do CEP:

Histricos

k : nmero de amostras;

x : mdia aritmtica dos valores da amostra i, onde i = 1, 2, 3, ..., k

n : tamanho de cada amostra;

ij

: valor j da amostra i, onde j = 1, 2, 3, ..., n

143

Manual do Usurio

Configurar
Esta a pgina principal do CEP e permite a configurao de suas propriedades
gerais. Nesta tela tambm encontramos botes para chamar as telas auxiliares do
CEP, que permitem visualizar grficos e resultados da anlise estatstica.

Figura 95: Propriedades do CEP

144

Histricos

Manual do Usurio

Configurao das propriedades do CEP


OPO
Pontos/Grupo

DESCRIO
Define o nmero de itens para cada amostra

Tipo de disperso

Define o mtodo a ser usado: Sigma ou Range

Tag

Define qual o Tag do Histrico que ser analisado

Limites de
Engenharia/Inferior

Define o limite inferior de Engenharia ou


Especificao do intervalo de tolerncia para os dados
das amostras do CEP

Limites de
Engenharia/Superior

Define o limite superior de Engenharia ou


Especificao do intervalo de tolerncia para os dados
das amostras do CEP

Aps a alterao de algumas destas caractersticas, necessrio apertar o boto


Atualizar CEP para o sistema refazer os clculos.
Cores das Penas
Esta pgina permite selecionar as cores para cada pena (tag) do Histrico e as
demais linhas de controle, que sero mostradas nos grficos do CEP, a saber: mdia,
limite superior/inferior de controle, limite superior/inferior de engenharia, curva
normal e cor da barra.

Figura 96: Configuraes das Cores das Penas

Histricos

145

Manual do Usurio

Grficos de Mdias
Esta pgina permite configurar a aparncia do grfico de mdias do CEP. Seus
controles so descritos a seguir.

Figura 97: Configuraes do Grfico de Mdia

Opes para o eixo X (horizontal)

146

OPO
Limite esquerdo

DESCRIO
Limite esquerdo do eixo X. Disponvel se o grfico
do tipo XY.

Limite direito

Limite direito do eixo X. Disponvel se o grfico do


tipo XY.

Exibir rgua superior

Exibe uma rgua para o eixo X na parte superior do


grfico.

Exibir rgua inferior

Exibe uma rgua para o eixo X na parte inferior do


grfico.

Histricos

Manual do Usurio

Opes para o eixo Y (vertical)


OPO
Limite superior

DESCRIO
Limite superior do eixo Y.

Limite inferior

Limite inferior do eixo Y.

Exibir rgua esquerda

Exibe uma rgua a esquerda do grfico, com os


valores do eixo Y.

Exibir rgua direita

Exibe uma rgua a direita do grfico, com os valores


do eixo Y.
Opes comuns

OPO
Ajuste automtico

DESCRIO
Calcula automaticamente os limites para os eixos X
e/ou Y.

Grade Rolante

Faz com que a grade de fundo se movimente


medida que os valores do grfico so atualizados.

Texto

Permite acrescentar um ttulo para as rguas.

Formato Data/Hora

Ajusta o formato de data e hora quando configurados


para o eixo.

Cores/Fundo da rgua

Define a cor de fundo para as rguas.

Cores/Texto da rgua

Define a cor para o texto que ser mostrado nas


rguas.

Cores/Fundo do grfico

Define a cor de fundo para o grfico.

Cores/Grades e eixos

Define a cor da grade e dos eixos do grfico.

Grade/Linhas de X

Define o nmero de linhas horizontais da grade.

Grade/Linhas de Y

Define o nmero de linhas verticais da grade.

Fonte da rgua

Define fonte, tamanho e cor para os caracteres do


grfico.

Mtodos de Clculo
O grfico da mdia calculado da maneira seguinte. Para cada amostra i (1, 2, ..., k),
calculada a mdia

x i:
x i=

1
( x11 + x12 + x13 + ... + x1n )
n

x , a mdia das mdias de cada amostra. Voc


pode obter o valor do desvio padro das mdias x usando um de dois mtodos:
Uma linha central representada por

Histricos

147

Manual do Usurio

a) Mtodo Sigma
Para cada amostra i ( i = 1, 2, ..., k ) calcula-se:
12

n

S = x 2 n. x 2 n
j 1 j

A seguir, calcula-se o desvio mdio:

S=

1
k

S S
1

... S k

Utiliza-se, para a estimativa do desvio padro, um fator de correo, anotado por c 2.


Esta constante varia conforme n e, como voc pode ver na tabela do CEP, quando n
maior que 25, c2 = 1, o que significa que no h mais correo a fazer.
O desvio padro ser, ento:

S
C2

Recomenda-se utilizar este mtodo para amostras grandes, com n maior que 10.

148

Histricos

Manual do Usurio

b) Mtodo Range
Para cada amostra i ( i = 1, 2, ..., k ), calcula-se:

R X
i

max

X
min

A seguir calcula-se a amplitude mdia:

1
k

R R ... R
1

Utiliza-se, para a estimativa do desvio padro, um fator de correo, anotado por d 2.


Esta constante varia conforme n e, como voc pode ver na tabela do CEP, quanto
maior o valor de n maior a correo a ser aplicada. O desvio padro ser, ento:

R
D2

Recomenda-se utilizar este mtodo para amostras pequenas, com n menor ou igual a
10 (n<=10).
O grfico ter, ento, os seguintes pontos no eixo X.
XDB: Linha central = x
LSC: Limite Superior de Controle

LSC X a2 R ;
LIC: Limite Inferior de Controle

LIC X a2 R ;
LSE: Limite Superior de Engenharia;
LIE: Limite Inferior de Engenharia;

Histricos

149

Manual do Usurio

Grfico de Disperso
Esta pgina permite configurar a aparncia do grfico de disperso do CEP. Ela tem
os mesmos controles e funcionamento do grfico das Mdias.
Mtodos de Clculo
a) Mtodo Sigma

A linha central do grfico representada por

S=

1
k

S S
1

e calculada como segue:

... S k

Utiliza-se, para o clculo dos limites de controle, duas constantes c3 e c4 (ver tabela
SPC). Desta forma calcula-se os limites:

LSC =

LIC =

Este grfico recomendado para amostras grandes com n maior que 10 (n>10);
b) Mtodo Range
Da mesma forma que no grfico anterior, a linha central do grfico representada
por

e calculada como segue:

1
k

R R ... R
1

Utiliza-se, para o clculo dos limites de controle, duas constantes d 3 e d4 (ver tabela
CEP). Desta forma calcula-se os limites:

150

LSC =

R .d 4

LIC =

R .d 3

Histricos

Manual do Usurio

Os valores para clculo das linhas centras e limites de controle so definidos de


acordo com a tabela que segue:
Tabela CEP (valores para clculo das linhas centrais e limites de controles)

Histricos

d2

c2

d3

d4

c3

c4

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

1,880
1,023
0,729
0,577
0,483
0,419
0,373
0,337
0,308
0,285
0,266
0,249
0,235
0,223
0,212
0,203
0,194
0,187
0,180
0,173
0,167
0,162
0,157
0,153

1,128
1,693
2,059
2,326
2,534
2,704
2,847
2,970
3,078
3,173
3,258
3,336
3,407
3,472
3,532
3,588
3,640
3,689
3,735
3,778
3,819
3,858
3,895
3,931

0,5642
0,7236
0,7979
0,8407
0,8686
0,8882
0,9027
0,9139
0,9227
0,9300
0,9359
0,9410
0,9453
0,9490
0,9523
0,9551
0,9576
0,9599
0,9619
0,9638
0,9655
0,9670
0,9684
0,9696

0,000
0,000
0,000
0,000
0,000
0,076
0,136
0,184
0,223
0,256
0,284
0,308
0,329
0,348
0,364
0,379
0,392
0,404
0,414
0,425
0,434
0,433
0,452
0,459

3,267
2,575
2,282
2,115
2,004
1,924
1,864
1,816
1,777
1,744
1,716
1,692
1,671
1,652
1,636
1,621
1,608
1,596
1,586
1,575
1,566
1,557
1,548
1,541

0,000
0,000
0,000
0,000
0,030
0,118
0,185
0,239
0,284
0,321
0,354
0,382
0,406
0,428
0,448
0,466
0,482
0,497
0,510
0,523
0,534
0,545
0,555
0,565

3,267
2,568
2,266
2,089
1,970
1,882
1,815
1,761
1,716
1,679
1,646
1,618
1,594
1,572
1,552
1,534
1,518
1,503
1,490
1,477
1,466
1,455
1,445
1,435

151

Manual do Usurio

Grfico de Histograma
O Grfico de Histograma mostra um volume grande de dados de forma clara,
permitindo uma melhor visualizao da tendncia central, da disperso ao longo da
escala de medio e da freqncia de valores.

Figura 98: Grfico de Histograma

Na pgina Grfico de Histograma podemos configurar a aparncia deste tipo de


grfico gerado a partir do CEP. Esta pgina tem os mesmos controles e
funcionamento do grfico das mdias. O Elipse SCADA gera o Grfico de
Histograma baseado nos seguintes elementos:
Nmero de Barras
Total de itens

Nmero de barras

20-50
51-100
101-200
201-500
501-1000
Mais de 1000

6
7
8
9
10
11-20

Intervalo de Barra (l)


A largura de cada barra dada por um intervalo, determinado diminuindo-se o
menor item do maior e dividindo-se o resultado pelo nmero de barras. Elipse
SCADA define que item pertence a que barra e calcula a freqncia total f para cada
barra do grfico. A distribuio normal tambm aparece no grfico do Histograma e
determinada pela seguinte frmula:

152

Histricos

Manual do Usurio

1
y
2

x 2

onde: = mdia e = desvio padro


A linha central da mdia, e os limites de controle (LSC e LIC) e engenharia (LSE e
LIE) tambm aparecem no grfico.
ndices de Capabilidade
Antes de descrever cada ndice de capabilidade, as seguintes frmulas devem ser
definidas:
Ponto mdio = (LSE + LIE) / 2
Tolerncia = LSE - LIE
CP - Capabilidade Inerente do Processo

CP =

Tolerancia
6

Se as amostras no estiverem no ponto mdio elas tendem a zero.


VALOR DO CP
Maior que 1.33

DESCRIO
Processo capaz.

Entre 1.0 e 1.33

Processo capaz, mas precisa ser monitorado


com CP prximo de 1.0.

Menor que 1.0

Processo no capaz.

CR - Taxa de Capabilidade
o inverso do CP.
CR =

6
Tolerancia

valores de CR menores que 0.75 indicam capabilidade.


K - mdia do processo versus mdia especificada
K a comparao entre a mdia e o ponto mdio, mostrando o quanto os dados esto
centralizados de acordo com a especificao.

Histricos

153

Manual do Usurio

K=

Media PtoMedio
Tolerancia

CPK - Capabilidade em relao a mdia especificada


CPK a capabilidade do processo baseada no pior caso de dados. CPK o menor
valor de:

LSE Media
3

Media LIE
ou

Um valor negativo do CPK indica que a mdia est fora dos limites de engenharia.
Um CPK igual a zero indica que a mdia igual a um dos limites de engenharia. Um
CPK entre 0 e 1.0 significa que parte dos 6 limites sigma caem fora dos limites de
engenharia. Um CPK igual a 1 indica que um final dos 6 limites sigma cai em um
limite de engenharia. Um CPK maior que um significa que os 6 limites sigma caem
completamente dentro dos limites de engenharia.

154

Histricos

Manual do Usurio

Configuraes
Esta pgina a mesma existente na consulta do Histrico e permite a configurao
do arquivo de histrico que ser usado pelo CEP.

Figura 99: Configuraes

Histricos

155

Manual do Usurio

Consulta
Esta pgina a mesma existente na consulta do Histrico e permite definir um
intervalo de tempo para o arquivo de Histrico.

Figura 100: Configuraes das Consultas

156

Histricos

Captulo

10
10.

Relatrios

Relatrios permitem imprimir os dados de arquivos de Histrico ou de Alarmes ou


ainda valores de tags em tempo real.
Atualmente, os relatrios tm a seguinte restrio: no permitem carregar/salvar
configurao de impressora (a janela de configurao da impressora mostrada
sempre).
Voc pode definir um Relatrio no Organizer durante a configurao da aplicao
ou em tempo de execuo usando Funes Especiais atravs de Scripts.
Existem quatro tipos de Relatrios disponveis:
Texto: imprime os dados de arquivos de histricos ou de alarmes em formato
texto;
Grfico: imprime os dados de arquivos de histricos ou de alarmes de forma
grfica;
Formatado: usado para imprimir dados em tempo real, como por exemplo o
valor de um Tag em determinado momento;

Anlise Histrica : um relatrio em tela que possui dentro dele um


relatrio grfico.
Para criar ou editar um Relatrio voc precisa selecionar a opo Relatrios na
rvore da aplicao no Organizer, a pgina abaixo ser mostrada contendo uma lista
de todos os Relatrios existentes na aplicao.

Figura 101: Tela de criao de relatrios

Relatrios

157

Manual do Usurio

Voc pode criar um novo Relatrio usando o boto Novo direita da pgina ou
remover um existente selecionando-o na lista e pressionando o boto deletar. A
janela para escolha do tipo do Novo Relatrio mostrada a seguir:

Figura 102: Tela dos tipos de relatrios

Cada Relatrio que voc cria para a aplicao aparece abaixo da opo Relatrios
(Reports) na rvore da aplicao no Organizer. Ao selecionar um Relatrio
especfico suas propriedades so mostradas ao lado direito da rvore.

158

Relatrios

Manual do Usurio

10.1. Propriedades Gerais


Para relatrios do tipo: Texto, Grfico e Formatado
A pgina de propriedades Gerais dos Relatrios Texto, Grfico e Formatado aparece
quando selecionada a aba Geral no topo das pginas do Relatrio. Esta pgina
mostrada abaixo e seus respectivos campos so descritos na tabela que segue.

Figura 103: Propriedades gerais dos relatrios

Relatrios

159

Manual do Usurio
Propriedades Gerais dos Relatrios
OPO
Nome

DESCRIO
Define o nome do Relatrio que ser usado na rvore
do Organizer e nos Scripts.

Descrio

Uma breve descrio sobre o Relatrio.

Imprimir cabealho na
batelada
Imprime o ttulo do
relatrio

Habilita a impresso de uma pgina contendo dados


do cabealho da Batelada.

Impressora

Permite escolher a definio de impressora para o


relatrio. O boto mostra a caixa de dilogo de
Configurao de Impressora.

Editar!

Permite editar o
FORMATADO.

Fonte...

Define a fonte (tipo, cor e tamanho) a ser usada no


Relatrio.

Imprimir

Imprime o Relatrio.

Impressora e Fonte

Os botes Carregar e Salvar permitem carregar e


salvar configuraes de impressora previamente
definidas e salvas no sistema.

Somente disponvel para Relatrios TEXTO e


GRFICO. Imprime como ttulo o texto informado
no campo Descrio.

desenho

de

um

relatrio

10.2. Configuraes
Para relatrios do tipo: Texto e Grfico
Permite a especificao do arquivo a ser impresso: Histrico (extenso DAT),
Alarmes (extenso DAT) ou Batelada (extenso HDR). Se a opo Processo de
Batelada estiver marcada (ver Propriedades Gerais do Histrico) o quadro Batelada
nesta pgina estar disponvel para a escolha da Batelada.
A pgina de Configuraes dos Relatrios aparece quando selecionada a aba
Configuraes no topo das pginas do Relatrio Texto ou Grfico. Esta pgina
mostrada abaixo e seus respectivos campos so descritos na tabela que segue.

160

Relatrios

Manual do Usurio

Figura 104: Configuraes do Relatrio

Configuraes dos Relatrios

Relatrios

OPO
Arquivo fonte

DESCRIO
Define o nome do arquivo fonte para o Relatrio
(.DAT ou .HDR).

Localizar...

Permite localizar o arquivo fonte a ser usado pelo


Relatrio.

Todas as bateladas

Seleciona todas as bateladas para serem impressas.


Esta opo est disponvel somente para arquivos de
Histrico por batelada.

Ultima batelada

Seleciona a ltima batelada para ser impressa. Esta


opo est disponvel somente para arquivos de
Histrico por batelada.

Batelada especfica

Seleciona uma batelada especfica para ser impressa,


conforme o especificado nos campos Campo e Valor.

Campo

Lista os campos disponveis para seleo de uma


batelada especfica. Somente campos tipo string sero
listados.

Valor

Define o valor a ser buscado quando numa batelada


especfica.

161

Manual do Usurio

10.3. Consulta
Para relatrios do tipo: Texto e Grfico
Permite definir um intervalo de tempo para selecionar os dados do arquivo a ser
impresso. A pgina de Consulta do Relatrio aparece quando selecionada a aba
Consulta no topo das pginas dos Relatrios Texto ou Grfico. Esta pgina
mostrada abaixo e seus respectivos campos so descritos na tabela que segue.

Figura 105: Propriedades das Consultas

162

Relatrios

Manual do Usurio

Propriedades das Consultas


OPO
Sem consulta por data

DESCRIO
No ser usado filtro, ou seja, seleciona todos os
dados.

Intervalo de tempo

Seleciona os dados dentro de um intervalo de tempo


especificado.

Dados mais recentes

Seleciona apenas os dados mais novos.

Data inicial

Determina a data inicial do intervalo de tempo.

Hora inicial

Determina o horrio inicial do intervalo de tempo.

Data final

Determina a data final do intervalo de tempo.

Hora final

Determina o horrio final do intervalo de tempo.

ltimo

Nmero de unidades usadas para selecionar os dados


mais recentes.

Unidade

Define a unidade usada para selecionar os dados mais


recentes.

10.4. Banco de Dados


Relatrio Texto
A pgina Banco de Dados do Relatrio aparece quando selecionada a aba Banco de
Dados no topo das pginas do Relatrio Texto.

Figura 106: Propriedades de Bancos de Dados em Relatrios

Relatrios

163

Manual do Usurio
Propriedades do Banco de Dados
OPO

164

Campos

DESCRIO
Lista os campos disponveis.

Para Cima

Move o campo selecionado uma posio para cima.

Para Baixo

Move o campo selecionado uma posio para baixo.

Atualizar Estrutura do
Arquivo

Recarrega a lista de campos atual do arquivo nos


campos do Relatrio. Quando feita alguma
modificao na estrutura do arquivo usado pelo
Relatrio este boto deve ser pressionado para
atualizao dos campos.

Habilitado

Permite que o campo selecionado seja impresso.

Tamanho

Define o nmero de dgitos a serem mostrados


incluindo o ponto decimal.

Preciso

Define quantos dgitos do tamanho sero decimais.

Prefixo

Adiciona um prefixo tipo string ao valor mostrado.

Sufixo

Adiciona um sufixo tipo string ao valor mostrado.

Formato da Data

Define o formato do campo DataTime.

Etiqueta

Define um nome alternativo aos campos que sero


impressos no relatrio.

Linhas

Define o nmero de linhas que o campo selecionado


ir ter no Relatrio.

Relatrios

Manual do Usurio

10.5. Batelada
Relatrio Texto
A pgina de Batelada do Relatrio Texto aparece quando selecionada a aba
Batelada no topo das pginas do Relatrio Texto. Esta pgina mostrada abaixo e
seus respectivos campos so descritos na tabela que segue.

Figura 107: Propriedades de Bateladas em Relatrios

Relatrios

165

Manual do Usurio
Propriedades de Bateladas
OPO

166

Campos

DESCRIO
Lista os campos disponveis.

Para cima

Move o campo selecionado uma posio para cima.

Para baixo

Move o campo selecionado uma posio para baixo.

Habilitado

Permite que o campo selecionado seja impresso.

Atualizar estrutura de
arquivo

Recarrega a lista de campos atual do arquivo nos


campos do Relatrio. Quando feita alguma
modificao na estrutura do arquivo usado pelo
Relatrio este boto deve ser pressionado para
atualizao dos campos.

Tamanho

Define o nmero de dgitos a serem mostrados


incluindo o ponto decimal.

Preciso

Define quantos dgitos do tamanho sero decimais.

Prefixo

Adiciona um prefixo tipo string ao valor mostrado.

Sufixo

Adiciona um sufixo tipo string ao valor mostrado.

Formato da Data

Define o formato do campo DataTime.

Etiqueta

Define um nome alternativo aos campos que sero


impressos no relatrio.

Linhas

Define o nmero de linhas que o campo selecionado


ir ter no Relatrio.

Relatrios

Manual do Usurio

10.6. Grfico
Relatrio Grfico
A pgina Grfico do Relatrio Grfico aparece quando selecionada a aba Grfico no
topo das pginas do Relatrio Grfico. Esta pgina mostrada abaixo e seus
respectivos campos so descritos na tabela que segue:

Figura 108: Propriedades do Grfico

Relatrios

167

Manual do Usurio
Propriedades do Grfico (Eixo X e Eixo Y)
OPO

DESCRIO
Define se a escala do grfico ser linear (escala normal)
ou logartmica (fator de potncia).

Limite esquerdo

Define o limite esquerdo do eixo X do grfico. Esta


opo est disponvel somente se o grfico do tipo XY.

Limite direito

Define o limite direito do eixo X do grfico. Esta opo


est disponvel somente se o grfico do tipo XY.

Exibir rgua superior

Exibe uma rgua superior no grfico, onde so mostrados


os valores do eixo X.

Exibir rgua inferior

Exibe uma rgua inferior no grfico, onde so mostrados


os valores do eixo X.

Limite superior

Define o limite superior do eixo Y do grfico.

Limite inferior

Define o limite inferior do eixo Y do grfico.

Exibir rgua a
esquerda
Exibir rgua a direita

Exibe uma rgua a esquerda do grfico, onde so


mostrados os valores do eixo Y.

Ajuste automtico

Calcula automaticamente os limites dos eixos X ou Y do


grfico.

Grade rolante

Define que a grade de orientao do grfico ir rolar na


direo em que o grfico est sendo desenhado
acompanhando os valores, ao invs de ficar fixa no
objeto.

Texto

Legenda que ir aparecer ao lado da escala do eixo X e


eixo Y.

Formato Data/Hora

Define o formato da marcao de tempo que ir aparecer


no eixo X nos grficos Tempo X Dado.

Escala

Exibe uma rgua a direita do grfico, onde so mostrados


os valores do eixo Y.

Propriedades do Grfico (Cores e Grade)

168

OPO
Fundo da rgua

DESCRIO
Define a cor de fundo para as rguas do grfico.

Texto da rgua

Define a cor para o texto que ser mostrado nas rguas.

Fundo do grfico

Define a cor de fundo para o grfico.

Grades e eixos

Define a cor da grade e dos eixos do grfico.

Grade

Mostra uma grade (linhas de orientao vertical e


horizontal) no grfico.

Linhas de X

Define o nmero de linhas horizontais da grade.

Linhas de Y

Define o nmero de linhas verticais da grade.

Mostrar milisegundos

Mostra os milisegundos no eixo do grfico que representa


o tempo.

Fonte da rgua

Define fonte, tamanho e cor para os caracteres do grfico.


Relatrios

Manual do Usurio

10.7. Penas
Relatrio Grfico
A pgina Penas do Relatrio Grfico aparece quando selecionada a aba Penas no
topo das pginas do Relatrio Grfico. Esta pgina mostrada abaixo e seus
respectivos controles e campos so descritos na tabela que segue.

Figura 109: Propriedades de Penas

Propriedades das Penas


OPO

DESCRIO
Insere uma pena associada a um tag.
Insere uma pena associada a um campo do histrico (a opo Carrega
Dados do Histrico do Disco deve estar habilitada na aba Avanado).
Insere uma marca indicativa no grfico.
Apaga uma pena ou uma marca selecionada na lista.
Define que o desenho da pena ser do tipo Linha.
Define que o desenho da pena ser do tipo rea.
Define que o desenho da pena ser do tipo Barra.
Muda a ordem da pena selecionada.

Label

Essa coluna lista as penas selecionadas para o grfico. Permite mudar o


texto da legenda e ativar/desativar cada pena.

Y Axis

Seleciona o tag a ser visualizado no eixo Y.

X Axis

Seleciona o tag a ser visualizado no eixo X.


Mostra o quadro Cores das Penas (ver seo a seguir).

Relatrios

169

Manual do Usurio

Cores das Penas


O quadro Cores das Penas aparece quando clica-se no cone
ao lado das
penas do grfico. Nesse quadro, podemos definir a cor, o formato e o tipo do grfico
que ser desenhado para a pena em questo: linha, rea ou barra. O boto Outros...
permite a escolha de outras cores que no as listadas no quadro.

Figura 110: Configuraes das Cores das Penas

10.8. Scripts
Relatrio Grfico
Os scripts permitem fazer pr-configuraes nos relatrios, antes de sua impresso.
Por exemplo, possvel configurar a escala de um grfico a ser impresso. Maiores
detalhes a respeito do uso de scripts veja no captulo especfico.
SCRIPTS DISPONVEIS
EVENTO

OnBeforePrint

170

DESCRIO

Disparado na execuo do mtodo Print() do relatrio, logo depois


de executar a consulta, antes do relatrio ser impresso de fato.

Relatrios

Manual do Usurio

10.9. Relatrio Formatado


O Relatrio Formatado usado quando se deseja imprimir dados em tempo real
como por exemplo o valor de um determinado tag em dado momento. Este relatrio
pode ser editado usando-se objetos disponveis em modo de edio.

Figura 111: Relatrio Formatado

10.10.

Relatrio Anlise Histrica

O Relatrio Anlise Histrica um relatrio em tela que cria um objeto Anlise


Histrica, podendo tambm ser impresso. A configurao e as pginas de
propriedade deste Relatrio so feitas em tempo de execuo, de acordo com o que
j foi descrito nessa seo.
possvel configurar a janela da Anlise Histrica e ativar ou desativar as pginas
de configurao nas propriedades gerais do objeto Anlise Histrica no Organizer.

Relatrios

171

Captulo

11
11.

Drivers

O Elipse SCADA permite a comunicao com equipamentos de aquisio de dados


e com outros computadores executando o Elipse SCADA, atravs de drivers de E/S
ou drivers de rede fornecidos pela Elipse Software. Um documento fornecido com
cada driver contendo informaes importantes a respeito de sua configurao.
Verifique se o driver desejado j est disponvel para o SCADA CE. Os
arquivos .dll para SCADA Win e SCADA CE so diferentes.
Para instalar ou configurar um driver voc precisa selecionar a pgina de drivers em
um tag PLC ou Bloco associado ou acessar o objeto Drivers no Organizer. Nesse
caso, a pgina abaixo ser mostrada contendo uma lista de todos os drivers
instalados na aplicao. Voc pode instalar um novo driver pressionando o boto
Novo ou remover um existente selecionando-o na lista e pressionando o boto
Deletar.

Figura 112: Drivers do Sistema

Drivers

173

Manual do Usurio

11.1. Configurando Drivers


Cada novo driver que voc adiciona na aplicao, aparece abaixo da opo Drivers
na rvore da aplicao no Organizer. Ao selecionar um driver especfico, suas
propriedades so mostradas ao lado direito da rvore.
A pgina de Configurao do Driver aparece quando selecionada a respectiva aba no
topo das pginas de configurao do driver ou quando voc pressiona o boto
Configurar direita da lista de Drivers.

11.1.1. Drivers PLC


Para os Drivers PLC, voc pode configurar os parmetros de comunicao P e
outras propriedades do driver de acordo com as informaes contidas no arquivo de
ajuda que acompanha o driver. A opo Abortar em erro encerra a comunicao
caso ocorra algum problema, impedindo que a aplicao fique travada.

Figura 113: Configurao do driver

174

Drivers

Manual do Usurio

Propriedades de Configurao de Drivers


OPO

Drivers

DESCRIO

Nome

Nome do objeto.

Descrio

Mostra informaes do driver, como fabricante,


verso e data.

Localizao do Driver

Mostra o caminho do arquivo do driver.

Parmetros

Permite a configurao dos parmetros de


comunicao P para o driver selecionado,
conforme especificado na ajuda do driver.

Abortar em erro

Aborta a comunicao se algum problema ocorrer.

Esconder mouse durante


a comunicao
Retentar comunicaes
falhadas
No. de tentativas

Esconde o cursor do mouse durante a comunicao.

Localizar

Permite navegar pelos diretrios para localizar o


arquivo do driver.

Recarregar

Recarrega o driver, reestabelecendo a conexo.

Ajuda

Mostra a ajuda do driver selecionado.

Avanado

Abre uma janela para configurao das opes


avanadas do driver.

Extras

Abre uma janela paea configurao dos parmetros


extras do driver.

Define que o sistema ir tentar reestabelecer uma


comunicao perdida com o driver.
Define o nmero de tentativas de reestabelecer a
comunicao com o driver.

175

Manual do Usurio
Propriedades de Configurao de Drivers (Avanado)
OPO
Manter comportamento
16-bits

DESCRIO
Se ligado desabilita a multitarefa, fazendo com que o
driver 32-bits rode como na verso 16-bits. Essa
opo necessria para alguns drivers mais antigos.

Escrever em background

Controla como as escritas sero efetuadas no driver.


Algumas escritas geradas pelo Elipse SCADA podem
ser efetuadas em background (segundo plano),
aumentando a performance. Se esta opo estiver
desabilitada todas as escritas sero em foreground
(primeiro plano), forando a aplicao a esperar a
comunicao com o driver para continuar sua
execuo.

Prioridade de escrita

Permite escolher se a prioridade das escritas ser


maior (High) ou igual (Low) prioridade das leituras.

Iniciar o driver ao rodar a


aplicao

Permite desabilitar o incio automtico do driver. Por


exemplo: em um driver dial-up, muitas vezes
interessante esperar um comando para iniciar a
comunicao.

Manter o driver em
memria

Muitos drivers tm um tempo de carregamento e


incio muito lento. Essa opo mantm o driver em
memria, minimizando o tempo de incio e
agilizando a comunicao.

O boto Extras... chama configuraes especiais dos drivers. Essas configuraes


variam de driver para driver. Consulte o arquivo de ajuda que acompanha o driver
para obter maiores informaes. A caixa de dilogo pode mudar de acordo com o
driver que est inserido no sistema, mas em geral, mostrado o que est abaixo:

176

Drivers

Manual do Usurio

Figura 114: Configuraes extras

As opes disponveis so as seguintes:

Drivers

177

Manual do Usurio
Opes das Configuraes Extras

178

OPO
Use Modem

DESCRIO
Habilita a utilizao do modem.

Modem Settings

Determina o modem a ser utilizado.

Dial number

Determina o nmero a ser discado pelo modem.

Accept incoming calls

Configura o modem, aps o driver ser conectado ao


mesmo, para atender chamadas vindas de outro
modem, aps um nmero configurvel de toques.

No Log

No utiliza o arquivo de log.

Create new

Cria um novo arquivo de log e insere no local


indicado no campo file path. Se j existir arquivo de
log no path especificado, o arquivo de log ser sobreescrito.

Append data

Cria um novo arquivo de log e insere no local


indicado no campo file path. Se j existir arquivo de
log no caminho especificado, as informaes sero
acrescentadas ao final do mesmo.

Standard Error Output

Utilizada para depurao. Esta opo deve ser


mantida desabilitada.

ASCII Output

Converte os bytes de comunicao em caracteres


texto, conforme a tabela ASCII.

Log Date & Time

Mostra o timestamp, isto , a data e o horrio de cada


mensagem no arquivo.

Drivers

Manual do Usurio

11.1.2. Drivers de Rede

Figura 115: Configuraes Comuns para Drivers de Rede

Drivers

179

Manual do Usurio
Configuraes Comuns para Drivers de Rede
OPO

180

DESCRIO

Nome

Nome do objeto.

Descrio

Breve descrio do objeto.

Nome do driver

Nome do driver, definido pelo fabricante.

Localizao do driver

Permite navegar nos diretrios para indicar o arquivo


do driver.

Configurao corrente

Mostra a configurao corrente do driver de rede.

Localizar...

Permite navegar pelos diretrios para localizar o


arquivo do driver.

Recarregar

Recarrega o driver, reestabelecendo a conexo.

Ajuda

Mostra a ajuda do driver selecionado.

Configurar...

Abre a janela de configurao do driver. Esta janela


varia conforme o driver selecionado. Consulte a
documentao do driver para obter mais informaes

Inicia driver quando


carregar a aplicao
T1, T2, PS, BR

Ativa o driver no incio da execuo da aplicao.


Estes parmetros governam o funcionamento do
protocolo de troca de mensagens entre diversas
instncias do Elipse SCADA. O protocolo fullduplex e permite que cada estao envie at 16
mensagens sem confirmao (janela de mensagens).
O tamanho da mensagem em bytes definido no
campo PS (Packet Size).
O pacote de dados dividido entre a troca de dados
de tags e arquivos remotos, e o envio de dados para
transmisso de vdeo em tempo real para o Elipse
Watcher. O campo BR (Band Reserve) determina o
percentual destes pacotes que est reservado para a
troca de dados. O restante pode ser utilizado pelo
Watcher. Se no houverem dados de vdeo, o pacote
inteiro utilizado para dados de tags, e vice-versa.
O campo T1 determina o tempo de envio do
keepalive (em milisegundos), isto , uma mensagem
que informa que o Elipse ainda est ativo. Esta
mensagem s enviada se a estao no estiver
enviando dados no momento.
O campo T2 indica o timeout (tempo-limite), em
milisegundos, para o reenvio de mensagens
no-reconhecidas. Se uma mensagem no foi
reconhecida como recebida, ela reenviada aps este
tempo expirar. Se o envio de uma mensagem falhar
dez vezes, a conexo abortada.

Drivers

Manual do Usurio

11.2. Scripts de Drivers


Scripts de drivers normalmente esto associados ao status da comunicao. Isto
significa, na prtica, que um script pode ser executado quando um erro de
comunicao ocorrer. Maiores detalhes a respeito do uso de scripts veja no captulo
especfico.
Scripts Disponveis
Voc pode associar scripts a drivers executando-os em uma das situaes a seguir:
Executado cada vez que um erro de leitura ou escrita ocorrer no
OnCommError
driver.

11.3. Lista de Tags Associados


A pgina Lista de Tags mostra os tags PLC e Bloco que esto associados ao driver
em questo, permitindo a edio dos parmetros de endereamento e varredura
diretamente na lista, num processo semelhante a uma planilha eletrnica.

Figura 116: Cabealho da Lista de tags associados

Opes disponveis na Lista de tags associados


OPO

Drivers

DESCRIO

Nome

Nome do Tag

N1/B1 N4/B4

Parmetros de endereamento do tag .

Scan

Tempo de atualizao (leitura) do valor do tag.

Size

Mostra o tamanho de um tag Bloco (no disponvel


para tags PLC).

Exportar Tags...

Permite criar um arquivo no formato CSV com a


definio dos parmetros dos tags listados. Este
arquivo pode ser importado no Elipse E3 ou qualquer
outro software compatvel (como por exemplo, o
Microsoft Excel).

181

Captulo

12
12.

Database

A opo Databases permite criar e manipular bancos de dados dentro do Elipse


SCADA. Este objeto utiliza o padro ODBC do Windows que efetua a manipulao
do banco de dados enviando e recebendo dados. Open Database Connectivity
(ODBC) uma interface criada pela Microsoft que oferece uma interface universal
para acesso a diferentes bancos de dados incluindo Oracle, Access, MySQL,
Interbase entre outros.
Voc pode definir um Banco de Dados no Organizer durante a configurao da
aplicao ou em tempo de execuo atravs de Scripts. Para utilizar um banco de
dados no Elipse SCADA voc precisa selecionar a opo Databases na rvore da
aplicao no Organizer. A pgina abaixo ser mostrada contendo uma lista de todos
os Databases existentes na aplicao.

Figura 117: Database

Propriedades do Database

Database

OPO
Lista

DESCRIO
Lista os databases existentes na aplicao.

Novo

Chama o Assistente de Nova Conexo que permite acrescentar


uma conexo ODBC para um banco de dados.

Deletar

Remove da lista o database selecionado.

Avanado

Permite a consulta e edio do string de conexo ODBC.

183

Manual do Usurio

Voc pode conectar o Elipse SCADA a um banco de dados usando o Assistente de


Nova Conexo ao pressionar o boto Novo direita da pgina. Uma janela ser
mostrada perguntando se voc deseja criar uma conexo com uma tabela j existente
ou criar uma nova tabela. A seguir uma lista contendo as conexes (Data Sources)
existentes ser mostrada, se desejar uma nova clique no boto Novo e escolha o
driver ODBC que voc deseja usar: MS Access, MS Fox Pro, MS Excel, CAClipper, dBase, Oracle e outros. Selecionado o driver, clique OK e configure as
opes do mesmo, entre elas: Nome da Conexo (Data Source Name) e o arquivo ou
diretrio que contm os dados. Se voc estiver criando uma nova tabela uma janela
ser apresentada para que voc informe o Nome da Tabela, seus respectivos campos
e o tipo de dados de cada um.
O Elipse SCADA ir mostrar na rvore do Organizer a nova tabela e seus
respectivos campos, que podero ser modificados usando as funes especiais do
ODBC nos Scripts. Voc pode remover um banco de dados existente selecionando-o
na lista e pressionando o boto Deletar. Para uma melhor compreenso da
conectividade do ODBC veja a figura a seguir:

184

Database

Manual do Usurio

Figura 118: Exemplo de conectividade ODBC

Exemplo usando Database


O exemplo a seguir mostra uma conexo do Elipse SCADA com um banco de dados
Access.

Drivers

No Access crie um banco de dados contendo uma ou mais tabelas. Ex:


arquivo SUPPORT.MDB com a tabela Main Table.
Feche o banco de dados (SUPPORT.MDB).
No Elipse SCADA selecione a opo Databases na rvore do Organizer.
Pressione o boto Novo e o Assistente de Nova Conexo ser mostrado para
que voc escolha fazer uma conexo com uma tabela j existente ou criar
uma nova tabela. Selecione a conexo com uma tabela j existente.

185

Manual do Usurio

Figura 119: Assistente de Nova Conexo de Banco de Dados

Selecione a aba Machine Data Source e uma lista com as conexes (Data
Source Name) disponveis ser mostrada. Se voc desejar alguma no
disponvel na lista pressione o boto Novo e escolha o Driver ODBC que
deseja usar. Neste exemplo voc deve escolher o banco de dados Microsoft
Access e clicar OK.

Figura 120: Bases de dados ODBC

186

Database

Manual do Usurio

Drivers

A janela Criar nova Database ser mostrada para que voce indique o tipo
da fonte de dados. Selecione Sistema Database e clique Next.
Na janela seguinte escolha o Driver ODBC que deseja usar. Neste exemplo
voc deve escolher o banco de dados Microsoft Access e clicar Next;
Aparecer a janela de Configurao do Driver onde voc deve informar o
nome da conexo (Data Source Name) e pressionando o boto Select
escolher o arquivo que voc criou (SUPPORT.MDB);
A prxima janela permite a seleo das tabelas do banco de dados que sero
utilizadas. Selecione a tabela Main Table;
Agora os ttulos das tabelas selecionadas aparecem abaixo da opo
Databases na rvore da aplicao e seus respectivos campos aparecem
abaixo do ttulo.
Feito isso, os campos do Banco de Dados podem ser associados aos Objetos
de Tela, bem como a Tags (variveis do sistema). A manipulao dos
registros do Banco de Dados feita atravs de Funes Especiais que podem
ser encontradas usando-se o App Browser quando em uma pgina de Scripts
(ver Captulo de Scripts - Funes Especiais - Funes de Bancos de Dados).

187

Captulo

13
13.

Usurios

Elipse SCADA permite a voc controlar o acesso a uma aplicao atravs de uma
lista de nomes, podendo atribuir uma senha a cada usurio e configurar nveis de
segurana no seu sistema.
O usurio Administrador possui acesso ilimitado ao sistema. Os demais usurios
possuem um nvel de segurana associado que permite a eles acessarem apenas as
caractersticas atribudas ao seu nvel de acesso.
Voc pode criar uma lista de usurios selecionando a opo Usurios na rvore da
aplicao no Organizer, a pgina abaixo ser mostrada contendo uma lista de todos
os usurios cadastrados na aplicao.

Figura 121: Lista de usurios

Opes disponveis na Lista de usurios


OPO
Lista

DESCRIO
Lista de todos os usurios cadastrados.

Novo

Adiciona um novo usurio na lista de usurios.

Deletar

Remove o usurio selecionado.

Propriedades

Mostra as propriedades do usurio selecionado.

Voc pode adicionar um novo usurio usando o boto Novo direita da pgina ou
remover um existente selecionando-o na lista e pressionando o boto Deletar.
Ao adicionar um novo usurio no sistema ele ir aparecer na rvore do Organizer
logo abaixo de Usurios. Selecione o novo usurio na rvore e a janela a seguir ir
aparecer, onde devero ser informados o login e a senha do usurio.
Usurios

189

Manual do Usurio

Figura 122: Propriedades do Usurio

Propriedades do Usurio
OPO
Nome

DESCRIO
Define o nome do usurio.

Descrio

Uma breve descrio sobre o usurio.

Login

String de identificao do usurio.

Senha

Campo para cadastrar a senha do usurio.

Nvel de Acesso

Define o nvel de acesso do usurio (de 1 a 100). A


maior prioridade o nmero 1.

Feito isto, voc deve definir o nvel de acesso para cada tela da aplicao conforme a
tabela a seguir:
NVEL
0
1
maior que 1

ACESSO
livre acesso para todos
super usurio
outros usurios

Um usurio pode acessar somente as telas que possuem prioridade zero ou maior
igual a sua. Como padro, todas as telas possuem nvel de acesso 0 (livre acesso).

190

Usurios

Manual do Usurio

13.1. Funes e Atributos


As funes a seguir so especficas para o login:
Aplicao.Login()

Chama uma caixa de dilogo para a identificao de um novo usurio. Retorna


verdadeiro (diferente de zero) se o usurio foi identificado com sucesso (foi
logado) ou falso (zero) se no foi. Em caso de erro, nenhuma mensagem ser
mostrada. A funo atualiza o atributo global lastError, colocando 0 (zero) se o
login for cancelado pelo usurio ou 1 (um) se o usurio ou a senha for invlida.
Aplicao.Logout()

Retira um usurio logado da aplicao. Fecha todas as telas que possuem prioridade
diferente de zero.
Aplicao.UserAdministration()

Esta funo mostra uma de duas caixas de dilogo conforme o nvel de acesso do
usurio:

Se User-level = 1 (administrador), ele poder criar, modificar e remover os


atributos de todos os usurios, inclusive trocar a senha.

Se User-level > 1, ele somente poder trocar a sua senha.

Quando voc pressionar OK na caixa de dilogo a mensagem Senha Trocada


dever aparecer. Se aparecer a mensagem Nova senha no confirma, voc
provavelmente reescreveu uma senha diferente da sua nova.
A aplicao possui os seguintes atributos para as funes de login:
ATRIBUTO
UserName

DESCRIO
Nome do usurio logado na aplicao (vazio, quando
no h usurios logados).

UserAccessLevel

Nvel do usurio logado na aplicao (100, quando


no h usurios logados).

13.2. Scripts de Login


possvel associar scripts a eventos gerados pelo login de usurios.
Scripts Disponveis
Voc pode associar scripts a dois eventos de login da aplicao:

Usurios

191

Manual do Usurio
EVENTOS
OnUserLogin

DESCRIO
executado quando um usurio logado na aplicao

OnUserLogout

executado quando um usurio sai da aplicao

Observaes:
No permitido mais de um usurio logado ao mesmo tempo na aplicao.
Quando um usurio loga na aplicao, os dois scripts so executados:
OnUserLogout (se j existe um usurio logado) e OnUserLogin;

192

Quando a aplicao termina executado um Logout;


Voc no pode acessar ou modificar qualquer propriedade de usurios (nome,
descrio etc.) em tempo de execuo. Propriedades de usurios no podem ser
associadas a nenhum objeto de tela e no podem ser usadas em scripts.

Usurios

Captulo

14
14.

Aplicaes Remotas

As Aplicaes Remotas so usadas quando se deseja conectar dois ou mais Elipse


SCADA que estejam ligados via rede, modem ou cabo serial. Para usar esta
caracterstica, voc deve definir uma estao Servidora e outra Cliente e adicionar o
driver de rede que deseja usar em ambas.
Atualmente, s driver TCPIP est implementado para CE.
Voc pode adicionar um driver de rede s suas aplicaes Servidora e Cliente
selecionando a opo Drivers na rvore da aplicao no Organizer e pressionando o
boto Novo direita da lista de drivers de rede. Cada novo driver que voc adiciona
na aplicao, aparece abaixo da opo Drivers e ao selecionar um Driver especfico,
suas propriedades so mostradas ao lado direito da rvore. Pressione o boto
Configurar para abrir a janela de configurao do driver de rede, que varia
conforme o driver selecionado. (Ver o captulo sobre drivers).
Na aplicao Cliente, depois de adicionar o driver de rede, voc precisa criar uma
Aplicao Remota e configurar seus parmetros.
Para criar ou editar uma Aplicao Remota, voc precisa selecionar a opo
Aplicaes Remotas na rvore da aplicao no Organizer. A pgina abaixo ser
mostrada contendo uma lista de todas as Aplicaes Remotas existentes na
aplicao. Voc pode criar uma nova Aplicao Remota usando o boto Novo
direita da pgina ou remover uma existente selecionando-a na lista e pressionando o
boto Deletar.

Figura 123: Aplicaes Remotas

Aplicaes Remotas

193

Manual do Usurio
Propriedades da Lista de Aplicao Remota
OPO
Lista

DESCRIO
Mostra uma lista de todas as Aplicaes Remotas existentes na sua
aplicao, elas aparecem na rvore do Organizer logo abaixo da
opo Remote Applications e quando selecionadas permitem a
edio de suas propriedades.

Novo

Cria uma nova Aplicao Remota.

Deletar

Remove da lista a Aplicao Remota selecionada.

Depois de adicionar uma Aplicao Remota, voc precisa configurar os parmetros


do Servidor conforme o driver selecionado. Para isso, pressione o boto
Configurar na pgina de Propriedades Gerais da Aplicao Remota (veja a
prxima seo).

194

Aplicaes Remotas

Manual do Usurio

14.1. Propriedades Gerais


Cada Aplicao Remota que voc cria para a aplicao, aparece abaixo da opo
Aplicaes Remotas na rvore da aplicao no Organizer. Ao selecionar uma
Aplicao Remota especfica, suas propriedades so mostradas ao lado direito da
rvore.
A pgina de propriedades Gerais da Aplicao Remota aparece quando selecionada
a aba Geral no topo das pginas da Aplicao Remota. Esta pgina mostrada
abaixo e seus respectivos campos so descritos na tabela que segue.

Figura 124: Propriedades Gerais

Aplicaes Remotas

195

Manual do Usurio
Propriedades Gerais de Aplicaes Remotas
OPO

196

Nome

DESCRIO
Define o nome da Aplicao Remota que ser usada
na rvore do Organizer e nos Scripts.

Descrio

Uma breve descrio sobre a Aplicao Remota.

Driver de rede

Permite a seleo de um Driver de Rede para a


Aplicao Remota corrente. Os drivers devem ser
instalados na opo Drivers da rvore da aplicao a
fim de que estejam disponveis.

Configurao de rede

Mostra a configurao de rede usada pelo driver


selecionado, por exemplo: porta remota, endereo de
rede remoto, endereo do nodo remoto. Nenhuma
edio permitida neste campo.

Conectar com o servidor


ao rodar a aplicao

Habilita a conexo com a Aplicao Remota


(Servidor) no incio da execuo da aplicao no
Elipse.

Ajuda

Mostra a Ajuda do Driver selecionado.

Configurao

Abre uma janela que permite configurar, os


parmetros da Aplicao Servidora (remota), por
exemplo, quando usando um driver MIRROR/SPX:
- Porta Servidora: define a porta de comunicao do
servidor (de 1 a 32767)
- Endereo da Rede: define o endereo de rede do
Servidor (8 caracteres hexa)
- Endereo do Nodo: define o endereo do nodo
Servidor (12 caracteres hexa)

Novo Tag Remoto!

Cria um novo Tag Remoto que aparece abaixo da


Aplicao Remota na rvore do Organizer. Cada Tag
Remoto criado na aplicao Cliente est associado a
um Tag na aplicao Servidora (remota).

Novo arquivo Remoto!

Cria um novo Arquivo Remoto que aparece abaixo


da Aplicao Remota na rvore do Organizer. O
Arquivo Remoto usado para obter um arquivo da
aplicao Servidora, o que deve ser feito usando-se as
funes dos Arquivos Remotos.

Novo Grupo

Cria um novo grupo de Tags Remotos que aparece


abaixo da Aplicao Remota ou de um outro grupo
deTags Remotos, na rvore do Organizer.

Aplicaes Remotas

Manual do Usurio

14.2. Scripts de Aplicaes Remotas


Scripts de Aplicaes Remotas geralmente esto associados a uma conexo remota.
Isto significa, por exemplo, que eles podem ser executados ao iniciar ou terminar
uma conexo.
Os Scripts disponveis para as Aplicaes Remotas so descritos na tabela abaixo.
Maiores detalhes a respeito do uso de Scripts, veja no captulo especfico.
Scripts Disponveis
Voc pode associar scripts a Aplicaes Remotas executando-os na situao a seguir:
EVENTOS
DESCRIO
Executa o Script ao terminar a conexo.
OnDisconnect

Aplicaes Remotas

197

Captulo

15
15.

Elipse Web

O mdulo adicional Elipse Web permite disponibilizar as telas da aplicao na Web


atravs de um servidor Web qualquer como por exemplo o PSW (Personal Web
Server) ou o IIS (Internet Information Services) do Windows. O servidor Web
precisa estar instalado na mquina onde est rodando a aplicao Elipse, e esta deve
possuir um IP fixo caso se queira acessar a aplicao pela Internet.
Para configurar o Elipse Web, siga os seguintes procedimentos:

Verifique se seu computador possui um servidor Web (PWS ou IIS). Em


caso negativo, instale-o.
O Elipse Web um mdulo adicional, portanto verifique se o hardkey possui
este mdulo.

No Elipse SCADA, acesse o Organizer e no item Aplicao, clique na aba


Web.

Habilite o item Habilitar servidor de dados para web, conforme a figura


abaixo:

Figura 125: Aba Web

Elipse Web

199

Manual do Usurio

Clique no boto [Localizar...] e especifique o diretrio padro do servidor


Web. No caso do PWS ou IIS, o diretrio padro C:\Inetpub\wwwroot.
Clique no boto [OK].
No item Porta, defina qual porta TCP/IP ser utilizada para comunicao
entre os applets e o supervisrio.
Feitas estas configuraes, copie o arquivo Applet.jar da pasta
C:\...\Elipse SCADA\Applet\ para a pasta padro do servidor Web.
Em cada tela que voc deseja visualizar pela Web, necessrio habilitar a
criao da pgina HTML. Para tanto, acesse as propriedades da tela e clique
na aba Web, conforme figura abaixo:

Figura 126: Aba Web acessada atravs das propriedades da Tela

Habilite a opo Criar Pgina Web e especifique o nome da pgina html a


ser criada. Estas pginas sero criadas no diretrio padro do servidor Web.
Para visualizar a aplicao, basta digitar na barra de endereos do browser o
endereo do servidor e o nome do documento HTML configurado (por
exemplo: http://NomedoServidor/Screen1.htm).

NOTAS:

200

O Elipse Web permite apenas a superviso da aplicao. No possvel


controlar, enviar dados ou interagir com a aplicao.

Ser acessvel somente a tela que estiver ativa na aplicao.

Elipse Web

Captulo

16
16.

Watcher

O Elipse Watcher um plug-in do Elipse SCADA que oferece captura,


armazenamento e transmisso digital de imagens. Com ele, possvel visualizar
imagens dentro de uma aplicao e trabalhar com elas como for desejado.
Cada placa de aquisio ligada ao Elipse SCADA representada por um objeto do
Watcher. Para acrescentar um equipamento, basta acrescentar um objeto
correspondente na lista de objetos.
possvel configurar os parmetros de cada um dos objetos independentemente.
Estes objetos so posteriormente ligados a um objeto de tela (Preview, AVI ou
Video) para sua utilizao dentro da aplicao ou ligados a um objeto AVI
Recorder, que permite a gerao de um arquivo .AVI. O Elipse Watcher possui
drivers para uma variedade de equipamentos do mercado. Consulte nosso
departamento tcnico para verificar a compatibilidade do seu com o Elipse SCADA.

Figura 127: Watcher

Watcher

201

Manual do Usurio

16.1. Objetos do Watcher


Cada objeto do Watcher representa um dispositivo ou placa de aquisio conectado
no sistema. Os objetos de captura de vdeo so ligados a "cmeras" (listadas na aba
Cameras do Watcher), que representam a entrada de vdeo do objeto em questo.
Quando configuramos objetos de tela para a apresentao de vdeo, temos que
indicar a qual cmera o objeto estar ligado, isto , qual entrada de vdeo ele ir
receber.

Figura 128: Tipos de objetos do Watcher

202

Watcher

Manual do Usurio

AVI Player
O objeto AVI Player permite a reproduo de um arquivo .AVI no sistema. Este
objeto do Watcher normalmente associado a um objeto de tela AVI.

Figura 129: Propriedades do AVI Player

Propriedades do AVI Player


OPO

Watcher

Nome

DESCRIO
Determina o nome do objeto.

Descrio

Uma breve descrio do objeto.

Arquivo AVI

Determina o caminho do arquivo AVI.

Localizar

Permite navegar pelo disco para indicar o arquivo


AVI de origem.

203

Manual do Usurio

AVI Recorder
O objeto AVI Recorder permite a gravao de uma entrada de vdeo (uma placa de
aquisio, por exemplo) em um arquivo formato .AVI.

Figura 130: Propriedades do AVI Recorder

204

Watcher

Manual do Usurio

Propriedades do AVI Recorder


OPO
Nome

DESCRIO
Determina o nome do objeto.

Descrio

Uma breve descrio do objeto.

Arquivo AVI

Determina a localizao e o nome do arquivo AVI a


ser gerado.

Localizar

Permite navegar pelo disco para indicar o arquivo


AVI de destino.

Fonte de Vdeo

Origem do vdeo a ser gravado.

Compresso

Determina como ser feita a compresso do AVI,


permitindo a escolha do compressor, qualidade e
outras configuraes.

Quadros por segundo

Determina a taxa de atualizao com a qual ser feita


a gravao.

Frame Grabber S611


Atravs desta opo, possvel configurar as especificaes referentes a interface
com placa de aquisio (frame-grabber) S611 da Sensoray.

Watcher

205

Manual do Usurio

Figura 131: Propriedades da interface com a placa S611

206

Watcher

Manual do Usurio

Propriedades da interface com a placa S611


OPO

Watcher

Nome

DESCRIO
Determina o nome do objeto.

Descrio

Uma breve descrio do objeto.

Entrada

Determina o tipo de entrada do video: S-Video,


Video 1, Video 2, Video 3 ou Video 4.

Tamanho da imagem

Determina o tamanho da imagem: Tamanho integral,


3/4 do tamanho, 1/2 do tamanho, 1/4 do tamanho ou
Avanado (determinando largura e altura).

Largura

Determina a largura da imagem. Esta opo s


vlida se o tem Avanado do Tamanho da imagem
estiver habilitado.

Altura

Determina a altura da imagem. Esta opo s vlida


se o tem Avanado do Tamanho da imagem estiver
habilitado.

Placa #

Determina as especificaes da placa.

Formato de Cor

Determina o formato da cor do video: (RGB 24 bits


ou Mono 8 bits)

Entrelaado

Habilita a opo entrelaado no sistema.

Formato do Sinal

Determina o formato do sinal do video: NTSC,


NTSC Japo, PAL, PAL-M, PAL-N.

Quadros por segundo

Determina quantos quadros por segundo sero


gravados no objeto.

207

Manual do Usurio

Frame Grabber S613


Atravs desta opo, possvel configurar as especificaes referentes a interface
com placa de aquisio S613 da Sensoray.

Figura 132: Propriedades da interface com a placa S613

208

Watcher

Manual do Usurio

Propriedades da interface com a placa S613


OPO

Watcher

Nome

DESCRIO
Determina o nome do objeto.

Descrio

Uma breve descrio do objeto.

Entrada

Determina o tipo de entrada do video: S-Video,


Video 1 ou Video 2.

Tamanho da imagem

Determina o tamanho da imagem: Tamanho integral,


3/4 do tamanho, 1/2 do tamanho, 1/4 do tamanho ou
Avanado (determinando largura e altura).

Largura

Determina a largura da imagem. Esta opo s


vlida se o tem Avanado do Tamanho da imagem
estiver habilitado.

Altura

Determina a altura da imagem. Esta opo s vlida


se o tem Avanado do Tamanho da imagem estiver
habilitado.

Placa #

Determina as especificaes da placa.

Formato de Cor

Determina o formato da cor do video: (RGB 24 bits


ou Mono 8 bits)

Entrelaado

Habilita a opo entrelaado no sistema.

Formato do Sinal

Determina o formato do sinal do video: NTSC,


NTSC Japo, PAL, PAL-M, PAL-N.

Quadros por segundo

Determina quantos quadros por segundo sero


gravados no objeto.

Compresso da imagem

Determina como a imagem ser comprimida: Sem


compresso ou compresso M JPEG.

Fator

Determina o fator do MJPEG (Esta opo s


habilitada, se for selecionada o tem MJPEG na opo
acima).

209

Manual do Usurio

Dispositivos com Suporte a Video for Windows


Atravs de esta opo, possvel configurar as especificaes referentes a entrada de
video atravs de dispositivos com suporte ao padro Video for Windows.

Figura 133: Propriedades do Dispositivo com Suporte a Video for Windows

Propriedades do Dispositivo com Suporte a Video for Windows


OPO

210

Nome

DESCRIO
Determina o nome do objeto

Descrio

Uma breve descrio do objeto.

Dispositivo de Video

Determina a o dispositivo de video habilitado no


sistema.

Compresso de video

Habilita a compresso do video

Visualizao de video

Habilita a visualizao do video

Formato de video

Habilita a configurao do formato do video

Fonte de video

Determina as especificaes referentes a fonte do


video.

Watcher

Manual do Usurio

Placa de Captura Xpress Plus


Atravs desta opo, possvel configurar as especificaes referentes placa de
captura XPressPlus da IntegralTech. Esta placa permite o controle de at 32
cmeras, que podem ser configuradas separadamente.

Figura 134: Propriedades da Plca a de captura Xpress Plus

Propriedades da Plca a de captura Xpress Plus


OPO

Watcher

Nome

DESCRIO
Determina o nome do objeto.

Descrio

Uma breve descrio do objeto.

Nmero de

Especifica o nmero de cmeras que sero inseridas


pelo boto Inserir Cmeras. Permite criar objetos
que representaro as cmeras conectadas placa.

Inserir Cmeras

Insere o nmero de objetos "Camera" especificado


em Nmero de. A placa XPressPlus tem um limite
de 32. As excedentes sero ignoradas.

Arquivo

Nome do arquivo (com o caminho completo) onde o


vdeo ser gravado.

Formato do Sinal

Formato do sinal que est sendo recebido.

Nmero da Placa

Nmero de identificao da placa.

211

Manual do Usurio

Cmeras
Com a placa XPressPlus possvel gerenciar e ajustar opes de todas as cmeras
conectadas, individualmente. As configuraes so feitas atravs de um objeto
Camera, que representa a cmera em questo. Estes objetos so criados atravs do
boto Inserir Cameras, mostrado no item anterior. Cada cmera tem trs conjuntos
de opes, a saber: Geral, Opes de Gravao e Mscara.
a) Propriedades Gerais

Figura 135: Propriedades gerais de cmeras Xpress Plus

Propriedades gerais de cmeras Xpress Plus


OPO

212

Nome

DESCRIO
Determina o nome do objeto.

Descrio

Uma breve descrio do objeto.

Cmera

Determina a cmera em foco.

Brilho

Determina o brilho da imagem da cmera.

Saturao

Determina a saturao da imagem da cmera.

Contraste

Determina o contraste da imagem da cmera.

Hue

Determina o Hue da imagem da cmera.

Foco

Determina o foco da imagem da cmera.

Watcher

Manual do Usurio

b) Opes de Gravao
Atravs deste item possvel ajustar as opes de gravao da placa de captura.

Figura 136: Propriedades das Opes de Gravao

Watcher

213

Manual do Usurio
Propriedades das Opes de Gravao
OPO
Opes de gravao

DESCRIO
Configura as opes de gravao da cmera:
- Habilitar gravao: habilita a gravao na cmera
selecionada.
- Habilitar seqncia: habilita a gravao em
sequncia na cmera.
- Deteco de movimento: habilita a gravao na
cmera a cada deteco de movimento.
- Sem gatilho de prioridade: habilita a gravao
sem gatilho de prioridade.
- Gravao por Gatilho: habilita a gravao por
gatilho.

rea

Determina a rea de gravao da cmera.

Sensitividade

Determina a sensitividade da gravao da cmera.

Campo/ciclo

Determina o campo/ciclo da gravao da cmera.

Tam.quadro

Determina o tamanho do quadro de gravao da


cmera.

QPS

Determina o QPS da gravao da cmera.

Opes de gatilho

Determina as opes de gatilho da gravao da


cmera.

c) Mscara
Definir uma mscara indicar reas de sensibilidade, isto , deteco de movimento
de cada entrada de vdeo. As reas em vermelho representam os lugares nosensveis. As reas em verde-claro, as reas sensveis.

214

Watcher

Captulo

17
17.

Steeplechase

O objeto Steeplechase configura as especificaes referentes ao Steeplechase, que


um SoftPLC ao qual o Elipse SCADA d suporte. Atravs deste objeto, possvel
a comunicao com este dispositivo.
Atravs de suas propriedades, possvel configurar o caminho pelo qual o sistema
buscar as informaes no servidor local ou da rede. Aps configuradas as
especificaes, o sistema verifica a autorizao da licena e ativa ou no a
comunicao. Somente em algumas verses do Elipse SCADA esta opo
disponvel.
As propriedades para esta opo so os seguintes:

Figura 137: Steeplechase

Steeplechase

215

Manual do Usurio
Propriedades do Steeplechase
OPO

216

Nome

DESCRIO
Determina o nome do objeto.

Scan

Determina o valor do scan.

Importar Tags

Permite importar tags.

Wizard

Abre um wizard de configurao para o steeplechase.

Descrio

Uma breve descrio sobre o objeto.

Nome do Servidor

Determina o nome do servidor do steeplechase.

Status

Determina o status do objeto.

Status do VLC

Determina o status do VLC (Virtual Logic


Controler).

Projeto do VLC

Determina o projeto do VLC (Virtual Logic


Controler).

Verso

Determina a verso do objeto.

Steeplechase

Captulo

18
18.

OPC Server

O objeto OPCServer um cliente OPC (OLE for Process Control) que possibilita a
comunicao com um determinado equipamento ou dispositivo, utilizando o
protocolo OPC. O objeto OPCServer a representao de um servidor OPC DA
(Data Access) dentro do Elipse SCADA, o que permite o envio e recebimento de
dados de tempo real (tags).

Figura 138: Objetos OPCServer no Organizer

OPC Server

217

Manual do Usurio

18.1. Propriedades Gerais do OPC Server

Figura 139: Propriedades Gerais do OPC Server

Propriedades Gerais do OPC Server


OPO

218

DESCRIO

Nome

Nome do objeto.

Descrio

Uma breve descrio sobre o objeto.

Manter conexo ativa

Quando habilitado, a conexo com o servidor


estabelecida uma vez e mantida at o encerramento da
aplicao. Quando desabilitado, o Elipse SCADA ir
estabelecer conexes com o servidor OPC toda vez que
precisar solicitar um dado.

BlockMode

Quando habilitado, permite que tags OPC sejam


adicionados ou removidos em blocos, aumentando a
performance.

Novo Tag

Permite criar manualmente um novo tag OPC.

Novo Grupo

Permite agrupar tags em grupos, a fim de facilitar a sua


organizao.

OPC Server

Manual do Usurio

OPO
Log...

DESCRIO
Permite habilitar o registro (log) do servidor e definir o
nome e caminho do arquivo de log.

Endereo na rede

Endereo do servidor OPC na rede. Este campo permite a


atribuio direta, quando no for possvel navegar na rede
para selecionar o servidor.

ID do servidor

Nome do servidor OPC.

Informaes do fabricante

Apresenta as informaes sobre o servidor OPC,


registradas pelo fabricante.

Localizar...

Permite selecionar o servidor OPC dentre os servidores


ativos.

Verso...

Informa a verso do servidor OPC.

Importar...

Permite a importao de tags ou grupos de tags definidos


no servidor OPC. Obs.: este recurso pode no estar
disponvel no servidor OPC.

Verificar servidor OPC a cada ...


segundos
Recuperar conexes perdidas a
cada ... segundos

Habilita a verificao do servidor OPC no perodo (em


segundos) determinado no campo.

Leituras de Fundo/Habilita

Habilita a leitura dos tags em segundo plano. o modo


mais eficiente de leitura, com um mnimo de
comunicao entre o Elipse SCADA e o servidor OPC.
Os dados s so atualizados quando ocorrerem variaes
maiores que a Banda Morta definida pelo usurio (ver
opo Banda Morta).

Scan

Indica o tempo da atualizao dos tags em segundo


plano. Este valor poder ser aproximado pelo servidor, de
acordo com suas caractersticas internas. Um valor zero
(0) requisita ao servidor um tempo de atualizao menor
possvel.

Banda Morta (%)

Percentual que especifica a faixa de variao considerada


no-significativa. Isto , variaes dentro desse
percentual no so notificadas ao sistema pelo servidor.
Um valor zero (0) por exemplo, mandaria qualquer
variao. Obs.: a utilizao dessa caracterstica depende
diretamente do servidor OPC utilizado. Consulte a
documentao do servidor.

OPC Server

Habilita a recuperao de conexes perdidas no perodo


(em segundos) determinado no campo. Obs.: s vlida
se a opo Verificar servidor OPC a cada ... segundos
estiver habilitada.

219

Manual do Usurio

18.2. Tags OPC


Os tags OPC permitem a troca de informaes com servidores OPC. Atravs deles,
possvel enviar e receber dados ao servidor OPC.

Figura 140: Propriedades de tags OPC

Propriedades de Tags OPC


OPO
Nome
Descrio
Nome Real

220

DESCRIO
Determina o nome do tag OPC.
Breve descrio sobre o tag.
Identificador do tag dentro do servidor OPC
(caminho).

OPC Server

Manual do Usurio

OPO
Modo de Leitura

Ler do (a)

Escala

OPC Inferior
Sistema Inferior
OPC Superior
Sistema Superior
Scan
Testar conexo aqui

Habilita a leitura pelo scan


Habilita a escrita automtica
Novo Elemento da Matriz!

OPC Server

DESCRIO
Especifica o modo de leitura dos tags no servidor
OPC.
Sncrono - faz a solicitao de leitura do tag e
aguarda o retorno do servidor.
Fundo (ou Segundo Plano) - os dados s so
atualizados quando ocorrerem variaes
significativas (fora da Banda Morta). Veja as
propriedades do servidor OPC.
Define qual a origem dos dados lidos do servidor
OPC.
Dispositivo - fora a leitura o dado diretamente do
dispositivo conectado ao servidor.
Cache - solicita o valor armazenado no cache do
servidor.
Marcando esta opo, os valores do Tag sero
convertidos para uma nova escala de valores,
determinada pelo usurio conforme os limites
definidos em OPC Inferior, OPC Superior, Sist.
Inferior e Sist. Superior.
Define o valor mnimo a ser lido do servidor OPC.
Define o novo valor mnimo para a converso dos
valores lidos.
Define o valor mximo a ser lido do servidor
OPC.
Define o novo valor mximo para a converso dos
valores lidos.
Determina o valor do Scan.
Permite que voc teste a configurao do Tag
OPC, tanto para escrita quanto para leitura. Uma
mensagem pode indicar um erro de conexo ou o
valor recebido pelo item configurado.
Habilita a leitura peridica do tag OPC. O perodo
definido no campo Scan.
Habilita escrita automtica para o tag OPC.
Acrescenta elementos a um tag OPC tratado como
uma matriz (array). Permite a leitura de variveis
definidas como matrizes no servidor.

221

Manual do Usurio

Pgina de Alarmes

Figura 141: Pgina de alarmes

Propriedades da Pgina de Alarmes


OPO
LoLo

222

DESCRIO
Alarme Baixo Crtico. Define um intervalo de valores
(menor igual) onde o Tag OPC considerado em um
estado de Alarme Baixo Crtico. usado quando o
valor do Tag OPC est abaixo de um mnimo, ou
seja, extremamente baixo.

Low

Alarme Baixo. Define um intervalo de valores


(menor igual) onde o Tag OPC considerado em
estado de alarme baixo. usado quando o valor do
Tag OPC est abaixo do normal.

High

Alarme Alto. Define um intervalo de valores (maior


igual) onde o Tag OPC considerado em estado de
Alarme Alto. usado quando o valor do Tag OPC
est mais alto do que o normal.
OPC Server

Manual do Usurio

OPO
HiHi

OPC Server

DESCRIO
Alarme Alto Crtico. Define um intervalo de valores
(maior igual) onde o Tag OPC considerado em
estado de Alarme Alto Crtico. usado quando o
valor do Tag OPC est acima de um mximo, ou
seja, extremamente alto.

Valor

Define os limites para cada situao possvel de


alarme (lolo, low, hi, hihi).

Pri

Define a prioridade para cada situao de alarme.


Nmeros pequenos indicam alta prioridade (a
prioridade deve ser um nmero entre 0 e 999). Para
um melhor controle os alarmes de maior prioridade
iro aparecer em primeiro plano na janela de alarmes
(objeto de tela Alarme).

Comentrios

Um comentrio ou mensagem pode ser definido para


cada alarme.

Logar mensagens de
retorno
Grupo de Alarmes

Habilita o registro (log) das mensagens de retorno de


alarme.

Manter o valor do tag


sempre atualizado

Define que o sistema ir supervisionar o Tag OPC


constantemente, mesmo que ele no esteja sendo
utilizado em nenhum lugar da aplicao, a fim de no
perder nenhum alarme deste tag.

Usa outro nome de tag

Permite definir um nome alternativo para o tag.

Ativar alarme aps espera


de

Ativa o alarme aps o tempo (em milissegundos)


determinado.

Define o grupo de Alarmes do tag corrente. O grupo


de Alarmes deve ser definido na opo Alarmes do
Organizer.

223

Manual do Usurio

18.3. Grupo OPC


Os grupos OPC permitem uma organizao visual dos tags OPC, facilitando sua
manipulao. Em muitos casos, estes grupos so criados automaticamente durante a
importao de tags do servidor, refletindo a estrutura hierrquica do prprio.

Figura 142: Propriedades de Grupos OPC

Propriedades do Grupo OPC

224

OPO
Nome

DESCRIO
Especifica o nome do objeto.

Descrio

Uma breve descrio do objeto.

Novo Grupo

Insere um novo Grupo OPC no objeto OPCServer.

Importar

Permite importar tags ou grupos de tags definidos no servidor


OPC para o Grupo OPC em questo.

OPC Server

Manual do Usurio

Quando acionado o boto Importar tags, a janela abaixo mostrada. A partir da,
basta arrastar o tag desejado para o grupo selecionado.

Figura 143: Assistente de importao

18.4. Qualidade
Os campos de qualidade representam o estado de qualidade do valor do item. formado de
uma palavra de 16 bits, sendo que os primeiros 8 bits so definidos na forma de 3 campos de
bits: Campo Qualidade, Campo Substatus e Campo Limite.
Os outros 8 bits (de maior ordem) esto disponveis para uso de cada fabricante. Se esses
bits forem utilizados, os bits de qualidade padro ainda so utilizados para indicar quais
dedues pode-se fazer sobre os dados retornados. Assim, de responsabilidade do cliente
interpretar o campo de informaes especficas de qualidade para garantir que o servidor
que est provendo essa informao usa as mesmas regras que o cliente.

OPC Server

225

Manual do Usurio
Campo Qualidade
QUALIDADE
0 63

CAMPO QUALIDADE
Ruim

64 127

DESCRIO
O valor no usvel pelas
razes indicadas no substatus.

Incerta

A qualidade do valor incerta


pelas razes indicadas no
substatus.

128 191

(Reservado)

No usado pelo padro OPC.

192 255

Boa

A qualidade do valor Boa.

Um servidor que no suporta informao de qualidade retorna 192 sempre (Bom).


Tambm aceitvel que um servidor retorne simplesmente Ruim ou Bom (0 ou
192) e sempre retornar 0 para o Substatus e limite.

226

OPC Server

Captulo

19
19.

Scripts

Os Scripts so pequenos procedimentos escritos em linguagem de programao


prpria Elipse Basic que permitem uma maior flexibilidade na sua aplicao. O
scripts so sempre associados a eventos, isto , eles so iniciados no momento da
ocorrncia deste evento.

19.1. Consideraes Gerais


Em qualquer linguagem de programao, necessria a criao de mtodos, de
modo a especificar e ordenar a execuo das instrues desejadas. A prpria
estrutura dos scripts do Elipse SCADA j organiza de certa maneira esta ordem, pois
so orientados a eventos.
Os eventos so ocorrncias relacionadas a um objeto, que podem ser tratadas de
modo a se realizar uma ao especfica. Eles podem ser fsicos, como por exemplo,
alguma ao no teclado ou no mouse. Em cada caso, temos diversas informaes
relevantes como a tecla pressionada ou a posio do cursor e o status dos botes. Os
eventos podem ser internos, como a mudana do valor de uma varivel. Estes
eventos podem tambm ter associaes fsicas, como a mudana de uma temperatura
de uma cmara de 10 para 11 graus quando temos um tag que recebe os valores
dessa temperatura. O Elipse SCADA j tem diversos eventos pr-definidos
disponveis para a ligao ou associao de scripts. Exemplos de alguns desses
eventos so listados a seguir.
Eventos comuns em aplicaes no ElipseSCADA

Scripts

OPO
OnKeyPress

DESCRIO
Quando uma tecla pressionada

OnKeyRelease

Quando uma tecla liberada

OnSetFocus

Quando um objeto recebe o foco de edio

OnLButtonDown

Quando o boto esquerdo pressionado sobre um objeto

OnPress

Quando um objeto boto pressionado

OnRelease

Quando um objeto boto liberado

WhileRunning

Enquanto uma aplicao est executando

OnAlarm

Quando ocorre qualquer tipo de alarme

227

Manual do Usurio

A linguagem utilizada nos mdulos de script, o Elipse Basic, bastante similar s


linguagens C, porm com recursos de programao visuais como os encontrados no
Visual Basic. Algumas caractersticas da linguagem:
No necessrio a declarao de variveis ou funes no incio do Script. As
variveis devem ser tags, objetos ou atributos previamente criadas ou importadas
de outras aplicaes. O Elipse SCADA j possui algumas variveis de sistema
pr-definidas.
O tipo de dado que se atribui a um tag livre. O valor suportado pode ser desde
um inteiro de 8 bits at um tipo real de 64 bits ou ainda um string (texto). Em
comunicao de dados com equipamentos externos, a converso feita
automaticamente, de acordo com os tipos suportados pelo equipamento. No caso
de propriedades, um cone ao lado de cada uma (visualizado atravs do
AppBrowser) indica o tipo de dado suportado:
Atributo numrico
(nmero inteiro)
Atributo numrico
(nmero real)
Atributo string (texto)
Atributo booleano (0
ou 1)

As variveis e constantes so os objetos bsicos manipulados num Script. Os


operadores especificam o que ser realizado com os mesmos. As expresses
combinam variveis e constantes para produzir novos valores. Para facilitar a edio
de scripts ou de tags expresso, podem ser usadas as ferramentas AppBrowser e
Referncia Cruzada.

228

Scripts

Manual do Usurio

19.2. AppBrowser e Referncia Cruzada


O AppBrowser permite navegar facilmente pela aplicao. Quando voc seleciona
um objeto na rvore ao lado esquerdo da janela, seus atributos e funes
correspondentes so listados direita.
Voc pode usar o AppBrowser como referncia durante a edio de um script. Uma
caracterstica bastante til a possibilidade de selecionar um objeto, atributo ou
funo que voc deseja utilizar e copiar diretamente para o script pressionando o
boto Copia no Script ->.
A ferramenta Referncia Cruzada possui a mesma estrutura do AppBrowser com a
diferena que quando voc seleciona um objeto na rvore ao lado esquerdo da
janela, suas respectivas referncias que so listadas direita. D um duplo-clique
sobre uma referncia para ir ao objeto referido.

Figura 144: AppBrowser

Opes disponveis no App Browser

Scripts

OPO
Seleo

DESCRIO
Mostra o nome do objeto, atributo e funo selecionado, da mesma
forma que ser copiado para o script.

Objetos

Lista dos objetos em ordem hierrquica.

Info

Mostra uma descrio do item selecionado.

Propriedades

Lista dos atributos e funes do objeto selecionado.

Exibir

Permite filtrar a informao (atributos ou funes) listada na janela


de propriedades.

Copia no Script

Copia a referncia do atributo ou funo selecionado para o script.

229

Manual do Usurio

19.3. Operadores e Constantes


Listamos as constantes (com suas notaes) e operadores que podem ser utilizados
nos scripts.
Constantes
TIPOS
Inteiros (32 bits, dec)

1234, 1234d, -993

EXEMPLO

Inteiros (32 bits, bin)

11001110b (no permite sinal)

Inteiros (32 bits, octal)

7733o (no permite sinal)

Inteiros (32 bits, hex)

0A100h,
3B8h
(no
permite
sinal)
(se o primeiro dgito A-F, coloque um zero na
frente)

Nmeros reais (64 bits)

133.443, 344.939 (no tem notao cientfica)

Strings

"Temperatura", "presso"
Operadores Aritmticos

OPERADOR
+ (adio)

tag001 + 34

EXEMPLO

+ (concatenao de strings)

slider1.Frame.title + "<- PLC1"

- (subtrao)

tag001 - screen1.x

* (multiplicao)

screen1.width * 3.141592

/ (diviso)

tag001 / tag002

% (resto da diviso)

tag001 % tag002

** (exponenciao)

tag001 ** 2 (tag001 ao quadrado)


Operadores lgicos

230

OPERADOR
& (E bit-a-bit)

flags & 0F000h

EXEMPLO

| (OU bit-a-bit)

flags | 0F000h

^ (OU exclusivo bit-a-bit)

flags ^ 0F000h

~ (NO bit-a-bit)

~flags

<< (SHIFT esquerda)

flags
<<
2
(desloca o valor de flags dois bits para a esquerda)

>> (SHIFT direita)

flags
>>
(desloca o valor de flags dois bits para a direita)

AND (E lgico)

tagOnOff AND (tag001 > 200)

OR (OU lgico)

tagOnOff OR (tag001 > 200)

XOR (OU exclusivo)

tagOnOff XOR (tag001 > 200)

NOT (negao)

NOT tagOnOff

Scripts

Manual do Usurio

Precedncia de Operadores (Ordem de Execuo)


A tabela abaixo lista as regras para precedncia e associao de todos os operadores.
+ - ~ NOT (operadores unrios)
**
/%
+>> <<
>= < <=
== <>
&
^
AND, XOR e OR
= += -= *= /= %= &= |= ^= **= <<= >>=

19.4. Controle de Fluxo


A fim de controlar a ordem na qual as instrues so processados o Elipse Basic
disponibiliza uma srie de comandos para fazer desvios e condies. Estes
comandos so tratados a seguir.

19.4.1. Comando If...Else...ElseIf...EndIf


Permite a tomada de decises durante a execuo de um script.
Sintaxe:

Scripts

231

Manual do Usurio
If <condio1>
<bloco de instrues 1>
Else
<bloco de instrues n>
EndIf
If <condio1>
<bloco de instrues 1>
ElseIf <condio2>
<bloco de instrues 2>
Else
<bloco de instrues n>
EndIf

As condies especificadas so expresses que podem ser avaliadas como


verdadeiras (diferente de zero) ou falsas (zero ou string vazio ""). Se a condio for
verdadeira o bloco de instrues executado at o comando EndIf.
Quando este comando executado, a condio do If (condio1) avaliada
primeiro, caso verdadeira o bloco de instrues 1 executado encerrando o comando
com o EndIf. Se a condio1 for falsa a condio do ElseIf (condio2) avaliada e
o bloco de instrues 2 executado caso esta seja verdadeira. Se for falsa a prxima
condio ElseIf ser avaliada e assim por diante. Se nenhuma condio ElseIf for
verdadeira o bloco de instrues do Else ser executado. O programa continua sua
execuo com o comando aps o EndIf.
Blocos de instrues ElseIf e Else so opcionais. Voc pode especificar tantas
clusulas ElseIf desejar, entretanto elas nunca podero estar aps uma clusula Else.
Qualquer bloco de instrues pode conter comandos IfEndIf aninhados.

19.4.2. Comando For...Next


Repete um bloco de instrues um determinado nmero de vezes. A esta repetio
damos o nome de Lao ou Loop.
Sintaxe:
For <contador> = <incio> To <fim>
<bloco de instrues>
Next

19.4.3. Comando While...Wend


Executa um bloco de instrues enquanto uma determinada condio verdadeira.

232

Scripts

Manual do Usurio

Sintaxe:
While <condio>
<bloco de instrues>
Wend

A condio especificada uma expresso que pode ser avaliada como verdadeira
(diferente de zero) ou falsa (zero ou string vazio ""). Se a condio for verdadeira o
bloco de instrues executado at a instruo Wend, quando, ento, a condio
avaliada novamente. O bloco de instrues ser repetido at que a condio seja
falsa, quando o comando depois da instruo Wend ser executado. Laos
While...Wend podem ser aninhados.

19.4.4. Comando Repeat...Until


Executa um bloco de instrues at que determinada condio seja verdadeira.
Sintaxe:
Repeat
<bloco de instrues>
Until <condio>

A condio especificada uma expresso que pode ser avaliada como verdadeira
(diferente de zero) ou falsa (zero ou string vazio ""). O bloco de instrues
executado e aps a condio avaliada. Se for falsa, o bloco de instrues
repetido e a condio avaliada novamente. O bloco de instrues ser repetido
at que a condio seja verdadeira, quando ento, o comando depois da instruo
Until ser executado. Laos Repeat...Until podem ser aninhados.

19.4.5. Comando Return


Encerra a execuo imediatamente, retornando ao ponto de onde foi chamado o
script.

19.5. Funes Especiais


O Elipse SCADA possui uma srie de funes especiais pr-definidas que auxiliam
na edio de scripts, facilitando a execuo de tarefas mais complexas e permitindo
uma melhor configurao do seu sistema.
Atravs da ferramenta AppBrowser podemos ver as diversas funes especiais
disponveis para cada objeto durante a edio de scripts.
Destacamos o objeto Gerenciador Global, que traz funes de utilidade geral, como
funes de datas e do relgio de tempo-real, manipulao de strings e converses
numricas, arquivos, multimdia e outras.
Scripts

233

Manual do Usurio

Alm deste, temos diversos outros objetos que possuem funes especficas
relacionadas: Aplicao, Tags, Telas, Objetos de Tela, Alarmes, Receitas,
Histricos, Relatrios, Consulta, Plotagem, Drivers, Databases e Aplicaes
Remotas.
Este captulo apresenta a lista completa de todas as funes disponveis no Elipse
SCADA, divididas por objeto, em ordem alfabtica. Cada entrada indica o prottipo
da funo com seus parmetros entre parnteses. Os parmetros entre colchetes so
opcionais. Seguindo a entrada da funo, h a explicao de que ela faz e os seus
parmetros.

19.5.1. Funes do Gerenciador Global


Abs(x)

Retorna o valor absoluto de X.


Exemplo:
tag001 = Abs(-5.14) // Retorna 5.14
ACos(x)

Retorna arco cosseno (ngulo) do valor x no intervalo [0, ] radianos. O parmetro x


deve estar contido no intervalo [-1, 1], caso contrrio a funo retorna zero.
Asc(string)

Retorna o cdigo ASCII para o primeiro caractere de string.


Exemplo:
tag001 = Asc("screen") // Retorna 115
ASin(x)

Retorna arco seno (ngulo) do valor x no intervalo [-/2, /2] radianos. O parmetro
x deve estar contido no intervalo [-1, 1], caso contrrio a funo retorna zero.
ATan(x)

Retorna arco tangente (ngulo) do valor x no intervalo [-/2, /2] radianos.


Blue(Cor)

Retorna o valor do componente azul de Cor.


Ver funo Red().

234

Scripts

Manual do Usurio

CaptureAppScreen([nomedoarquivo],[nomedatela],[tipo])

Captura a tela especificada no parmetro nomedatela e salva-a em um arquivo de


formato BMP com nome especificado em nomedoarquivo. Se o parmetro
nomedoarquivo a for em branco (" "), a captura colocada na rea de
transferncia.
O parmetro tipo determina como a tela ser capturada: se o parmetro for 0, toda a
tela capturada, inclusive a barra de tarefas do Windows; se for 1 (ou qualquer valor
diferente de 0), apenas a rea que abrange os objetos da tela capturada (o tamanho
fica sendo o contorno ao redor de todos os objetos de tela).
Exemplo:
IF CaptureAppScreen("tela.bmp", "Tela1",1)
MessageBox("Tela1 capturada no arquivo tela.bmp")
ELSE
MessageBox("Erro capturando a tela!")
ENDIF
IF CaptureAppScreen("", "Tela1",1)
MessageBox("Tela1 capturada para a rea de transferncia")
ELSE
MessageBox("Erro capturando a tela!")
ENDIF

CaptureScreen([nomeArquivo])

Captura a toda a tela do sistema colocando-a na rea de transferncia (se nenhum


arquivo for especificado no parmetro nomeArquivo) ou em um arquivo com nome
nomeArquivo, no formato BMP.
Exemplo:
IF CaptureScreen("tela.bmp")
MessageBox("Tela capturada no arquivo tela.bmp")
ELSE
MessageBox("Erro capturando a tela!")
ENDIF
Chr(n)

Retorna o caractere representado pelo cdigo ASCII especificado.


Exemplo:
tag001 = Chr(115) // retorna "s"

Scripts

235

Manual do Usurio
CopyFile(arqFonte, arqDestino)

Copia os contedos do arquivo arqFonte para o arqDestino. A funo retorna 1


(um) se foi bem sucedida e 0 (zero) caso contrrio. Os atributos globais lastError e
lastErrorStr so atualizados por essa funo.
Exemplo:
IF CopyFile("source.dat", "dest.dat")
MessageBox ("A cpia foi bem sucedida.")
ELSE
MessageBox("Erro no comando CopyFile!")
ENDIF
CopyObject(strSrcName, strDestName [, strDestFolder])

Cria uma cpia do objeto strSrcName com o nome strDestName. O novo objeto
criado na mesma pasta do objeto-fonte como padro, a no ser que o destino seja
indicado no parmetro opcional strDestFolder. A funo retorna True se for bem
sucedida ou False caso contrrio.
Exemplo:
// Cria uma cpia do objeto Display1 na pasta
// Screens.Screen1; o novo objeto ser chamado Display2
CopyObject ("Screens.Screen1.Display1", "Display2")
// Cria uma cpia de Display1 na pasta Screens.Screen1
// o novo objeto ser chamado Display2 e ser colocado
// na pasta Screens.Screen2
CopyObject ("Screens.Screen1.Display1",
"Display2", "Screens.Screen2")
Cos(angle)

Retorna o cosseno do ngulo especificado. O ngulo angle expresso em radianos.


CreateDir(dir)

Cria um novo diretrio, especificado no parmetro dir. Retorna TRUE se for bem
sucedida ou FALSE se falhar. Os atributos globais lastError e lastErrorStr so
atualizados por essa funo.
CreateFile(nomeArquivo, string)

Cria um arquivo chamado nomeArquivo, escreve o texto string no arquivo e fecha


o arquivo. Se o arquivo j existir, ele destrudo e substitudo pelo novo contedo.
Retorna FALSE em erro ou TRUE caso contrrio.

236

Scripts

Manual do Usurio

DDEExecute(servidor, tpico, comando)

Envia um comando DDE para outra aplicao. O parmetro servidor o nome do


servidor DDE, normalmente o nome de uma aplicao, o parmetro topico um
documento aberto na aplicao e o parmetro comando o comando que voc quer
executar.
Exemplo:
DDEExecute("Excel", "Sheet1", '[SELECT("R1C1:R5C1")]')
DDEExecute("Excel", "Sheet1",
"[PRINT(1;;;1;FALSE;FALSE;1;FALSE;1;360;360)]")

O primeiro exemplo seleciona a regio a ser impressa, o segundo executa o comando


de impresso. O primeiro parmetro sempre o nome da aplicao. O segundo
parmetro a planilha ou documento que voc quer acessar, incluindo o caminho e a
extenso do arquivo. O terceiro parmetro o comando.
Deg(angle)

Retorna o ngulo angle, expresso em graus, convertido para radianos, segundo a


frmula degrees = (radians / 3.141592) * 180.
Exemplo:
tag001 = Deg(ACos(x)) // Arcosseno de x expresso em graus
DeleteFile(arquivo)

Apaga o arquivo especificado no parmetro arquivo. Retorna TRUE se for bem


sucedida ou FALSE se falhar. Os atributos globais lastError e lastErrorStr so
atualizados por essa funo.
DeleteObject(strNomeObjeto)

Apaga o objeto strNomeObjeto da aplicao.


EditProperties()

Abre uma janela que permite a edio das propriedades do Gerenciador Global.
Execute(CmdLinha)

Executa o programa especificado no parmetro CmdLinha. Se o programa no est


localizado no diretrio do \WINDOWS ou \WINDOWS\SYSTEM, voc deve
especificar a localizao do arquivo. Parmetros do programa tambm podem ser
includos na linha de comando CmdLinha.
Exemplo:

Scripts

237

Manual do Usurio
Execute("C:\WINDOWS\WINCALC.EXE")
Execute("C:\UTIL\PKZIP.EXE DATA C:\DATA\*.*")

Esta funo no aceita parmetros no CE. Use a funo ShellExecute().


Exp(x)

Retorna a funo exponencial de x.


Exemplo:
tag001 = Exp(2.302585093)

// retorna 10.0

FileSelectWindow([filepath][, extension][, type])

Mostra uma janela para a seleo de um arquivo. Retorna um string contendo o


nome do arquivo selecionado ou um string vazio, se falhar ou for cancelado pelo
usurio. O parmetro filepath especifica o arquivo ou diretrio que estar
previamente marcado. O parmetro extension especifica os tipos de arquivos que
podero ser selecionados. Sua sintaxe :
filterName1 | mask1 |

filterNameN | maskN

Cada filtro uma seqncia de dois strings separados por um |. O primeiro string
o nome do filtro que ser mostrado na caixa combo e o segundo string a mscara
de seleo de arquivos (*.dat, por exemplo). A mscara pode conter uma seqncia
de mscaras, separadas por ponto-e-vrgula (por exemplo, *.bmp;*.jpg;*.gif). Os
filtros devem estar separados por |.
Exemplo:
dim strDir
strdir = FileSelectWindow("C:\temp\*.dat",_
"Arquivos de Historico (*.dat)|*.dat")

O parmetro type um inteiro que especifica a maneira que o arquivo ser


selecionado, de acordo com a tabela:
VALOR
0

DESCRIO
Abre uma janela de seleo de arquivo; no permite que o usurio
digite nada, s escolher os arquivos existentes.

Permite o usurio criar um novo arquivo, digitando o nome do


arquivo a ser criado.

Permite o usurio digitar o nome do arquivo desejado e retorna o


caminho (path) completo; no cria o arquivo.

FillString(string, nCount)

Retorna um string contendo o parmetro string tantas vezes quantas especificadas


em nCount.
238

Scripts

Manual do Usurio

Exemplo:
// retorna "PasswordPassword" em String
String = FillString("Password", 2)

FindFirstFile(nome[, atributos])

Procura pelo primeiro arquivo a partir de um determinado padro de nome e


atributos especficos, retornando o nome do arquivo encontrado. O atributo nome
determina o padro de arquivo a ser procurado (por exemplo: "\DATA\*.DAT") e o
parmetro atributos opcional e determina a soma dos atributos desejados no
arquivo, segundo a tabela:
VALOR
0
1
2
4
16
32

ATRIBUTO
Normal, sem atributos
Somente leitura (read only)
Oculto (hidden)
Arquivo de sistema (system)
Diretrio (directory)
Arquivo-morto (archive)

Por exemplo, para colocar o atributo System (arquivo do sistema) e Hidden


(oculto), deve atribuir o numeral 6, isto : system (4) + hidden (2) = 4+2 = 6.
A funo retorna o nome do primeiro arquivo que satisfaz os parmetros ou vazio
("") caso nenhum arquivo seja encontrado. Aps chamar FindFirstFile() a funo
FindNextFile() pode ser chamada para encontrar outros arquivos que satisfaam
essas condies.
Se o parmetro atributos no for especificado, os atributos no so considerados.
FindNextFile()

Procura pelo prximo arquivo que obedece os parmetros especificados na funo


FindFirstFile(). Retorna o nome do arquivo que satisfaz os parmetros, ou vazio ("")
caso nenhum arquivo seja encontrado.
Exemplo:

Scripts

239

Manual do Usurio
// Este exemplo faz uma cpia de segurana de todos os
// arquivos *.DAT no diretrio C:\DADOS que tenham o
// atributo arquivo-morto (archive) para C:\BACKUP
DIM strFile
strFile = FindFirstFile ("C:\Dados\*.dat",32)
WHILE strFile<>""
CopyFile ("C:\Data\+strFile,C:\Backup\+strFile)
strFile = FindNextFile()
WEND

FolderSelectWindow([filepath])

Abre uma janela para seleo de um diretrio (pasta), retornando um string com o
nome do diretrio selecionado ou um string vazio, se for cancelada. O parmetro
filepath especifica o diretrio inicial a ser selecionado. Se no for especificado, a
seleo o diretrio-raiz do drive corrente.
Exemplo:
strFile = FolderSelectWindow ("C:\Dados")
Format(strFormato, valor)

Retorna um valor no formato data/hora de acordo com a string strFormato. O


parmetro valor o prprio valor a ser formatado.

240

Scripts

Manual do Usurio

As opes para esta funo so as seguintes:


Formatos Data/Hora para a funo Format

Scripts

FORMATO
w

SIGNIFICADO
Dia da semana (Dom Sab)

Dia da semana (DOM SAB)

ww

Dia da semana (Domingo Sbado)

WW

Dia da semana (DOMINGO SBADO)

Dia (1 31)

dd

Dia (01 31)

Ms (1 12)

mm

Ms (01 12)

mmm

Ms (Jan Dez)

MMM

Ms (JAN DEZ)

mmmm

Ms (Janeiro Dezembro)

MMMM

Ms (JANEIRO DEZEMBRO)

mmmmm

Ms (j d)

MMMMM

Ms (J D)

yy

Ano (00 99)

YY

Ano (1970 9999)

Hora (0 23)

hh

Hora (00 23)

Minuto (0 59) (deve estar acompanhando horas ou seguido de


segundos)

mm

Minuto (00 59) (deve estar acompanhando horas ou seguido de


segundos)

Segundo (0 59)

ss

Segundo (00 59)

AM/PM

Hora no formato 12 horas, mostra AM (manh) e PM (tarde).

am/pm

Hora no formato 12 horas, mostra am e pm.

A/P

Hora no formato 12 horas, mostra A e P.

a/p

Hora no formato 12 horas, mostra a e p.

Dcimos de segundo (deve ser precedido de segundos)

00

Centsimos de segundo (deve ser precedido de segundos)

000

Milsimos de segundo (deve ser precedido de segundos)

Nova linha (CR + LF)

241

Manual do Usurio

Exemplo:
DIM date = GetTime()
// Retorna "November 21, 2000"
str = Format("mmmm d, yyyy",date)
// Retorna "11:41:32.612"
str = Format("hh:mm:ss.000",date)
GetAbsoluteFilename(arquivo)

Retorna o nome completo do arquivo.


Exemplo:
// Retorna "C:\WINDOWS\SYSTEM\VGA.DRV"
strArquivo = GetAbsoluteFilename("VGA.DRV")

GetAppDir()

Retorna o diretrio da aplicao.


GetCurDir()

Retorna o diretrio corrente.


GetDay(time)

Obtm o dia a partir de um valor de tempo absoluto.


Exemplo:
day = GetDay(GetTime())
// Exemplo abaixo retorna 30
day = GetDay(MakeTime(30,10,1996,17,25,56))
GetDayOfWeek(dataHora)

Obtm o dia da semana a partir de um valor de tempo absoluto (1 para domingo, 2


para segunda, , 7 para sbado).
Exemplo:
day = GetDayOfWeek(GetTime())
// Exemplo abaixo retorna 5
day = GetDayOfWeek(MakeTime(30,10,1997,17,25,56))
GetDayOfYear(dataHora)

Obtm o dia do ano a partir de um valor de tempo absoluto em dias (1 para 1o. de
jan, 2 para 2 de jan, , 32 para 1o. de fev, 33 para 2 de fev, ).
Exemplo:
242

Scripts

Manual do Usurio

day = GetDayOfYear(GetTime())
day = GetDayOfYear(MakeTime(9,2,1997,17,25,56))
// retorna 40

GetDiskFreeSpace(strDiretrio[,bEspacoLivreUsuario])

Retorna o nmero total de Kbytes disponveis no caminho strDiretrio especificado.


O parmetro bEspacoLivreUsuario opcional e indica ao Elipse SCADA que ele
deve considerar a quota do usurio, quando aplicvel.
GetFileAttributes(arquivo[, verso])

Retorna a soma dos atributos de arquivo, de acordo com a seguinte tabela:


ATTRIBUTOS
Erro
Normal
Somente Leitura (Read Only)
Oculto (Hidden)
Sistema (System)
Volume
Diretrio (Directory)
Arquivo-morto (Archive)

VALOR
-1
0
1
2
4
8
16
32

O parmetro verso opcional. Se ele for especificado (verso = 1), os seguintes


atributos NTFS estaro disponveis:
ATTRIBUTOS
Arquivo comprimido
Arquivo off-line
Arquivo no-indexado pelo
servio de indexao
Arquivo encriptado

VALOR
2048
4096
8192
16384

GetFileCreationTime(arquivo)

Retorna a hora em que o arquivo foi criado, atravs fo parmetro arquivo.


GetFileLastAccessTime(arquivo)

Retorna a hora em que o arquivo foi acessado pela ltima vez, atravs do parmetro
arquivo.
GetFileLastModifiedTime(arquivo)

Retorna a hora da ltima modificao no arquivo atravs do parmetro arquivo.


Scripts

243

Manual do Usurio
GetFileSize(arquivo)

Retorna o tamanho do arquivo em bytes, atravs do parmetro arquivo.


GetHaspVar(strNomeVar)

L o valor de uma varivel interna armazenada em uma chave de hardware (Hasp).


Esta varivel s pode ser programada pela Elipse Software no Hasp. A funo
retorna uma string contendo o valor da varivel ou em vazio ("") se ocorrer algum
erro ou a varivel no existir.
Exemplo:
tagSerialNo = GetHaspVar("SerialNo")
GetHour(time)

Obtm a hora a partir de um valor de tempo absoluto.


Exemplo:
hour = GetHour(GetTime())
hour = GetHour(MakeTime(30,10,1996,17,25,56))
// Retorna 17
GetLastError()

Retorna o cdigo de erro da ltima operao no arquivo (o mesmo valor do atributo


global lastError).
GetLicenseString()

Retorna uma string nica que representa a licena do Elipse SCADA que est sendo
utilizada.
GetMinute(time)

Obtm os minutos a partir de um valor de tempo absoluto.


Exemplo:
minute = GetMinute(GetTime())
minute = GetMinute(MakeTime(30,10,1996,17,25,56))
// retorna 25
GetMonth(time)

Obtm o ms a partir de um valor de tempo absoluto.


Exemplo:
month = GetMonth(GetTime())
month = GetMonth(MakeTime(30,10,1996,17,25,56))
// retorna 10

244

Scripts

Manual do Usurio

GetSecond(time)

Obtm os segundos a partir de um valor de tempo absoluto.


Exemplo:
second = GetSecond(GetTime())
second = GetSecond(MakeTime(30,10,1996,17,25,56))
// retorna 56
GetTime()

Retorna a hora atual do sistema como um valor de tempo absoluto medido em


segundos desde 00:00 do dia 1o. de janeiro de 1970. O valor tambm expressa
milisegundos nas trs primeiras casas decimais.
Exemplo:
// Este exemplo conta quantos segundos leva para
// fazer uma cpia de um arquivo
DIM timeInicio, timeDuracao
timeInicio = GetTime()
CopyFile("C:\Dados\Temp.dat","C:\Dados\Backup\Temp.dat")
timeDuracao = GetTime() timeInicio
MessageBox ("A cpia durou "
+ Str (timeDuracao,8,3) + " segundos.")
GetYear (time)

Obtm o ano a partir de um valor de tempo absoluto.


Exemplo:
year = GetYear(GetTime())
year = GetYear(MakeTime(30,10,1996,17,25,56))
// retorna 1996
Green (cor)

Retorna o valor do componente verde de Cor. Ver Red().


HashString (strEntrada, strSenha)

Codifica a string passada como parmetro (strEntrada) utilizando a senha fornecida


(strSenha). O resultado uma string nica para a combinao (strEntrada,
strSenha). O clculo irreversvel: no possvel obter a string original e nem a
senha a partir da string retornada.

Scripts

245

Manual do Usurio
Hex (n)

Retorna uma string com a representao hexadecimal de n.


Exemplo:
tag001 = Hex(31) // retorna "1F"
HexToDec (stringHexa)

Retorna um nmero inteiro com o valor correspondente a stringHexa.


Exemplo:
tag001 = HexToDec("1F") // retorna "31"
Int (x)

Retorna a parte inteira de x, obtida por truncagem.


Exemplo:
tag002 = -9,9
tag001 = Int (tag002) // retorna -9
IsNumeric (expresso)

Verifica se o resultado da expresso informada no parmetro expresso um


nmero. Retorna TRUE (diferente de zero) se for um nmero ou FALSE (zero) se
no for.
Exemplo:
tag001 = IsNumeric(1000)
tag001 = IsNumeric("teste")

// retorna TRUE (1)


// retorna FALSE (0)

tag001 = IsNumeric(GetTime())

// retorna TRUE (1)

IsString (expresso)

Verifica se o resultado da expresso informada no parmetro expresso um string.


Retorna TRUE (diferente de zero) se for um nmero ou FALSE (zero) se no for.
Exemplo:
tag001 = IsString(1000)

// retorna FALSE (0)

tag001 = IsString("teste")
tag001 = IsString(GetTime())

// retorna TRUE (1)


// retorna FALSE (0)

Left (string, nCount)

Retorna os nCount caracteres mais esquerda do parmetro string.


Exemplo:
String = Left('Password', 4) // retorna 'Pass'
Len (string)

Retorna o nmero de caracteres de um string.


246

Scripts

Manual do Usurio

Exemplo:
Integer = Len('Password')

// retorna 8

Log(x)

Retorna o logaritmo natural do nmero x.


Exemplo:
tag001 = Log(tag002)
Log10(x)

Retorna o logaritmo base-10 do nmero x.


Exemplo:
tag001 = Log10(tag002)
MakeLower(string)

Retorna o parmetro string em letras minsculas.


Exemplo:
String = MakeLower('Password') // Retorna 'password'
MakeReverse(string)

Inverte um string, de forma que o primeiro caractere se torne o ltimo e vice-versa.


Exemplo:
String = MakeReverse('Password') // Retorna 'drowssaP'
MakeTime (day, month, year, hour, minute, second)

Retorna um valor de tempo absoluto a partir dos parmetros especificados. O


intervalo de valores para cada parmetro :
Intervalo

day
month
year
hour
minute
second

Descrio

1 a 31 (pode ser 28, 29 ou 30 conforme o ms e o ano)


1 a 12
1970 a 2039
0 a 23
0 a 59
0 a 59

Se algum dos parmetros for invlido a funo retorna 0.


Exemplo:
myTime = MakeTime(30,10,1996,17,25,56)
MakeUpper (string)

Retorna o parmetro string em letras maisculas.


Scripts

247

Manual do Usurio

Exemplo:
String = MakeUpper(Password)

// retorna PASSWORD

Max (x)

Compara x e y e retorna o maior valor entre as duas expresses numricas.


Exemplo:
tag001=Max(tag002,tag003)
MessageBox (texto[, ttulo[, Estilo]][,x][,y])

Mostra uma caixa de mensagem que pode ser configurada pelo usurio. A funo
retorna um valor correspondente a um boto pressionado na caixa de mensagem ou
no Keypad.
Parmetros da Funo
O parmetro Text obrigatrio, os parmetros Title e Style so opcionais e seus
valores default (0000h) determinam uma caixa de mensagem padro.
texto: Deve ser um string ou um Tag contendo um string. Deve ser expresso entre
aspas simples e aparecer centralizado na caixa de mensagem logo acima dos
botes.

248

Scripts

Manual do Usurio

Exemplo:
MessageBox ("Como est a Caixa de Mensagem?")
// Um string e' atribuido a um Tag
Mensagem = "Como est a Caixa de Mensagem?"
MessageBox(strMensagem)

Ttulo: Deve ser um string da mesma forma que o parmetro Text e ir aparecer na
barra de ttulo da caixa de mensagem. Exemplo:
MessageBox ("Como est a caixa de Mensagem?",
"Teste da Caixa de Mensagem")
// Dois strings abaixo sao atribuidos a Tags
strText="Como est a caixa de Mensagem?"
strTitle="Teste da Caixa de Mensagem"
MessageBox(strText,strTitle)

x, y: Permite especificar a posio em que o dilogo ir aparecer.


Estilo: Permite modificar o estilo da caixa de mensagem e deve ser um valor em
hexadecimal conforme as caractersticas que voc deseja. As seguintes
caractersticas podem ser configuradas.
Tipos da janela
TIPO
Application Modal

HEXA
0000h

DESCRIO
Voc deve responder a caixa de mensagem
para seguir usando a janela que a chamou.
Entretanto, voc pode ir para qualquer outra
janela.

System Modal

1000h

Todas as aplicaes ficam suspensas at que


voc responda esta caixa de mensagem.
usada para mensagens muito importantes.

Desk Modal

2000h

Semelhante ao Application Modal s que


suspende todas as telas da aplicao at que
a mensagem seja respondida.

Botes da caixa de mensagem


BOTES
OK

HEXA
0000h

DESCRIO
Aparecer somente o boto de OK na caixa
de mensagem

OK, Cancel

0001h

Aparecero os botes OK e Cancel.

Abort, Retry, Ignore

0002h

Aparecero os botes Abort, Retry, e Ignore.

Yes, No, Cancel

0003h

Aparecero os botes Yes, No, e Cancel.

Yes, No

0004h

Aparecero os botes Yes e No

Retry, Cancel

0005h

Aparecero os botes Retry e Cancel.

Default para os botes


Scripts

249

Manual do Usurio
BOTES
Boto1 como default

HEXA
0000h

DESCRIO
D o foco para o Boto 1.

Boto2 como default

0100h

D o foco para o Boto 2.

Boto3 como default

0200h

D o foco para o Boto 3.

TIPO
Pare

HEXA
0010h

DESCRIO
O cone um sinal de pare

Pergunta

0020h

O cone um ponto de interrogao

Exclamao

0030h

O cone um ponto de exclamao

Informao

0040h

O cone o caractere i dentro de um crculo

cone

Valores de retorno
VALOR
1

BOTO
OK

OK

MENSAGEM

Cancel

Cancelar

Abort

Abortar

Retry

Tentar de novo

Ignore

Ignorar

Yes

Sim

No

No

Configurando uma Caixa de Mensagem


Para configurar o estilo de uma Caixa de Mensagem voc deve fazer um OR lgico
de cada caracterstica que voc deseja (Tipo, botes default, cone, botes). Voc
pode escolher apenas uma das caractersticas disponveis (veja tabelas acima). Por
exemplo, para especificar uma caixa de Mensagem com o seguinte estilo:
Tipo System Modal (1000h) + Boto 2 como Default (0100h) +
cone de exclamao (0030h) + Botes Yes e No (0004h) = 1134h

Exemplo:
strText = "Como est a caixa?"
strTitle = "Teste da Caixa de Mensagem"
MessageBox(strText, strTitle, 1134h)
Mid (strText, nFirst, [nCount])

Retorna parte de strText conforme os parmetros nFirst e nCount. nFirst especifica


a posio, no string, do primeiro caractere do substring que ser retornado (a
contagem inicia em zero) e nCount o nmero de caracteres do substring. Exemplo:

250

Scripts

Manual do Usurio

strSenha = Mid('Password', 0, 3)
strSenha = Mid('Password', 3, 4)

// retorna 'Pas'
// retorna 'swor'

strSenha = Mid('Password', 2)

// retorna 'ssword'

Min (x,y)

Compara x e y e retorna o menor valor entre as duas expresses numricas.


Exemplo:
tag001 = Min (2.4,28.3)

// tag001 = 2.4

MoveFile (arqFonte, arqDestino)

Move o arquivo especificado para uma nova localizao. Retorna TRUE se bem
sucedida ou FALSE em caso de erro. Os atributos globais lastError e lastErrorStr
so atualizados por essa funo.
Exemplo:
MoveFile("c:\data\turtle.dat","c:\newdata\rabbit.dat")

PadC (string, tamanho [, caractere])

Retorna a string strString centralizada com o caractere, parmetro caractere,


completando o tamanho do string resultante especificado pelo parmetro tamanho.
Se caractere no especificado, espaos so introduzidos. Somente o primeiro
caractere do parmetro caracter usado.
Exemplos:
PadC("abc",7)
PadC("abcdefghij",5)

// Resulta " abc "


// Resulta "abcde"

PadC("abc",8,"-")

// Resulta "--abc---"

PadL (string, tamanho [, caractere])

Retorna string posicionado no lado direito com o caractere caractere completando


o tamanho do string resultante, indicado por tamanho. Se caractere no
especificado, espaos so introduzidos. Somente o primeiro caractere de caractere
usado.
Exemplos:

Scripts

PadL("abc",5)

// Resulta "

PadL("abcdefghij",5)
PadL("abc",8,"-")

// Resulta "abcde"
// Resulta "-----abc"

abc"

251

Manual do Usurio
PadR (string, tamanho [, caracter])

Retorna string posicionado no lado esquerdo com o caractere especificado no


parmetro caracter, completando o tamanho do string resultante, indicado por
tamanho. Se caracter no especificado, espaos so introduzidos. Somente o
primeiro caractere de strPadChar usado.
Exemplos:
PadR("abc",7)

// Resulta "abc

"

PadR("abcdefghij",5) // Resulta "abcde"


PadR("abc",8,"-")
// Resulta "abc-----"
PasswordDlg(text, title, [x], [y])

Abre uma caixa de dilogo para entrada de uma password. O parmetro title um
string a ser mostrado na barra de ttulo e text um string com uma mensagem para o
usurio. Retorna a password digitada pelo usurio. Os parmetros opcionais x e y
indicam a posio do canto superior esquerdo da caixa de mensagem a ser mostrada.
A funo retorna a senha digitada pelo usurio.
Exemplo:
strPwd = PasswordDlg ("Digite a senha","Segurana")
strPwd = PasswordDlg
("Digite sua senha","Login",100,100)
PlaySound (soundIndex)

Toca um som especificado no parmetro soundIndex (inteiro entre 0 e 5) de acordo


com a tabela abaixo:

NDICE

DESCRIO
Bipe usando o alto-falante interno do computador

Asterisco (observao)

Exclamao

Mo (ateno)

Questo

Alerta padro

Este som definido no painel de controle do Windows. A funo faz a solicitao


do toque do som ao sistema e retorna. O som tocado assincronamente.
PlayWave (filename, [startTime], [stopTime])

Toca um arquivo formato WAV. Os parmetros startTime e stopTime especifica o


intervalo do arquivo que ser tocado (em milisegundos). Se estes parmetros forem
252

Scripts

Manual do Usurio

omitidos, todo o arquivo ser tocado. O processo pode ser parado chamando a
funo StopWave().
Exemplo:
PlayWave("tada.wav",2000,5000)
// Toca o arquivo do segundo 2 at o 5

Esta funo no aceita os parmetros startTime e stopTime no CE.

PrintString (numeroLPT, string)

Envia a string para a impressora numeroLPT. A string enviada aguardando um pr


processamento (raw bytes). Se a formatao requerida, possvel acessar as
configuraes da impressora. Os caracteres CR e LF (Chr(13) + Chr(10)) deve ser
fornecido para mudar uma nova linha.
Exemplo:
PrintString(1, "Hello World")
Rad (angle)

Retorna o ngulo angle (expresso em graus) convertido para radianos, segundo a


frmula: radianos = (angle / 180) * 3.141592.
ReadFromFile (strArquivo, [posInicio], [bytesALer)

L o arquivo strArquivo, iniciando por posInicio (do incio do arquivo, se no for


especificado). Se bytesALer no for especificado, a funo l todos os bytes do
arquivo. Recomenda-se que o arquivo contenha somente dados de texto/caractere.
Dados binrios podem ser lidos, mas no podem ser manipulados no Elipse
SCADA.
Exemplo:
tag001 = ReadFromFile("Help.txt")
// L todo o arquivo HELP.TXT para tag001

ReadIniNumber (strArquivo, strSeo, strEntrada, [nValorDefault])

Retorna o nmero de uma entrada no arquivo de configurao (.INI) strArquivo. Os


parmetros strSeo e strEntrada especificam a seo e a entrada do arquivo
respectivamente. Se a entrada no for encontrada, o valor nValorDefault
retornado. Se nValorDefault no for especificado, a funo retorna zero. O arquivo
deve ser formatado com a seguinte sintaxe:

Scripts

253

Manual do Usurio
[secao1]
entrada1 = valor1
entrada2 = valor2
<outras entradas>
entradaN = valorN
[secao2]
<outras entradas>
[secaoN]
<outras entradas>

Exemplo:
// Arquivo MYAPP.INI com o seguinte contedo:
// [General]
// Total = 1000
// UserName = Admin
ReadIniNumber("MYAPP.INI","General","Total",-1)
// retorna 1000
ReadIniString("MYAPP.INI","General","UserName")
// retorna "Admin"

NOTA: Se houver um outro programa que modifica o arquivo .INI, as mudanas


podero no ser vistas imediatamente porque Windows mantem uma cpia do
arquivo em memria. Voc pode forar a atualizao chamando WriteIni
(strFile,"","","") antes de ler o arquivo .INI. Seja um arquivo VALUES.INI que est
sendo atualizado por um outro programa. Pode-se ler os valores atualizados assim:
WriteIni("VALUES.INI","","","")
// Fora o Windows a descarregar o cache
ReadIniNumber("VALUES.INI", "Secao", "Entrada")
// L o valor de Entrada na seo Secao

ReadIniString(strArquivo, strSeo, strEntrada, [strValorPadro])

Retorna o string contendo o valor da entrada no arquivo strArquivo .INI. Os


parmetros strSeo e strEntrada especificam a seo e a entrada do respectivo
arquivo. Se a entrada no for encontradaI, o strValorPadro retornado, ou um
string nulo ("") se strValorPadro no for especificado.
Real (string)

Converte um string numrico ou um nmero para um nmero real.


254

Scripts

Manual do Usurio

Exemplo:
Numeric = Real(30)

// retorna 30,0

Red(cor)

Estas funes permitem obter uma das trs cores componentes de um valor 24
bits.de cor: vermelho, verde e azul. O valor retornado estar sempre entre 0
(intensidade mnima) e 255 (intensidade mxima).
Exemplo:
color = Display.backgroundColor
Display.backgroundColor = RGB(Red(color)/2,
Green(color)/2, Blue(color)/2)

O exemplo acima configura a cor de fundo de um Display para a metade da


intensidade da cor original, para cada uma das trs componentes de cores.
ReleaseMouseCapture ()

Libera a captura do mouse efetuada pela funo SetMouseCapture(). Um objeto


que tem uma captura de mouse ativa recebe todos os eventos do mouse,
independente do mouse estar ou no sobre o objeto.
Exemplo: o script OnMouseOver a seguir muda a cor de fundo de um objeto de tela
quando o mouse est sobre ele e retorna cor original quando o mouse sai.
// verifica se j no h uma captura de mouse
IF NOT Display.HasMouseCapture()
// o mouse entrou no objeto, capture
Display.SetMouseCapture()
// colocar uma cor de destaque
Display.backgroundColor = RGB(220,220,220)
ELSEIF NOT Display.IsMouseInside()
// se o mouse saiu do objeto, coloque a cor original
Display.backgroundColor = RGB(192,192,192)
// e cancele a captura
ReleaseMouseCapture()
ENDIF
RemoveDir (dir)

Remove um diretrio (pasta) existente. No Windows, por restrio do sistema, o


diretrio deve estar vazio e no deve ter sub-diretrios, para ser apagado. No
possvel apagar o diretrio corrente, o diretrio de trabalho do sistema ou o
diretrio-raiz. Retorna o valor TRUE se bem sucedida ou FALSE (zero) se no. Os
atributos globais lastError e lastErrorStr so atualizados por essa funo.

Scripts

255

Manual do Usurio
RenameFile (arqFonte, arqDestino)

Muda o nome do arquivo arqFonte para arqDestinoe. Retorna o valor TRUE se


bem sucedida ou FALSE (zero) se no. Os atributos globais lastError e lastErrorStr
so atualizados por essa funo.
RGB (vermelho, verde, azul)

Retorna um valor de cor 24 bits para as trs cores componentes especificadas:


vermelho, verde e azul. Cada componente um inteiro entre 0 (intensidade mnima)
e 255 (intensidade mxima). O valor retornado pode ser atribudo a qualquer atributo
de cor de um objeto. Exemplo:
// Vermelho forte
Display1.backgroundColor = RGB(255,0,0)
Right (string, nCount)

Retorna os nCount caracteres mais direita do parmetro string.


Exemplo:
str = Right("Password",4)

// retorna "word"

Rnd ()

Retorna um nmero real aleatrio entre 0 e 1 (inclusive).


Round (x)

Retorna o nmero x arredondado para o inteiro mais prximo.


Exemplo:
tag001 = Round(14,1)

// o resultado 14.0

tag002 = Round(13,9)

// o resultado 14.0

RunMacro (strExpresso)

Compila e executa a expresso contida no string strExpresso passado como


parmetro. Retorna o valor da expresso executada ou zero se nenhum erro de
compilao ou execuo ocorrer.
Exemplo:
// executa a expresso "Screen<activeScreen>.Activate",
// onde activeScreen o nmero da tela.
RunMacro("Screen"+Str(activeScreen,1,0)+".Activate()")

ScriptWindow ()

Abre uma janela para debug no modo Runtime que permite supervisionar todos os
scripts que esto rodando. Tambm mostra quanto tempo ou quantas vezes um script
for executado.
256

Scripts

Manual do Usurio

SetFileAttributes (arquivo, attrNovo)

Modifica os atributos do arquivo file para attrNovo. Veja a funo


GetFileAttributes para a lista de atributos que o parmetro arquivo pode receber. A
funo retorna TRUE se bem sucedida ou FALSE (zero) se falhar. Os atributos
globais lastError e lastErrorStr so atualizados por esta funo.
Exemplo:
SetFileAttributes("turtle.dat",3)
// somente leitura (1) + oculto (2) = 3
SetSystemTime (novaHora)

Ajusta a hora do sistema para o parmetro novaHora. O parmetro novaHora um


valor absoluto de datahora. Use a funo MakeTime() para compilar este nmero.
A funo retorna 1 (TRUE) se obtiver sucesso, 0 (FALSE) se falhar.
Exemplo:
SetSystemTime(MakeTime(10,8,2000,17,25,56))

NOTA: A hora interna mantida pelo Elipse SCADA no ajustada


automaticamente. Para que isso ocorra, pode-se utilizar dois mtodos: Adicionar a
chave
HKEY_CURRENT_USER\Software\Elipse
Software\Elipse32\Options\DisableInternalClock com o valor 1
ao Editor de Registro do Windows, ou ento iniciar o Elipse SCADA via linha de
comando utilizando a opo -disableInternalClock. Caso nenhum dos dois
mtodos seja utilizado, o sistema faz pequenos incrementos/decrementos em seu
tempo interno at que alcance a hora do relgio do sistema em uma taxa mxima de
20% (incrementa/decrementa no mximo 2 segundos a cada 10 segundos).
Sgn (x)

Retorna o sinal de x (-1 se negativo, 0 se zero, 1 se positivo).


Exemplo:
tag001 = Sgn(-123.98)

// retorna -1

ShellExecute (strOperao, strArquivo, strParametros, strDir, nCmdVisual))

Executa um comando especfico sobre um arquivo (programa ou documento)


especificado. O parmetro strOperao indica o comando ser executado, a saber:
"edit" (editar); "explore" (explorar); "find" (buscar); "open" (abrir); print"
(imprimir); ou "properties" (propriedades). O parmetro strArquivo indica o
caminho completo do arquivo que ir executar a ao. strParametros um string
que especifica os parmetros que devem ser passados na chamada do comando ou o
arquivo que sofrer a ao indicada. strDir define o diretrio padro a ser utilizado.
nCmdVisual especifica como a aplicao deve ser mostrada quando for aberta, a
saber: 0 = esconder a janela; 1 = mostrar a janela; 2 = mostrar a janela minimizada;
3 = mostrar a janela maximizada.
Scripts

257

Manual do Usurio

Exemplo:
'Executa comandos FTP salvos no arquivo filename.txt
'sem mostrar nenhuma janela
ShellExecute("open", "ftp", "-s:filename.txt", "", 0)
Sin (angle)

Retorna o seno do ngulo especificado. O ngulo angle expresso em radianos.


Sleep (nSegundos)

Faz uma pausa na execuo do script durante nSeconds segundos ( possvel


especificar uma frao, por exemplo: Sleep (0.5)). A interface do usurio no
responder enquanto a pausa estiver sendo executada. Processos rodando em
segundo plano que estiverem rodando em thread separados (E/S, drivers de rede,
recepo de vdeo) continuaro funcionando, mas toda a lgica da aplicao (scripts)
ser pausada.
Sqrt (x)

Retorna a raiz quadrada de x.


Exemplo:
tag001 = Sqrt(81)

// returns 9

StartSound (soundIndex, [frequency (ms)])

Toca o som especificado em soundIndex na freqncia especificada em frequency


(em milisegundos) at um comando StopSound ser chamado. soundIndex deve ser
um inteiro entre 0 e 5 (veja a tabela de sons disponveis consultando a funo
PlaySound()). A freqncia mnima 100ms; se for especificado um nmero
menor, o valor 100 ser assumido. Note que o parmetro frequency designa de
quanto em quanto tempo o som ser tocado.
Exemplo:
StartSound(2,2000)
// toca o som de exclamao a cada 2 segundos

StopSound ()

Pra um som que est tocando, iniciado pela funo StartSound().


StopWave ()

Pra a reproduo de um arquivo WAV iniciada pela funo PlayWave().

258

Scripts

Manual do Usurio

Str (value, size, precision)

Converte um nmero inteiro ou real para um string. O parmetro value o nmero a


ser convertido, o parmetros size e precision determinam o tamanho e preciso do
string. Quando o parmetro value for um string ele primeiro convertido para um
nmero e depois formatado conforme os parmetros size e precision.
Exemplo:
String = Str(30.95,6,2)

// Retorna " 30.95"

StrZero (Valor, tamanho, prec)

Converte um nmero inteiro ou real para um string preenchendo com zeros a


esquerda at o tamanho especificado. O parmetro valor o nmero a ser
convertido, o parmetros tamanho e prec determinam o tamanho e preciso do
string. Quando o parmetro value for um string ele primeiro convertido para um
nmero e depois formatado conforme os parmetros tamanho e prec.
Exemplo:
String = StrZero(30.95,6,2)

// Retorna "030.95"

Tan (angle)

Retorna a tangente do ngulo especificado. O ngulo angle expresso em radianos.


WaitCursor(bHabilita)

Habilita (bHabilita=1) ou desabilita (bHabilitae=0) o cursor de espera (ampulheta).


Exemplo:
WaitCursor (1)
<alguns comandos que demoram tempo>
WaitCursor (0)

WatchWindow()

Abre uma janela de depurao no mdulo Runtime que permite visualizar os valores
das propriedades de um item selecionado na rvore da aplicao.
WriteIni (strArquivo, strSeo, strEntrada, valor)

Escreve o valor (numrico ou string) no arquivo .INI strArquivo. O parmetro


strSeo e strEntrada especificam a seo e a entrada do arquivo respectivo.
NOTA: Se o arquivo for modificado INI file, tas transformaes no sero
imediatamente modificadas, porque o Windows copia um arquivo na memria.
Voc pode forar a atualizao utilizando o parmetro WriteIni (strFile, "", "", "")
depois de ler o arquivo .INI.
O exemplo abaixo escreve as seguintes linhas em MYAPP.INI:
Scripts

259

Manual do Usurio
[General]
Total = 1500
UserName = Admin

Exemplo:
WriteIni("MYAPP.INI","General","Total",1500)
WriteIni("MYAPP.INI","General","UserName","Admin")
WriteToFile(arquivo, texto, [operao])

Escreve o texto no arquivo. Retorna 1 se for bem sucedida ou 0 se ocorrer algum


erro. O parmetro operao opcional e possui as seguintes especificaes:

MODO

DESCRIO
(default) Cria o arquivo se no existir, colocando a string no fim do
arquivo.

Falha se o arquivo no existir, colocando a string no final do arquivo.

Cria o arquivo se no existir, substituindo o arquivo por uma nova


string.

Falha se o arquivo no existir, substituindo o arquivo por uma nova


string.

Exemplo:
WriteToFile("test.txt", "Essa linha ser
acrescentada para um arquivo existente", 1)

19.5.2. Funes da Aplicao


AddUser (nome, descrio, login, senha, nivelAcesso)

Adiciona um novo usurio na lista de usurios da aplicao. Retorna 1 (um) se for


bem sucedida ou 0 (zero) caso contrrio.
Exemplo:
Application.AddUser
("Joo Machado", "Gerente", "JoaoM", "1234", 0 )

DeleteUser (login)

Apaga um usurio da lista de usurios. Retorna 1 (um) se for bem sucedida ou 0


(zero) caso contrrio.
Exemplos:

260

Scripts

Manual do Usurio

Application.DeleteUser("JoaoM")
Application.DeleteUser(strUserName)

EditProperties()

Abre uma janela que permite a edio das propriedades da Aplicao.


GetMaxX()

Retorna a lagura da janela da aplicao em pixels.


GetMaxY()

Retorna a altura da janela da aplicao em pixels.


Login ([x][,y][,habilitaTitulo][,permiteFechar][,strTitulo])

Chama uma caixa de dilogo para a identificao (login) de um usurio. Retorna


verdadeiro (diferente de zero) se o usurio for logado com sucesso ou falso (zero) se
no for. Em caso de erro nenhuma mensagem ou janela ser mostrada. Os
parmetros opcionais X e Y indicam as coordenadas da posio do canto superior
esquerdo da janela de login. O parmetro habilitaTitulo determina se a janela de login
ter barra de ttulo (habilitaTitulo = 1, default) ou no (habilitaTitulo = 0). O
parmetro permiteFechar um booleano que indica se o boto de fechar a janela
deve aparecer (padro 1, visvel). O parmetro strTitulo permite especificar um
ttulo para a janela diferente do padro. Em caso de erro, o atributo global lastError
tambm atualizado: 0 (zero) se o login for cancelado pelo usurio ou 1 (um) se o
usurio ou a senha forem invlidos.
Exemplo:
IF Application.Login()
SetPointScreen.Activate()
ENDIF
Logout()

Executa o logout (sada) de um usurio da aplicao. Fecha todas as telas que


possuem prioridade diferente de zero.
Exemplo:
IF MessageBox("Voc quer dar logout?","Logout",4) == 6
Application.Logout( )
ENDIF

MaximizeApp()

Maximiza a janela da aplicao.

Scripts

261

Manual do Usurio
MinimizeApp()

Minimiza a janela da aplicao.


ReloadApp([strAppName])

Termina a execuo da aplicao corrente, recarrega-a do disco e reinicia-a. O


parmetro opcional strAppName permite passar o nome de outra aplicao a ser
reiniciada, ao invs da corrente. Esta funo no est disponvel no modo Demo
(demonstrao) do Elipse SCADA.
RestoreApp()

Restaura o tamanho original da janela da aplicao, antes de ela ter sido maximizada
ou minimizada.
ShutDownWindows(modoDesligamento)

Permite reiniciar ou desligar o computador via scripts. O parmetro


modoDesligamento pode ser: 1 (desligar, sem forar o encerramento das
aplicaes), 2 (desligar, forando o encerramento das aplicaes), 3 (reiniciar, sem
forar o encerramento das aplicaes) ou 4 (reiniciar, forando o encerramento das
aplicaes). Um desligamento forado ou um reincio forado indicam que todos os
outros programas em execuo (exceto o Elipse SCADA) sero imediatamente
terminados e no ser possvel salvar nenhuma alterao.
Exemplo:
// Parada programada normal do Windows
Application.ShutdownWindows(1)

Nota: Quando a aplicao rodada no modo Configurador, ele simplesmente pra a


aplicao. Quando a aplicao rodada no modo Runtime, o aplicativo parado e o
computador reiniciado.
StopRunning()

Finaliza a aplicao corrente.


UserAdministration([x][,y][,enableTitle][,allowClose][,customTitle])

Permite a um usurio modificar sua senha. Se o usurio administrador (nvel de


acesso 1) ele poder criar, modificar e remover os atributos de todos os usurios.

262

Scripts

Manual do Usurio

19.5.3. Funes de Tags


Funes Comuns
EditProperties()

Abre uma janela que permite a edio das propriedades do tag.


Funes de Tags Matriz
Avg (r1, c1, r2, c2)

Retorna a mdia dos valores no retngulo definido por linha1 (r1) coluna1 (c1) e
linha2 (r2) coluna2 (c2).
Exemplo:
tagSum = tagMatriz.Avg(2,1,3,3)
// retorna a mdia das clulas
// (2,1), (2,2), (2,3), (3,1), (3,2), (3,3)
ExchangeColumns (coluna1, coluna2)

Troca o contedo de duas colunas de uma matriz.


Exemplo:
// Troca os contedos das colunas 3 e 4
TagMTX1.ExchangeColumns(3,4)
ExchangeRows (linha1, linha2)

Troca o contedo de duas linhas de uma matriz.


Exemplo:
// Troca os contedos das linhas 3 e 4
TagMTX1.ExchangeRows(3,4)
GetCell (linha, coluna)

Retorna o valor (numrico ou string) de uma determinada clula da matriz


especificada pela linha row e columa column.
Exemplo:
// Retorna o valor da clula da linha 3, coluna 5
TagMTX1.GetCell(3,5)
MapCellsToTags(startColumn, startRow, endColumn, endRow)

Mapeia as informaes associada com as propriedades ou tags.


Scripts

263

Manual do Usurio

Exemplo:
TagMTX1.MapCellsToTags(1,1,5,5)
OrderBy(linhaSuperior, linhaInferior, coluna, ascendente)

Ordena as linhas de uma matriz entre a linha inicial linhaSuperior e a final


linhaInferior pela coluna coluna, de maneira ascendente (se ascendente = 1) ou
descendente (se ascendente = 0).
Exemplo:
// Ordena as linhas 1 a 8 da matriz de forma ascendente,
// conforme os valores da coluna 1
TagMTX1.OrderBy(1,8,1,1)
SetCell (linha, coluna, valor)

Atribui um valor value a uma determinada clula da matriz especificada pela linha
especificada pelo parmetro linha e coluna especificada pelo parmetro coluna.
Exemplo:
// Atribui o valor 9 clula da linha 3, coluna 5
TagMTX1.SetCell(3,5,9)
Sum (r1, c1, r2, c2)

Retorna o somatrio dos valores contidos no retngulo definido por linha1 (r1)
coluna1 (c1) e linha2 (r2) coluna2 (c2).
Exemplo:
// Soma os contedos das clulas
// (2,1), (2,2), (2,3), (2,4), (3,1), (3,2), (3,3), (3,4)
TagMTX1.Sum(2,1,3,4)

Funes de Tags Crono


Reset()

Zera o acumulador.
Funes de Tags Bloco
GetAt(ndice)

Pega o valor armazenado em um elemento de bloco. O atributo ndice indica o


ndice do elemento do tag bloco. Ateno: esta funo no pode ser usada em
verses limitadas (verses Lite) do Elipse SCADA.
Exemplo:
264

Scripts

Manual do Usurio

// Soma todos os elementos do bloco


DIM index, sum
sum = 0
FOR index = 0 TO Block1.size-1
sum += Block1.GetAt(index)
NEXT
Read()

L o bloco do PLC imediatamente e retorna 1 se a leitura foi bem sucedida e 0 se a


leitura falhar. Para maiores informaes sobre blocos PLC, verifique o item Tag
Bloco do captulo sobre Tags neste manual.
ATENO: Esta uma funo sncrona, ou seja, espera at que a operao de
leitura esteja terminada antes de retornar para a prxima instruo, o que pode
degradar seriamente o desempenho da aplicao, conseqentemente voc deve usla com cuidado e somente quando for absolutamente necessrio.
SetAt (ndice, valor)

Seta o valor de um elemento de bloco. Retorna verdadeiro se a operao for bem


sucedida, caso contrrio retorna falso. O atributo ndice indica o ndice do elemento
do tag bloco e o atributo valor o valor a ser enviado para o elemento.
Ateno: Esta funo no pode ser usada em verses limitadas (verses Lite) do
Elipse SCADA.
Exemplo:
// Este exemplo ajusta todos os elementos do bloco para zero
DIM index
FOR index = 0 TO Block1.size-1
Block1.SetAt(index, 0)
NEXT
SetSize (size)

Ajusta o nmero dos elementos do bloco, indicado pelo parmetro size. Os


elementos do bloco sero adicionados se o bloco crescer, ou removidos se o bloco
diminuir.
Write ()

Escreve os valores atuais do bloco no PLC imediatamente e retorna 1 se a escrita foi


bem sucedida e 0, se a escrita falhar. Para maiores informaes sobre escrita em
servios de I/O, verifique o item Tag Bloco do captulo sobre Tags neste manual.

Scripts

265

Manual do Usurio

Funes de Elementos de Bloco


Read()

L o elemento de um tag bloco PLC. Retorna 1 (um) se a leitura foi bem sucedida, e
0 (zero) se a leitura falhar.
Ateno: esta uma funo sncrona, ou seja, espera at que a operao de leitura
esteja terminada antes de retornar para a execuo da prxima instruo. Ela pode
degradar seriamente o desempenho da aplicao, conseqentemente deve ser usada
quando for absolutamente necessrio.
Write()

Escreve o valor atual do elemento do bloco no PLC imediatamente, retornando 1


(um) se a escrita foi bem sucedida, ou 0 (zero) se a leitura falhar. Para maiores
informaes sobre escrita em servios de I/O, verifique o item Elemento de Bloco
do captulo sobre Tags neste manual.
Ateno: Esta uma funo sncrona, ou seja, espera at que a operao de escrita
esteja terminada antes de retornar para a execuo da prxima instruo. Ela pode
degradar seriamente o desempenho da aplicao, conseqentemente deve ser usada
quando for absolutamente necessrio.
WriteEx(valor)

Escreve o valor para o driver I/O, especificando as informaes para o tag. Esta
funo usada para especificar as informaes de varredura (scan) do tag.
Funes de Tags OPC
Read()

L o valor do servidor OPC.


Write()

Escreve o valor no tag para o servidor OPC.


Funes de Tags PLC
Read()

L o Tag PLC imediatamente e retorna 1 se a leitura foi bem sucedido e 0 se a


leitura falhar. Para maiores informaes sobre tags que lem dados de servidores de
I/O, consulte o item Tag PLC do captulo sobre Tags neste manual.
266

Scripts

Manual do Usurio

Ateno: esta uma funo sncrona, ou seja, espera at que a operao de leitura
esteja terminada antes de retornar para a execuo da prxima instruo. Ela pode
degradar seriamente o desempenho da aplicao, conseqentemente deve ser usada
quando for absolutamente necessrio.
Write()

Escreve o valor atual do Tag no PLC imediatamente. Retorna 1 se a escrita foi bem
sucedida e 0 se a escrita falhar. Para maiores informaes sobre tags que escrevem
dados em servidores de I/O, consulte o item Tag PLC do captulo sobre Tags neste
manual.
Ateno: esta uma funo sncrona, espera at que a operao de escrita esteja
terminada antes de retornar para a execuo da prxima instruo. Ela pode degradar
seriamente o desempenho da aplicao, conseqentemente deve ser usada quando
for absolutamente necessrio.
WriteEx(valor[,timeStamp])

Escreve o valor diretamente no I/O, sem atribu-lo ao Tag PLC. Esta funo usa a
escala definida no Tag PLC. O parmetro numrico opcional timeStamp permite
forar uma data/hora para a escrita do valor.
Exemplo:
Block1.elm000.WriteEx(12)

19.5.4. Funes de Tela


Activate()

Semelhante funo Show().


EditProperties()

Abre uma janela que permite a edio das propriedades do Tela.


GetMouseX()

Retorna a coordenada X atual do mouse.


GetMouseY()

Retorna a coordenada Y atual do mouse.


Hide()

Esconde (fecha) uma tela.


Scripts

267

Manual do Usurio
SendTab (nTabs)

Envia caracteres [Tab] para a aplicao de modo a mudar o foco do teclado entre os
objetos de tela. Valores positivos de nTabs simulam a tecla [Tab], valores negativos
simulam a combinao de teclas [Shift]+[Tab].
Exemplo:
Screen1.SendTab(4)
Show()

Mostra uma tela. A tela no recebe o foco quando mostrada.

19.5.5. Funes dos Objetos de Tela


Funes Comuns
BringToFront()

Coloca o objeto no primeiro plano da tela (na frente dos demais objetos).
EditProperties()

Abre uma janela que permite a edio das propriedades do objeto.


HasFocus()

Retorna verdadeiro (diferente de zero) se o objeto tem o foco de teclado ou falso


(zero) se no tem.
Exemplo:
// Muda a cor de Botao se ele tem o foco do teclado
IF Botao.HasFocus()
Botao.foregroundColor = RGB(255,255,0)
ENDIF
HasMouseCapture()

Retorna verdadeiro (diferente de zero) se o objeto est com o mouse capturado ou


falso (zero) se no est.
Exemplo:

268

Scripts

Manual do Usurio

Botao.SetMouseCapture()
tag1 = Botao.HasMouseCapture()

// retorna 1

ReleaseMouseCapture()
tag1 = Botao.HasMouseCapture()

// retorna 0

IsMouseInside()

Retorna verdadeiro (diferente de zero) se o mouse est sobre o objeto ou falso (zero)
se no est.
Exemplo:
// Muda a cor de Botao se ele tem o mouse sobre ele
IF Botao.IsMouseInside( )
Botao.foregroundColor = RGB(255,255,0)
ENDIF
MoveTo(x,y)

Move um objeto para as coordenadas x e y especificadas.


Exemplo:
// Nesse exemplo, quando o mouse passar por cima do objeto,
// ele movido para o canto esquerdo superior da tela.
IF Quadrado.IsMouseInside()
Quadrado.MoveTo(0,0)
ENDIF
SendToBack()

Coloca o objeto no ltimo plano da tela (atrs dos demais objetos).


SetFocus()

Define o foco de teclado para o objeto.


SetMouseCapture()

Captura o mouse para o objeto que chama a funo. Todas as mensagens de mouse
sero direcionadas a este objeto at que a funo global ReleaseMouseCapture( )
seja chamada.
SetTag(nomeTag)

Associa um novo Tag (nomeTag) ao objeto. Retorna verdadeiro (diferente de zero)


se o Tag foi adicionado com sucesso ou falso (zero) se no foi. Se nomeTag um
string vazio (" "), ento o Tag associado removido do objeto. Esta funo somente
pode ser usada para objetos com apenas um nico Tag, ou seja, no vlida para os
objetos Tendncia e Barra.
Scripts

269

Manual do Usurio

Funes do Objeto Alarme


AckSelection()

Envia um sinal de reconhecimento (ACK) para todas as mensagens de alarme


selecionadas no objeto. Retorna o nmero de mensagens reconhecidas.
Exemplo:
DIM nAcks
nAcks = Alarm1.AckSelection()
IF nAcks > 0
MessageBox(Str(nAcks) + " message(s) acknowledged!")
ELSE
MessageBox("No messages acknowledged!")
ENDIF
GetColorZoneInfo(campo, zona)

Retorna informaes sobre uma zona de alarmes no-reconhecidos. zona o


nmero da zona (0, 1 ou 2). campo pode ser um dos seguintes campos:
MODO
CheckValue

DESCRIO
Retorna 0 se a zona est desabilitada, 1 se a zona
permitida

ForeColor

Retorna a cor de primeiro plano (texto) da zona

BackColor

Retorna a cor de fundo da zona

InitialValue

Retorna a menor prioridade para a zona

SecondValue

Retorna a maior prioridade para a zona

Exemplos:
// Ajusta a cor da zona 0 para branco se est habilitada
IF Alarm.GetColorZoneInfo("CheckValue", 0)
Alarm.SetColorZoneInfo("ForeColor", 0, RGB(255,255,255))
ENDIF
SetColorZoneInfo(campo, zona, valor)

Modifica o valor de um campo de uma zona de alarmes no-reconhecidos. zona e


campo tm o mesmo significado que em GetColorZoneInfo(). valor o novo valor
a ser atribudo ao campo.

270

Scripts

Manual do Usurio

Funes de Objetos AVI


End()

Move a posio do filme para o final.


Home()

Move a posio do filme para o incio.


OpenAVI()

Abre um arquivo AVI sem iniciar a reproduo.


PauseAVI()

Pausa o filme na posio atual.


PlayAVI([nFrom [, nTo]])

Abre um arquivo AVI e inicia a execuo do avi. Se nFrom for especificado, o


incio ser a partir do quadro nFrom. Se nTo for especificado, a reproduo ser at
o quadro nTo. Se o AVI estiver configurado para tocar ao contrrio, estes
parmetros sero ignorados e o filme vai ser tocado por inteiro. Se o atributo
timeFormat do AVI for 1, ento os parmetros nFrom e nTo sero interpretados
como milisegundos.
Step(nframes)

Move a posio do filme nframes quadros para frente. Se nframes for negativo, a
posio ser movida para trs. O filme ser pausado depois da chamada da funo.
Se o atributo timeFormat do AVI for 1, ento o parmetro nframes ser
interpretado como milisegundos.
StopAVI()

Pra a reproduo do filme e fecha o arquivo.


Funes da Barra
O parmetro barIndex usado nas funes abaixo o nmero que identifica a barra
no grfico de barras, sendo a primeira, identificada com o nmero zero, a segunda,
um, a terceira, dois, e assim por diante.

Scripts

271

Manual do Usurio
CheckLoLoLimit(barIndex, bEnable)
CheckLowLimit(barIndex, bEnable)
CheckHighLimit(barIndex, bEnable)
CheckHiHiLimit(barIndex, bEnable)

Estas funes habilitam ou desabilitam uma zona em um Bar Gauge.


Exemplo:
// Habilita a zona HiHi
// se tag1.HiHi.verify for verdadeiro.
Bar1.CheckHiHiLimit(2, tag1.HiHi.verify)
GetCheckLoLoLimit(barIndex)
GetCheckLowLimit(barIndex)
GetCheckHighLimit(barIndex)
GetCheckHiHiLimit(barIndex)

Estas funes retornam 1 se a zona correspondente estiver habilitada em um Bar


Gauge.
GetLoLoColor(barIndex)
GetLowColor(barIndex)
GetNormalColor(barIndex)
GetHighColor(barIndex)
GetHiHiColor(barIndex)

Retorna a cor da zona especfica em um Bar Gauge.

272

Scripts

Manual do Usurio

GetLoLoLimit(index)
GetLowLimit(index)
GetHighLimit(index)
GetHiHiLimit(index)

Retorna o limite da zona especfica em um Bar Gauge.


SetIndexBarColor(barIndex, color)

Ajusta a cor de um grfico de barra normal. Para um Bar Gauge, feita uma
configurao diferente.
Exemplo:
// Este exemplo muda a cor das barras 1 a 4 para vermelho
// no grfico de barras Bar1.
DIM index
FOR index = 1 to 4
Bar1.SetIndexBarColor(index, RGB(255,0,0) )
NEXT
SetLoLoColor( barIndex, color)
SetLowColor( barIndex, color)
SetNormalColor( barIndex, color)
SetHighColor( barIndex, color)
SetHiHiColor( barIndex, color)

Ajusta a cor de uma zona especfica em um Bar Gauge.


SetLoLoLimit( barIindex, value)
SetLowLimit( barIndex, value)
SetHighLimit( barIndex, value)
SetHiHiLimit( barIndex, value)

Ajusta o limite de uma zona especfica em um Bar Gauge.

Scripts

273

Manual do Usurio

Funes do Browser
GetField(nomeDoCampo)

Retorna o valor do campo indicado por nomeDoCampo na linha atual (apontada


por curSel). Se chamada no script OnDrawRow(), retorna o valor do campo na linha
que vai ser desenhada.
SetLabel(indiceColuna, titulo)

Permite mudar o ttulo de uma coluna em runtime. O parmetro indiceColuna indica


o nmero da coluna, comeando por 0. O nmero da coluna atribudo obedecendo
a ordem que aparece na aba Banco de Dados, mesmo para colunas desabilitadas. O
parmetro titulo indica o novo texto que deve ser configurado para a coluna.
SetRecordRange(primeiroReg, ltimoReg)

Define um intervalo de registros a ser carregado no Browser.


SetTempRowColor(cor)

Permite ajustar a cor de fundo da linha que vai ser desenhada.


SetTempRowTextColor(cor)

Permite ajustar a cor do texto da linha que vai ser desenhada.


UpdateQuery()

Atualiza a consulta do Browser, renovando os valores das linhas mostradas.


Funes de Objetos Texto
SetZoneText(iZone, Text)

Muda o texto da zona iZone para Text. Se iZone for 0 o texto de todas as zonas
modificado.
Funes de Objetos Tendncia
AddData(time)

Adiciona um novo valor a todas as penas da Tendncia.


BreakPen()

Quebra a pena, fazendo com que os novos dados adicionados no estejam


conectados com os pontos que j estavam na pena.
274

Scripts

Manual do Usurio

ClearData()

Apaga os dados da tendncia ou somente de uma pena da tendncia. Exemplo:


// Apaga todos os dados da tendncia Fornos
Fornos.ClearData()
// Apaga s os dados da pena Temp1 da tendncia Fornos
Fornos.Temp1.ClearData()
LoadHistoricData()

Carrega dados do histrico relacionado tendncia, segundo a consulta especificada.


Funes do VideoIn
Pause ()

Pausa a reproduo do video.


Play ()

Liga a reproduo do video.


Snapshot (nomedoarquivo, tipo)

Grava o quadro (frame) atual de um vdeo em um arquivo com o nome e caminho


nomedoarquivo. O nome do arquivo dever ter a extenso includa, a funo no
adiciona-a. tipo designa o tipo de arquivo e pode ser:

TIPO

DESCRIO
Arquivo RAW (salva o quadro atual no disco, sem nenhuma converso.

Formato BMP.

Formato GIF (limitado a uma paleta de 256 cores).

Formato JPEG.

Stop ()

Pra a reproduo do vdeo.

19.5.6. Funes de Alarmes


AckAllAlarms([tagName])

Reconhece todos os alarmes pertencentes ao tag tagName. Se tagName no for


especificado, todos os alarmes de todos os tag do alarme sero reconhecidos.
Scripts

275

Manual do Usurio

Exemplo:
// Reconhece todas as mensagens para o tag Heat1
Alarms.AckAllAlarms(Heat1)
// Reconhece tudo
Alarms.AckAllAlarms()
ClearHistoricalData()

Apaga todas as mensagens de alarmes e tambm limpa o arquivo de log de alarmes.


GetInfo(campo, zona)

Retorna informaes a respeito de uma mensagem de alarmes. Se zona no for


especificado, a funo retorna informaes sobre a ltima mensagem criada no
grupo de alarmes. O parmetro campo o nome do campo que se deseja saber o
contedo. Os valores possveis so:
Valores possveis
CAMPO
Comment

DESCRIO
Retorna um string com o Comentrio da mensagem.

DateTime

Retorna a marcao de tempo (timestamp) do alarme como


um valor datetime (nmero de segundos desde 01.01.1970).

Event

Retorna o tipo de evento, a saber: ALM para mensagem de


alarme e RTN para mensagens de retorno.

Limit

Retorna um inteiro com o limite do alarme.

Priority

Retorna um inteiro com a prioridade da mensagem de alarme.

State

Retorna um string com o estado do alarme, a saber: ACK


para reconhecido e UNACK para no-reconhecido.

Tagname

Retorna o nome do tag associado mensagem de alarme.

Type

Retorna um string com o tipo de alarme (HIHI, HIGH,


LOW, LOLO, RET)

Value

Retorna o valor do alarme.

Handle

Retorna um handle da mensagem de alarme. Este handle


pode ser armazenado e usado para recuperar as informaes
sobre o alarme posteriormente.

User

Retorna o usurio responsvel pela mensagem de alarme.

possvel usar abreviaes para os nomes dos campos, com pelo menos, dois
caracteres. Isto , o campo Value pode ser abreviado por VA, o campo
Priority pode ser abreviado por PR e assim por diante.
Exemplo:

276

Scripts

Manual do Usurio

// Alarms.OnAlarm() script
// guarda o handle de alarme das mensagens
// de tags que comeam "TEMP"
IF Left(Alarms.GetInfo("Tagname"), 4) == "TEMP"
lastHandle = Alarms.GetInfo("Handle")
ENDIF
GetNextActiveAlarmHandle( lastHandle)

Retorna o handle da prxima mensagem de alarmes ativos. Mensagens de alarmes


ativos so mostradas no Alarme Resumido. lastHandle pode ser: -1 para buscar o
primeiro handle de alarme ativo ou o nmero do handle anterior, retornado pela
funo GetNextActiveAlarmHandle. Se no h mais mensagens de alarmes ativos,
a funo retorna -1. O handle retornado pode ser usado na funo Alarms.GetInfo().
Exemplo:
// conta o nmero de mensagens de alarmes
// de tags que comeam "TEMP"
// e mostra em uma Caixa de Mensagem (MessageBox)
DIM hAlarm, strTagName, nTotal
nTotal = 0
hAlarm = Alarms.GetNextActiveAlarmHandle(-1)
While hAlarm <> -1
strTagName = Alarms.GetInfo("TA", hAlarm)
IF Left(strTagName, 4) == "TEMP"
nTotal = nTotal + 1
EndIf
hAlarm = Alarms.GetNextActiveAlarmHandle(hAlarm)
Wend
MessageBox("Existem " + Str(nTotal) + " alarmes ativos!")
RemoveFromSummary(messageID)

Remove do Alarme Resumido uma mensagem de alarme criada pela funo


SimulateAlarm com a ID messageID.
SimulateAlarm(id, timeStamp, strNomeTag, strComentrio, valor, limite,
pri, tipo, evt, estado)

Cria uma nova mensagem de alarme. Retorna 1 se bem-sucedida, ou 0 caso


contrrio. Os parmetros disponveis nesta funo so os seguintes:

Scripts

277

Manual do Usurio
Parmetros
CAMPO
id

278

DESCRIO
Identificador da mensagem do alarme. Se o valor for 0, a
mensagem de alarme ser escrita somente no registro de
alarmes. Se o valor for maior que 0, a mensagem ser escrita
no registro de alarmes e poder ser mostrada no objeto Alarme
da Tela. Voc deve passar o mesmo valor deste parmetro a
funo RemoveFromSummary para remover a mensagem do
sumrio.

timeStamp

TimeStamp do alarme.

strNomeTag

String que contm o nome do tag. Caso no exista tag, este


campo puramente informativo.

strComentrio

String que contm a mensagem de comentrio do alarme.

valor

Valor do alarme.

limite

Determina o limite mximo excedido pelo alarme.

pri

Nvel de prioridade do alarme, que pode ser de 1 at 999

tipo

Tipo de mensagem do alarme, que pode ser: RET, HIHI,


HIGH, LOLO, LOW or

evt

Tipo de evento: EVT, ACK, ALM, RTN or

estado

Determina o estado de reconhecimento do alarme: ACK,


UNACK ou

Scripts

Manual do Usurio

Exemplo:
// Este exemplo grava um evento do sistema no registro
// de alarmes. A mensagem no vai para o Alarme Resumido
// porque a ID 0.
Alarms.SimulateAlarm(0, GetTime(),_
"System", "Comm Error",0, 0, 1, "", "EVT", "UNACK")
// Este exemplo simula um alarme High
Alarms.SimulateAlarm(230, GetTime(), "pressure1",_
"Pressao 1 ALTA", 140, 120, 10, "HIGH", "ALM", "UNACK")
// A linha seguinte remove a mensagem simulada do Resumido
// e grava uma mensagem de retorno de alarme falsa no
// registro de alarmes
Alarms.RemoveFromSummary(230)
Alarms.SimulateAlarm(0, GetTime(), "pressure1",_
"Pressure normal",110, 120, 10, "RTN", "ALM", "ACK")

19.5.7. Funes das Receitas


ChooseRecipe(ttulo,registroSel[,x][,y][,largura][,altura])

Abre um dilogo que permite selecionar uma receita a partir de uma lista, retornando
seu ndice no arquivo. O parmetro ttulo um string a ser mostrado na barra de
ttulo do dilogo (coloque " " para uma janela sem ttulo), registroSel o ndice da
receita a ser selecionada quando o dilogo for aberto (coloque -1 para no selecionar
nenhuma), x, y, largura and altura so opcionais e indicam a posio e o tamanho
da janela; se no forem informados, o dilogo aberto no centro da tela ou na ltima
posio em que foi aberto, e uma borda permite que seu tamanho seja modificado.
Exemplo:
// tagReceita ir receber o ndice da receita escolhida.
// O Dilogo ser aberto no centro da tela, em uma janela
// redimensionvel, com o ttulo Lista de Receitas.
tagReceita = Receitas.ChooseRecipe("Lista de receitas",1)

No CE, a posio e a dimenso da janela so fixas.


CopyRecord(indice)

Copia um registro selecionado com os mesmos valores do registro original,


especificados em indice. Esta funo retorna o nmero de novos registros ou 0 se
falhar.

Scripts

279

Manual do Usurio
Exemplo:
// Copiando uma receita
DIM nRecord
nRecord = Recipe1.ChooseRecipe("Recipes", -1)
IF nRecord > 0
Recipe1.CopyRecord(nRecord)
ENDIF
CreateNewRecord(description)

Cria um novo registro no arquivo de Receitas conforme o parmetro description,


retornando o ndice do registro no arquivo.
DeleteRecipe(registro)

Apaga o registro de nmero registro em uma receita. Retorna verdadeiro (diferente


de zero) se a operao for efetuada com sucesso ou falso (zero) se no for.
EditProperties()

Abre uma janela que permite a edio das propriedades da Receita;


EditRecipe()

Abre uma caixa de dilogo para editar um arquivo de Receita.


FindRecipe(descrio)

Procura por um registro de uma receita que possui o string description na sua
descrio. Retorna o nmero do registro ou zero caso no encontre nenhum.
GetRecCount()

Retorna o nmero de registros do arquivo de receitas.


GetRecDescription(record)

Retorna a descrio de um registro record no arquivo de Receitas. O parmetro


record deve estar entre 1 <= record <= GetRecCount().
LoadRecipe(record)

Carrega uma receita record do arquivo de Receitas para os respectivos tags


relacionados. O parmetro record deve estar entre 1 <= record <= GetRecCount().
A funo retorna True se a receita foi carregada corretamente; False, se algum erro
ocorrer.
Exemplo:

280

Scripts

Manual do Usurio

// Carrega o quarto registro de Receitas


Receitas.LoadRecipe(4)
SaveRecipe(record)

Salva o registro record. A funo retorna True se a receita foi gravada corretamente;
False, se algum erro ocorrer.
SetRecDescription(record, description)

Muda para description a descrio do registro record no arquivo de Receitas.

19.5.8. Funes de Histricos


Analysis (x, y [, width [, height]])

Abre a janela da anlise histrica gerando o seu respectivo grfico. Os parmetros x


e y determinam as coordenadas horizontal e vertical da janela da anlise,
respectivamente. O parmetro width determina a largura da janela da anlise
histrica. O parmetro height determina a altura da janela da anlise histrica.
Average (src, type, startTime [, endTime])

Retorna a mdia de um conjunto de dados do histrico. O parmetro src determina o


nome do tag que gravado no histrico. O parmetro type determina o intervalo de
tempo a ser considerado para calcular a mdia, que pode ser o seguinte:
Intervalos de tempo
VALOR

ATRIBUTO

Ano

Ms

Semana

Dia

Hora

Minuto

O parmetro startTime determina o tempo inicial da mdia. O parmetro endTime


(opcional) determina o tempo final da mdia. Se ele for utilizado, o parmetro Type
ignorado.
Close()

Fecha um arquivo de histrico.


Scripts

281

Manual do Usurio
Edit()

Edita o registro corrente sem escrev-lo em disco. Para escrev-lo use a funo
Update().
EditProperties()

Abre uma janela que permite a edio das propriedades do histrico.


FindTime(time)

Retorna o ndice do primeiro registro que possui data e hora maior ou igual
especificada em time.
FinishBatchProcess()

Termina um histrico tipo batelada.


GetFirstRec()

Retorna o nmero do primeiro registro do arquivo de histrico.


GetLastRec()

Retorna o nmero do ltimo registro do arquivo de histrico.


GetRecCount()

Retorna o nmero total de registros do arquivo de histrico.


GetRecno()

Retorna a posio atual do ponteiro para o arquivo de histrico.


GoTo(recno)

Move o ponteiro de registros do arquivo de histrico para o registro de ndice recno


sem ler o registro.
IsBOF()

Verifica se o ponteiro de registros aponta para o incio do arquivo de histrico.


Retorna verdadeiro (diferente de zero) se o ponteiro estiver no incio ou falso (zero)
se no.
IsEOF()

Verifica se o ponteiro de registros aponta para o fim do arquivo de histrico. Retorna


verdadeiro (diferente de zero) se o ponteiro estiver no fim ou falso (zero) se no.

282

Scripts

Manual do Usurio

Move(n)

Move o ponteiro de registros do arquivo de histrico n registros para frente


(nmeros positivos) ou para trs (nmeros negativos). O registro lido e seus
valores carregados nos respectivos campos do histrico.
MoveFirst()

Move o ponteiro de registros do arquivo de histrico para o primeiro registro. O


registro lido e seus valores carregados nos respectivos campos do histrico.
MoveLast()

Move o ponteiro de registros do arquivo de histrico para o ltimo registro. O


registro lido e seus valores carregados nos respectivos campos do histrico.
MoveNext()

Move o ponteiro de registros do arquivo de histrico para o prximo registro. O


registro lido e seus valores carregados nos respectivos campos do histrico.
MovePrev()

Move o ponteiro de registros do arquivo de histrico para o registro anterior. O


registro lido e seus valores carregados nos respectivos campos do histrico.
Open()

Abre um arquivo de histrico.


RestartLastBatch()

Reinicia a ltima batelada.


SPC()

Executa a anlise do SPC.


StartBatchProcess()

Inicia um histrico por batelada.


Update()

Escreve o registro corrente.


WriteRecord()

Escreve um registro no arquivo de histrico.

Scripts

283

Manual do Usurio

19.5.9. Funes da Anlise Histrica


Analysis(x, y[,width[,height]])

Abre a janela da anlise histrica gerando o seu respectivo grfico. Os parmetros x


e y determinam as coordenadas horizontal e vertical da janela da anlise,
respectivamente. O parmetro width determina a largura da janela da anlise
histrica. O parmetro height determina a altura da janela da anlise histrica.
CloseAnalysis()

Fecha a janela da anlise histrica.


RequeryAnalysis()

Reaplica a consulta sobre o arquivo de dados da anlise histrica, carregando


novamente os dados na janela da anlise.
SPC()

Executa o CEP (Controle Estatstico de Processos) sobre o arquivo de dados da


anlise histrica.

19.5.10. Funes do CEP


Recalc([bMostraJanelaProgresso=1])

Recalcula todos os dados do CEP. Esta funo juntamente com SetDatField()


permite calcular o CEP automaticamente sem ter que abrir as janelas de
configurao
e
grfico,
especificada
atravs
do
parmetro
bMostraJanelaProgresso=1.
SetDatField(nomeCampo)

Ajusta o nome do campo do arquivo histrico que ser utlizado nos clculos do
CEP.

19.5.11. Funes de Relatrios


Funes Comuns

EditProperties()

Abre uma janela que permite a edio das propriedades do relatrio.


284

Scripts

Manual do Usurio

LoadCfg(nomeArquivo)

Carrega a configurao da impressora, margens e fontes do relatrio de um arquivo


em disco salvo pela funo SaveCfg().
Print(bShowErrorMessages,[strHeaderBmp],[strFooterBmp],
[bStretchHeader], [bStretchFooter])

Imprime o relatrio conforme a configurao especificada. Retorna verdadeiro


(diferente de zero) se o Relatrio for impresso com sucesso, ou falso (zero) se no
for. O parmetro bShowErrorMessages indica se o comando dever mostrar
mensagens de erro (1) ou dever executar em modo "silencioso", ou silent mode (0).
Os parmetros opcionais strHeaderBmp e strFooterBmp indicam os nomes do
arquivos com as imagems a serem includas no cabealho e no rodap,
respectivamente. J os parmetros opcionais bStretchHeader e bStretchFooter
habilitam , cada um por vez, o stretch no cabealho e no rodap.
SaveCfg(nomeArquivo)

Salva a configurao da impressora, margens e fontes do relatrio em um arquivo;


SetupPrinter()

Abre a janela de configurao (setup) da impressora.


Relatrio Texto
AddFilter (campo, valorMin, valorMax)

Filtra o valor de um campo. O parmetro campo um string especificando o nome


do campo numrico a ser filtrado. Os parmetros valorMin e valorMax especificam
um intervalo de valores para a busca. Registros que possuem valores fora deste
intervalo sero excludos do relatrio. recomendvel configurar o filtro antes da
impresso e remov-lo depois. Mais de um campo podem ser filtrados e somente os
registros que satisfaam todos os filtros sero includos no relatrio.
Exemplo:
TextRep1.AddFilter("code", 0, 23)
PrintToFile (arquivo, [bImprimeCabealho], [separador],
[bIndicarProgress], [bInserirAspas])

Imprime os dados de um arquivo Histrico ou de Alarmes para um arquivo texto


especificado pelo nome no parmetro fileName.
O parmetro bImprimeCabealho habilita (1) ou desabilita (0) a impresso do
cabealho (este parmetro opcional e o valor default 0). Quando voc seleciona
uma Batelada especfica para ser impressa com o parmetro bImprimeCabealho
Scripts

285

Manual do Usurio

como 1 e o atributo BImprimeCabealho do Relatrio como 1, a funo tambm ir


imprimir os dados do cabealho da batelada.
O parmetro separador um string contendo o caractere que ser utilizado para
separar os campos ( opcional e o valor default " ", ou seja, um espao em branco).
Retorna verdadeiro (diferente de zero) se o relatrio foi impresso com sucesso ou
falso (zero) se no foi. Nenhum cabealho impresso.
O parmetro bIndicarProgress habilita (1) ou desabilita (0) mostrar uma barra de
progresso enquanto o relatrio impresso (este parmetro opcional e o valor
default 0).
Se for utilizado um caractere separador, o parmetro bInserirAspas define se
colunas do tipo string e data/hora tero os valores envolvidos por aspas
(bInserirAspas = 1). Se o parmetro receber 0, nenhum tipo de coluna ser
envolvido por aspas, mesmo quando um caractere limitador usado. Este parmetro
opcional e o valor default 1.
Exemplo:
Relatorio.PrintToFile ("turtle.dat", 1, "-", 1)
RemoveAllFilters()

Remove os filtros de todos os campos do relatrio.


RemoveFilter(campo)

Remove um filtro de um campo field.

19.5.12. Funes de Consultas


FindTime(time, firstReg, lastReg)

Retorna o nmero do primeiro registro entre firstReg e lastReg que possue a data e
hora maior ou igual a time. Se no existirem registros no intervalo especificado com
a data maior ou igual a time a funo retorna -1.
Exemplo:
Query1.FindTime(MakeTime(2,3,1995,13,45,30), 20, 50)
ReloadStructure()

Fora o objeto consulta a recarregar a lista de campos. Isto est requerido se voc
mudar a especificao de fonte para a consulta e a estrutura da especificao for
diferente do campo precedente.
Exemplo:

286

Scripts

Manual do Usurio

ReportTxt.Query.filename = "C:\Data\MON12.DAT"
ReportTxt.Query.ReloadStructure()

19.5.13. Funes da Plotagem


SaveBitmap (nomeArquivo, largura, altura, escalaFonte)

Grava o grfico em um arquivo .BMP. O parmetro nomeArquivo determina o


nome (e o caminho) do arquivo .BMP. largura e altura especificam a largura e
altura do bitmap, respectivamente. escalaFonte determina o tamanho da fonte do
texto do bitmap, de acordo com a frmula tamanhoDaFonte *
(escalaFonte/1000). Se zero, o tamanho da fonte no alterado.
Exemplo:
Trend1.Plotter.SaveBitmap("C:\SNAPSHOT.BMP", 320, 200, 0)
TimeInHAxis()

Determina que o eixo X em um grfico XY expresse tempo.


TimeInVAxis()

Determina que o eixo Y em um grfico XY expresse tempo.


Funes do Cursor/Marca/Pena
O cursor no est habilitado no CE.
GetXAxis()

Retorna o nome do tag/campo do eixo x.


GetYAxis()

Retorna o nome do tag/campo do eixo y .


SetXAxis(strNome)

Modifica o tag/campo do eixo x atravs do parmetro strNome.


SetYAxis(strNome)

Modifica o tag/campo do eixo y atravs do parmetro strNome.

Scripts

287

Manual do Usurio

19.5.14. Funes de Drivers


Funes Comuns
EditProperties()

Abre uma janela que permite a edio das propriedades do driver.


LoadCfg(nomeArquivo)

Carrega um arquivo, especificado por nomeArquivo, com a configurao do driver.


SaveCfg(nomeArquivo)

Salva a configurao do driver em um arquivo especificado por nomeArquivo.


StartComm()

Inicia a comunicao com o driver. Retorna verdadeiro (diferente de zero) se a


comunicao foi iniciada com sucesso, ou falso (zero) se no foi.
StopComm()

Encerra a comunicao com o driver. Retorna verdadeiro (diferente de zero) se a


comunicao foi encerrada com sucesso, ou falso (zero) se no foi.

Drivers PLC
AddFilter(filter)

Adiciona um filtro de comunicao filter ao Driver. filter permite desabilitar leitura


ou escrita nos Tags PLC ou Bloco que possuam os mesmos parmetros
especificados no filtro.
Exemplo:
// desabilita todas comunicaes
// com N1 ou B1=1 e N2 ou B2 = 30
Driver1.AddFilter("1,30")
// desabilita todas as leituras com N4 ou B4 = 40
Driver1.AddFilter("R,,,40")

filter um string composto por 4 nmeros separados por vrgulas, correspondendo


aos parmetros N1/B1, N2/B2, N3/B3, N4/B4. O primeiro parmetro pode ser
precedido por uma letra como segue:
"R" desabilita leituras
"W" desabilita escritas
288

Scripts

Manual do Usurio

B" desabilita Tags Bloco


"T" desabilita Tags PLC
Se nenhuma letra for especificada todas as leituras e escritas nos tags PLC e Bloco
sero afetadas pelo filtro. A funo retorna zero (0) caso ocorra algum erro ou 1 se o
filtro foi adicionado com sucesso.
GetErrorInfo(param)

Retorna informao sobre o ltimo erro; param define qual informao ser
retornada.
Se param for 0, a funo vai retornar o tipo de comunicao que causou o erro,
como segue:
1 = leitura de um tag PLC;
2 = leitura de um tag Bloco;
3 = escrita em um tag PLC;
4 = escrita em um tag Bloco;
Se param for 1, 2, 3 ou 4, retorna os parmetros N1 a N4 do tag PLC ou B1 a B4 do
tag bloco que causou o erro.
Exemplo:
// Script Driver1.OnCommError()
// Filtra todos tags N1/B1 do ltimo erro
DIM strFilter
strFilter = Str(Driver1.GetErrorInfo(1))
// Evita adicionar o mesmo filtro mais de uma vez
// removendo o filtro anterior para o mesmo PLC
Driver1.RemoveFilter(strFilter)
Driver1.AddFilter(strFilter)
Reload()

Recarrega o driver do disco. No retorna nenhum valor caso ocorra um erro.


RemoveAllFilters()

Remove todos os filtros de um driver. No retorna nenhum valor caso ocorra um


erro.
RemoveFilter(filter)

Remove um filtro de um driver, adicionado com AddFilter(). Retorna verdadeiro


(diferente de zero) se o filtro foi removido com sucesso ou falso (zero) se ele no
existir ou for invlido. O parmetro filter deve ser especificado da mesma forma que
em AddFilter().
Scripts

289

Manual do Usurio
StartComm()

Inicia a comunicao com o driver. Retorna verdadeiro (diferente de zero) se a


comunicao foi iniciada com sucesso ou falso (zero) se no foi.
StopComm()

Encerra a comunicao com o driver. Retorna verdadeiro (diferente de zero) se a


comunicao foi encerrada com sucesso ou falso (zero) se no foi.
Drivers de Rede
Configure()

Abre uma caixa de dilogo para configurao dos parmetros do driver de rede.
StartDriver()

Carrega o driver de rede habilitando a comunicao remota. Retorna verdadeiro


(diferente de zero) se o driver foi carregado com sucesso ou falso (zero) se no foi.
StopDriver()

Pra o driver de rede desabilitando qualquer comunicao remota. Retorna sempre


verdadeiro (diferente de zero) indicando que o driver foi parado com sucesso.

290

Scripts

Manual do Usurio

19.5.15. Funes de Database


AddRecord (bUpdateQuery)

Adiciona um novo registro na database. Retorna TRUE (diferente de zero) se foi


adicionado com sucesso ou FALSE (zero) se algum dos seguintes erros ocorrer:
disco cheio, banco de dados somente para leitura, uma chave primria com um
valor j existente ou no foram feitas modificaes na database. necessrio
preencher todos os campos do registro antes de chamar a funo. O parmetro
bUpdateQuery indica se a consulta (query) deve ser atualizada depois de adicionarse o registro. Se o parmetro estiver em 0 (zero) ento o registro adicionado s
estar visvel aps a atualizao da consulta. O valor padro 1 (um).
Exemplos:
Table1.ID = tag002
Table1.Valor = tag003
Table1.AddRecord(1)
BeginTrans()

Inicia uma transao com a database (base de dados). Retorna verdadeiro se a


transao for comeada, falso se falhar ou se as transaes da sustentao da base de
dados no forem localizadas.
Exemplo:
if (BD1.CanTransact())
BD1.BeginTrans()// inicia uma transao
BD1.GotoRecord(0)// vai para o incio
while (not BD1.IsEOF())// se no o fim do arquivo
BD1.DeleteRecord()// apaga um registro
BD1.MoveNext()// vai para o prximo
wend
BD1.CommitTrans()// mesmo que BD1.EndTrans(1)
endif
CanTransact()

Retorna verdadeiro (diferente de zero) se a database est disponvel para transaes


ou falso (zero) se no est. Exemplo: veja em BeginTrans().
CloseConnection()

Fecha uma conexo ODBC. Esta operao libera o banco de dados para operaes
externas, como por exemplo, fazer um backup da database que est sendo usada pelo
Elipse ou mudar algum parmetro de conexo.
Scripts

291

Manual do Usurio
CommitTrans()

Termina uma transao salvando todos os novos dados.


Exemplo: veja em BeginTrans().
DeleteRecord()

Apaga o registro corrente do Banco de Dados. Retorna verdadeiro (diferente de


zero) se o registro foi removido ou falso (zero) se algum dos seguintes erros ocorrer:
o banco de dados somente para leitura, o ponteiro de registros est apontando para
a marca de incio de arquivo (BOF), o ponteiro de registros est apontando para a
marca de fim de arquivo (EOF). Esta funo apaga todos os registros duplicados, ou
seja, que possuam os mesmos dados, caso um nico registro duplicado seja apagado.
Exemplo: veja o exemplo em BeginTrans().
EditProperties()

Abre uma janela que permite a edio das propriedades do Banco de Dados.
EditRecord()

Edita o registro corrente sem escrev-lo em disco. Para escrev-lo use a funo
Update(). Estas duas funes esto obsoletas e so mantidas para permitir
compatibilidade com verses anteriores do software. Para editar um registro,
atualmente, deve-se apenas modificar os valores dos campos, uma vez estando sobre
os mesmos.
EndTrans(n)

Encerra uma transao conforme o parmetro n. Se n um (1) chamada a funo


CommitTrans() se zero (0) chamada a funo RollBack(). Exemplo: veja em
BeginTrans().
Find(strCondition [, bMoveFirst=0])

Procura o primeiro registro da condio strCondition. Se bMoveFirst for 1 a busca


partir do primeiro registro, se bMoveFirst for 0 (opo) a busca partir do registro
atual. strCondition uma expresso de texto usada encontrar o registro (como
clusula Where em uma indicao do SQL sem a palavra Where). (Apenas em
DAO.)

292

Scripts

Manual do Usurio

GetConnectionString()

Obtm o string de conexo usado pelo driver ODBC.


Exemplo:
// Obtm o string ODBC da conexo de BD1
strConexao = BD1.GetConnectionString()
GetEditMode()

Retornam o estado da edio para o registro atual. (Apenas em DAO.) Pode ser um
dos seguintes valores:
-1

VALOR

ATRIBUTO
A tabela no est conectada (fechada).

Nenhuma edio em progresso.

O registro est sendo modificado.

O registro est sendo adicionado.

GetLastError()

Retorna a ltima mensagem de erro ocorrida durante uma transao com o Banco de
Dados.
GetODBCParameter(strParam)

Retornam o valor do parmetro strParam da string da conexo ODBC. A string da


conexo uma seqncia dos parmetros e dos valores de parmetro como no
ODBC;DSN=C:\Data.DB;Timeout=500.
Exemplo:
strDSN = Table1.GetODBCParameter(.DSN.)
GetRecordNumber()

Retorna o nmero do registro no Banco de Dados. O primeiro registro o nmero


zero.
GetTableName()

Obtm o nome da tabela do Banco de Dados. (Apenas em ODBC.)

Scripts

293

Manual do Usurio

GetTotalNumberOfRecords()

Retorna o nmero total de registros no Banco de Dados conforme a Consulta


especificada na funo SQLQuery().
Exemplo:
// Retorna o nmero total de registros,
// pois no tem um consulta definida.
BD1.SQLQuery(" ", " ")
TagRam = BD1.GetTotalNumberOfRecords()
GotoRecord(n)

Move o ponteiro de registros para o registro n, conforme a Consulta especificada.


Retorna verdadeiro (diferente de zero) se a movimentao foi feita com sucesso ou
falso (zero) se for achado uma marca de fim de arquivo EOF.
Exemplo:
// vai para o 13o. registro, uma vez que o primeiro
// registro tem sempre ndice 0 (zero)
Database1.GotoRecord(12)
IsBOF()

Verifica se o ponteiro de registros est no incio do arquivo. Retorna verdadeiro


(diferente de zero) se est ou falso (zero) se no est.
IsEOF()

Verifica se o ponteiro de registros est no final do arquivo. Retorna verdadeiro


(diferente de zero) se est ou falso (zero) se no est.
Exemplo: veja em BeginTrans().
Locate(strCondio [, bMoveParaIncio])

Procura pelo prximo registro que atenda expresso informada no parmetro string
strCondio. O parmetro bMoveParaIncio um valor booleano que define se a
procura deve comear a partir do primeiro registro do banco de dados
(bMoveParaInicio = 1) ou do registro atual (bMoveParaInicio = 0).
Exemplo:
// Localiza o primeiro registro que atenda a expresso
// a partir do registro atual
Database1.Locate("temp == tag001 * tag002", 0)

294

Scripts

Manual do Usurio

Move(n)

Move o ponteiro do banco de dados n registros para frente relativos a posio atual
do ponteiro. Retorna verdadeiro (diferente de zero) se a movimentao foi feita com
sucesso ou falso (zero) se for achado uma marca de fim de arquivo EOF.
Exemplo:
// Posiciona o ponteiro no 11o. registro, uma vez que
// o primeiro registro tem sempre ndice 0 (zero)
Database1.GotoRecord(10)
// Posiciona o ponteiro no prximo registro (12o. registro)
Database1.Move(1)
// Volta dois registros (10o. registro)
Database1.Move(-2)
MoveFirst()

Move o ponteiro de registros para o primeiro registro do banco de dados. Retorna


verdadeiro (diferente de zero) se a movimentao foi feita com sucesso ou falso
(zero) se no foi.
MoveLast()

Move o ponteiro de registros para o ltimo registro do banco de dados. Retorna


verdadeiro (diferente de zero) se a movimentao foi feita com sucesso ou falso
(zero) se no foi.
MoveNext()

Move o ponteiro de registros para o prximo registro. Retorna verdadeiro (diferente


de zero) se a movimentao foi feita com sucesso ou falso (zero) se for achado uma
marca de fim de arquivo EOF.
MovePrev()

Move o ponteiro de registros para o registro anterior. Retorna verdadeiro (diferente


de zero) se a movimentao foi feita com sucesso ou falso (zero) se for achado uma
marca de incio de arquivo BOF.
OpenConnection()

Reabre uma conexo ODBC. Deve ser usada somente aps uma funo
CloseConnection() j ter sido usada, uma vez que os bancos de dados usados no
Elipse SCADA so abertos juntamente com a aplicao. Retorna verdadeiro
(diferente de zero) se a operao obteve sucesso ou falso (zero) se no.

Scripts

295

Manual do Usurio
Requery()

Atualiza o Banco de Dados. til quando mais de um usurio est usando o BD.
Esta funo no necessria quando voc est usando a funo Update(1), j que
esta prpria funo atualiza o BD.
RollBack()

Desfaz todas as aes feitas durante uma transao. Retorna verdadeiro (diferente de
zero) se as aes foram desfeitas com sucesso ou falso (zero) se no.
SetODBCParameter(param, valor)

Muda um parmetro dentro do string de conexo ODBC.


Exemplo:
// muda a string de conexo ODBC para usar o banco
// de dados Access de nome Suporte que se encontra
// no raiz do disco C:
Database1.CloseConnection()
Database1.SetODBCParameter("DBQ", "C:\suporte.mdb")
Database1.OpenConnection()
SetTableName(nomeTabela)

Define um novo nome para a tabela corrente.


Exemplo:
Table1.CloseConnection()
Table1.SetTableName("Producao")
Table1.OpenConnection()
SQLQuery(Filtro, OrdenarPor)

Define um filtro a ser usado na consulta ao Banco de Dados, conforme os


parmetros Filtro e OrdenarPor.
Filtro: Define um filtro a ser usado na consulta ao Banco de Dados conforme os
campos e as opes do usurio. Para usar este parmetro voc precisa especificar um
valor ou expresso a ser usado para pesquisa de um campo especfico. Quando no
existe um filtro especfico para o parmetro Filtro, voc deve entrar com um string
vazio.
Os operadores aceitos em expresses neste parmetro so: =, <> (diferente), <, >,
<=, >=, !< (no menor do que), !> (no maior do que), AND, OR, NOT, LIKE
(semelhante ou igual), IN, BETWEEN, IS NULL, IS NOT NULL.
OrdenarPor: Define uma ordem para a pesquisa no Banco de Dados conforme o
campo especificado, que pode ser ascendente (default) ou descendente. Este campo
obrigatrio, mas pode ser especificada um string vazio.
A funo retorna o nmero de registros encontrados na consulta.
296

Scripts

Manual do Usurio

Exemplos:
// Procura todos os registros que possuem "Maria" no campo
// nome, em ordem ascendente e retorna a quantidade de
// registros resultantes em Quantos
quantos = Database1.SQLQuery("nome = 'Maria'","nome")
// Nenhum filtro. Note que as aspas do string
// podem ser duplas ou simples.
Database1.SQLQuery(" ")
// Procura todos os registros que possuem no
// campo name um string maior que 'Mary' e no campo
// salary um nmero maior que 1000. Ambos os filtros
// devem ser satisfeitos.
Database1.SQLQuery("name > 'Mary' AND salary > 1000")
// Voc pode usar o valor de um Tag para criar
// um string usando a concatenao.
Database1.SQLQuery("name = '"+TagRam1+"'")
// Procura todos os registros que possuem no
// campo name um string que comea por 'ma'.
// Por exemplo: Maria, Mario, Manoela, Marcelo
Database1.SQLQuery("name LIKE 'ma%'")
// Procura todos os registros que possuem no
// campo vendas um nmero entre 40000 e 100000.
Database1.SQLQuery("vendas BETWEEN 40000 AND 100000")
// Procura todos os registros que possuem no
// campo opcional um espao em branco, ordenado em
// ordem descendente pelo campo nome.
Database1.SQLQuery("opcional IS NULL","nome DESC")
// Faz a consulta por data
Database1.SQLQuery("Date = CDate('10/09/2006')")

NOTA: este ltimo exemplo vlido para o banco de dados MDB. Outros bancos
podem no aceitar este formato de consulta.

Scripts

297

Manual do Usurio

Update(bReconsulta)

Atualiza as mudanas feitas no registro. O parmetro bReconsulta determina se


deve ser feita uma consulta aps atualizao dos registros. Se este parmetro for 1, a
consulta feita e os registros so atualizados e se for 0, os registros adicionados s
estaro visveis aps a atualizao da consulta. Esta funo est obsoleta e foi
mantida para permitir compatibilidade com verses anteriores do software.
Atualmente, as gravaes no banco de dados so feitas automaticamente quando
necessrias.

19.5.16. Funes de Aplicaes Remotas


Configure()

Abre uma caixa de dilogo do driver para configurao dos parmetros da Aplicao
Remota.
Connect()

Estabelece conexo com a Aplicao Remota. Retorna verdadeiro (diferente de zero)


se a conexo foi estabelecida com sucesso ou falso (zero) se no.
Disconnect()

Encerra a conexo com a Aplicao Remota. Retorna verdadeiro (diferente de zero)


se a conexo foi encerrada com sucesso ou falso (zero) se no.
EditProperties()

Abre uma janela que permite a edio das propriedades da Aplicao Remota.
LoadCfg(nomeArquivo)

Carrega de um arquivo, especificado por nomeArquivo, a configurao da


Aplicao Remota.
SaveCfg(nomeArquivo)

Salva a configurao da Aplicao Remota em um arquivo, especificado por


nomeArquivo.
Funes para Arquivos Remotos
Cancel()

Aborta uma transferncia de arquivo que esteja em andamento.


298

Scripts

Manual do Usurio

GetFile(serverFile, clientFile)

Obtm um arquivo do servidor com o nome serverFile e faz uma cpia deste para
um arquivo local com nome clientFile.

19.5.17. Funes do OPCServer


Connect()

Estabelece conexo com o servidor OPC.


Disconnect()

Encerra a conexo com o servidor OPC.


NOTA: Para saber se o servidor OPC est conectado ou no, deve-se monitorar a
propriedade ServerStatus (ver Propriedades do OPCServer).
EditProperties()

Abre uma janela que permite a edio das propriedades do objeto.

Scripts

299

Manual do Usurio

19.6. Atributos
Atributos so dados associados a um objeto que determinam suas caractersticas e a
maneira com que ele ir se comportar. Normalmente existe uma janela onde voc
pode modificar os atributos de um objeto. Cada atributo tem um tipo associado
representado por seu cone conforme segue:
Atributo numrico
Atributo string (texto)
Atributo booleano (verdadeiro/falso, true/false
Atributo de sistema, usado internamente pelo Elipse
SCADA.

As sees a seguir iro descrever os seguintes atributos:


Atributos Globais

Atributos da Receita

Atributos da Aplicao

Atributos do Histrico

Atributos dos Tags

Atributos do Relatrio

Atributos da Tela

Atributos do Driver

Atributos do Alarme

Atributos de Databases

Atributo de Usurios

Atributo de Aplicao Remota

Atributo de Watcher

Atributo de Steeplechase

Atributo de OPCServer

19.6.1. Atributos do Gerenciador Global


Estes atributos so atributos Globais do Elipse SCADA e podem ser modificados de
qualquer ponto da aplicao. Porm, deve-se ter cuidado ao modificar qualquer um
destes atributos j que eles podem mudar a funcionalidade de um Script ou de um
objeto.
currentTime: Um inteiro sem sinal (somente leitura) contendo a data e hora
atual do sistema para ser utilizado em expresses ou em displays com formato
data/hora. atualizado uma vez por segundo. No deve ser usado como contador de
tempo em scripts pois no atualizado durante a execuo de scripts. Neste caso,
use a funo gettime() que atualizada sempre que chamada;
300

Scripts

Manual do Usurio

day: Um inteiro contendo o dia do sistema;


dayOfWeek: um inteiro sem sinal de 1 to 7 (somente leitura) contendo o nmero
do dia da semana corrente, conforme segue: 1 - Domingo, 2 - Segunda, 3 - Tera, 4 Quarta, 5 - Quinta, 6 - Sexta, 7 - Sbado;
description: Um string contendo uma breve descrio sobre o objeto global;
hour: Um inteiro contendo a hora do sistema;
lastError: Um inteiro sem sinal de 0 a 65535 (somente leitura) contendo o
cdigo do ltimo erro ocorrido em operaes com arquivos ou diretrios;
lastErrorStr: Um string contendo a descrio do ltimo erro ocorrido em
operaes com arquivos ou diretrios.
minute: Um inteiro contendo os minutos do sistema;
month: Um inteiro contendo o ms do sistema;
name: Um string contendo o nome do objeto global, usado como identificador
para o mesmo;
performanceCount
: Indica a performance da aplicao, que pode variar de 0
a 1000. O valor 0 determina que a aplicao est carregada e 1000 determina que a
aplicao est com folga de processamento.
second: Um inteiro contendo os segundos do sistema;
year: Um inteiro contendo o ano do sistema;

19.6.2. Atributos da Aplicao


activeAlarms: Um inteiro que indica o nmero de alarmes ativos na aplicao.
allowClose
: Um atributo booleano (somente leitura) determinando que o
aplicativo possa ser fechado por outros meios que no a funo StopRunning()
como por exemplo, um clique do mouse no boto Close ou o comando Shutdown
do Windows. Retorna verdadeiro (diferente de zero) se o boto est habilitado ou
falso (zero) se no est;
centerWindow
: Um atributo booleano usado para habilitar a centralizao
da janela da aplicao, no incio da sua execuo. Retorna True (sem zero) se a
centralizao da janela for habillitada e false (zero) caso contrrio.
closeButton
: Um atributo booleano (somente leitura) determinando que o
boto de close esteja habilitado na janela da aplicao. Retorna verdadeiro (diferente
de zero) se o boto est habilitado ou falso (zero) se no est;
description: Um string contendo uma breve descrio sobre a aplicao;
Scripts

301

Manual do Usurio

exclusive
: Um atributo booleano determinando que o Elipse SCADA possua
exclusividade para uso da CPU. Retorna verdadeiro (diferente de zero) se o Elipse
SCADA exclusivo ou falso (zero) se no ;
height: Um inteiro sem sinal (de 0 a 65535) determinando a altura da janela da
Aplicao, em pixels. usado juntamente com o atributo width para definir o
tamanho da janela. Este atributo deve ser definido conforme a resoluo usada no
Windows para que se tenha uma janela sem scroll bar. Por exemplo, se voc est
usando uma resoluo de 640x480 (VGA) o parmetro height pode variar de 0 a 480
pixels;
isMaximized: Um atributo booleano determinando se a janela da aplicao est
maximizada ou no. Retorna verdadeiro (diferente de zero) se a janela est
maximizada ou falso (zero) se no est;
isMinimized: Um atributo booleano determinando se a janela da aplicao est
minimizada ou no. Retorna verdadeiro (diferente de zero) se a janela est
minimizada ou falso (zero) se no est;
isNormal: Um atributo booleano determinando se a janela da aplicao est
normalizada ou no. Retorna verdadeiro (diferente de zero) se a janela est
normalizada ou falso (zero) se no est;
keyPadBackColor
: Um nmero hexadecimal (de 0h a 1000000h) ou
decimal (de 0 a 16777215) definindo a cor de fundo do Key Pad (Teclado em Tela).
Este valor tambm pode ser especificado pela funo RGB(r,g,b) onde cada
componente (r,g,b) pode variar de 0 a 255.
keyPadHeight
: Um inteiro sem sinal (de 0 a 65535) determinando a altura
da janela do Key Pad, em pixels. usado juntamente com o atributo KeyPadWidth
para definir o tamanho da janela. Este atributo deve ser definido conforme a
resoluo usada no Windows para que se tenha uma janela sem scroll bar. Por
exemplo, se voc est usando uma resoluo de 640x480 (VGA) o parmetro height
pode variar de 0 a 480 pixels;
keyPadKeyColor
: Um nmero hexadecimal (de 0h a 1000000h) ou decimal
(de 0 a 16777215) definindo a cor das teclas do Key Pad (Teclado em Tela). Este
valor tambm pode ser especificado pela funo RGB(r,g,b) onde cada componente
(r,g,b) pode variar de 0 a 255.
keyPadTextColor
: Um nmero hexadecimal (de 0h a 1000000h) ou
decimal (de 0 a 16777215) definindo a cor do texto das teclas do Key Pad (Teclado
em Tela). Este valor tambm pode ser especificado pela funo RGB(r,g,b) onde
cada componente (r,g,b) pode variar de 0 a 255.
keyPadTitleBar
: Atributo booleano, indica se o Key Pad ter barra de ttulo
(um, default) ou no (zero).

302

Scripts

Manual do Usurio

keyPadVisible
: Um atributo booleano determinando que o Key Pad seja
visvel. Retorna verdadeiro (diferente de zero) se a Key Pad visvel ou falso (zero)
se no .
keyPadWidth
: Um inteiro sem sinal (de 0 a 65535) determinando a largura
da janela do Key Pad, em pixels. usado juntamente com o atributo KeyPadHeight
para definir o tamanho da janela. Este atributo deve ser definido conforme a
resoluo usada no Windows para que se tenha uma janela sem scroll bar. Por
exemplo, se voc est usando uma resoluo de 640x480 (VGA) o parmetro height
pode variar de 0 a 640 pixels;
keyPadX
: Um inteiro com sinal (de -32768 a 32767) determinando a
coordenada X para o canto superior esquerdo da janela do Key Pad, em pixels.
usado juntamente com o atributo Y para definir a posio do canto superior esquerdo
da janela. Este atributo deve ser definido conforme a resoluo usada no Windows
para que se tenha uma janela sem scroll bar. Por exemplo, se voc est usando uma
resoluo de 640x480 (VGA) a sua coordenada X pode variar de 0 a 640 pixels;
keyPadY
: Um inteiro com sinal (de -32768 a 32767) determinando a
coordenada Y para o canto superior esquerdo da janela do Key Pad, em pixels.
usado juntamente com o atributo X para definir a posio do canto superior esquerdo
da janela. Este atributo deve ser definido conforme a resoluo usada no Windows
para que se tenha uma janela sem scroll bar. Por exemplo, se voc est usando uma
resoluo de 640x480 (VGA) a sua coordenada Y pode variar de 0 a 480 pixels;
largeButtons: Um atributo booleano habilitando botes grandes no Organizer,
Anlise Histrica, etc. para facilitar o uso do Touch Screen. Retorna verdadeiro
(diferente de zero) se os botes grandes esto habilitados ou falso (zero) se no
esto.
maximizeButton
: Um atributo booleano(somente leitura) determinando que
o boto maximizar esteja habilitado na janela da aplicao. Retorna verdadeiro
(diferente de zero) se o boto est habilitado ou falso (zero) se no est.
minimizeButton
: Um atributo booleano (somente leitura) determinando que
o boto minimizar esteja habilitado na janela da aplicao. Retorna verdadeiro
(diferente de zero) se o boto est habilitado ou falso (zero) se no est.
name: Um string contendo o nome da aplicao, usado como identificador para
a mesma.
noMousePointer
: Um atributo booleano usado para desabilitar (esconder) o
ponteiro do mouse em tempo de execuo (quando executando uma aplicao).
Retorna verdadeiro (diferente de zero) se o mouse est desabilitado ou falso (zero)
se no est.
noScreenSaver
: Um atributo booleano usado para desabilitar o screen saver
em tempo de execuo (quando executando uma aplicao). Retorna verdadeiro
(diferente de zero) se o screen saver est desabilitado ou falso (zero) se no est.
Scripts

303

Manual do Usurio

numPadCloseButton
: Atributo booleano, indica se o boto para fechar o
NumPad dever ser apresentado (valor um, default) ou no (valor zero).
numPadTitleBar
: Atributo booleano, indica se o Numeric Pad ter barra de
ttulo (um, default) ou no (zero).
numPadTitleBarText
: Atributo string, permite indicar um texto para a
barra de ttulo do Numeric Pad (vazio, por default).
revision: Um inteiro sem sinal (somente leitura) indicando o nmero de reviso
da aplicao. automaticamente incrementado cada vez que a aplicao salva.
saveKeyPadCoord
: Um atributo booleano determinando que as
coordenadas e o tamanho da janela do KeyPad (Teclado em tela) seja salvo para
carregar na prxima abertura do mesmo. Retorna verdadeiro (diferente de zero) se o
salvamento est habilitado ou falso (zero) se no est.
startMaximized: Um atributo booleano determinando que a janela da aplicao
inicie maximizada. Retorna verdadeiro (diferente de zero) se a aplicao inicia
maximizada ou falso (zero) se no.
startMinimized: Um atributo booleano determinando que a janela da aplicao
inicie minimizada. Retorna verdadeiro (diferente de zero) se a aplicao inicia
minimizada ou falso (zero) se no.
startNormal: Um atributo booleano determinando que a janela da aplicao
inicie normalizada. Retorna verdadeiro (diferente de zero) se a aplicao inicia
normalizada ou falso (zero) se no.
startScreen: Somente para uso do Elipse SCADA. No so permitidas
modificaes por parte de usurios.
titleBar
: Um atributo booleano determinando que a Barra de Ttulo seja
mostrada na janela da aplicao. Retorna verdadeiro (diferente de zero) se a Barra de
Ttulo mostrada ou falso (zero) se no .
useKeyPad: Um atributo booleano habilitando o uso do KeyPad (Teclado em
tela) em tempo de execuo. Retorna verdadeiro (diferente de zero) se o KeyPad
est habilitado ou falso (zero) se no est.
userAccessLevel: Um inteiro sem sinal de 0 a 65535 (somente leitura)
determinando o nvel de acesso do usurio logado na aplicao.
userLogin: Um string (somente leitura) contendo o nome de usurio (login)
corrente.
userName: Um string (somente leitura) contendo o usurio corrente logado na
aplicao.
version: Um string (somente leitura) indicando a verso do Elipse que salvou a
aplicao por ltimo.
304

Scripts

Manual do Usurio

width: Um inteiro sem sinal (de 0 a 65535) determinando a largura da janela da


Aplicao, em pixels. usado juntamente com o atributo height para definir o
tamanho da janela. Este atributo deve ser definido conforme a resoluo usada no
Windows para que se tenha uma janela sem scroll bar. Por exemplo, se voc est
usando uma resoluo de 640x480 (VGA) o parmetro width pode variar de 0 a 640
pixels.
x: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X para
o canto superior esquerdo da janela da Aplicao, em pixels. usado juntamente
com o atributo Y para definir a posio do canto superior esquerdo da janela. Este
atributo deve ser definido conforme a resoluo usada no Windows para que se
tenha uma janela sem scroll bar. Por exemplo, se voc est usando uma resoluo de
640x480 (VGA) a sua coordenada X pode variar de 0 a 640 pixels.
y: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada Y para
o canto superior esquerdo da janela da Aplicao, em pixels. usado juntamente
com o atributo X para definir a posio do canto superior esquerdo da janela.

19.6.3. Atributos de Tags


Atributos Comuns
advised: (booleano, somente leitura) Usado para indicar se o item est em
advise, isto , se os objetos associados ao tag so informados sempre que o valor
do tag mudar.
alarmDelay: (inteiro sem sinal) o tempo mnimo (em milisegundos) que o tag
deve permanecer em uma mesma condio de alarme antes deste tornar-se ativo. Se
alarmDelay for modificado em tempo de execuo, o contador de tempo
reiniciado. Este atributo s vlido se o atributo delayedAlarm for True (ver
atributo delayedAlarm).
alternateName: (string) Nome alternativo do tag para ser usado no registro (log)
de alarmes do Tag.
alwaysInAdvise: (boolean) Permite forar um tag estar em advise (ver atributo
advised).
currentAlarm: (inteiro sem sinal, apenas leitura) Indica o estado de alarme atual
do tag, conforme segue: 0, sem alarme; 1, LoLo; 2, Low; 3, High e 4, HiHi.
delayedAlarm: (booleano) Se TRUE, o tag deve permanecer um tempo mnimo
(especificado em alarmDelay) em uma mesma condio de alarme (Hi, HiHi, Lo,
LoLo) para ativar (ou gerar) o alarme correspondente.
description: (string) Contm uma breve descrio sobre o tag.
Scripts

305

Manual do Usurio

enableAlternateName: (booleano) Habilita utilizar um nome alternativo


(indicado no atributo alternateName) para o registro (log) de alarmes do tag.
enableReturnLog: (booleano) Usado para habilitar o log da mensagem de
retorno do alarme. Retorna verdadeiro (diferente de zero) se o log est habilitado ou
falso (zero) se no est.
name: (string) Contm o nome do tag, usado como identificador do tag.
returnMessage: (string) Contm a mensagem de retorno de alarme para o tag.
timeStamp: (real, somente leitura) Contm a ltima data e hora em que o valor
do tag foi modificado.
Atributos de Grupos de Tags
totalAlarms: (inteiro sem sinal, apenas leitura) que indica o nmero de alarmes
ativos nos tags e subgrupos do grupo.
Atributos de Tags OPC
quality: Um inteiro sem sinal (somente leitura), que indica a qualidade do tag
OPC.
Atributos de Tags PLC
autoRead: Um atributo booleano usado para habilitar a leitura automtica do
PLC. Retorna verdadeiro (diferente de zero) se a leitura automtica est habilitada
ou falso (zero) se no est. Deve ser usado em conjunto com o atributo enableScan
devendo ambos estarem marcados ou desmarcados;
autoWrite: Um atributo booleano usado para habilitar a escrita automtica no
PLC. Retorna verdadeiro (diferente de zero) se a escrita automtica est habilitada
ou falso (zero) se no est;
driverName: Um string contendo o nome do Driver do PLC conectado ao
sistema, usado como um identificador do Driver;
enableScan: Um atributo booleano usado para habilitar a leitura do PLC.
Retorna verdadeiro (diferente de zero) se o scan est habilitado ou falso (zero) se
no est. Deve ser usado em conjunto com o atributo autoRead devendo ambos
estarem marcados ou desmarcados;
high1: Um nmero real configurando o limite superior do PLC. Ele usado
junto com o atributo low1 para definir um intervalo de variao;
high2: Um nmero real configurando o limite superior do sistema. Ele usado
junto com o atributo low2 para definir um intervalo de variao;
306

Scripts

Manual do Usurio

low1: Um nmero real configurando o limite inferior do PLC. Ele usado junto
com o atributo high1 para definir um intervalo de variao;
low2: Um nmero real configurando o limite inferior do sistema. Ele usado
junto com o atributo high2 para definir um intervalo de variao;
n1: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro N1
conforme a documentao do Driver;
n2: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro N2
conforme a documentao do Driver;
n3: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro N3
conforme a documentao do Driver;
n4: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro N4
conforme a documentao do Driver;
nFailReads: Um inteiro sem sinal (somente leitura) que indica o nmero total de
leituras incorretas;
nFailWrites: Um inteiro sem sinal (somente leitura) que indica o nmero total
de escritas incorretas;
nOKReads: Um inteiro sem sinal (somente leitura) que indica o nmero total de
leituras feitas com sucesso;
nOKWrites: Um inteiro sem sinal (somente leitura) que indica o nmero total
de escritas feitas com sucesso;
realScan: Um nmero real (somente leitura) indicando o tempo real de scan em
que o Elipse est conseguindo ler o Tag.
scaling: Um atributo booleano usado para habilitar escalas de valores entre o
PLC e o sistema. Retorna verdadeiro (diferente de zero) se a escala est habilitada
ou falso (zero) se no est. Com este atributo habilitado voc pode configurar os
atributos low1, high1, low2 e high2;
scanTime: Um inteiro com sinal (de -32768 a 32767) configurando o intervalo
de tempo entre duas leituras;
status: Um string (somente leitura) contendo o estado atual de comunicao do
Tag: "Reading" (lendo), "Writing" (escrevendo), "Idle" (fazendo nada);
Atributos de Tags DDE
computer: Um string contendo o nome do computador a ser conectado usando
DDE. usado como identificador do computador em uma rede e pode ser mudado
em tempo de execuo.
Scripts

307

Manual do Usurio

high1: Um nmero real configurando o limite superior do PLC. Ele usado


junto com o atributo low1 para definir um intervalo de variao;
high2: Um nmero real configurando o limite superior do sistema. Ele usado
junto com o atributo low2 para definir um intervalo de variao;
item: Um string contendo o nome dos dados a serem monitorados pelo Tag
DDE. usado como identificador dos dados. Em uma conexo entre dois Elipse
SCADA este atributo pode ser um Tag, em uma conexo com o Excel este atributo
deve ser declarado como RxCy onde x a linha e y a coluna de uma clula
especfica;
low1: Um nmero real configurando o limite inferior do PLC. Ele usado junto
com o atributo high1 para definir um intervalo de variao;
low2: Um nmero real configurando o limite inferior do sistema. Ele usado
junto com o atributo high2 para definir um intervalo de variao;
scaling: Um atributo booleano usado para habilitar escalas de valores entre o
PLC e o sistema. Retorna verdadeiro (diferente de zero) se a escala est habilitada
ou falso (zero) se no est. Com este atributo habilitado voc pode configurar os
atributos low1, high1, low2 e high2;
server: Um string contendo o nome da aplicao a ser conectada usando DDE.
usado como um identificador da aplicao no computador especificado para a
conexo. Por exemplo, voc deseja criar uma conexo DDE no computador
Elipse_Software, que est executando o Elipse SCADA cujo nome DDE ELIPSE$.
Voc pode mudar este atributo em tempo de execuo;
topic: Um string contendo o nome da janela ou rea de trabalho a ser conectada
usando DDE. usado como identificador de uma rea de trabalho no servidor da
aplicao;
Atributos de Tags Demo
delay: Um inteiro configurando o nmero de perodos entre cada gerao de
valor para o tag demo. Por exemplo, se for 1 um valor gerado a cada perodo, se
for 2, gera um valor a cada dois perodos, e assim por diante. usado junto com o
atributo period para controlar o intervalo de tempo para a variao dos dados. A
frmula que exprime a frequncia de modificao do tag demo period * delay.
enabled: Um atributo booleano usado para habilitar a simulao de dados do tag
demo enquanto o tag est ativo. Retorna verdadeiro (diferente de zero) se a
simulao de dados est habilitada ou falso (zero) se no est;
highLimit: Um nmero real configurando o limite alto do tag demo. usado
junto com o atributo lowLimit para definir o intervalo de variao do Tag;

308

Scripts

Manual do Usurio

increment: Um nmero real determinando o incremento a ser adicionado aos


dados conforme a frequncia de tempo especificada em period.
lowLimit: Um nmero real configurando o limite baixo do tag demo. usado
junto com o atributo highLimit para definir o intervalo de variao do Tag.
period: Um inteiro configurando o intervalo em milisegundos entre a gerao de
cada novo valor para o tag demo. usado junto com o atributo delay para controlar
o intervalo de tempo para a variao dos dados.
type: Um inteiro configurando o tipo de variao do tag demo. A variao
descrita por uma curva e pode ter os seguintes tipos:
Tipos de variao
NOME

VALOR
0

DESCRIO
Dados variando randomicamente

Randmico
1

Dados variando conforme uma funo seno

Dados alternam entre dois valores

Um grfico tipo dente de serra onde os


dados variam de um limite mais baixo para
um mais alto

Um grfico tipo dente de serra onde os


dados variam entre dois limites

Um grfico tipo dente de serra onde os


dados variam de um limite mais alto para
um mais baixo

Senoidal
Onda Quadrada
Rampa de Subida

Triangular
Rampa de Descida

Atributos de Tags Bloco


autoRead: Um atributo booleano usado para habilitar a leitura automtica do
PLC. Retorna verdadeiro (diferente de zero) se a leitura automtica est habilitada
ou falso (zero) se no est. Deve ser usado em conjunto com o atributo enableScan
devendo ambos estarem marcados ou desmarcados.
autoWrite: Um atributo booleano usado para habilitar a escrita automtica no
PLC. Retorna verdadeiro (diferente de zero) se a escrita automtica est habilitada
ou falso (zero) se no est.
b1: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro B1
conforme a documentao do Driver.
b2: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro B2
conforme a documentao do Driver.

Scripts

309

Manual do Usurio

b3: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro B3


conforme a documentao do Driver.
b4: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro B4
conforme a documentao do Driver.
driverName: um string contendo o nome do Driver do PLC conectado ao
sistema, usado como um identificador do Driver.
enableScan: Um atributo booleano usado para habilitar a leitura do PLC.
Retorna verdadeiro (diferente de zero) se o scan est habilitado ou falso (zero) se
no est. Deve ser usado em conjunto com o atributo autoRead devendo ambos
estarem marcados ou desmarcados.
nFailReads: Um inteiro sem sinal (somente leitura) que indica o nmero total de
leituras incorretas.
nFailWrites: Um inteiro sem sinal (somente leitura) que indica o nmero total
de escritas incorretas.
nOKReads: Um inteiro sem sinal (somente leitura) que indica o nmero total de
leituras feitas com sucesso.
nOKWrites: Um inteiro sem sinal (somente leitura) que indica o nmero total
de escritas feitas com sucesso.
realScan: um nmero real (somente leitura) indicando o tempo real de scan em
que o Elipse est conseguindo ler o Tag.
scanTime: Um inteiro com sinal (de -32768 a 32767) configurando o intervalo
de tempo entre duas leituras.
size: Um inteiro determinando o tamanho do bloco a ser monitorado pelo Elipse
SCADA.
status: Um string (somente leitura) contendo o estado atual de comunicao do
Tag: "Reading" (lendo), "Writing" (escrevendo), "Idle" (fazendo nada).
Atributos de Elementos de Tags Bloco
high1: Um nmero real configurando o limite superior do PLC. Ele usado
junto com o atributo low1 para definir um intervalo de variao.
high2: Um nmero real configurando o limite superior do sistema. Ele usado
junto com o atributo low2 para definir um intervalo de variao.
index: Um inteiro sem sinal (de 0 ao nmero total de elementos - 1)
determinando o ndice (iniciando em zero) do elemento no bloco.
low1: Um nmero real configurando o limite inferior do PLC. Ele usado junto
com o atributo high1 para definir um intervalo de variao.
310

Scripts

Manual do Usurio

low2: Um nmero real configurando o limite inferior do sistema. Ele usado


junto com o atributo high2 para definir um intervalo de variao.
scaling: Um atributo booleano usado para habilitar escalas de valores entre o
PLC e o sistema. Retorna verdadeiro (diferente de zero) se a escala est habilitada
ou falso (zero) se no est. Com este atributo habilitado voc pode configurar os
atributos low1, high1, low2 e high2.
Atributos de Tags Matriz
nColumns: Um inteiro sem sinal configurando o nmero de colunas do Tag
Matriz.
nRows: Um inteiro sem sinal configurando o nmero de linhas do Tag Matriz.
Atributos de Tags Crono
acum: Valor atual do cronmetro;
autoRestart: Reinicia automaticamente ao atingir valor de preset;
description: Descrio do tem.
enable: Habilita/Desabilita cronmetro.
name: O identificador usado para referncia do item.
resetAcum: Reseta acumulador quando habilitado (reiniciado)
saveAcum: Salva acumulador ao sair.
Atributos de Tags Expresso
expression: (string) Contm a prpria expresso do tag, permitindo que ela seja
modificada em tempo de execuo.
Atributos de Tags RAM
initialValue: (string) Contm um valor inicial para o tag e permite que este valor
seja modificado em tempo de execuo.

19.6.4. Atributos da Tela


accessLevel: Um inteiro sem sinal de 0 a 65535 (somente leitura) determinando
o nvel de acesso da Tela.
Scripts

311

Manual do Usurio

background: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a


16777215) definindo a cor de fundo da Tela. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255. Exemplo: tela1.background = RGB(255,0,0)
bitmapName: Um string contendo o nome de um bitmap usado como fundo em
uma Tela. Exemplo: screen.bitmapName = "Leaves.bmp"
border
: somente para telas janeladas e de tamanho fixo. Um atributo
booleano determinando que a uma borda de 1 pixel de largura seja mostrada em
volta da tela. Retorna verdadeiro (diferente de zero) se a borda mostrada (default)
ou falso (zero) se no ;
caption: Um atributo booleano determinando que a Barra de Ttulo seja
mostrada na Tela. Retorna verdadeiro (diferente de zero) se a Barra de Ttulo
mostrada ou falso se no ;
clipChildren: Um atributo booleano, habilitando o uso do clipping para o
redesenho dos objetos de tela relativo ao fundo da mesma. Retorna verdadeiro
(diferente de zero) se o clipping est habilitado ou falso se no est. Este atributo
deve ser habilitado somente se os objetos de tela no esto sobrepostos e no sero
movidos, caso contrrio poder no surtir o efeito desejado;
closeButton: Um atributo booleano determinando que o boto de close seja
mostrado na Tela. Retorna verdadeiro (diferente de zero) se o boto mostrado ou
falso (zero) se no ;
description: Um string contendo uma breve descrio sobre o Tag;
fullScreen: Um atributo booleano determinando o tipo da tela (cheia ou
janelada). Retorna verdadeiro (diferente de zero) se a tela cheia ou falso (zero) se
janelada;
height: Um inteiro sem sinal (de 0 a 65535) determinando a altura da Tela, em
pixels. usado juntamente com o atributo width para definir o tamanho da Tela.
Este atributo deve ser definido conforme a resoluo usada no Windows para que se
tenha uma janela sem scroll bar. Por exemplo, se voc est usando uma resoluo de
640x480 (VGA) o parmetro height pode variar de 0 a 480 pixels;
maximizeButton: Um atributo booleano determinando que o boto maximizar
seja mostrado na Tela. Retorna verdadeiro (diferente de zero) se o boto mostrado
ou falso (zero) se no ;
minimizeButton: Um atributo booleano determinando que o boto minimizar
seja mostrado na Tela. Retorna verdadeiro (diferente de zero) se o boto mostrado
ou falso (zero) se no ;
modal: somente para telas janeladas (fullScreen=0). Um atributo booleano
determinando que a tela seja, ou no, do tipo modal (ela deve ser fechada para que o
312

Scripts

Manual do Usurio

foco passe para outras telas abertas). Retorna verdadeiro (diferente de zero) se a Tela
modal ou falso (zero) se no ;
moveable
: Um atributo booleano determinando que a Tela possa ser movida
em tempo de execuo. Retorna verdadeiro (diferente de zero) se a Tela pode ser
movida ou falso (zero) se no pode;
name: Um string contendo o nome da Tela, usado como identificador da Tela;
popup: Somente para telas janeladas (fullScreen=0). Um atributo booleano
determinando que a tela seja, ou no, do tipo popup (ela automaticamente fechada
quando perde o foco). Retorna verdadeiro (diferente de zero) se a Tela popup ou
falso (zero) se no ;
resizeable
: Um atributo booleano determinando que a Tela possa ser
redimensionada em tempo de execuo. Retorna verdadeiro (diferente de zero) se a
Tela pode ser redimensionada ou falso (zero) se no pode;
scrollBars: Um atributo booleano determinando que o scroll bar seja mostrado
na Tela. Retorna verdadeiro (diferente de zero) se o scroll bar mostrado ou falso
(zero) se no ;
visible: Um atributo booleano determinando que a Tela seja visvel. Retorna
verdadeiro (diferente de zero) se a Tela visvel ou falso (zero) se no ;
width: Um inteiro sem sinal (de 0 a 65535) determinando a largura da Tela, em
pixels. usado juntamente com o atributo height para definir o tamanho da Tela.
Este atributo deve ser definido conforme a resoluo usada no Windows para que se
tenha uma janela sem scroll bar. Por exemplo, se voc est usando uma resoluo de
640x480 (VGA) o parmetro width pode variar de 0 a 640 pixels;
x
: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X
para o canto superior esquerdo da Tela, em pixels. usado juntamente com o
atributo Y para definir a posio do canto superior esquerdo da Tela. Este atributo
deve ser definido conforme a resoluo usada no Windows para que se tenha uma
janela sem scroll bar. Por exemplo, se voc est usando uma resoluo de 640x480
(VGA) a sua coordenada X pode variar de 0 a 640 pixels;
xOrigin: Um inteiro sem sinal (de 0 a 65535) determinando a coordenada X para
a origem da Tela, em pixels. usado juntamente com o atributo yOrigin para definir
o tamanho da Tela. Este atributo deve ser definido conforme a resoluo usada no
Windows para que se tenha uma janela sem scroll bar. Por exemplo, se voc est
usando uma resoluo de 640x480 (VGA) o parmetro xOrigin pode variar de 0 a
640 pixels;
y
: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada Y
para o canto superior esquerdo da Tela, em pixels. usado juntamente com o
atributo X para definir a posio do canto superior esquerdo da Tela. Este atributo
deve ser definido conforme a resoluo usada no Windows para que se tenha uma
Scripts

313

Manual do Usurio

janela sem scroll bar. Por exemplo, se voc est usando uma resoluo de 640x480
(VGA) a sua coordenada Y pode variar de 0 a 480 pixels;
yOrigin: Um inteiro sem sinal (de 0 a 65535) determinando a coordenada Y para
a origem da Tela, em pixels. usado juntamente com o atributo xOrigin para definir
o tamanho da Tela. Este atributo deve ser definido conforme a resoluo usada no
Windows para que se tenha uma janela sem scroll bar. Por exemplo, se voc est
usando uma resoluo de 640x480 (VGA) o parmetro yOrigin pode variar de 0 a
480 pixels;

19.6.5. Atributos dos Objetos de Tela


Os objetos de tela possuem atributos em comum, que aparecem em todos os objetos
e atributos especficos, associados as suas caractersticas nicas. Listamos todos
estes atributos a seguir.
Atributos Comuns
accessLevel: (inteiro) Permite atribuir um nvel de segurana ao objeto. Se for 0
(zero), todos os usurios tem livre acesso ao objeto, podendo clicar e entrar dados
neste. Se for 1 (um) ou mais, apenas os usurios com o nvel de acesso menor ou
igual podem usar o objeto.
enabled: Valor booleano que, quando verdadeiro (TRUE), habilita o acesso ao
objeto via mouse ou teclado. Este atributo no afeta objetos que no provem acesso
via teclado ou mouse (como o Display ou o Gauge).
height: Inteiro sem sinal (de 0 a 65535) que Determina a altura do objeto, em
pixels. usado juntamente com o atributo width para definir o tamanho do objeto.
showTip: Valor booleano que habilita o objeto a mostrar uma pequena dica (tip)
quando o mouse est sobre ele.
visible: Valor booleano que indica se o objeto est visvel ao usurio (TRUE) ou
no (FALSE).
width: Inteiro sem sinal (de 0 a 65535) Determinando a largura do objeto, em
pixels. usado juntamente com o atributo height para definir o tamanho do objeto.
x, y: Dois inteiros com sinal (de -32768 a 32767) Determinando a coordenada X
e Y para o canto superior esquerdo do objeto, em pixels, a partir do canto superior
esquerdo da Tela em que est o objeto.
Atributos do Alarme
ackALMColor: Nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor do texto para uma mensagem de Alarme reconhecida.
314

Scripts

Manual do Usurio

Este valor tambm pode ser especificado pela funo RGB (r, g, b) onde cada
componente RGB pode variar de 0 a 255. Exemplo: Alarm.ackAlmColor =
RGB(255,0,255)

alarmState: (booleano) Determina que a coluna de status dos alarmes seja


mostrada no objeto. Retorna verdadeiro (diferente de zero) se a coluna de status
mostrada ou falso (zero) se no .
alarmType: (booleano) Determina se a coluna de tipo de Alarme ser mostrada
no objeto: verdadeiro (diferente de zero) mostrada; falso (zero) no .
comment: (booleano) Determina que a coluna de comentrios seja mostrada no
objeto Alarme. Retorna verdadeiro (diferente de zero) se a coluna de comentrios
mostrada ou falso (zero) se no .
commentLength: Inteiro sem sinal (de 1 a 199) Determinando o comprimento
do comentrio que ser mostrado. Somente disponvel se o atributo comment est
habilitado;
date: (booleano) Determina que a coluna de data seja mostrada no objeto
Alarme. Retorna verdadeiro (diferente de zero) se a coluna de data mostrada ou
falso (zero) se no .
description: String contendo uma breve descrio sobre o Alarme.
displayTitle: (booleano) Determina que a barra de ttulo do Alarme seja
mostrada. Retorna verdadeiro (diferente de zero) se a barra de ttulo mostrada ou
falso (zero) caso contrrio.
event: (booleano) Determina que a coluna de eventos seja mostrada no objeto
Alarme. Retorna verdadeiro (diferente de zero) se a coluna de eventos mostrada ou
falso (zero) se no .
finalPriority: Inteiro sem sinal (de 1 a 199) determinando a maior prioridade de
mensagens de alarme a ser monitorada pelo objeto. Somente mensagens de Alarme
com prioridade inferior a finalPriority sero mostrados no objeto.
initialPriority: Inteiro sem sinal (de 1 a 199) determinando a menor prioridade
de mensagens de alarme a ser monitorada pelo objeto. Somente mensagens de
Alarme com prioridade maior que initialPriority sero mostrados no objeto.
largeButtons: (booleano) Habilita botes grandes na toolbar do objeto Alarmes.
Retorna verdadeiro (diferente de zero) se os botes grandes esto habilitados ou
falso (zero) se no esto.
limit: (booleano) Determina que a coluna de limites dos alarmes seja mostrada
no objeto. Retorna verdadeiro (diferente de zero) se a coluna de limites mostrada
ou falso (zero) se no .
limitLength: Inteiro sem sinal (de 1 a 10) determinando o comprimento dos
limites dos Alarmes que sero mostrados. Somente disponvel se o atributo limit est
habilitado;
Scripts

315

Manual do Usurio

limitPrec: Inteiro sem sinal (de 0 a limitLength - 2) determinando o nmero de


dgitos decimais para os limites que sero mostrados no Alarme.
name: String contendo o nome do Alarme, usado como identificador do Alarme.
priority: (booleano) Determina que a coluna de prioridades de alarmes seja
mostrada no objeto. Retorna verdadeiro (diferente de zero) se a coluna de
prioridades mostrada ou falso (zero) se no .
rtnColor: Nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da mensagem de retorno do Alarme. Este valor tambm
pode ser especificado pela funo RGB (r, g, b) onde cada componente RGB pode
variar de 0 a 255.
Exemplo:
Alarm.rtnColor = RGB(255,255,0)

tagName: (booleano) Determina que a coluna de nomes dos Tags seja mostrada
no objeto. Retorna verdadeiro (diferente de zero) se a coluna de nomes dos Tags
mostrada ou falso (zero) se no .
tagNameLength: Inteiro sem sinal (de 1 a 32) determinando o comprimento dos
nomes dos Tags que sero mostrados. Somente disponvel se o atributo tagName
est habilitado;
time: (booleano) Determina que a coluna de hora seja mostrada no objeto
Alarme. Retorna verdadeiro (diferente de zero) se a coluna de hora mostrada ou
falso (zero) se no .
titleBarColor: Nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da linha de ttulo do Alarme. Este valor tambm pode ser
especificado pela funo RGB (r, g, b) onde cada componente RGB pode variar de 0
a 255. Exemplo: Alarm.titleBarColor = RGB(255,255,0)
titleTextColor: Nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor de texto do ttulo do Alarme. Este valor tambm pode ser
especificado pela funo RGB (r, g, b) onde cada componente RGB pode variar de 0
a 255. Exemplo: Alarm.titleTextColor = RGB(255,255,0)
toolbar: (booleano) Determina que a barra de ferramentas do objeto Alarme seja
mostrado. Retorna verdadeiro (diferente de zero) se a barra de ferramentas
mostrado ou falso (zero) se no .
toolbarColor: Nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da barra de ferramentas do Alarme. Este valor tambm
pode ser especificado pela funo RGB (r, g, b) onde cada componente RGB pode
variar de 0 a 255. Exemplo: Alarm.toolbarColor = RGB(255,255,0)
type:Inteiro sem sinal (de 0 a 1) definindo o tipo do Alarme, que pode ser
resumido (0) ou histrico (1). Esta propriedade somente de leitura.
316

Scripts

Manual do Usurio

unAckALMColor: Nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a


16777215) definindo a cor do texto para uma mensagem de Alarme no
reconhecida. Este valor tambm pode ser especificado pela funo RGB (r, g, b)
onde cada componente RGB pode variar de 0 a 255.
userLength: (inteiro de 1 a 20) Indica o tamanho da coluna Usurio (user), em
caracteres.
userName: (booleano) Se verdadeiro, indica que a coluna Usurio (user) deve
ser mostrada.
value: (booleano) Determina que a coluna de valores dos Tags seja mostrada no
objeto Alarme. Retorna verdadeiro (diferente de zero) se a coluna de valores dos
Tags mostrada ou falso (zero) se no .
valueLength: Inteiro sem sinal (de 1 a 10) determinando o comprimento dos
valores dos Tags que sero mostrados. Somente disponvel se o atributo comment
est habilitado;
valuePrec: Inteiro sem sinal (de 0 a valueLength - 2) determinando o nmero de
dgitos decimais para os valores que sero mostrados no Alarme.
windowColor: Nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor de fundo do Alarme. Este valor tambm pode ser
especificado pela funo RGB (r, g, b) onde cada componente RGB pode variar de 0
a 255.
Atributos da Animao
backgroundColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal
(de 0 a 16777215) definindo a cor de fundo da Animao. Este valor tambm pode
ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar
de 0 a 255;
blinkTime: Um inteiro sem sinal (de 0 a 100) determinando o tempo em ms de
pisca-pisca da Animao, ou seja, o tempo em que a zona default ir piscar
alternando com a zona atual.
border: Um atributo booleano determinando que a borda da Animao seja
mostrada no objeto. Retorna verdadeiro (diferente de zero) se a borda mostrada ou
falso (zero) se no ;
description: um String contendo uma breve descrio sobre a Animao.
Exemplo:
Animation.description = "Animation Object"

name: Um string contendo o nome da Animao, usado como identificador da


Animao.
Scripts

317

Manual do Usurio

transparent: Um atributo booleano determinando que o fundo da Animao


seja transparente. Retorna verdadeiro (diferente de zero) se a o fundo transparente
ou falso (zero) se no ;
Atributos da Barra
backgroundColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de
0 a 16777215) definindo a cor de fundo do Grfico de Barras. Este valor tambm
pode ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode
variar de 0 a 255;
barColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da Barra no grfico. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
bipolar: Um atributo booleano determinando que o Grfico de Barras seja
bipolar, desta forma as barras possuem dois lados divididos por um centro. As barras
crescem a partir do centro em direo aos limites do grfico. Retorna verdadeiro
(diferente de zero) se o Grfico de Barras bipolar ou falso (zero) se no ;
bottomRange: Um nmero real configurando o valor mnimo para o Grfico de
Barras. usado junto com o atributo topRange para definir um intervalo de valores
para a Barra;
bottomRuler: Um atributo booleano determinando que uma rgua de valores
seja mostrada na parte inferior do Grfico de Barras. Retorna verdadeiro (diferente
de zero) se a rgua inferior mostrada ou falso (zero) se no ;
description: Um string contendo uma breve descrio sobre o Grfico de
Barras;
enable3D: Um atributo booleano usado para habilitar um efeito 3D na Barra.
Retorna verdadeiro (diferente de zero) se o efeito 3D est habilitado ou falso (zero)
se no est.
enableRuler: Um atributo booleano determinando que uma rgua de valores
seja mostrada no Grfico de Barras. Retorna verdadeiro (diferente de zero) se a
rgua mostrada ou falso (zero) se no ;
gridColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da grade e divises do Grfico de Barras. Este valor
tambm pode ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b)
pode variar de 0 a 255;
label
: Um string contendo a unidade de medida a ser mostrada na rgua.
Exemplo: Barra1.label = "MHz"

318

Scripts

Manual do Usurio

labelEnable: Um atributo booleano determinando que o label da rgua seja


mostrado no Grfico de Barras. Retorna verdadeiro (diferente de zero) se o label da
rgua mostrado ou falso (zero) se no ;
leftRuler: Um atributo booleano determinando que uma rgua de valores seja
mostrada esquerda do Grfico de Barras. Retorna verdadeiro (diferente de zero) se
a rgua esquerda mostrada ou falso (zero) se no ;
middle: Um nmero real determinando o centro das barras bipolares. Somente
disponvel se o atributo middle est habilitado;
name: Um string contendo o nome do Grfico de Barras, usado como
identificador da Barra;
orientation: Um inteiro sem sinal determinando a orientao do Grfico de
Barras, conforme a tabela a seguir:
GAUGE

ORIENTAO
Vertical, de cima para baixo

Vertical, de baixo para cima


Horizontal, da esquerda para direita
Horizontal, da direita para esquerda

rightRuler: Um atributo booleano determinando que uma rgua de valores seja


mostrada direita do Grfico de Barras. Retorna verdadeiro (diferente de zero) se a
rgua direita mostrada ou falso (zero) se no ;
rulerColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da rgua do Grfico de Barras. Este valor tambm pode
ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar
de 0 a 255;
rulerDivisions: Um inteiro sem sinal (de 0 a 100) determinando o nmero de
divises na rgua do Grfico de Barras. Somente disponvel se o atributo
enableRuler est habilitado;
spacing: Um inteiro sem sinal (de 0 a 10) determinando o espao (em pixels)
entre as barras do grfico;
textColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor do texto da rgua. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
Scripts

319

Manual do Usurio

thickness: Um inteiro sem sinal configurando a largura do efeito 3D da barra


(em pixels);
topRange: Um nmero real configurando o valor mximo para o Grfico de
Barras. usado junto com o atributo bottomRange para definir um intervalo de
valores para a Barra;
topRuler: Um atributo booleano determinando que uma rgua de valores seja
mostrada na parte superior do Grfico de Barras. Retorna verdadeiro (diferente de
zero) se a rgua superior mostrada ou falso (zero) se no ;
Atributos do Browser
ascending: Um atributo booleano determinando a ordem dos registros a serem
mostrados no Browser. Retorna verdadeiro (diferente de zero) se a ordem
ascendente ou falso (zero) se descendente. O default ascendente;
backColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da rea fora da tabela do Browser. Este valor tambm
pode ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode
variar de 0 a 255;
completeRows: Um inteiro sem sinal (de 0 a 65535) determinando o nmero das
linhas completamente visveis, no incluindo a ltima linha se ela estiver
parcialmente visvel.
curSel: Um inteiro sem sinal (de 0 a 65535) determinando o nmero do registro
selecionado (somente leitura). Retorna -1 se nenhuma linha est selecionada;
description: Um string contendo uma breve descrio sobre o Browser;
firstRec: Um inteiro sem sinal (de 0 a 65535) determinando o nmero do
primeiro registro selecionado para ser visto (somente leitura).
gridColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor das linhas da grade do Browser. Este valor tambm pode
ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar
de 0 a 255;
lastRec: Um inteiro sem sinal (de 0 a 65535) determinando o nmero do ltimo
registro selecionado para ser visto (somente leitura).
name: Um string contendo o nome do Browser, usado como identificador do
Browser;
rowColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor de fundo das linhas no selecionadas do Browser. Este
valor tambm pode ser especificado pela funo RGB(r,g,b) onde cada componente
(r,g,b) pode variar de 0 a 255;
320

Scripts

Manual do Usurio

rowTextColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a


16777215) definindo a cor do texto das linhas no selecionadas do Browser. Este
valor tambm pode ser especificado pela funo RGB(r,g,b) onde cada componente
(r,g,b) pode variar de 0 a 255;
selColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor de fundo da linha corrente, selecionada no Browser. Este
valor tambm pode ser especificado pela funo RGB(r,g,b) onde cada componente
(r,g,b) pode variar de 0 a 255;
selTextColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor do texto da linha corrente, selecionada no Browser. Este
valor tambm pode ser especificado pela funo RGB(r,g,b) onde cada componente
(r,g,b) pode variar de 0 a 255;
titleColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da linha de ttulo do Browser. Este valor tambm pode
ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar
de 0 a 255;
titleTextColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor de texto do ttulo do Browser. Este valor tambm pode
ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar
de 0 a 255;
topRow: Um inteiro sem sinal (de 0 a 65535) determinando o nmero do
registro mostrado na primeira linha visvel (somente leitura).
visibleRows: Um Inteiro sem sinal (de 0 a 65535) determinando o nmero de
linhas visveis, incluindo a ltima mesmo que esteja aparecendo s parcialmente
(somente leitura).
Atributos do Boto
backgroundColor0: Um nmero hexadecimal (de 0h a 1000000h) ou decimal
(de 0 a 16777215) definindo a cor do Boto quando est em seu estado normal (no
pressionado). Este valor tambm pode ser especificado pela funo RGB(r,g,b) onde
cada componente (r,g,b) pode variar de 0 a 255;
backgroundColor1: Um nmero hexadecimal (de 0h a 1000000h) ou decimal
(de 0 a 16777215) definindo a cor do Boto quando est pressionado. Este valor
tambm pode ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b)
pode variar de 0 a 255;
bitmap0: Um string contendo o nome do bitmap a ser mostrado como fundo de
um Boto quando est em seu estado normal (no pressionado);
bitmap1: Um string contendo o nome do bitmap a ser mostrado como fundo de
um Boto quando est pressionado;
Scripts

321

Manual do Usurio

buttonAction: Um inteiro sem sinal (de 0 a 2) determinando o tipo de ao do


boto, que pode ser Momentneo (Momentary) (0), Liga-desliga (Toggle) (1) ou Jog
(2);
buttonType: Um inteiro sem sinal (de 0 a 6) determinando o tipo do boto de 7
tipos disponveis:
buttonType = 0
buttonType = 1
buttonType = 2
buttonType = 3
buttonType = 4
buttonType = 5
buttonType = 6

description: Um string contendo uma breve descrio sobre o Boto;


goToScreen: Somente para uso do Elipse SCADA. No so permitidas
modificaes por parte de usurios.
name: Um string contendo o nome do Boto, usado como identificador do
Boto;
text0: Um string contendo o texto que ser mostrado no Boto quando ele est
em estado normal (no pressionado);
text1: Um string contendo o texto que ser mostrado no Boto quando ele est
pressionado;
textColor0: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor do texto do Boto quando est em seu estado normal (no
pressionado). Este valor tambm pode ser especificado pela funo RGB(r,g,b) onde
cada componente (r,g,b) pode variar de 0 a 255;
textColor1: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor do texto do Boto quando est pressionado. Este valor
322

Scripts

Manual do Usurio

tambm pode ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b)
pode variar de 0 a 255;
value0: Um inteiro sem sinal (de 0 a 65535) determinando o valor do Boto
quando em estado normal (no pressionado);
value1: Um inteiro sem sinal (de 0 a 65535) determinando o valor do Boto
quando pressionado;
visible: Um atributo booleano determinando que o Boto seja visvel. Retorna
verdadeiro (diferente de zero) se o Boto visvel ou falso (zero) se no ;
width: Um inteiro sem sinal (de 0 a 65535) determinando a largura do Boto,
em pixels. usado juntamente com o atributo height para definir o tamanho do
Boto;
x: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X para
o canto superior esquerdo do Boto, em pixels. usado juntamente com o atributo Y
para definir a posio do canto superior esquerdo do Boto a partir da origem da
Tela (0,0);
y: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada Y para
o canto superior esquerdo do Boto, em pixels. usado juntamente com o atributo X
para definir a posio do canto superior esquerdo do Boto a partir da origem da
Tela (0,0);
Atributos do Display
backgroundColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal
(de 0 a 16777215) definindo a cor de fundo do Display. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
description: Um string contendo uma breve descrio sobre o Display;
enabled: Um atributo booleano usado para habilitar o acesso do teclado e mouse
ao objeto Display. Retorna verdadeiro (diferente de zero) se o acesso est habilitado
ou falso (zero) se no est;
height: Um inteiro sem sinal (de 0 a 65535) determinando a altura do Display,
em pixels. usado juntamente com o atributo width para definir o tamanho do
Display;
horizontalAlign: Um inteiro sem sinal (de 0 a 2) determinando o alinhamento
horizontal para os dados que sero mostrados no Display, conforme a tabela abaixo:
VALOR

Scripts

ALINHAMENTO
Esquerda

Centro
323

Manual do Usurio
2

Direita

multiLine: Um atributo booleano usado para habilitar mltiplas linhas no


Display. Retorna verdadeiro (diferente de zero) se o uso de mltiplas linhas est
habilitado ou falso (zero) se no est;
name: Um string contendo o nome do Display, usado como identificador do
Display;
precision: Um inteiro sem sinal (de 0 a 254) determinando o nmero de dgitos
decimais a serem mostrados no Display. Nunca poder ser maior que o atributo size.
prefix: Um string contendo um prefixo a ser mostrado antes do valor do Tag
associado ao Display;
size: Um inteiro sem sinal (de 0 a 255) determinando o tamanho dos dados a
serem mostrados no Display.
showTip: Um atributo booleano habilitando o objeto a mostrar uma Tip (dica)
quando o mouse est sobre ele. Retorna verdadeiro (diferente de zero) se a Tip est
habilitada ou falso (zero) se no est;
suffix: Um string contendo um sufixo a ser mostrado depois do valor do Tag
associado ao Display;
textColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor do texto do Display. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
type: Um inteiro sem sinal (de 1 a 2) determinando o tipo de dados a ser
mostrado no Display, que pode ser um string (1) ou um nmero (2).
verticalAlign: Um inteiro sem sinal (de 0 a 2) determinando o alinhamento
vertical para os dados que sero mostrados no Display, conforme a tabela abaixo:

VALOR

ALINHAMENTO
Topo

Centro

Abaixo

visible: Um atributo booleano determinando que o Display seja visvel. Retorna


verdadeiro (diferente de zero) se o Display visvel ou falso (zero) se no ;
width: Um inteiro sem sinal (de 0 a 65535) determinando a largura do Display,
em pixels. usado juntamente com o atributo height para definir o tamanho do
Display;
324

Scripts

Manual do Usurio

x: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X para


o canto superior esquerdo do Display, em pixels. usado juntamente com o atributo
Y para definir a posio do canto superior esquerdo do Display a partir da origem da
Tela (0,0);
y: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada Y para
o canto superior esquerdo do Display, em pixels. usado juntamente com o atributo
X para definir a posio do canto superior esquerdo do Display a partir da origem da
Tela (0,0);
Atributos do Gauge
backgroundColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal
(de 0 a 16777215) definindo a cor de fundo do Gauge. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
bulletsVisible: Um atributo booleano determinando que as marcas sejam
mostradas em forma de bullets. Retorna verdadeiro (diferente de zero) se os bullets
so mostrados ou falso (zero) se no so;
decimalPlaces: Um inteiro sem sinal (de 0 a 65535) determinando o nmero de
casas decimais a serem utilizadas na formatao dos valores do Gauge.
description: Um string contendo uma breve descrio sobre o Gauge;
enabled: Um atributo booleano usado para habilitar o acesso do teclado e mouse
ao objeto Gauge. Retorna verdadeiro (diferente de zero) se o acesso est habilitado
ou falso (zero) se no est;
frameColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da moldura do Gauge. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
frameVisible: Um atributo booleano determinando que um frame seja mostrado
ao longo do percurso da agulha do Gauge. Retorna verdadeiro (diferente de zero) se
o frame mostrado ou falso (zero) se no ;
height: Um inteiro sem sinal (de 0 a 65535) determinando a altura do Gauge, em
pixels. usado juntamente com o atributo width para definir o tamanho do Gauge;
hiColorLegend: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0
a 16777215) definindo a cor da legenda para o intervalo de valores especificados
como High. Este valor tambm pode ser especificado pela funo RGB(r,g,b) onde
cada componente (r,g,b) pode variar de 0 a 255;
hiDiv: Um nmero real configurando o valor do limite inferior do intervalo
High;
Scripts

325

Manual do Usurio

hiHiColorLegend: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de


0 a 16777215) definindo a cor da legenda para o intervalo de valores especificados
como High-High. Este valor tambm pode ser especificado pela funo RGB(r,g,b)
onde cada componente (r,g,b) pode variar de 0 a 255;
hiHiDiv: Um nmero real configurando o valor do limite inferior do intervalo
High-High;
hiLimit: Um nmero real no intervalo [0,1], configurando posio da borda
superior da legenda. usado junto com o atributo lowLimit para definir a espessura
da legenda;
isHiHiLimitVisible: Um atributo booleano determinando que o intervalo de
valores HighHigh do Gauge seja mostrado na legenda. Retorna verdadeiro (diferente
de zero) se o intervalo HighHigh mostrado ou falso (zero) se no ;
isHiLimitVisible: Um atributo booleano determinando que o intervalo de
valores High do Gauge seja mostrado na legenda. Retorna verdadeiro (diferente de
zero) se o intervalo High mostrado ou falso (zero) se no ;
isLowLimitVisible: Um atributo booleano determinando que o intervalo de
valores Low do Gauge seja mostrado na legenda. Retorna verdadeiro (diferente de
zero) se o intervalo Low mostrado ou falso (zero) se no ;
isLowLowLimitVisible: Um atributo booleano determinando que o intervalo de
valores LowLow do Gauge seja mostrado na legenda. Retorna verdadeiro (diferente
de zero) se o intervalo LowLow mostrado ou falso (zero) se no ;
legendVisible: Um atributo booleano determinando que uma legenda seja
mostrada no Gauge. Retorna verdadeiro (diferente de zero) se as marcas so
mostradas ou falso (zero) se no so;
limitVisible: Um atributo booleano determinando que os limites do Gauge
sejam mostrados. Retorna verdadeiro (diferente de zero) se os limites so mostrados
ou falso (zero) se no so;
lowColorLegend: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de
0 a 16777215) definindo a cor da legenda para o intervalo de valores especificados
como Low. Este valor tambm pode ser especificado pela funo RGB(r,g,b) onde
cada componente (r,g,b) pode variar de 0 a 255;
lowDiv: Um nmero real configurando o valor do limite superior do intervalo
Low;
lowLimit: Um nmero real no intervalo [0,1], configurando a posio da borda
inferior da legenda do Gauge. usado junto com o atributo hiLimit para definir a
espessura da legenda;
lowLowColorLegend: Um nmero hexadecimal (de 0h a 1000000h) ou decimal
(de 0 a 16777215) definindo a cor da legenda para o intervalo de valores
326

Scripts

Manual do Usurio

especificados como Low-Low. Este valor tambm pode ser especificado pela funo
RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0 a 255;
lowLowDiv: Um nmero real configurando o valor do limite superior do
intervalo Low-Low;
maximum: Um nmero real configurando o valor mximo para o Gauge.
usado junto com o atributo minimum para definir um intervalo de valores para o
Gauge;
minimum: Um nmero real configurando o valor mnimo para o Gauge.
usado junto com o atributo maximum para definir um intervalo de valores para o
Gauge;
name: Um string contendo o nome do Gauge, usado como identificador do
Gauge;
needleColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da agulha do Gauge. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
needleThickness: Um inteiro sem sinal (de 1 a 2) determinando a espessura da
agulha do Gauge, que pode ser ponteiro fino (1) ou grosso (2);
normalColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da legenda para o intervalo de valores especificados
como normais. Este valor tambm pode ser especificado pela funo RGB(r,g,b)
onde cada componente (r,g,b) pode variar de 0 a 255;
orientation: Um Inteiro sem sinal (de 0 a 3) determinando a orientao do
grfico do Gauge, conforme segue:
Gauge1.orientation = 0
Gauge1.orientation = 1
Gauge1.orientation = 2
Gauge1.orientation = 3

points: Um inteiro sem sinal (de 0 a 65535) determinando o nmero de pontos


na rgua do Gauge. Alguns pontos no podem ser mostrados se forem definidos
muitos pontos para um Gauge pequeno.

Scripts

327

Manual do Usurio

showTip: Um atributo booleano habilitando o objeto a mostrar uma Tip (dica)


quando o mouse est sobre ele. Retorna verdadeiro (diferente de zero) se a Tip est
habilitada ou falso (zero) se no est;
startAngle: Um nmero real configurando o ngulo inicial da agulha do Gauge;
subTicksColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0
a 16777215) definindo a cor das sub-marcas do Gauge. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
subTicksVisible: Um atributo booleano determinando que sub-marcas (ticks)
sejam mostradas entre as marcas principais. Retorna verdadeiro (diferente de zero)
se as sub-marcas so mostradas ou falso (zero) se no so;
textColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor do texto que ser mostrado no Gauge. Este valor tambm
pode ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode
variar de 0 a 255;
thickTicks: Um atributo booleano determinando que as marcas principais do
Gauge sejam grossas. Retorna verdadeiro (diferente de zero) se as marcas so
grossas ou falso (zero) se no so;
tickColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor das marcas principais do Gauge. Este valor tambm pode
ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar
de 0 a 255;
ticksValues: Um atributo booleano determinando que os valores das marcas
(ticks) sejam mostrados no Gauge. Retorna verdadeiro (diferente de zero) se os
valores so mostrados ou falso (zero) se no so;
ticksVisible: Um atributo booleano determinando que as marcas principais
(ticks) sejam mostradas no Gauge. Retorna verdadeiro (diferente de zero) se as
marcas so mostradas ou falso (zero) se no so;
totalNumberOfSubticks: Um inteiro sem sinal (de 0 a 9) determinando o
nmero total de sub-marcas a serem mostradas entre as marcas principais.
valueVisible: Um atributo booleano determinando que o valor do Gauge seja
mostrado. Retorna verdadeiro (diferente de zero) se o valor do Gauge mostrado ou
falso (zero) se no ;
visible: Um atributo booleano determinando que o Gauge seja visvel. Retorna
verdadeiro (diferente de zero) se o Gauge visvel ou falso (zero) se no ;
width: Um inteiro sem sinal (de 0 a 65535) determinando a largura do Gauge,
em pixels. usado juntamente com o atributo height para definir o tamanho do
Gauge;
328

Scripts

Manual do Usurio

x: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X para


o canto superior esquerdo do Gauge, em pixels. usado juntamente com o atributo
Y para definir a posio do canto superior esquerdo do Gauge a partir da origem da
Tela (0,0);
y: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada Y para
o canto superior esquerdo do Gauge, em pixels. usado juntamente com o atributo
X para definir a posio do canto superior esquerdo do Gauge a partir da origem da
Tela (0,0);
Atributos do Setpoint
autoSend: (booleano) Quando em 1 (um), automaticamente manda os dados
entrados no controle para o tag associado quando este perder o foco.
backgroundColor: Nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor de fundo do SetPoint. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255.
checkMaximum: (booleano) Usado para habilitar a verificao do valor do
SetPoint com o valor mximo especificado para o mesmo. Retorna verdadeiro
(diferente de zero) se a verificao est habilitada ou falso (zero) se no est.
checkMinimum: (booleano) Usado para habilitar a verificao do valor do
SetPoint com o valor mnimo especificado para o mesmo. Retorna verdadeiro
(diferente de zero) se a verificao est habilitada ou falso (zero) se no est.
dateFormat: (string) Define um formato para mostrar e entrar dados de
data/hora em um setpoint. Exemplo: "dd/mm/yy hh:mm:ss" ser mostrado como
"02/07/97 18:35:22".

Scripts

329

Manual do Usurio
Formatos Data/Hora para o atributo dateFormat
FORMATO
w

SIGNIFICADO
Dia da semana (Dom Sab)

Dia da semana (DOM SAB)

ww

Dia da semana (Domingo Sbado)

WW

Dia da semana (DOMINGO SBADO)

Dia (1 31)

dd

Dia (01 31)

Ms (1 12)

mm

Ms (01 12)

mmm

Ms (Jan Dez)

MMM

Ms (JAN DEZ)

mmmm

Ms (Janeiro Dezembro)

MMMM

Ms (JANEIRO DEZEMBRO)

mmmmm

Ms (j d)

MMMMM

Ms (J D)

Yy

Ano (00 99)

YY

Ano (1970 9999)

Hora (0 23)

Hh

Hora (00 23)

Minuto (0 59) (deve estar acompanhando hs ou seguido de seg.)

mm

Minuto (00 59) (deve estar acompanhando hs ou seguido de seg.)

Segundo (0 59)

Ss

Segundo (00 59)

AM/PM

Hora no formato 12 horas, mostra AM (manh) e PM (tarde).

Am/pm

Hora no formato 12 horas, mostra am e pm.

A/P

Hora no formato 12 horas, mostra A e P.

a/p

Hora no formato 12 horas, mostra a e p.

Dcimos de segundo (deve ser precedido de segundos)

00

Centsimos de segundo (deve ser precedido de segundos)

000

Milsimos de segundo (deve ser precedido de segundos)

Nova linha (CR + LF)

description: (string) Contm uma breve descrio sobre o SetPoint.


enabled: (booleano) Usado para habilitar o acesso do teclado e mouse ao objeto
Setpoint. Retorna verdadeiro (diferente de zero) se o acesso est habilitado ou falso
(zero) se no est.
330

Scripts

Manual do Usurio

height: um inteiro sem sinal (de 0 a 65535) determinando a altura do SetPoint,


em pixels. usado juntamente com o atributo width para definir o tamanho do
SetPoint.
horizontalAlign: (inteiro sem sinal de 0 a 2) Determina o alinhamento
horizontal para os dados que sero mostrados no SetPoint, a saber: 0, esquerda; 1,
centro ou 2, direita.
maximum: Um nmero real configurando o valor mximo para o SetPoint.
usado junto com o atributo minimum para definir um intervalo de valores para o
SetPoint;
minimum: Um nmero real configurando o valor mnimo para o SetPoint.
usado junto com o atributo maximum para definir um intervalo de valores para o
SetPoint;
multiLine
: Um atributo booleano usado para habilitar mltiplas linhas no
SetPoint. Retorna verdadeiro (diferente de zero) se o uso de mltiplas linhas est
habilitado ou falso (zero) se no est;
name: (string) Contm o nome do SetPoint, usado como identificador do
SetPoint.
precision: Um inteiro sem sinal (de 0 a 254) determinando o nmero de dgitos
decimais a serem mostrados no SetPoint. Nunca poder ser maior que o atributo size.
prefix: (string) Contm um prefixo a ser mostrado antes do valor do Tag
associado ao SetPoint. Exemplo: SetPoint.prefix = "Peso"
refresh: Um atributo booleano determinando que o valor do SetPoint seja
atualizado automaticamente se alguma modificao ocorrer no Tag associado.
Retorna verdadeiro (diferente de zero) se a atualizao automtica est habilitada ou
falso (zero) se no est.
selectAll: Um atributo booleano determinando que todos os caracteres do
SetPoint sejam selecionados quando o objeto receber o foco. Retorna verdadeiro
(diferente de zero) se a seleo de todos os caracteres est habilitada ou falso (zero)
se no est.
showTip: Um atributo booleano habilitando o objeto a mostrar uma Tip (dica)
quando o mouse est sobre ele. Retorna verdadeiro (diferente de zero) se a Tip est
habilitada ou falso (zero) se no est.
size: Um inteiro sem sinal (de 0 a 255) determinando o tamanho dos dados a
serem mostrados no SetPoint;
suffix: (string) Contm um sufixo a ser mostrado depois do valor do Tag
associado ao SetPoint. Exemplo: SetPoint.suffix = "Kg"
textColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor do texto que ser mostrado no SetPoint. Este valor
Scripts

331

Manual do Usurio

tambm pode ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b)
pode variar de 0 a 255;
type: Um inteiro sem sinal (de 1 a 2) determinando o tipo de dados a ser
mostrado no SetPoint, que pode ser um string (1) ou Um nmero (2).
verticalAlign: (inteiro sem sinal de 0 a 2) Determina o alinhamento vertical para
os dados que sero mostrados no SetPoint, a saber: 0, pelo topo; 1, centro e 2, por
baixo.
visible: Um atributo booleano determinando que o SetPoint seja visvel. Retorna
verdadeiro (diferente de zero) se o SetPoint visvel ou falso (zero) se no ;
width: Um inteiro sem sinal (de 0 a 65535) determinando a largura do SetPoint,
em pixels. usado juntamente com o atributo height para definir o tamanho do
SetPoint;
x: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X para
o canto superior esquerdo do SetPoint, em pixels. usado juntamente com o atributo
Y para definir a posio do canto superior esquerdo do SetPoint a partir da origem da
Tela (0,0);
y: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada Y para
o canto superior esquerdo do SetPoint, em pixels. usado juntamente com o atributo
X para definir a posio do canto superior esquerdo do SetPoint a partir da origem da
Tela (0,0);
Atributos do Slider
description: um string contendo uma breve descrio sobre o Slider;
enabled: Um atributo booleano usado para habilitar o acesso do teclado e mouse
ao objeto Slider. Retorna verdadeiro (diferente de zero) se o acesso est habilitado
ou falso (zero) se no est;
frameColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da moldura do Slider. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
height: um inteiro sem sinal (de 0 a 65535) determinando a altura do Slider, em
pixels. usado juntamente com o atributo width para definir o tamanho do Slider;
name: um string contendo o nome do Slider, usado como identificador do
Slider;
orientation: um inteiro sem sinal (de 0 a 1) determinando a orientao do Slider.
Retorna 0 (zero) se o Slider horizontal ou 1 (um) se vertical;
precision: um inteiro sem sinal (de 0 a 254) determinando o nmero de dgitos
decimais a serem mostrados nos limites e no valor visvel do Slider.
332

Scripts

Manual do Usurio

rangeMaximum: Um nmero real configurando o valor mximo para o Slider.


usado junto com o atributo rangeMinimum para definir um intervalo de valores
para o Slider;
rangeMinimum: Um nmero real configurando o valor mnimo para o Slider.
usado junto com o atributo rangeMaximum para definir um intervalo de valores para
o Slider;
showRange: Um atributo booleano determinando que os limites do Slider sejam
mostrados. Retorna verdadeiro (diferente de zero) se os limites so mostrados ou
falso (zero) se no so;
showTip: Um atributo booleano habilitando o objeto a mostrar uma Tip (dica)
quando o mouse est sobre ele. Retorna verdadeiro (diferente de zero) se a Tip est
habilitada ou falso (zero) se no est;
showValue: Um atributo booleano determinando que o valor do Slider seja
mostrado. Retorna verdadeiro (diferente de zero) se o valor do Slider mostrado ou
falso (zero) se no ;
step: Um nmero real a ser incrementado ou decrementado do valor do Slider
quando as setas do mesmo so pressionadas;
textColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor do texto que ser mostrado no Slider. Este valor tambm
pode ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode
variar de 0 a 255;
updateOnRelease: Um atributo booleano determinando que o valor do Slider
seja atualizado quando o boto do mouse for solto depois de mover a alavanca do
Slider. Retorna verdadeiro (diferente de zero) se o Slider atualizado quando sua
alavanca movida ou falso (zero) se no .
visible: Um atributo booleano determinando que o Slider seja visvel. Retorna
verdadeiro (diferente de zero) se o Slider visvel ou falso (zero) se no ;
width: Um inteiro sem sinal (de 0 a 65535) determinando a largura do Slider,
em pixels. usado juntamente com o atributo height para definir o tamanho do
Slider;
x: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X para
o canto superior esquerdo do Slider, em pixels. usado juntamente com o atributo Y
para definir a posio do canto superior esquerdo do Slider a partir da origem da
Tela (0,0);
y: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada Y para
o canto superior esquerdo do Slider, em pixels. usado juntamente com o atributo X
para definir a posio do canto superior esquerdo do Slider a partir da origem da
Tela (0,0);

Scripts

333

Manual do Usurio

Atributos do Texto
description: Um string contendo uma breve descrio sobre o Texto;
enabled: Um atributo booleano usado para habilitar o acesso do teclado e mouse
ao objeto Texto. Retorna verdadeiro (diferente de zero) se o acesso est habilitado
ou falso (zero) se no est;
height: um inteiro sem sinal (de 0 a 65535) determinando a altura do Texto, em
pixels. usado juntamente com o atributo width para definir o tamanho do Texto;
name: um string contendo o nome do Texto, usado como identificador do Texto;
showTip: Um atributo booleano habilitando o objeto a mostrar uma Tip (dica)
quando o mouse est sobre ele. Retorna verdadeiro (diferente de zero) se a Tip est
habilitada ou falso (zero) se no est;
visible: Um atributo booleano determinando que o Texto seja visvel. Retorna
verdadeiro (diferente de zero) se o Texto visvel ou falso (zero) se no ;
width: Um inteiro sem sinal (de 0 a 65535) determinando a largura do Texto, em
pixels. usado juntamente com o atributo height para definir o tamanho do Texto;
x: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X para
o canto superior esquerdo do Texto, em pixels. usado juntamente com o atributo Y
para definir a posio do canto superior esquerdo do Texto a partir da origem da
Tela (0,0);
y: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada Y para
o canto superior esquerdo do Texto, em pixels. usado juntamente com o atributo X
para definir a posio do canto superior esquerdo do Texto a partir da origem da
Tela (0,0);
Atributos da Tendncia
description: Um string contendo uma breve descrio sobre a Tendncia;
enabled: Um atributo booleano usado para habilitar o acesso do teclado e mouse
ao objeto Tendncia. Retorna verdadeiro (diferente de zero) se o acesso est
habilitado ou falso (zero) se no est;
enableDataRec: Um atributo booleano usado para habilitar a Tendncia a
coletar novos valores sempre que os Tags associados a ela mudarem. Retorna
verdadeiro (diferente de zero) se os valores so coletados ou falso (zero) se no so;
frozen: Um atributo booleano usado para habilitar/desabilitar o scroll
automatico do Trend. Retorna verdadeiro (diferente de zero) se o Trend est
congelado ou falso (zero) se o scroll est habilitado (default);

334

Scripts

Manual do Usurio

height: Um inteiro sem sinal (de 0 a 65535) determinando a altura da Tendncia,


em pixels. usado juntamente com o atributo width para definir o tamanho da
Tendncia;
isXY: Um atributo booleano. Somente para uso do Elipse SCADA. No so
permitidas modificaes por parte de usurios.
name: Um string contendo o nome do Tendncia, usado como identificador da
Tendncia;
orientation: Um inteiro sem sinal (de 0 a 3) determinando a orientao do
grfico da Tendncia, conforme a tabela a seguir:
VALOR
0

ORIENTAO
Horizontal, da direita para esquerda

Horizontal, da esquerda para direita

Vertical, de cima para baixo

Vertical, de baixo para cima

showTip: Um atributo booleano habilitando o objeto a mostrar uma Tip (dica)


quando o mouse est sobre ele. Retorna verdadeiro (diferente de zero) se a Tip est
habilitada ou falso (zero) se no est;
timeSpan: Um nmero real determinando o tempo a ser visualizado na
Tendncia em segundos.
visible: Um atributo booleano determinando se a tendncia est visvel. Retorna
verdadeiro (diferente de zero) se a tendncia est visvel ou falso (zero) se no est.
width: Um inteiro sem sinal (de 0 a 65535) determinando a largura da
Tendncia, em pixels. usado juntamente com o atributo height para definir o
tamanho da Tendncia;
x: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X para
o canto superior esquerdo da Tendncia, em pixels. usado juntamente com o
atributo Y para definir a posio do canto superior esquerdo da Tendncia a partir da
origem da Tela (0,0);
y: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada Y para
o canto superior esquerdo da Tendncia, em pixels. usado juntamente com o
atributo X para definir a posio do canto superior esquerdo da Tendncia a partir da
origem da Tela (0,0);
Atributos da Moldura
borderColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da borda da Moldura. Este valor tambm pode ser
Scripts

335

Manual do Usurio

especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
borderEnabled: Um atributo booleano determinando que a borda da Moldura
seja mostrada. Retorna verdadeiro (diferente de zero) se a borda mostrada ou falso
(zero) se no ;
borderThickness: Um inteiro sem sinal (de 0 a 255) determinando a espessura
da borda da Moldura;
color: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da Moldura. Este valor tambm pode ser especificado
pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0 a 255;
description: Um string contendo uma breve descrio sobre a Moldura;
enable3D: Um atributo booleano usado para habilitar um efeito 3D na Moldura.
Retorna verdadeiro (diferente de zero) se o efeito 3D est habilitado ou falso (zero)
se no est.
frame: Um atributo booleano determinando que a Moldura seja mostrada.
Retorna verdadeiro (diferente de zero) se a Moldura mostrada ou falso (zero) se
no .
name: Um string contendo o nome da Moldura, usado como identificador da
Moldura;
separator: Um atributo booleano determinando que uma linha de separao do
ttulo seja mostrada. Retorna verdadeiro (diferente de zero) se a linha mostrada ou
falso (zero) se no ;
set3DInset: Um atributo booleano determinando que o efeito 3D seja na parte de
dentro ou de fora da Moldura. Retorna verdadeiro (diferente de zero) se o efeito 3D
mostrado por dentro ou falso (zero) se por fora;
thickness3D: Um inteiro sem sinal (de 0 a 255) determinando a espessura do
efeito 3D da Moldura.
title: Um string contendo o ttulo da Moldura;
titleColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor do texto do ttulo. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
titleEnabled: Um atributo booleano determinando que o ttulo da Moldura seja
mostrado. Retorna verdadeiro (diferente de zero) se o ttulo mostrado ou falso
(zero) se no ;

336

Scripts

Manual do Usurio

19.6.6. Atributos da Plotagem


autoRangeX: Um atributo booleano determinando que os limites do eixo X do
grfico sejam automaticamente calculados. Retorna verdadeiro (diferente de zero) se
o clculo automtico para os limites do eixo X est habilitado ou falso (zero) se no
est;
autoRangeY: Um atributo booleano determinando que os limites do eixo Y do
grfico sejam automaticamente calculados. Retorna verdadeiro (diferente de zero) se
o clculo automtico para os limites do eixo Y est habilitado ou falso (zero) se no
est;
backgroundColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal
(de 0 a 16777215) definindo a cor de fundo da Plotagem. Este valor tambm pode
ser especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar
de 0 a 255;
backRulerColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de
0 a 16777215) definindo a cor de fundo da Plotagem. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
bottomLimit: Um nmero real configurando o limite inferior a ser mostrado na
rgua do eixo Y. usado junto com o atributo topLimit para definir um intervalo de
valores;
bottomRuler: Um atributo booleano determinando que uma rgua de valores
seja mostrada na parte inferior da Plotagem. Retorna verdadeiro (diferente de zero)
se a rgua inferior mostrada ou falso (zero) se no ;
bShowMsec: Um atributo booleano determinando que os milisegundos sejam
sejam mostrados na Plotagem. Retorna verdadeiro (diferente de zero) se os
milisegundos so mostrados ou falso (zero) se no so;
description: Um string contendo uma breve descrio sobre a Plotagem;
enableXUnit: Um atributo booleano determinando que a unidade do eixo X seja
mostrada na Plotagem. Retorna verdadeiro (diferente de zero) se a unidade do eixo
X mostrada ou falso (zero) se no ;
enableYUnit: Um atributo booleano determinando que a unidade do eixo Y seja
mostrada na Plotagem. Retorna verdadeiro (diferente de zero) se a unidade do eixo
Y mostrada ou falso (zero) se no ;
gridColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da grade da Plotagem. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;

Scripts

337

Manual do Usurio

gridVisible: Um atributo booleano determinando que a grade da Plotagem seja


mostrada. Retorna verdadeiro (diferente de zero) se a grade mostrada ou falso
(zero) se no ;
gridX: Um inteiro sem sinal (de 0 a 65535) determinando o nmero de divises
no eixo X;
gridY: Um inteiro sem sinal (de 0 a 65535) determinando o nmero de divises
no eixo Y;
leftLimit: Um nmero real configurando o limite esquerdo a ser mostrado na
rgua do eixo X. usado junto com o atributo rightLimit para definir um intervalo
de valores;
leftRuler: Um atributo booleano determinando que uma rgua de valores seja
mostrada esquerda da Plotagem. Retorna verdadeiro (diferente de zero) se a rgua
esquerda mostrada ou falso (zero) se no ;
name: Um string contendo o nome da Plotagem, usado como identificador da
Plotagem;
rightLimit: Um nmero real configurando o limite direito a ser mostrado na
rgua do eixo X. usado junto com o atributo leftLimit para definir um intervalo de
valores;
rightRuler: Um atributo booleano determinando que uma rgua de valores seja
mostrada direita da Plotagem. Retorna verdadeiro (diferente de zero) se a rgua
direita mostrada ou falso (zero) se no ;
rulerColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da rgua da Plotagem. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
topLimit: Um nmero real configurando o limite superior a ser mostrado na
rgua do eixo Y. usado junto com o atributo bottomLimit para definir um intervalo
de valores;
topRuler: Um atributo booleano determinando que uma rgua de valores seja
mostrada na parte superior da Plotagem. Retorna verdadeiro (diferente de zero) se a
rgua superior mostrada ou falso (zero) se no ;
xUnit: Um string contendo o nome da unidade a ser mostrada no eixo X;
yUnit

: Um string contendo o nome da unidade a ser mostrada no eixo Y;

Atributos do Cursor
barCalc: Determina como o valor da barra calculado, a saber: 0 = Mdia;
1 = Mxima; 2 = Mnima; 3 = Por Amostra.
338

Scripts

Manual do Usurio

barWidth: Define a largura da barra no eixo X quando for uma barra por
amostra.
bottomWorld: Determina o ponto inferior dos dados do grfico.
description: Possui a descrio do objeto.
leftWorld: Determina o ponto esquerdo dos dados do grfico.
mode: Configura o modo de operao do cursor, a saber: 0 = Nenhum;
1 = Modo de Seleo; 2 = Modo de Zoom; 3 = Modo de Rolagem.
name: Contm o nome que identifica o objeto.
penColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da pena do cursor. Este valor tambm pode ser
especificado pela funo RGB (ver funo RGB).
penStyle: Especifica o estilo da pena do cursor, a saber: 0 = Slido;
1 = Tracejado; 2 = Pontilhado; 3 = Trao-Ponto; 4 = Trao-Ponto-Ponto.
penType: Especifica o tipo da pena do cursor a ser desenhado, a saber:
1 = Linha; 2 = Barra; 3 = rea.
penVisible: Atributo booleano que determina se a pena est sendo mostrada
(diferente de zero) ou no (zero).
penWidth: Um inteiro sem sinal (de 0 a 65.535) determinando a largura da pena
do cursor em pixels.
rangeType: Determina the seleo do cursor:
0

VALOR

ESTILO
Sem seleo.

A seleo um ponto.

A seleo um retngulo.

rangeX1: Determina o valor x do primeiro ponto da seleo (atributo


rangeType deve ser 2).
rangeX2: Determina o valor x do segundo ponto da seleo (atributo
rangeType deve ser 2).
rangeY1: Determina o valor y do primeiro ponto da seleo (atributo
rangeType deve ser 2).
rangeY2: Determina o valor y do segundo ponto da seleo (atributo
rangeType deve ser 2).
rightWorld: Determina o ponto direito dos dados do grfico (atributo
rangeType deve ser 2).
selLabel: Nome da pena selecionada.
Scripts

339

Manual do Usurio

selRecord: Determina o nmero do registro selecionado: Se o valor for -1, no


h seleo.
selX: Determina o valor x do ponto selecionado (atributo rangeType deve
ser 1).
selY: Determina o valor y do ponto selecionado (atributo rangeType deve
ser 1).
topWorld: Determina o ponto superior dos dados do grfico.
vLock: Atributo booleano que determina se os limites verticais do grfico sero
congelados quando em modo zoom ou rolagem (diferente de zero) ou no (zero).
Atributos das Penas
description: Um string contendo uma breve descrio sobre a Pena;
name: Um string contendo o nome da Pena, usado como identificador da Pena;
penColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor da Pena. Este valor tambm pode ser especificado pela
funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0 a 255;
penStyle: Um inteiro sem sinal (de 0 a 4) determinando o estilo da Pena,
conforme a tabela a seguir:
VALOR

ESTILO

Slido

Tracejado

Pontilhado

Trao-Ponto
Trao-Ponto-Ponto

penVisible: Atributo booleano que determina se a pena est sendo mostrada


(diferente de zero) ou no (zero).
penWidth: Um inteiro sem sinal (de 0 a 65535) determinando a largura da Pena
em pixels;
Atributos da Marca
description: Um string contendo uma breve descrio sobre a Marca;
name: Um string contendo o nome da Marca, usado como identificador da
Marca;
markType: Um inteiro sem sinal (de 0 a 2) determinando o tipo da Marca,
conforme a tabela a seguir:
340

Scripts

Manual do Usurio

VALOR

TIPO

Ponto

Vertical

Horizontal

penColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a


16777215) definindo a cor da Marca. Este valor tambm pode ser especificado pela
funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0 a 255;
penStyle: Um inteiro sem sinal (de 0 a 4) determinando o estilo da Marca,
conforme a tabela a seguir:
VALOR

ESTILO

Slido

Tracejado

Pontilhado

Trao-Ponto
Trao-Ponto-Ponto

penVisible: Um atributo booleano determinando que a Marca seja mostrada.


Retorna verdadeiro (diferente de zero) se a Marca mostrada ou falso (zero) se no
;
penWidth: Um inteiro sem sinal (from 0 to 65535) determinando a largura da
Marca em pixels;
x: Um nmero real determinando a coordenada X da Marca em pixels. usado
juntamente com o atributo Y para definir a posio da Marca a partir da origem do
grfico (0,0);
y: Um nmero real determinando a coordenada Y da Marca em pixels. usado
juntamente com o atributo X para definir a posio da Marca a partir da origem do
grfico (0,0);

19.6.7. Atributos de Alarmes


description: Um string contendo uma breve descrio sobre o Alarme;
displayMessageBox
: Um atributo booleano determinando que as
mensagens de alarme sejam mostradas quando um alarme ocorrer. Retorna
verdadeiro (diferente de zero) se as mensagens esto habilitadas ou falso (zero) se
no esto;
filename: Um string contendo o nome do arquivo de log de Alarmes;
lastAlarmPri: Um inteiro sem sinal (de 0 a 65535) informando a prioridade do
ltimo alarme ativado. um atributo somente de leitura.
Scripts

341

Manual do Usurio

logAlarms: Um atributo booleano determinando que os alarmes sejam gravados


no arquivo de log de Alarmes. Retorna verdadeiro (diferente de zero) se a gravao
est habilitada ou falso (zero) se no est;
name: Um string contendo o nome do Alarme, usado como identificador do
Alarme;
nRecords: Um inteiro sem sinal (de 0 a 65535) determinando o nmero de
alarmes mais recentes a serem gravados no arquivo de log de alarmes.
soundType
: Um inteiro sem sinal (de 0 a 65535) determinando o tipo de
som a ser tocado quando um alarme ocorrer. Est disponvel somente se o atributo
warningSound est habilitado.
warningSound: Um atributo booleano usado para habilitar um som de alerta
quando um alarme ocorrer. Retorna verdadeiro (diferente de zero) se o som de alerta
est habilitado ou falso (zero) se no est;

19.6.8. Atributos das Receitas


description: Um string contendo uma breve descrio sobre o Receita;
name: Um string contendo o nome da Receita, usado como identificador da
Receita;

19.6.9. Atributos dos Histricos


batch: Um atributo booleano usado para habilitar um processo de batelada.
Retorna verdadeiro (diferente de zero) se a batelada est habilitada ou falso (zero) se
no est;
description: Um string contendo uma breve descrio sobre o Histrico;
enabled: Um atributo booleano usado para habilitar a gravao dos dados
histricos no arquivo de Histrico. Retorna verdadeiro (diferente de zero) se a
gravao est habilitada ou falso (zero) se no est;
filename: Um string contendo o nome do arquivo de Histrico;
isBatchRunning: Um atributo booleano (somente leitura) determinando se a
batelada est sendo executada ou no. Retorna verdadeiro (diferente de zero) se a
batelada est executando ou falso (zero) se no est;
name: Um string contendo o nome do Histrico, usado como identificador do
Histrico;
networkSupport: Um atributo booleano usado para habilitar o suporte a rede
para o Histrico, isto , permite que o Histrico seja acessado (somente para leitura)
342

Scripts

Manual do Usurio

por outras aplicaes Elipse na Rede, atravs de um Browser ou Relatrio do tipo


Anlise Histrica. Retorna verdadeiro (diferente de zero) se o suporte a rede est
habilitado ou falso (zero) se no est;
size: Um inteiro sem sinal (de 0 a 65535) determinando o tamanho do arquivo de
Histrico em nmero de registros;
writeTime: Um inteiro longo sem sinal (de 0 a 232) determinando a frequncia
com que os dados sero escritos no arquivo de Histrico;

19.6.10. Atributos da Anlise Histrica


advised: Este atributo somente para leitura e no faz sentido para a Anlise
Histrica;
description: Um string contendo uma breve descrio sobre a Anlise Histrica;
maximizeButton: Um atributo booleano determinando que o boto maximizar
esteja habilitado na janela da Anlise Histrica. Retorna verdadeiro (diferente de
zero) se o boto est habilitado ou falso (zero) se no est;
minimizeButton: Um atributo booleano determinando que o boto minimizar
esteja habilitado na janela da Anlise Histrica. Retorna verdadeiro (diferente de
zero) se o boto est habilitado ou falso (zero) se no est;
modal: Um atributo booleano determinando que a caixa de dilogo da Anlise
Histrica seja modal (no permite acessar nenhuma outra janela antes de ser
fechada) ou modeless (no necessita ser fechada para se acessar outras telas).
Retorna verdadeiro (diferente de zero) se a pgina modal ou falso (zero) se no ;
name: Um string contendo o nome da Anlise Histrica, usado como
identificador da Anlise;
pageStyle: Um inteiro sem sinal (de 0 a 2) determinando quais as pginas da
Anlise Histrica que devem ser mostradas, conforme a tabela a seguir:
VALOR
0
1
2

PGINAS
Mostra todas as pginas
Mostra somente a pgina da Anlise (Grfico)
Mostra somente as pginas selecionadas

resizeable: Um atributo booleano determinando que a janela da Anlise


Histrica possa ser redimensionada em tempo de execuo. Retorna verdadeiro
(diferente de zero) se a janela pode ser redimensionada ou falso (zero) se no pode;
showGraphPage: Um atributo booleano determinando que a pgina Grfico
seja mostrada na janela da Anlise Histrica. Retorna verdadeiro (diferente de zero)
se a pgina mostrada ou falso (zero) se no ;
Scripts

343

Manual do Usurio

showPenColorsPage: Um atributo booleano determinando que a pgina Cores


das Penas seja mostrada na janela da Anlise Histrica. Retorna verdadeiro
(diferente de zero) se a pgina mostrada ou falso (zero) se no ;
showPensPage: Um atributo booleano determinando que a pgina Penas seja
mostrada na janela da Anlise Histrica. Retorna verdadeiro (diferente de zero) se a
pgina mostrada ou falso (zero) se no ;
showPrintSetupPage: Um atributo booleano determinando que a pgina
Impresso seja mostrada na janela da Anlise Histrica. Retorna verdadeiro
(diferente de zero) se a pgina mostrada ou falso (zero) se no ;
showQueryPage: Um atributo booleano determinando que a pgina Consulta
seja mostrada na janela da Anlise Histrica. Retorna verdadeiro (diferente de zero)
se a pgina mostrada ou falso (zero) se no ;
showSettingsPage: Um atributo booleano determinando que a pgina
Configuraes seja mostrada na janela da Anlise Histrica. Retorna verdadeiro
(diferente de zero) se a pgina mostrada ou falso (zero) se no ;

19.6.11. Atributos da Consulta


batchField: texto (string) que define qual o campo de cabealho a ser utilizado
em uma consulta em um histrico por bateladas. Este valor equivalente ao campo
Field na pgina Settings nas propriedades do browser. Aps configurada esta
propriedade, deve-se chamar a funo UpdateQuery() para visualizar os novos
dados no browser.
criteria: um string contendo o nome da batelada que se deseja procurar.
description: um string contendo uma breve descrio sobre a Consulta.
filename: um string contendo o nome do arquivo sobre o qual vai ser aplicada a
Consulta.
finalDay: um inteiro sem sinal (de 1 a 31) determinando o dia final quando o
tipo de Consulta por Intervalo de Tempo;
finalHour: um inteiro sem sinal (de 0 a 23) determinando a hora final quando o
tipo de Consulta por Intervalo de Tempo;
finalMinute: um inteiro sem sinal (de 0 a 59) determinando o minuto final
quando o tipo de Consulta por Intervalo de Tempo;
finalMonth: um inteiro sem sinal (de 1 a 12) determinando o ms final quando o
tipo de Consulta por Intervalo de Tempo;
finalSecond: um inteiro sem sinal (de 0 a 59) determinando o segundo final
quando o tipo de Consulta por Intervalo de Tempo;
344

Scripts

Manual do Usurio

finalYear: um inteiro sem sinal (de 1970 a 2039) determinando o ano final
quando o tipo de Consulta por Intervalo de Tempo;
name: um string contendo o nome da Consulta, usado como identificador da
Consulta.
queryType: um inteiro sem sinal (de 0 a 2) determinando o tipo de Consulta
conforme a tabela a seguir:
VALOR
0
1
2

TIPO DA CONSULTA
Intervalo de Tempo
Dados mais Recentes
Sem Critrio

queryUnit: usado juntamente com o atributo queryValue, quando este


igual a 1 (dados mais recentes ou newest data). um inteiro sem sinal (de 0 a 5)
determinando uma unidade de tempo para a busca dos dados mais recentes,
conforme a tabela a seguir:
VALOR
0
1
2
3
4
5

FORMATO
Dia
Ms
Ano
Horas
Minutos
Segundos

queryValue: Somente disponvel se o atributo queryType 1 (Dados mais


Recentes ou newest data). um inteiro sem sinal determinando um perodo de
tempo para a busca dos dados mais recentes, especificado no campo Last na pgina
de Consulta. usado juntamente com o atributo queryUnit.
startDay: um inteiro sem sinal (de 1 a 31) determinando o dia inicial quando o
tipo de consulta por Intervalo de Tempo;
startHour: um inteiro sem sinal (de 0 a 23) determinando a hora inicial quando
o tipo de Consulta por Intervalo de Tempo;
startMinute: um inteiro sem sinal (de 0 a 59) determinando o minuto inicial
quando o tipo de Consulta por Intervalo de Tempo;
startMonth: um inteiro sem sinal (de 1 a 12) determinando o ms inicial quando
o tipo de consulta por Intervalo de Tempo;
startSecond: um inteiro sem sinal (de 0 a 59) determinando o segundo inicial
quando o tipo de Consulta por Intervalo de Tempo;
startYear: um inteiro sem sinal (de 1970 a 2039) determinando o ano inicial
quando o tipo de Consulta por Intervalo de Tempo;

Scripts

345

Manual do Usurio

19.6.12. Atributos do CEP (SPC)


avg: Um nmero real determinando a mdia;
cp: Somente para uso do Elipse SCADA.;
cpk: Somente para uso do Elipse SCADA.
cr: Somente para uso do Elipse SCADA;
description: um string contendo uma breve descrio sobre o SPC;
dispersionChartType: um inteiro sem sinal (de 0 a 1) determinando o tipo do
grfico como Sigmas (0) ou Ranges (1);
dispLCL: Um nmero real configurando o limite inferior do grfico de
Disperso. Ele usado junto com o atributo dispUCL para definir um intervalo de
variao;
dispUCL: Um nmero real configurando o limite superior do grfico de
Disperso. Ele usado junto com o atributo dispLCL para definir um intervalo de
variao;
k: Somente para uso do Elipse SCADA;
lcl: Um nmero real configurando o limite inferior de Controle. Ele usado
junto com o atributo ucl para definir um intervalo de variao;
lel: Um nmero real configurando o limite inferior de Engenharia. Ele usado
junto com o atributo uel para definir um intervalo de variao;
maxValue: (somente leitura) Um nmero real indicando o valor mximo entre
as amostras calculadas.
minValue: (somente leitura) Um nmero real indicando o valor mnimo entre as
amostras calculadas.
name: Um string contendo o nome do SPC, usado como identificador do SPC;
nRecords: (somente leitura) um inteiro sem sinal (de 1 a 65535) indicando o
nmero total de registros analisados.
pointsPerGroup: um inteiro sem sinal (de 0 a 65535) determinando o nmero
de pontos por amostra;
stdDev: Um nmero real determinando o Desvio Padro;
ucl: Um nmero real configurando o limite superior de Controle. Ele usado
junto com o atributo lcl para definir um intervalo de variao;
uel: Um nmero real configurando o limite superior de Engenharia. Ele usado
junto com o atributo lel para definir um intervalo de variao;
346

Scripts

Manual do Usurio

19.6.13. Atributos da Batelada


description: Um string contendo uma breve descrio sobre a Batelada;
fieldName: Um string contendo o nome do arquivo da Batelada;
fieldType: Um inteiro sem sinal determinando o tipo de Batelada (somente
leitura).
name: Um string contendo o nome da Batelada, usado como identificador da
Batelada;

19.6.14. Atributos dos Relatrios


bottomMargin: um inteiro sem sinal (de 0 a 65535) determinando a margem
inferior do Relatrio, em milmetros;
description: um string contendo uma breve descrio sobre o Relatrio;
leftMargin: um inteiro sem sinal (de 0 a 65535) determinando a margem
esquerda do Relatrio, em milmetros;
name: um string contendo o nome do Relatrio, usado como identificador do
Relatrio;
printHeader: Um atributo booleano usado para habilitar a impresso de uma
pgina contendo informaes do cabealho da batelada. Retorna verdadeiro
(diferente de zero) se a impresso do cabealho est habilitada ou falso (zero) se no
est;
printTitle: Um atributo booleano usado para habilitar a impresso de um ttulo
no Relatrio. Retorna verdadeiro (diferente de zero) se a impresso do ttulo est
habilitada ou falso (zero) se no est;
rightMargin: um inteiro sem sinal (de 0 a 65535) determinando a margem
direita do Relatrio, em milmetros;
rowColor: Um nmero hexadecimal (de 0h a 1000000h) ou decimal (de 0 a
16777215) definindo a cor das linhas do Relatrio. Este valor tambm pode ser
especificado pela funo RGB(r,g,b) onde cada componente (r,g,b) pode variar de 0
a 255;
topMargin: um inteiro sem sinal (de 0 a 65535) determinando a margem
superior do Relatrio, em milmetros;

Scripts

347

Manual do Usurio

19.6.15. Atributos dos Drivers


Driver PLC
abortOnError: Um atributo booleano usado para habilitar a interrupo da
comunicao se algum erro ocorrer. Retorna verdadeiro (diferente de zero) se a
comunicao est habilitada ou falso (zero) se no est;
busy: Um atributo booleano usado para informar se uma comunicao est
ocorrendo. Retorna verdadeiro (diferente de zero) se uma comunicao est
ocorrendo ou falso (zero) se nenhuma comunicao est sendo feita;
description: Um string contendo uma breve descrio sobre o Driver;
driverName: Um string contendo o nome do Driver conforme o fabricante, este
nome ser usado para a comunicao com o PLC;
driverPath: Um string contendo a localizao (path) do Driver;
enableRead: Um atributo booleano usado para habilitar a leitura de valores e
blocos do driver. Retorna verdadeiro (diferente de zero) se a leitura est habilitada
ou falso (zero) se no est;
enableRetry: Um atributo booleano usado para habilitar a uma nova tentativa de
comunicao se algum erro ocorrer. Retorna verdadeiro (diferente de zero) se a
retentativa est habilitada ou falso (zero) se no est;
enableWrite: Um atributo booleano usado para habilitar a escrita de valores e
blocos do driver. Retorna verdadeiro (diferente de zero) se a escrita est habilitada
ou falso (zero) se no est;
hideMouse: Um atributo booleano determinando que o mouse seja escondido
durante a comunicao. Retorna verdadeiro (diferente de zero) se o desaparecimento
do mouse est habilitado ou falso (zero) se no est;
isLoaded: Um atributo booleano usado para informar se o driver est carregado
em memria ou no. Retorna verdadeiro (diferente de zero) se o driver est
carregado ou falso (zero) se no est;
isStarted: Um atributo booleano usado para informar se uma comunicao foi
iniciada ou no. Retorna verdadeiro (diferente de zero) se uma comunicao foi
iniciada ou falso (zero) se no foi;
name: Um string contendo o nome do Driver, usado como identificador do
Driver;
p1: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro P1
conforme a documentao do Driver;

348

Scripts

Manual do Usurio

p2: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro P2


conforme a documentao do Driver;
p3: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro P3
conforme a documentao do Driver;
p4: Um inteiro com sinal (de -32768 a 32767) configurando o parmetro P4
conforme a documentao do Driver;
retryCount: Um inteiro sem sinal (de 0 a 65535) determinando o nmero de
tentativas, se o atributo enableRetry est habilitado;
Drivers de Rede
bytesReceived: Um inteiro sem sinal (de 0 a 65535) determinando o nmero de
bytes recebidos pelo driver (somente leitura);
bytesSent: Um inteiro sem sinal (de 0 a 65535) determinando o nmero de bytes
enviados pelo driver aos clientes (somente leitura);
description: Um string contendo uma breve descrio sobre o Driver;
name: Um string contendo o nome do Driver, usado como identificador do
Driver;
nClients: Um inteiro sem sinal (de 0 a 65535) determinando o nmero de
clientes atualmente conectados ao driver (somente leitura);
rx: Um atributo booleano (somente leitura) usado para informar se o driver est
recebendo dados ou no. Retorna verdadeiro (diferente de zero) se o driver est
recebendo dados ou falso (zero) se no est;
tx: Um atributo booleano (somente leitura) usado para informar se o driver est
enviando dados ou no. Retorna verdadeiro (diferente de zero) se o driver est
enviando dados ou falso (zero) se no est;

19.6.16. Atributos do Banco de Dados


description: Um string contendo uma breve descrio sobre o Banco de Dados.
directory: Determina o diretrio do Database.
filter: Um string ou valor usado como filtro quando feita uma consulta no
Banco de Dados.
lastErrorStr: Um string contendo a descrio do ltimo erro ocorrido em
operaes com o Banco de Dados.

Scripts

349

Manual do Usurio

name: Um string contendo o nome da database, usado como identificador do


Banco de Dados.
originalTableName: Especifica as informaes referentes a tabela do database.
recno: Um inteiro sem sinal (de 0 a 65535) determinando o nmero do registro
corrente.
sort: Um string contendo o nome do campo no Banco de Dados usado para
orden-lo.
Atributos de campos de Bancos de Dados
advised: (booleano, somente leitura) Indica que o campo est em advise, ou seja,
ele atualizado toda vez que um objeto associado for referenciado.
originalFieldName: Determina o nome do campo no database.
type: Determina o tipo do campo.

19.6.17. Atributos da Lista de Usurios


description: Um string contendo uma breve descrio sobre o Usurio.
name: Um string contendo o nome do Usurio, usado como identificador do
Usurio.

19.6.18. Atributos da Aplicao Remota


description: Um string contendo uma breve descrio sobre a Aplicao
Remota;
isConnected: Atributo booleano usado para informar se a Aplicao Remota
est conectada ou no. Retorna verdadeiro (diferente de zero) se est conectada ou
falso (zero) se no est;
isConnecting: Atributo booleano usado para informar se a Aplicao Remota
est em processo de conexo ou no. Retorna verdadeiro (diferente de zero) se est
conectando ou falso (zero) se no est;
name: Um string contendo o nome da Aplicao Remota, usado como
identificador da Aplicao Remota;

350

Scripts

Manual do Usurio

Atributos do Arquivo Remoto


bytesDone: Um inteiro sem sinal (de 0 a 232) que determina o nmero de bytes
j comparados / transferidos (somente leitura).
description: Um string contendo uma breve descrio sobre o Arquivo Remoto;
lastError: Um inteiro sem sinal (de 0 a 5) que determina o cdigo do erro
ocorrido na ltima transferncia de arquivo (somente leitura), conforme a tabela a
seguir:
VALOR
0
1
2
3
4
5

EVENTO
Transferncia OK
No conseguiu abrir ou criar arquivo do cliente
Arquivo do servidor no foi encontrado.
Dados invlidos recebidos do servidor durante conexo
Bloco fora de sequncia recebido do servidor
Erro de posicionamento ou de escrita no arquivo do cliente

name: Um string contendo o nome identificador do Arquivo Remoto;


result: Um inteiro com sinal (de -1 a 1) que determina o resultado da ltima
transferncia de arquivo (somente leitura), conforme a tabela a seguir:
VALOR
-1
0
1

EVENTO
Nenhuma transferncia foi efetuada
ltima transferncia falhou
ltima transferncia teve sucesso.

state: Um inteiro sem sinal (de 0 a 3) indicando o estado da transferncia de


arquivo atual (somente leitura), conforme a tabela a seguir:
VALOR
0
1
2
3

EVENTO
Nenhuma transferncia em andamento
Conectando
Comparando arquivos
Transferindo

totalLength: Um inteiro sem sinal (de 0 a 232) determinando o nmero de bytes


a comparar / transferir (somente leitura).
Atributos do Tag Remoto
alarmDelay: (inteiro sem sinal) o tempo mnimo (em milisegundos) que o tag
deve permanecer em uma mesma condio de alarme antes deste tornar-se ativo. Se
alarmDelay for modificado em tempo de execuo, o contador de tempo
reiniciado. Este atributo s vlido se o atributo delayedAlarm for True (ver
atributo delayedAlarm).
Scripts

351

Manual do Usurio

alternateName: Nome alternativo para este tag no log de alarmes.


alwaysInAdvise: Mantm o valor do tag sempre atualizado.
currentAlarm: Determina o estado do tag. As opes disponveis so as
seguintes:
Opes disponveis
NDICE
0

DESCRIO
Indica que no h alarmes ativos.

Alarme de nvel LOLO

Alarme de nvel LOW

Alarme de nvel High

Alarme de nvel HIHI

delayedAlarm: (booleano) Se TRUE, o tag deve permanecer um tempo mnimo


(especificado em alarmDelay) em uma mesma condio de alarme (Hi, HiHi, Lo,
LoLo) para ativar (ou gerar) o alarme correspondente.
enableAlternateName: Habilita o uso de outro nome para o tag.
enableReturnLog: Habilita/desabilita o log de mensagens de retorno de alarme.
initialValue: (string) Contm um valor inicial para o tag e permite que este valor
seja modificado em tempo de execuo.
remoteTag: Caminho do tag remoto.
remoteTagPath: (string) Indica o caminho do tag remoto dentro de uma
aplicao remota.
returnMessage: Determina a mensagem de retorno de alarme do tag.
timeStamp: Data/hora em que o valor do tag foi gerado.
Atributos do Video Remoto
name: Nome do objeto.
remoteCameraId: Determina o ID da cmera na aplicao remota.
Atributos da Cmera do Video Remoto
bitsPerPixel: Determina o nmero de bits necessrios para armazenar cada pixel
da imagem.
352

Scripts

Manual do Usurio

brighness: Determina o ajuste do brilho da imagem.


cameraId: Identificador da cmera na aplicao (de 0 a 65535).
color: Ajusta a saturao de cores da imagem.
contrast: Ajusta o contraste da imagem.
curentFrameRate: Taxa de captura atual.
currentPos: Determina a posio atual (em segundos) na sequncia do video.
firstPos: Determina a posio inicial (em segundos) da sequncia de video.
frameSize: Determina o tamanho (em bytes) do ltimo quadro capturado.
gamma: Ajuste de gama (de 0 a 1000).
imageHeight: Determina a altura da imagem, em pixels.
imageWidth: Determina a largura da imagem, em pixels.
isPaused: Indica se o video est pausado em um quadro.
isPlaying: Indica se o video est sendo reproduzido.
isStopped: Indica se a entrada de video est parada.
lastPos: Indica a posio final da sequncia de video (em segundos).
name: Determina o nome da cmera.
sharpness: Ajusta o foco da imagem.
tint: Ajusta a colorao da imagem.
velocity: Indica a velocidade em que o video est sendo tocado. As opes
disponveis so as seguintes:
Opes disponveis
NDICE

Scripts

DESCRIO
Velocidade normal frente

-1

Velocidade normal para trs

353

Manual do Usurio

19.6.19. Atributos do Watcher


Atributos Comuns
description: Um string contendo uma breve descrio sobre o Watcher.
name: Um string contendo o nome do Watcher, usado como identificador.
Atributos do Objeto AVI Player
duration: Determina o nmero total de frames do AVI.
fileName: Determina o nome do arquivo AVI.
position: Determina a posio do frame no arquivo AVI.
reverse: Retrocede um frame no arquivo AVI.
speed: Determina a velocidade dos frames do AVI.
timeFormat: Determina o formato de tempo do frame: 0 durao e posio so
especificados no nmero de frames e 1 durao e posio so especificados por
milisegundos.
volume: Determina o volume do som em 0,1% unidades do nvel do som original
(1000 = volume original, 500 = metade-volume etc.)
Atributos do Objeto AVI Recorder
description: Descrio do objeto.
fileName: Nome do arquivo AVI.
frameRate: Indica o nmero de quadros a gravar por segundo.
isRecording: Inicia/pra a gravao no arquivo AVI.
name: Nome do objeto.
Atributos da Placa S611
board: Indica o nmero da placa (de 0 a 7).
color: Determina o formato de cor da sada do video.
customHeight: Determina altura da imagem, empixels (para escala avanada).
354

Scripts

Manual do Usurio

custonWidth: Determina a largura da imagem, em pixels (para escala avanada).


format: Determina o formato da imagem (PAL-M, NTSC, etc).
frameRate: Determina o nmero de quadros a capturar por segundo.
input: Determina a entrada de video.
interlaced: Determina o entrelaamento de imagens. As opes disponveis so
as seguintes:
Opes disponveis
NDICE
0

DESCRIO
Imagem no entrelaada

Imagem entrelaada

scale: Define o tamanho da imagem.


Atributos da Placa S613
board: Determina o nmero da placa (de 0 a 7).
cfactor: Determina o fator de compresso. As configuraes so as seguintes:
Opes disponveis
NDICE

DESCRIO

Menor compresso

At 65535

Maior compresso:

color: Determina o formato de cor da sada do video.


compress: Determina a compresso da imagem. As configuraes so as
seguintes:
Opes disponveis
NDICE

DESCRIO

Sem compresso

MJPEG

customHeight: Determina a altura da imagem, em pixels (para escala avanada).


customWidth: Determina a largura da imagem, em pixels (para escala
avanada).
Scripts

355

Manual do Usurio

description: Descrio do objeto.


format: Determina o formato da imagem (PAL-M, NTSC, etc).
frameRate: Determina o nmero de quadros a capturar, por segundo.
input: Determina a entrada de video.
interlaced: Determina o entrelaamento de imagem. Se o valor for 0, a imagem
no entrelaada e se for 1, a imagem entrelaada.
name: Nome do objeto.
scale: Define o tamanho da imagem.
Atributos do Objeto VFW
deviceIndex: Determina o ndice do dispositivo na listagem de dispositivo do
sistema.
deviceName: Determina o nome do dispositivo com suporte a Video for
Windows.
deviceVersion: Determina a verso do dispositivo com suporte a Video for
Windows.
frameRate: Determina o nmero de quadros a capturar por segundo.
Atributos do Objeto XPresPlus Camera
fileName: Nome do arquivo de video.
format: Formato da imagem (PAL-M, NTSC, etc).
name: Nome do objeto.
nFrame: Determina o nmero do quadro atual.
numBoard: Determina o nmero da placa.
numCam: Define o nmero total de cmeras.

19.6.20. Atributos do Steeplechase


server: (string) Contm o nome do servidor Steeplechase.
scan: (inteiro) Tempo de varredura e atualizao do Steeplechase (em
milisegundos).

356

Scripts

Manual do Usurio

19.6.21. Atributos do OPCServer


serverStatus: (inteiro) Indica o status atual do servidor OPC. Se a verificao do
servidor estiver habilitada nas propriedades do OPCServer (opo Verificar
servidor OPC), a propriedade serverStatus ser atualizada na freqncia
especificada na propriedade vrftTime. Caso a verificao do servidor estiver
desabilitada, a propriedade poder assumir os valores 0 (no-conectado) ou -1
(desconhecido).
totalAlarms: (inteiro) Indica o nmero total de alarmes ativos em um grupo de
tags OPC.
vrfyTime: (inteiro) Especifica o perodo de tempo (em milissegundos) em que o
sistema deve verificar se o servidor est ativo.

Scripts

357

Captulo

20
20.

Suporte a DDE

O Elipse SCADA permite a troca de informaes com outros programas atravs do


suporte a tecnologia DDE (Dynamic Data Exchange). O sistema pode operar como
servidor ou cliente de aplicativos como o Microsoft Excel, Microsoft Access e
outros.

20.1. Elipse SCADA como Cliente


O Elipse SCADA trabalhando como Cliente DDE permite buscar dados de
aplicaes servidoras DDE. Para tal conexo, necessrio que a outra aplicao seja
servidora DDE (no mesmo computador). A sintaxe DDE definida na aplicao
servidora. Como Cliente DDE, o Elipse SCADA deve ter um tag DDE configurado
de acordo com a documentao de sintaxe fornecida pela aplicao servidora. No
necessrio criar qualquer definio na aplicao servidora, pois o Elipse SCADA
pode encontrar as informaes automaticamente. A configurao do tag DDE feita
na pgina geral do tag no Organizer, como pode ser visto abaixo.

Figura 145: Pgina de configurao do tag DDE

Suporte a DDE

359

Manual do Usurio

Os campos Nome do Servidor, Tpico e Item so sempre definidos de acordo com


a aplicao servidora. Se a aplicao estiver aberta no mesmo computador que o
Elipse SCADA est rodando, esta detectada automaticamente atravs dos itens
Servidor e Tpico. possvel testar a conexo com a aplicao servidora atravs do
boto [Testar Conexo].
Voc pode enviar um comando DDE para uma aplicao servidora atravs de
Scripts, usando a funo DDEExecute(). Veja o captulo sobre Scripts, em Funes
Especiais, Gerenciador Global.
Exemplo: Elipse SCADA & Microsoft Excel
A configurao a seguir estabelece uma conexo DDE entre o Elipse SCADA, como
um cliente, e o Microsoft Excel, como servidor, usando a clula A1 em uma planilha
chamada Sheet1 na pasta de trabalho Book1. Ambos os programas esto rodando
no mesmo computador.
Para esse exemplo, execute os seguintes procedimentos:

Crie um Tag DDE.


Faa as seguintes configuraes no Tag DDE:
Configuraes do Tag DDE
OPO
Nome do Servidor

Excel

DESCRIO

Tpico

[Plan1.xls]Plan1

Item

L1C1

NOTA: Para verses ou linguagens diferentes do software, tpicos e itens podem


mudar.

360

O boto Testar Conexo permite testar a conexo DDE. Uma vez feita a
conexo, o tag DDE configurado pode ser usado em objetos de tela, scripts
ou outras funes.

Suporte a DDE

Manual do Usurio

20.2. Elipse SCADA como Servidor


Elipse SCADA no necessita de nenhuma configurao especial para trabalhar como
um servidor DDE, precisa apenas estar rodando com uma aplicao aberta no
momento em que outra aplicao precisar acessar seus dados.
Para configurar a aplicao cliente basta especificar os trs parmetros para acessar
o Elipse SCADA como servidor DDE: servidor, tpico e item.
Exemplo: Elipse SCADA & Microsoft Excel
Neste exemplo o Excel (Cliente) precisa acessar um tag no Elipse SCADA
(Servidor) usando DDE.
Para esse exemplo, execute os seguintes procedimentos:

Suporte a DDE

Defina o tag que o Excel ir acessar no Elipse SCADA; por exemplo:


tagDDE.
Crie uma tabela no Excel e salve com qualquer nome; por exemplo:
tabela.xls.
No Excel, digite na clula desejada, digite a seguinte frmula:
=ELIPSE|Aplicao!Tags.tagDDE, onde: "ELIPSE" o servidor DDE,
"Aplicao" o tpico e Tags.tagDDE o item a ser acessado. Esse item
pode ser qualquer tag ou atributo de qualquer objeto do aplicativo como por
exemplo: "Hist1.DateTime".

361