Escolar Documentos
Profissional Documentos
Cultura Documentos
x
usando um de dois mtodos:
140 Histricos
a) Mtodo Sigma
Para cada amostra i ( i = 1, 2, ..., k ) calcula-se:
S
i
=
1 2
2 2
1
j
j
n
x
n
x
n
|
\
|
.
|
.
A seguir, calcula-se o desvio mdio:
S =
( )
1
1 2
k
S S 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, c
2
= 1, o que significa que no h mais correo a fazer.
O desvio padro ser, ento:
2
C
S
x
=
Recomenda-se utilizar este mtodo para amostras grandes, com n maior que 10.
Manual do Usurio
Histricos 141
b) Mtodo Range
Para cada amostra i ( i = 1, 2, ..., k ), calcula-se:
( )
i
R X X
=
max min
A seguir calcula-se a amplitude mdia:
( )
R
k
R R R
k
= + + +
1
1 2
...
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:
2
D
R
x
=
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
R X LSC
a
+ =
2
;
LIC: Limite Inferior de Controle
R X LIC
a
=
2
;
LSE: Limite Superior de Engenharia;
LIE: Limite Inferior de Engenharia;
142 Histricos
Grafico 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
e calculada como segue:
S =
( )
1
1 2
k
S S S
k
+ + + ...
Utiliza-se, para o clculo dos limites de controle, duas constantes c
3
e c
4
(ver tabela
SPC). Desta forma calcula-se os limites:
LSC = S
( )
4
c
LIC = S
( )
3
c
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
R
e calculada como segue:
( )
R
k
R R R
k
= + + +
1
1 2
...
Utiliza-se, para o clculo dos limites de controle, duas constantes d
3
e d
4
(ver tabela
CEP). Desta forma calcula-se os limites:
LSC = R .
4
d
LIC = R .
3
d
Manual do Usurio
Histricos 143
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)
N a
2
d
2
c
2
d
3
d
4
c
3
c
4
1 1,880 1,128 0,5642 0,000 3,267 0,000 3,267
2 1,023 1,693 0,7236 0,000 2,575 0,000 2,568
3 0,729 2,059 0,7979 0,000 2,282 0,000 2,266
4 0,577 2,326 0,8407 0,000 2,115 0,000 2,089
5 0,483 2,534 0,8686 0,000 2,004 0,030 1,970
6 0,419 2,704 0,8882 0,076 1,924 0,118 1,882
7 0,373 2,847 0,9027 0,136 1,864 0,185 1,815
8 0,337 2,970 0,9139 0,184 1,816 0,239 1,761
9 0,308 3,078 0,9227 0,223 1,777 0,284 1,716
10 0,285 3,173 0,9300 0,256 1,744 0,321 1,679
11 0,266 3,258 0,9359 0,284 1,716 0,354 1,646
12 0,249 3,336 0,9410 0,308 1,692 0,382 1,618
13 0,235 3,407 0,9453 0,329 1,671 0,406 1,594
14 0,223 3,472 0,9490 0,348 1,652 0,428 1,572
15 0,212 3,532 0,9523 0,364 1,636 0,448 1,552
16 0,203 3,588 0,9551 0,379 1,621 0,466 1,534
17 0,194 3,640 0,9576 0,392 1,608 0,482 1,518
18 0,187 3,689 0,9599 0,404 1,596 0,497 1,503
19 0,180 3,735 0,9619 0,414 1,586 0,510 1,490
20 0,173 3,778 0,9638 0,425 1,575 0,523 1,477
21 0,167 3,819 0,9655 0,434 1,566 0,534 1,466
22 0,162 3,858 0,9670 0,433 1,557 0,545 1,455
23 0,157 3,895 0,9684 0,452 1,548 0,555 1,445
24 0,153 3,931 0,9696 0,459 1,541 0,565 1,435
144 Histricos
Grafico 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 97: 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 6
51-100 7
101-200 8
201-500 9
501-1000 10
Mais de 1000 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:
Manual do Usurio
Histricos 145
( )
y
x
e
=
1
2
2
2
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 DESCRIO
Maior que 1.33 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.
146 Histricos
K =
( )
Media PtoMedio
Tolerancia
|
\
|
.
|
2
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
ou
( )
Media LIE
3
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.
Manual do Usurio
Histricos 147
Configuraes
Esta pgina a mesma existente na consulta do Histrico e permite a configurao
do arquivo de histrico que ser usado pelo CEP.
Figura 98: Configuraes
148 Histricos
Consulta
Esta pgina a mesma existente na consulta do Histrico e permite definir um
intervalo de tempo para o arquivo de Histrico.
Figura 99: Configuraes das Consultas
Relatrios 149
Relatrios permitem imprimir os dados de arquivos de Histrico ou de Alarmes ou
ainda valores de tags em tempo real.
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 100: Tela de criao de relatrios
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:
Capitulo
10
10. Relatrios
150 Relatrios
Figura 101: 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.
Manual do Usurio
Relatrios 151
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 102: Propriedades gerais dos relatrios
152 Relatrios
Propriedades Gerais dos Relatrios
OPO DESCRIO
Nome
Define o nome do Relatrio que ser usado na rvore
do Organizer e nos Scripts.
Descriao
Uma breve descrio sobre o Relatrio.
!mprimir cabealho na
batelada
Habilita a impresso de uma pgina contendo dados
do cabealho da Batelada.
!mprime o titulo do
relatrio
Somente disponvel para Relatrios TEXTO e
GRFICO. Imprime como ttulo o texto informado
no campo Descrio.
!mpressora
Permite escolher a definio de impressora para o
relatrio. O boto mostra a caixa de dilogo de
Configurao de Impressora.
Editar!
Permite editar o desenho de um relatrio
FORMATADO.
Fonte...
Define a fonte (tipo, cor e tamanho) a ser usada no
Relatrio.
!mprimir
Imprime o Relatrio.
!mpressora e Fonte Os botes Carregar e Salvar permitem carregar e
salvar configuraes de impressora previamente
definidas e salvas no sistema.
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.
Manual do Usurio
Relatrios 153
Figura 103: Configuraes do Relatrio
Configuraes dos Relatrios
OPO DESCRIO
Arquivo fonte
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 especifica
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.
154 Relatrios
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 104: Propriedades das Consultas
Manual do Usurio
Relatrios 155
Propriedades das Consultas
OPO DESCRIO
Sem consulta por data
No ser usado filtro, ou seja, seleciona todos os
dados.
!ntervalo 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.
Ultimo
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 105: Propriedades de Bancos de Dados em Relatrios
156 Relatrios
Propriedades do Banco de Dados
OPO DESCRIO
Campos
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.
Precisao
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.
Manual do Usurio
Relatrios 157
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 106: Propriedades de Bateladas em Relatrios
158 Relatrios
Propriedades de Bateladas
OPO DESCRIO
Campos
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.
Precisao
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.
Manual do Usurio
Relatrios 159
10.6. Grafico
Relatrio Grfico
A pgina Grfico do Relatrio Grfico aparece quando selecionada a aba Grafico no
topo das pginas do Relatrio Grfico. Esta pgina mostrada abaixo e seus
respectivos campos so descritos na tabela que segue:
Figura 107: Propriedades do Grfico
160 Relatrios
Propriedades do Grfico (Eixo X e Eixo Y)
OPO DESCRIO
Escala
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
Exibe uma rgua a esquerda do grfico, onde so
mostrados os valores do eixo Y.
Exibir rgua a direita
Exibe uma rgua a direita do grfico, onde so mostrados
os valores do eixo Y.
Ajuste automatico
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.
Propriedades do Grfico (Cores e Grade)
OPO DESCRIO
Fundo da rgua
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 grafico
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.
Nostrar 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.
Manual do Usurio
Relatrios 161
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 108: 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).
162 Relatrios
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 109: Configuraes das Cores das Penas
Manual do Usurio
Relatrios 163
10.8. 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 110: Relatrio Formatado
10.9. Relatrio Analise 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.
Drivers 165
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.
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 111: Drivers do Sistema
Capitulo
11
11. Drivers
166 Drivers
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 112: Configurao do driver
Manual do Usurio
Drivers 167
Propriedades de Configurao de Drivers
OPO DESCRIO
Nome
Nome do objeto.
Descriao
Mostra informaes do driver, como fabricante,
verso e data.
Localizaao do Driver
Mostra o caminho do arquivo do driver.
Parametros
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 comunicaao
Esconde o cursor do mouse durante a comunicao.
Retentar comunicaoes
falhadas
Define que o sistema ir tentar reestabelecer uma
comunicao perdida com o driver.
No. de tentativas
Define o nmero de tentativas de reestabelecer a
comunicao com o driver.
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.
168 Drivers
Propriedades de Configurao de Drivers (Avanado)
OPO DESCRIO
Nanter comportamento
16-bits
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.
!niciar o driver ao rodar a
aplicaao
Permite desabilitar o incio automtico do driver. Por
exemplo: em um driver dial-up, muitas vezes
interessante esperar um comando para iniciar a
comunicao.
Nanter 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.
Manual do Usurio
Drivers 169
11.1.2. Drivers de Rede
Figura 113: Configuraes Comuns para Drivers de Rede
170 Drivers
Configuraes Comuns para Drivers de Rede
OPO DESCRIO
Nome
Nome do objeto.
Descriao
Breve descrio do objeto.
Nome do driver
Nome do driver, definido pelo fabricante.
Localizaao do driver
Permite navegar nos diretrios para indicar o arquivo
do driver.
Configuraao 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
!nicia driver quando
carregar a aplicaao
Ativa o driver no incio da execuo da aplicao.
T1, T2, PS, BR
Estes parmetros governam o funcionamento do
protocolo de troca de mensagens entre diversas
instncias do Elipse SCADA. O protocolo full-
duplex 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.
Manual do Usurio
Drivers 171
11.2. 8cripts de Drivers
Scripts do 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:
OnCommError
Executado cada vez que um erro de leitura ou escrita ocorrer no
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 114: Cabealho da Lista de tags associados
Opes disponveis na Lista de tags associados
OPO DESCRIO
Nome
Nome do Tag
N1/B1 - N+/B+
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).
Database 173
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 115: Database
Propriedades do Database
OPO DESCRIO
Lista
Lista os databases existentes na aplicao.
Novo Chama o Assistente de Nova Conexao 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.
Voc pode conectar o Elipse SCADA a um banco de dados usando o Assistente de
Nova Conexao ao pressionar o boto Novo direita da pgina. Uma janela ser
mostrada perguntando se voc deseja criar uma conexo com uma tabela j existente
Capitulo
12
12. Database
174 Database
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, CA-
Clipper, 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:
Figura 116: Exemplo de conectividade ODBC
Manual do Usurio
Drivers 175
Exemplo usando Database
O exemplo a seguir mostra uma conexo do Elipse SCADA com um banco de dados
Access.
No Access crie um banco de dados contendo uma ou mais tabelas. Ex:
arquivo SUPPORT.NDB com a tabela Nain Table.
Feche o banco de dados (SUPPORT.NDB).
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.
Figura 117: Assistente de Nova Conexo de Banco de Dados
Selecione a aba Nachine 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.
176 Database
Figura 118: Bases de dados ODBC
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.NDB);
A prxima janela permite a seleo das tabelas do banco de dados que
sero utilizadas. Selecione a tabela Nain 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).
Usurios 177
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 119: Lista de usurios
Opes disponveis na Lista de usurios
OPO DESCRIO
Lista
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.
Capitulo
13
13. Usuarios
178 Usurios
Figura 120: Propriedades do Usurio
Propriedades do Usurio
OPO DESCRIO
Nome
Define o nome do usurio.
Descriao
Uma breve descrio sobre o usurio.
Login
String de identificao do usurio.
Senha
Campo para cadastrar a senha do usurio.
Nivel 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 ACESSO
0
livre acesso para todos
1
super usurio
maior que 1
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).
Manual do Usurio
Usurios 179
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 DESCRIO
UserName
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).
180 Usurios
13.2. 8cripts 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:
EVENTOS DESCRIO
OnUserLogin
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;
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.
Aplicaes Remotas 181
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.
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
Aplicaoes 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 121: Aplicaes Remotas
Capitulo
14
14. Aplicaes Remotas
182 Aplicaes Remotas
Propriedades da Lista de Aplicao Remota
OPO DESCRIO
Lista
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).
Manual do Usurio
Aplicaes Remotas 183
14.1. Propriedades Gerais
Cada Aplicao Remota que voc cria para a aplicao, aparece abaixo da opo
Aplicaoes 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 122: Propriedades Gerais
184 Aplicaes Remotas
Propriedades Gerais de Aplicaes Remotas
OPO DESCRIO
Nome
Define o nome da Aplicao Remota que ser usada
na rvore do Organizer e nos Scripts.
Descriao
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.
Configuraao 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 aplicaao
Habilita a conexo com a Aplicao Remota
(Servidor) no incio da execuo da aplicao no
Elipse.
Ajuda
Mostra a Ajuda do Driver selecionado.
Configuraao.
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.
Manual do Usurio
Aplicaes Remotas 185
14.2. 8cripts 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
OnDisconnect
Executa o Script ao terminar a conexo.
Elipse Web 187
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 ser 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 123: Aba Web
Clique no boto Localizar e especifique o diretrio padro do Servidor
Web. No caso do PWS ou IIS, o diretrio padro C:\Inetpub\wwwroot.
Capitulo
15
15. Elipse Web
188 Elipse Web
Clique no boto OK.
No item Porta, especifique a porta TCP/IP a ser utilizada.
Feitas estas configuraes, copie os arquivos Applet.cab e Applet.zip
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 htm. Para tanto, acesse as propriedades da Tela e clique
na aba Web, conforme figura abaixo:
Figura 124: 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 htm configurado
(Ex: http://NomedoServidor/Screen1.htm).
Observaes:
- 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.
Watcher 189
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 125: Watcher
Capitulo
16
16. Watcher
190 Watcher
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 126: Tipos de objetos do Watcher
Manual do Usurio
Watcher 191
AV Player
O objeto Av! Player permite a reproduo de um arquivo .Av! no sistema. Este
objeto do Watcher normalmente associado a um objeto de tela Av!.
Figura 127: Propriedades do AVI Player
Propriedades do AVI Player
OPO DESCRIO
Nome
Determina o nome do objeto.
Descriao
Uma breve descrio do objeto.
Arquivo Av!
Determina o caminho do arquivo AVI.
Localizar
Permite navegar pelo disco para indicar o arquivo
AVI de origem.
192 Watcher
AV Recorder
O objeto Av! Recorder permite a gravao de uma entrada de vdeo (uma placa de
aquisio, por exemplo) em um arquivo formato .Av!.
Figura 128: Propriedades do AVI Recorder
Propriedades do AVI Recorder
OPO DESCRIO
Nome
Determina o nome do objeto.
Descriao
Uma breve descrio do objeto.
Arquivo Av!
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 video
Origem do vdeo a ser gravado.
Compressao
Determina como ser feita a compresso do AVI,
permitindo a escolha do compressor, qualidade e
outras configuraes.
Ouadros por segundo
Determina a taxa de atualizao com a qual ser feita
a gravao.
Manual do Usurio
Watcher 193
Frame grabber 8611
Atravs desta opo, possvel configurar as especificaes referentes a interface
com placa de aquisio (frame-grabber) S611 da Sensoray.
Figura 129: Propriedades da interface com a placa S611
194 Watcher
Propriedades da interface com a placa S611
OPO DESCRIO
Nome
Determina o nome do objeto.
Descriao
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.
Ouadros por segundo
Determina quantos quadros por segundo sero
gravados no objeto.
Manual do Usurio
Watcher 195
Frame grabber 8613
Atravs desta opo, possvel configurar as especificaes referentes a interface
com placa de aquisio S613 da Sensoray.
Figura 130: Propriedades da interface com a placa S613
196 Watcher
Propriedades da interface com a placa S613
OPO DESCRIO
Nome
Determina o nome do objeto.
Descriao
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.
Ouadros por segundo
Determina quantos quadros por segundo sero
gravados no objeto.
Compressao 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).
Manual do Usurio
Watcher 197
Dispositivos com 8uporte 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 131: Propriedades do Dispositivo com Suporte a Video for Windows
Propriedades do Dispositivo com Suporte a Video for Windows
OPO DESCRIO
Nome
Determina o nome do objeto
Descriao
Uma breve descrio do objeto.
Dispositivo de video
Determina a o dispositivo de video habilitado no
sistema.
Compressao de video
Habilita a compresso do video
visualizaao 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.
198 Watcher
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 132: Propriedades da Plca a de captura Xpress Plus
Propriedades da Plca a de captura Xpress Plus
OPO DESCRIO
Nome
Determina o nome do objeto.
Descriao
Uma breve descrio do objeto.
Numero de
Especifica o nmero de cmeras que sero inseridas
pelo boto !nserir Cameras. Permite criar objetos
que representaro as cmeras conectadas placa.
!nserir Cameras
Insere o nmero de objetos "Camera" especificado
em Numero 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.
Numero da Placa
Nmero de identificao da placa.
Manual do Usurio
Watcher 199
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 !nserir Cameras, mostrado no item anterior. Cada cmera tem trs conjuntos
de opes, a saber: Geral, Opes de Gravao e Mscara.
a) Propriedades Gerais
Figura 133: Propriedades gerais de cmeras Xpress Plus
Propriedades gerais de cmeras Xpress Plus
OPO DESCRIO
Nome
Determina o nome do objeto.
Descriao
Uma breve descrio do objeto.
Camera
Determina a cmera em foco.
Brilho
Determina o brilho da imagem da cmera.
Saturaao
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.
200 Watcher
b) Opes de Gravao
Atravs deste item possvel ajustar as opes de gravao da placa de captura.
Figura 134: Propriedades das Opes de Gravao
Manual do Usurio
Watcher 201
Propriedades das Opes de Gravao
OPO DESCRIO
Opoes de gravaao
Configura as opes de gravao da cmera:
- Habilitar gravaao: habilita a gravao na cmera
selecionada.
- Habilitar seqncia: habilita a gravao em
sequncia na cmera.
- Detecao de movimento: habilita a gravao na
cmera a cada deteco de movimento.
- Sem gatilho de prioridade: habilita a gravao
sem gatilho de prioridade.
- Gravaao por Gatilho: habilita a gravao por
gatilho.
Area
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.
OPS
Determina o QPS da gravao da cmera.
Opoes 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 no-
sensveis. As reas em verde-claro, as reas sensveis.
Steeplechase 203
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 135: Steeplechase
Capitulo
17
17. 8teeplechase
204 Steeplechase
Propriedades do Steeplechase
OPO DESCRIO
Nome
Determina o nome do objeto.
Scan
Determina o valor do scan.
!mportar Tags
Permite importar tags.
Wizard
Abre um wizard de configurao para o steeplechase.
Descriao
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).
versao
Determina a verso do objeto.
OPC Server 205
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 136: Objetos OPCServer no Organizer
Capitulo
18
18. OPC 8erver
206 OPC Server
18.1. Propriedades Gerais do OPC 8erver
Figura 137: Propriedades Gerais do OPC Server
Manual do Usurio
OPC Server 207
Propriedades Gerais do OPC Server
OPO DESCRIO
Nome
Determina o nome do objeto.
Nanter conexao 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.
Descriao
Uma breve descrio sobre o objeto.
Nome do Servidor
Determina qual o servidor OPC ao qual o objeto ir
se conectar.
versao
Informa a verso do servidor OPC.
!nformaoes do fabricante
Apresenta as informaes sobre o servidor OPC,
registradas pelo fabricante.
verificar servidor OPC a
cada ... segundos
Habilita a verificao do servidor OPC no perodo
(em segundos) determinado no campo.
Recuperar conexoes
perdidas a cada ...
segundos
Habilita a recuperao de conexes perdidas no
perodo (em segundos) determinado no campo. Obs.:
s vlida se a opo acima de verificao estiver
habilitada.
Habilita/Leituras de Fundo
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 significativas (ver 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 Norta
Percentual que especifica a faixa de variao
considerada no-significativa. Isto , variaes dentro
desse percentual no so notificadas pelo servidor ao
sistema. 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.
!mportar
Permite a importao de tags ou grupos de tags
definidos no servidor OPC. Obs.: este recurso pode
no estar disponvel no servidor OPC.
Log
Permite habilitar o registro (log) do servidor e definir
o nome e caminho do arquivo de log.
Novo Grupo
Cria um novo grupo no Driver. Um grupo permite ter
uma organizao hierrquica dos tags do servidor
OPC.
208 OPC Server
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 138: Propriedades de tags OPC
Manual do Usurio
OPC Server 209
Propriedades de Tags OPC
OPO DESCRIO
Nome
Determina o nome do tag OPC.
Descriao
Breve descrio sobre o tag.
Nome Real
Identificador do tag dentro do servidor OPC
(caminho).
Nodo de Leitura
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.
Ler do (a)
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.
Escala
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.
OPC !nferior
Define o valor mnimo a ser lido do servidor OPC.
Sistema !nferior
Define o novo valor mnimo para a converso dos
valores lidos.
OPC Superior
Define o valor mximo a ser lido do servidor
OPC.
Sistema Superior
Define o novo valor mximo para a converso dos
valores lidos.
Scan
Determina o valor do Scan.
Testar conexao aqui
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 pelo scan
Habilita a leitura peridica do tag OPC. O perodo
definido no campo Scan.
Habilita a escrita automatica
Habilita escrita automtica para o tag OPC.
Novo Elemento da Natriz!
Acrescenta elementos a um tag OPC tratado como
uma matriz (array). Permite a leitura de variveis
definidas como matrizes no servidor.
210 OPC Server
Pagina de alarmes
Figura 139: Pgina de alarmes
Manual do Usurio
OPC Server 211
Propriedades da Pgina de Alarmes
OPO DESCRIO
LoLo
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.
HiHi
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).
Comentarios
Um comentrio ou mensagem pode ser definido para
cada alarme.
Logar mensagens de
retorno
Habilita o registro (log) das mensagens de retorno de
alarme.
Grupo de Alarmes
Define o grupo de Alarmes do tag corrente. O grupo
de Alarmes deve ser definido na opo Alarmes do
Organizer.
Nanter 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.
212 OPC Server
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 140: Propriedades de Grupos OPC
Propriedades do Grupo OPC
OPO DESCRIO
Nome
Especifica o nome do objeto.
Descriao
Uma breve descrio do objeto.
Novo Grupo
Insere um novo Grupo OPC no objeto OPCServer.
!mportar
Permite importar tags ou grupos de tags definidos no servidor
OPC para o Grupo OPC em questo.
Manual do Usurio
OPC Server 213
Quando acionado o boto Importar tags, a janela abaixo mostrada. A partir da,
basta arrastar o tag desejado para o grupo selecionado.
Figura 141: Assistente de importao
Scripts 215
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.
Capitulo
19
19. 8cripts
216 Scripts
Eventos comuns em aplicaes no ElipseSCADA
OPO DESCRIO
OnKeyPress
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
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.
Manual do Usurio
Scripts 217
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 142: AppBrowser
Opes disponveis no App Browser
OPO DESCRIO
Seleao
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.
!nfo
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.
218 Scripts
19.3. Operadores e Constantes
Listamos as constantes (com suas notaes) e operadores que podem ser utilizados
nos scripts.
Constantes
TIPOS EXEMPLO
Inteiros (32 bits, dec) 1234, 1234d, -993
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 EXEMPLO
+ (adio) tag001 + 34
+ (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
OPERADOR EXEMPLO
8 (E bit-a-bit) flags & 0F000h
] (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 >> 2
(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
Manual do Usurio
Scripts 219
Precedncia de operadores {ordem de execuo}
A tabela abaixo lista as regras para precedncia e associao de todos os operadores.
+ - ~ NOT (operadores unrios)
**
/
+ -
>> <<
>= < <=
== <>
8
'
AND, XOR e OR
= += -= *= /= = 8= ]= '= **= <<= >>=
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 f...Else...Elsef...Endf
Permite a tomada de decises durante a execuo de um script.
Sintaxe:
220 Scripts
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.
Sintaxe:
Manual do Usurio
Scripts 221
While <condio>
<bloco de instrues>
Wend
A condiao 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 instruoes executado at a instruo Wend, quando, ento, a condio
avaliada novamente. O bloco de instruoes 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 condiao especificada uma expresso que pode ser avaliada como verdadeira
(diferente de zero) ou falsa (zero ou string vazio ""). O bloco de instruoes
executado e aps a condio avaliada. Se for falsa, o bloco de instruoes
repetido e a condio avaliada novamente. O bloco de instruoes 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.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.
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
222 Scripts
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("screw") // 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. O
parmetro x deve estar contido no intervalo [-1, 1], caso contrrio a funo retorna
zero.
Blue(Cor}
Retorna o valor do componente azul de Cor.
Ver funo Red().
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.
Manual do Usurio
Scripts 223
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"
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:
224 Scripts
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.
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:
Manual do Usurio
Scripts 225
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:
Execute("C:\WINDOWS\WINCALC.EXE")
Execute("C:\UTIL\PKZIP.EXE DATA C:\DATA\*.*")
Exp(x}
Retorna a funo exponencial de x.
Exemplo:
226 Scripts
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:
str = FileSelectWindow ("c:\Dados\",
"Arquivos de dados (*.dat)|*.dat|Todos os arquivos|*.*")
str = FileSelectWindow("c:\Imagens\",
"Arquivos de imagens|*.bmp;*.gif;*.jpg")
O parmetro type um inteiro que especifica a maneira que o arquivo ser
selecionado, de acordo com a tabela:
VALOR DESCRIO
0
Abre uma janela de seleo de arquivo; no permite que o usurio
digite nada, s escolher os arquivos existentes.
1
Permite o usurio criar um novo arquivo, digitando o nome do
arquivo a ser criado.
2
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.
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
Manual do Usurio
Scripts 227
parmetro atributos determina a soma dos atributos desejados no arquivo, segundo
a tabela:
VALOR ATRIBUTO
0
Normal, sem atributos
1
Somente leitura (read only)
2
Oculto (hidden)
+
Arquivo de sistema (system)
16
Diretrio (directory)
32
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.
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:
// 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")
228 Scripts
Format (strFormato, valor}
Retorna um valor no formato data/hora de acordo com a string strFormato. A string
valor especifica um formato data/hora (ex: "dd/mm/yy hh:mm:ss) e a data/hora e
retorna a funo GetTime().
As opes para esta funo so as seguintes:
Formatos Data/Hora para a funo Format
FORMATO SIGNIFICADO
w
Dia da semana (Dom Sab)
W
Dia da semana (DOM SAB)
ww
Dia da semana (Domingo Sbado)
WW
Dia da semana (DOMINGO SBADO)
d
Dia (1 31)
dd
Dia (01 31)
m
Ms (1 12)
mm
Ms (01 12)
mmm
Ms (Jan Dez)
NNN
Ms (JAN DEZ)
mmmm
Ms (Janeiro Dezembro)
NNNN
Ms (JANEIRO DEZEMBRO)
mmmmm
Ms (j d)
NNNNN
Ms (J D)
yy
Ano (00 99)
YY
Ano (1970 9999)
h
Hora (0 23)
hh
Hora (00 23)
m
Minuto (0 59) (deve estar acompanhando horas ou seguido de
segundos)
mm
Minuto (00 59) (deve estar acompanhando horas ou seguido de
segundos)
s
Segundo (0 59)
ss
Segundo (00 59)
AN/PN Hora no formato 12 horas, mostra AN (manh) e PN (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.
0
Dcimos de segundo (deve ser precedido de segundos)
Manual do Usurio
Scripts 229
00
Centsimos de segundo (deve ser precedido de segundos)
000
Milsimos de segundo (deve ser precedido de segundos)
]
Nova linha (CR + LF)
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))
230 Scripts
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:
day = GetDayOfYear(GetTime())
day = GetDayOfYear(MakeTime(9,2,1997,17,25,56))
// retorna 40
GetDispFreeSpace (strDiretrio}
Retorna o nmero total de Kbytes disponveis no caminho strDiretrio especificado.
GetFileAttributes (arquivo}
Retorna a soma dos atributos do arquivo atravs do parmetro arquivo, de acordo
com a seguinte tabela:
VALOR ATRIBUTO
-1 Erro
0 Normal
1 Somente Leitura (Read Only)
2 Oculto (Hidden)
4 Sistema (System)
8 Volume
16 Diretrio (Directory)
32 Arquivo-morto (Archive)
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.
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
Manual do Usurio
Scripts 231
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).
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
GetSecond (time}
Obtm os segundos a partir de um valor de tempo absoluto.
Exemplo:
232 Scripts
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().
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 expressao um
nmero. Retorna TRUE (diferente de zero) se for um nmero ou FALSE (zero) se
no for.
Exemplo:
Manual do Usurio
Scripts 233
tag001 = IsNumeric(1000) // retorna TRUE (1)
tag001 = IsNumeric("teste") // retorna FALSE (0)
tag001 = IsNumeric(GetTime()) // retorna TRUE (1)
IsString (expresso}
Verifica se o resultado da expresso informada no parmetro expressao 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") // retorna TRUE (1)
tag001 = IsString(GetTime()) // 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.
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.
234 Scripts
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 Descrio
day
1 a 31 (pode ser 28, 29 ou 30 conforme o ms e o ano)
month
1 a 12
year
1970 a 2039
hour
0 a 23
minute
0 a 59
second
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.
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.
Manual do Usurio
Scripts 235
Exemplo:
MessageBox ("Como est a Caixa de Mensagem?")
// Um string e' atribuido a um Tag
Mensagem = "Como est a Caixa de Mensagem?"
MessageBox(strMensagem)
Titulo: 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 HEXA DESCRIO
Application Nodal
0000h Voc deve responder a caixa de mensagem
para seguir usando a janela que a chamou.
Entretanto, voc pode ir para qualquer outra
janela.
System Nodal
1000h Todas as aplicaes ficam suspensas at que
voc responda esta caixa de mensagem.
usada para mensagens muito importantes.
Desk Nodal
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 HEXA DESCRIO
OK
0000h Aparecer somente o boto de OK na caixa
de mensagem
OK, Cancel
0001h Aparecero os botes OK e Cancel.
Abort, Retry, !gnore
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.
236 Scripts
Default para os botes
BOTES HEXA DESCRIO
Botao1 como default
0000h D o foco para o Boto 1.
Botao2 como default
0100h D o foco para o Boto 2.
Botao3 como default
0200h D o foco para o Boto 3.
cone
TIPO HEXA DESCRIO
Pare
0010h O cone um sinal de pare
Pergunta
0020h O cone um ponto de interrogao
Exclamaao
0030h O cone um ponto de exclamao
!nformaao
0040h O cone o caractere i dentro de um crculo
Valores de retorno
VALOR BOTO MENSAGEM
1
OK OK
2
Cancel Cancelar
3
Abort Abortar
4
Retry Tentar de novo
5
Ignore Ignorar
6
Yes Sim
7
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 (strTexto, nFirst, [nCount|}
Retorna parte de strTexto conforme os parmetros nFirst e nCount. nFirst
especifica a posio, no string, do primeiro caractere do substring que ser retornado
e nCount o nmero de caracteres do substring.
Manual do Usurio
Scripts 237
Exemplo:
strSenha = Mid('Password',1,3) // retorna 'Pas'
strSenha = Mid('Password',4,4) // retorna 'swor'
strSenha = Mid('Password',3) // 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) // Resulta " abc "
PadC("abcdefghij",5) // 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:
PadL("abc",5) // Resulta " abc"
PadL("abcdefghij",5) // Resulta "abcde"
PadL("abc",8,"-") // Resulta "-----abc"
238 Scripts
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 sound!ndex (inteiro entre 0 e 5) de acordo
com a tabela abaixo:
NDICE DESCRIO
0
Bipe usando o alto-falante interno do computador
1
Asterisco (observao)
2
Exclamao
3
Mo (ateno)
+
Questo
5
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
omitidos, todo o arquivo ser tocado. O processo pode ser parado chamando a
funo StopWave().
Manual do Usurio
Scripts 239
Exemplo:
PlayWave("tada.wav",2000,5000)
// Toca o arquivo do segundo 2 at o 5
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 pos!nicio (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 strSeao 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:
240 Scripts
[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 Write!ni
(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 strSeao e strEntrada especificam a seo e a entrada do respectivo
arquivo. Se a entrada no for encontradaI, o strvalorPadrao retornado, ou um
string nulo ("") se strvalorPadrao no for especificado.
Real (string}
Converte um string numrico ou um nmero para um nmero real.
Exemplo:
Manual do Usurio
Scripts 241
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 SetNouseCapture(). 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 OnNouseOver 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.
242 Scripts
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 strExpressao 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.
Manual do Usurio
Scripts 243
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 NakeTime() 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. Ao invs disso, 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 uma operao strOperaao para o arquivo strArquivo especificado.
strOperaao pode ser um dos seguintes comandos: "edit" (editar), "explore"
(explorar), "find" (buscar), "open" (abrir), "print" (imprimir) ou "properties"
(propriedades). strParametros um string que especifica os parmetros que devem
ser passados para a aplicao. strDir define o diretrio padro. 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.
Sin (angle}
Retorna o seno do ngulo especificado. O ngulo angle expresso em radianos.
244 Scripts
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 sound!ndex na freqncia especificada em frequency
(em milisegundos) at um comando StopSound ser chamado. sound!ndex 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().
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
Manual do Usurio
Scripts 245
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
strSeao 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 Write!ni (strFile, "", "", "")
depois de ler o arquivo .INI.
O exemplo abaixo escreve as seguintes linhas em MYAPP.INI:
[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 operaao opcional e possui as seguintes especificaes:
246 Scripts
MODO DESCRIO
0
(default) Cria o arquivo se no existir, colocando a string no fim do
arquivo.
1
Falha se o arquivo no existir, colocando a string no final do arquivo.
2
Cria o arquivo se no existir, substituindo o arquivo por uma nova
string.
3
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:
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
Manual do Usurio
Scripts 247
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 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.
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 que seja reiniciado o micro via programao Script. Termina a aplicao
atual e fecha-a abaixo o computador. O parmetro modoDesligamento pode ser: 1
(parada programada), 2 (parada programada forada), 3 (reboot) ou 4 (reboot
forado). Uma parada forada ou um reboot forado indicam que todos os outros
248 Scripts
programas em execuo (exceto Elipse) imediatamente sero terminados e no ser
possvel salvar nenhuma alterao.
Exemplo:
// Parada programada normal do Windows
Application.ShutdownWindows(1)
OBS: Quando a aplicao rodada no modo Configurador, ele simplesmente pra a
aplicao. Quando a aplicao rodada no modo Runtime, o aplicativo parado e o
micro 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.
19.5.3. Funes de Tags
Funes Comuns
EditProperties(}
Abre uma janela que permite a edio das propriedades do tag.
GetAt (index}
Retorna o valor do elemento index de um bloco.
Exemplo:
Tag1.GetAt(3)
Read (}
L um valor do PLC diretamente para o Tag.
Manual do Usurio
Scripts 249
SetAt (index, value}
Atribui um valor ao elemento de um bloco, somente se o atributo autoWrite estiver
habilitado. Retorna verdadeiro (diferente de zero) se a operao for efetuada com
sucesso ou falso (zero) se no for.
Exemplo:
Tag1.SetAt(3, 3.44)
Write (}
Escreve o valor de um Tag diretamente no PLC.
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, columa}
Retorna o valor (numrico ou string) de uma determinada clula da matriz
especificada pela linha row e columa column.
Exemplo:
250 Scripts
// 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.
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
linha!nferior 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
EditProperties(}
Abre a janela de edio das propriedades do tem.
Reset(}
Zera o acumulador.
Manual do Usurio
Scripts 251
Funes de Tags Bloco
GetAt(ndice}
Pega o valor armazenado em um elemento de bloco. O atributo indice indica o
ndice do elemento do tag bloco. Ateno: esta funo no pode ser usada em
verses limitadas (verses Lite) do Elipse SCADA.
Exemplo:
// 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, retorna 1 se lido sucedido, e 0 se falhar. Usa o
bloco e verifica a documentao do bloco. Esta uma funo synchronous, espera
at que a operao lida esteja terminada antes de retornar a execuo da
especificao, pois ele pode seriamente degradar o desempenho da aplicao,
conseqentemente voc deve us-la 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 indice 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.
252 Scripts
Write (}
Escreve os valores atuais do bloco ao PLC imediatamente, retorna 1, se a escrita for
bem sucedida, e 0, se falhar. Usa o bloco que escreve o servio do I/O, verificando a
documentao do bloco.
Funes de Elementos de Bloco
Read(}
L o elemento de um tag bloco PLC. Retorna 1 (um) se lido, e 0 (zero) se falhar.
Ateno: esta uma funo sncrona, espera at que a operao lida esteja terminada
antes de retornar a execuo. Ela pode seriamente degradar o desempenho da
aplicao, conseqentemente deve ser usada quando for absolutamente necessrio.
Write(}
Escreve o valor atual do elemento do bloco ao PLC imediatamente, retornando 1
(um) se a escrita ser bem sucedida, ou 0 (zero) se falhar. Usa o bloco para escreve o
servio do elemento do I/O, verifica se suportar o elemento do bloco escrever.
Ateno: Esta uma funo sncrona, espera at que a operao lida esteja
terminada antes de retornar a execuo. Ela pode seriamente degradar o desempenho
da aplicao, conseqentemente deve ser usada quando for absolutamente
necessrio.
WriteEx(valor}
Escreve o valor diretamente ao I/O, sem atribu-lo ao Elemento de Bloco. Esta
funo usa a escala definida no Elemento de Bloco .
Exemplo:
Block1.elm000.WriteEx(12)
Funes de Tags OPC
Read(}
L o valor do servidor OPC.
Write(}
Escreve o valor no tag para o servidor OPC.
Manual do Usurio
Scripts 253
Funes de Tags PLC
Read(}
L o Tag o PLC imediatamente, retorna 1 se for bem sucedido, 0 se falhar. Usa o
Tag leu o servio do driver do I/O, verifica a documentao do driver se suportar o
Tag ler. Ateno: esta uma funo sncrona, espera at que a operao lida esteja
terminada antes de retornar a execuo. Ela pode seriamente degradar 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 for bem
sucedida e 0 se falhar. Usa o Tag escreve o servio do driver I/O, verifica a
documentao do driver se suportar o Tag escrever. Ateno: esta uma funo
sncrona, espera at que a operao lida esteja terminada antes de retornar a
execuo. Ela pode seriamente degradar 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.
19.5.4. Funes de Tela
Activate(}
Mostra uma tela dando o foco para ela.
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.
254 Scripts
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:
Manual do Usurio
Scripts 255
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.
256 Scripts
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 DESCRIO
Checkvalue
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
!nitialvalue
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 GetColorZone!nfo(). valor o novo valor
a ser atribudo ao campo.
Manual do Usurio
Scripts 257
Funes de Objetos AV
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 bar!ndex 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.
258 Scripts
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.
GetLoLoLimit(index}
GetLowLimit(index}
GetHighLimit(index}
GetHiHiLimit(index}
Retorna o limite da zona especfica em um Bar Gauge.
Manual do Usurio
Scripts 259
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.
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.
SetRecordRange(primeiroReg, ltimoReg}
Define um intervalo de registros a ser carregado no Browser.
260 Scripts
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.
UpdateOuery(}
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.
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 Videon
Pause (}
Pausa a reproduo do video.
Manual do Usurio
Scripts 261
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
0
Arquivo RAW (salva o quadro atual no disco, sem nenhuma converso.
1
Formato BMP.
2
Formato GIF (limitado a uma paleta de 256 cores).
3
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.
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.
GetColorZoneInfo(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:
262 Scripts
Valores possveis
CAMPO DESCRIO
Comment
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:
// 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.Get!nfo().
Exemplo:
Manual do Usurio
Scripts 263
// 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:
264 Scripts
Parmetros
CAMPO DESCRIO
id
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.
strComentario
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
Manual do Usurio
Scripts 265
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 titulo 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)
CreateNewRecord(description}
Cria um novo registro no arquivo de Receitas conforme o parmetro description,
retornando o ndice do registro no arquivo.
266 Scripts
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.
Exemplo:
// Copiando uma receita
DIM nRecord
nRecord = Recipe1.ChooseRecipe("Recipes", -1)
IF nRecord > 0
Recipe1.CopyRecord(nRecord)
ENDIF
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:
// Carrega o quarto registro de Receitas
Receitas.LoadRecipe(4)
Manual do Usurio
Scripts 267
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
0
Ano
1
Ms
2
Semana
3
Dia
+
Hora
5
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.
Edit(}
Edita o registro corrente sem escrev-lo em disco. Para escrev-lo use a funo
Update().
268 Scripts
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.
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.
Manual do Usurio
Scripts 269
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.
19.5.9. Funes da Analise 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.
270 Scripts
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
bNostraJanelaProgresso=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.
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 bShowErrorNessages 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,
Manual do Usurio
Scripts 271
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 valorNin e valorNax 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|, [bIndicarProgres|}
Imprime os dados de um arquivo Histrico ou de Alarmes para um arquivo texto
especificado pelo nome no parmetro fileName.
O parmetro b!mprimeCabealho 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 b!mprimeCabealho
como 1 e o atributo B!mprimeCabealho 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 b!ndicarProgress habilita (1) ou desabilita (0) mostrar uma barra de
progresso enquanto o relatrio impresso (este parmetro opcional e o valor
default 0).
Exemplo:
272 Scripts
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:
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)
ShowDate(bShow}
Mostra a data na rgua inferior do grfico, quando o parmetro bShow igual a 1.
Se bShow igual a 0 no mostra a data.
Manual do Usurio
Scripts 273
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
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.
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.
274 Scripts
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
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 = 0, retorna o tipo de comunicao que causou o erro:
0 = nenhum erro;
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 ou B1 a B4 do Tag PLC ou
Bloco que causou o erro.
Reload(}
Recarrega o driver do disco. No retorna nenhum valor caso ocorra um erro.
Manual do Usurio
Scripts 275
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().
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.
276 Scripts
19.5.15. Funes de Database
AddRecord (bUpdateOuery}
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
bUpdateOuery indica se a consulta (query) deve ser atualizada depois de adicionar-
se 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.
Manual do Usurio
Scripts 277
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.)
278 Scripts
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:
VALOR ATRIBUTO
-1
A tabela no est conectada (fechada).
0
Nenhuma edio em progresso.
1
O registro est sendo modificado.
2
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.)
Manual do Usurio
Scripts 279
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
strCondiao. O parmetro bNovePara!nicio um valor booleano que define se a
procura deve comear a partir do primeiro registro do banco de dados
(bNovePara!nicio = 1) ou do registro atual (bNovePara!nicio = 0).
Exemplo:
// Localiza o primeiro registro que atenda a expresso
// a partir do registro atual
Database1.Locate("temp = tag001 * tag002", 0)
280 Scripts
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.
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.
Manual do Usurio
Scripts 281
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()
SOLOuery(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
opcional.
Exemplos:
// Procura todos os registros que possuem
// "Maria" no campo nome, em ordem ascendente
Database1.SQLQuery("nome = 'Maria'","nome")
282 Scripts
// 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 = #08/03/2004#")
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.
Manual do Usurio
Scripts 283
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.
GetFile(serverFile, clientFile}
Obtm um arquivo do servidor com o nome serverFile e faz uma cpia deste para
um arquivo local com nome clientFile.
284 Scripts
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;
day: Um inteiro contendo o dia do sistema;
Manual do Usurio
Scripts 285
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
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;
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 ;
286 Scripts
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;
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;
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.
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).
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
.
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
Manual do Usurio
Scripts 287
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;
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;
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.
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).
288 Scripts
numPadTitleBarText: Atributo string, permite indicar um texto para a barra de
ttulo do Numeric Pad (vazio, por default).
numPadTitleBarText: Atributo string, permite indicar um texto para a barra de
ttulo do Key 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.
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
Manual do Usurio
Scripts 289
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.
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.
19.6.3. Atributos dos 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.
enableAlternateName: (booleano) Habilita utilizar um nome alternativo
(indicado no atributo alternateName) para o registro (log) de alarmes do tag.
290 Scripts
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 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;
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;
Manual do Usurio
Scripts 291
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.
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
292 Scripts
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;
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:
Manual do Usurio
Scripts 293
Tipos de variao
NOME VALOR DESCRIO
Randmico
0
Dados variando randomicamente
Senoidal
1
Dados variando conforme uma funo seno
Onda Ouadrada
2
Dados alternam entre dois valores
Rampa de Subida
3
Um grfico tipo dente de serra onde os
dados variam de um limite mais baixo para
um mais alto
Triangular
4
Um grfico tipo dente de serra onde os
dados variam entre dois limites
Rampa de Descida
5
Um grfico tipo dente de serra onde os
dados variam de um limite mais alto para
um mais baixo
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.
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.
294 Scripts
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.
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.
Manual do Usurio
Scripts 295
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.
name: O identificador usado para referncia do item.
enable: Habilita/Desabilita cronmetro.
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.
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 ;
296 Scripts
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
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 ;
Manual do Usurio
Scripts 297
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 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;
298 Scripts
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.
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 .
ampm: (booleano) Determina se a coluna de hora do Alarme ser mostrada no
sistema (ingls) de 12 horas. Verdadeiro (diferente de zero), 12 horas; falso (zero)
24 horas.
Manual do Usurio
Scripts 299
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 .
dateFormat: Inteiro sem sinal (de 0 a 7) configurando o formato da data para o
objeto Alarme conforme a tabela a seguir:
VALOR FORMATO
0
MM/DD (03/27)
1
MMM DD (Mar 27)
2
MM/DD/YY (03/27/96)
3
MMM DD YYYY (Mar 27 1996)
+
DD/MM (27/03)
5
DD MMM (27 Mar)
6
DD/MM/YY (27/03/96)
/
DD MMM YYYY (27 Mar 1996)
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.
enableAlarms: (booleano) Se verdadeiro (diferente de zero), Determina que
todos os alarmes de um grupo de Alarmes esto habilitados.
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.
300 Scripts
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;
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 .
timeFormat: Inteiro sem sinal (de 0 a 2) configurando o formato da hora para o
objeto Alarme conforme a tabela a seguir:
VALOR FORMATO
0 HH:MM (14:33)
1 HH:MM:SS (14:33:47)
2 MM:SS (33:47)
Manual do Usurio
Scripts 301
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).
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.
302 Scripts
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"
enabled: Um atributo booleano usado para habilitar o acesso do teclado e mouse
ao objeto Animao. 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 da Animao,
em pixels. usado juntamente com o atributo width para definir o tamanho da
Animao;
name: Um string contendo o nome da Animao, usado como identificador da
Animao.
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;
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 ;
visible: Um atributo booleano determinando que a Animao seja visvel.
Retorna verdadeiro (diferente de zero) se a Animao visvel ou falso (zero) se no
;
width: Um inteiro sem sinal (de 0 a 65535) determinando a largura da
Animao, em pixels. usado juntamente com o atributo height para definir o
tamanho da Animao;
x: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X para
o canto superior esquerdo da Animao, em pixels. usado juntamente com o
atributo Y para definir a posio do canto superior esquerdo da Animao a partir da
origem da Tela (0,0);
Manual do Usurio
Scripts 303
y: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada Y para
o canto superior esquerdo da Animao, em pixels. usado juntamente com o
atributo X para definir a posio do canto superior esquerdo da Animao a partir da
origem da Tela (0,0);
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.
enabled: Um atributo booleano usado para habilitar o acesso do teclado e mouse
ao objeto Barra. Retorna verdadeiro (diferente de zero) se o acesso 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;
304 Scripts
height: Um inteiro sem sinal (de 0 a 65535) determinando a altura da Barra, em
pixels. usado juntamente com o atributo width para definir o tamanho do Grfico
de Barras;
label: Um string contendo a unidade de medida a ser mostrada na rgua.
Exemplo: Barra1.label = "MHz"
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;
Manual do Usurio
Scripts 305
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;
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;
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 ;
visible: Um atributo booleano determinando a visibilidade do grfico de barras.
Retorna verdadeiro (diferente de zero) se o grfico de barras est visvel ou falso
(zero) se no est.
width: Um inteiro sem sinal (de 0 a 65535) determinando a largura do Grfico
de Barras, em pixels. usado juntamente com o atributo height para definir o
tamanho da Barra.
x: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X para
o canto superior esquerdo do Grfico de Barras, em pixels. usado juntamente com
o atributo Y para definir a posio do canto superior esquerdo da Barra 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 Grfico de Barras, em pixels. usado juntamente com
o atributo X para definir a posio do canto superior esquerdo da Barra a partir da
origem da Tela (0,0).
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
306 Scripts
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;
enabled: Um atributo booleano usado para habilitar o acesso do teclado e mouse
ao objeto Browser. Retorna verdadeiro (diferente de zero) se o acesso est habilitado
ou falso (zero) se no est;
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;
height: Um inteiro sem sinal (de 0 a 65535) determinando a altura do Browser,
em pixels. usado juntamente com o atributo width para definir o tamanho do
Browser;
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;
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;
Manual do Usurio
Scripts 307
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;
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).
visible: Um atributo booleano determinando que o Browser seja visvel. Retorna
verdadeiro (diferente de zero) se o Browser visvel ou falso (zero) se no ;
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).
width: Um inteiro sem sinal (de 0 a 65535) determinando a largura do Browser,
em pixels. usado juntamente com o atributo height para definir o tamanho do
Browser;
x: Um inteiro com sinal (de -32768 a 32767) determinando a coordenada X para
o canto superior esquerdo do Browser, em pixels. usado juntamente com o atributo
Y para definir a posio do canto superior esquerdo do Browser 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 Browser, em pixels. usado juntamente com o atributo
X para definir a posio do canto superior esquerdo do Browser a partir da origem da
Tela (0,0);
Atributos do Boto
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);
308 Scripts
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 = +
buttonType = 5
buttonType = 6
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;
description: Um string contendo uma breve descrio sobre o Boto;
enabled: Um atributo booleano usado para habilitar o acesso do teclado e mouse
ao objeto Boto. Retorna verdadeiro (diferente de zero) se o acesso est habilitado
ou falso (zero) se no est;
goToScreen: Somente para uso do Elipse SCADA. No so permitidas
modificaes por parte de usurios.
height: Um inteiro sem sinal (de 0 a 65535) determinando a altura do Boto, em
pixels. usado juntamente com o atributo width para definir o tamanho do Boto;
Manual do Usurio
Scripts 309
name: Um string contendo o nome do Boto, usado como identificador do
Boto;
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;
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
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);
310 Scripts
Atributos do Display
name: Um string contendo o nome do Display, usado como identificador do
Display;
description: Um string contendo uma breve descrio sobre o Display;
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);
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;
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;
visible: Um atributo booleano determinando que o Display seja visvel. Retorna
verdadeiro (diferente de zero) se o Display visvel ou falso (zero) se no ;
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;
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;
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 ALINHAMENTO
0 Esquerda
1 Centro
2 Direita
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:
Manual do Usurio
Scripts 311
VALOR ALINHAMENTO
0 Topo
1 Centro
2 Abaixo
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;
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;
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).
size: Um inteiro sem sinal (de 0 a 255) determinando o tamanho dos dados a
serem mostrados no 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;
suffix: Um string contendo um sufixo a ser mostrado depois do valor do Tag
associado ao Display;
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;
Atributos do Gauge
name: Um string contendo o nome do Gauge, usado como identificador do
Gauge;
description: Um string contendo uma breve descrio sobre o Gauge;
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
312 Scripts
X para definir a posio do canto superior esquerdo do Gauge a partir da origem da
Tela (0,0);
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;
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;
visible: Um atributo booleano determinando que o Gauge seja visvel. Retorna
verdadeiro (diferente de zero) se o Gauge visvel ou falso (zero) se no ;
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;
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;
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.
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 ;
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;
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;
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;
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;
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;
Manual do Usurio
Scripts 313
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;
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;
startAngle: Um nmero real configurando o ngulo inicial da agulha do Gauge;
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
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);
decimalPlaces: Um inteiro sem sinal (de 0 a 65535) determinando o nmero de
casas decimais a serem utilizadas na formatao dos valores do Gauge.
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;
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;
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;
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;
314 Scripts
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;
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;
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;
totalNumberOfSubticks: Um inteiro sem sinal (de 0 a 9) determinando o
nmero total de sub-marcas a serem mostradas entre as marcas principais.
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;
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 ;
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;
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;
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 ;
lowLowDiv: Um nmero real configurando o valor do limite superior do
intervalo Low-Low;
lowLowColorLegend: 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-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;
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 ;
lowDiv: Um nmero real configurando o valor do limite superior do intervalo
Low;
Manual do Usurio
Scripts 315
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;
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 ;
hiDiv: Um nmero real configurando o valor do limite inferior do intervalo
High;
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;
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 ;
hiHiDiv: Um nmero real configurando o valor do limite inferior do intervalo
High-High;
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;
Atributos do 8etpoint
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.
316 Scripts
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".
Formatos Data/Hora para o atributo dateFormat
FORMATO SIGNIFICADO
w
Dia da semana (Dom Sab)
W
Dia da semana (DOM SAB)
ww
Dia da semana (Domingo Sbado)
WW
Dia da semana (DOMINGO SBADO)
d
Dia (1 31)
dd
Dia (01 31)
m
Ms (1 12)
mm
Ms (01 12)
mmm
Ms (Jan Dez)
NNN
Ms (JAN DEZ)
mmmm
Ms (Janeiro Dezembro)
NNNN
Ms (JANEIRO DEZEMBRO)
mmmmm
Ms (j d)
NNNNN
Ms (J D)
Yy
Ano (00 99)
YY
Ano (1970 9999)
H
Hora (0 23)
Hh
Hora (00 23)
N
Minuto (0 59) (deve estar acompanhando hs ou seguido de seg.)
mm
Minuto (00 59) (deve estar acompanhando hs ou seguido de seg.)
S
Segundo (0 59)
Ss
Segundo (00 59)
AN/PN Hora no formato 12 horas, mostra AN (manh) e PN (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.
0
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)
Manual do Usurio
Scripts 317
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.
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.
318 Scripts
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
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 8lider
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;
Manual do Usurio
Scripts 319
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.
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;
320 Scripts
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);
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;
Manual do Usurio
Scripts 321
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);
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 ORIENTAO
0
Horizontal, da direita para esquerda
1
Horizontal, da esquerda para direita
2
Vertical, de cima para baixo
3
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);
322 Scripts
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
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
Manual do Usurio
Scripts 323
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 ;
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 ;
324 Scripts
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;
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;
Manual do Usurio
Scripts 325
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.
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:
VALOR ESTILO
0
Sem seleo.
1
A seleo um ponto.
2
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).
326 Scripts
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.
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
0
Slido
1
Tracejado
2
Pontilhado
3
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;
Manual do Usurio
Scripts 327
Atributos da Marca
name: Um string contendo o nome da Marca, usado como identificador da
Marca;
description: Um string contendo uma breve descrio sobre a Marca;
penVisible: Um atributo booleano determinando que a Marca seja mostrada.
Retorna verdadeiro (diferente de zero) se a Marca mostrada ou falso (zero) se no
;
markType: Um inteiro sem sinal (de 0 a 2) determinando o tipo da Marca,
conforme a tabela a seguir:
VALOR TIPO
0 Ponto
1 Vertical
2 Horizontal
penStyle: Um inteiro sem sinal (de 0 a 4) determinando o estilo da Marca,
conforme a tabela a seguir:
VALOR ESTILO
0
Slido
1
Tracejado
2
Pontilhado
3
Trao-Ponto
Trao-Ponto-Ponto
penWidth: Um inteiro sem sinal (from 0 to 65535) determinando a largura da
Marca em pixels;
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;
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);
328 Scripts
19.6.7. Atributos de Alarmes
name: Um string contendo o nome do Alarme, usado como identificador do
Alarme;
description: Um string contendo uma breve descrio sobre o Alarme;
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;
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.
filename: Um string contendo o nome do arquivo de log de Alarmes;
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;
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.
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;
lastAlarmPri: Um inteiro sem sinal (de 0 a 65535) informando a prioridade do
ltimo alarme ativado. um atributo somente de leitura.
19.6.8. Atributos das Receitas
name: Um string contendo o nome da Receita, usado como identificador da
Receita;
description: Um string contendo uma breve descrio sobre o Receita;
19.6.9. Atributos dos Histricos
name: Um string contendo o nome do Histrico, usado como identificador do
Histrico;
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;
Manual do Usurio
Scripts 329
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 2
32
) determinando a frequncia
com que os dados sero escritos no arquivo de Histrico;
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;
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;
networkSupport: Um atributo booleano usado para habilitar 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. Retorna verdadeiro (diferente de zero) se o suporte a rede est
habilitado ou falso (zero) se no est;
19.6.10. Atributos da Analise Histrica
name: Um string contendo o nome da Anlise Histrica, usado como
identificador da Anlise;
description: Um string contendo uma breve descrio sobre a Anlise Histrica;
advised: Este atributo somente para leitura e no faz sentido para a Anlise
Histrica;
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 ;
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 PGINAS
0
Mostra todas as pginas
1
Mostra somente a pgina da Anlise (Grfico)
2
Mostra somente as pginas selecionadas
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 ;
330 Scripts
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 ;
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 ;
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 ;
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 ;
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 ;
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;
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;
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;
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 UpdateOuery() 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;
Manual do Usurio
Scripts 331
finalMonth: um inteiro sem sinal (de 1 a 12) determinando o ms final quando o
tipo de Consulta por Intervalo de Tempo;
finalYear: um inteiro sem sinal (de 1970 a 2039) determinando o ano 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;
finalSecond: um inteiro sem sinal (de 0 a 59) determinando o segundo 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 TIPO DA CONSULTA
0
Intervalo de Tempo
1
Dados mais Recentes
2
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 FORMATO
0
Dia
1
Ms
2
Ano
3
Horas
+
Minutos
5
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;
startMonth: um inteiro sem sinal (de 1 a 12) determinando o ms inicial quando
o tipo de consulta por Intervalo de Tempo;
332 Scripts
startYear: um inteiro sem sinal (de 1970 a 2039) determinando o ano 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;
startSecond: um inteiro sem sinal (de 0 a 59) determinando o segundo inicial
quando o tipo de Consulta por Intervalo de Tempo;
19.6.12. Atributos do CEP {8PC}
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.
Manual do Usurio
Scripts 333
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;
19.6.13. Atributos da Batelada
name: Um string contendo o nome da Batelada, usado como identificador 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).
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;
334 Scripts
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;
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;
Manual do Usurio
Scripts 335
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;
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;
336 Scripts
19.6.16. Atributos de Database
name: Um string contendo o nome da database, usado como identificador do
Banco de Dados.
description: Um string contendo uma breve descrio sobre o Banco de Dados.
lastErrorStr: Um string contendo a descrio do ltimo erro ocorrido em
operaes com o Banco de Dados.
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.
filter: Um string ou valor usado como filtro quando feita uma consulta no
Banco de Dados.
directory: Determina o diretrio do Database.
lastErrorStr: Descreve os erros ocorridos no database.
originalTableName: Especifica as informaes referentes a tabela do database.
Atributos de campos de Databases
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 Usuarios
name: Um string contendo o nome do Usurio, usado como identificador do
Usurio.
description: Um string contendo uma breve descrio sobre o Usurio.
19.6.18. Atributos da Aplicao Remota
name: Um string contendo o nome da Aplicao Remota, usado como
identificador 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;
Manual do Usurio
Scripts 337
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;
Atributos do Arquivo Remoto
bytesDone: Um inteiro sem sinal (de 0 a 2
32
) 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 EVENTO
0
Transferncia OK
1
No conseguiu abrir ou criar arquivo do cliente
2
Arquivo do servidor no foi encontrado.
3
Dados invlidos recebidos do servidor durante conexo
+
Bloco fora de sequncia recebido do servidor
5
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 EVENTO
-1
Nenhuma transferncia foi efetuada
0
ltima transferncia falhou
1
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 EVENTO
0
Nenhuma transferncia em andamento
1
Conectando
2
Comparando arquivos
3
Transferindo
totalLength: Um inteiro sem sinal (de 0 a 2
32
) determinando o nmero de bytes
a comparar / transferir (somente leitura).
338 Scripts
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).
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 DESCRIO
0
Indica que no h alarmes ativos.
1
Alarme de nvel LOLO
2
Alarme de nvel LOW
3
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.
Manual do Usurio
Scripts 339
Atributos da Cmera do Video Remoto
bitsPerPixel: Determina o nmero de bits necessrios para armazenar cada pixel
da imagem.
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 DESCRIO
1
Velocidade normal frente
-1
Velocidade normal para trs
340 Scripts
19.6.19. Atributos do Watcher
Atributos comuns
name: Um string contendo o nome do Watcher, usado como identificador.
description: Um string contendo uma breve descrio sobre o Watcher.
Atributos do objeto AV 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 AV 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 8611
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).
custonWidth: Determina a largura da imagem, em pixels (para escala avanada).
Manual do Usurio
Scripts 341
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 DESCRIO
0
Imagem no entrelaada
1
Imagem entrelaada
scale: Define o tamanho da imagem.
Atributos da Placa 8613
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
0
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
0
Sem compresso
1
MJPEG
customHeight: Determina a altura da imagem, em pixels (para escala avanada).
customWidth: Determina a largura da imagem, em pixels (para escala
avanada).
description: Descrio do objeto.
342 Scripts
format: Determina o formato da imagem (PAL-M, NTSC, etc).
frameRate: Determina o nmero de quadros a capturar, por segundo.
imput: 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 8teeplechase
server: (string) Contm o nome do servidor Steeplechase.
scan: (inteiro) Tempo de varredura e atualizao do Steeplechase (em
milisegundos).
Manual do Usurio
Scripts 343
19.6.21. Atributos do OPC8erver
vrfyTime: (inteiro) Especifica o perodo de tempo (em milissegundos) em que o
sistema deve verificar se o servidor est ativo.
totalAlarms: (inteiro) Indica o nmero total de alarmes ativos em um grupo de
tags OPC.
Suporte a DDE 345
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 8CADA 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 143: Pgina de configurao do tag DDE
Capitulo
20
20. 8uporte a DDE
346 Suporte a DDE
Os campos Nome do Servidor, Tpico e !tem 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 Conexao|.
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 DESCRIO
Nome do Servidor Excel
Tpico [Plan1.xls]Plan1
Item L1C1
NOTA: Para verses ou linguagens diferentes do software, tpicos e itens podem
mudar.
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.
Manual do Usurio
Suporte a DDE 347
20.2. Elipse 8CADA como 8ervidor
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:
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".