Você está na página 1de 342

ELIPSEE3

SISTEMA DE SUPERVISO E CONTROLE

Manual E3

Verso 1.00.019 2002 Elipse Software Ltda. Todos os direitos reservados.

ndice
1. INTRODUO............................................................................................................................................................................ 7 1.1. Descrio Geral................................................................................................................................................................... 8 1.2. Arquitetura de Projetos........................................................................................................................................................ 9 1.3. Mdulos e verses do sistema.......................................................................................................................................... 10 1.4. Outras informaes........................................................................................................................................................... 11 1.5. Novidades da Verso........................................................................................................................................................ 11 2. ELIPSE SCADA X E3.............................................................................................................................................................. 12 3. INSTALAO........................................................................................................................................................................... 13 1.6. Requisitos do sistema....................................................................................................................................................... 13 1.7. Instrues de Instalao................................................................................................................................................... 14 1.8. Atualizao das verses................................................................................................................................................... 15 1.9. Sobre o Hardkey................................................................................................................................................................ 16 1.9.1. Atualizao do Hardkey.............................................................................................................................................. 16 4. INICIANDO O E3...................................................................................................................................................................... 17 1.10. Iniciando um projeto........................................................................................................................................................ 18 1.11. rea de Trabalho............................................................................................................................................................. 18 1.11.1. Barra de Menus........................................................................................................................................................ 19 1.11.2. Barra de Ferramentas.............................................................................................................................................. 19 1.12. Configurao do Studio................................................................................................................................................... 33 1.12.1. Ferramentas.............................................................................................................................................................. 36 1.12.2. Barra de Execuo do Projeto................................................................................................................................. 37 1.12.3. Organizer.................................................................................................................................................................. 39 1.12.4. Propriedades............................................................................................................................................................. 46 1.12.5. Eventos..................................................................................................................................................................... 51 1.12.6. Mtodos.................................................................................................................................................................... 51 1.13. App Browser.................................................................................................................................................................... 52 1.14. Links ................................................................................................................................................................................ 53 5. DOMNIOS................................................................................................................................................................................ 55 1.15. Execuo do Domnio..................................................................................................................................................... 57 1.16. Configurao do Domnio................................................................................................................................................ 58 1.16.1. Na Barra de Ferramentas Padro............................................................................................................................ 58 1.16.2. No Organizer............................................................................................................................................................. 59 1.16.3. Configuraes do domnio via E3Server................................................................................................................. 61 1.16.4. Opes...................................................................................................................................................................... 62 1.16.5. Projetos..................................................................................................................................................................... 65 1.16.6. Servidores................................................................................................................................................................. 65 1.16.7. Licenas.................................................................................................................................................................... 67 1.16.8. Monitor...................................................................................................................................................................... 68 1.17. Hot-StandBy no E3.......................................................................................................................................................... 69 1.17.1. Executando um Domnio Distribudo........................................................................................................................ 70 1.17.2. Parando um Domnio Distribudo............................................................................................................................. 70 1.17.3. Parando um dos Servidores do Domnio................................................................................................................. 71 1.17.4. Tempo de troca entre Servidores............................................................................................................................. 71 1.17.5. Reconexo de Viewers............................................................................................................................................. 71 1.18. Conectar a ...................................................................................................................................................................... 71 1.19. Senhas............................................................................................................................................................................. 72 1.19.1. Permisses............................................................................................................................................................... 73 1.19.2. Usurios.................................................................................................................................................................... 75 1.19.3. Grupos...................................................................................................................................................................... 76 1.20. E3WebViewer.................................................................................................................................................................. 77 1.20.1. Instalao do IIS....................................................................................................................................................... 78 1.20.2. Configurao do IIS.................................................................................................................................................. 79 1.20.3. Visualizando a aplicao.......................................................................................................................................... 81 1.20.4. Visualizando a aplicao Localmente...................................................................................................................... 83 6. DRIVERS E TAGS ................................................................................................................................................................... 84 1.21. Tags................................................................................................................................................................................. 85 1.22. Tipos de Tags.................................................................................................................................................................. 86 1.23. Regras para o nome dos Tags........................................................................................................................................ 88 1.24. Criando Tags................................................................................................................................................................... 88 1.25. Tags de Comunicao ................................................................................................................................................... 89

MANUAL E3
1.25.1. Pasta de Comunicao (IOFolder)........................................................................................................................... 89 1.25.2. Tag de Comunicao (IOTag).................................................................................................................................. 89 1.25.3. Bloco de Comunicao ( IOBlock)........................................................................................................................... 91 1.25.4. Elemento de Bloco (IOBlockElement)...................................................................................................................... 91 1.26. Configuraes de Comunicao..................................................................................................................................... 93 1.26.1. Interface de Configurao........................................................................................................................................ 93 1.26.2. Modo de Operao................................................................................................................................................... 94 1.26.3. Excees................................................................................................................................................................... 95 1.26.4. Compartilhamento de Drivers................................................................................................................................... 95 1.26.5. Interface de Execuo.............................................................................................................................................. 96 1.26.6. Utilizao das escalas.............................................................................................................................................. 97 1.26.7. Teste de Comunicao............................................................................................................................................. 97 1.26.8. Utilizao de Estampa de Tempo............................................................................................................................ 98 1.26.9. Lista de valores......................................................................................................................................................... 98 1.26.10. Importao de Tags................................................................................................................................................ 99 1.26.11. Importao do Elipse Scada para o E3............................................................................................................... 101 1.27. Driver OPC.................................................................................................................................................................... 103 1.27.1. Objeto Grupo OPC................................................................................................................................................. 108 1.27.2. Objeto Pasta OPC.................................................................................................................................................. 109 1.27.3. Objeto Tag OPC..................................................................................................................................................... 109 1.27.4. Objeto Bloco OPC.................................................................................................................................................. 110 1.27.5. Objeto Elemento de Bloco OPC............................................................................................................................. 112 1.28. Servidor de Dados (DataServer)................................................................................................................................... 113 1.28.1. Pasta de Dados (Folder)........................................................................................................................................ 113 1.28.2. TagDemo................................................................................................................................................................ 114 1.28.3. Tag Interno.............................................................................................................................................................. 115 1.29. Outros tipos de dados................................................................................................................................................... 116 7. VIEWER.................................................................................................................................................................................. 117 8. TELAS E QUADROS............................................................................................................................................................. 125 1.30. Tela................................................................................................................................................................................ 125 1.30.1. Componentes da Tela............................................................................................................................................ 127 1.31. Quadros......................................................................................................................................................................... 129 9. TELAS E QUADROS............................................................................................................................................................. 133 1.32. Arco da Elipse................................................................................................................................................................ 134 1.33. Desenho Livre................................................................................................................................................................ 135 1.34. Elipse ............................................................................................................................................................................ 135 1.35. Escala............................................................................................................................................................................ 136 1.36. Figura............................................................................................................................................................................. 137 1.37. Linha.............................................................................................................................................................................. 138 1.38. Polgono......................................................................................................................................................................... 139 1.39. Polgono de Curvas....................................................................................................................................................... 140 1.40. Retngulo....................................................................................................................................................................... 140 1.41. Retngulo Arredondado................................................................................................................................................ 141 1.42. Texto ............................................................................................................................................................................. 142 1.43. Display........................................................................................................................................................................... 143 1.44. Setpoint.......................................................................................................................................................................... 144 1.45. Configuraes Gerais.................................................................................................................................................... 145 1.45.1. Eventos e Propriedades Gerais............................................................................................................................ 155 1.45.2. Formatao de Valores.......................................................................................................................................... 158 1.45.3. Formatos para Data e Hora.................................................................................................................................... 163 1.46. Links............................................................................................................................................................................... 165 1.46.1. Conexo Simples.................................................................................................................................................... 165 1.46.2. Conexo Bidirecional.............................................................................................................................................. 166 1.46.3. Conexo Digital...................................................................................................................................................... 167 1.46.4. Conexo Analgica................................................................................................................................................ 168 1.46.5. Conexo por tabela................................................................................................................................................ 169 10. SCRIPTS............................................................................................................................................................................... 170 1.47. Picks............................................................................................................................................................................... 174 1.48. Criando Scripts.............................................................................................................................................................. 174 1.48.1. Fundamentos de VBScript..................................................................................................................................... 178 1.49. Variveis........................................................................................................................................................................ 179 1.50. Constantes..................................................................................................................................................................... 182 1.50.1. Criando Constantes................................................................................................................................................ 182 1.51. Operadores.................................................................................................................................................................... 182 1.51.1. Precedncia de Operadores.................................................................................................................................. 183 1.52. Controle de Fluxo.......................................................................................................................................................... 184 1.53. Procedimentos (Procedure).......................................................................................................................................... 190

1.54. Sintaxe SQL................................................................................................................................................................... 196 1.55. Seleo Condicional...................................................................................................................................................... 198 1.56. Operadores Condicionais.............................................................................................................................................. 198 1.57. Outros Tpicos Gerais.................................................................................................................................................. 206 11. BANCO DE DADOS............................................................................................................................................................. 209 1.58. Criando um Banco de Dados........................................................................................................................................ 210 1.58.1. Servidor de Dados Access..................................................................................................................................... 210 1.58.2. Servidor de Dados Oracle...................................................................................................................................... 210 1.58.3. Servidor de Banco de Dados SQL Server............................................................................................................. 211 12. OBJETO ALARME............................................................................................................................................................... 212 1.59. Servidor de Alarmes (AlarmServer).............................................................................................................................. 213 1.60. Objeto rea.................................................................................................................................................................... 216 1.61. Alarmes (AlarmConfig).................................................................................................................................................. 217 1.62. Fontes de Alarmes........................................................................................................................................................ 218 1.62.1. Tipos de Fontes de Dados..................................................................................................................................... 218 1.62.2. Banda Morta........................................................................................................................................................... 220 1.62.3. Taxa de Variao.................................................................................................................................................... 223 13. E3ALARM............................................................................................................................................................................. 224 14. HISTRICOS........................................................................................................................................................................ 230 15. E3BROWSER....................................................................................................................................................................... 238 1.63. Fonte de Dados............................................................................................................................................................. 239 1.64. Exemplos de Scripts...................................................................................................................................................... 245 1.65. Objetos do E3Browser.................................................................................................................................................. 246 1.65.1. Objeto Campos....................................................................................................................................................... 246 1.65.2. Objeto Coleo de Campos................................................................................................................................... 247 16. E3CHART............................................................................................................................................................................. 248 1.66. Tipos de escala e Cor................................................................................................................................................... 252 1.66.1. Usar escala de Dados no eixo Horizontal e Vertical............................................................................................. 253 1.66.2. Escala de Tempo Fixa............................................................................................................................................ 255 1.66.3. Escala Mvel de tempo.......................................................................................................................................... 258 1.67. Penas............................................................................................................................................................................. 260 1.67.1. Varivel atualizada em tempo real......................................................................................................................... 262 1.67.2. Histrico usando consulta...................................................................................................................................... 263 1.67.3. Configurao da aparncia da pena...................................................................................................................... 265 1.67.4. Configurao avanada da pena........................................................................................................................... 265 1.68. Criando um E3Chart Histrico...................................................................................................................................... 266 1.69. Objeto Coleo de Penas ............................................................................................................................................ 268 1.70. Objeto Consulta (Query)............................................................................................................................................... 269 1.71. Objeto Coleo de Consultas ...................................................................................................................................... 270 17. FRMULAS.......................................................................................................................................................................... 271 18. CONTROLES ACTIVEX...................................................................................................................................................... 274 1.72. Caixa de Seleo.......................................................................................................................................................... 277 1.73. Boto de opes............................................................................................................................................................ 278 1.74. Lista de Seleo............................................................................................................................................................ 279 1.75. Boto de Comando........................................................................................................................................................ 281 1.76. Texto.............................................................................................................................................................................. 281 1.77. Lista................................................................................................................................................................................ 282 1.78. Barra de Rolagem......................................................................................................................................................... 283 1.79. Boto Incremento-Decremento..................................................................................................................................... 284 1.80. Editor de Texto.............................................................................................................................................................. 285 1.81. Boto Liga-Desliga........................................................................................................................................................ 286 19. BIBLIOTECAS...................................................................................................................................................................... 289 1.82. Biblioteca de Smbolos.................................................................................................................................................. 289 1.83. ElipseX........................................................................................................................................................................... 291 1.83.1. XControls................................................................................................................................................................ 292 1.83.2. XObjects................................................................................................................................................................. 294 1.83.3. Programao nos ElipseX...................................................................................................................................... 296 20. RELATRIOS...................................................................................................................................................................... 299 1.84. Objeto Consulta............................................................................................................................................................. 303 1.85. Componentes do Relatrio........................................................................................................................................... 304 1.85.1. Cabealho de Pgina (PageHeader).................................................................................................................... 304 1.85.2. Cabealho de Grupo (GroupFooter)...................................................................................................................... 305 1.85.3. Detalhes de Pgina (Details)................................................................................................................................. 306 1.85.4. Rodap de Pgina (PageFooter).......................................................................................................................... 307 1.85.5. Rodap de Grupo (GroupFooter)........................................................................................................................... 308 1.86. Objetos do Relatrio...................................................................................................................................................... 309

MANUAL E3
1.86.1. Prvia de Impresso (Preview).............................................................................................................................. 309 1.86.2. Configuraes do Relatrio (Report Setting)........................................................................................................ 311 1.86.3. Editor de Scripts..................................................................................................................................................... 315 1.86.4. Linha....................................................................................................................................................................... 315 1.86.5. Retngulo................................................................................................................................................................ 316 1.86.6. Retngulo Arredondado......................................................................................................................................... 317 1.86.7. Elipse...................................................................................................................................................................... 318 1.86.8. Label....................................................................................................................................................................... 318 1.86.9. Figura..................................................................................................................................................................... 319 1.86.10. Campo ................................................................................................................................................................. 319 1.86.11. Cdigo de Barras.................................................................................................................................................. 321 1.86.12. Quebra de pgina................................................................................................................................................. 321 1.86.13. Tabela................................................................................................................................................................... 322 1.86.14. E3Chart................................................................................................................................................................. 323 1.86.15. Enviar para frente / Enviar para trs.................................................................................................................... 324 1.87. Exemplos de utilizao dos Relatrios......................................................................................................................... 324 21. AJUDA E SUPORTE TCNICO.......................................................................................................................................... 328 1.88. Opes de ajuda no sistema......................................................................................................................................... 329 1.88.1. VBScriptHelp........................................................................................................................................................... 329 1.88.2. Manual de Instrues............................................................................................................................................. 329 1.88.3. Ajuda On-Line (Guia de Referncias).................................................................................................................... 330 1.89. Dvidas mais Frequentes.............................................................................................................................................. 332 1.90. Suporte Tcnico............................................................................................................................................................ 340 1.90.1. Servios de Suporte............................................................................................................................................... 341

Bem Vindo

M
E3.

ais versatilidade, mais facilidade, mais recursos, mais poder. Este o Elipse

Totalmente voltado operao em rede e aplicaes distribudas, o E3 oferece um novo e avanado modelo de objetos, uma poderosa interface grfica alm de uma nova e exclusiva arquitetura que permite o rpido desenvolvimento de aplicaes e mxima conectividade com dispositivos e outros aplicativos. Sua concepo incorpora as mais novas tecnologias em desenvolvimento de software, maximizando a performance, a produtividade e a qualidade de suas aplicaes e do prprio processo, minimizando perdas e custos. Os novos recursos e ferramentas de edio facilitam o desenvolvimento de aplicaes e minimizam tempo de configurao. Uma nova estrutura de aplicaes trabalha com o conceito de projeto modular com processamento distribudo em rede, integrando recursos de vdeo e suporte a tecnologias como COM, DCOM, ActiveX e OPC Agradecemos o seu interesse e desejamos sucesso com sua nova ferramenta de trabalho.

1
1.

Captulo

Introduo

A Elipse Software, tradicional desenvolvedora de softwares de superviso e controle de processos, conhecidos como Sistema Scada (Supervisory, Control and Data Acquisition), tem orgulho de oferecer sua mais nova e moderna ferramenta para superviso e controle de processos o Elipse E3. O E3 totalmente orientado a objetos e utiliza um padro de conectividade COM/DCOM (Distributed Component Object Model). A interface grfica permite a criao de objetos vetoriais (escalveis) com o uso de diversas ferramentas grficas, tais como: fill, rotao, movimento, sombra, entre outras. O sistema disponibiliza uma biblioteca de objetos fornecida pela ELIPSE (ElipseX) ou ainda permite que o usurio desenvolva suas prprias bibliotecas.

Tambm possvel integrar ao sistema bibliotecas compatveis com o E3. Em cada objeto possvel definir propriedades de qualquer tipo, suportado pelo sistema ou qualquer tipo de dado criado anteriormente na biblioteca. Alm disso, cada instncia ou cpia de um objeto ElipseX mantm uma referncia com os objetos originais da biblioteca, que incide sobre os objetos j em uso. Pensando na intranet e internet, o E3 suporta a tecnologia de frames HTML, permitindo usar o mesmo layout de telas do aplicativo tanto em aplicaes Standalone quanto em aplicaes baseadas em browsers. Cada quadro pode conter um link para uma pgina na Internet, uma tabela do Microsoft Excel ou ainda uma tela do E3. importante ressaltar que toda a funcionalidade da aplicao fica mantida, mesmo quando vista por um browser comercial. Alis, nenhuma alterao necessria para que uma aplicao rode na rede local ou na web. Basta colocar o web server a rodar. Por utilizar uma arquitetura distribuda, o sistema utiliza o conceito de domnios. Um domnio formado por um conjunto de aplicaes, pequenas ou grandes, que so executadas em conjunto, compartilhando um mesmo domnio. As aplicaes num domnio podem compartilhar vrios recursos (tais como alarmes, drivers, telas, banco de dados, etc) como se fossem partes de uma nica aplicao. A vantagem desta arquitetura que aplicaes podem ser adicionadas, removidas ou at editadas no mesmo domnio, permitindo a sua distribuio pelos servidores do sistema. Assim, um domnio poder ser um conjunto de servidores ou rodar apenas em um servidor, de acordo com o tamanho da aplicao. Alm disso, as estaes Viewer (clientes) continuam se referindo a um nico domnio, independentemente do nmero de servidores.
Manual E3 7

ELIPSE E3

1.1.

Descrio Geral
O E3 foi desenvolvido inicialmente para a plataforma Microsoft Windows 2000, utilizando alguns recursos disponveis somente neste sistema operacional. A interface grfica com o usurio pode ainda ser executada nos sistemas Windows 9X/NT/2000/Me/XP ou ainda atravs da Internet ou Intranet via Internet Explorer. As funes bsicas do software esto divididas em mdulos independentes, capazes de processar atividades especficas. O gerenciamento do trfego de informaes entre os mdulos coordenado por um mdulo principal (E3 Server) como veremos adiante, utilizando a tecnologia COM/DCOM (Component Object Model / Distributed Component Object Model), permitindo que os componentes possam ser executados tanto na mesma mquina quanto distribudos numa rede local. Em linhas gerais, o E3 composto de um ncleo (Kernel) responsvel por unir e coordenar o trabalho de vrios outros mdulos, que tambm so servidores de informaes. A partir da so geradas as interfaces grficas com o usurio que ficam disponveis atravs dos Clientes, tanto locais como pela Internet. O E3 possui trs programas principais, que so: E3 Studio: Ferramenta de Configurao, criao e manuteno dos domnios, projetos e bibliotecas; E3 Viewer: Interface de operao do sistema, exibindo em tempo real as informaes do sistema para os operadores. Pode ser substitudo pelo Internet Explorer para operao via Internet; E3 Server: Servidor do Sistema executa o domnio configurado pelo E3 Studio e fornece os dados e interface grfica para o E3 Viewer.

Como principais vantagens do E3, temos:


8

Poderoso, fcil de usar e altamente flexvel; Substitui com vantagens solues demoradas e caras; Aplicvel em processos de qualquer natureza; Comunicao com qualquer equipamento e sistema; Software em Portugus; Registro e anlise de dados; Nova arquitetura de objetos; Nova interface grfica com editor vetorial; Voltado a aplicaes distribudas, em rede ou internet. Suporte tecnologia ActiveX Conexo com sistemas corporativos (ERP) Configurao on-line
Manual E3

ELIPSE E3

Suporte a OPC Hot-standby e hot-backup Linguagem de scripts Arquitetura cliente-servidor Acesso banco de dados MELHOR SUPORTE SEM QUALQUER CUSTO: H mais de dez anos, a Elipse reconhecida por oferecer um suporte eficiente, rpido e totalmente gratuito aos seus usurios.

Pela leitura deste manual, teremos contato com cada um desses mdulos e como a interao entre eles ser configurada.

1.2.

Arquitetura de Projetos
Uma das caractersticas do E3 permitir a edio e execuo de vrios projetos simultneos. Isso permite que os sistemas de automao sejam distribudos em mdulos, facilitando a configurao e manuteno do sistema. Em configurao, os vrios aplicativos podem compartilhar informaes comuns, alm de evitar a repetio de itens desnecessrios. Alm disso, um aplicativo pode chamar funes ou acessar propriedades de outro, tornando um sistema realmente modular. Todos os aplicativos podem utilizar as Bibliotecas instaladas na mquina, controles ActiveX e mdulos nativos do E3. As ligaes entre os aplicativos e destes para seus mdulos so feitos atravs dos Links. Os Links representam a tecnologia desenvolvida pela Elipse Software que permite aos mdulos servidores e clientes se conectarem/desconectarem em execuo, alm de permitir e coordenar o fluxo de informaes entre eles. Alm disso, cada aplicativo (Projeto) pode ser executado e interrompido, sem prejudicar o funcionamento do software. claro que na ausncia da execuo de um projeto, aqueles mdulos que dependem dos dados gerados por ele ficaro com seus Links desconectados, ora no podero receber ou enviar dados. Assim que o Projeto voltar a ser executado, todos os Links sero refeitos automaticamente, voltando a comunicao a seu estado normal.

Manual E3

ELIPSE E3

1.3.

Mdulos e verses do sistema


O ncleo do E3 chamado de E3 Server, representado pelos programas E3Server.exe e E3Run.exe. O E3Server diferenciado pelo nmero de pontos de comunicao suportados, de acordo com a tabela abaixo:
VERSES E3 Studio E3Server 300 E3Server 1.500 E3Server 5.000 DESCRIO

E3Server Ilimitado

Ferramenta de Configurao do Sistema. Pode ser fornecida em conjunto com um E3 Server. Suporta at 300 tags de comunicao (Pontos de I/O) e j possui uma licena de Viewer completa inclusa. Suporta at 1.500 tags de comunicao (Pontos de I/O) e j possui uma licena de Viewer completa inclusa. Sistema ideal para a maioria das aplicaes. Suporta at 5.000 tags de comunicao (Pontos de I/O) e j possui uma licena de Viewer completa inclusa. Sistema indicado para aplicaes de grande porte. utilizado em aplicaes maiores que 5000 tags, com suporte at 1 milho de pontos. Tambm possui 1 licena de Viewer completa inclusa.

Cada licena de Servidor inclui: E3 SERVER - Servidor e runtime da aplicao. VIEWER - Estao de operao do sistema (visualizao e operao). IO DRIVER - Gerenciador de comunicao e tags de comunicao. DB SERVER - Gerenciador de banco de dados. SCRIPTS - Suporte a linguagem de programao VBScript. RELATRIOS - Ferramenta para a gerao de relatrios. OPC CLIENT - Suporte a OPC (OLE for Process Control) como cliente. Esto disponveis tambm alguns mdulos adicionais para o E3, conforme a necessidade do sistema. So eles:
MDULO E3 Viewer (Licena adicional) DESCRIO

Podem ser adquiridas licenas adicionais para os Viewers, permitindo que mais usurios possam operar o sistema simultaneamente. O controle das licenas do Viewer fica no Servidor, de modo que no necessrio utilizar o dispositivo de proteo (hardkey) nos clientes.

Na ausncia do HardKey, o software pode ainda ser executado em modo Demonstrao. Como no necessita do hardkey, o modo Demo pode ser utilizado para avaliao do software. Ele possui todos os recursos existentes no modo Studio, com exceo de trabalhar com um mximo de 20 tags de comunicao (IOTag e OPCTag) e permitir a comunicao com equipamentos de aquisio de dados por
10 Manual E3

ELIPSE E3

at 10 minutos. No E3Server, h somente as opes de Executar e Fechar Domnio, sendo que o mesmo pode ser executado em at 10 minutos. A biblioteca de smbolos disponibiliza somente o primeiro smbolo de cada biblioteca.

1.4.

Outras informaes
Para saber mais sobre nossos produtos, acesse nossa pgina http://www.elipse.com.br ou entre em contato com nosso departamento de vendas na cidade mais prxima de voc:
So Paulo, SP: Porto Alegre, RS: Curitiba, PR: EUA: (11) 3061-2828 (51) 3346-4699 (41) 342-0120 +1 (252) 995-6885

1.5.

Novidades da Verso
Sempre buscando inovar e atender as necessidades crescentes do mercado, o E3 oferece as seguintes novidades na sua verso: Novos objetos do E3Browser: Objeto Campos e Objeto Coleo de Campos; Relatrios: Novos recursos de configurao dos Usurios: Usurios, Grupos e Permisses; Novos recursos de configurao do Domnio; Nova opo no projeto Proteger: Protege o contedo do arquivo contra edio e/ou visualizao no-autorizada. As opes deste item so: Adicionar proteo, Alterar senha e Remover proteo. Novo layout nos Picks dos Scripts e nas propriedades de configurao do E3Chart; Nova propriedade do Viewer: DisableTaskwitching, que desabilita a troca de janelas; Movimentao: Informaes sobre movimentao Linear e Rotacional;

Manual E3

11

2
2.

Captulo

Elipse Scada x E3

Este captulo se destina queles que j esto habituados com as caractersticas e funcionalidades do Elipse Scada, mas que notaro vrias diferenas entre o mtodo de trabalho se comparado com o E3 Studio. De uma forma geral, o E3 Studio apresenta vrias melhorias, que se traduzem numa maior capacidade de processamento de tarefas de superviso e controle em geral, alm de diminuir o tempo gasto na configurao do aplicativo, principalmente para grandes sistemas. Podemos citar brevemente as seguintes melhorias: Arquitetura de Camadas similar ao conceito das Aplicaes Internet, com o servidor sendo executado de forma totalmente independente dos visualizadores (Servidor Web / Navegador de Internet); Capacidade de distribuio do processamento do servidor entre vrios computadores; pode ser executado em cada estao servidora de cada mdulo da aplicao, ou ainda executar em vrias estaes o mesmo mdulo (processamento paralelo); Configurao e Execuo de vrios projetos simultaneamente. O Studio permite editar ao mesmo tempo vrios projetos, alm de permitir que vrias pessoas compartilhem a edio de cada projeto ou mdulo pela rede, aumentando a capacidade de colaborao on-line. Um conjunto de aplicativos executado simultaneamente, com interaes entre si forma um Domnio, que implica em facilidades de manuteno do sistema, alm de permitir o HotStandBy (Duplicidade) entre seus mdulos; Interface grfica poderosa, com a presena de editor grfico vetorial completo, capaz de desenvolver qualquer tipo de interatividade com o usurio. Podem ser importados formatos grficos vetoriais diversos como os Metafiles, alm do uso de controles universais com a tecnologia ActiveX; Mdulo de Programao de Scripts em linguagem VBScript permite utilizar recursos amplamente difundidos de programao de pginas para Internet, alm de permitir que os mesmos recursos feitos para uma aplicao local (atravs do E3 Client) sejam utilizados quando em operao pela Web.
12

Manual E3

1.6.

3 4
3.

Captulo

Instalao

Para que a instalao do sistema seja feita, necessrio verificar as configuraes bsicas do computador e demais equipamentos. O E3 permite configurar o sistema para dois tipos de instalao, feitas em Windows 2000/Xp ou Windows 98/Me, pela qual ser executado o E3 Cliente.

Requisitos do sistema
Para a instalao no Windows 2000/XP, so necessrias as seguintes configuraes: Processador Celeron, K6-2, Pentium II ou equivalente/superior; 128 MB de memria RAM; Monitor e Placa de Vdeo com resoluo 800 x 600; 100 MBytes de espao em disco rgido (exceto espao para arquivo de dados); Microsoft Windows 2000 ou XP; 1 porta paralela; Interface de rede, para o uso de aplicaes distribudas.

Para a instalao em Windows 98/Me, so necessrias as seguintes configuraes: Processador Celeron, K6-2, Pentium II ou equivalente/superior; 64 MB de memria RAM; Monitor e Placa de Vdeo com resoluo VGA (640 x 480); 10 MBytes de espao em disco rgido; Microsoft Windows 98/Me; Interface de rede, para a conexo com o E3 Server.

Manual E3

13

ELIPSE E3

1.7.

Instrues de Instalao
Para instalar o sistema, siga os seguintes procedimentos: Insira o Hardkey (dispositivo de proteo) na porta paralela do seu computador, se j existir uma impressora nesta porta coloque primeiro o Hardkey e conecte a impressora no mesmo; Insira o CD de instalao do E3 Studio; Execute o arquivo e3-w2kfull.exe. Siga as instrues que aparecero na tela e aguarde finalizao da instalao.

Uma mensagem "Instalao Completa" ir aparecer quando a instalao for bem sucedida. Um grupo de programas chamado E3 Studio ser criado no seu Computador, contendo os cones do programa. Verifique se os cones ou os caminhos esto corretamente configurados, apontando para o sistema. Caso isto no ocorra, desinstale e reinstale novamente o sistema.

Figura1: Caminho do E3 no sistema

14

Manual E3

ELIPSE E3

1.8.

Atualizao das verses


Periodicamente, a Elipse lana novos releases do software, que contm novas ferramentas e/ou atualizaes das j existentes. Tais atualizaes podem ser obtidas atravs de mdia comum (Disquetes ou CD-ROM) ou atravs do site www.elipse.com.br. Pela Internet esto disponveis no caso de atualizao, arquivos que se modificam a cada release, o que torna o tamanho da atualizao menor que a instalao. Tambm esto disponveis, verses de demonstrao do sistema. Para atualizar a verso do sistema, siga os seguintes procedimentos. Adquira a atualizao da verso do sistema, atravs de Disquetes ou CD-Rom, ou download no site da elipse software (www.elipse.com.br); Caso esteja com a aplicao ou o sistema abertos, feche-os. Desinstale o E3 Studio do seu computador; Execute o arquivo atualizao (e3-w2kfullbr.exe) e aguarde a tela de abertura;

Siga os procedimentos que iro aparecer na tela e aguarde a finalizao. importante salientar que este processo apenas atualiza a verso, sendo que os dados contidos no sistema anteriormente permanecem os mesmos. Uma mensagem "Instalao Completa" ir aparecer quando a instalao for bem sucedida. Verifique se os cones ou os caminhos esto corretamente configurados, apontando para o sistema. Caso isto no ocorra, desinstale e reinstale novamente o sistema. Para verificar verso do sistema, abra o programa, selecione no Menu Ajuda a opo Sobre o E3, que o sistema indicar a sua verso.

Manual E3

15

ELIPSE E3

1.9.

Sobre o Hardkey
O E3 utiliza um sistema de proteo do software baseado num dispositivo externo conhecido como chave de hardware ou hardkey, que contm a definio dos mdulos e ferramentas disponveis para o usurio. Por se tratar de um dispositivo de memria, ele pode ser modificado pela Elipse Software para efeito de substituio ou atualizao de verses.

1.9.1. Atualizao do Hardkey


Para isso, alm dos procedimentos comerciais normais, o usurio poder seguir os seguintes passos, de forma que a atualizao seja feita o mais rpido possvel:

Coloque a chave na porta paralela e execute o programa CUSTOMER.EXE, que copiado para o mesmo diretrio da instalao, e selecione a opo Get ID. Escolha a opo Save, fornecendo um nome para o arquivo com qualquer extenso (sugesto: *.TXT). Mande o arquivo por e-mail para a Elipse Software.

Ao receber um novo arquivo, execute o programa CUSTOMER.EXE. Execute a opo Config e fornea o nome do arquivo recebido, e a chave estar programada.

16

Manual E3

4
4.

Captulo

Iniciando o E3

Para iniciarmos uma aplicao no E3 Studio, devemos seguir os seguintes procedimentos: Clique no cone de atalho do sistema na rea de trabalho ou acesse via Boto Iniciar (Start) - Programas (Programs) - E3 - E3 Studio. A Hardkey dever estar conectada em sua porta paralela, no caso de uma edio local, ou a mquina deve estar na mesma rede local que outra com o E3 Server, j previamente instalada e com uma hardkey presente.

Figura1: Caminho do E3 no sistema

Manual E3

17

ELIPSE E3

1.10. Iniciando um projeto


Quando iniciado o E3 Studio, o sistema abre uma caixa de dilogo com algumas opes do projeto. Ao iniciar o E3 Studio, aparecero trs opes de trabalho: Opes do sistema
OPO DESCRIO

Iniciar E3 Studio; no ser aberto nenhum projeto;. Criar um Projeto Novo; ser requisitado o nome e caminho do novo projeto. Abrir um projeto existente; Ao clicar em Outros Arquivos.... Teremos a opo de localizar um projeto num diretrio especfico ou podemos escolher na lista os ltimos aplicativos editados.

1.11. rea de Trabalho


A figura abaixo mostra a aparncia do E3 Studio aps a criao de um novo projeto chamado "Exemplo".

Figura 1- rea de Trabalho

18

Manual E3

ELIPSE E3

O E3 Studio j vem com uma srie de Menus e Barras de ferramentas configuradas, que so mostradas ao se executar o E3 Studio pela primeira vez. Ao utilizar uma interface grfica mais moderna, similar a programas como o Office 2000, os Menus e Barras de Ferramentas, podem ser modificados pelo usurio. Quando no existe uma aplicao aberta, a tela apresenta menos opes habilitadas na Barra de menu e Barra de Ferramentas, mas o seu layout permanece o mesmo. A Barra de Ttulo mostra o caminho e o nome da sua aplicao, bem como o ttulo da tela corrente que est sendo mostrada na rea de trabalho. Os botes da Barra de Ferramentas permitem que voc execute determinadas tarefas rapidamente, sem usar os menus. Desta forma, voc pode criar Objetos de Tela ou chamar o Organizer, simplesmente pressionando um boto. A Barra de Telas mostra o ttulo da tela corrente e permite que voc altere entre uma tela e outra, simplesmente selecionando o seu nome na lista da caixa de dilogo. A Barra de Status mostra informaes de ajuda a respeito da rea da tela, sobre a qual est o ponteiro do mouse. A rea de trabalho usada para editar as telas e os relatrios da aplicao.

1.11.1.Barra de Menus
A Barra de Menus do E3 Studio muda conforme a existncia de uma aplicao aberta ou no. Existem 3 situaes na quais a barra muda: Nenhuma aplicao aberta: A barra de menus desenho e formatao esto desabilitadas. A barra de menus est com a maioria das opes desabilitadas, sendo que somente as opes Abrir e Novo esto ativas. Nova aplicao criada ou nenhuma tela sendo editada: Na barra de menus desenho, as seguintes opes esto habilitadas: selecionar, rotacionar e ordem de tabs; todos os objetos de desenho; botes camadas e zoom. Na barra de menus, as opes habilitadas so: novo, abrir, salvar tudo e salva e executa tudo. Abrir uma nova aplicao existente: Todas as barras de menus esto habilitadas.

1.11.2.Barra de Ferramentas
A Barra de Ferramentas do E3 muda conforme existncia de uma aplicao aberta ou no. As mesmas situaes que determinam uma modificao na Barra de Menu fazem com que a Barra de Ferramentas se modifique. A tabela abaixo mostra as opes disponveis no sistema:

Manual E3

19

ELIPSE E3

Barra de Ferramentas Padro

20

Manual E3

ELIPSE E3 CONE COMANDO Novo projeto Abrir projeto Salvar projeto Desfazer Salvar tudo Refazer AO Cria um novo projeto. Abre um projeto existente. Salva um Projeto selecionado. Desfaz a ltima ao executada. Salva todo o projeto. Refaz a ltima ao executada.

Janela do Projeto Habilita a Janela do Projeto no sistema. (Organizer) Janela de propriedades Habilita a Janela de propriedades, pela qual sero configurados as informaes referentes aos objetos e o sistema. Executar Viewer Abre o E3 Viewer (Visualizao do projeto). Salva Tudo Salva tudo, executa o domnio e abre o Viewer. Executa/ Para Domnio Executa/para o domnio corrente Executa/Fecha Viewer Verificar Erro Erro Anterior Prximo erro Ajuda Ajuda Sensvel Executa/fecha o E3 Viewer Verifica se o domnio contm erro. Mostra o erro anteriormente encontrado no domnio. Mostra o prximo erro encontrado no domnio. Habilita a ajuda do sistema. Habilita a ajuda sensvel do sistema.

Manual E3

21

ELIPSE E3 Desfragmentar Desfragmenta o arquivo especificado.

22

Manual E3

ELIPSE E3

Barra de Ferramentas Sombra

Manual E3

23

ELIPSE E3 CONE COMANDO Aplica Sombra Sombra Acima Desloca Sombra para cima Sombra Esquerda Sombra Direita AO Aplica Sombra. Desloca Sombra para cima. Desloca Sombra para baixo. Desloca Sombra Esquerda. Desloca Sombra Direita.

24

Manual E3

ELIPSE E3 Cor da Sombra Seleciona Cor da Sombra.

Manual E3

25

ELIPSE E3

Barra de Ferramentas Tela


CONE COMANDO Desagrupar Agrupar Ordem dos Tabs Rotacionar Desenho Livre Elipse AO Desagrupa uma seleo de objetos. Agrupa uma seleo de objetos. Mostra identificador de ordem navegao entre os objetos. Exibe ferramenta de rotao. Exibe ferramenta de Desenho Livre. Exibe ferramenta de desenho de Elipses.

Retngulo Arredondado Exibe ferramenta de desenho de Retngulos arredondados. Retngulo Exibe ferramenta de desenho de Retngulos. Caixa de Seleo Edio da Grade Linha Selecionar Movimentao Enviar Para Baixo Trazer para Cima Enviar para o Fundo Trazer para o Topo Texto Polgono de Curvas Polgono Figura Arco de Elipse Display Setpoint Exibe quadro para seleo de objetos na tela. Exibe propriedades do Grid. Exibe ferramenta de desenho de retas. Exibe ferramenta de desenho de retas. Seleciona modo de adio de movimentao. Insere objeto abaixo. Insere objeto acima. Envia objeto para o fundo. Envia objeto para o topo. Insere texto. Exibe ferramenta de desenho de polgono de curvas. Exibe ferramenta de desenho de polgono. Insere Imagem. Exibe ferramenta de desenho de Arco de Elipse. Mostra os valores das tags. Cria um objeto Setpoint na tela.

26

Manual E3

ELIPSE E3

Manual E3

27

ELIPSE E3

Barra de Ferramentas Objeto

28

Manual E3

CONE

COMANDO Sumrio de Alarmes Tabela de Dados Grfico

Caixa de Seleo Boto de Opes Lista de seleo Boto de Comando

Texto

Lista Barra de Rolagem Editor de texto

ELIPSE E3 AO Visualiza as condies de alarmes presentes no sistema. Utilizado para visualizar os dados dos histricos e alarmes guardados no banco de dados. Componente responsvel pela visualizao em forma de grfico de dados em tempo real e dados histricos. Define uma caixa de seleo do tipo Check Box, que ser inserida no projeto. Define um boto de opes do tipo Radio, que ser inserido no projeto. Define uma lista de seleo que ser inserida no projeto. Utilizado para acionamento ou execues de tarefas especificadas pelo usurio, atravs do mouse ou teclado. Este objeto permite o desenho de textos, utilizando o valor definido na propriedade Caption. Define uma lista no projeto. Utilizado para acionar uma barra de rolagem na tela.

Utilizado para criar um editor de texto que ser utilizado na aplicao, no momento da sua execuo. Boto Define um boto tipo chave, que ser inserido Incremento/Decremento no projeto. Atravs deste objeto possvel inserir alguma ao para cada um dos status do boto.

Manual E3

29

ELIPSE E3 Boto Liga\Desliga Utilizado criar um boto Liga/Desliga (On/Off).

30

Manual E3

ELIPSE E3

Barra de Ferramentas Desenho

Manual E3

31

ELIPSE E3 CONE COMANDO Estilo do Gradiente Espessura da Linha Estilo da Borda Cor da Frente Cor do Fundo Cor da Borda AO Define Estilo de Preenchimento. Define Espessura da Linha. Define Estilo da Borda. Define Cor de Frente. Define Cor de Fundo. Define Cor da Borda.

32

Manual E3

ELIPSE E3 Cor da Fonte Define Cor da Fonte.

Barra de Ferramentas Formatao


CONE COMANDO Mesma Altura Mesma Largura Alinhamento Inferior Alinhamento Superior Alinhar Direita Alinhar Esquerda Texto Direita Texto Centralizado Texto Esquerda Fonte Sublinhada Fonte em Itlico Fonte em Negrito Tamanho da Fonte Grade Distribuir Verticalmente AO Aplica a mesma altura entre objetos. Aplica a mesma largura entre objetos. Alinha objetos abaixo. Alinha objetos acima. Alinha objetos direita. Alinha objetos esquerda. Formata Texto direita. Centraliza Texto. Formata Texto esquerda. Insere fonte sublinhada. Insere fonte em Itlico. Insere fonte em negrito. Seleciona Tamanho da Fonte. Insere Grade. Formata espaamento entre objetos na vertical.

Distribui Horizontalmente Formata espaamento entre objetos na horizontal. Centralizar Centraliza objetos horizontalmente. Horizontalmente Centralizar Verticalmente Centraliza objetos verticalmente. Mesmo Tamanho Aplica mesmo tamanho aos objetos selecionados.

1.12. Configurao do Studio


Podemos escolher a aparncia de detalhes das ferramentas do E3 Studio atravs do Menu "Visualizar" - "Customizar", onde teremos acesso janela de configuraes abaixo:

Manual E3

33

ELIPSE E3

Figura: Configuraes do Studio

Na Tab Comandos, podemos definir os cones cada uma das barras de ferramentas clicando sobre o cone no campo Comandos e arrastando-o para dentro da barra de ferramentas desejada na tela do E3 Studio.

Figura: Configuraes do Studio

Na Tab Barra de Ferramentas, podemos escolher a visualizao das barras, editar ou criar novas barras de ferramentas.

34

Manual E3

ELIPSE E3

Figura: Configuraes da Barra de Ferramentas

Na Tab Teclado, podemos definir teclas de atalho para cada opo das barras de ferramentas. Para isso, basta escolher o comando desejado no campo "Comandos" e clicar no campo "Nova tecla de atalho". Tudo o que for digitado ser capturado e inserido nesse campo como a tecla de atalho desejada. Para fazer a atribuio, clique em "Atribuir".

Figura: Configuraes do Teclado

A Tab Menus mostra opes gerais sobre os Menus. possvel escolher as opes do menu principal, pela qual pode-se mostrar menus predefinidos ou repor as caractersticas padro.

Manual E3

35

ELIPSE E3

Figura: Configuraes do Menu

Na Tab Opes possvel configurar as especificaes gerais do projeto.

Figura: Configuraes da Opo

1.12.1.Ferramentas
Podemos configurar a barra de ferramentas do E3 Studio atravs do Menu "Ferramentas" - "Opes", onde teremos acesso janela de configuraes abaixo:

36

Manual E3

ELIPSE E3

Editor Este tem destinado a configurao das ferramentas do E3 Studio (Barra de rolagem, Tab, identao, etc).

Figura1: Configuraes da opo Editor

Formato Este item configura o formato da fonte do sistema.

Figura: Configuraes do Formato

1.12.2.Barra de Execuo do Projeto


A Barra de execuo do projeto utilizada para determinar as aes que esto ocorrendo no projeto. Assim possvel verificar se o projeto est em andamento ou se est parado, alem de outras opes que sero listadas abaixo:
Manual E3 37

ELIPSE E3

Licenas Atravs desta opo possvel visualizar todas as licenas disponveis do sistema e do projeto em andamento. Tal recurso disponibilizar informaes sobre o programa em execuo, o computador que est utilizando-o, usurio, o tempo de execuo, etc. Para utilizar este recurso, siga os seguintes procedimentos: Clique com o boto direito do mouse no cone do sistema e selecione a opo Licenas. O sistema abrir uma tela com as informaes disponveis referentes s licenas do sistema. Para atualizar os dados, selecione a opo Atualizar.

Figura: E3Server - Licenas

Domnios A fim de coordenar o uso de vrios aplicativos, entra em cena o conceito de Domnio, que o nome dado a um conjunto de aplicativos. Os aplicativos pertencentes a um Domnio podem ser executados em conjunto pelo Servidor (E3 Server), de forma a facilitar a configurao e execuo. O uso do Domnio facilita ainda a localizao do servidor pelos Viewers (E3 Viewer), alm de permitir a
38 Manual E3

ELIPSE E3

criao de unidades Stand-by no caso de algum componente, projeto ou Domnio vir a falhar. O Domnio representado por um Nome (Nome do Domnio) que informado em cada Projeto. Um arquivo de Domnio indica o nome e caminho de todos os projetos que fazem parte de um Domnio, e utiliza a extenso.DOM. A Execuo do Domnio se d atravs do E3Server.exe, que pode receber como parmetro de inicializao um arquivo de projeto (extenso PRJ) ou um arquivo de Domnio (extenso DOM). Atravs desta opo possvel configurar as opes referentes a domnio. Para utilizar este item, siga os seguintes procedimentos: Clique com o boto direito do mouse sobre a caixa de execuo do projeto e selecione a opo Domnio. Nesta opo, contm vrios itens:

o o

OPES: Este tpico permite que sejam configuradas as informaes referentes ao domnio. Para utilizar este recurso, siga os seguintes procedimentos: Executar: Executa o domnio corrente. Fechar: Fecha o domnio corrente.

Veja maiores detalhes no tpico Domnio.

1.12.3.Organizer
O Organizer permite uma viso simples e organizada de toda a aplicao, ajudando na edio e configurao de todos os objetos envolvidos no sistema atravs de uma rvore hierrquica de opes. Possui trs opes de trabalho e visualizao, que so Projetos, Biblioteca e Classes.

Manual E3

39

ELIPSE E3

Figura: Organizer

No item Projetos, temos a viso de todos os projetos que esto abertos para edio (pertencentes ou no ao domnio corrente). Sua estrutura pode ser comparada rvore de diretrios do Windows Explorer. Desta forma a estrutura de uma aplicao comea pelo item do Nome da Aplicao, e todos os objetos ou mdulos que foram inseridos como parte da mesma descem a partir da raiz. Cada objeto por sua vez pode contem itens filhos, que podem ser visualizados atravs da expanso de seus elementos. Ao navegar pela estrutura da(s) aplicao(es), vrias opes sero apresentadas para edio dos objetos, seja atravs do uso do boto esquerdo ou direito do mouse. Ao clicar em um objeto com o boto esquerdo, suas propriedades podero ser visualizadas e editadas atravs da Janela de Propriedades, se esta estiver habilitada. O Folder Biblioteca do Organizer disponibiliza uma srie de objetos grficos que podem ser arrastados e inseridos nas Telas de suas aplicaes. As Bibliotecas podem ser arquivos do tipo Metafiles (WMF - Windows MetaFile) ou ainda XControls, que so as bibliotecas grficas do E3 Studio, que por sua vez podem ser compostos de Metafiles, Desenhos realizados com o editor grfico do E3, Controles ActiveX ou ainda outros XControls. J o Folder Classes, mostra os tipos de dados e mdulos bsicos "cadastrados" para utilizao com o E3. Existem trs tipos de mdulos que podem estar cadastrados, e que podem ser retirados e adicionados: Um mdulo E3 (arquivo com extenso *.E3), que so mdulos nativos do E3 Studio; mdulo ActiveX (podem estar agrupados ou ocultos, geralmente usam extenso *.OCX e devem ser registrados no Windows) e mdulo ElipseX, que so as bibliotecas de objetos do E3, que podem incluir dois tipos de Objetos: XControls e XObjects.

40

Manual E3

ELIPSE E3

As classes inseridas ficam armazenadas no Registry do Windows, de modo a manter em disco a configurao escolhida. Para registrar mdulos no E3, basta clicar na rea de fundo do item Classes com o boto direito do mouse. As opes "Adicionar mdulo do E3 Studio" e "Adicionar Biblioteca ElipseX" permitiro a escolha dos arquivos a serem adicionados ao sistema. A opo "Adicionar ActiveX" apresenta uma janela padro do Windows, mostrando os ActiveX disponveis em sua mquina. A instalao do E3 j disponibiliza 3 objetos ActiveX, que so: o E3AlarmControl (Verificao e Reconhecimento de Alarmes), o E3Browser (Lista Contedo de Banco de Dados) e E3Chart (Grficos), e mais 5 mdulos E3, que so o Standard (Tipos Bsicos de Dados), o Data (Execuo de Tags internos e XObjects), o DB (DataBase), o IODriver (Drivers de Comunicao) e o Panel (Telas e Objetos grficos). Clicando com o boto direito do mouse sobre o nome do projeto, no folder Projetos do Organizer, so disponibilizadas algumas opes:

Opes do Projeto no Organizer


Manual E3 41

ELIPSE E3

Fechar: Fecha o projeto corrente; Atualizar: Atualiza as configuraes do projeto; Salvar como : Abre uma caixa de dilogo para que seja salvo o projeto de acordo com o local indicado. Desfragmentar: Desfragmenta o projeto, isto , faz com que os espaos que so criados desnecessariamente (deleo de itens do sistema, etc) sejam retirados, disponibilizando dinamismo ao sistema. Para tanto, basta selecionar o item Desfragmentar, que o sistema far a desfragmentao e mostrar o diagnstico do mesmo.

Nova pasta: Cria uma nova pasta no sistema. A Pasta funciona como uma diviso lgica para o projeto, facilitando a visualizao de sistemas de grande porte. Inserir : Atravs deste recurso, possvel inserir no projeto os diversos mdulos disponveis e registrados. Isso porque cada projeto pode conter somente as funcionalidades desejadas pelo usurio ou que estiverem disponveis naquela mquina, evitando eventuais overheads de processamento. Alm disso, permite que novos mdulos sejam desenvolvidos e adicionados dinamicamente. Proteger: Atravs deste tem, possvel proteger o contedo do arquivo contra a edio ou visualizao no autorizada. Para utilizar este recurso, clique com o boto direito do mouse sobre o Nome do projeto no Organizer, e clique na opo Proteger. O sistema abrir uma caixa de dilogo com as seguintes opes:

42

Manual E3

ELIPSE E3

As opes deste tem so os seguintes: - Adicionar proteo: Protege o contedo do arquivo contra a edio ou visualizao no autorizada. Atravs deste recurso, possvel especificar a senha de proteo para os arquivos do projeto.

- Alterar Senha: Altera a senha de proteo de edio do arquivo. Para utilizar este recurso, basta acessar a opo, informar a senha anterior e digitar a senha que deseja cadastrar.

Manual E3

43

ELIPSE E3

- Remover proteo: Remove a proteo de edio do arquivo. Para utilizar este recurso, basta acessar a opo, digitar a senha atual e clicando no boto OK, o sistema remove a proteo do arquivo.

Aps, o sistema mostra uma mensagem, informando o status da proteo:

Quando um arquivo Lib ou Prj aberto no E3 Studio, este inicializa mostrando um cone acizentado , com um lock indicando que est protegido e este contedo no pode ser acessado. Para acessar o contedo do arquivo, clique no cone da direita e mude para Abrir com senha. O cone fica colorido, indicando acessibilidade dos arquivos .

44

Manual E3

ELIPSE E3

Figura: App Browser com o projeto protegido e atravs do clique com o boto direito, acessado o menu

Figura: Login para ser informada a senha de proteo para acesso a edio e e visualizao do projeto

O contedo dos Libs e prj protegidos so criptografados. Quando um projeto protegido, as propriedades DocString e Domain so bloqueadas. Atualmente, os mdulos disponveis no E3 so o Servidor de Dados, Banco de dados, Histrico, Configurao de Alarmes, Servidor de Alarmes, Frmula, Relatrio, Driver de comunicao, Driver de Comunicao OPC, Tela, Viewer e Quadro (Frame). Ao carregar uma aplicao j existente, os mdulos no so imediatamente carregados, apenas sua existncia mostrada. Isso permite que a carga da aplicao seja mais rpida, sendo que o usurio pode carregar depois somente os mdulos que realmente sero editados. Um mdulo descarregado tem a aparncia semitransparente, indicando que no est em memria. Para carreg-lo, basta dar um duplo-clique ou ento acessar pelo boto direito a opo "Abrir". Devido arquitetura mostrada, cada mdulo precisa ser salvo independentemente, apesar dos dados pertencentes a ele ficarem armazenados no mesmo arquivo da aplicao qual ele pertence, o arquivo PRJ. Quando um mdulo, qualquer propriedade ou objeto interno modificado, o smbolo * mostrado logo ao final de seu nome no Organizer, indicando que ainda no foram salvas as alteraes. Logo aps a gravao em disco, o smbolo * retirado, indicando que o processo de salvamento foi concludo com sucesso. Dentro de cada mdulo podem ser inseridos seus prprios objetos, cujos tipos ficam definidos internamente pelo mdulo. Assim, voc pode inserir tags de comunicao
Manual E3 45

ELIPSE E3

dentro de um mdulo de comunicao, verificaes de alarme em um mdulo de alarmes, etc..., acessados atravs de um clique com o boto direito sobre o mdulo ou objeto dentro do mdulo. Um menu especfico mostrar as opes disponveis. Cada mdulo tambm possui uma janela que aberta na rea de trabalho, de onde podem ser editados seus objetos, alm do Organizer. A Janela de edio pode ser acessada atravs de um duplo-clique sobre o mdulo.

1.12.4.Propriedades
Na rea de trabalho, toda a vez que inserido um novo projeto ou objeto, o sistema abre uma caixa de configurao das propriedades do objeto selecionado. Alm das propriedades padro que todos os objetos possuem, existem tambm as propriedades especficas de cada objeto. O objeto pode ter caractersticas prprias, ou semelhantes e correlacionadas com outros objetos.

Na caixa de ttulo das propriedades estar sempre o nome do objeto selecionado no momento. Para que esta caixa esteja visvel no projeto, necessrio que a opo esteja marcada no item Janela de Propriedades do menu Visualizar. As propriedades padro dos objetos so:

46

Manual E3

ELIPSE E3

Propriedades Padro dos objetos

Manual E3

47

ELIPSE E3 PROPRIEDADES Angle BackgroundColor BorderColor BorderStyle BorderWidth DocString Effect3D Effect3DColorBase Effect3DColorTop Effect3D_X Effect3D_Y Enabled FillStyle ForegroundColor GradientStyle HasFocus Height HorizontalFillStyle HorizontalPercentFill Layer MouseOver MouseOverChild Name Shadow ShadowColor ShadowX ShadowY Width TabStop Tip VerticalFillStyle DESCRIO Seta ou retorna o nmero inteiro do ngulo de rotao deste objeto. Seta ou retorna o nmero inteiro da cor de fundo deste objeto. Seta ou retorna o nmero inteiro da cor da borda/linha deste objeto. Seta ou retorna o nmero inteiro do estilo da borda do objeto. Seta ou retorna o nmero inteiro da espessura da linha/borda deste objeto. Retorna ou seta a string de documentao do objeto. Determina a aplicao do efeito 3d no objeto selecionado. Determina a cor da base do efeito 3D no objeto. Determina a cor do topo do efeito 3D no objeto. Seta ou retorna o tamanho do efeito 3D no eixo X. Seta ou retorna o tamanho do efeito 3D no eixo Y. Seta ou retorna o boleano que habilita a funcionalidade deste objeto. Seta ou retorna o nmero inteiro do estilo de preenchimento do objeto. Seta ou retorna o nmero inteiro da cor de frente deste objeto. Seta ou retorna o nmero inteiro do estilo de preenchimento do degrad do objeto. Determina o foco do campo no objeto. Seta ou retorna o nmero da altura deste objeto. Seta ou retorna o nmero inteiro do estilo do preenchimento horizontal do objeto. Seta ou retorna o nmero inteiro da porcentagem de preenchimento horizontal do preenchimento do objeto. Seta ou retorna o nmero inteiro da mscara da camada deste objeto. Retorna o boleano que informa se o mouse est sobre o objeto. Retorna o boleano que informa se o mouse est sobre um filho deste objeto. Retorna ou seta o nome do objeto. Retorna o boleano que habilita/desabilita a sombra do objeto. Seta ou retorna o nmero inteiro da cor da sombra deste objeto. Seta ou retorna o nmero da coordenada horizontal esquerda da sombra do objeto. Seta ou retorna o nmero da coordenada vertical superior da sombra do objeto. Seta ou retorna o nmero da largura deste objeto. Determina a utilizao da tecla TAB na edio. Retorna ou seta o texto de dica do objeto. Seta ou retorna o nmero inteiro do estilo do preenchimento vertical do objeto.

48

Manual E3

ELIPSE E3 VerticalPercentFill Visible X Y Seta ou retorna o nmero inteiro da porcentagem de preenchimento vertical do preenchimento do objeto. Seta ou retorna o boleano de visibilidade do objeto. Seta ou retorna o nmero da coordenada horizontal esquerda relativa a este objeto. Seta ou retorna o nmero da coordenada vertical acima relativa a este objeto.

A Janela de Propriedades possui duas colunas: os mtodos (somente propriedades os eventos so vistos nos scripts e as funes pelo AppBrowser) e os valores. Voc pode configurar um valor para uma propriedade digitando diretamente no campo selecionado, ou ainda seguindo ainda as instrues da janela ao clicar sobre o campo Valor. Isso porque, a depender da propriedade que se deseja editar, ser exibida uma janela especfica de configurao, como Janela de edio de cores para uma propriedade cor, Janela de busca de arquivos para propriedade de arquivos, etc... Ao lado de cada mtodo exibido um cone que indica o tipo de dado listado.

Figura: janela de propriedades

Os tipos de dados disponveis no E3 so aqueles pertencentes ao mdulo Standard, visualizado pelo Tab Classes do Organizer, listados abaixo:

Manual E3

49

ELIPSE E3

Tipos de Dados disponveis


CONE DESCRIO

Nulo ou sem valor


Tipo Digital implementado como um Integer (-1= TRUE e 0= FALSE) Numrico de 8 bits (0 a 255) Numrico de 16 bits (-32768 a 32767) Numrico de 32 bits (-2147483648 a 2147483647) Real (3.4E +/- 38 - 7 digits) Real (1.7E +/- 308 - 15 digits) Unidade Monetria Inteiro de 96 bits Data em formato Gregoriano (dias desde 1899, e pode ser formatado pelo usurio) Texto Tipo Varivel pode assumir vrios formatos. Numrico de 16 bits (0 a 65535) Numrico de 32 bits (0 a 4294967296) Numrico de 8 bits (-128 a 127) Cdigo de Erro do tipo Dword Numrico de 32 bits com cdigo de cor Tipo de Fonte Arquivo de Imagens Pena Grfica Tipo de Ferramenta de Desenho Caminho de Arquivo Formatao de Dados a ser aplicada a um valor Associao entre Objetos Numeradores automticos Associao Analgica entre Objetos Associao de Movimento entre Objetos Funo a ser executada em um Script Evento disponvel para a gerao de Scripts Projeto E3

TIPO DE DADO Void Boolean Byte Integer Long Single Double Currency Decimal Date String Variant Word Dword Char Error Color Font Picture Pen Brush FilePath Format Link Enum AnalogBind AnimationBind Function Event Project

50

Manual E3

ELIPSE E3

1.12.5.Eventos
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 E3 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. Os eventos podem ser fsicos, como por exemplo, alguma ao no teclado. Neste caso, a informao relevante seria a tecla pressionada (dentre outras); ou se o evento vem do mouse, a informao relevante seria a posio do cursor e o status dos botes. Os eventos podem ser internos, como a mudana de uma temperatura de uma cmara de 10 para 11 graus. Eventos Padro
EVENTOS Click DESCRIO Ocorre quando o boto esquerdo do mouse pressionado sobre o objeto. DbClick Ocorre quando o boto esquerdo do mouse pressionado duas vezes sobre o objeto. KeyDown Ocorre quando o objeto tem o foco e o usurio pressionou uma tecla. KeyUp Ocorre quando o objeto tem o foco e o usurio soltou uma tecla. OnStartRunning Ocorre quando inicia a execuo de uma instncia deste objeto. OnStopRunning Ocorre quando finaliza a execuo de uma instncia deste objeto.

1.12.6.Mtodos
A Janela de Propriedades possui duas colunas: os mtodos (somente propriedades os eventos so vistos nos scripts e as funes pelo AppBrowser) e os valores. Voc pode configurar um valor para uma propriedade digitando diretamente no campo selecionado, ou ainda seguindo ainda as instrues da janela ao clicar sobre o campo Valor. Isso porque, a depender da propriedade que se deseja editar, ser exibida uma janela especfica de configurao, como Janela de edio de cores para uma propriedade cor, Janela de busca de arquivos para propriedade de arquivos, etc... Ao lado de cada mtodo exibido um cone que indica o tipo de dado listado. Mtodos Padro
MTODOS Activate AddObject Deactivate DeleteObject Item DESCRIO Seta ou retorna a ativao do objeto no projeto. Adiciona um objeto na aplicao via script. Seta ou retorna a desativao do objeto no projeto. Deleta o objeto especificado. Retorna um objeto filho deste objeto conforme o nome especificado.

Manual E3

51

ELIPSE E3

1.13. App Browser


O App Browser uma ferramenta de edio dentro do E3 Studio, criada para facilitar o processo de identificao e cpia de propriedades/funes, e pode ser utilizada em trs situaes: Pela Janela de Propriedades, na escolha de algum valor do tipo Link para uma propriedade; Na Janela de Associaes (Links) dos Objetos, para escolha do campo Fonte (Origem dos Dados); Na edio de Scripts.

O App Browser permite navegar facilmente pela aplicao ou aplicaes, e ao selecionar um objeto na rvore ao lado esquerdo da janela , seus atributos e funes, que podem ser copiadas para a posio atual do cursor (identificada pelo cone ) atravs do boto "Copiar". No campo Texto visto acima, mostrado o caminho completo do item selecionado, e na parte inferior mostrado com o ttulo "Info" seu DocString. Outra caracterstica do App Browser opo de AutoOcultar, identificada pelas setas direcionais, vistas ao lado do boto de fechar. Ao clicar sobre o smbolo deixando-o na posio apontada para cima, o App Browser ficar fixo, com a opo de Auto-Ocultar desabilitada. Ao deixar o tringulo apontado para a esquerda, a opo estar habilitada, bastando permanecer com o mouse alguns segundos fora da rea do App Browser, para que este permanea na forma minimizada.

Figura: App Browser

52

Manual E3

ELIPSE E3

1.14. Links
Links ou Conexes so as ligaes feitas entre os aplicativos e destes para seus mdulos, pela qual interligam-se entre si. Permite aos mdulos, servidores e clientes se conectarem/desconectarem em execuo, alm de permitir e coordenar o fluxo de informaes entre eles. Isso permite a cada Projeto ser executado e/ou interrompido, sem prejudicar o funcionamento do software. Os links trazem permitem grande facilidade ao criar animaes e outros tipos de associaes, visto que no necessrio a execuo de lgicas ou scripts para associar duas variveis quaisquer. Ao digitar ou associar um objeto ou propriedade no campo Fonte, o texto aparecer na cor azul, caso este corresponda a um tem existente e/ou carregado no Studio. Se o tem no existir ou pertencer a um mdulo no presente ou descarregado, o texto aparecer em vermelho. Para utilizar este recurso, proceda assim: Ao clicar com o boto direito do mouse sobre cada mdulo ou objeto, escolha a opo "Propriedades". Temos acesso, alm da pgina principal de configurao do objeto, as pginas Associaes e Scripts, que so padro para todos os objetos. A pgina Associaes permite acesso todas as propriedades do objeto em questo, para que possam ser diretamente ligadas com qualquer outra propriedade de qualquer outro objeto, mesmo que esteja em outro mdulo ou em outra aplicao.H vrios tipos de conexes por Links: Conexo simples : Na Conexo Simples, o valor do campo Fonte copiado para a propriedade toda vez que o primeiro for modificado.

Manual E3

53

ELIPSE E3

Conexo Bidirecional : Na Conexo Bidirecional, o mesmo acontece porm, caso tambm haja uma variao na propriedade, seu valor ser copiado para o Fonte, gerando assim um link de duas direes.

Conexo Digital : J na Conexo Digital, podemos estabelecer que caso a varivel do campo Fonte seja uma propriedade digital, seus estados verdadeiro e falso sejam mapeados para certos valores no Destino, incluindo a opo de Pisca (alternao de valores).

54

Conexo Analgica fonte e destino.

: Estabelecer uma escala de converses entre a varivel


Manual E3

ELIPSE E3

Captulo

5
5.

Domnios

Conexo por Tabela e destino.

: Podemos estabelecer condies entre a varivel, valores

Na tabela so especificados valores mnimo e mximo e valores referentes a estas condies.

Manual E3

55

ELIPSE E3

A fim de coordenar o uso de vrios aplicativos, entra em cena o conceito de Domnio, que o nome dado a um conjunto de aplicativos. Os aplicativos pertencentes a um Domnio podem ser executados em conjunto pelo Servidor (E3 Server), de forma a facilitar a configurao e execuo. O uso do Domnio facilita ainda a localizao do servidor pelos Viewer (E3 Viewer), alm de permitir a criao de unidades Stand-by no caso de algum componente, projeto ou Domnio vir a falhar. O E3 um ambiente modular de desenvolvimento e execuo de sistemas de superviso. Os seguintes mdulos compe o E3: E3SERVER O E3Server o coordenador de todos os outros mdulos do E3. simbolizado por um cone no system tray . O E3Server pode trabalhar apenas com um arquivo de domnio por vez, e este chamado de Domnio Aberto. responsvel por: Verificar e gerenciar licenas de uso dos diferentes mdulos do E3; Iniciar/Parar/Monitorar o processo de runtime (E3Run) do Domnio; Abrir/Editar/Manipular arquivos DOM; Controlar o acesso de usurios aos objetos do domnio; Monitorar outros servidores do domnio e implementar o Hot-Standby

O E3Server pode trabalhar apenas com um arquivo de domnio por vez, e este chamado de Domnio Aberto. IOSERVER O IOServer o processo responsvel pela execuo dos drivers de I/O. Cada driver roda em um IOServer separado. Os IOServers so criados/mantidos/monitorados pelo processo E3Run.

STUDIO O Studio o ambiente de desenvolvimento e configurao de aplicativos. Permite abrir/editar arquivos PRJ e LIB. O Studio multiusurio, isto , vrios Studios podem modificar os mesmos arquivos ao mesmo tempo. VIEWER O Viewer a interface como usurio em runtime, onde mostra as telas em execuo e permite a operao do sistema. O Viewer pode ser rodado a aprtir de qualquer
56 Manual E3

ELIPSE E3

ponto da rede que tenha acesso ao E3Server. No necessrio copiar o aplicativo para rodar o mdulo Viewer, pois as telas e bitmaps so baixados conforme a necessidade em tempo de execuo. Um domnio do E3 corresponde ao que se chamava de aplicativo no Elipse Scada, que um conjunto de objetos e configuraes que define um sistema de superviso. O Domnio representado por um Nome (Nome do Domnio) que informado em cada Projeto. Um arquivo de Domnio indica o nome e caminho de todos os projetos que fazem parte de um Domnio, e utiliza a extenso .DOM. Os seguintes arquivos constituem o domnio: DOM ARQUIVO DE CONFIGURAO DO DOMNIO O arquivo .DOM armazena quatro tipos de informaes: opes de configurao do domnio; lista de arquivos PRJ e LIB que contm os tags, telas, definies de objetos, etc; configurao dos servidores (micros) que iro rodar o domnio; configurao de usurios e acesso.

PRJ ARQUIVO DE PROJETO Um domnio pode ter 1 ou mais aqruivos de projeto. Cada arquivo PRJ contm definies de objetos, tags, telas, histricos, alarmes, bitmaps, etc. A organizao dos objetos de um arquivo PRJ livre, podem ser criados diversos nveis de folders (diretrios) dentro do PRJ, e cada folder pode conter qualquer tipo de objeto. O usurio pode dividir os objetos de um sistema de superviso em um ou mais arquivos PRJ, dependendo das suas necessidades. Em tempo de execuo, cada PRJ pode ser ativado independentemente dos outros, inclusive em servidores diferentes. A execuo distribuda do sistema (em vrios computadores) e a capacidade de parar seletivamente partes do aplicativo, determinam a separao dos objetos em vrios arquivos PRJ. LIB - ARQUIVO DE BIBLIOTECA Os arquivos .LIB contm definies de objetos criados pelo usurio (ElipseX) que podem ser utilizados nos arquivos de projeto.

1.15. Execuo do Domnio


A Execuo do Domnio se d atravs do E3Server.exe, que pode receber como parmetro de inicializao um arquivo de projeto (extenso PRJ) ou um arquivo de Domnio (extenso DOM) Ao entrar em execuo, o E3Server se apresenta como um cone no Tray do Windows 2000, como a seguir:
Manual E3 57

ELIPSE E3

Domnio E3Server
CAMPO DESCRIO

Ao iniciar a execuo de um domnio, o cone do E3Server se apresenta com a cor cinza, indicando que o projeto est em fase de inicializao. Ao encerrar a inicializao, o cone ter a cor verde, indicando que o domnio est em execuo. Ao interromper a execuo de um projeto, o cone apresenta a cor vermelha, e aps o trmino do processo de shutdown, caso seja o nico ou o ltimo de um domnio, o cone de execuo ser retirado do Tray. Durante a execuo do E3Server, podemos requisitar a execuo de novos projetos ou interromper a execuo dos projetos que j estejam rodando. Isso pode ser feito atravs de um clique com o boto esquerdo do mouse sobre o cone do E3Server, onde aparecero as opes "Iniciar Aplicao", "Finalizar Aplicativos!", ou "Finalizar Aplicao". As mesmas requisies podem ser feitas atravs do E3 Studio, selecionando-se o projeto e clicando no boto "Executa".

1.16. Configurao do Domnio


O Studio permite algumas operaes bsicas sobre o domnio:

1.16.1.Na Barra de Ferramentas Padro

Executa aplicativo: Atravs desta opo, possvel executar o domnio corrente (ou forar que os projetos sejam atualizados, caso j estejam em execuo) e habilitar o Viewer.

58

Manual E3

ELIPSE E3

Parar/ Rodar: Executa ou para a execuo do domnio corrente. Executar/Parar o Viewer: Abre/Fecha a visualizao do Viewer. Verifica se o domnio contm erro: Atravs desta opo, possvel verificar pelo E3 Studio se o domnio corrente contm erro. Este recurso mostra uma mensagem de aviso, caso algum erro seja encontrado e se no tem nenhum erro. Tal especificaes so mostradas na barra de status do projeto:

Mostra o erro anterior e prximo erro: Atravs destas opes, possvel verificar o erro anterior e o prximo erro do domnio do sistema. O sistema indicar na barra de status os erros encontrados e eles aparecero at que sejam corrigidos. Aps os erros serem corrigidos, o sistema indicar uma mensagem informando que o sistema foi liberado, conforme figura acima. Mostrar prximo erro: Atravs destas opes, possvel verificar o prximo erro do domnio do sistema. O sistema indicar na barra de status os erros encontrados e eles aparecero at que sejam corrigidos. Aps os erros serem corrigidos, o sistema indicar uma mensagem informando que o sistema foi liberado.

1.16.2.No Organizer
Salvar No menu Arquivo, possvel configurar o domnio do projeto. Novo Domnio Atravs desta opo possvel criar um domnio padro, pela qual o sistema utilizar este recurso para a execuo do projeto. Para utilizar este recurso, proceda assim:
Manual E3 59

ELIPSE E3

Clique no Menu Arquivo e selecione a opo Novo domnio. O sistema abrir uma janela de dilogo questionando o local onde ser salvo o domnio. Informe o nome do domnio e pressione OK. Aps ser informado o local de armazenamento do arquivo, o sistema questionar se desejas inserir o novo domnio no projeto. Clique em Yes para confirmar a insero e em No para cancelar a insero (Um domnio pode ser inserido a qualquer momento. Para isto, basta utilizar a opo Inserir Domnio, atravs do clique com o boto direito do mouse sobre o nome do projeto e selecionando a opo).

Figura1: Mensagem do domnio

Para remov-lo do projeto, basta utilizar a opo Remover Domnio.

Toda a vez que se inicia o E3 Studio, na tela inicial questionado o que o usurio deseja fazer. Dentre as opes disponveis, est Novo Domnio. Escolhendo esta opo, o sistema criar um novo domnio com todas as especificaes e informaes padres, para que o mesmo possa ser utilizado eventualmente.

Figura1: Assistente de aplicao

Nesta tela de domnio, o sistema questiona se esta aplicao vai pertencer a qual domnio. Nisto, possvel especificar se deseja Adicionar no domnio ativo, Criar um novo domnio (pela qual, este novo domnio ser inserido no sistema) ou No adicionar em nenhum domnio. Adicionar no domnio corrente Atravs desta opo, possvel adicional o domnio que est sendo criado para a aplicao corrente, pela qual o sistema indicar.
60 Manual E3

ELIPSE E3

Figura2: Adicionar no domnio corrente

Abrir Domnio Atravs desta opo possvel abrir um domnio do sistema na aplicao em uso. Para utilizar este recurso, siga os seguintes procedimentos: Clique no Menu Arquivos e selecione a opo Abrir Domnio. Selecione o(s) domnio(s) que deseja inserir no projeto. Clique em Open para inserir o domnio. Fechar Domnio Atravs desta opo possvel fechar o domnio corrente na aplicao. Remover Domnio Atravs desta opo, possvel remover o domnio da aplicao corrente.

1.16.3.Configuraes do domnio via E3Server


O E3Server o coordenador de todos os outros mdulos do E3. simbolizado por um cone no system tray. O E3Server responsvel por: Verificar e gerenciar licenas de uso dos diferentes mdulos do E3; Iniciar/ Parar/ Monitorar o processo de runtime (E3Run) do Domnio; Abrir/ Editar/ Manipular arquivos DOM; Controlar o acesso de usurios aos objetos do domnio; Monitorar outros servidores do domnio e implementar o Hot-Standby;

Voc tambm pode configurar o Domnio via E3Server. Para tanto, basta acessar o cone do E3Server com o clique do boto direito e selecionar o tem Opes. Clique com o boto direito do mouse sobre a caixa de execuo do projeto e selecione a opo Domnio. Nesta opo, contm vrios itens:

Manual E3

61

ELIPSE E3

EXECUTAR O DOMNIO: Executa o domnio do projeto corrente. Quando este boto pressionado, o sistema abre uma caixa de mensagem informando algumas especificaes referentes ao projeto.

Pressionando novamente este boto, o sistema fecha o domnio e a visualizao do projeto no Viewer. Num domnio podem ser inseridos um ou vrios projetos. Para isto, existem vrios processos a serem utilizados. Abaixo ser descrita toda a informao a respeito da sua utilizao: OPES: Este tpico permite que sejam configuradas as informaes referentes ao domnio. Para utilizar este recurso, siga os seguintes procedimentos: Clique com o boto direito do mouse sobre a caixa de execuo do projeto e selecione a opo Domnio Opes; Nessa janela podemos configurar os projetos e bibliotecas do domnio. As opes disponveis so as seguintes:

1.16.4.Opes
Este tpico permite que sejam configuradas as informaes referentes ao domnio. A tela abaixo ser mostrada, com as configuraes do domnio:

62

Manual E3

ELIPSE E3

Figura: E3Server tem Opes

Atravs das opes deste tem, possvel configurar o domnio em rede ou local. Para tanto, basta especificar as informaes nos campos correspondentes. Campos do E3Server Opes Caminho de acesso aos arquivos do domnio em rede: Esta opo permite que seja especificado o caminho na rede, de acesso dos arquivos do domnio. Habilitar distribuio em rede: Permite que o domnio seja distribudo em rede, isto , em mais de um ser. Se a opo for desabilitada, ento o domnio executar no servidor em que foi carregado, sem suporte a Hot-Standby. Se a distribuio em rede for habilitada, ser possvel selecionar um servidor principal onde o domnio ser executado, e opcionalmente, um servidor em standby. Marque esta opo se o domnio deve rodar em rede. Se estiver desmarcado ento o domnio roda no servidor em que foi carregado, sem suporte a hot-standby. Se a distribuio em rede for habilitada voc deve selecionar um servidor principal onde o domnio ser executado, e opcionalmente um servidor em standby.

Importante: A DISTRIBUIO EM REDE NO EST DISPONVEL EM MODO DEMO!!!Quando o domnio est distribudo em rede necessrio que todos os servidores tenham uma cpia dos arquivos do domnio (.DOM, .PRJ e .LIB) e a mesma rvore de diretrios. Quando o domnio est distribudo em rede, os seguintes procedimentos so necessrios:
Manual E3 63

ELIPSE E3

Definir um diretrio compartilhado na rede para conter a cpia principal dos arquivos do domnio. Este diretrio deve residir em um computador que no faa parte do Domnio E3. Criar em cada servidor do E3, um diretrio onde ser mantida uma cpia atualizada dos arquivos do domnio. O E3Run ir utilizar esta cpia local dos arquivos PRJ e LIB. Abrir sempre o arquivo DOM da rede, utilizando o caminho de rede (Ex: \\server\folder\domnio.dom) Quando utilizar o E3Studio, sempre edite os projetos e bibliotecas da cpia principal (na rede). Para aplicar as alteraes, copie os PRJs e Libs alterados para o diretrio local dos servidores do domnio. Aps a cpia, clique no boto Studio para que as alteraes sejam aplicadas no processo de runtime (E3Run). do

Servidor Principal: Selecione o nome do servidor principal para execuo do domnio. Para cadastrar e configurar os servidores, utilize a pgina de Servidores. Servidor de backup: Marque esta opo e selecione um servidor da lista se voc deseja ter um servidor de backup. Este servidor ficar em STANDBY, com o aplicativo carregado no E3Run pronto para executar caso o servidor principal entre em falha ou o servidor de backup seja ativado manualmente. IMPORTANTE: Quando o domnio colocado em execuo, o E3 Server sempre escolhe o servidor ativo por ordem alfabtica, independente se est selecionado como principal ou backup. Este critrio de desempate utilizado sempre que mais de um servidor se candidata a executar o domnio (veja detalhes mais abaixo em Hot-Standby no E3).

Endereo para PING de integridade da rede: O algoritmo de Hot-Standby exige que seja declarada uma terceira entidade de rede (as outras so os servidores principal e backup) para determinar se a rede est funcionando. Se no for possvel acessar o endereo de integridade nem o servidor de backup, o servidor principal assume que a sua interface de rede est com problemas e termina imediatamente a execuo do domnio (veja detalhes mais abaixo em Hot-Standby no E3). Conta de usurio para execuo do E3Server: Atravs das opes deste tem, possvel especificar conta do usurio que tero acesso as configuraes do domnio na execuo do mesmo. Reiniciar o domnio em caso de falha: Esta opo reinicia o domnio corrente em caso de falha.

64

Manual E3

ELIPSE E3

1.16.5.Projetos
Este tpico permite as configuraes das informaes referentes aos projetos do domnio.

Figura: E3Server tem Projetos

Atravs das opes deste tem, possvel configurar a distribuio em rede. Para tanto, basta especificar as informaes nos campos correspondentes, referentes ao Servidor principal e o Servidor de backup. Campos do E3Server Projetos Nome: Esta opo lista os nomes dos projetos no sistema. Adicionar / Remover Atravs destas opes, pode-se remover ou adicionar projetos no sistema. Para adicionar um projeto, basta clicar no boto Adicionar e especificar os campos Nome do projeto e tens da Distribuio em rede. Para remover um projeto, basta selecion-lo na lista e clicar no boto Remover. Em manuteno (execuo desabilitada): Esta opo permite que seja desabilitada a execuo do domnio no do projeto. Isto possibilita desabilitar o domnio, evitando que ocorram erros na execuo do projeto. Se a opo habilitada, o sistema mostra o cone , demonstrando que o projeto no ser utilizado. Os demais projetos com o cone , mostram os projetos habilitados.

1.16.6.Servidores
Este tpico permite configurar as opes referentes aos Servidores do domnio.

Manual E3

65

ELIPSE E3

Figura: E3Server- tem Servidores

Atravs das opes deste tem, possvel configurar as informaes do servidor na rede e caso queira, a conta do usurio para execuo do E3Server. Campos do E3Server Projetos Nome: Esta opo lista os nomes dos servidores no sistema. Adicionar / Remover Atravs destas opes, pode-se remover ou adicionar servidores no sistema. Para adicionar um servidor em rede, basta clicar no boto Adicionar e especificar os campos Nome do servidor, Identificao do servidor na rede e para adicionar um servidor local, basta especificar o tem Caminho local de acesso aos arquivos de domnio. Caso deseje especificar alguma conta de usurio para a execuo do domnio, basta especificar as informaes no tem Conta de usurio para execuo do E3Server. Para remover um projeto, basta selecionlo na lista e clicar no boto Remover. Caminho local de acesso aos arquivos do domnio: Marque esta opo para indicar a localizao dos arquivos do domnio (.PRJ e .LIB) no servidor selecionado quando estes no estiverem no mesmo diretrio do .DOM. recomendado que os arquivos do domnio SEMPRE ESTEJAM NO MESMO DIRETRIO QUE O ARQUIVO DOM, portanto normalmente esta opo estar desabilitada. Identificao do servidor na rede: Digite o nome do servidor na rede, deve ser o nome da mquina com ou sem as barras duplas no incio (ex.: \\server ou server).

66

Manual E3

ELIPSE E3

Em manuteno (execuo desabilitada): Esta opo permite que seja desabilitada a execuo do servidor no projeto. Isto possibilita desabilitar o servidor, evitando que ocorram erros na execuo do domnio projeto. Se a opo habilitada, o sistema mostra o cone , demonstrando que o servidor no ser utilizado. Os , mostram os servidores habilitados.

demais servidores com o cone

1.16.7.Licenas
Voc tambm pode configurar o Domnio via E3Server. Para tanto, basta acessar o cone do E3Server com o clique do boto direito, selecionar o tem Opes e clique com o boto direito do mouse sobre a caixa de execuo do projeto e selecione a opo Licenas.

Figura: Licenas

Opes disponveis: LICENSE ID: Informa o nmero da licena (hardkey), um hexa-decimal de oito dgitos. Se o hardkey no foi detectado, o nmero 00000000. E3 SERVER: Indica o tipo de E3Server. E3STUDIO: Indica o nmero de licenas disponveis e em uso do E3 Viewer. IOPoints: Indica o nmero de pontos de IO e de drivers disponveis e em uso. Maximum execution time: Indica o tempo mximo permitido de execuo de um aplicativo.

Manual E3

67

ELIPSE E3

1.16.8.Monitor
O Dialog de Monitorao mostra informaes em tempo real sobre o estado dos servidores do domnio.

Opes disponveis: Domnio atual: Mostra o nome do arquivo .DOM corrente e indica o estado do domnio: rodando ou parado. Endereo de ping: Mostra o estado da conexo com o endereo de integridade da rede.

A lista de servidores conectados mostra o estado dos outros servidores do domnio: Nome: Nome do servidor. Endereo: Endereo de rede do servidor. Ping: Mostra o estado do ping de rede com este servidor. Relgio: Mostra a hora local do servidor. Estado: Mostra o estado do domnio no servidor (Parado ou Rodando). Conexo: Mostra o estado da conexo DCOM com o servidor. Funo: Mostra uma lista de indicadores reportados pelo servidor:

68

Manual E3

ELIPSE E3

- Ativo: Este o servidor ativo do domnio; - Reserva: Este o servidor standby do domnio; - Falha(n): Servidor possui falhas locais reportadas; - Prioridade: O servidor requisitou prioridade para rodar o domnio, este indicador faz com que o servidor ativo passe para standby; - Candidato: O servidor est se candidatando a rodar o domnio; - E/S: O servidor possui IOServers ativos.

1.17. Hot-StandBy no E3
A ferramenta de Hot-StandBy do E3 tem como objetivo permitir que um servidor fique em estado de espera (standby), aguardando uma possvel falha de um outro servidor (servidor ativo). A troca de servidor ativo pode ser manual ou automtica. A troca manual acionada pelo Dialog de configurao do Domnio. A troca automtica ocorre quando o servidor em standby detecta que o servidor principal no est mais rodando. Um servidor pode assumir um dos seguintes estados: Servidor em manuteo: Este estado indicado na configurao do servidor do domnio. Um servidor em manuteno no toma parte em nenhum evento do domnio. Servidor Ativo: Apenas um servidor pode estar ativo em um domnio em um determinado momento. O servidor ativo aquele que est rodando o aplicativo (E3Run). Este estado est indicado na configurao do domnio, o servidor ativo o selecionado como Servidor principal (ou ento o Servidor de backup, caso a opo Ativar o servidor de backup estiver habilitada). O servidor ativo deve atualizar um arquivo de chave de runtime (.runkey) em intervalos regulares para indicar a sua atividade. O arquivo runkey criado no mesmo diretrio do domnio. O nome diferente para cada execuo do domnio, para evitar que um arquivo travado possa impedir a execues do aplicativo.

Manual E3

69

ELIPSE E3

Servidor Standby: Apenas um servidor pode estar em stanby em um domnio, em um determinado momento.O servidor standby roda o E3Run em modo stanby, o aplicativo fica carregado, apenas esperando o comando para inicializar a operao. Este estado est indicado na configurao do domnio. O servidor stanby selecionado como Servidor de backup (ou ento o Servidor principal, caso a opo Ativar o servidor de backup esteja habilitada). O servidor de backup monitora o arquivo Runkey; se no for atualizado regularmente, o domnio reconfigurado automaticamente para deixar o servidor standby como ativo. Servidor OffLine: Um servidor fica offline quando perde o acesso ao arquivo de domnio. Quando isto ocorre, o servidor para o E3Run e fica retentando o acesso ao DOM. Assim que o acesso refeito, o servidor pode ir para o estado Ativo, Stanby ou Inativo, conforme a configurao do domnio. Servidor Inativo: Um servidor fica inativo quando est declarado no domnio mas no est selecionado como Servidor principal nem como Servidor de backup. Mesmo inativo, este servidor monitora mudanas no arquivo de domnio, podendo passar para o estado Ativo ou Standby, se o dominio for reconfigurado.

IMPORTANTE: Para rodar uma aplicao distribuda no E3, necessrio que todos os servidores tenham acesso ao arquivo de domnio (DOM) atravs do mesmo caminho de rede, isto , o arquivo DOM deve estar em um diretrio compartilhado na rede. Todos servidores do domnio ficam constantemente monitorando o arquivo DOM para detectar mudanas na configurao do domnio.

1.17.1.Executando um Domnio Distribudo


Para executar um domnio distribudo, basta iniciar um dos seus servidores, os outros servidores so automaticamente iniciados pelo primeiro servidor. Para iniciar um domnio, crie um atalho para o E3Server com a seguinte linha de comando: E3Server.exe start \\server\folder\domain.dom Este comando pode ser feito inclusive de um servidor que no faz parte no domnio. Este servidor ir iniciar os servidores do domnio e depois ser automaticamente fechado. Um domnio pode ser iniciado tambm atravs do Studio, basta abrir o domnio (atravs do caminho de rede) e clicar no boto .

1.17.2.Parando um Domnio Distribudo


Um domnio pode ser parado por qualquer um dos seus servidores, atravs do cone do E3Server no System Tray. Escolha a opo Domnio... -> Parar e o servidor Ativo e o Standby iro terminar o processo E3Run. O domnio pode ser reiniciado escolhendo a opo Domnio... -> Executar. Se voc escolher a
70 Manual E3

ELIPSE E3

opo Domnio... -> Fechar os E3Servers sero fechados e os servidores estaro aptos a rodar outros domnios. Importante: As opes de parar e fechar um domnio AFETAM TODOS OS SERVIDORES DO DOMNIO e no apenas o servidor onde o comando executado!!!

1.17.3.Parando um dos Servidores do Domnio


A maneira correta de parar um dos servidores do domnio marc-lo como Em manuteno... na configurao do domnio. Se o servidor ativo for colocado em manuteno, o servidor standby ir passar para o estado ativo. Para recolocar o servidor no domnio, desmarque a opo Em manuteno... deste servidor.

1.17.4.Tempo de troca entre Servidores


O tempo para o servidor Backup assumir quando ocorre uma falha do servidor Ativo de aproximadamente 1 minuto. Este tempo permite que o servidor anterior termine a execuo do aplicativo (caso a falha seja de rede apenas).

1.17.5.Reconexo de Viewers
Quando h uma troca de servidores, os Viewers entram em processo de reconexo, tentando alternadamente conectar com o servidor backup e com o ativo. O usurio tem a opo de esperar o fim do processo de reconexo com o viewer atual, cancelar a reconexo (e fechar o Viewer) ou abrir uma nova sesso Viewer com o novo servidor.

1.18. Conectar a ...


A opo Conectar a... abre uma caixa de dilogo que permite conectar no servidor local ou remoto. A lista que esta opo dispe a dos servidors recentes. Para utilizar este recurso, necessrio acessar o menu Arquivo - Conectar a..., e a caixa de dilogo aberta:

Manual E3

71

ELIPSE E3

Figura: Conectar

Quando o Studio aberto, ele conecta automaticamente no ltimo servidor que estava conectado. Se a conexo falhar, a janela "Conectar a..." aberta para permitir conectar ao servidor local ou a outro servidor da rede. A conexo com um servidor remoto faz com que uma licena do E3Studio seja consumida no servidor remoto. O hardkey local no utilizado quando a conexo remota. O ttulo do E3Studio informa o nome do servidor conectado e tambm indica se est rodando em modo demo. DICA: Quando o usurio conectar a um servidor, importante que os aplicativos sejam abertos atravs de um caminho na rede. Em vez de usar "C:\projetos\projeto.dom" utilize "\\server\projetos\projetos.dom". Desta forma, o Studio e o E3Server remoto podero acessar os arquivos utilizando o mesmo caminho.

1.19. Senhas
Atravs desta opo, possvel controlar o acesso a Telas, em uma lista de nomes, onde a cada nome atribudo uma senha e um login. Conforme a opo setada, o sistema permitir acesso aos usurios cadastrados ou acesso ilimitado as telas do projeto. Os demais usurios podem atravs da mesma opo, trocar sua senha, atravs da digitao da senha antiga e da dupla confirmao da nova senha. As senhas e informaes dos usurios so gravadas num arquivo criptografado e independente dos demais no diretrio da aplicao. Para configurar as informaes do usurio, basta acessar no Menu do sistema, a opo Usurios e especificar os tens solicitados. Para o usurio se logar no sistema, deve-se obrigatoriamente executar o login para ter acesso as telas e demais especificaes do sistema, menos na tela de Abertura do projeto, pela qual todos os usurios tero acesso liberado. Neste tem, o sistema disponibiliza vrias opes de configurao:

72

Manual E3

ELIPSE E3

1.19.1.Permisses
Configura as permisses dos usurios quanto ao sistema e suas devidas especificaes.

Figura1: Permisses dos usurios

CAMPOS Usurio/Grupos: Esta opo lista os usurios e/ou grupos de usurios configurados no sistema. Tais parmetros podem ser informados atravs das Abas Usurio e Grupos, que sero vistas a seguir. Assim, com o usurio selecionado, possvel na opo Items para segurana marcar os tens ao qual este usurio tem acesso. ITENS DE SEGURANA: Este tem mostra as opes disponveis no sistema para o usurio ter acesso ou no, ao qual sero especificadas em Permisses. USURIOS/GRUPOS: So filtros das opes de configurao. Pode-se selecionar a opo Usurios, se deseja visualizar somente os usurios registrados, ou a opo Grupos, se desejar visualizar somente os grupos registrados. PERMISSES: Mostra as permisses dos usurios e grupos no sistema.

Escolhendo a opo Legenda, a seguinte tela ser mostrada:

Manual E3

73

ELIPSE E3

Figura2: Legenda das permisses disponveis para os usurios

CAMPOS DA LEGENDA

Permitido: Atravs deste tem, o sistema permite ao usurio selecionado as telas e especificaes selecionadas para o mesmo. No Permitido: Atravs deste tem, o comando no permitido para este usurio, independente do(s) grupo(s) que ele pertence. Permitido pelo grupo: Atravs deste tem, de acordo com o(s) grupo(s) a que o usurio pertence, este comando permitido. No permitido pelo grupo: Atravs deste tem, de acordo com o(s) grupo(s) a que o usurio pertence, este comando no permitido. No informado: Atravs deste tem, no h nada informado para este comando. No momento, este comando est permitido. Uma verificao de permisso consiste em uma informao que o membro do grupo tem sobre um comando que atua em um objeto especfico. Por exemplo: "Usurio1" tem permisso para o comando "Abrir" sobre o objeto "Tela1".

74

Manual E3

ELIPSE E3

Cada membro do grupo pode negar ou afirmar a permisso de um comando, independente do grupo a que ele pertence. Desta forma, ele no pode optar por sempre utilizar a informao definida pelos seus grupos. Se as informaes dos grupos forem conflitantes, ser usado a seguinte ordem de preferncia: Negar > Afirmar > Indiferente. Caso no seja encontrado nenhuma informao sobre um objeto especfico, a verificao de permisses ser feita na classe do objeto. Por exemplo: Caso o usurio esteja com permisso para abrir "Telas" e nao tenha nenhuma informao sobre abrir "tela1", ele podera abrir a "tela1". Se deseja, tambem pode negar o comando. NO QUERO USAR A VERIFICAO DE PERMISSES: Com esta opo habilitada, no sero feitas verificaes de permisses, mesmo que existam usurios cadastrados. No caso de no existir usurios, tambm no ser feito a verificao de permisses.

1.19.2.Usurios
Atravs da opo Usurios possvel configurar as informaes referentes os usurios que tero ou no acesso ao sistema. Para utilizar este recurso, preciso acessar o Menu Arquivos - Usurios ...- e clicar na aba Usurios. Aps a sua configurao, somente os usurios listados tero acesso ao sistema.

Figura3: usurios

Caso deseje incluir um novo usurio, clique no boto Novo e o sistema abrir uma tela de configurao do usurio. Neste tem, necessrio cadastrar os dados do usurio e clicar em Ok.

Manual E3

75

ELIPSE E3

Para colocar este usurio em um grupo de usurios, necessrio criar um Grupo (veja maiores detalhes no tpico Grupos).

Figura4: Adio de usurios

As senhas e informaes dos usurios so gravadas num arquivo criptografado e independente dos demais no diretrio da aplicao. Para ver as restries e permisses dos usurios, veja o item Permisses. Para o usurio se logar no sistema, deve-se obrigatoriamente executar o login para ter acesso as telas e demais especificaes do sistema, menos na tela de Abertura do projeto, pela qual todos os usurios tero acesso liberado.

1.19.3.Grupos
A opo Grupos permite que sejam configuradas as informaes referentes aos grupos. Cada grupo define caractersticas que sero comuns para todos os seus membros (usurios). Um grupo tambm pode pertencer a outro grupo. S no permitido pertencer a ele mesmo, ou pertencer a outro grupo que j pertenca a ele, ou seja, uma referncia circular. Para utilizar este recurso, necessrio acessar o menu Arquivos - Usurios... - e selecionar a aba Grupos.

76

Manual E3

ELIPSE E3

Figura: Grupos

Campos Nome: Determina o nome do grupo. Novo/Editar/Remover: Adiciona, edita ou remove um grupo. Quando utilizada a tecla adicionar ou editar, a tela a seguir mostrada, para configurao:

Figura: Adio de usurios. Para a edio de grupo, a mesma tela aparece, apenas constando no ttulo da janela Editar grupo.

1.20. E3WebViewer
O E3WebViewer um cliente web que permite a visualizao e controle de aplicaes E3 em navegadores com suporte tecnologia ActiveX, como o Internet Explorer. Desta forma, possvel visualizar e interagir com um processo de cho de fbrica atravs de um navegador web comum. O navegador pode estar em qualquer computador da rede que tenha acesso ao E3Server.
Manual E3 77

ELIPSE E3

Para iniciar a visualizao, basta digitar na barra de endereos o caminho aonde se encontra o E3Server. Caso nunca tenha sido realizada nenhuma visualizao no computador, o internet explorer vai iniciar a instalao dos componentes. Nota: Caso a instalao no inicie automaticamente, voc precisa verificar a configurao do seu Internet Explorer. Atualmente, o E3WebViewer funciona baseado no protocolo DCOM (Distributed Component Object Model) e seu uso recomendado apenas para uso em intranet. Aps instalado, o E3WebViewer vai funcionar exatamente como o Viewer, fazendo o download da aplicao (telas, bitmaps, etc). Todas as funcionalidades do Viewer so suportadas no E3WebViewer (E3Chart, E3alarm, etc...).

1.20.1.Instalao do IIS
Para que os clientes acessem o E3Server preciso que exista um servidor http. Junto com o Windows (XP, 2000) vem o Internet IIS (Internet Information Services) que pode ser usado como servidor http. Para utilizar este recurso, siga os seguintes procedimentos: Obs: Os procedimentos a seguir se aplicam somente ao computador que vai servir como servidor. Abra o Painel de Controle (ou Control Panel); Acesse a opo Adicionar programas (ou Add/Remove Programs); Clique em Adicionar um componente do windows (ou Windows Component);

78

Manual E3

ELIPSE E3

Figura1: Internet Information Service (IIS)

Selecione na lista o tem Internet Information Services (IIS) e clique em Prximo (ou Next); O sistema inicializar a instalao do software. Aguarde a finalizao do processo, para configurar o sistema.

1.20.2.Configurao do IIS
Aps instalado o IIS conforme as instrues acima, acesse o Painel de Controle Ferramentas Administrativas (ou Control Panel - Administratives Tools) Clique em Internet Information Services, no caso do WindowsXP, ou Internet Services Manager, no caso do Windows2000.

Manual E3

79

ELIPSE E3

Figura: IIS

Clique na opo Default Web Site Properties. Acesse a tab Documents. A seguinte tela ser mostrada:

Figura3: Configuraes

80

Remova os documentos e adicione um novo chamado E3WebClient.htm.


Manual E3

ELIPSE E3

Este procedimento habilita como pgina inicial (E3WebClient.htm) no endereo do computador servidor. Crie uma pgina html com o seguinte cdigo-fonte:

<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> <title>New Page 1</title> </head> <body topmargin="0" leftmargin="0"> <p> <object classid="clsid:7EB4D157-FACC-45BB-9536-C14B9DCE3CA7" id="E3Viewer1" width="100%" height="100%" align="center" codebase="http://server/e3-w2kviewer.exe"> <param name="_Version" value="65536"> <param name="_ExtentX" value="19209"> <param name="_ExtentY" value="14552"> <param name="_StockProps" value="0"> <param name="Domain" value="\\server"> </object> </p> </body> </html>

Basicamente, a pgina contm o ActiveX E3WebViewer e o caminho do arquivo de instalao. No E3WebViewer existe a propriedade Domain, que indica o endereo da mquina onde est rodando o E3Server. Este endereo pode ser o mesmo computador do servidor http ou outro computador da rede. Salve a pgina no diretrio C:\Inetpub\wwwroot\E3WebClient.htm, que o diretrio padro aps a instalao do IIS. Aps estes procedimentos, a estao cliente j pode acessar o servidor http atravs do internet explorer.

1.20.3.Visualizando a aplicao
Antes de iniciar a visualizao pela primeira vez da aplicao, verifique a configurao do seu internet explorer: Acesse o menu Ferramentas (ou Tools) Opes (ou Options), clique na pgina Segurana (ou Security) e selecione a opo Intranet. Aps, clique em Customizado (ou Custom Level).

Manual E3

81

ELIPSE E3

Figura4: Internet Options

Habilite as opes referentes aos controle ActiveXs conforme a tela abaixo:

Figura: Configuraes de segurana

82

Manual E3

ELIPSE E3

Campos Activex controls and plug-ins: Habilite a opo para Enable; Download unsigned ActiveX controls: Habilite a opo para Enable;

Initialize and script ActiveX controls not market as safe: Habilite a opo para Enable; Depois especificadas as configuraes, digite na barra de endereos o nome do computador configurado como servidor. Aps estes procedimentos, ser iniciada a visualizao da aplicao, ou a instalao se for a primeira visualizao.

Figura: WEB

1.20.4.Visualizando a aplicao Localmente


Junto com a instalao do E3, enviado uma pgina de exemplo para conexo local. Sua localizao no diretrio : E3\ Web. Para visualizar a aplicao localmente, basta chamar a pgina como o domnio, rodando no seu computador.

Manual E3

83

6
6.

Captulo

Drivers e Tags

O E3 permite a comunicao com equipamentos de aquisio de dados, controladores, CLPs (Controladores Lgicos Programveis), UTRs (Unidades Termiais Remotas), ou qualquer outro tipo de equipamento, atravs de Drivers de Comunicao ou Servidores OPC, de acordo com o tipo do equipamento ou tipo de comunicao necessria. Os Drivers de Comunicao do E3 so arquivos independentes com extenso DLL. Um arquivo de Ajuda fornecido com cada driver, contendo informaes importantes a respeito de sua configurao. Para cada Driver, voc pode configurar os parmetros de comunicao P e outras propriedades do driver, de acordo com as informaes fornecidas contidas na Ajuda. O objeto Driver de Comunicao o mdulo do E3 que possibilita a comunicao com um determinado equipamento/dispositivo usando os drivers DLL fornecidos pela Elipse Software. Para inserir um Driver de Comunicao em seu projeto (se ainda no houver) clique com o boto direito do mouse no nome do projeto, e selecione o item Driver de Comunicao, de acordo com a figura abaixo:

Figura1: Insero do objeto Driver de Comunicao

Tutorial E3

84

ELIPSE E3

As principais propriedades do Driver de Comunicao so as seguintes: Propriedades do Driver


PROPRIEDADE DriverLocation DriverName P1 P2 P3 P4 ReadRetries ShareServer WriteRetries DESCRIO

Seta ou retorna o string que define o caminho do arquivo do driver. Retorna o string que descreve o driver. Seta ou retorna o nmero inteiro do primeiro parmetro de configurao genrico do driver. Seta ou retorna o nmero inteiro do segundo parmetro de configurao genrico do driver. Seta ou retorna o nmero inteiro do terceiro parmetro de configurao genrico do driver. Seta ou retorna o nmero inteiro do quarto parmetro de configurao genrico do driver. Determina o nmero de retentativas de leitura que foram executadas para a comunicao do driver com o equipamento/dispositivo. Seta o boleano que define se o driver dever ou no ser compartilhado. Determina o nmero de retentativas de escrita que foram executadas para a comunicao do driver.

1.21. Tags
Os Tags so todas as variveis (numricas ou alfanumricas) envolvidas num aplicativo, e podem ser de vrios tipos, de acordo com a utilizao desejada. O valor do tag ou qualquer de seus atributos poder ser mostrado pelos objetos de animao na tela, utilizado en clculos atravs dos scripts, modificados atravs de aes do operador, etc. A superviso de um processo com o E3 ocorre atravs da leitura de variveis de processo no campo. Os valores dessas variveis sero armazenados nos IOTags, que so os Tags suportados pelo Driver de Comunicao. Para cada objeto de animao inserido na tela pode ser associado um ou mais Tags ou Propriedades de qualquer objeto do software. Existem tambm outros tipos de tags, como poder ser visto adiante, porm cada tipo de tag deve estar presente num servidor que suporta aquele tipo de tag deve estar presente num servidor que suporta aquele tipo de tag. Assim como os tags de comunicao devem ser inseridos em um driver de comunicao, os tags OPC devem ser inseridos em um Driver OPC e os Tags Internos e de simulao devem ser inseridos no Servidor de dados, que veremos adiante tambm. Para o E3 podem existir 3 tipos de servidores de tags, a saber:

Manual E3

85

ELIPSE E3

Driver de Comunicao: So os mdulos responsveis por coletar dados de equipamentos externos atravs da execuo de um servidor (IOServer.exe) que por sua vez carrega um arquivo DLL fornecido pela Elipse Software, que contm a implementao do Protocolo de Comunicao especfico daquele equipamento. Os dados a serem lidos ou escritos so os Tags de Comunicao, e so definidos a partir do driver de comunicao. Driver OPC: So os mdulos responsveis por coletar dados de equipamentos externos atravs da execuo de um Servidor OPC (OLE for Process Control) externo, que pode ser fornecido por qualquer empresa. O servidor OPC contm as informaes sobre o protocolo de comunicao do equipamento, alm de uma interface grfica onde podem ser definidos os tags de comunicao. Tais tags podem ser importados para o Driver OPC dentro do E3 (que neste caso atua como um OPC Client) ou ainda podem ser criados a partir do E3. Tais tags, por estarem inseridos dentro de um Driver OPC no E3 so chamados de Tags OPC.

DataServer: So os mdulos responsveis por executar ou abrigar a execuo de todas as outras variveis do processo que no so exatamente de comunicao, como tags internos, de demonstrao, ou ainda outras estruturas de dados como a parte de dados das bibliotecas ElipseX, chamados de Xobjects.

1.22. Tipos de Tags


Ao criar Tags, o usurio poder organiz-los livremente, de forma a facilitar a procura e identificao durante o processo de configurao, respeitando sempre as propriedades do mesmo. Os tipos de Tags disponveis no sistema so os seguintes:

86

MANUAL E3

ELIPSE E3

Tipos de Tags
TIPO Tag Demo MDULO QUE DESCRIO SUPORTA DataServer Tag utilizado para simulao de valores. Permite gerar curves definidas ou valores aleatrios, a partir da seleo de suas propriedades. DataServer Objeto de propsito genrico, utilizado para guardar valores de qualquer tipo, incluindo nmeros, textos e at outros objetos. IODriver Possibilita a leitura e/ou escrita de um conjunto de valores, utilizando o IODriver onde ele est inserido. IODriver Possibilita a leitura e/ou escrita de um conjunto de valores utilizando o IODriver onde ele est inserido. IODriver Posibilita o acesso a cada um dos elementos ou valores definidos no IOBlock. Permite tambm a leitura e/ou escrita individual dos valores, independente do IOBlock onde ele est inserido. OPC Seta ou retorna informaes de parmetros de configurao genricas do OPCTag. OPC utilizado para leitura e/ou escrita de valores em OPCTag, onde tais informaes de configurao sero setadas ou retornadas para o OPCDriver. OPC Possibilita a leitura e/ou escrita de um s valor, utilizando o OPCDriver, ao qual ele est inserido. OPC Possibilita a leitura e/ou escrita de um conjunto de valores utilizando o OPCDriver onde ele est inserido. Permite a leitura de vrios dados simultneos; OPC Possibilita o acesso a cada um dos elementos ou valores definidos no BlocoOPC. Permite tambm a leitura e/ou escrita individual dos valores, independente do Bloco OPC inserido.

Tag Interno IOTag

IOBloco Elemento de Bloco

Pasta OPC Grupo OPC

Tag OPC

Bloco OPC

Elemento de Bloco OPC

Manual E3

87

ELIPSE E3

1.23. Regras para o nome dos Tags


Ao especificar o nome dos tags, alguns detalhes devem ser levados em conta: O nome da varivel no pode conter caracteres reservados, como: [ ],\, /, :, ?, ".

Esses caracteres so trocados por caracteres de sublinhado: _ . Assim, o sistema aplica a seguinte regra: Uso do Colchete Se o 1- caracter no for uma letra ou caracter de sublinhado, o nome deve estar entre colchetes. Se algums dos demais caracteres (2- em diante) no for uma letra ou nmero ou caracter de sublinhado, o nome tambm deve estar entre colchetes. nome do tag no pode conter espaos, o que vale tambem para todos os outros nomes de objetos do E3. nome do tag no pode conter operadores lgicos e aritmticos tais como: ?,.,-,+, etc... nome do tag no pode ser estritamente numrico.

1.24. Criando Tags


Para a criao de novos tags, basta selecionar o mdulo Servidor adequado (DataServer, Driver de Comunicao (IODriver) ou OPCDriver) e com o boto direito do mouse, e selecionar o tipo de tag que deseja. Aps ser selecionado o tag, o sistema automaticamente nomear o tag, de acordo com a opo desejada. Para renome-lo, configure atravs das propriedades (Clique com o boto direito do mouse no nome do tag e selecione a opo Propriedades, ou d um duplo clique sobre o tag). Pode-se tambm selecionar o tag e pressionar a tecla F2(o sistema permitir que seja editado o nome do tag).

88

MANUAL E3

ELIPSE E3

1.25. Tags de Comunicao


De acordo com o que foi visto no captulo anterior, os tags devem ser inseridos em cada mdulo servidor de tags que suporta o tag desejado. Os tags inseridos dentro de um Driver de Comunicao so chamados Tags de Comunicao ou IOTags. Os Tags de Comunicao (ou IOTags) possibilitam a leitura e/ou escrita de um conjunto de valores, utilizando o IODriver (ou Driver de Comunicao), onde ele est inserido. Podem ser utilizados tambm os Blocos de Comunicao (ou IOBlock), para a leitura de mais de uma varivel simultnea, e para acessar cada valor do bloco, utilize os objetos Elemento de Bloco, que podem ser includos dentro do objeto. Atravs das propriedades do Tag de Comunicao ou Bloco de Comunicao possvel especificar qual conjunto de dados no equipamento/dispositivo este tag estar associado. Esta propriedade pode ser modificada depois de iniciada a comunicao. O mtodo Write far a escrita de um conjunto de valores no dispositivo/equipamento. Utilize a propriedade Scan para especificar qual o tempo de varredura ser utilizada pelo servidor, para atualizar o bloco. Esta propriedade representada em milissegundos e pode ser modificada depois de iniciada a comunicao, utilizada apenas quando a propriedade Allowread estiver setada para True. A propriedade TimeStamp atualizada sempre que ocorre alguma mudana de valor ou estado nas propriedades Value ou Quality dos tags. Ele informa qual a data/hora associada tanto aos valores quanto qualidade dos dados lidos em bloco. Tipos de Dados Os tipos de dados disponveis no sistema so os seguintes:

1.25.1.Pasta de Comunicao (IOFolder)


Definem Grupos ou Subdiretrios de forma a melhor Organizar as variveis; Cada IOFolder pode ser renomeado conforme a necessidade, e novos IOFolders podem ser inseridos dentro de outros.

1.25.2.Tag de Comunicao (IOTag)


usado para definir a troca de informaes com os equipamentos de aquisio, que consistem em 1 (uma) nica varivel independente. O IOTag pode ser uma varivel analgica, entrada, sada, contador, ponto digital, etc... Vrios pontos digitais podem ser agrupados em um IOTag e serem acessados atravs de suas propriedades como Bits de Dados. Os IOTags so configurados atravs de uma srie de parmetros N (N1 a N4) que variam de acordo com o driver de comunicao a ser utilizado. Para utilizar este recurso no sistema, siga os seguintes procedimentos:

Manual E3

89

ELIPSE E3

Insira um Tag de Comunicao no projeto, clicando com o boto direito do mouse na pasta Driver e insira um Tag. Caso necessite, configure suas propriedades, conforme as especificaes: Propriedades do IOTag
PROPRIEDADE AllowRead AllowWrite DeviceHigh DeviceLow EnableScaling EU EUHigh EULow N1 N2 N3 N4 Quality Scan TimeStamp UseBitFields Value Bit00-Bit31 DESCRIO

Seta ou retorna o boleano que habilita a leitura do IOTag. Seta ou retorna o boleano que habilita a escrita do IOTag. Seta ou retorna o nmero do limite mximo de valor que o tag atinge no equipamento. Seta ou retorna o nmero do limite mnimo de valor que o tag atinge no equipamento/dispositivo. Seta ou retorna o boleano que define se o tag deve ou no fazer ajuste de escala do valor lido/enviado ao equipamento/dispositivo. Seta ou retorna o string que informa qual o tipo unidade este tag representa. Seta ou retorna o nmero do limite mximo do valor que o tag dever assumir na propriedade Value. Seta ou retorna o nmero do limite mnimo do valor que o tag dever assumir na propriedade Value. Seta ou retorna o nmero inteiro do primeiro parmetro de configurao genrico do IOTag. Seta ou retorna o nmero inteiro do segundo parmetro de configurao genrico do IOTag. Seta ou retorna o nmero inteiro do terceiro parmetro de configurao genrico do IOTag. Seta ou retorna o nmero inteiro do quarto parmetro de configurao genrico do IOTag. Retorna o nmero inteiro que determina a qualidade do valor representado na propriedade Value. Seta ou retorna o nmero inteiro do intervalo de varredura para o IOTag. Retorna o data/hora da ltima atualizao ocorrida no objeto IOTag. Seta ou retorna o boleano que define se o tag deve ou no considerar as propriedades Bit00 at Bit31. Seta ou retorna o valor associado a este IOTag. Seta ou retorna o boleano do bit relativo propriedade Value.

90

MANUAL E3

ELIPSE E3

1.25.3.Bloco de Comunicao ( IOBlock)


usado para definir a troca de informaes com os equipamentos de aquisio, que consistem de 1 (uma) ou mais variveis, desde que em forma consecutiva no endereamento dentro do dispositivo externo. A depender do mtodo de comunicao utilizado, podem economizar tempo de comunicao, obtendo um nmero maior de atualizaes num mesmo intervalo de tempo se comparado com o IOTag. Os IOBlocks so configurados atravs de uma srie de parametros B (B1 a B4) que variam de acordo com o driver de comunicao a ser utilizado, alm do parmetro Tamanho (Size) que define o nmero de elementos ou ndices disponveis no Bloco. Para utilizar este recurso, siga os seguintes procedimentos: Insira um Bloco de Comunicao no projeto, clicando com o boto direito do mouse na pasta Driver e escolhendo a opo Bloco de comunicao. Configure suas propriedades conforme as especificaes: Propriedades do Bloco de Comunicao
PROPRIEDADE AllowRead AllowWrite B1 B2 B3 B4 Quality Scan Size TimeStamp DESCRIO

Seta ou retorna o boleano que habilita a leitura do IOBlock. Seta ou retorna o boleano que habilita a escrita do IOBlock. Seta ou retorna o nmero inteiro do primeiro parmetro de configurao genrico do IOBlock. Seta ou retorna o nmero inteiro do segundo parmetro de configurao genrico do IOBlock. Seta ou retorna o nmero inteiro do terceiro parmetro de configurao genrico do IOBlock. Seta ou retorna o nmero inteiro do quarto parmetro de configurao genrico do IOBlock. Retorna o nmero inteiro que determina a qualidade dos dados contidos nos objetos IOBlockElement dentro do bloco. Seta ou retorna o nmero inteiro do intervalo de varredura para o IOBlock. Seta ou retorna o nmero inteiro definindo a quantidade de elementos (valores) deste bloco. Retorna o data/hora da ltima atualizao ocorrida no objeto IOBlock.

1.25.4.Elemento de Bloco (IOBlockElement)


Representam a associao de cada uma das posies de um IOBlock, de forma a serem utilizados se fossem IOTags. Os IOBlockElements podem "apontar"
Manual E3 91

ELIPSE E3

livremente para cada ndice dentro de um IOBlock, sendo que podem existir dois IOBlockElements apontando para o mesmo ndice do IOBlock, e tambm pode existir um nmero menor, igual ou maior de IOBlockElements do que o nmero de variveis declaradas no Bloco. Para utilizar este recurso, siga os seguintes procedimentos: Insira um Bloco de Comunicao no projeto. Aps, clique com o boto direito do mouse neste objeto e escolha a opo Elemento de Bloco. Configure suas propriedades conforme as especificaes:

Propriedades do Elemento de Bloco


PROPRIEDADE Bit00-Bit031 DeviceHigh DeviceLow EU EuHigh EULow EnableScalling DESCRIO

Index

Quality UseBitFields Value

Seta ou retorna o boleano do bit relativo propriedade Value. Seta ou retorna o nmero do limite mximo de valor que o elemento atinge no equipamento/dispositivo. Seta ou retorna o nmero do limite mnimo de valor que o elemento atinge no equipamento/dispositivo. Seta ou retorna o string que informa qual o tipo unidade este elemento representa. Seta ou retorna o nmero do limite mximo do valor que o elemento dever assumir na propriedade Value. Seta ou retorna o nmero do limite mnimo do valor que o elemento dever assumir na propriedade Value. Seta ou retorna o boleano que define se o elemento deve ou no fazer ajuste de escala do valor lido/enviado ao equipamento/dispositivo. Seta ou retorna o nmero inteiro que determina a posio deste elemento dentro da tabela de dados do objeto Bloco de Comunicao. Retorna o nmero inteiro que determina a qualidade do valor representado na propriedade Value. Seta ou retorna o boleano que define se o elemento deve ou no considerar as propriedades Bit00 at Bit31. Seta ou retorna o valor associado a este Elemento de Bloco.

92

MANUAL E3

ELIPSE E3

1.26. Configuraes de Comunicao


Abaixo sero especificadas informaes referentes s configuraes para comunicao nos drivers:

1.26.1.Interface de Configurao
Ao se inserir um Driver em uma aplicao pelo Studio, temos acesso a uma planilha-rvore de definies (via duplo-clique sobre o Driver), que determinaro as atividades que sero realizadas pelo Driver de Comunicao em execuo, consistindo no recebimento de mensagens ou interrogao cclica de um conjunto de variveis. Ao clicar sobre o Driver de Comunicao, suas propriedades so listadas na Janela de Propriedades. Para determinar qual o protocolo de comunicao a ser usada, basta clicar na opo "DriverLocation", onde aparecer uma caixa de seleo de arquivo, para escolha do arquivo DLL que contm a comunicao.

Devem ser preenchidos os parmetros P, que vo de P1 a P4. Tambm devem ser configuradas as opes atravs do boto "Outros Parmetros, acessados atravs do clique com o boto direito do mouse sobre o Driver - opo Propriedades Driver - Outros Parmetros, onde esto disponveis Janelas Extra de Configurao, se existentes. A depender do driver de comunicao utilizado, podem variar os significados dos parmetros P e tambm as opes na Janela Extra. Consulte a documentao de cada driver para detalhes sobre sua configurao.

Manual E3

93

ELIPSE E3

O Driver de Comunicao, representado pelo Mdulo IODriver o responsvel pela coleta de dados dos equipamentos envolvidos nos processos-sejam eles do tipo PLC (Controlador Lgico Programvel), RTU (Unidade Terminal Remota), Controladores Single-Loop ou Multi-Loop, Placas de Aquisio de Dados ou quaisquer outros sistemas externos. O Driver de Comunicao por sua vez formado pelo executvel IOServer.exe, cuja atuao controlada diretamente pelo E3 Server (E3Server.exe), e ocupa um espao de memria e uma mquina de execuo independentes no processador (CPU). O IOServer.exe pode realizar a comunicao com os equipamentos mencionados atravs da utilizao de um arquivo com extenso DLL, como visto anteriormente. Os Drivers de Comunicao utilizados pelo IOServer so desenvolvidos pela Elipse Software, e contm as informaes necessrias especficas de cada sistema, denominado Protocolo de Comunicao. Os Drivers de Comunicao tambem podem ser desenvolvidos por terceiros a partir de um DDK (Driver Development Kit) fornecido pela Elipse Software, em linguagem C/C++, caso seja de interesse do usurio desenvolver um novo driver para um Protocolo de Comunicao especfico. Novos drivers tambm so desenvolvidos constantemente pela Elipse Software, ou ainda mediante consulta.

1.26.2.Modo de Operao
Ao iniciar a execuo do E3Server, este se encarrega de executar cada IOServer (no caso de existir mais de um). O IOServer por sua vez repassar ao E3Server as configuraes iniciais das variveis, denominadas Tags, que sero atualizadas. Baseado no tempo de Scan (Ciclo em milissegundos) de cada Tag, o Driver ir requisitar o valor de cada um, mediante o recebimento de mensagens ou interrogao cclica, repassando os valores para o IOServer, que por sua vez os
94 MANUAL E3

ELIPSE E3

enviar para o E3Server, que ser responsvel por distribuir a informao para os outros mdulos.

Da mesma forma, o E3Server poder enviar uma solicitao de atribuio de valores para uma ou mais variveis, que ser executada com prioridade em relao s atividades de coleta de dados. A verificao do tempo de ciclo de cada varivel feita de forma sequencial, a partir da primeira definio. Caso o ciclo de uma varivel esteja "vencido", o IOServer proceder ao questionamento de seu valor, passando para a prxima varivel, at que a verificao de toda a planilha esteja completa, para ento retornar ao topo para uma nova varredura. Assim, podemos reservar um tempo de ciclo menor para as variveis com necessidade de atualizao mais veloz, e um tempo de ciclo maior para as variveis sem tanta prioridade de atualizao. Deve-se ressaltar, entretanto, que a performance da comunicao depende de uma srie de fatores, incluindo o tipo de interface de comunicao utilizada, velocidade (baud-rate), taxa de erros, etc...

1.26.3.Excees
No caso da Falha de um IOServer, o E3Server ir realizar um reinicializao daquele mdulo, de forma a normalizar seu funcionamento, ou ainda disparar uma unidade StandBy caso esteja configurado para tal. O mesmo acontece com o IOServer, que ir interromper seu funcionamento caso no haja nenhum E3Server (Principal ou StandBy) para receber seus dados.

1.26.4.Compartilhamento de Drivers
Uma outra caracterstica interessante do Driver de Comunicao seu compartilhamento entre mais de uma aplicao, que habilitado pela propriedade ShareServer. Desta forma, voc pode criar vrios IODrivers em uma ou vrias aplicaes que sero executadas em conjunto, e aquele Driver de Comunicao que for executado primeiro ser o responsvel por iniciar os procedimentos de comunicao, como abrir uma porta serial ou inicializar uma interface de comunicao. Os prximos Drivers de Comunicao compartilhados utilizaro o
Manual E3 95

ELIPSE E3

mesmo IOServer aberto pelo primeiro Driver de Comunicao, o que permite uma maior flexibilidade e independncia entre os mdulos de comunicao. Isso se deve ao fato de que a maioria dos dispositivos de comunicao, como modems, portas seriais e algumas interfaces permitirem apenas uma conexo, o que impediria a utilizao por mais de um Driver de Comunicao. Com o compartilhamento utilizado pelo Driver de Comunicao, podemos "reutilizar" a mesma conexo por mais de um Driver de Comunicao. As condies para o compartilhamento, alm da opo ShareServer em verdadeiro (1), seriam a utilizao do mesmo driver de comunicao, incluindo o caminho do arquivo e diretrio (propriedade DriverLocation idntica).

1.26.5.Interface de Execuo
Quando o E3Server est em execuo, temos acesso interface de execuo do Driver de Comunicao, denominado "Driver Manager" ou "Gerenciador de Drivers", clicando sobre o smbolo de execuo e escolhendo a opo "Drivers". O Gerenciador de Drivers permite visualizar todos os drivers em execuo, mostrando algumas propriedades que so o Nome, Caminho do Driver, Compartilhado? (Indicando a propriedade SharedServer), Erros de Leitura (Numero de Erros/Total de Operaes), Erros de Escrita (Nmero de Erros/Total de Operaes) e Log (Habilitado/Desabilitado). Pelo boto "Janela Aberta" temos acesso interface do IOServer, como visto abaixo, que permite visualizar algumas mensagens de comunicao internas entre o IOServer e o E3Server, como a inicializao do driver e eventuais erros de comunicao.

Ainda no Gerenciador de Drivers, o boto "Habilitar Log" faz com que as mensagens de comunicao do driver sejam enviadas a um arquivo em disco, cujo nome e localizao devem ser definidos na configurao do driver. Atravs do

96

MANUAL E3

ELIPSE E3

mesmo boto podemos interromper este procedimento de gravao. J o boto "Atualizar" realiza uma "atualizao" nos dados exibidos.

1.26.6.Utilizao das escalas


Caso o equipamento que voc est utilizando para coletar os dados informe valores de tags que precisam ser convertidos, podemos utilizar as escalas dos tags, que so basicamente uma especificao de uma converso linear entre duas bases diferentes. Para isso, deve-se habilitar a propriedade EnableScaling do tag e informar os parmetros DeviceLow e DeviceHigh, que seriam os intervalos inferior e superior do dado vindo do equipamento, alm dos parmetros EULow e EUHigh que so os intervalos inferior e superior do dado j em unidades de engenharia. A formula para a converso a seguinte: Tag.Value = (((Tag.RawValue - DeviceLow)*(EUHigh-EULow))/(DeviceHighDeviceLow)) + EULow

1.26.7.Teste de Comunicao
Ao configurar um IODriver, podemos realizar um procedimento de teste de comunicao a fim de verificar se os valores esto corretos e sendo atualizados sem problemas. Ao clicar com o boto direito sobre o IODriver, temos a opo "Ativar Comunicao".

Manual E3

97

ELIPSE E3

Desta forma, o Driver de Comunicao especificado ser carregado e os valores das variveis podero ser visualizados no campo Value de cada Tag na planilha de edio. Caso algum dos tags possua a propriedade AllowRead em falso, ou ainda se o tag no possui um valor a ser reportado, aquela linha aparecer com a cor cinza. Caso o tag apresente erro de comunicao, a linha se tornar vermelha e caso a comunicao esteja OK, a linha ter a cor azul. Para interromper a monitorao, clique com o boto direito sobre o IODriver novamente escolhendo a opo "Desativar Comunicao".

1.26.8.Utilizao de Estampa de Tempo


Alguns equipamentos e protocolos permitem o envio de informaes de tempo juntamente com os valores das variveis. Os drivers de comunicao para tais equipamentos podem, a cada varivel consultada, retornar tambm a informao deste relgio, que fica armazenada na propriedade TimeStamp de cada Tag, possuindo preciso de 1ms. O TimeStamp um nmero real de 64 bits, que armazena uma informao de Data/Hora no formato Juliano, que o nmero de segundos desde 1/1/1970, com casas decimais que so os milisegundos. Ao ser repassado para o E3 Server, esse valor transformado para a base Gregoriana, que so os dias desde 31/12/1899, com a parte fracionria representando a hora em fraes de dia. O ano mnimo suportado 100 e o ano mximo 9999, garantindo uma resoluo de pelo menos 1ms em todo o intervalo. Esta base que ser utilizada dentro do software. Quando o equipamento no suporta este tipo de informao, ou quando o driver no est preparado para tal, o Driver de Comunicao insere no TimeStamp o valor de Data/Hora atual, a partir do relgio do computador. De posse do TimeStamp, o E3 ir utilizar essa informao tanto para a verificao e gravao de alarmes, quanto para a gerao de arquivos histricos. No caso dos Tags serem elementos de bloco, informado o mesmo TimeStamp para todos os elementos do bloco, j que foram consultados no mesmo instante de tempo. No caso de serem eventos distintos, no lugar desses elementos devem ser usados Tags de Comunicao. Para ter mais detalhes sobre quais equipamentos possuem esta caracterstica, entre em contato com o fabricante. Para saber quais drivers ou quais tipos de variveis dentro dos drivers utilizam a estampa de tempo, consulte a ajuda dos drivers ou diretamente o suporte tcnico da Elipse Software.

1.26.9.Lista de valores
Alm do envio do TimeStamp, os IODrivers tambm suportam o envio de listas de valores para os tags. As listas so uma seqncia de valores para um mesmo Tag de Comunicao ou Bloco de Comunicao, que so informadas numa mesma leitura.

98

MANUAL E3

ELIPSE E3

Alguns exemplos de utilizao para a lista de valores so a coleta de variaes rpidas de um tag digital, por exemplo, atravs da utilizao de SOE (Sequence of Events - Sequencia de Eventos), que esto armazenadas em um equipamento tipo PLC ou RTU (Remote Terminal Unit) ou ainda na leitura de tabelas de dados onde esto armazenados dados de telemetria, como nos exemplos abaixo.

Na primeira tabela, temos uma sequencia de valores para o campo A, associada a um instante de tempo, representando um leitura SOE. Neste caso, o ideal realizar a leitura atravs de um Tags de Comunicao, que trar toda a tabela em uma nica leitura, sendo que os valores do campo A estaro no prprio tag e o campo Time estar na propriedade TimeStamp. J na segunda tabela, temos uma representao tpica de coleta de dados de telemetria, onde para cada instante de tempo existem vrias colunas, representando vrios valores coletados naquele determinado instante. Para a leitura desses valores, o ideal utilizar um Bloco de Comunicao, que trar toda a tabela em uma nica leitura, sendo que os valores do campo Time estaro associados propriedade TimeStamp do Bloco; os valores do campo A estaro associados a um elemento do bloco, o campo B a outro elemento e assim por diante. A utilizao dos scripts ser descrita adiante.

1.26.10. Importao de Tags


A definio dos Tags tambm pode ser importada de um arquivo externo com a extenso CSV (Comma Separated Values), atravs da opo "Importar Tags" mostrada ao clicar com o boto direito do mouse sobre o Driver de Comunicao. Este arquivo ser lido considerando o separador de elementos configurado no Windows (na configurao por usurio, no do sistema), sendo que cada linha do arquivo pode conter a definio de um Tag PLC, Tag Bloco ou Elemento de Bloco.
Manual E3 99

ELIPSE E3

A primeira linha do arquivo deve conter um cabealho com a descrio (nome) do valor listado naquela coluna, porm nem todas propriedades de um Tag precisam aparecer no arquivo (Nesse caso, as colunas no implementadas mantero o valor default do Tag). Desta forma, os Tags so lidos ordenadamente da segunda linha em diante, e linhas sem dados nenhum sero ignoradas. Os nomes das colunas so identificados por uma parte chave da palavra que descreve a propriedade, aceitando verses em ingls e portugus, quando existir. O nome do Tag pode conter um hierarquia com nomes separados por pontos (Ex.:"Grupo1.Tag001.Elemento001"). A importao automaticamente criar Folders para conter os Tags ou Blocos com Elementos de Bloco, exceto quando j existir o Folder ou Bloco com o mesmo nome; nesse caso sero usados os tens j existentes. Caso j exista um item naquele Driver de Comunicao com mesmo nome, mas de tipo diferente, a cada item importado ser criado um novo Bloco ou um novo Folder. Para maiores informaes, veja o item Importao de Tags. Os valores da linha de uma coluna que no contenham texto mantero o valor do ltimo Tag que definiu aquele valor ("herana" das linhas anteriores). Para utilizar este recurso, siga os seguintes procedimentos: Clique com o boto direito do mouse na pasta Driver e selecione a opo Importar Tags. Na Caixa de dilogo, selecione atravs do arquivo a tag desejada, respeitando as extenses os arquivos, conforme especificaes abaixo.

Figura: Importao de tags

Lista de propriedades aceitas para importao Name / Nome: Nome do Tag, ser ajustado automaticamente pelo E3 (renumerado) se necessrio. A importao tentar reproduzir a hierarquia presente no nome. No delimitado por nenhum tipo de caractere especial (dessa forma no pode conter o caractere configurado como separador de lista). Valor default: (vazio).

100

MANUAL E3

ELIPSE E3

Type / Tipo: Tipo do Tag: PLC, Bloco ou Elemento de Bloco); pode ser especificado numericamente como 0, 1 ou 2, respectivamente. Valor default: Tag PLC. N1 / B1, N2 / B2, N3 / B3, N4 / B4: Parmetros de endereamento do Tag. So lidos como valores numricos de 16 bits. No usado nos Elementos de Bloco. Valor default:0. ScanTime / TempoScan: Tempo de scan do tag. lido como um valor numrico de 16 bits. No usado nos Elementos de Bloco. Valor default: 1000 ms. AllowRead / Leitura / autoRead, AllowWrite / Escrita / autoWrite: So lidos como variveis Booleanas (True/False, Verdadeiro/Falso, Yes/No, 0/no-zero). No usado nos Elementos de Bloco. Valor default: True DocString / Descrio/ Description: Documentao do Tag, lido como texto. Valor default:(vazio). EnableScaling / Escala / Scaling: Uso da converso de escala para os valores do Tag. Lido como uma varivel Booleana (True/False, Verdadeiro/Falso, Yes/No, 0/no-zero). No usado para o Tag Bloco. Valor default: False EULow / Low2 , EuHigh / High2, DeviceHigh / High1, DeviceLow / Low1: Valores limites para a converso de escala do Tag. Lidos como valores em ponto flutuante. No usado para o Tag Bloco. Valores default: 1000 para os valores "High" e 0 para os valores "Low". Index / ndice : ndice do Elemento de Bloco dentro do Tag Bloco. Lido como um valor numrico de 16 bits. No usado nos Tag PLC ou Tag Bloco. Valor default: 0. Size / Tamanho : Nmero de elementos do Tag Bloco. Lido como um valor numrico de 16 bits. No usado nos Tag PLC ou Elemento de Bloco. Valor default: 0.

1.26.11. Importao do Elipse Scada para o E3


A definio dos Tags tambm pode ser importada de um arquivo externo com a extenso CSV (Comma Separated Values), atravs da opo "Importar Tags" mostrada ao clicar com o boto direito do mouse sobre o Driver de Comunicao ou OPCDriver. O E3 Studio aceita a importao de tags do Scada para o seu sistema, respeitando as suas devidas configuraes. Para utilizar este recurso, siga os seguintes procedimentos: Importar os tags PLC e Elemento de Bloco em arquivos separados:

Manual E3

101

ELIPSE E3

Depois de imprimir, v no Excel e abra o arquivo.

Escolha a opo de importao: Espao, Ponto e vrgula e qualificador de texto como aspas simples , e escolha concluir. Insira uma nova linha na planilha (primeira linha) e insira os nomes dos campos conforme a ordem na importao. Acrescente mais uma coluna , com o nome de Tipos, cujos valores em cada linha devem ser PLC ou0, Elemento de Bloco ou 2, a dempender do tipo de tag que est importando. O campo EnableScan ou AutoRead deve ter o nome de Allowread, Leitura ou AutoRead. Salve e Feche o arquivo, e importe para o E3.

Os elementos de Bloco criam seus respectivos pais (Tag Bloco), mas o SCADA no os importa. Nesse caso, depois de importar os tags voc deve preencher os parmetros B1 a B4 e SCAN do Tag Bloco, e ainda definir o Tamanho do Bloco para que comporte todos os seus elementos.

102

MANUAL E3

ELIPSE E3

1.27. Driver OPC


Os drivers OPC so os mdulos responsveis por coletar dados de equipamentos externos atravs da execuo de um Servidor OPC (OLE for Process Control) externo ao Elipse E3, que pode ser fornecido por qualquer empresa. O servidor OPC contm as informaes sobre o protocolo de comunicao do equipamento, alm de uma interface grfica onde podem ser definidos os tags de comunicao. Tais tags podem ser importados para o Driver OPC dentro do E3 (que neste caso atua como um OPC Client) ou ainda podem ser criados a partir do E3. Tais tags, por estarem inseridos dentro de um Driver OPC no E3 so chamados de Tags OPC. Atravs de suas configuraes, possvel configurar o caminho do servidor OPC, pela qual o sistema buscar informaes no servidor OPC local ou da rede. Aps configurado, o sistema verificar a compatibilidade, endereo e dados do servidor OPC e ativar ou no a comunicao. O driver OPC permite ainda a configurao de grupos OPCGroup - onde podemos configurar caractersticas comuns a um conjunto de tags de comunicao. O objeto OPCTag possibilita a leitura e/ou escrita de valores. A leitura do tag feita automaticamente pelo OPCDriver, com tempo de varredura definido pela propriedade Scan. Para utilizar um OPCDriver, siga os seguintes procedimentos: Clique com o boto direito do mouse sobre o nome do projeto, e selecione a opo Drive de comunicao OPC.

Manual E3

103

ELIPSE E3

Figura: Insero do objeto Driver OPC

Configure as suas propriedades, atravs do duplo clique do mouse sobre o objeto, ou clicando com o boto direito do mouse e selecionando a opo Propriedades; Propriedades do Driver OPC
PROPRIEDADE Compatibily ServerMachine ServerName Serverld DESCRIO

Determina a compatibilidade de configuraes de sistema e servidor. Determina o endereo da estao onde est rodando o OPC Server. Retorna o nome/descrio retornado pelo servidor OPC. Determina o servidor OPC ao qual o OPCDriver se conecta.

A identificao dos outros objetos pertencentes ao OPCDriver podem ser inseridas manualmente, ou ento serem trazidas automaticamente do Servidor OPC. Para isso, acesse as propriedades do driver clicando com o boto direito, e escolhendo o Folder OPC Driver. Depois de informado o Endereo e ID do Servidor, clique no boto Selecionar, onde a janela abaixo aparecer:

104

MANUAL E3

ELIPSE E3

Figura: Configuraes do OPCDriver

Opes disponveis Endereo: Determina o endereo do OPCDriver no computador. ID do Servidor: Determina o caminho do servidor OPCDriver no computador. Selecionar: Abre uma caixa de mensagens permitindo ao usurio, que seja localizado o OPCDriver tanto na estao local quanto numa estao na rede. Para tanto, aps ter clicado neste boto, selecionar as opes disponveis e localizar o driver.

Figura: Configuraes dos Servidores OPC

Manual E3

105

ELIPSE E3

Opes disponveis Tentar enumerador padro ou registro (recomendado): O sistema configura as especificaes do driver, localizando conforme o enumerador padro ou algum registro no sistema. o mais utilizado e recomendado para o sistema. Tentar apenas enumerador padro (servio OPCENUM): O sistema configura as especificaes do driver, localizando apenas o enumerador padro (servio OPCENUM). Tentar apenas registros no sistema: armazenados no sistema. O sistema localiza apenas os registros

O OPCDriver pode ser localizado atravs da rede local ou em rede. Para tanto, basta utilizar o boto Selecionar..., pela qual abrir a tela abaixo, para que seja localizado o servidor OPC.

Figura: Configuraes do OPCDriver

Clicando em Ok, o sistema mostrar os dados do Driver, indicando os caminhos e o nome do servidor. Assim, o sistema habilitar o boto Ativar comunicao (Ativa a comunicao com o equipamento) e Informaes ( Informaes do driver). Quando ativada a comunicao, a caixa de mensagens do projeto muda, habilitando as opes Importar Tags e Informaes sobre o servidor.
106 MANUAL E3

ELIPSE E3

Importar Tags: Atravs desta opo, possvel importar tags para um Grupo OPC. Para tanto, basta clicar com o boto direito no objeto OPC e selecionar a opo Importar Tags. Clicando na opo listada no campo Servidor OPC e arrastando para o grupo do OPC, possvel importar os Tags. Tambm possvel filtrar os campos que sero visualizados, selecionando uma das opes no Filtros de procura no servidor. O sistema abrir uma tela com as opes disponveis:

Figura: Configuraes do OPCDriver

Filtros de procura no servidor Nome dos Itens: Filtra os tags a partir do nome dos itens especificados. Tipo de dados: Filtra os tags a partir do tipo de dado especificado no campo. Estes dados podem ser: Null, Integer, Long ou Single. Tipo de acesso: Filtra os tags a partir do tipo de acesso especificado no campo. Estes acessos podem ser: Leitura, Escrita ou leitura/Escrita. Mostrar apenas itens com IDs no encontrados no projeto: Filtra os tags para que o sistema mostre apenas os itens com IDs no encontrados no projeto.

Esto disponveis para serem inseridos dentro de um DriverOPC os seguintes objetos:

Manual E3

107

ELIPSE E3

1.27.1.Objeto Grupo OPC


O objeto Grupo OPC agrupa uma srie de OPCTags que tero o mesmo tempo de atualizao. Contm um conjunto de OPCTags que compartilham os mesmos parmetros de atualizao (tempo de varredura e banda morta). Voc obrigado a inserir OPCTags somente dentro de um Grupo OPC. Para inserir um OPCGroup, siga os seguintes procedimentos: Aps ter criado o objto OPCDriver, clique com o boto direito do mouse sobre o objeto, e selecione a opo Grupo de tags OPC.

Figura: Grupo OPC

Configure as propriedades do objeto, atravs do duplo clique, ou clicando com o boto direito do mouse, e selecionando a opo propriedades: Propriedades do Grupo OPC
PROPRIEDADE DeadBand Enable RealScan Scan DESCRIO

Permite regular um nvel mnimo de variao considerado significativo para os OPCTags de um OPCGroup. Seta ou retorna o valor boleano de habilitao da varredura do Grupo. Retorna o tempo de varredura real para o OPCGroup. Seta a atualizao do OPCGroup.

108

MANUAL E3

ELIPSE E3

1.27.2.Objeto Pasta OPC


Definem Grupos ou Subdiretrios de forma a melhor Organizar as variveis; Cada OPCFolder pode ser renomeado conforme a necessidade, e novas Pastas OPC que podem ser inseridos dentro de outros.

Figura: Insero da Pasta OPC

1.27.3.Objeto Tag OPC


O Tag OPC um objeto para leitura e/ou escrita de valores em um dispositivo/ equipamento. O objeto Tag OPC possibilita a leitura e/ou escrita de um s valor, utilizando o OPCDriver, ao qual ele est inserido. A leitura do tag feita automaticamente pelo OPCDriver, com tempo de varredura definido pela propriedade Scan. Configure a propriedade AllowRead para definir se este tag dever ou no ser lido pelo OPCDriver. Para utilizar este recurso, siga os seguintes procedimentos: Aps o objeto OPCDriver e o OPCGroup terem sido criados, clique com o boto direito do mouse sobre este objeto OPCGroup, e selecione a opo Tag de comunicao OPC.

Figura: Insero do Tag OPC

Configure as suas propriedades, para especificao das informaes do objeto.

Manual E3

109

ELIPSE E3

Propriedades do Tag OPC


PROPRIEDADE AllowRead AllowWrite Bit00-Bit31 DataType DeviceHigh DESCRIO

DeviceLow

EU EUHigh EULow EnableScaling ItemID Quality RawValue SyncWrite TimeStamp UseBitFields Value

Seta ou retorna o boleano que habilita a leitura do OPCTag. Seta ou retorna o boleano que habilita a escrita do OPCTag. Seta ou retorna o boleano do bit relativo propriedade Value. Retorna o tipo de valor associado a este OPCTag. Seta ou retorna o nmero do limite mximo de valor que o tag atinge no equipamento/dispositivo., para efeito de ajustes de escala. Seta ou retorna o nmero do limite mnimo de valor que o tag atinge no equipamento/dispositivo, para efeitos de ajustes de escala. Seta ou retorna o string que informa qual o tipo unidade este tag representa. Seta ou retorna o nmero do limite mximo do valor que o tag dever assumir na propriedade Value. Seta ou retorna o nmero do limite mnimo do valor que o tag dever assumir na propriedade Value. Seta ou retorna o boleano que define se o tag deve ou no fazer ajuste de escala do valor lido/enviado ao equipamento/dispositivo. Determina o caminho que identifica o OPCTag no servidor OPC ao qual o OPCDriver se conecta. Retorna o nmero inteiro que determina a qualidade do valor representado na propriedade Value. Seta ou retorna o valor enviado do servidor. Determina a edio de configuraes da escala no OPCTag. Retorna a data/hora da ltima atualizao ocorrida no objeto OPCTag. Seta ou retorna o boleano que define se o tag deve ou no considerar as propriedades Bit00 at Bit31. Seta ou retorna o valor associado a este OPCTag.

1.27.4.Objeto Bloco OPC


O objeto Bloco de Comunicao OPC possibilita a leitura e/ou escrita de um s valor utilizando o bloco onde ele est inserido. Para fazer uma escrita, deve-se apenas atribuir um novo valor propriedade Value. A leitura do tag feita automaticamente pelo TagOPC com tempo de varredura definido pela propriedade Scan. O Bloco OPC l uma tabela de dados e este objeto estar sempre associado posio definida por sua propriedade Index. Suponhamos que tenhamos um Elemento de Bloco OPC com Index igual a 5 e esteja inserido em um Bloco OPC com tamanho 10 e seus dados lidos os seguintes:

110

MANUAL E3

ELIPSE E3

Ento segundo a tabela acima este Elemento de Bloco OPC com Index igual a 5 teria sua propriedade Value igual a 3. Para utilizar este recurso, siga os seguintes procedimentos: Aps o objeto OPCDriver e o Grupo OPC terem sido criados, clique com o boto direito do mouse sobre este objeto Grupo OPC, e selecione a opo Bloco OPC.

Figura: Insero do Bloco de comunicao OPC

Caso necessite, configure as propriedades deste objeto: Propriedades do Bloco OPC


PROPRIEDADE AllowRead AllowWrite ItemID Quality Size SyncWrite TimeStamp DESCRIO

Seta ou retorna o boleano que habilita a leitura do BlocoOPC. Seta ou retorna o boleano que habilita a escrita do BlocoOPC. Determina o caminho que identifica o BlocoOPC no servidor OPC ao qual o OPCDriver se conecta. Retorna o nmero inteiro que determina a qualidade do valor representado na propriedade Value. Determina o tamanho de elementos do BlocoOPC. Determina a edio de configuraes da escala no BlocoOPC. Retorna a data/hora da ltima atualizao ocorrida no objeto BlocoOPC.

Manual E3

111

ELIPSE E3

1.27.5.Objeto Elemento de Bloco OPC


O objeto Elemento de Bloco OPC possibilita a leitura e/ou escrita de um s valor utilizando o OPCTag onde ele est inserido. Para fazer uma escrita, deve-se apenas atribuir um novo valor propriedade Value. A leitura do tag feita automaticamente pelo BlocoOPC com tempo de varredura definido pela propriedade Scan. O Bloco OPC l uma tabela de dados e este objeto estar sempre associado posio definida por sua propriedade Index. Suponhamos que tenhamos um Elemento de Bloco OPC com Index igual a 5 e esteja inserido em um OPCBloco com tamanho 10 e seus dados lidos os seguintes:

Ento segundo a tabela acima este Elemento de Bloco OPC com Index igual a 5 teria sua propriedade Value igual a 3. Para utilizar este recurso, siga os seguintes procedimentos: Aps o objeto Bloco OPC ter sido criado, clique com o boto direito do mouse sobre este objeto, e selecione a opo Elemento de Bloco OPC.

Figura: Insero do elemento de Bloco OPC.

Caso necessite, configure as propriedades deste objeto:

112

MANUAL E3

ELIPSE E3

Propriedades do Elemento de Bloco OPC


PROPRIEDADE Bit00-Bit31 DeviceHigh DESCRIO

DeviceLow

EnableScaling Eu EuHigh EuLow Index Quality RawValue UseBitFields Value

Seta ou retorna o boleano do bit relativo propriedade Value. Seta ou retorna o nmero do limite mximo de valor que o tag atinge no equipamento/dispositivo, para efeito de ajustes de escala. Seta ou retorna o nmero do limite mnimo de valor que o tag atinge no equipamento/dispositivo, para efeitos de ajustes de escala. Seta ou retorna o boleano que define se o tag deve ou no fazer ajuste de escala do valor lido/enviado ao equipamento/dispositivo. Seta ou retorna o string que informa qual o tipo unidade este tag representa. Seta ou retorna o nmero do limite mximo do valor que o tag dever assumir na propriedade Value. Seta ou retorna o nmero do limite mnimo do valor que o tag dever assumir na propriedade Value. Seta ou retorna o nmero inteiro que determina a posio deste elemento dentro da tabela de dados do objeto OPCBloco. Retorna o nmero inteiro que determina a qualidade do valor representado na propriedade Value. Seta ou retorna o valor enviado do servidor. Seta ou retorna o boleano que define se o tag deve ou no considerar as propriedades Bit00 at Bit31. Seta ou retorna o valor associado a este Elemento de bloco OPC.

1.28. Servidor de Dados (DataServer)


O Servidor de Dados ou DataServer o mdulo responsvel por executar e gerenciar tags e outras variveis e objetos que no esto envolvidos diretamente com a comunicao, pois essa tarefa est reservada para o IODriver e o OPCDriver. Atravs do DataServer podemos configurar a existncia de tags internos e tags de simulao, alm de inserir os Xobjects, que so os objetos de dados ElipseX. Os objetos abaixo podem ser inseridos em um DataServer:

1.28.1.Pasta de Dados (Folder)


Definem Grupos ou Subdiretrios de forma a melhor Organizar as variveis; Cada OPCFolder pode ser renomeado conforme a necessidade, e novos OPCFolders podem ser inseridos dentro de outros.

Manual E3

113

ELIPSE E3

1.28.2.TagDemo
O TagDemo um objeto que gera valores de acordo com uma forma de onda, e utilizado para simulao de valores. Permite gerar curvas definidas ou valores aleatrios, a partir da seleo nos botes que aparecem na janela. Atravs da propriedade Type, especificada o tipo de onda do objeto, e a sada da forma de onda, vai para a propriedade Value. Utiliza-se a propriedade Minimum e Maximum, para configurar os limites mximos da variao da forma de onda e com a propriedade Period, o perodo do mesmo. Para utilizar este recurso, siga os seguintes procedimentos: Insira o objeto no projeto atravs do clique com o boto direito do mouse na pasta Dados e selecionando a opo TagDemo.

Figura: Insero do TagDemo

Pode-se configurar as propriedades do objeto atravs da caixa de dilogo, que pode ser visualizada dando um duplo clique no nome TagDemo ou clicando com o boto direito do mouse e selecionando a opo propriedades. Configure as informaes do TagDemo ou atravs da caixa de dilogo, ou com as propriedades:

114

MANUAL E3

ELIPSE E3

Propriedades do Tag Demo


PROPRIEDADE Enabled Maximum Minimum Period Scan Type Value DESCRIO

Seta ou retorna o valor boleano de habilitao da variao de valor do objeto DemoTag. Seta ou retorna o valor real do limite mximo da variao da propriedade Value. Seta ou retorna o valor real do limite mnimo da variao da propriedade Value. Seta ou retorna o valor inteiro que define o comprimento da forma da onda. Seta ou retorna o valor inteiro que define intervalo de tempo entre cada variao do DemoTag. Seta ou retorna o valor inteiro que define a forma da onda. Retorna o valor numrico da forma de onda configurada.

1.28.3.Tag Interno
O Tag Interno um objeto de propsito genrico, utilizado para guardar valores de qualquer tipo incluindo nmeros, textos e at outros objetos. Para utilizar os recursos deste objeto, siga os seguintes procedimentos: Insira um objeto InternaTag na aplicao, atravs do clique como boto direito do mouse na pasta Dados, e selecionar a opo InternalTag.

Figura: insero do tag interno

Pode-se configurar as propriedades do objeto atravs das propriedades, dando um duplo clique no objeto ou clicando com o boto direito do mouse. .

Manual E3

115

ELIPSE E3

1.29. Outros tipos de dados


Podem ser inseridos tambm em um Servidor de Dados outros tipos de dados, tipicamente objetos COM e os Xobjects. Atravs desses ltimos, podemos instanciar os objetos de dados da biblioteca, especificando e/ou associando cada uma das variveis internas do Xobject. Os objetos inseridos no DataServer sero executados pelo E3 Server, portanto estaro presentes no Servidor. Os Xcontrols que podem estar fazendo referncia aos Xobjects esto sendo executados pelo Viewer, logo esto em outro programa; porm so automaticamente referenciados e manipulados pelo conjunto Viewer(s) + Servidor (es). Para inserir um Xobject em um DataServer, devemos proceder da mesma forma para os tags acima. Se houver algum ElipseX registrado na maquina, que contenha algum Xobject, este estar disponvel na lista para a insero.

116

MANUAL E3

7
7.

Captulo

Viewer

Este objeto define como ser a interface do Viewer quando aberta pelo operador, alm de permitir a especificao e configurao de mtodos/propriedades globais da aplicao que podem ser utilizados no lado Cliente do sistema. S poder existir um objeto Viewer em seu domnio. Quando em execuo, o Viewer poder obter dados da aplicao atravs do mtodo Client da Aplicao. Este serve tanto para ativar telas, menus, etc. quanto para buscar dados do servidor. Para criar um Viewer, siga os seguintes procedimentos: Verifique se j existe um Viewer em seu domnio, ou insira um novo caso contrrio. D um duplo clique sobre o objeto, ou clique com o boto direito do mouse e selecione a opo Propriedades: Atravs da aba Visualizador, so configuradas algumas opes. No campo Ttulo, especificado o ttulo da tela de visualizao do projeto.

Figura: Configuraes do Viewer

Tutorial E3

117

ELIPSE E3

A opo Tela ou Frame inicial, configurada qual a tela que iniciar na

visualizao do projeto. Clicando sobre o boto , o sistema abre uma tela de configurao, pela qual chamar o App Browser, onde ser especificado a tela inicial de visualizao do sistema. Para tanto, necessrio selecionar no campo do projeto a opo desejada (ao clicar na opo, o campo texto indicar a opo selecionada), e clicar sobre o boto Copiar .

Figura: Configuraes Viewer

Atravs da opo Janela do Viewer, determinado como a tela inicializar a sua visualizao: A opo Zoom determina a visualizao no Viewer. Atravs das suas opes, possvel configurar para que o Viewer inicialize : Preencher: O Viewer preenche toda a largura e altura da tela. Toda Pgina: O Viewer preenche toda a pgina da tela. Toda Altura: O Viewer preenche toda a altura da tela. Toda Largura: O Viewer preenche toda a largura da tela. Para configurar o Zoom do Viewer, pode-se utilizar as opes acima, ou atravs dos percentuais disponveis nesta opo (10, 20 ,30, 40, 50, 60, 70, 80, 90, 100, 150, 200, 400, 800).
118 Manual E3

ELIPSE E3

Atravs da opo Janela do Viewer, determinado como a tela inicializar a sua visualizao: Iniciar maximizada: Ao executar o Viewer, a tela iniciar maximinizada, isto , toda a extenso da tela. Iniciar janelada: Ao executar o Viewer, a tela iniciar conforme especificaes de altura e largura. Neste campos, deve-se especificar a altura e largura em pixels, e determinar se deseja centralizar ou no a janela.

Iniciar minimizada: Ao executar o Viewer, a tela iniciar minimizada. Ttulo do Viewer: Atravs desta opo, possvel selecionar os botes que deseja inserir na execuo do Viewer.

Barra de ttulo: Com esta opo habilitada, possvel inserir uma barra de ttulo com as descries contidas na Propriedade Caption. Boto de fechar: Atravs desta opo, possvel inserir o boto fechar no Viewer, no momento da sua execuo. Boto de minimizar: Atravs desta opo, possvel inserir o boto minimizar no Viewer, no momento da sua execuo. Boto de maximizar: Atravs desta opo, possvel inseriri o boto maximizar no Viewer, no momento da sua execuo.

Na opo Desabilitar troca de janela, quando marcada esta opo, o Viewer desabilita a troca de janela, em runtime. Caso necessite, configure as propriedades do objeto:

Manual E3

119

ELIPSE E3

Propriedades do Viewer

120

Manual E3

ELIPSE E3 PROPRIEDADE CenterWindow CloseButton InicialScreen MaximizeButton MinimizeButton Titlebar User WindowHeight WindowWidth DESCRIO

Determina a centralizao da tela na opo janelada. Seta/Retona a insero do boto Fechar no Viewer. Especifica a tela inicial da visualizao do projeto. Determina a insero do boto Maximizar no Viewer. Determina a insero do boto Minimizar no Viewer. Determina a insero da barra de ttulo no Viewer. Especifica o usurio atual do sistema. Especifica a largura da janelada. Especifica a altura da janelada.

Manual E3

121

ELIPSE E3 WindowStyle

Especifica o tipo de visualizao da tela (0- maximed, 1windowed ou 2- minimized).

122

Manual E3

ELIPSE E3

Mtodos do Viewer
MTODOS DoModal GetFrame GetObject GetValue IsUseMemberOfGroup SetForegroundWnd SetValue SelectMenu ToggleValue Exit GetFormulaUnitDataO bj DESCRIO

Este mtodo abre uma tela em modo exclusivo. Este mtodo busca por um objeto Divisor que esteja aberto no Viewer. Este mtodo busca por um objeto que esteja sendo executado no servidor. Este mtodo busca pelo valor de um objeto/propriedade no servidor. Este mtodo mostra o usurio do Viewer. Este mtodo d o foco para a janela no Viewer. Este mtodo seta o valor de um objeto dentro do servidor. Este mtodo mostra um menu popup conforme especificado pelo parmetro menuOp. Este mtodo troca o valor de um objeto/propriedade entre dois valores. Este mtodo fecha a janela no Viewer. Este mtodo, utilizado em algum script na interface Grfica (Viewer), obtem o nome de uma certa Unit ou a quantidade de Units numa frmula, retornando a operao. Este mtodo, utilizado em algum script na Interface Grfica (Viewer), obtm o nome de um certo Conjunto de Valores ou a quantidade de Conjunto de Valores numa frmula, retornando se conseguiu realizar a operao. Este mtodo, utilizado em algum script na Interface Grfica (Viewer), apresenta uma Caixa de Dilogo permitindo ao usurio escolher o Conjunto de valores e a Unit de Destino, carregando a Frmula. Este mtodo, utilizado em alguns scripts na Interface grfica (Viewer), carrega automaticamente um conjunto de valores para uma unidade (Unit) de destino, apresenta uma caixa de Dilogo permitindo ao usurio informar valores diferentes daqueles definidos na Frmula. Este mtodo, utilizado em algum script na Interface Grfica (Viewer), carrega um Conjunto de valores para uma Unit de Destino, porm sem apresentar nenhuma interface grafica. Inicia o dilogo para login e aps confirmao loga o usurio informado. O usurio logado permanesse na mmoria at que seja feito outro login ou logout. O logout informa que o usurio atualmente logado no estar mais ultilizando a aplicao. A partir deste momento ser considerado que um usurio anmino est utilizando a aplicao.

GetFormulaValueData Obj

LoadFormulaDlg

LoadFormulaValues

LoadFormulaValuesQu iet Login

Logout

Para visualizar o projeto, clique em Salva e executa tudo


Manual E3

.
123

ELIPSE E3

Para rodar uma aplicao Cliente (Viewer), voc pode utilizar o Viewer, localizado no seguinte caminho: Menu Iniciar (Star) Programas (Programs) E3 Studio Viewer. Abrir a tela abaixo. Ento, s clocar o caminho da asua aplicao e clicar em Ok.

124

Manual E3

8
8.

Captulo

Telas e Quadros

Uma Tela pode ser definida como uma janela para monitoramento de um processo, onde so inseridos os objetos que faro a interface do operador com o sistema. Cada aplicao pode ter um nmero ilimitado de Telas. Os Quadros so um mtodo para organizar e estruturar a interface, criando visualizaes compostas para o usurio dentro da janela principal do Viewer ou Internet Explorer.

1.30. Tela
A Tela a entidade bsica de interface com o usurio, e pode conter vrios tipos de objetos. Grficos, que so inseridos na tela de modo que possam ser deletados, copiados, movidos, redimensionados, agrupados ou configurados. Na configurao do Viewer, voc pode especificar para que seja visualizados Quadros ou Telas, no momento da sua inicializao. Para tanto, basta definir no campo Tela ou Frame Inicial, a opo desejada. Tambm possvel atribuir a um objeto esta funo e determinar atravs de um script esta opo. Voc pode inserir uma nova Tela no projeto clicando com o boto direito do mouse sobre o Projeto, no Organizer, e escolhendo a opo "Inserir" e "Tela". Nesta nova Tela, voc pode definir suas propriedades, alm de definir vrios tipos de objetos grficos. O E3 Studio disponibiliza um completo editor grfico de objetos que podem ser inseridos em uma tela ou biblioteca. Esto disponveis: Linha Retngulo Retngulo Arredondado Elipse

Manual E3

125

ELIPSE E3

Arco de Elipse Desenho Livre Polgono Polgono de Curvas Desenho (Imagem) Texto Display Setpoint Escala Formulrios (CheckBox, RadioButton, ComboBox, etc..)

Figura: Tela

126

MANUAL E3

ELIPSE E3

1.30.1.Componentes da Tela
Os componentes da tela so os seguintes: Grade A Grade serve como referncia para o editor grfico (no aparece em execuo), composta ou uma matriz de pontos separados por uma distncia configurvel. Com ela, ao inserir, copiar ou editar objetos, as coordenadas iniciais (X,Y) e seu tamanho (Altura,Largura) somente sero aqueles possveis para que o objeto fique alinhado grade, tanto horizontal quanto verticalmente. A Grade pode ser retirada ou inserida atravs da opo "Grade" , e suas propriedades podem ser acessadas pelo Menu "Arranjar" - "Edio da Grade", onde pode ser definidos o estilo da Grade (Pontos ou Linhas) e o espaamento entre os pontos (ou linhas). Zoom Na edio da Tela podemos escolher livremente o nvel de zoom desejado e mais confortvel para a edio. As opes disponveis pelo Menu "Zoom" vo de 10 a 800%, alm poder ajustar automaticamente a largura em "Toda Largura", a altura em "Toda Altura", a pgina inteira sem alterao do aspecto largura x altura em "Toda Pgina" e a pgina inteira com alterao do aspecto em "Total". Camadas O E3 oferece uma arquitetura de telas com at 32 camadas para insero de objetos grficos. Cada objeto pode pertencer a uma ou mais camadas, e a tela ativa tanto em Configurao (no Studio) quanto em Execuo (no Viewer) podem estar com nenhuma, uma, vrias ou todas as camadas ativas. Isso permite criar sistemas com vrias formas de monitoramento, como por exemplo visualizao de um processo apenas com o sistema eltrico, apenas o hidrulico ou ambos. O Viewer pode tambm, controlar o aparecimento de camadas a depender de um determinado nvel de Zoom. A configurao das camadas feita a partir do menu "Camadas" ou via boto direito do mouse clicando sobre a tela, que a princpio exibe as opes "Todas Camadas", "Nenhuma Camada" e "Editar Camadas". Ao escolher a opo de editar, podemos configurar camadas individuais, como abaixo:

Manual E3

127

ELIPSE E3

Figura: Edio de camadas

Para inserir uma nova camada, pressione a tecla "Insert" de seu teclado.

A seguir, podemos definir um nome (Ex: Hidrulica, Eltrica, etc..), um Zoom Baixo e Alto e um Link para uma fonte de dados. O Zoom Baixo e Alto define um intervalo de Zoom tal que, se selecionado pelo usurio no Viewer em execuo, exibir a camada ou camadas que possurem intervalos de Zoom correspondentes. Para tanto, a opo Usar condio adicional de visibilidade deve estar habilitada, onde pode ser inserida uma varivel ou propriedade qualquer do sistema. Assim, ser possvel a edio dos parmetros que o Zoom ir respeitar. Os valores para o Zoom baixo e Zoom Alto podem ser setados atravs do clique com o mouse e insero dos valores, ou pela tecla de atalho (camada), que abrir uma caixa de dilogo para especificao dos valores.

J o Link estabelece um tag ou propriedade que uma vez ativo (diferente de zero) tambm exibe a camada (As opes de Zoom e Fonte so no-exclusivas, i.e., podem ativar a camada estando uma condio ou outra ativa). Atravs das teclas de atalho, possvel configurar a edio da camada:

128

MANUAL E3

ELIPSE E3

Opes da camada Camada: Disponibiliza a caixa de dilogo, que determina as especificaes referentes camada atual. Remover Camada: Remove a camada selecionada. Editar Camada: Disponibiliza a caixa de dilogo, que determina as especificaes referentes camada atual. Atravs desta opo, possvel editar as configuraes referentes a(s) camada(s). Aps este passo, o menu "Camadas" tambm exibir o nome das Camadas criadas, que podem ser ativadas e desativadas. Ao inserir objetos na Tela, estes assumiro como suas camadas somente aquelas que estiverem ativas naquele momento.

1.31. Quadros
Os Quadros so um mtodo para organizar e estruturar a interface, criando visualizaes compostas para o usurio dentro da janela principal do Viewer ou Internet Explorer. Muitas vezes uma aplicao requer apenas uma tela principal, que a porta de entrada para a aplicao. A partir da, o usurio pode navegar pelas outras telas, que ocuparo o lugar da primeira, formando uma nica visualizao do processo. Porm, possvel suportar mais de uma visualizao em um mesmo documento ou projeto. Isto til no caso de uma aplicao que utilize uma tela que nunca muda (ou que muda pouco), como por exemplo um menu, e outra parte que a navegao das telas propriamente ditas. Nesse caso, o divisor ter duas divises ou Splits. Cada Split corresponde a uma visualizao de uma tela de seu processo ou um URL (Universal Resource Locator), chamado de quadro. A figura abaixo, mostra algumas possibilidades:

Manual E3

129

ELIPSE E3

O suporte a mltiplas visualizaes se d atravs da criao de um Quadro em sua aplicao, que inicialmente vem configurado com 1 janela apenas, chamada de Divisor.

O Quadro considerado como uma Tela para o projeto (DOC); j os divisores so as sub-janelas dentro do Quadro. Como o propsito do uso dos quadros a utilizao de mais de uma janela simultnea, voc provavelmente ter que criar dois divisores filhos para esse divisor Principal. A disposio dos Divisores dentro do Quadro pode ser horizontal ou vertical, isto , a tela pode ser dividida na horizontal ou vertical. Dentro de cada divisor podem ser inseridos outros divisores, representando sub-divises dentro de uma janela.

130

MANUAL E3

ELIPSE E3

Figura: Quadro e Divisores

Para utilizar este recurso, siga os seguintes procedimentos: Insira um quadro no projeto, clicando com o boto direito do mouse no nome do projeto e escolhendo a opo quadro. O quadro deve conter divisores, dentre os quais sero as interligaes entre o link especificado e o programa. Para criar um divisor, clique com o boto direito do mouse sobre o quadro aberto na rea de Trabalho, ou ainda clique com o mesmo boto direito sobre o quadro no Organizer, escolhendo o Tab Quadro. Configure as propriedades do divisor, conforme for apropriado.

Manual E3

131

ELIPSE E3

Propriedades do Divisor
PROPRIEDADES SplitLink SplitType SplitUnit DESCRIO

SplitValue SplitPosition

o caminho para a tela que ser exibida inicialmente no quadro. Est relacionado com o campo Link da janela de configurao. o tipo de diviso do quadro, podendo ser Nenhum, Horizontal e Vertical. Est relacionada com o campo Diviso da janela. Definio das unidades para o tamanho do quadro, que podem ser em Porcentagem ou Pixels (pontos na tela). Est relacionada com o campo Unidade. a posio do quadro, dada em SplitUnits. o campo Valor na janela acima. Nmero seqencial que indica a posio do quadro no total de quadros. Est relacionada com o campo Posio.

Voc pode configurar as propriedades da tela para determinar tamanho, cor e outros aspectos do comportamento e aparncia, alm de eventos ao entrar ou sair de uma tela. As telas utilizam como padro para o tamanho e coordenadas as unidades HIMETRIC, dadas em 1/100 mm (no em pixels). Nesse sistema, ao adicionar um valor positivo em x, a coordenada x move-se para a direita. Quando adicionamos um valor positivo em y, a coordenada y move-se para baixo, sendo a origem dada pelo canto superior esquerdo da tela. As Telas podem ser abertas de modo Full-Screen, ocupando toda a rea do Viewer, ou ainda como Telas Modais, ocupando somente o tamanho de suas coordenadas Altura e Largura.

132

MANUAL E3

ELIPSE E3

9
9.

Captulo

Telas e Quadros

Uma Tela pode ser definida como uma janela para monitoramento de um processo, onde so inseridos os objetos que faro a interface do operador com o sistema. Cada acionados com os tags, variveis ou propriedades, de modo a realizar uma interface amigvel com o usurio. Os objetos de tela podem ser criados a partir da barra de ferramentas Objetos ou atravs do Menu Objetos. Uma vez selecionado o objeto que se deseja criar, mantenha o boto esquerdo do mouse pressionado na rea da tela, enquanto movimenta o mouse (um retngulo pontilhado mostra o tamanho e a forma do objeto). Ao soltar o boto, o objeto ser posicionado dentro da rea especificada. Voc pode inserir os seguintes elementos em uma Tela: Primitivas do Editor Grfico (Retas, Crculos, Retngulos, Polgonos, Curvas, etc..); Controles ActiveX fornecidos pela Elipse (E3Alarm, E3Chart, E3Browser); Controles ActiveX fornecidos por terceiros; Imagens no vetoriais (Arquivos BMP, JPG, GIF, etc...) Imagens vetoriais (Arquivos WMF) Controles Padro do Windows (Lista, Editor de texto, Lista de seleo, etc..) Bibliotecas grficas do E3 (XControl), compostas de qualquer dos objetos acima.

Os objetos grficos disponveis no sistema so os seguintes:

Manual E3

133

ELIPSE E3

1.32. Arco da Elipse


Permite realizar grficos do tipo torta. Ao ser inserido na tela, o objeto exibe dois pontos que indicam a posio da abertura da torta (propriedades "ArcBeginAngle" e "ArcEndAngle", dadas em graus (0 a 360)). Ao passar o mouse sobre os pontos, podemos arrast-los mudando diretamente as propriedades mencionadas, ou ainda atravs da Janela de Propriedades, que altera o Estilo do Arco atravs da propriedade "ArcStyle". Para utilizar este recurso, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela. Quando o mouse est sobre a tela, seu desenho se torna uma cruz. Mova-o para a posio selecionada, pressione e segure o boto esquerdo, e arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o objeto criado ficar selecionado, o que pode ser visto atravs de uma seleo das extremidades do objeto. Para editar o objeto, clique com o boto direito sobre o objeto e escolha a opo "Editar Pontos". Com esta operao, todos os vrtices do objeto criado ficam selecionados atravs de pequenos pontos, que podem ser movidos com o uso do mouse (basta clicar e arrastar). Para remover algum ponto, clique sobre o ponto enquanto aperta a tecla CTRL.

Pode-se configurar as informaes do objeto atravs da janela de propriedades. Propriedades do Arco


PROPRIEDADES ArcBeginAngle ArcEndAngle ArcStyle DESCRIO

Seta o ngulo inicial, em graus, do arco do objeto. Seta o ngulo final, em graus, do arco do objeto. Especifica o estilo da borda/linha do objeto: 0 Arc : O estilo do desenho ser um arco. 1- Chord : O estilo do desenho ser uma corda, unindo o ponto inicial e o final. 2 Pie : O estilo do desenho ser uma pizza.

134

MANUAL E3

ELIPSE E3

1.33. Desenho Livre


Esta ferramenta se destina criao de reas irregulares. Para definir os vrtices do objeto, mantenha o boto pressionado, enquanto arrasta o mouse pela tela. Todos os caminhos que o ponteiro do mouse percorrer sero criados como parte do objeto. Para utilizar este recurso, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela. Quando o mouse est sobre a tela, seu desenho se torna uma cruz. Mova-o para a posio selecionada, pressione e segure o boto esquerdo, e arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o objeto criado ficar selecionado, o que pode ser visto atravs de uma seleo das extremidades do objeto. Para editar o objeto, clique com o boto direito sobre o objeto e escolha a opo "Editar Pontos". Com esta operao, todos os vrtices do objeto criado ficam selecionados atravs de pequenos pontos, que podem ser movidos com o uso do mouse (basta clicar e arrastar). Para remover algum ponto, clique sobre o ponto enquanto aperta a tecla CTRL. Tambm possui todas as caractersticas gerais mostradas, como rotao, sombreamento, preenchimento total e parcial, estilo de bordas, etc....

1.34. Elipse
Este objeto permite o desenho de crculos e elipses, utilizando todo a largura/altura e definindo o centro do crculo no centro do retngulo. Pode ser redimensionado/rotacionado livremente.
Manual E3 135

ELIPSE E3

Criado a partir de rea definida, possui tambm todas as propriedades gerais. Para utilizar este objeto, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela. Quando o mouse est sobre a tela, seu desenho se torna uma cruz. Mova-o para a posio selecionada, pressione e segure o boto esquerdo, e arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o objeto criado ficar selecionado, o que pode ser visto atravs de uma seleo das extremidades do objeto.

1.35. Escala
O objeto Escala permite que seja aplicada uma referncia numrica a um objeto. Atravs de suas divises e subdivises determinadas atravs das propriedades Ticks e MinorTicks, so especificadas informaes para configurao do objeto. Para utilizar os recursos da escala, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela.

Quando o mouse est sobre a tela, seu desenho se torna uma cruz. Mova-o para a posio selecionada, pressione e segure o boto esquerdo, e arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o objeto criado ficar selecionado, o que pode ser visto atravs de uma seleo das extremidades do objeto. Caso necessite, configure o objeto atravs das suas propriedades:

136

MANUAL E3

ELIPSE E3

Propriedades da Escala
PROPRIEDADES BorderColor BorderStyle BorderWidth MaximumValue MinimumValue MinorTicks MinorTicksPercentSi ze ScaleAlignment ShowText TextColor TextFont Ticks TicksPercentSize DESCRIO

Determina a cor da borda da escala. Determina o estilo de borda que ser aplicado no escala. Determina a altura do objeto escala. Determina o valor mximo atingido pela escala. Determina o valor mnimo requerido pela escala. Determina a quantidade de medidas da escala. Determina o tamanho das linhas do objeto escala. Determina o tipo de alinhamento da escala. Determina a visibilidade do texto na escala. Determina a cor da fonte do objeto escala. Determina a fonte que ser aplicada ao objeto escala. Determina a quantidade de divisrias da escala. Determina o tamanho das linhas das divisrias padro da escala.

1.36. Figura
Este objeto permite mostrar imagens que estejam armazenadas em arquivos, estejam eles dentro ou fora do arquivo do aplicativo. A figura torna-se bem interessante quando trabalha com arquivos metafile, onde possvel animar as cores de preenchimento e borda sem alterao do arquivo de imagem. Para utilizar este objeto, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela. Quando o mouse est sobre a tela, seu desenho se torna uma cruz. Mova-o para a posio selecionada, pressione e segure o boto esquerdo, e arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o objeto criado ficar selecionado, o que pode ser visto atravs de uma seleo das extremidades do objeto. Para editar a figura, clique com o boto direito sobre o objeto e escolha a opo "Editar Pontos". Com esta operao, todos os vrtices do objeto criado ficam selecionados atravs de pequenos pontos, que podem ser movidos com o uso do mouse (basta clicar e arrastar). Para remover algum ponto, clique sobre o ponto enquanto aperta a tecla CTRL. O sistema abrir uma caixa para seleo da figura no arquivo.

Manual E3

137

ELIPSE E3

Selecione o local e clique em abrir, para inserir a figura na tela. Pode-se configurar as informaes do objeto atravs da janela de propriedades. Propriedades da Figura
PROPRIEDADES Convert EnableOverrideLineCo lor Filename OverrideFillColor OverrideFillMode OverrideLineColor TransparentColor TransparentMode TransparentPercent DESCRIO

Permite converter as figuras na propriedade desejadas. Seta ou retorna o boleano que habilita/desabilita a alterao da cor original da linha da figura. Seta ou retorna a string que define o caminho do arquivo de imagem. Seta ou retorna o nmero inteiro da cor do preenchimento sobrescrita para a figura. Seta ou retorna o nmero inteiro do estilo de sobrescrita do preenchimento da figura. Seta ou retorna o nmero inteiro da cor da linha sobrescrita para a figura. Seta ou retorna o nmero inteiro da cor de transparncia da imagem do objeto. Seta ou retorna o nmero inteiro do modo de transparncia da imagem. Seta ou retorna o nmero inteiro da porcentagem de transparncia da imagem do objeto.

1.37. Linha
Objeto bsico de reta que liga dois pontos quaisquer. Permite o desenho de retas, atravs de dois pontos especificados na sua criao ou na de polgonos. Pode ser redimensionado/rotacionado livremente. Possui as mesmas propriedades descritas no tem Propriedades Gerais. Para utilizar este objeto, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela.
138 MANUAL E3

ELIPSE E3

Quando o mouse est sobre a tela, seu desenho se torna uma cruz. Mova-o para a posio selecionada, pressione e segure o boto esquerdo, e arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o objeto criado ficar selecionado, o que pode ser visto atravs de uma seleo das extremidades do objeto.

1.38. Polgono
Utilizado para o desenho de polgonos cujos lados so retas. Para utiliz-lo, selecione a ferramenta e a cada clique em uma rea da tela, ser definido um vrtice do objeto. Quando desejar interromper o desenho, basta um duplo-clique no ltimo vrtice, quando o objeto aparecer selecionado. Para utilizar este objeto, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela. Ao ser inserido na tela, o nome visualizado na caixa de dilogo Propriedades linha, pois este objeto um seguimento de linha. Quando o mouse est sobre a tela, seu desenho se torna uma cruz.

Mova-o para a posio selecionada, pressione e segure o boto esquerdo, e arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o objeto criado ficar selecionado, o que pode ser visto atravs de uma seleo das extremidades do objeto.

Manual E3

139

ELIPSE E3

1.39. Polgono de Curvas


Realiza um desenho praticamente da mesma forma que o polgono, porm a cada ponto inserido, o objeto criar curvas que passam por todos os pontos criados. Caso queira editar o objeto, basta clicar com o boto direito sobre o mesmo e escolher a opo "Editar Pontos". Com esta operao, todos os vrtices do objeto criado ficam selecionados atravs de pequenos pontos, que podem ser movidos com o uso do mouse. Para remover algum ponto, basta clicar sobre o ponto enquanto aperta a tecla CTRL. Para utilizar este objeto, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela. Quando o mouse est sobre a tela, seu desenho se torna uma cruz. Mova-o para a posio selecionada, pressione e segure o boto esquerdo, e arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o objeto criado ficar selecionado, o que pode ser visto atravs de uma seleo das extremidades do objeto.

1.40. Retngulo
Este objeto permite o desenho de retngulos, utilizando toda a largura/altura do objeto. Pode ser redimensionado/ rotacionado livremente. Criado a partir de dois vrtices. Possui as mesmas propriedades descritas no item "Propriedades Gerais".

Para utilizar este objeto, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela.

140

MANUAL E3

ELIPSE E3

Quando o mouse est sobre a tela, seu desenho se torna uma cruz. Mova-o para a posio selecionada, pressione e segure o boto esquerdo, e arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o objeto criado ficar selecionado, o que pode ser visto atravs de uma seleo das extremidades do objeto.

1.41. Retngulo Arredondado


Retngulo criado a partir de dois vrtices com a opo dos cantos serem arredondados, a partir de um fator de arredondamento. Ao ser inserido ou editado, exibe um pequeno ponto prximo ao canto superior esquerdo do objeto, que permite modificar o fator de arredondamento.

Ao passarmos o mouse sobre esse ponto, podemos arrast-lo para as bordas, tornando o objeto mais reto, ou para o centro, tornando-o mais curvo. Isso refletido diretamente nas propriedades "RoundAspectX" e "RoundAspectY", que so nmeros reais que vo de 0 (retngulo completo) a 1 (crculo completo). Para utilizar este objeto, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela. Quando o mouse est sobre a tela, seu desenho se torna uma cruz. Mova-o para a posio selecionada, pressione e segure o boto esquerdo, e arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o objeto criado ficar selecionado, o que pode ser visto atravs de uma seleo das extremidades do objeto. Pode-se configurar as informaes do objeto atravs da janela de propriedades.

Manual E3

141

ELIPSE E3

Propriedades do Retngulo arredondado


PROPRIEDADES Round AspectX Round AspectY DESCRIO

Define o tamanho da dimenso das laterais do retngulo no eixo X. Define o tamanho da dimenso da altura do retngulo no eixo Y.

1.42. Texto
Possibilita de criao de um texto. Ao definir a rea na tela, podemos digitar diretamente o texto desejado, que aceita tambm mltiplas linhas.

Alm das propriedades gerais j mostradas (rotao, sombreamento, preenchimento total e parcial, estilo de bordas, etc....). Para utilizar este objeto, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela. Quando o mouse est sobre a tela, escreva a descrio desejada. Aps, d um duplo clique para finalizar a edio. O objeto texto tem as seguintes propriedades especficas:

142

MANUAL E3

ELIPSE E3

Propriedades do Texto
PROPRIEDADES Format IsSetPoint Multiline DESCRIO

TextAlignment TextColor TextFont Value

Especifica que tipo de formato ser atribudo ao objeto. Utilizada para determinar se o objeto vai ter comportamento de SetPoint, ou seja, permitir edio da Propriedade Value. utilizada para determinar se possvel a edio de textos em uma ou mais linhas. A partir do momento no qual a propriedade StretchText for setada para True, o texto automaticamente redimensiona o tamanho do texto para que a rea ocupada por ele continue sempre a mesma. Especifica o alinhamento do texto mostrado no texto. Especifica a cor da fonte do texto a ser exibido. Define o tipo da fonte a ser utilizado pelo texto. Seta ou retorna o valor do texto.

1.43. Display
Este objeto utilizado para mostrar os valores dos Tags em tempo real. As propriedades do Display permitem definir o tamanho, cor, fonte, alinhamento, efeito 3D, etc.

Este objeto pode ser redimensionado/rotacionado livremente. Aps ser inserido na tela, o objeto ser nomeado como Texto. Alm das propriedades gerais j mostradas (rotao, sombreamento, preenchimento total e parcial, estilo de bordas, etc....). Para utilizar este objeto, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela. Quando o mouse est sobre a tela, escreva a descrio desejada. Aps, d um duplo clique para finalizar a edio. As propriedades gerais deste objeto so as seguintes:

Manual E3

143

ELIPSE E3

Propriedades do Display
PROPRIEDADES BorderColor BorderStyle BorderWidth Format Strechtext IsSetPoint DESCRIO

Multiline

TextAlignment TextColor TextFont Value

Determina a cor da borda do objeto. Determina o estilo da borda do objeto. Determina a altura da borda do objeto. Especifica que tipo de formato ser atribudo ao objeto. Utilizada para ajustar o tamanho do text, conforme as dimenses do objeto. Utilizada para determinar se o Objeto Texto vai ter comportamento de IsSetPoint, ou seja, permitir edio da Propriedade Value. utilizada para determinar se possvel a edio de textos em uma ou mais linhas. A partir do momento no qual a propriedade StretchText for setada para True, o objeto Texto automaticamente redimensiona o tamanho do texto para que a rea ocupada por ele continue sempre a mesma. Especifica o alinhamento do texto mostrado no objeto Texto. Especifica a cor da fonte do texto a ser exibido. Define o tipo da fonte a ser utilizado pelo objeto Texto. Seta ou retorna o valor do texto associado ao objeto Texto.

1.44. Setpoint
O objeto Setpoint trabalha como uma caixa de edio pela qual so inseridos contedos para atribu-los a tags associados. Assim, basta digitar um valor e pressionar a tecla ENTER, para atribuir este valor ao tag associado. As propriedades do Setpoint permitem que seja definido o tipo de valor de entrada, fonte, tamanho, e cor dos caracteres que sero mostrados no objeto.

Alm das propriedades gerais j mostradas (rotao, sombreamento, preenchimento total e parcial, estilo de bordas, etc....). Para utilizar este objeto, siga os seguintes procedimentos: Para inserir o objeto grfico em uma tela, basta selecion-lo na barra de ferramentas e mover o ponteiro para a rea da Tela. Quando o mouse est sobre a tela, escreva a descrio desejada. Aps, d um duplo clique para finalizar a edio. As propriedades gerais deste objeto so as seguintes:

144

MANUAL E3

ELIPSE E3

Propriedades do Setpoint
PROPRIEDADES BorderColor BorderStyle BorderWidth Format Strechtext IsSetPoint DESCRIO

Multiline

TextAlignment TextColor TextFont Value

Determina a cor da borda do objeto. Determina o estilo da borda do objeto. Determina a altura da borda do objeto. Especifica que tipo de formato ser atribudo ao objeto. Especifica se o texto acompanha a dimenso do objeto. Utilizada para determinar se o Objeto Texto vai ter comportamento de IsSetPoint, ou seja, permitir edio da Propriedade Value. utilizada para determinar se possvel a edio de textos em uma ou mais linhas. A partir do momento no qual a propriedade StretchText for setada para True, o objeto Texto automaticamente redimensiona o tamanho do texto para que a rea ocupada por ele continue sempre a mesma. Especifica o alinhamento do texto mostrado no objeto Texto. Especifica a cor da fonte do texto a ser exibido. Define o tipo da fonte a ser utilizado pelo objeto Texto. Seta ou retorna o valor do texto associado ao objeto Texto.

1.45. Configuraes Gerais


As configuraes gerais dos objetos de tela so as seguintes: Travar Ao Escolher esta opo, o Studio no permite que o objeto seja movido, evitando movimentos indesejados. Depois de travado, o mouse exibe um cursor com um cadeado ao ser deslocado sobre a rea do objeto travado. Ao clicar novamente com o boto direito, exibida a opo "Destravar". Ponto ncora definido como as coordenadas (x,y) que marcam o ponto inicial do objeto. Inicialmente o ponto ncora est atrelado s coordenadas iniciais (X,Y) do objeto. Ao escolher a opo "Definir Ponto ncora", este aparece junto ao objeto, com o smbolo de onde pode ser movido para qualquer lugar da tela. Se voc estiver utilizando o Grid, ao arrastar o objeto com a nova ncora, o ponto que foi definido que ficar fixado nos pontos de grid, sendo que o objeto ficar "deslocado" nas mesmas propores em relao ncora. Configurar como Padro Aplica as definies do objeto que est sendo editado como o Estilo Padro para os prximos objetos que utilizarem a funo "Aplicar Estilo". Neste Estilo esto
Manual E3 145

ELIPSE E3

includos as Cores de Frente, Fundo e Borda, Espessura da Linha, Estilo da Borda e do Gradiente. Aplicar Estilo Aplica as definies de Estilo previamente definidas pela opo "Configurar como Padro". Neste Estilo esto includos as Cores de Frente, Fundo e Borda, Espessura da Linha, Estilo da Borda e do Gradiente. Recortar, Copiar, Duplicar e Colar So as aes bsicas de edio dos objetos. Podemos copiar objetos de tela pressionando a tecla CTRL, enquanto arrastamos o objeto que desejamos copiar. Esta ao ir criar um novo objeto de tela que ter as mesmas propriedades do item copiado. Pode-se ainda utilizar os comandos bsicos Copiar (CTRL+C) e Colar (CTRL+V) do Windows. Deletar Remove o objeto da Tela. Pode ser feito tambm se selecionando o objeto e pressionando a tecla Delete. Propriedades Chama uma janela de interface para edio de propriedades gerais e especficas (se existir) do objeto. Movimentao A Movimentao um recurso do E3 fcil e prtico para criar movimento a um objeto. Os tipos de movimentaes disponveis no sistema so: Movimentao Linear: O objeto que recebe este recurso faz movimentos lineares de acordo com as configuraes das propriedades no objeto. Movimentao Rotacional: O objeto que recebe este recurso faz movimentos rotacionais de acordo com as configuraes das propriedades no objeto. A rotao de um objeto est relacionada com duas propriedades do objeto: o centro de rotao e o ngulo. Ao criar o objeto, seu centro de rotao padro definido como o centro do objeto, e possui uma inclinao de 0 graus de posio da horizontal em relao a esse centro. Ao selecionar a opo "Rotacionar" no toolbar, podemos alterar tanto o centro de rotao como o prprio ngulo. Nesse momento, o ponteiro do mouse assume um formato, e o objeto selecionado possui seus vrtices indicados por pequenos crculos e seu centro por dois crculos circunscritos.
146 MANUAL E3

ELIPSE E3

Ao passar o mouse sobre o centro ou vrtices, o mouse torna-se somente um crculo e podemos modificar o centro arrastando-o, ou ainda rotacionando o objeto de um de seus vrtices em relao ao centro. O ngulo de rotao pode ser visualizado pela propriedade Angle de cada objeto. Deve-se ressaltar que alguns objetos ActiveX no permitem rotao. O ngulo de rotao pode ser visualizado pela propriedade Angle de cada objeto. Sobreposio de Objetos Se voc possui dois objetos na tela, e parte de um precisa estar sob ou sobre o outro, pode-se ajustar a disposio atravs dos botes Enviar para frente, Enviar para trs, Avanar e Recuar. Ao escolher as opes Enviar para frente ou Enviar para trs, o objeto selecionado ser colocado na primeira ou ltima posio na ordem de sobreposies. J ao escolher Avanar ou Recuar, o objeto selecionado ir ocupar a posio imediatamente acima ou abaixo do prximo objeto na ordem desejada. Ordem de Navegao entre os objetos Ao inserir uma srie de objetos na tela, possvel (em execuo), atravs do uso da tecla Tab, se deslocar de um objeto para o outro, como por exemplo dois Setpoints. Esta ordem feita atravs da opo Ordem dos Tabs . Para utilizar este recurso, crie os objetos na tela e selecione a opo Ordem dos tabs . Voc ver que o mouse assumir um cursor semelhante ao cone da opo. Clique com o mouse nos objetos conforme deseja ordenar. Nos objetos, aparecer o nmero com a devida ordem especificada. Quando o projeto for compilado, a navegao entre estes objetos, tanto do mouse como teclado, ser feita conforme a ordem especificada. Nota: Quando criado um novo objeto na tela, a ele atribuda a primeira posio e ordenada a sequncia decrescente aos demais objetos da tela. Para manter a ordem inicial dos objetos, siga os seguintes procedimentos: Aps ter criado o objeto na tela, clique na opo Ordem dos Tabs Com a tecla CTRL pressionada, clique no penltimo objeto. Solte a tecla CTRL e clique no ltimo objeto (objeto criado anteriormente). .

Selecionando objetos na tela Para selecionar os objetos contidos em uma rea, use a ferramenta de seleo. Com ela, voc pode selecionar os objetos dentro de um retngulo delimitado pelo mouse.

Manual E3

147

ELIPSE E3

Agrupando objetos e Editando objetos Agrupados Ao selecionar um grupo de objetos podemos transform-lo em apenas um, atravs da opo "Agrupar". Com essa opo, ser formado apenas um objeto que expe propriedades comuns como altura, largura, ngulo, etc..., sem mostrar diretamente cada um de seus componentes, e podemos copiar, arrastar e deletar um grupo que todo seu contedo ser tratado como um nico objeto. Para utilizar este recurso, siga os seguintes procedimentos: Selecione os objetos que deseja formar o grupo. Clique no boto Agrupar.

Este recurso permite que os objetos selecionados tornem-se um grupo, fazendo com que possa ser mudada todas as configuraes do mesmo. Ao ser aplicado este recurso, o sistema d acesso as propriedades especficas do grupo. Para configurlas, siga os seguintes procedimentos: Aps o grupo ser criado, d um duplo clique sobre o objeto ou clique com o boto direito do mouse e selecione a opo propriedades.

Tais propriedades podem ser configuradas atravs da caixa de dilogo Propriedades.

Esta operao pode ser feita em cascata, sendo que um grupo pode conter qualquer objeto inclusive outros grupos. Para desfazer a unio de um grupo de objetos, devemos selecionar a opo "Desagrupar". Para editarmos um objeto contido em grupo, porm, no h necessidade de desagrup-lo.
148 MANUAL E3

ELIPSE E3

Basta escolher a opo Editar Grupo, disponvel via clique com o boto direito sobre o objeto, que teremos acesso a cada componente individual. Caso exista outro grupo dentro do primeiro, podemos repetir a operao at alcanarmos o objeto desejado. Uso de Teclas Direcionais Para mover um objeto com o teclado, voc tambm pode utilizar as teclas direcionais, como segue: Seta para Cima: Sobe o objeto 1 ponto para cima; Seta para Baixo: Desce o objeto 1 ponto para baixo; Seta para Direita: Move o objeto 1 ponto para a direita; Seta para Esquerda: Move o objeto 1 ponto para a esquerda;

Modificando Camadas do Objeto Para modificar a camada de algum objeto, basta selecion-lo e clicar no campo "Layer" visvel pela Janela de Propriedades, ou ainda via boto direito do mouse, selecionando a opo "Camadas", quando alguma estiver disponvel. Sombreamento Os objetos grficos podem ter um efeito de sombra automtico, atravs da opo do toolbar "Sombreamento". Habilita/desabilita a sombra do objeto. Setando esta propriedade para True, o objeto mostrar uma sombra com os mesmos estilos de preenchimento, fundo e borda, porm com a propriedade ShadowColor, especificada a cor do preenchimento da sombra do objeto. Quando as propriedades so aplicadas em um grupo de objetos, primeiro desenhado todas as sombras dos objetos filhos do grupo e aps so desenhados os objetos. Ao escolher esta opo, um segundo objeto idntico ao primeiro acrescentado, porm, ligeiramente deslocado e permanecendo sempre em segundo plano, criando o efeito de sombra. Atravs das opes "Sombra Acima", "Sombra Abaixo", "Sombra Direita" e "Sombra Esquerda", podemos modificar o posicionamento da Sombra. A propriedade "Shadow" de cada objeto indica se este possui ou no o efeito de sombra, e equivale posio do boto "Sombreamento" do toolbar, assim como as opes de posicionamento que modificam as propriedades "ShadowX" e "ShadowY", dadas em unidades HIMETRIC(1/100 mm). J a cor da sombra pode ser alterada via opo "Cor da Sombra", ou ento atravs da propriedade "ShadowColor" na Janela de Propriedades. Para utilizar os recursos da sombra, proceda assim:

Manual E3

149

ELIPSE E3

Insira ou selecione o objeto que deseja aplicar a sombra. Voc pode alterar suas propriedades atravs da barra de atalho ou pela sua caixa de propriedades. Aps, clique na opo sombra no Toolbar ou atravs de suas propriedades. Configure as propriedades conforme opo desejada. Propriedades da Sombra
PROPRIEDADES Shadow ShadowColor ShadowX ShadowY DESCRIO

Habilita a aplicao da sombra. Seta ou retorna o nmero inteiro da cor da sombra deste objeto. Seta ou retorna o nmero da coordenada horizontal esquerda da sombra do objeto. Seta ou retorna o nmero da coordenada vertical superior da sombra do objeto.

Pode-se aplicar as propriedades do objeto, atravs da barra de atalho do sistema. Opes


OPO DESCRIO

Habilita/Desabilita a sombra no objeto. Posiciona a sombra abaixo do objeto. Posiciona a sombra acima do objeto. Posiciona a sombra esquerda do objeto. Posiciona a sombra direita do objeto. Seta ou retorna o nmero inteiro da cor da sombra deste objeto.

Para retirar o efeito da sombra, basta selecionar o objeto e acessar o cone sombra no toolbar.

Preenchimento Cada objeto grfico pode ter seu contedo preenchido de acordo com as opes disponveis na propriedade "FillStyle", a partir da Janela de Propriedades. So elas:

150

MANUAL E3

ELIPSE E3

Opes de Preenchimento
OPO DESCRIO

Solid: O Objeto tem seu contedo da mesma cor da propriedade "ForegroundColor". a opo padro. Hollow: O Objeto mostra em seu interior tudo o que estiver no fundo, deixando visvel apenas a borda (se houver). Com esta opo, o objeto no possui contedo. Horizontal: O preenchimento feito com listras horizontais, intercaladas com a opo escolhida para o fundo (Opaco ou Transparente). Vertical: O preenchimento feito com listras verticais, intercaladas com a opo escolhida para o fundo (Opaco ou Transparente). Downward: O preenchimento feito com listras diagonais para baixo, intercaladas com a opo escolhida para o fundo (Opaco ou Transparente). Upward: O preenchimento feito com listras diagonais para cima, intercaladas com a opo escolhida para o fundo (Opaco ou Transparente). Cross: O preenchimento feito com listras verticais e horizontais, intercaladas com a opo escolhida para o fundo (Opaco ou Transparente). DiagonalCross: O preenchimento feito com listras diagonais para cima e para baixo, intercaladas com a opo escolhida para o fundo (Opaco ou Transparente). SemiTransparent: Nesta opo o objeto fica parcialmente opaco, isto , transparece o fundo a depender da opo escolhida para seu fundo (Opaco ou Transparente). Na opo Opaco a transparncia difusa; na segunda, feita atravs de pequenas faixas transparentes.

Gradiente e Estilos de Gradiente: Nesta opo o fundo uma transio ou gradiente da cor "ForeGroundColor" para a cor "BackGroundColor". O Efeito de transio determinado pela propriedade "GradientStyle", disponvel na Janela de Propriedades, ou pela opo "Estilo do Gradiente" no toolbar. Nesta opo tambm podem ser visualizados todos os tipos de preenchimento anteriores.

Manual E3

151

ELIPSE E3

Figura: Preenchimento

Este um efeito do preenchimento. Estilo de Fundo Indica como o objeto exibir sua segunda opo de cor (BackGroundColor), o que pode ser informado pela opo "Estilo de Gradiente" do Toolbar, ou pela Janela de Propriedades. As opes so "Opaco", indicando cores slidas e "Transparente" indicando opo de transparncia com o fundo. Bordas Indica como o objeto exibir suas extremidades. Podemos definir uma cor para a Borda, atravs da opo "Cor da Borda" do toolbar, ou ainda pela propriedade "BorderColor" na Janela de Propriedades.

Podemos escolher ainda entre alguns estilos de borda, pela opo "Estilo de Borda" ou propriedade "BorderStyle" e ainda a espessura da linha pela opo de mesmo nome ou propriedade "BorderWidth", dada em unidades HIMETRIC.

152

MANUAL E3

ELIPSE E3

Preenchimento Parcial Horizontal e Vertical Esta opo muito til para a representao de qualquer tipo de recipiente (tanques, vasos, reservatrios, etc..) que desejamos indicar o nvel do material. Todos os objetos podem ser preenchidos tanto no sentido vertical quanto horizontal pela cor de frente (ForeGroundColor) em relao cor de fundo (BackGroundColor). Isso pode ser ajustado pelas seguintes propriedades, acessadas pela Janela de Propriedades: Propriedades do preenchimento
PROPRIEDADES HorizontalFillStyle VerticalFillStyle HorizontalPercent Fill VerticalPercentFill DESCRIO

Indica a forma do preenchimento horizontal: da esquerda para a direita, direita para a esquerda ou centro para as bordas. Indica a forma do preenchimento vertical: de baixo para cima, cima para baixo ou centro para as bordas. Nmero de 0 a 100 indicando a porcentagem do preenchimento na horizontal. Valor padro: 100 (preenchimento total). Nmero de 0 a 100 indicando a porcentagem do preenchimento na vertical. Valor padro: 100 (preenchimento total).

Formatao de Cores Em todas as propriedades de cores, podemos especificar a cor desejada pelo clique no campo Valor da propriedade de cor desejada na Janela de Propriedades, ou ainda em outras janelas que for possvel escolha de cores.

Figura: Cores

Manual E3

153

ELIPSE E3

O tab Padro, permite escolher cores padronizadas do sistema, incluindo tonalidades de cinza. J o tab Personalizado, permite que o usurio faa suas prprias definies de cores.

Figura: Cor personalizada

A cor pode ser escolhida pela navegao com o cursor pelo mapa de cores, com o uso do mouse. O ponto por onde o mouse passar ter a propriedade de cor refletida nos campos abaixo, que podem ser editados tambm diretamente pelo teclado. Existem duas metodologias para a determinao de cores, que so o RGB (Red, Green, Blue) definidas como cores primrias ou pela definio de matiz, saturao e luminosidade. Todas as propriedades vo de 0 a 255. Red: Indica a quantidade do componente primrio vermelho na composio da cor; Green: Indica a quantidade do componente primrio verde na composio da cor; Blue: Indica a quantidade do componente primrio azul na composio da cor; Hue: Especifica a matiz da cor; Sat: Indica a saturao da cor; Lum: Indica a luminosidade da cor, que tambm pode ser editada pelo slider direita do mapa de cores.

154

MANUAL E3

ELIPSE E3

1.45.1. Eventos e Propriedades Gerais


Para configurar um objeto no E3 Studio podem ser utilizadas diversas maneiras. Uma delas, atravs da configurao das propriedades. Todos os objetos possuem propriedades e eventos, e alguns so comuns a todos eles, sendo chamadas de Propriedades e/ou Eventos gerais.

Figura: Eventos padro

Os eventos sero melhor entendidos no captulo Scripts. Abaixo segue a listagem das propriedades e eventos, com suas caractersticas: Eventos Padro
EVENTO Click DbClick KeyDown KeyUp OnStartRunning OnStopRunning DESCRIO

Ocorre quando o boto esquerdo do mouse pressionado sobre o objeto. Ocorre quando o boto esquerdo do mouse pressionado rapidamente duas vezes sobre o objeto. Ocorre quando alguma tecla pressionada e este objeto estava com o foco. Ocorre quando alguma tecla solta e este objeto estava com o foco. Ocorre quando inicializada a execuo de uma instncia deste objeto. Ocorre quando finaliza a execuo de uma instncia deste objeto.

Manual E3

155

ELIPSE E3

Propriedades Padro

156

MANUAL E3

ELIPSE E3 PROPRIEDADES Angle BackgroundColor BackgroundStyle BorderColor BorderStyle BorderWidth Effect3D Effect3DcolorBase Effect3DcolorTop Effect3D_X Effect3D_Y DocString Enabled FillStyle ForegroundColor GradientStyle HasFocus Height HorizontalFillStyle HorizontalPercentFill Layer MouseOver MouseOverChild Name Shadow ShadowColor ShadowX ShadowY Width TabStop Tip DESCRIO

Seta ou retorna o nmero inteiro do ngulo de rotao deste objeto. Seta ou retorna o nmero inteiro da cor de fundo deste objeto. Seta ou retorna o nmero inteiro do estilo do fundo do objeto. Seta ou retorna o nmero inteiro da cor da borda/linha deste objeto. Seta ou retorna o nmero inteiro do estilo da borda do objeto. Seta ou retorna o nmero inteiro da espessura da linha/borda deste objeto Determina a aplicao do efeito 3d no objeto selecionado. Determina a cor da base do efeito 3D no objeto. Determina a cor do topo do efeito 3D no objeto. Seta ou retorna o tamanho do efeito 3D no eixo X. Seta ou retorna o tamanho do efeito 3D no eixo y. Retorna ou seta o string de documentao do objeto. Seta ou retorna o boleano que habilita a funcionalidade deste objeto. Seta ou retorna o nmero inteiro do estilo de preenchimento do objeto. Seta ou retorna o nmero inteiro da cor de frente deste objeto. Seta ou retorna o nmero inteiro do estilo de preenchimento do degrad do objeto. Determina o foco do campo no objeto. Seta ou retorna o nmero da altura deste objeto. Seta ou retorna o nmero inteiro do estilo do preenchimento horizontal do objeto. Seta ou retorna o nmero inteiro da porcentagem de preenchimento horizontal do preenchimento do objeto. Seta ou retorna o nmero inteiro da mscara da camada deste objeto. Retorna o boleano que informa se o mouse est sobre o objeto. Retorna o boleano que informa se o mouse est sobre um filho deste objeto. Retorna ou seta o nome do objeto. Retorna o boleano que habilita/desabilita a sombra do objeto. Seta ou retorna o nmero inteiro da cor da sombra deste objeto. Seta ou retorna o nmero da coordenada horizontal esquerda da sombra do objeto. Seta ou retorna o nmero da coordenada vertical superior da sombra do objeto. Seta ou retorna o nmero da largura deste objeto. Determina a utilizao da tecla TAB na edio. Retorna ou seta o texto de dica do objeto.

Manual E3

157

ELIPSE E3 VerticalFillStyle VerticalPercentFill Visible X Y

Seta ou retorna o nmero inteiro do estilo do preenchimento vertical do objeto. Seta ou retorna o nmero inteiro da porcentagem de preenchimento vertical do preenchimento do objeto. Seta ou retorna o boleano de visibilidade do objeto. Seta ou retorna o nmero da coordenada horizontal esquerda relativa a este objeto. Seta ou retorna o nmero da coordenada vertical acima relativa a este objeto.

1.45.2.Formatao de Valores
O uso de formatadores permite mudar a forma como os dados so apresentados sem mudar o valor que existe por trs deles. O formato um texto que pode ser editado manualmente ou configurado atravs da janela de formatao. Seu uso semelhante aos formatadores usados nas planilhas de dados, seguindo a mesma sintaxe bsica mas com algumas extenses. So suportados dados: Numricos (sada decimal, cientfica, hexadecimal, binria e octal) Texto Booleanos Datas e Horas (calendrio Gregoriano)

Figura: Formatao de valores

Em alguns objetos encontramos a opo de formatao de campos, acessada via menu de propriedades do objeto ou pela Janela de Propriedades, na opo "Format", onde acessamos a janela abaixo:
158 MANUAL E3

ELIPSE E3

Formatos Pr- Definidos As seguintes formataes esto disponveis: Geral: No h formatao especfica, sendo realizada automaticamente a depender do tipo de dado. Nmero: Este formato apresenta nmeros com parte inteira e fracionria, permitindo definir o nmero de casas decimais e uso de separador de milhares. Para nmeros muito grandes ou muito pequenos, utilize o formato cientfico. Os smbolos de casa decimal e separador de milhares so aqueles definidos no Windows, Painel de Controle, Configuraes Regionais. Data: Apresentam valores numricos (formato Gregoriano) como datas e horas, quando vlidos. Use o formato de hora para apresentar apenas a parte de hora. Hora: Apresentam valores numricos (formato Gregoriano) como datas e horas, quando vlidos. Use o formato de data para apresentar apenas a parte da data. Porcentagem: Este formato multiplica o nmero por 100 e adiciona o smbolo de percentual, definindo-se tambm o nmero de casas decimais. Cientfico: Este formato apresenta o nmero em notao de mantissa e expoente, ideal para nmeros de magnitude variada, permitindo escolher tambm o nmero de casas decimais e formatos. Especial: Permitem formatar nmeros inteiros em bases no decimais (hexadecimal, octal e binria).

Outros Formatos Na opo "Outros", podemos criar um formato de dados qualquer, mesmo um dos j citados, a partir da digitao de um cdigo (texto) de formato. O texto do formatador composto de at quatro campos separados por um caractere de ponto e vrgula (;). O primeiro campo sempre aplicado quando no existir um outro campo mais apropriado para o valor ou tipo de dado. O segundo campo utilizado para valores numricos negativos. O terceiro campo utilizado quando o valor numrico for zero. E o quarto campo utilizado quanto o dado for do tipo texto.Sempre que mais de um campo for definido o campo anterior ser considerado, mesmo que seja vazio. No caso de um formatador de campo vazio o valor formatado ser sempre um texto vazio. Note-se que isso difere do formato geral que apenas um formato vazio, sem o uso dos separadores de campo (;). Na opo "Outros", podemos criar um formato de dados qualquer, mesmo um dos j citados, a partir da digitao de um cdigo (texto) de formato. O texto do formatador composto de at quatro campos separados por um caractere de ponto e
Manual E3 159

ELIPSE E3

vrgula (;). O primeiro campo sempre aplicado quando no existir um outro campo mais apropriado para o valor ou tipo de dado. O segundo campo utilizado para valores numricos negativos. O terceiro campo utilizado quando o valor numrico for zero. E o quarto campo utilizado quanto o dado for do tipo texto. Sempre que mais de um campo for definido o campo anterior ser considerado, mesmo que seja vazio. No caso de um formatador de campo vazio o valor formatado ser sempre um texto vazio. Note-se que isso difere do formato geral que apenas um formato vazio, sem o uso dos separadores de campo (;). Entrada de Texto Para inserir caracteres que sero mostrados pelo formatador pode-se coloc-los entre aspas () ou aps uma barra:

Isso vlido para todos tipos de formatadores. Alm disso podem ser criados formatadores que contenham apenas texto. possvel tambm combinar isso com os uso dos diferentes campos. Exemplo:

Alm disso, os seguintes caracteres podem ser mostrados diretamente sem o uso de aspas ou barra: $ - + / () : ! ^ & ' (aspas simples esquerda) ' (aspas simples direita) ~ { } = < > Observao: Para mostrar a barra (\) ou aspas duplas (") no dado formatado use \" e \\. Quando entre aspas todo o texto copiado diretamente logo "\a" mostrado simplesmente como \a. Formatadores Numricos Os formatadores numricos aceitam trs tipos bsicos de caracteres para definir o nmero de dgitos apresentados:
160 MANUAL E3

ELIPSE E3

O ponto decimal '.' define que se deseja apresentar tambm a parte fracionria de um nmero. O caractere no formatador sempre o ponto '.', mas apresentado como o caractere separador (exemplo: vrgula) configurado no sistema (pelo Painel de Controle do Windows). A vrgula tem duas funes: aps os dgitos do formatador, indica que o valor deve ser divido por mil (para cada virgula). Independente da configurao local do Windows, no texto do formatador sempre deve ser usada a vrgula para indicar o separador de milhar, mas a sada formatada sair de acordo com a configurao regional do sistema. Se colocada na parte direita do ponto decimal (parte) inteira, juntamente com os dgitos, indica que deve ser usado o separador de milhar. A vrgula (,) pode ser usada como separador de milhar mesmo na notao cientfica, mas no para dividir o nmero por 1000.

Formatador Cientfico O nmero poder ser apresentado em notao cientfica (mantissa e expoente) quando aps algum digito houver E+, E-, e- ou e+, seguidos de dgitos para formatar o expoente. Quando for usado E+ ou e+ o expoente ser sempre mostrado com sinal, quando for usado E- ou e-, o sinal aparecer apenas para expoente negativos, sendo que no expoente sempre ser mostrado um dgito mesmo que este seja zero. O nmero de dgitos direita do ponto decimal afeta o expoente mostrado.

Manual E3

161

ELIPSE E3

Formatador para Texto O caractere @ copia o valor do dado na posio onde aparecer. Esse formatador deve aparecer no quarto campo (exemplo: ;;;@) ou diretamente quando h apenas um campo.

Formatadores para bases no decimais Os formatadores para bases no decimais sempre apresentam apenas a parte inteira do valor numrico formatado e tambm no so sensveis ao sinal. Da mesma forma que na base decimal, caso o nmero possua mais dgitos do que o requisitado no formatador esses dgitos so apresentados de qualquer forma. Atualmente estes formatadores esto limitados em nmeros de 32 bits. Caso a parte inteira do valor exceda esse limite a funo retornar erro.

Observao: este tipo de formatador no suportado em programas de planilhas de dados.


162 MANUAL E3

ELIPSE E3

1.45.3.Formatos para Data e Hora


A sintaxe da formatao de datas e horas difere um pouco do sistema usado pelas planilhas, seguindo o modo usado pela configurao regional do Windows. As datas so valores numricos onde a parte inteira uma contagem de dias desde 31 de dezembro de 1899 e a parte fracionria representa a hora em fraes de dia. O ano mnimo suportado 100 e o ano mximo 9999, isso garante uma resoluo de pelo menos 1 ms em todo o intervalo. Os nomes de meses e dias da semana, a ordem padro de dia, ms e ano, o separador de datas e horas so todos utilizados de acordo com a configurao regional do Windows. Atravs do quadro abaixo, possvel verificar o formatador e a sada formatada para os valores:

Manual E3

163

ELIPSE E3

Observao: quando usado algum formatador do tipo de tempo decorrido (especificado).

164

MANUAL E3

ELIPSE E3

1.46. Links
Links ou Conexes so as ligaes feitas entre os aplicativos e destes para seus mdulos, pela qual interligam-se entre si. Permite aos mdulos, servidores e clientes se conectarem/desconectarem em execuo, alm de permitir e coordenar o fluxo de informaes entre eles. Isso permite a cada Projeto ser executado e/ou interrompido, sem prejudicar o funcionamento do software. Os links trazem permitem grande facilidade ao criar animaes e outros tipos de associaes, visto que no necessrio a execuo de lgicas ou scripts para associar duas variveis quaisquer. Ao digitar ou associar um objeto ou propriedade no campo Fonte, o texto aparecer na cor azul, caso este corresponda a um tem existente e/ou carregado no Studio. Se o tem no existir ou pertencer a um mdulo no presente ou descarregado, o texto aparecer em vermelho. Para utilizar este recurso, proceda assim: Ao clicar com o boto direito do mouse sobre cada mdulo ou objeto, escolha a opo "Propriedades". Temos acesso, alm da pgina principal de configurao do objeto, as pginas Associaes e Scripts, que so padro para todos os objetos. A pgina Associaes permite acesso todas as propriedades do objeto em questo, para que possam ser diretamente ligadas com qualquer outra propriedade de qualquer outro objeto, mesmo que esteja em outro mdulo ou em outra aplicao. H vrios tipos de conexes por Links:

1.46.1.Conexo Simples
Conexo simples : Na Conexo Simples, o valor do campo Fonte copiado para a propriedade toda vez que o primeiro for modificado. No exemplo abaixo, a propriedade Angle est associada um TagDemo, via uma "Conexo Simples", representado por uma seta horizontal.

Manual E3

165

ELIPSE E3

Para utilizar este recurso, siga os seguintes procedimentos: Selecione o objeto desejado para a conexo.

Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e selecionando a opo Propriedades. Clique na Tab Associaes e selecione a propriedade que deseja fazer a conexo. O sistema indicar vrios tipos de conexes. Selecione a conexo desejada e clique no cone do App Browser, caso deseje associar alguma especificao.

1.46.2.Conexo Bidirecional
Conexo Bidirecional : Na Conexo Bidirecional, o mesmo acontece porm, caso tambm haja uma variao na propriedade, seu valor ser copiado para o Fonte, gerando assim um link de duas direes.

Para utilizar este recurso, siga os seguintes procedimentos: Selecione o objeto desejado para a conexo.

Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e selecionando a opo Propriedades. Clique na Tab Associaes e selecione a propriedade que deseja fazer a conexo. O sistema indicar vrios tipos de conexes.
166 MANUAL E3

ELIPSE E3

Selecione a conexo desejada e clique no cone do App Browser, caso deseje associar alguma especificao.

1.46.3.Conexo Digital
Conexo Digital : J na Conexo Digital, podemos estabelecer que caso a varivel do campo Fonte seja uma propriedade digital, seus estados verdadeiro e falso sejam mapeados para certos valores no Destino, incluindo a opo de Pisca (alternao de valores).

Para utilizar este recurso, siga os seguintes procedimentos: Selecione o objeto desejado para a conexo.

Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e selecionando a opo Propriedades. Clique na Tab Associaes e selecione a propriedade que deseja fazer a conexo. O sistema indicar vrios tipos de conexes. Selecione a conexo desejada e clique no cone do AppBrowser, caso deseje associar alguma especificao.

Manual E3

167

ELIPSE E3

1.46.4.Conexo Analgica
Conexo Analgica fonte e destino. : Estabelecer uma escala de converses entre a varivel

Para utilizar este recurso, siga os seguintes procedimentos: Selecione o objeto desejado para a conexo.

Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e selecionando a opo Propriedades. Clique na Tab Associaes e selecione a propriedade que deseja fazer a conexo. O sistema indicar vrios tipos de conexes. Selecione a conexo desejada e clique no cone do App Browser, caso deseje associar alguma especificao.

168

MANUAL E3

ELIPSE E3

1.46.5.Conexo por tabela


Conexo por Tabela : Podemos estabelecer condies entre a varivel, valores e destino,. Na tabela so especificados valores mnimo e mximo e valores referentes a estas condies. Para utilizar este recurso, siga os seguintes procedimentos: Clique nas propriedades do objeto e escolha a opo Associaes. Selecione a propriedade que deseja fazer a associao, e clique no tem Conexo por tabela.

Para inserir os campos da tabela na associao, pressione o boto

ou tecla

Insert do teclado. Para deletar um registro, clique no boto ou pressione a tecla Delete do teclado. Assim, ser possvel inserir os valores mnimo e mximo, e determinar os valores que setaro entre eles.

Manual E3

169

1 0

Captulo

10. Scripts

Os Scripts so mdulos de linguagem de programao, nos quais podem ser criadas linhas de cdigos que permitem maior flexibilidade para associar aes a eventos especficos. Cada tem de um aplicativo E3 possui uma lista de eventos previamente associados. Assim, o usurio poder criar programas que sero executados na ocorrncia de um evento especfico. 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 E3 j organiza, de certa maneira, esta ordem, pois so orientados eventos. Os Eventos so ocorrncias relacionadas a um objeto, que podem ser tratadas de modo a se realizar uma ao. Os eventos podem ser fsicos, como por exemplo alguma ao no teclado. Neste caso, a informao relevante seria a tecla pressionada (dentre outras); ou se o evento vem do mouse, a informao relevante seria a posio do cursor e os status dos botes. Os eventos podem ser internos, como a mudana de uma temperatura de uma cmara de 10 para 11 graus. As condies de eventos que podem ocorrer com os objetos j so previamente tratadas pelo E3, e so disponveis para o usurio ligar programas (scripts) a eles. A linguagem que o E3 Studio usa em seus scripts o VBScript, que um subconjunto da linguagem Microsoft Visual Basic, e um interpretador rpido, leve e portvel, desenvolvido para uso em browsers de internet e outras aplicaes que usam Microsoft ActiveX Controls, Automation Servers e Java applets. As Variveis (tags/ atributos), constantes e mtodos so os objetos bsicos, que podem ser manupulados num script. Os operadores especificam o que ser realizado com os mesmos; j as expresses combinam variveis e constantes para produzir novos valores. Em todos os objetos podem ser inseridos scripts que, conforme a especificao solicitada, executar determinada ao. Para utilizar este recurso, siga os seguintes procedimentos: Selecione o objeto que deseja criar o script e clique com o boto direito sobre ele e acesse a opo Propriedades; depois clique na aba Script.

Tutorial E3

170

ELIPSE E3

Verifique o que deseja fazer. Cada objeto possui eventos especficos e/ou eventos padro. Nesta caixa de dilogo, existem algumas opes para configurao do mesmo:

Outros eventos: Atravs desta opo, possvel especificar o evento desejado. Para utilizar este recurso, siga os seguintes procedimentos: Na aba Script, clique no boto (Outros Eventos);

Manial E3

171

ELIPSE E3

Adicionar Evento: Atravs desta opo, possvel adicionar um novo evento. Excluir Eventos: Atravs desta opo, possvel excluir o evento selecionado. Editar Eventos: Atravs desta opo, possvel editar o evento selecionado, especificando as informaes desejadas. Para criar um novo evento, clique no boto . Para configurar um evento

criado, clique no boto do novo evento.

. O sistema abrir uma caixa de dilogo, para criao

172

MANUAL E3

ELIPSE E3

Especifique as informaes solicitadas e clique em OK para inserir o evento. Para cancelar, clique no boto Cancelar. Um exemplo para a utilizao de eventos definidos pelo usurio, seria a realizao de um clculo ou tarefa mais complexa em um objeto, quando o evento gerador vem de um outro tag ou propriedade. Apesar de voc poder criar e executar este mesmo tipo de trabalho a partir do prprio tag ou propriedade gerador do evento, existem vantagens em manter o script junto do objeto que sofrer a ao do script. Dentre eles, podemos citar o trabalho adicional necessrio para fazer um objeto apontar para outro, alm de facilidades de manuteno, pois se por algum motivo for necessrio modificar ou deletar o tag ou propriedade que seja o evento gerador, no necessrio modificar um segundo objeto. Ainda como vantagens, esto o fato de que se voc deletar o tag gerador do evento, o objeto no perder o script, basta que voc indique uma outra fonte geradora de evento. A gerao de eventos internos facilita ainda a criao de bibiotecas, pois cada vez que um componente de biblioteca inserido em uma aplicao, traz consigo os scripts e clculos que possam ser necessrios, diminuindo o trabalho de configurao.

Manial E3

173

ELIPSE E3

1.47. Picks
Alm da opo "Executar Script" existem outras aes que podem ser associadas a um evento, que so experts chamados de Picks. Os Picks implementam um forma mais amigvel de realizar procedimentos mais comuns, poupando tempo de configurao. Entre eles esto atividades como troca de tela, atribuio de valores, etc..., conforme explicados anteriormente. Cada evento pode possuir um script e vrios picks associados, que ficam disponveis na lista vista direita. A ordem de execuo respeitada, sendo executada de cima para baixo. Para alterar a ordem, voc pode utilizar as setas para cima e para baixo. Cada objeto pode possuir qualquer quantidade de eventos com scripts ou picks associados.

1.48. Criando Scripts


Uma das maiores dificuldades ao criar um script obter a referncia correta aos objetos que se deseja manipular. Para um script acessar as propriedades e funes de um objeto ou varivel, necessrio que o objeto seja primeiramente encontrado nos vrios mdulos do E3. Devido a independncia existente entre cada um dos mdulos, nenhum objeto possui um acesso direto outro, o que uma caracterstica comum as linguagens como o Visual Basic. Deve-se ressaltar que ao editar um Script, o usurio poder utilizar o AppBrowser, que permite copiar para o script o caminho de uma funo ou propriedade de forma completa, auxiliando-o na criao de scripts. Portanto, para acessar objetos externos ao qual voc est manipulando num script, so utilizadas algumas diretivas bsicas. Existem basicamente trs localizaes de origem de scripts, do ponro de vista do local de execuo, que so os seguintes: Servidor (E3Server), ElipseX (Bibliotecas) e as Telas (Viewer). Acessando propriedades do Servidor Para se acessar um objeto que est rodando no servidor, a partir de um objeto de tela ou um ElipseX pode se usar a diretiva Application.GetObject("Nome do Mdulo"). A palavra "Application" indica que estamos nos conectando com o Servidor, e a funo GetObject procura por um mdulo E3 com o nome fornecido, devolvendo uma referncia para o objeto. Seja o exemplo de a partir de um boto na tela, desligar o scan de um tag num Driver de Comunicao:
Sub Retangulo1_Click()
174 MANUAL E3

ELIPSE E3

Application.GetObject("Driver1").Item("tag001").AllowRead = false End Sub

ou ainda
Sub Retangulo1_Click() Application.GetObject("Driver1.tag001").AllowRead = false End Sub

a funo Item foi utilizada para, a partir da referncia obtida ao Driver1, localizar o tag001. Depois de localizado o objeto, a suas propriedades e funes podem ser acessadas livremente. Caso alguma outra operao tivesse que ser realizada com o Driver1 ou tag001, outra alternativa para o script acima seria:
Sub Retangulo1_Click() Set obj = Application.GetObject("Driver1") obj.Item("tag001").AllowRead = false obj.Item("tag002").AllowRead = false End Sub

Neste caso, a varivel obj est "apontando" para o Driver1, e na prxima vez dentro do script que quisermos acessar algum objeto que descende de Driver1, podemos utilizar a varivel obj diretamente. Neste caso, opcional a declarao desse tipo de varivel, que assume o formato Variant do VBScript. A palavra Application nos scripts podem indicar tanto funes que so executadas no Viewer quanto no Servidor, no caso, o objeto Application sabe de antemo quais funes devem ser executadas tanto para um quanto para outro. Voc no pode, entretanto, executar funes de Viewer dentro do Servidor, assim como no possvel executar funes de Servidor dentro do Viewer. Acessando propriedades do Servidor de dentro do Servidor Suponha o exemplo de acessar as propriedades de um tag a partir de outro. Nesse caso, origem e destino esto no servidor, porm ligados via um mdulo "pai" que o Driver1. Nesse caso, deve ser usada a declarao Parent. Isto faz com que seja acessado primeiro o "pai" do objeto onde est o script, para depois descermos na hierarquia em busca de outro elemento. Exemplo:
Sub Tag1_OnRead() Parent.Item("tag002").AllowRead = false End Sub

Se estivermos dentro de um grupo, e queremos acessar o mesmo tag002, podemos aninhar" vrios comandos Parent. Exemplo:
Sub Tag1_OnRead() Parent.Parent.Item("tag002").AllowRead = false
Manial E3 175

ELIPSE E3

End Sub

Acessando Objetos de uma Tela a partir de um script na Tela Neste caso devemos usar somente a funo Item, j que os objetos so "filhos" da tela. Exemplo:
Sub Tela1_OnPreShow(vArg) Item("Retangulo1").Enabled = true End Sub

Acessando Objetos de uma Tela a partir de um script em outro objeto na Tela Neste caso devemos usar a funo Parent. Exemplo:
Sub Retangulo1_Click() Parent.Item("Retangulo2").Enabled = true End Sub

Modificando a Tela ou objetos de Tela a partir do Servidor Isso no possvel via scripts, pois cada cliente de dados uma cpia diferente das telas. A modificao de um comportamento qualquer na tela s pode ser feita, por uma questo de conceito, a partir de associaes (o servidor reporta automaticamente todas as mudanas das variveis escolhidas para os viewers) ou via busca explcita do viewer por informaes no servidor. Toda a operao de associao da interface grfica feita do cliente para o servidor, e no do servidor para o cliente. Acessando Objetos de um ElipseX a partir do proprio ElipseX Se voc declarou alguma propriedade para o ElipseX, e est usando o script OnPropertyChanged, ou ainda os scripts OnStart e OnStopRunning, o acesso aos objetos pode ser feito com a funo Item diretamente. No exemplo, via script OnPropertyChanged sao acessados objetos grficos num XControl:
For i = 1 TO max Set obj = Item("MenuSEItem" & Cstr(i)) obj.Visible = True Next

Caso voc tenha declarado um XMethod (um objeto ou propriedade do ElipseX) e queira acess-lo de dentro do ElipseX, no necessrio usar o comando Item. O acesso direto. Seja o exemplo com a declarao de uma varivel "liga" do tipo "boolean" no XControl "Lib1".O Acesso pode ser feito da forma abaixo:
Lib1.liga = true

176

MANUAL E3

ELIPSE E3

Imagine o mesmo XControl "Lib1" onde tambm est declarado o objeto "data", do tipo "Controle", sendo que "Controle" um XObject criado anteriormente.. O Objeto Controle pode ter como propriedades outros XMethods, como "setpoint" e "constante1". Para acessar a propriedade "setpoint" de qualquer lugar de dentro de "Lib1", podemos fazer:
Lib1.data.setpoint = 89

Vantagens do Uso do VBScript O VBScript troca informaes com as aplicaes utilizando ActiveX Scripting. Com o ActiveX Scripting, browsers e outras aplicaes clientes, como o E3 Viewer, no necessitam de cdigos especiais para cada componente de script. O ActiveX Scripting permite que um cliente compile scripts, obtenha e chame funes, dentre outros procedimentos. Isso possibilita que os scripts desenvolvidos para uma aplicao ou biblioteca, que devam ser executados na interface grfica, podem ser realizados tanto no E3 Viewer quanto em um browser de internet, sem a necessidade de qualquer adaptao do aplicativo. Ambiente de programao O ambiente de programao de scripts no E3 Studio, pode ser acessado atravs do clique com o boto direto do mouse sobre qualquer objeto, escolhendo a opo Propriedades. Todos os objetos possuem o Tab Scripts, que exibe uma janela. O combo Box que aparece na parte superior da janela onde definimos qual Evento ser o gerador de script. Existem dois tipos de Eventos em um objeto qualquer: aqueles pr-definidos, isto , j fazem parte do objeto, e aqueles definidos pelo usurio. Os eventos pr-definidos variam de objeto para objeto, a depender da sua utilizao e funcionalidade. Um objeto de tela, por exemplo, possui eventos relacionados interface grfica, como OnClick (chamado ao clicar sobre o objeto) ou OnDbClick (chamado com um duplo clique); j um objeto como um IODriver, possui eventos relacionados comunicao, como o OnCommError (chamado quando h um erro de comunicao). Voc pode tambm definir outros eventos para o objeto, ao clicar no boto "Outros Eventos, como explicado anteriormente. Ao selecionar um evento, voc pode clicar no cone "+" (adicionar) direita da janela, a fim de selecionar o tipo de ao relacionada com o evento. Pode ser escolhida a ao "Executar Script", que permitir a edio direta do script. Ao escolher esta opo automaticamente o campo de digitao apresenta uma declarao de Procedure (veremos com mais detalhes as procedures no prximo captulo) cuja definio automtica, composta do seguinte texto:
Sub NomedoObjeto_NomedoEvento() End Sub

NomedoObjeto ser substitudo pelo nome do objeto em questo e o Nome doEvento ser trocado pelo nome do evento em questo. Se voc no desejar criar
Manial E3 177

ELIPSE E3

um cdigo para este script, voc poder exclu-lo da lista. Caso porm, voc queira escrever um cdigo para o script, dever digit-lo entre a declarao da linha Sub e o final, no comando End Sub. Para ajudar na digitao do script, voc pode utilizar o App Browser, como j descrito neste manual. Ao escolher a funo ou propriedade desejada, voc pode acessar o boto "Copiar". O tag, propriedade ou funo escolhidos sero inseridos onde est o cursor do teclado na campo de digitao do script. O local do cursor ser mostrado atravs da animao com uma seta piscante.

1.48.1.Fundamentos de VBScript
Tipos de Dados O VBScript possui somente um tipo de dado chamado Variant. Um Variant um tipo especial de dado que pode conter diferentes tipos de informao, dependendo de como usado. Pelo fato do Variant ser o nico tipo de dado no VBScript, tambm o tipo de dado de retorno de todas as funes em VBScript. De forma simplista, um Variant pode conter informao numrica ou texto (string). Um Variant se comporta como um nmero quando voc o usa num contexto numrico e como uma string quando num contexto string. Isto , se voc est trabalhando com dados que parecem nmeros, o VBScript assume que um nmero e faz o que mais apropriado para os nmeros. Similarmente, se voc est trabalhando com dados que s podem ser texto, o VBScript trata como se fosse texto. Voc sempre pode fazer com que nmeros se comportem como texto colocando-os dentro de aspas (" "). Subtipos Variant Alm das classificaes simples de nmero ou texto, um Variant pode fazer distines sobre a natureza especfica da informao numrica. Por exemplo, voc pode ter informao numrica que representa data ou hora. Quando usado com outros dados de data e hora, o resultado sempre expresso como uma data ou hora. Voc tambm pode ter uma variedade de informao numrica variando em tamanho de tipos Booleanos at grandes nmeros em ponto flutuante. Estas dieferentes categorias de informao que podem estar contidas em um Variant so chamados subtipos. Na maioria das vezes, voc simplesmente atribui o tipo de dado desejado em um Variant, e ele se comporta da forma mais apropriada. A tabela abaixo mostra os subtipos que um Variant pode conter:

178

MANUAL E3

ELIPSE E3

Subtipos que um Variant pode conter


SUBTIPOS Empty Null Boolean Byte Integer Currency Long Single DESCRIO

Double

Date (Time) String Object Error

Variant no est inicializado. O valor 0 para variveis numricas ou string de comprimento zero ("") para variveis texto. Variant intencionalmente no contem dados vlidos. Contm True ou False. (0 ou 1). Contm inteiros na faixa 0 a 255. Contm inteiros na faixa -32768 a 32767. -922,337,203,685,477.5808 a 922,337,203,685,477.5807. Contm inteiros na faixa -2,147,483,648 to 2,147,483,647. Contm nmero ponto flutuante de preciso simples na faixa -3.402823E38 a -1.401298E-45 para valores negativos; 1.401298E45 a 3.402823E38 para valores positivos. Contm nmero ponto flutuante de preciso dupla, na faixa -1.79769313486232E308 a -4.94065645841247E-324 para valores negativos; 4.94065645841247E-324 a 1.79769313486232E308 para positivos. Contm um nmero que representa uma data entre 1 de Janeiro, 100 a 31 de Dezembro, 9999. Contm um texto de comprimento varivel que pode ter aproximadamente 2 bilhes da caracteres de comprimento. Contm um objeto. Contm um cdigo de erro.

1.49. Variveis
Uma varivel pode ser entendida como um armazenador que se refere uma localizao de memria no computador onde voc pode armazenar informaes que podem mudar durante a execuo do script. Por exemplo, voc pode criar uma varivel chamada ClickCount para guardar o nmero de vezes que o usurio clicou num objeto. Onde a varivel est armazenada na memria do computador no importante. O que importante que voc s precisa se referenciar uma varivel pelo nome para ver ou modificar seu valor. Em VBScript, as variveis so sempre do tipo fundamental Variant. Declarando variveis Voc pode declarar variveis explicitamente no seu script usando o comando Dim, o comando Public , e o comando Private. Por exemplo:
Dim DegreesFahrenheit

Manial E3

179

ELIPSE E3

Voc pode declarar mltiplas variveis separando cada nome de varivel com uma vrgula. Por exemplo:
Dim Top, Bottom, Left, Right

Voc tambm pode declarar uma varivel implicitamente simplesmente usando seu nome no script. Esta uma prtica rpida, porm se seu script for muito grande voc poder se confundir e criar mais de uma varivel com o mesmo nome. Restries de Nomes Os nomes de variveis devem seguir as regras de nomeao para qualquer coisa em VBScript. Um nome de varivel: Deve comear com um caracter alfabtico. No pode conter um ponto. No deve exceder 255 caracteres. Deve ser nico no escopo no qual est declarado.

Escopo e Tempo de vida de Variveis O escopo de uma varivel determinado por onde voc a declara. Quando voc declara uma varivel dentro de uma procedure, somente o cdigo dentro daquela procedure pode acessar ou mudar o valor daquela varivel. Ela tem escopo local e chamada de varivel procedure-level. Se voc declara uma varivel fora de uma procedure, pode faz-la reconhecvel a todas as procedures em seu script. Seria uma varivel script-level , e tem escopo de script. O tempo de vida de uma varivel depende de quanto tempo ela existe. O tempo de vida de uma varivel script-level se extende do momento que declarada at o momento que o script para de executar. No nvel de procedure, uma varivel existe somente enquanto voc est na procedure. Ao sair da procedure, a varivel destruda. Variveis locais so ideiais como espao de armazenamento temporrio quando uma procedure est em execuo. Voc pode ter variveis locais de mesmo nome em vrias procedures diferentes porque cada uma reconhecida somente pela procedure na qual foi declarada. Atribuindo Valores variveis Valores so atrbudos variveis criando uma expresso como a seguir: a varivel est no lado esquerdo da expresso e o valor que voc quer atribuir varivel fica direita. Por exemplo: B = 200 Variveis Escalares e tipo Array Na maioria das vezes, voc quer somente assinalar um valor simples varivel declarada. Uma varivel contendo um nico valor chamada varivel escalar. Outras vezes, conveniente atribuir mais de um valor relacionado com uma nica
180 MANUAL E3

ELIPSE E3

varivel. Ento voc pode criar uma varivel que contm uma srie de valores. Isto chamado de Array. Variveis Escalares e Arrays so declaradas da mesma forma, exceto que a declarao de um array utiliza parnteses ( ) seguindo o nome da varivel. No exemplo seguinte, um array de uma dimenso contendo 11 elementos declarado:
Dim A(10)

Apesar do nome mostrado nos parnteses ser 10, todos os arrays em VBScript comeam em zero (zero-based), ento este array atualmente contm 11 elementos. Num array de base zero, o nmero de elementos sempre o nmero mostrado nos parnteses mais um. O tipo de array chamado de tamanho fixo. Voc atribui dados cada um dos elementos de um array usando um ndice dentro do array. Comeando do zero e terminando em 10, dados podem ser atribudos aos elementos de um array como a seguir:
A(0) = 256 A(1) = 324 A(2) = 100 . . . A(10) = 55

Similiarmente, o dado pode ser copiado de qualquer elemento usando um ndice dentro do elemento particular de interesse. Por exemplo: ...
SomeVariable = A(8)

Os Arrays no esto limitados em uma simples dimenso. Voc pode ter at 60 dimenses, apesar da maioria das pessoas no compreenderem mais que 3 ou 4 dimenses. Voc pode declarar mltiplas dimenses separando o nmero de tamanho do array com vrgulas. No exemplo a seguir, a varivel MyTable um array de duas dimenses consistindo de 6 linhas e 11 colunas:
Dim MyTable(5, 10)

Num array bidimensional, o primeiro nmero sempre o nmero de linhas; o segundo nmero o nmero de colunas. Voc tambm pode declarar um array cujo tamanho muda durante a execuo do script. Isto chamado de array dinmico. O array inicialmente declarado dentro de uma procedure usando o comando Dim ou o comando ReDim. Entretanto, para um array dinmico, no colocado dentro dos parnteses nem o tamanho nem o nmero de dimenses. Por exemplo:
Dim MyArray() ReDim AnotherArray()

Para usar um array dinmico, voc deve subsequentemente utilizar ReDim para determinar o nmero de dimenses e o tamanho de cada dimenso. No exemplo seguinte, ReDim seta o tamanho inicial do array dinmico para 25. O comando ReDim seguinte redimensiona o array para 30, mas usa a palavra chave Preserve para preservar o contedo do array durante o processo de redimensionamento.

Manial E3

181

ELIPSE E3

ReDim MyArray(25) ReDim Preserve MyArray(30)

No h limite para o nmero de vezes que voc pode redimensionar um array dinmico, porm se voc torna um array menor, os dados eliminados so perdidos.

1.50. Constantes
Uma constante um nome que toma lugar de um nmero ou string que nunca muda. O VBScript define um nmero de constantes intrnsecas. Voc pode obter informaes sobre essas constantes no manual de referncia.

1.50.1.Criando Constantes
Voc pode criar constantes definidas pelo usurio em VBScript utilizando o comando Const. Usando o comando Const, voc pode criar constantes texto ou numricas como nomes com significado e atribuir valores literais. Por exemplo:
Const MyString = "Isto um texto." Const MyAge = 49

Note que o texto literal colocado entre parnteses (" "). Os parnteses so o mtodo mais bvio para diferenciar valores texto de numricos. Voc pode representar Datas e Horrios literais inserindo-os entre sinais de nmeros ou cancelas (#). Por exemplo:
Const CutoffDate = #6-1-97#

Voc pode querer adotar um esquema de nomes para diferenciar constantes de variveis. Isto vai prevenir voc de tentar reatribuir valores constantes enquanto o script est sendo executado. Por exemplo, voc pode querer usar um prefixo "vb" ou "con" nos nomes de constantes, ou deixar as constantes em letras maisculas. Diferenciar constantes de variveis elimina confuses que podem aparecer ao desenvolver scripts mais complexos.

1.51. Operadores
O VBScript possui uma ampla gama de operadores, incluindo operadores aritmticos, comparao, concatenao e lgicos.
182 MANUAL E3

ELIPSE E3

1.51.1.Precedncia de Operadores
Quando vrias operaes ocorrem em uma expresso, cada parte avaliada e resolvida em uma ordem preterminada chamada precedncia de operadores. Voc pode usar parnteses para redefinir a ordem de precedncia e forar algumas partes de um expresso a serem sempre realizadas antes daquelas que esto fora dos parnteses. Dentro dos parnteses, entretanto, a precedncia de operadores padro mantida. Quando expresses contm operadores de mais de uma categoria, os operadores aritmticos so avaliados primeiro, operadores de comparao so os prximos, e operadores lgicos so os ltimos. Operadores de Comparao possuem todos a mesma precedncia; isto , so avaliados da esquerda para a direita na ordem que aparecem. Operadores lgicos e aritmticos so avaliados na seguinte ordem:

Quando a multiplicao e diviso ocorrem juntas numa expresso, cada operao avaliada como aparece da esquerda para a direita. Da mesma forma, quando a
Manial E3 183

ELIPSE E3

adio e subtrao ocorrem juntas em uma expresso, cada operao avaliada em ordem de aparecimento da esquerda para a direita. O operador de concatenao de strings (&) no um operador aritmtico, mas em precedncia ele ocorre depois de todos os operadores aritmticos e antes de todos os operadores de comparao. O operador Is um operador de comparao de referncia de objetos. Ele no compara objetos ou seus valores; somente checa para determinar se duas referncias se referem ao mesmo objeto.

1.52. Controle de Fluxo


Controlando a Execuo do Programa Voc pode controlar o fluxo de execuo do script com comandos de condio e de lao. Com comandos condicionais, voc pode escrever cdigo VBScript que toma decises e repete aes. Os seguintes comandos condicionais esto disponveis em VBScript:
If Then Else Select Case

Tomando Decises Usando If ...Then ... Else O comando If...Then...Else usado para avaliar se uma condio verdadeira ou falsa e, dependendo do resultado, especificar um ou mais comandos para serem executados. Usualmente a condio uma expresso que usa um operador de comparao para comparar um valor ou varivel com outra. Os comandos If...Then...Else podem ser aninhados em quantos nveis voc precisar. Executando Comandos se uma Condio verdadeira Para executar somente um comando quando uma condio verdadeira, use a sintaxe de uma linha para o comando If...Then...Else. O exemplo a seguir mostra a sintaxe de uma linha. Note que este exemplo omite a palavra chave Else.
Sub FixDate() Dim myDate myDate = #2/13/95# If myDate < Now Then myDate = Now End Sub

Para executar mais de uma linha de cdigo, voc deve usar a sintaxe de bloco ou mltiplas linhas. Esta sintaxe inclui o comando End If, como mostrado abaixo:
Sub AlertUser(value)
184 MANUAL E3

ELIPSE E3

If value = 0 Then AlertLabel.ForeColor = vbRed AlertLabel.Font.Bold = True AlertLabel.Font.Italic = True End If

Executando Comandos se uma Condio verdadeira e outros se a condio Falsa Voc pode usar um If...Then...Else para definir dois blocos de cdigo: um para ser executado se a condio verdadeira, e outro bloco para ser executado se a condio falsa.
Sub AlertUser(value) If value = 0 Then AlertLabel.ForeColor = vbRed AlertLabel.Font.Bold = True Else AlertLabel.Forecolor = vbBlack AlertLabel.Font.Bold = False AlertLabel.Font.Italic = False End If End Sub

Decidindo entre vrias alternativas Uma variao no comando If...Then...Else permite a voc escolher entre vrias alternativas. Adicionando clusulas ElseIf expadimos a funcionalidade do comando If...Then...Else , ento voc pode controlar o fluxo de execuo baseado em diferentes possibilidades. Por exemplo:
Sub ReportValue(value) If value = 0 Then MsgBox value ElseIf value = 1 Then MsgBox value ElseIf value = 2 then Msgbox value Else Msgbox "Value out of range!" End If

Voc pode adicionar quantas clusulas ElseIf voc precisar para prover escolhas alternativas. O uso extensivo de clusulas ElseIf tornam o programa ruim. Uma melhor maneira de escolher entre vrias alternativas utilizar o comando Select Case.

Manial E3

185

ELIPSE E3

Tomando Decises com Select Case A estrutura Select Case prov uma alternativa ao If...Then...ElseIf para executar seletivamente um bloco de instrues dentre mltiplos blocos de instrues. O comando Select Case prov capacidade similar ao comando If...Then...Else, mas torna o cdigo mais eficiente e legvel. A estrutura Select Case trabalha com uma expresso simples de teste que avaliada uma vez, no topo da estrutura. O resultado da expresso ento comparada com os valores para cada Case em uma estrutura. Se h uma comparao verdadeira, o bloco de instrues associado com aquele Case executado, como no exemplo a seguir.
Select Case Document.Form1.CardType.Options(SelectedIndex).Text Case "MasterCard" DisplayMCLogo ValidateMCAccount Case "Visa" DisplayVisaLogo ValidateVisaAccount Case "American Express" DisplayAMEXCOLogo ValidateAMEXCOAccount Case Else DisplayUnknownImage PromptAgain End Select

Note que a estrutura Select Case avalia uma expresso uma vez no topo da estrutura. Em contraste, a estrutura If...Then...ElseIf pode avaliar uma expresso diferente para cada instruo ElseIf. Voc pode trocar uma estrutura If...Then...ElseIf com um Select Case somente se cada ElseIf avaliar a mesma expresso. Laos (Looping) Laos permitem a voc executar um grupo de instrues repetidamente. Alguns loops repetem cdigos at uma condio ser Falsa; outros repetem cdigos enquanto uma condio for verdadeira. Tambm existem loops que repetem instrues um nmero especfico de vezes. Os seguintes laos esto disponveis no VBScript: Do...Loop: Faz um lao enquanto ou at uma condio for verdadeira. While...Wend: Faz um lao enquanto uma condio for verdadeira. For...Next: Usa um contador para realizar execuo um nmero especfico de vezes. For Each...Next: Repete um grupo de comandos para cada item em uma coleo ou cada elemento de um array.

186

MANUAL E3

ELIPSE E3

Usando Laos Do ...Loop Voc pode usar comandos Do...Loop para executar um bloco de cdigo um nmero indefinido de vezes. Os comandos so repetidos enquanto a condio for verdadeira ou at ma condio ser tornar verdadeira. Repetindo Comandos enquanto uma condio verdadeira Use a palavra chave While para checar uma condio numa instruo Do...Loop. Voc pode checar a condio antes de entrar no loop (como mostrado no exemplo ChkFirstWhile), ou voc pode checar depois do loop ter rodado pelo menos uma vez (mostrado no exemplo ChkLastWhile). Na procedure ChkFirstWhile, se myNum colocado para 9 ao invs de 20, o cdigo dentro do loop nunca ser executado. Na procedure ChkLastWhile, o cdigo dentro do loop ser executado somente uma vez dentro do loop devido condio j ser falsa.

Sub ChkFirstWhile() Dim counter, myNum counter = 0 myNum = 20 Do While myNum > 10 myNum = myNum 1 counter = counter + 1 Loop MsgBox "The loop made " & counter & " repetitions." End Sub Sub ChkLastWhile() Dim counter, myNum counter = 0 myNum = 9 Do myNum = myNum 1 counter = counter + 1 Loop While myNum > 10 MsgBox "The loop made " & counter & " repetitions." End Sub

Repetindo um cdigo at que uma condio seja verdadeira Existem dois mtodos de usar a palavra chave Until para checar uma condio num loop Do...Loop. Voc pode checar a condio antes de entrar no loop (como mostrado no exemplo ChkFirstUntil) ou voc pode checar depois do loop ter rodado pelo menos uma vez (mostrado no exemplo ChkLastUntil). Enquanto a condio for falsa, o loop acontece.
Sub ChkFirstUntil() Dim counter, myNum counter = 0
Manial E3 187

ELIPSE E3

myNum = 20 Do Until myNum = 10 myNum = myNum 1 counter = counter + 1 Loop MsgBox "The loop made " & counter & " repetitions." End Sub Sub ChkLastUntil() Dim counter, myNum counter = 0 myNum = 1 Do myNum = myNum + 1 counter = counter + 1 Loop Until myNum = 10 MsgBox "The loop made " & counter & " repetitions." End Sub

Saindo de uma instruo Do...Loop de dentro do Loop Voc pode sair de um Do...Loop usando o comando Exit Do. Devido ao fato de desejar sair somente em certas situaes, como para evitar um loop infinito, voc deve usar o comando Exit Do na condio verdadeira de um comando If...Then...Else. Se a condio falsa, o loop ocorre normalmente. No exemplo a seguir, myNum assinalado com um valor que cria um loop infinito. O comando If...Then...Else checa essa condio, prevenindo a execuo infinita.
Sub ExitExample() Dim counter, myNum counter = 0 myNum = 9 Do Until myNum = 10 myNum = myNum - 1 counter = counter + 1 If myNum < 10 Then Exit Do Loop MsgBox "The loop made " & counter & " repetitions." End Sub

Usando While...Wend O Comando While...Wend provido no VBScript para aqueles que so familiares a seu uso. Entretanto, a falta de flexibilidade no While...Wend, faz com que seja recomendado o uso da instruo Do...Loop.

188

MANUAL E3

ELIPSE E3

Usando For...Next Voc pode usar o comando For...Next para executar um bloco de instrues um nmero especfico de vezes. Para loops, use uma varivel como contador cujo valor incrementado ou decrementado com cada repetio do loop. O exemplo a seguir faz com que a procedure MyProc seja executada 50 vezes. O comando For especifica a varivel x e seus valores iniciais e finais. O comando Next incrementa o contador em uma unidade.
Sub DoMyProc50Times() Dim x For x = 1 To 50 MyProc Next End Sub

Usando a palavra chave Step, voc pode incrementar ou decrementar a varivel contadora pelo valor que voc especificar. No exemplo a seguir, o contador incrementado por 2 cada vez que o loop repetido. Quando o loop acaba, o total a soma de 2, 4, 6, 8, e 10.
Sub TwosTotal() Dim j, total For j = 2 To 10 Step 2 total = total + j Next MsgBox "The total is " & total End Sub

Para decrementar o contador, use um valor negativo para o Step. Voc deve especificar um valor final que menor que o valor inicial. No exemplo a seguir, myNum decrementado de 2 em 2 cada vez que o loop repetido. Quando o loop termina, o total a soma de 16, 14, 12, 10, 8, 6, 4, and 2.
Sub NewTotal() Dim myNum, total For myNum = 16 To 2 Step 2 total = total + myNum Next MsgBox "The total is " & total End Sub

Voc pode sair de qualquer comando For...Next antes do contador alcanar seu valor final usando o comando Exit For. Pelo fato de voc querer sair somente em certas situaes, como quando um erro ocorre, voc deve usar o comando Exit For na parte verdadeira de uma instruo If...Then...Else . Se a condio falsa, o loop executado normalmente.

Manial E3

189

ELIPSE E3

Usando For Each...Next Um Loop For Each...Next similar a um loop For...Next. Ao invs de repetir as intrues de um bloco um nmero especfico de vezes, um loop For Each...Next repete um grupo de comandos para cada item numa coleo de objetos ou para cada elemento num array. Isto bastante til quando voc no sabe quantos elementos esto presentes em uma coleo. Exemplo:
Sub cmdChange_OnClick Dim d 'Create a variable Set d = CreateObject("Scripting.Dictionary") d.Add "0", "Athens" 'Add some keys and items d.Add "1", "Belgrade" d.Add "2", "Cairo" For Each I in d Document.frmForm.Elements(I).Value = D.Item(I) Next End Sub

1.53. Procedimentos (Procedure)


Em VBScript, existem dois tipos de procedures; a procedure Sub e a procedure Function. Procedure Sub Uma procedure Sub uma srie de comandos VBScript, entre as instrues Sub e End Sub, que realizam aes mas no retornam valores. Uma procedure Sub pode receber argumentos (constantes, variveis ou expresses que so passadas por uma procedure que a chama). Se uma procedure Sub no tem argumentos, o comando Sub deve incluir uma dupla vazia de parnteses. A procedure Sub seguinte usa duas funes intrnsecas ou internas do VBScript, MsgBox e InputBox, para mostrar uma informao ao usurio. Ela ento mostra o resultado de um clculo baseado nessa informao. O clculo realizado em uma procedure Function criada utilizando VBScript. A procedure Function mostrada a seguir:
Sub ConvertTemp() temp = InputBox("Please enter the temperature in degrees F.", 1) MsgBox "The temperature is " & Celsius(temp) & " degrees C." End Sub

Procedure Function Uma procedure Function uma srie de instrues VBScript entre os comandos Function e End Function. Uma Function similar uma
190 MANUAL E3

ELIPSE E3

procedure Sub, mas pode retornar um valor. Uma procedure Function pode ter argumentos (constantes, variveis ou expresses que so passadas por uma procedure que a chama). Se uma Function no possui argumentos, o comando Function deve incluir uma dupla vazia de parnteses. Uma Function retorna um valor atribuindo um valor seu nome em uma ou mais instrues na procedure. O tipo de retorno em uma Function sempre um Variant. No exemplo a seguir, a funo Celsius calcula graus Celsius a partir de graus Fahrenheit. Quando a funo chamada da procedure Sub ConvertTemp, uma varivel contendo o valor do argumento passada para a funo. O resultado do clculo retornado procedure que fez a chamada e mostrado em uma message box.
Sub ConvertTemp() temp = InputBox("Please enter the temperature in degrees F.", 1) MsgBox "The temperature is " & Celsius(temp) & " degrees C." End Sub Function Celsius(fDegrees) Celsius = (fDegrees - 32) * 5 / 9 End Function

Extraindo e Inserindo dados em uma Procedure Para passar cada dado para suas procedures utilizado um argumento. Argumentos servem como armazenadores para os dados que voc quer passar para dentro de sua procedure. Voc pode nomear seus argumentos com qualquer nome vlido de varivel. Quando voc cria uma procedure usando o comando Sub ou Function, parnteses devem ser includos depois do nome da procedure. Quaisquer argumentos so colocados dentro dos parnteses, separados por vrgulas. No exemplo a seguir, fDegrees o armazenador para o valor sendo passado funo Celsius para a converso.
Function Celsius(fDegrees) Celsius = (fDegrees - 32) * 5 / 9 End Function

Para extrair dados de uma procedure, voc deve usar uma Function. Lembre-se, uma Function pode retornar um valor; uma Sub no o pode. Usando procedure Sub e Function Uma Function em seu cdigo deve sempre ser usada no lado direito de uma atribuio de varivel ou expresso. Por exemplo:
Temp = Celsius(fDegrees) -ouMsgBox "The Celsius temperature is " & Celsius(fDegrees) & " degrees."

Manial E3

191

ELIPSE E3

Para chamar uma procedure Sub de outra procedure, digite o nome da procedure junto com os valores para qualquer dos argumentos requeridos, cada um separado por vrgula. O comando Call no necessrio, mas se voc us-lo, deve incluir qualquer argumento entre parnteses. O exemplo a seguir mostra duas chamadas procedure MyProc. Uma usa o comando Call e outra no. Ambas realizam a mesma coisa.
Call MyProc(firstarg, secondarg) MyProc firstarg, secondarg

Note que os parnteses so omitidos na chamada quando o comando Call no usado. Convenes de Cdigo Convenes de cdigo so sugestes para ajudar a desenvolver cdigo em VBScript. Podem conter: Convenes de nomes para objetos, variveis e procedures; Convenes para comentrios; Formatao de texto e guias para identao;

Formatao de texto e guias para identao A principal razo para usar um conjunto consistente de convenes de codificao padronizar a estrutura e estilo de codificao de um script ou um conjunto de scripts para que voc e outras pessoas possam ler e entender o cdigo. O uso de boas convenes de codificao resulta em um cdigo-fonte preciso, legvel e no-ambguo, que consistente com as convenes de outras linguagens e to intuitivo quanto possvel. As convenes de codificao incluem os seguintes tpicos: Nomeao de constantes, varivel, procedimentos e objetos Na nomeao de constantes, variveis, procedimentos e objetos, um ponto pacfico: os nomes devem sempre informar a respeito da finalidade a que o objeto prope-se. Constantes Use o prefixo "con" seguido do nome da constante. Inicie o nome da constante com letra maiscula. Para nomes de constantes com duas ou mais palavras, separeas usando apenas as letras mausculas para definir o incio da nova palavra. Exemplo:
192 MANUAL E3

ELIPSE E3

conMinhaConstante Variveis Embora um nome razoavelmente extenso seja o recomendado, nomes com mais de 32 caracteres tornam-se difceis de ler e digitar. Nesse caso, bom usar nomes abreviados, principalmente para variveis que possuam um uso muito grande, como contadores em laos. Deve-se, entretanto, usar um mesmo padro de abreviao em todo o cdigo (no defina, por exemplo, uma varivel contadora com "Cnt" em um procedimento e "Cont" em outro). Alm disso, recomendado usar prefixos da nomeao de variveis, que indicam o seu subtipo e o seu escopo. Isso muito til no uso de variveis em funes ou em laos que trabalhem com um subtipo especfico ou para no usar variveis locais de um procedimento em outro. A seguir, os prefixos recomendados para os subtipos do tipo de dado Variant e para os escopos possveis em VB Script:

Manial E3

193

ELIPSE E3

Exemplos: varivel local do tipo String: strMeuNome; varavel pblica do tipo Double: sdblNmeroChamadas;

Procedimentos: Uma boa tcnica usar o par verbo-substantivo para a nomeao (no use, entretanto, palavras vagas, ambguas ou genricas, como "faz", "coisa" e "isso"). Se voc encontrar dificulade para nomear um procedimento usando essas sugestes, talvez ele no tenha razo de existir ou seu propsito esteja errado. Exemplos: ClassificaMatrizNomes CaculaTaxaJuros AjustaMargens

Objetos: Recomenda-se usar os seguintes prefixos:

194

MANUAL E3

ELIPSE E3

Comentrios Todos os procedimentos devem comear com um breve comentrio do que ele faz. No entanto, esse comentrio no deve descrever os detalhes de implementao, porque isso freqentemente consome muito tempo e resulta num trabalho de manuteno de comentrios desnecessrio. O cdigo em si ou os comentrios aos finais das linhas descrevero como o procedimento executa a tarefa a que se prope. Alis, uma recomendao muito importante, mas que deve causar dio e pavor imensa maioria dos programadores : comente cada linha de cdigo no seu programa! Embora seja demasiadamente trabalhoso, isso lhe poupar muita dor de cabea, principalmente quando voc tentar, algum tempo depois ter escrito o cdigo, ler o que voc mesmo escreveu. Uma boa dica para quem odeia comentar usar a seguinte tcnica: primeiro, escreva todo o cdigo; depois, comente todas as linhas. Isso ser muito til para revisar o cdigo e encontrar erros sintticos ou semnticos (e pode estar certo de que voc ir encontrar muitos, apesar de ser um timo programador!). Alm disso, algumas vezes pode ser til incluir, no incio do cdigo, um pequeno pseudocdigo descrevendo o algoritmo.

Manial E3

195

ELIPSE E3

Para cada procedimento, deve-se, antes da sua definio, incluir as seguintes informaes: Proposta (o que o procedimento faz, e no como); Suposies (que outras partes do programa afetam tal procedimento); Efeitos (que outras partes do programa tal procedimento afeta); Parmetros (a explicao da finalidade de cada parmetro deve ser feita em uma linha prpria);

Formatao e identao do cdigo Utilize identaes (ou seja, tabulaes) para indicar os relacionamentos entre blocos de cdigo. No caso de construes com um incio e um final bem definidos - os laos, por exemplo, use um recuo de quatro espaos no seu contedo, uma vez para cada nvel de aninhamento. Alm disso, os comentrios iniciais dos procedimentos devem ser identados em um espao. interessante tambm deixar uma linha em branco entre a definio e o corpo do procedimento e as partes diversas do corpo (declaraes, inicializaes, processos, etc.).

1.54. Sintaxe SQL


Os dados de alarmes/eventos e histricos armazenados em disco so guardados em tabelas. Muitas vezes precisamos realizar consultas nessas tabelas a fim de apresentar os dados na tela ou em um relatrio. Para fazer as consultas, muitas vezes desejamos ordenar e/ou filtrar os dados; nesses casos, devemos utilizar uma estrutrura de consulta de dados chamada SQL (Structured Query Language). Voc poder utilizar consultas SQL em scripts, relatrios, objetos de alarmes (E3Alarm) e browser (E3Browser), dentre outros objetos. Comando Select Num Banco de Dados relacional, os dados so guradados em tabelas. Um exemplo segue abaixo:

196

MANUAL E3

ELIPSE E3

Digamos que voc queira ver o endereo de cada empregado. Para isso, use o comando SELECT:
SELECT FirstName, LastName, Address, City, State FROM EmployeeAddressTable;

O resultado da consulta mostrado abaixo:

Na consulta realizada, voc perguntou por todos os dados na tabela EmployeeAddressTable, e especificamente, voc perguntou pelas colunas chamadas FirstName, LastName, Address, City, e State. Note que os nomes de colunas e tabelas no possuem espaos.. devem ser digitadas como uma nica palavra; e o comando termina com um ponto e vrgula(;). A forma geral para o comando SELECT, retornando todos os dados numa tabela :
SELECT ColumnName, ColumnName, ... FROM TableName;

Para obter todas as colunas de uma tabela sem digitar o nome das colunas, use:
SELECT * FROM TableName;

Os objetos do E3 j fazem consultas SQL com o comando SELECT internamente. Este comando pode ser usado em um Script, por exemplo, caso queira realizar uma consulta em uma base de dados qualquer via programao.

Manial E3

197

ELIPSE E3

1.55. Seleo Condicional


Para prosseguir com o comando SELECT, vamos verificar uma nova tabela, mostrada abaixo:

1.56. Operadores Condicionais


Existem seis operadores relacionais em SQL, e depois de introduzi-los, voc ver como so usados:

198

MANUAL E3

ELIPSE E3

A clusula WHERE usada para especificar que somente certas linhas da tabela sero mostradas, baseados nos critrios descritos na clusula WHERE . Veja os exemplos a seguir. Se voc quiser ver o campo EMPLOYEEIDNO daqueles que ganham mais de $50,000, use o comando:
SELECT EMPLOYEEIDNO FROM EMPLOYEESTATISTICSTABLE WHERE SALARY >= 50000;

Note que o sinal >= (maior ou igual a) usado, como queremos ver aqueles que recebem um valor maior ou igual a $50,000. O resultado :
EMPLOYEEIDNO -----------010 105 152 215 244

A descrio WHERE , SALARY >= 50000, conhecida como uma conditio (uma operao que avalia VERDADEIRO ou FALSO). O mesmo pode ser feito para colunas texto:
SELECT EMPLOYEEIDNO FROM EMPLOYEESTATISTICSTABLE WHERE POSITION = 'Manager';

O comando acima mostra os nmeros de ID de todos os Gerentes. Geralmente, com colunas texto, o valor colocado entre aspas simples. ('). Nota: A palavra Position um identificador ilegal pois uma palavra chave no usada mas reservada, de acordo com a norma SQL-92. Mais Condies: Condies Compostas / Operadores Lgicos O operador AND une duas ou mais condies, e mostra uma coluna somente se cada linha satisfizer todas as condies listadas. Para mostrar todas as pessoas do Staff e que ganham mais de $40,000, use:
SELECT EMPLOYEEIDNO FROM EMPLOYEESTATISTICSTABLE WHERE SALARY > 40000 AND POSITION = 'Staff';

O Operador OR une duas ou mais condies, mas retorna uma linha se qualquer uma das condies for verdadeira. Exemplo:
SELECT EMPLOYEEIDNO FROM EMPLOYEESTATISTICSTABLE WHERE SALARY < 40000 OR BENEFITS < 10000;

Manial E3

199

ELIPSE E3

AND e OR podem ser combinados, por exemplo:


SELECT EMPLOYEEIDNO FROM EMPLOYEESTATISTICSTABLE WHERE POSITION = 'Manager' AND (SALARY > 60000 OR BENEFITS > 12000); < TT >

IN & BETWEEN Um mtodo mais fcil de usar condies compostas usar IN ou BETWEEN. Por exemplo, se voc quiser listar todos os gerentes e staff:
SELECT EMPLOYEEIDNO FROM EMPLOYEESTATISTICSTABLE WHERE POSITION IN ('Manager', 'Staff');

ou para listar aqueles que ganham mais que $30,000, mas menos que $50,000, use:
SELECT EMPLOYEEIDNO FROM EMPLOYEESTATISTICSTABLE WHERE SALARY BETWEEN 30000 AND 50000;

Para listar todos aqueles fora dessa faixa, use:


SELECT EMPLOYEEIDNO FROM EMPLOYEESTATISTICSTABLE WHERE SALARY NOT BETWEEN 30000 AND 50000;

Similarmente, NOT IN lista todas as linhas excludas do comando IN. Additionalmente, NOT's podem ser inseridos com AND's e OR's, exceto pelo fato que NOT um operador unrio (avalia uma condio, reverter o valor, quando AND's e OR's avaliam duas condies), e que todos os NOT's so avaliados antes que qualquer AND ou OR. Ordem SQL de operadores lgicos (cada um opera da esquerda para a direita)
NOT AND OR

Usando LIKE Olhe na tabela EmployeeStatisticsTable, e digamos que voc queira ver todas as pessoas cujos sobrenomes comeam com S:
SELECT EMPLOYEEIDNO FROM EMPLOYEEADDRESSTABLE WHERE LASTNAME LIKE 'S%';
200 MANUAL E3

ELIPSE E3

O smbolo de porcentagem (%) usado para representar qualquer caracter possvel (nmero, letra ou pontuao) ou conjunto de caracteres que podem aparecer depois do "S". Para encontrar as pessoas cujo sobrenome termina em "S", use '%S', ou se voc quiser o "S" no meio da palavra, use '%S%'. O '%' pode ser usado para quaisquer caracteres na mesma posio relativa aos caracteres solicitados. NOT LIKE mostra linhas que no se enquadram na descrio solicitada. Outras possibilidades do comando LIKEdisplays rows not fitting the given description. Joins Nesta seo, discutiremos as Joins inner , and equijoins. Um bom desenho de banco de dados sugere que cada tabela liste somente dados sobre uma nica entidade, e uma informao mais detalhada pode ser obtida num banco relacional, usando tabelas adicionais e usando uma unio. Primeiro, usaremos as tabelas abaixo: AntiqueOwners

Manial E3

201

ELIPSE E3

Orders

Antiques

202

MANUAL E3

ELIPSE E3

Chaves Uma chave primria uma coluna ou conjunto de colunas que identificam de forma nica o resto dos dados em uma dada linha. Por exemplo, na tabela AntiqueOwners, a coluna OwnerID identifica nicamente aquela linha. Isso significa duas coisas: Duas linhas no podem ter o mesmo OwnerID, e, mesmo se dois owners possurem o mesmos nomes (nome e sobrenome) a coluna OwnerID garantem que as duas pessoas no sero confundidas, pois a coluna OwnerID ser usada pera buscar as pessoas, ao invs dos nomes. Uma chave estrangeira foreign key uma coluna em uma tabela que uma chave primria para outra tabela, o que significa que qualquer dado em uma chave estrangeira deve ter um dado correspondente em outra tabela onde aquela coluna a chave primria. Realizando um Join O propsito dessas chaves que o dado pode ser relatado entre as tabelas, sem a necessidade de repetir os dados em cada tabela. Por exemplo, voc pode encontrar os nomes daqueles que compraram uma cadeira sem listar o nome completo na tabela Antiques. Para encontrar os nomes daqueles que compraram uma cadeira, use a sintaxe:
SELECT OWNERLASTNAME, OWNERFIRSTNAME FROM ANTIQUEOWNERS, ANTIQUES WHERE BUYERID = OWNERID AND ITEM = 'Chair';

Note que ambas tabelas envolvidas na relao so listadas na clusula FROM. Na clusula WHERE, note que ITEM = 'Chair' restringe a listagem para aqueles que compraram uma cadeira. Em segundo lugar, note que as colunas ID so relacionada de uma tabela a outra usando a clusula BUYERID = OWNERID. Somente onde o ID bate entre as tabelas e o item comprado uma cadeira, os nomes sero listados. A notao com ponto pode ser usada para evitar ambiguidades, como segue:
SELECT ANTIQUEOWNERS.OWNERLASTNAME, ANTIQUEOWNERS.OWNERFIRSTNAME FROM ANTIQUEOWNERS, ANTIQUES WHERE ANTIQUES.BUYERID = ANTIQUEOWNERS.OWNERID AND ANTIQUES.ITEM = 'Chair';

Como as colunas tinham nomes diferentes em cada tabela, isto no era necessrio.

DISTINCT e Eliminando Duplicaes


Digamos que voc quer listar o ID e nomes somente das pessoas que venderam objetos antigos. Obviamente, voc quer uma lista que cada vendedor listado somente uma vez. Isto significa que voc ter que dizer ao SQL para eliminar vendas duplicadas, e listar cada pessoa somente uma vez. Para isso, use o comando DISTINCT.
Manial E3 203

ELIPSE E3

Primeiro, precisaremos de uma equijoin para a tabela AntiqueOwners para pegar dados do nome da pessoa (LastName e FirstName). Entretanto, tenha em mente que desde que a coluna SellerID na tabela Antiques uma chave estrangeira para a tabela AntiqueOwners, um vendedor somente ser listado se existir uma linha na tabela AntiqueOwners listando o ID e nomes. Ns tambm queremos eliminar mltiplas ocorrncias do campo SellerID, ento usaremos DISTINCT na coluna onde a repetio pode ocorrer:
SELECT DISTINCT SELLERID, OWNERLASTNAME, OWNERFIRSTNAME FROM ANTIQUES, ANTIQUEOWNERS WHERE SELLERID = OWNERID ORDER BY OWNERLASTNAME, OWNERFIRSTNAME;

Aliases & In/Subqueries Seja o exemplo abaixo que mostra o sobrenome das pessoas que colocaram um pedido e o que o pedido , somente listando aqueles pedidos que podem ser feitos (isto , existe um comprador que possui o item ordenado):
SELECT OWN.OWNERLASTNAME Last Name, ORD.ITEMDESIRED Item Ordered FROM ORDERS ORD, ANTIQUEOWNERS OWN WHERE ORD.OWNERID = OWN.OWNERID AND ORD.ITEMDESIRED IN (SELECT ITEM FROM ANTIQUES);

isto resulta:
Last Name Smith Smith Akins Lawson Item Ordered Table Desk Chair Mirror

Note alguns fatos sobre esta consulta: O comando "Last Name" e "Item Ordered" na linha Select so os cabealhos no relatrio. O OWN & ORD so aliases; so os novos nomes oara as duas tabelas listadas na clusula FROM que so usadas como prefixos para todas notaes com pontos. Isto elimina ambiguidades entre as tabelas. Note que a tabela Orders listada primeiro na clusula FROM; isso faz com que a listagem seja feita fora daquela tabela, e que a tabela AntiqueOwners somente usada para informao de detalhes (Last Name). O mais importante, a clusula AND dentro do WHERE fora a subquery In a ser invocada ("= ANY" ou
204 MANUAL E3

ELIPSE E3

"= SOME" so dois usos equivalentes de IN). Isso faz com que a subquery seja executada, retornando todos os itens da tabela Antique, pois no h clausula WHERE. Resumindo: A subquery retorna um conjunto de itens nos quais cada ItemDesired na tabela Orders comparado; a condio In verdadeira somente se ItemDesired est dentro daqueles retornados pela tabela Antiques. Outros comandos SQL Funes Aggregate Abordaremos 5 importantes funes aggregate: SUM, AVG, MAX, MIN, e COUNT. Elas so chamadas aggregate porque sintetizam os resultados de uma consulta, ao invs de listar todas as colunas SUM () d o total de todas as colunas, satisfazendo qualquer condio, ou a dada coluna, quando a coluna numrica. AVG () d a mdia das colunas. MAX () retorna o maior valor. MIN () retorna o menor valor. COUNT(*) retorna o nmero de linhas satisfazendo uma condio. Usando as tabelas mostradas no incio deste captulo, temos:
SELECT SUM(SALARY), AVG(SALARY) FROM EMPLOYEESTATISTICSTABLE;

Esta consulta retorna o total de todos os salrios e o salrio mdio na tabela.


SELECT MIN(BENEFITS) FROM EMPLOYEESTATISTICSTABLE WHERE POSITION = 'Manager';

Esta consulta retorna o menor benefcio dos empregados que so gerentes.


SELECT COUNT(*) FROM EMPLOYEESTATISTICSTABLE WHERE POSITION = 'Staff';

Esta consulta retorna quantos empregados possuem o Status de Staff (3).

Criando Novas Tabelas Podem ser criadas novas tabelas em execuo. Os tipos de dados mais usuais so Char, Integer, Decimal, Date e Logical.
CREATE TABLE ORDERS (OWNERID INTEGER NOT NULL, ITEMDESIRED CHAR(40) NOT NULL);

Manial E3

205

ELIPSE E3

Alterando Tabelas Vamos adicionar uma coluna tabela Antiques para permitir a entrada de preo de um determinado item:
ALTER TABLE ANTIQUES ADD (PRICE DECIMAL(8,2) NULL);

Os dados para esta tabela podem ser atualizados ou inseridos em proximas operaes. Adicionando Dados Para inserir dados em uma tabela, faa o seguinte:
INSERT INTO ANTIQUES VALUES (21, 01, 'Ottoman', 200.00);

Isto insere dados na tabela como uma nova linha, numa ordem pre-definifa. Ao invs disso, vamos mudar a ordem a deixar o preo em branco:
INSERT INTO ANTIQUES (BUYERID, SELLERID, ITEM) VALUES (01, 21, 'Ottoman');

Deletando Dados Vamos deletar essa nova linha do banco de dados:


DELETE FROM ANTIQUES WHERE ITEM = 'Ottoman';

Mas se h uma outra linha que contm 'Ottoman', aquela linha ser deletada tambm. Vamos deletar todas as linhas (uma, nest caso) que contm os dados especficos que adicionamos antes:
DELETE FROM ANTIQUES WHERE ITEM = 'Ottoman' AND BUYERID = 01 AND SELLERID = 21;

Atualizando Dados Vamos atualizar um preo numa linha que no tem um preo listado ainda: Esta consulta coloca o preo da cadeira em 500.00. Como mostrado acima, condies WHERE podem ser usadas para limitar a atualizao de certas colunas.

1.57. Outros Tpicos Gerais


SQL No-padro Em adio s funes agregadas mostradas, existem outras funes que podem ser utilizadas, exceto que so usadas erm valores individuais (no grupos) em colsultas de uma nica linha. Estas funes devem ser usadas em tipos de dados apropriados. Eis algumas funes matemticas:

206

MANUAL E3

ELIPSE E3 ABS(X) CEIL(X) FLOOR(X) Valor Absoluto X um valor decimal a ser arredondado para cima X um valor decimal a ser arredondado para baixo

GREATEST(X,Y) Retorna o maior de dois nmeros LEAST(X,Y) MOD(X,Y) POWER(X,Y) ROUND(X,Y) SIGN(X) SQRT(X) Retorna o menor de dois nmeros. Retorna o resto de X / Y. Retorna X potncia de Y. Arredonda X para Y casas decimais. Se Y omitido, X arredondado para o prximo inteiro. Retorna um menos se X < 0, seno um mais. Retorna a raiz quadrada de X.

Funes de Caracteres
LEFT(<string>,X) RIGHT(<string>,X) UPPER(<string>) LOWER(<string>) INITCAP(<string>) LENGTH(<string>) Manial E3 Retorna os X caracteres mais esquerda do texto Retorna os X caracteres mais direita do texto Converte o texto para caracteres maisculos. Converte o texto para caracteres minsculos. Converte o texto para o formato original. Retorna o nmero de caracteres no texto. 207

ELIPSE E3

<string>||<string> LPAD(<string>,X,'*')

Soma dois strings. Adiciona esquerda do texto um caracter fazendo o texto X caracteres maior. Adiciona direita do texto um caracter fazendo o texto X caracteres maior. Extrai Y caracteres do texto comeando na posio X .

RPAD(<string>,X,'*')

SUBSTR(<string>,X,Y)

A funo valor nulo substitui <value> por qualquer NVL(<column>,<value>) NULL no campo <column>. Se o valor corrente de <column> no NULL, NVL no tem efeito.

208

MANUAL E3

1 1

Captulo

11. Banco de Dados

O Banco de dados do E3 utilizado para armazenar e centralizar todos os dados ou informaes referentes ao projeto. importante lembrar que alguns objetos possuem banco de dados especficos que tambm so responsveis pelo gerenciamento das informaes. O objeto ServidorDB um servidor de Banco de Dados, responsvel pelo armazenamento e gerenciamento das informaes de Histricos, Alarmes, Frmulas e Receitas que utilizam seus servios. Possui suporte MDB (Access) e Add-ons podem ser adicionados ao E3 para prover accesso a outros Bancos de Dados, como Oracle e Microsoft SQL Server. Atravs da propriedade SourceType possvel escolher o tipo de banco de dados(Oracle, SQLServer ou Access) que ser utilizado no sistema. Para utilizar este recurso, clique com o boto direito do mouse sobre o nome do projeto e escolha a opo "Inserir" e " Banco de Dados".

Manual E3

209

ELIPSE E3

1.58. Criando um Banco de Dados


Ao inserir o banco de dados no sistema, so habilitadas as opes referentes ao tipo de servidor de dados. As opes existentes so: Servidor de Dados Oracle, Access e SQL Server. Estes parmetros de definio do banco de dados so definidos atravs da propriedade SourceType.

1.58.1.Servidor de Dados Access


Neste caso gerada uma base de dados no formato MDB. Para utilizar este recurso, siga os seguintes procedimentos: Verifique se j existe um Banco de Dados no seu projeto; caso contrrio insira um novo Banco de Dados clicando com o boto direito sobre o cone do projeto, e selecionando a opo Inserir -> Banco de Dados. Configure a propriedade SourceType para a opo stAcess. No banco de dados ser configurado o caminho do arquivo a ser utilizado. No campo de caminho do arquivo MDB, no necessrio informar o caminho de um arquivo j existente, pois o prprio objeto de encarregar de criar o arquivo no local especificado neste campo caso o mesmo no exista. Para configurao do Banco de Dados ser apresentada a seguinte tela: Insira no campo Arquivo MDB o nome do arquivo desejado (existente ou no).

Nos campos de Usurio e Senha poder ser definido um usurio para se conectar a um banco de dados j existente que possua senha para conexo. Clique no boto "OK", para finalizar as configuraes.

1.58.2.Servidor de Dados Oracle


Com esta opo os dados podero ser armazenados num Banco de Dados Oracle. Para utilizar este recurso, siga os seguintes procedimentos:
210

Configure a propriedade SourceType para a opo stOracle.


MANUAL E3

ELIPSE E3

No banco de dados ser configurado o caminho do arquivo a ser utilizado. Nos campos Usurio e Senha poder ser definido para conectar a um banco de dados j existente, que possua senha para conexo. Clique no boto OK, para finalizar as configuraes. Para configurao do Banco de Dados ser apresentada a seguinte tela:

1.58.3.Servidor de Banco de Dados SQL Server


Com esta opo os dados podero ser armazenados num Banco de Dados Oracle. Para utilizar este recurso, siga os seguintes procedimentos: Configure a propriedade SourceType para a opo stSQLServer. No banco de dados ser configurado o caminho do arquivo a ser utilizado. Nos campos Usurio e Senha poder ser definido para conectar a um banco de dados j existente, que possua senha para conexo. Clique no boto OK, para finalizar as configuraes. Para configurao do Banco de Dados ser apresentada a seguinte tela:

Manual E3

211

1 2

Captulo

12. Objeto Alarme

O E3 Studio prev mtodos para realizar a especificao e gerenciamento de alarmes e eventos de variveis de um processo. Qualquer varivel ou propriedade pode ser verificada em relao ao acontecimento de condies especiais. De posse dessas informaes, pode-se exibir a informao para vrios "assinantes" das informaes, que podem ser objetos de visualizao em tela, impressoras, pagers, etc.... Para realizar o gerenciamento do alarme, existem mais dois mdulos que devem ser utilizados: o Servidor de alarmes, responsvel pelo gerenciamento e envio das ocorrncias para um Servidor de Banco de Dados, e a Fonte de alarmes, onde so especificadas cada uma das verificaes a serem monitoradas. O objeto Alarmes define o tipo de alarme que ser inserido no sistema. Atravs do Objeto Area, definido a monitorao do alarme dentro da rea no sistema e configurado suas propriedades, assim como o gerenciamento das informaes do servidor banco de dados. O E3 Server envia mensagens com a notificao de valores e dados recebidos do IOServer, criando um Fluxo de Mensagens. Os AlarmSources, presentes no Alarme, checam e geram as mensagens de alarmes, que so enviadas para um concentrador, chamado AlarmHub, que por sua vez pode realizar armazenamentos temporrios em memria ou disco, no caso da falta de comunicao com o Servidor de alarme. O Objeto Servidor de Alarmes centraliza os alarmes configurados no sistema e define o local onde sero gravados os contedos disponveis nos alarmes. Aps as definies referentes a alarme e suas configuraes, localizar o mesmo no projeto, j que quando inicializado um novo projeto, o alarme j um objeto padro do sistema e j vem inserido no aplicativo. Para utilizar os recursos do alarme, proceda assim: Caso queira inserir mais alarmes no sistema, utilize o cone . Escolha o alarme de acordo com o tipo de projeto que deseja monitorar, pois existem diversos tipos configurados no sistema.

Manual E3

212

ELIPSE E3

Para monitorar o alarme, necessrio disponibilizar uma rea, pela qual ser configurado as informaes refentes a monitoramento do mesmo.

1.59. Servidor de Alarmes (AlarmServer)


O Objeto Servidor de Alarmes centraliza os alarmes configurados no sistema e define o local onde sero gravados os contedos disponveis nos alarmes. O Servidor de Alarmes centraliza os alarmes configurados no sistema e define o local onde sero gravados os contedos disponveis nos alarmes. A propriedade DataSource definir o servidor Banco de Dados e, conforme as suas configuraes, a propriedade Logging setar ou retornar a gravao das informaes no banco de dados do servidor de alarmes.

Manual E3

213

ELIPSE E3

Aps definidas todas as configuraes, o sistema inicializar as inseres e gravaes das informaes na tabela dos alarmes, conforme as especificaes descritas no campo. Quando clicado no boto Gerar tabela, o sistema gera a tabela de dados dos alarmes, conforme as suas especificaes e informa se a tabela foi gerada com sucesso.

As propriedades deste objeto so as seguintes: Propriedades do Servidor de Alarmes


PROPRIEDADES DataSource Logging TimeUnits DESCRIO

Define o banco de dados e suas configuraes no servidor de alarmes. Define a gravao dos dados no servidor de alarmes. Define a variao de tempo em que os dados sero atualizados no sistema. Pode-se utilizar variaes em hora, dia ou ms

Pela janela de configurao do Servidor de Alarmes, podemos especificar qual o Servidor de Banco de Dados que ser utilizado para a gravao dos alarmes. O Servidor de Banco de Dados (DBServer) um mdulo do E3 que deve ser inserido em sua aplicao. Podemos tambm especificar a metodologia para a gravao dos dados em tabelas. gerada uma tabela principal e uma de backup, cada uma com uma quantidade X de dias, semanas ou meses. Ao ultrapassar a quantidade X de tempo, criada automaticamente uma nova tabela, sendo mantida no banco a tabela anterior. Essa operao se repete at que seja atingido o nmero N de tabelas; a partir da, uma nova tabela ocupar o espao da primeira, e assim por diante, mantendo sempre a ltima tabela no disco, de forma rotativa. Os campos gerados so os seguintes:

214

MANUAL E3

ELIPSE E3

As especificaes dos campos da tabela so as seguintes: Campos


CAMPOS Acked AckRequired Area ActorID ChangeMask ConditionName ConditionActive Cookie CurrentValue Enabled EventTime EventTimeUTC EventType Quality Message Severity Source SubConditionNam e DESCRIO

Atributo Booleano que indica o reconhecimento ou no do alarme. Indica se o alarme deve ser reconhecido pelo usurio. Indica a rea qual o Alarme pertence. Nome do usurio que reconheceu o Alarme, capturado diretamente do sistema operacional. Informa sobre a mudana em uma condio de alarme. Indica o nome da condio de Alarme: Level, ROC (Rate of Change), DeadBand, Digital, etc... Indica se a condio de Alarme est ativa. Identificador Interno de Ocorrncia (Localizador). Valor da varivel em Alarme. Alarme Ativo/Inativo. Horrio de Ocorrncia do Alarme. Horrio de Ocorrncia do Alarme em relao Greenwich (Universal Time Coordinate). Tipo de Gerenciamento de Alarme: Simple, TrackingEvent ou ConditionEvent. Qualidade do Valor. Texto da Mensagem. Grau de Severidade - Baixa, Mdia, Alta. Texto com o Link para a fonte de dados. SubCondio de Alarme: LO,LOLO, HI, HIHI,

Manual E3

215

ELIPSE E3

1.60. Objeto rea


O objeto rea define a monitorao do alarme dentro da rea no sistema. Atravs da propriedade Alarm, determinado se existe pelo menos um alarme ativo, e caso isto ocorra, a propriedade ActiveAlarms, verifica o nmero de alarmes ativos dentro da rea. A propriedade Verify habilita ou desabilita a verificao de todos os alarmes dentro da rea e, conforme a situao, a propriedade ActiveNACKAlarms indicar os que esto sem reconhecimento. Para utilizar este recurso, siga os seguintes procedimentos: Clique com o boto direito do mouse no objeto alarmes e selecione a opo .

inserir rea, ou clique no cone

Entre nas propriedades da rea, atravs do boto direito do mouse e acessando a opo Propriedades. Propriedades da rea
PROPRIEDADES ActiveAlarms ActiveNackAlarms Alarm AlarmVerify DESCRIO

Propriedade que indica quantos alarmes esto ativos dentro da rea; Indica quantos alarmes esto sem reconhecimento dentro da rea; Indica se h ou no alarmes ativos dentro da rea (propriedade booleana); Informa se os alarmes pertecentes rea devem ser monitorados ou no, mesmo que contenha alarmes em verificao;

216

MANUAL E3

ELIPSE E3

1.61. Alarmes (AlarmConfig)


O Objeto Alarme (AlarmConfig) utilizado para criar as definies de reas e alarmes a serem verificados. Podem existir vrios AlarmServers em sua aplicao ou Domnio, que enviam dados para um AlarmServer. Dentro de cada AlarmConfig podemos inserir uma ou mais reas de Alarmes, que correspondem uma representao fsica ou lgica do posicionamento dos alarmes num processo. Ao consultar os alarmes, podemos realizar filtros pelas reas, buscando os dados atravs do tipo de organizao desejada. Dentro das reas de Alarmes, podemos inserir os AlarmSources, que so os tens onde especificamos as variveis e os tipos de verificao a serem feitas, ou ainda outras reas. Aps as definies referentes a alarme e suas configuraes, localizar o mesmo no projeto, j que quando inicializado um novo projeto, o alarme j um objeto padro do sistema. Para utilizar os recursos do alarme, proceda assim: Caso queira inserir mais alarmes no sistema, utilize o cone . Escolha o alarme de acordo com o tipo de projeto que deseja monitorar, pois existem diversos tipos configurados no sistema.

Atravs dela, podemos controlar e monitorar o comportamento de seus tens: Propriedades do Alarme
DESCRIO ActiveAlarms ActiveNackAlar ms Alarm AlarmVerify DisabledAlarm s DESCRIO

Propriedade que indica quantos alarmes esto ativos dentro da rea; Indica quantos alarmes esto sem reconhecimento dentro da rea; Indica se h ou no alarmes ativos dentro da rea. Informa se os alarmes pertecentes rea devem ser monitorados . Indica quantos Alarmes dentro da rea esto desabilitados;

Manual E3

217

ELIPSE E3

1.62. Fontes de Alarmes


Para determinar o tipo ou tipos de verificao a ser realizada pela fonte de alarme, devemos clicar sobre o mesmo com o boto direito do mouse, escolhendo a opo "Novo Alarme", inserir uma rea e dentro desta rea, um ou mais tipos de verificao estaro disponveis, que so as seguintes: Analgico, Digital, Banda Morta e Taxa de Variao.

1.62.1.Tipos de Fontes de Dados


Para determinar o tipo ou tipos de verificao a ser realizada pelo AlarmSource, devemos clicar sobre o mesmo com o boto direito do mouse, escolhendo a opo "Novo Alarme" e depois um ou mais tipos de verificao disponveis, que so: Analgico, Digital, Taxa de Variao e Banda Morta. Todos os AlarmSources possuem as seguintes propriedades gerais: Texto da Mensagem: o texto associado quela condio de alarme, que aparecer no objeto de visualizao (E3Alarm), Banco de Dados, etc... Pode conter at 255 caracteres de texto, como exemplo para gravao em Bancos de Dados Access (MDB). Severidade: Indica a gravidade do alarme ocorrido, podendo ser Baixa, Mdia e Alta. A severidade utilizada para realizao de filtros e ordenao nas mensagens. Pede Ack: Indica que o Alarme deve ser reconhecido pelo operador para ser retirado da lista de alarmes no E3Alarm, ou ainda se reconhecido automaticamente quando a varivel deixa uma condio de alarme. Link de Ajuda: Voc pode indicar um URL (Universal Resource Locator) que pode indicar um documento qualquer, como uma pgina de internet, documento de texto, planilha, help, etc..., que pode ser requisitada pelo operador na ocorrncia de um alarme.

H vrios tipos de fontes de alarme que podem ser inseridas na rea do alarme. As opes disponveis so as seguintes:

Analgico Permite monitorar uma varivel analgica, pela especificao de at 4 nveis de alarme, que so o LOLO (Muito Baixo), LO (Baixo), HI (Alto) e HIHI (Muito Alto).
218 MANUAL E3

ELIPSE E3

Campos Habilitao do Alarme (LoLo,Lo,Hi,HiHi): Habilita a verificao do Alarme escolhido. Limite: Indica o nvel a partir do qual deva ser indicado o alarme, em unidades de engenharia da varivel monitorada (A utilizao de smbolo de casas decimais deve ser compatvel com a configurao do Windows). O funcionamento dos alarmes segue a definio mostrada na figura abaixo. Os crculos coloridos indicam a transio de estados de alarmes possveis. Link de ajuda: Habilita o link de ajuda para a fonte de alarme. Banda morta: Habilita a banda morta, que um recurso utilizado para evitar que uma varivel, ao manter uma pequena oscilao em torno de um limite de alarme, gere uma quantidade desnecessria de mensagens. Volta ao normal: Determina a mensagem de texto que ser mostrada ao usurio quando o alarme voltar ao estado normal.

Digital Permite monitorar uma varivel digital, pela especificao de alarme na borda de subida (em -1 ou TRUE) ou borda de descida (em 0 ou FALSE). Para editar esta condio, basta clicar sobre o AlarmSource com o boto direito e escolher a opo "Propriedades", que mostrar a janela abaixo:

Manual E3

219

ELIPSE E3

Campos Habilitao do Alarme (AD): Habilita a verificao do Alarme. Valor de Alarme: Indica o valor para verificao, que deve ser 0 ou 1. O valor inverso do escolhido ser interpretado como retorno condio normal.

Propriedades As propriedades desta opo so as seguintes: Propriedades do Alarme


DESCRIO TextDigitalReturnMessage Text BooleanDigital NumericDigitalLimit TextDigitalMessageText NumericDigitalSeverity BooleanDigitalAckRequired TextDigitalLink DESCRIO

Mensagem de retorno de alarme. Habilita\Desabilita a verificao de alarme Digital. Limite para o nvel de alarme Digital. Texto da mensagem de alarme Digital. Importncia do alarme Digital. Conjunto de valores: 0Alta, 1- Mdia, 2-Baixa Verifica se este nvel de alarme Digital necessita de reconhecimento. Link de ajuda para o nvel de alarme Digital.

1.62.2.Banda Morta
Indica uma histerese a ser aplicada a um nvel de alarme, para efetivar a entrada e sada da condio. Este um recurso utilizado para evitar que uma varivel, ao

220

MANUAL E3

ELIPSE E3

manter uma pequena oscilao em torno de um limite de alarme, gere uma quantidade desnecessria de mensagens. Assim, por exemplo, uma varivel para entrar em alarme alto (Hi) deve ser maior que o valor Nvel de Alarme Alto + Banda Morta, e para voltar a condio normal, deve ser menor que o valor Nvel de Alarme Alto - Banda Morta. O valor deve ser inserido nas mesmas unidades de engenharia da varivel. A banda morta usa o valor absoluto para configurar suas especificaes

Campos Habilitao do Alarme (BM): Habilita a verificao do Alarme. Valor: Indica a diferena entre a varivel monitorada e o Setpoint, a partir do qual deve ser indicado o alarme. Deve ser informado em unidades de engenharia da varivel monitorada (A utilizao de smbolo de casas decimais deve ser compatvel com a configurao do Windows). Setpoint: Link para a varivel de referncia, para que seja monitorada uma diferena em relao varivel de monitorao. Um exemplo pode ser visto na figura abaixo, na comparao de um setpoint com uma varivel de processo.

As propriedades desta opo so as seguintes:

Manual E3

221

ELIPSE E3

Propriedades da Banda Morta


DESCRIO NumericLevelBand TextLevelReturnMessageT ext BooleanLoLo NumericLoLoLimit TextLoLoMessageText NumericLoLoSeverity BooleanLoLoAckRequired TextLoLoLink BooleanLo NumericLoLimit TextLoMessageText NumericLoSeverity BooleanLoAckRequired TextLoLink BooleanHi NumericHiLimit TextHiMessageText NumericHiSeverity BooleanHiAckRequired TextHiLink BooleanHi NumericHiLimit TextHiMessageText BooleanHiAckRequired DESCRIO

Especifica a banda morta para o alarme de nveis. Mensagem de retorno de alarme. Habilita\Desabilita a verificao de alarme BaixoBaixo. Prioridade Muito Baixa Limite para o nvel de alarme BaixoBaixo. Texto da mensagem de alarme BaixoBaixo. Importncia do nvel de alarme BaixoBaixo. Conjunto de valores: 0- Alta, 1- Mdia, 2-Baixa. Verifica se este nvel de alarme BaixoBaixo necessita de reconhecimento. Link de ajuda para o nvel de alarme BaixoBaixo. Habilita /Desabilita a verificao de alarme baixo. Prioridade Baixa Limite para o nvel de alarme Baixo. Texto da mensagem de alarme Baixo. Importncia do nvel de alarme Baixo. Conjunto de valores: 0- Alta, 1- Mdia, 2-Baixa Verifica se este nvel de alarme Baixo necessita de reconhecimento. Link de ajuda para o nvel de alarme Baixo. Prioridade Alta Habilita/Desabilita a verificao de alarme Alto. Limite para o nvel de alarme Alto. Texto da mensagem de alarme Alto. Importncia do nvel de alarmeAlto: Conjunto de valores: 0- Alta, 1- Mdia, 2- Baixa Verifica se este nvel de alarme Alto necessita de reconhecimento. Link de ajuda para o nvel de alarme Alto. Prioridade Muito Alta Habilita/Desabilita a verificao de alarme AltoAlto. Limite para o nvel de alarme AltoAlto. Texto da mensagem de alarme AltoAlto. Importncia do nvel de alarme AltoAlto.

222

MANUAL E3

ELIPSE E3

1.62.3.Taxa de Variao
O Alarme de Taxa de Variao ou ROC (Rate Of Change) usado para monitorar variaes muito rpidas em uma varivel do processo. A taxa de variao usa seus valores em porcentagem (%).

Os campos disponveis so: Habilitao do Alarme (TDV): Habilita a verificao do Alarme. Variao por Segundo: Indica a porcentagem da varivel monitorada que pode variar por segundo.

Este valor calculado tomando como base cada intervalo de leitura da varivel, pela frmula: ROC ou TDV = (ValorAtual - ValorAnterior) / (InstanteAtual InstanteAnterior). Se o ROC for maior que a taxa especificada, ser considerado estado de alarme.As propriedades da Taxa de variao so as seguintes: Propriedades da Taxa de variao
PROPRIEDADES TextRocReturnMessageT ext BooleanDigital NumericRocLimit DESCRIO

Mensagem de retorno de alarme. Habilita\Desabilita a verificao de alarme Taxa de variao. Limite para o nvel de alarme Taxa de variao.Para que o alarme ocorra, basta que o valor do tag associado ultrapasse esse valor em um segundo. Texto da mensagem de alarme Taxa de variao. Importncia do alarme Taxa de variao. Conjunto de valores: 0- Alta, 1- Mdia, 2-Baixa Verifica se este nvel de alarme Taxa de variao necessita de reconhecimento. Link de ajuda para o nvel de alarme Taxa de variao.

TextRocMessageText NumericRocSeverity BooleanRocAckRequired TextRocLink

Manual E3

223

1 3

Captulo

13. E3Alarm

O E3Alarm (ou Sumrio de alarmes) serve para visualizao da monitorao dos alarmes ativos no sistema. Atravs deste objeto, possvel verificar os status dos alarmes no sistema, verificando condio, prioridade, etc. utilizado para realizar a especificao e gerenciamento de alarmes e eventos de variveis de um processo. Qualquer varivel ou propriedade pode ser especificada, em relao ao acontecimento de condies especiais. De posse dessas informaes, pode-se exibir a informao para vrios "assinantes" das informaes, atravs da visualizao em tela. Para que o E3Alarm seja utilizado, necessrio que o objeto esteja registrado no sistema. Isto pode ser visto, clicando com o boto direito do mouse e verificando se o objeto mencionado. caso isto no ocorra, necessrio registr-lo no sistema. Para utilizar este recurso, siga os seguintes procedimentos: Insira no projeto o E3 Alarm, atravs do clique com o boto direito do mouse na rea de trabalho, e selecionando a opo E3 Alarm.

Este objeto tambm pode ser inserido atravs da Barra de Ferramentas Objeto, selecionando a opo Sumrio de Alarmes;

Descreva as especificaes atravs das propriedades do objeto, dando um duplo clique no objeto ou clicando com o boto direito do mouse no objeto e selecionando a opo Propriedades.

Manual E3

224

ELIPSE E3

Configure as propriedades do objeto atravs da caixa de dilogo ou atravs da caixa de propriedades Na aba Geral, esto as informaes referentes a Ordenao e Filtros. Nas opes, pode-se especificar o modo como deseja filtrar os campos, e determinar que tipo de prioridade de alarme ser listada.

Caso necessite configurar outras especificaes, clique no boto Avanado, e configure as opes desejadas. Nesta propriedade, ser especificado o domnio, que identifica uma aplicao local ou remota. O objeto ir conetar de acordo com as informaes selecionadas. Optando pela opo No mesmo domnio da tela, o sistema buscar as informaes de domnio local, e caso opte pela opo Em um domnio diferente da tela, o sistema permitir que seja especificado o caminho deste domnio na rede.

Manual E3

225

Na aba Colunas, selecione os campos que voc deseja que sejam mostrados no objeto, selecionando-o na lista e adicionando-o no campo selecionados. Caso deseje remover algum tem, selecione-o e clique em Remover, que o tem desaparecer do campo. Pode-se tambm ordenar os campos atravs dos botes Sobe e Desce.

226

MANUAL

E3

ELIPSE E3

Na aba Cores, so definidas as cores de reconhecimento dos alarmes no objeto. Em cada tem, h especificaes a respeito da situao do alarme. Modifique a cor do texto, quando o alarme estiver na situao especificada.

Pode-se tambm, especificar que cor deseja que o alarme apresenta, quando estiver em prioridade baixa, mdia ou alta. A cor especificada ser inserida no texto do alarme por prioridade. Caso necessite, configure o E3 Alarms atravs das propriedades do objeto: Propriedades do E3Alarm
PROPRIEDADES AlarmServer Domain Fields Filter ShowHighPriority ShowLowPriority ShowMediumPriority DESCRIO

Determina o servidor de alarmes que ir guardar os dados do objeto. Domnio local ou na rede, pela qual o objeto ir se comunicar. Campos de dados do alarme. Campos de filtro por rea de alarme. Especifica prioridade alta do alarme. Especifica prioridade baixa no alarme. Especifica prioridade mdia no alarme.

Manual E3

227

Para visualizar o E3 Alarm, verifique se todas as configuraes foram especificadas, e execute o E3 Viewer. Durante a operao, os Alarmes do sistema iro aparecer no objeto E3Alarm. Ao clicar com o boto direito do mouse, permitido o reconhecimento dos alarmes, onde aparecer a janela abaixo:

Campos

Reconhece apenas os alarmes selecionados: Somente os alarmes selecionados com o mouse o teclado sero reconhecidos. Reconhece todos os alarmes do filtro corrente: Todos os alarmes que esto sendo visualizados pelo E3Alarm no Viewer corrente sero reconhecidos, respeitando qualquer filtro que esteja aplicado. Reconhece Globalmente todos os alarmes: Todos os alarmes do domnio sero reconhecidos.

228

MANUAL

E3

ELIPSE E3

Poltica de Exibio e Reconhecimento


Conforme os alarmes vo sendo verificados, a seguinte operao realizada pelo sistema: Ao ser verificada uma condio de alarme, este logado no Servidor de alarme e no Banco de Dados como um alarme no reconhecido, e mostrado no E3Alarm; O usurio poder reconhecer o Alarme; nesse caso ser inserida um novo registro no Banco de Dados indicando o reconhecimento, e no E3Alarm a linha correspondente indicar que o mesmo foi reconhecido. O usurio poder no reconhecer o Alarme; nesse caso ele ficar mostrado no E3Alarm sem modificaes at que a varivel saia de condio de alarme. Nesse caso, um novo registro ser adicionado no Banco de Dados e no E3Alarm a linha correspondente ir relatar que o alarme saiu de condio de alarme. O Alarme s sair da lista do E3Alarm quando as duas condies forem satisfeitas, ou seja, a condio de alarme no mais existir e o usurio tiver reconhecido o alarme. Isto so no ser verdadeiro se a propriedade PedeAck do AlarmSource estiver em falso, o que far com que o Alarme seja logado diretamente no disco sem a necessidade de reconhecimento.

Manual E3

229

1 4

Captulo

14. Histricos

Os Histricos so mdulos responsveis pelo armazenamento de variveis no Banco de Dados, exceto as variveis de alarmes/eventos, que so armazenados pelo AlarmServer (Servidor de alarmes). Permitem armazenar dados de processos para anlises futuras. Voc pode criar tantos arquivos de Histricos quanto desejar, cada um contendo diversos Tags. Cada arquivo de histrico possui uma taxa de amostragem que determina com que frequncia os dados sero escritos no arquivo. Cada histrico pode criar ou utilizar uma tabela independente dentro do Banco de dados, cujo armazenamento pode ser definido po Tempo ou Evento. Atravs da propriedade CacheSize, definido o nmero de elementos no histrico. A propriedade ScanTime definir a variao de intervalo do tempo, em milisegundos, para gravao de novos registros no histrico e a propriedade RecordingType definir as configuraes para a gravao de elementos dentro do histrico. Conforme as definies especificadas na propriedade DBServer, que define o Servidor do Banco de Dados que est sendo utilizado no sistema. Para utilizar este recurso, siga os seguintes procedimentos: Clique com o boto direito do mouse, no nome do projeto. A opo abrir a caixa de dilogo, pela qual deve-se clicar em inserir/ histrico. Aps, deve-se entrar em suas configuraes clicando com o boto direito no histrico e escolhendo a opo Propriedades. Aps ser configurada as opes do histrio, necessrio inserir os campos da(s) tabela(s). Atravs da janela de opes do histrico, inserido os campos e definido suas configuraes.

230

MANUAL

E3

ELIPSE E3

As opes disponveis do histrico so: Adicionar campos: Adiciona campos na tabela do histrico. Remover campos: Remove o campo selecionado na tabela do histrico. Propriedades do Histrico: Atravs desta opo, possvel especificar o servidor de banco de dados, e a sua tabela. Assim, pode-se configurar as informaes referentes a tabela pela qual o sistema guardar as informaes do histrico.

Gerar estrutura no BD: Atravs desta opo, possvel gerar uma estrutura no banco de dados. Para tanto, as informaes referentes ao banco de dados e tabela
Manual E3 231

devem estar configuradas. Caso deseje configurar estas informaes, basta clicar com o boto direito do mouse sobre o histrico e clicar em Propriedades. Na tela Histrico, h as informaes referentes ao objeto.

A opo de gerao de tabela tambm pode ser feita atravs do boto Gerar Tabela. Para especificar informaes mais detalhadas, acesse as propriedades do objeto atravs do clique com o boto direito do mouse, que abrir a tela para configurao. Aps a configurao das informaes, clique no boto Gerar tabela, que ser gerada a tabela especificada.

232

MANUAL

E3

ELIPSE E3

Aps definidas todas as configuraes, o sistema inicializar as inseres e gravaes das informaes na tabela do histrico, conforme as especificaes descritas no campo. Quando clicado no boto Gerar tabela, o sistema gera a tabela de dados dos alarmes, conforme as suas especificaes e informa se a tabela foi gerada com sucesso.

O sistema mostrar uma tela de mensagens indicando a procedncia da gerao de tabela no histrico, conforme tela acima. No Histrico tambm possvel determinar a Chave Primria e o ndice na tabela de dados.
Manual E3 233

Chave Primria: A Chave Primria um identificador nico de um dado na tabela. O poder de um sistema de banco de dados relacional vem da sua habilidade de encontrar e trazer rapidamente a informao armazenada em tabelas separadas, usando consultas (consulta sobre os dados armazenados nas tabelas mltiplas, para servir enquanto a fonte de dados das tabelas). A fim de utilizar este recurso, em cada tabela, deve-se incluir um campo ou um conjunto de campos que identifiquem excepcionalmente cada registro primrio na tabela. Uma vez designada a chave primria na tabela, o acesso impedir que todos os valores duplicados ou nulos estejam incorporados aos campos das chaves primrias. A chave primria pode ser configurada de duas formas: verificando na tela do histrico, o campo da tabela que deseja tornar Chave Primria e habilitando-a atravs do boto cone , ou clicando no

, pela qual abrir a tela de configurao, conforme abaixo:

234

MANUAL

E3

ELIPSE E3

Campos Nome do ndice: Determina o nome do ndice. Garantir que os valores deste ndice sero nicos: Habilitando esta opo, faz com que os valores especificados para o ndice Chave Primria sejam nicos. Marque os campos que devero pertencer a este ndice: Determina os campos que iro pertencer ao ndice Chave Primria setado. Mude a ordem dos campos: Modifica a ordem, subindo ou descendo os campos.

ndices: Um ndice um campos ou registro em uma base de dados de acesso a tabela. Este acesso utilizado como ndices em uma tabela, mostrando dados, podendo acess-los, moviment-los, etc. Voc pode criar os ndices baseados em um nico campo ou em campos mltiplos. Os ndices de campo-mltiplo permitem distinguir entre os registros em que o primeiro campo pode ter o mesmo valor. Decidindo-se que campos posicionar, poder posicionar os campos que voc deseja procurar freqentemente. Entretanto, os ndices podem retardar abaixo algumas consultas, tais como adicionar consultas, quando os ndices para muitos campos necessitam ser atualizados ao executar estas operaes. A chave primria de uma tabela posicionada automaticamente, e voc no pode posicionar um campo cujo o tipo de dados seja um objeto. Os ndices pode ser configurada atravs do cone pela qual abrir a tela de configurao, conforme abaixo: ,

Manual E3

235

Campos Nome do ndice: Determina o nome do ndice. Garantir que os valores deste ndice sero nicos: Habilitando esta opo, faz com que os valores especificados para o ndice da Chave Primria sejam nicos. Marque os campos que devero pertencer a este ndice: Determina os campos que iro pertencer ao ndice da Chave Primria setado. Mude a ordem dos campos: Modifica a ordem, subindo ou descendo os campos.

Aps ser editado o ndice, o mesmo aparece na tela Editor de ndices.

236

MANUAL

E3

ELIPSE E3

Campos Nome: Determina o nome do ndice. Campos: Determina o campo pela qual o ndice est vinculado. Adicionar: Adiciona um novo ndice. Editar: Edita o ndice selecionado. Remover: Remove o ndice selecionado.

As propriedades e mtodos que definem a gravao dos dados so: Propriedades do Histrico
PROPRIEDADES CacheSize DBServer SubType ScanTime RecordingType TableName TimeUnit DESCRIO

Determina o nmero de elementos no histrico. Determina o servidor Banco de Dados do histrico. Define as condies da varivel do histrico. Define a variao de intervalo do tempo para gravao de registros no histrico. Configura a gravao do histrico. Especifica o nome da tabela utilizada no histrico. Define a unidade de tempo que ser utilizada no histrico.

Mtodos do Histrico
MTODOS StartAcquisition StopAcquisition WriteRecord DESCRIO

Esta funo habilita o objeto Histrico a gravar os dados na taxa especificada na propriedade ScanTime. Esta funo desabilita o objeto Histrico a gravar os dados por tempo (ciclicamente). Esta funo insere uma nova linha de informao no Banco de Dados do Histrico.

Manual E3

237

1 5

Captulo

15. E3Browser

O E3Browser (ou Tabela de Dados) um controle ActiveX utilizado para visualizar dados armazenados em Banco de Dados pelo DBServer. Voc pode realizar filtros de vrios tipos nos dados, atribuir cores para cada coluna, entre outras configuraes. Este objeto utilizado para visualizar os histricos e alarmes guardados no banco de dados do sistema. Atravs deste objeto, possvel monitorar os histricos guardados no banco de dados configurado no projeto, e visualiz-lo.

Figura1: E3Browser

Para que o E3Browser seja utilizado, necessrio que o objeto esteja registrado no sistema. Isto pode ser visto, clicando com o boto direito do mouse e verificando se o objeto mencionado. Para utilizar os recursos do E3 Browser, siga os seguintes procedimentos: Insira o E3 Browser no projeto atravs do clique com o boto direito do mouse na rea de trabalho, e selecionando o objeto E3 Browser.

Este objeto tambm pode ser inserido atravs da Barra de Ferramentas Objeto, selecionando a opo Tabela de Dados;

238

MANUAL

E3

ELIPSE E3

1.63. Fonte de Dados


Aqui voc deve escolher qual o Servidor de Banco de Dados ao qual o E3Browser estar ligado, e a tabela de origem dos dados. No caso de desejar visualizar os alarmes/eventos armazenados, voc deve informar a tabela Alarms. No caso de outros dados histricos, informe o nome da tabela declarada no objeto Hist. O campo "Avanado" permite informar qual o Domnio que o E3Browser estar ligado, podendo ser o Domnio da tela onde ele est inserido (em branco) ou outro Domnio qualquer. O boto "Buscar Campos" faz com que a configurao da tabela seja buscada do Banco, sendo exibidos todos os campos para escolha de propriedades; porm, para esta operao poder ser concluda a aplicao deve estar sendo executada, de forma ao E3Server poder acessar o Banco de Dados.
Especificao do caminho do domnio

Figura1: Especificao do caminho do domnio

Clicando no boto Avanado, o sistema abre a janela de configuraes avanadas , pela qual possvel configurar o cursor do provedor OLEDB. Neste tem, escolha a localizao que deseja utilizar e que fica mais acessvel a sua aplicao (Servidor ou Cliente). Logo abaixo, solicitada as especificaes referentes busca dos dados no sistema.Entre as opes listadas esto: 0- Semi- esttico, 1- Esttico e 2Dinmico. A figura abaixo mostra um exemplo para a exibio de uma tabela de Alarmes, onde so mostrados os campos presentes na tabela. Podem ser alteradas as seguintes caractersticas:

Manual E3

239

Campos Ordem das Colunas: Voce deve clicar e arrastar os bullets azuis ao lado de cada campo para a ordem desejada; Exibio: Pela Check Box ao lado do nome do campo; Ordenao: Ordenao pr-definida de cada campo, com as opes "No Sort", "Ascendente" e "Descendente". Filtro: Podem ser inseridas instrues para o filtro de dados diretamente em cada coluna. Os filtros inseridos sero fixos, sendo que tambm possvel via Scripts realizar consultas SQL diretamente. Formato: Especifica a formatao de cada campo, de acordo com as instrues mostradas no captulo "Formatao de Valores". Largura: Indica a largura em pixels do campo. Cor de Frente e Fundo: Voc pode escolher cores de frente e fundo para cada coluna do E3Browser.

240

MANUAL

E3

ELIPSE E3

Figura 1- Dados do E3Browser

Outras Opes Pelo Tab "Estilo" voc pode definir a aparncia das divises (grade) das clulas e dimenses das linhas e colunas. Pelo Tab "Opes" voc pode definir o regime de atualizao dos dados e tipo de seleo das clulas.

Na aba Opes, informe o intervalo de tempo em que os dados sero gravados e atualizados no E3 Browser. A atualizao ocorrer em milisegundos(ms). Pode-se escolher a opo de no atualizar os dados, fazendo com que as gravaes permaneam as mesmas. Na opo Tipo de seleo, ser informado qual o tipo de seleo ser feita na tabela.
Manual E3 241

Na aba Color, determine as cores do E3 Browser, referentes a colunas e clulas. Se a cor desejada no estiver na paleta, pode-se custoniz-la atravs do boto Edit Custom Color, pela qual ser aberta a caixa para edio da cor

Na aba Font, defina as especificaes de fontes no E3 Browser.

242

MANUAL

E3

ELIPSE E3

Na tab Associaes e na tab Scripts, pode-se fazer associaes ou criar scripts para o E3Browser.

Pode-se tambm, configurar as informaes do E3 Browser atravs de suas propriedades e mtodos, especificando os dados do objeto: Mtodos do E3Browser
MTODOS ClearFields RetrieveFields Requery DESCRIO

Limpa o contedo das colunas e linhas do E3Browser. O E3Browser retorna os campos do banco de dados utilizando a tabela atual. O E3Browser atualizar a consulta usando o campo atual e retornando os dados da tabela.

Manual E3

243

Propriedades do E3Browser
PROPRIEDADES AppName ColummWidth FixedBkColor CursorLocation DESCRIO

CursorType

FixedColumnWidth FixedRowFont FixedRowHeight GridBkColor GridFont GridLineColor GridLinesType

RefreshTime RowHeight SelectRow TextBkColor TextColor TitleTipBkColor TitleTipBkTextColor ToolbarBkColor ToolbarFont ToolberForeColor

Nome do computador em que o domnio est rodando, em rede local ou remota. Largura em pixes das colunas do E3Browser. Cor de fundo das colunas fixas do E3Browser. Determina a localizao da instncia da tabela no E3Browser. clServer- A instncia da tabela encontra-se no servidor. clClient - A instncia da tabela encontra-se no cliente. Determina como as tabelas do E3Browser sero criadas: ctKeySet - A tabela ser criada com as configuraes padro do E3Browser. ctStatic - A tabela ser criada estaticamente no E3Browser. ctDinamic - A tabela ser criada dinamicamente no E3Browser. Largura em pixeis das colunas fixas do E3Browser. Fonte das linhas fixas do E3Browser. Altura das linhas fixas do E3Browser. Cor de fundo da rea mvel do E3Browser. Fonte utilizada nos textos do E3Browser. Cor das linhas do E3Browser. Estilo de linhas: GLNone - Sem linhas separadoras GLHorz - Somente as linhas horizontais GLVert - Somente as linhas verticais. GLBoth - Linhas verticais e horizontais. Tempo de atualizao dos dados do E3Browser em relao ao histrico relacionado. Altura das linhas no E3Browser. Determina se possvel ou no selecionar as linhas do E3Browser. Cor de fundo da clula no E3Browser. Cor do texto. Cor dos titletips (textos que aparecem sobre a clula, quando o texto de dentro da clula no aparece totalmente). Cor de fundo dos titletips. Cor do Toolbar. Fonte utilizada nos textos da barra de funes (toolbar). Cor utilizadas pelos textos da barra de funes (toolbar).

Verifique se todas as especificaes esto determinadas. Para visualizar o E3 Browser, execute o Viewer.
244 E3

MANUAL

ELIPSE E3

1.64. Exemplos de Scripts


Seja realizar a exibio de um E3Browser com dados de Alarmes com filtro por rea. O nome da rea ser repassado para a tela onde est o Browser. Neste caso, foi feito um script com o evento "OnPreShow" da Tela.
Sub TelaEventos_OnPreShow(vArg) set obj = Item("E3BrowserX1") set fields = obj.Fields set field = fields.Item("Area") field.Criteria = "Area Like '" & vArg & "%'" End Sub

No exemplo acima, a varivel obj foi criada e apontada para o E3BrowserX1 (esse o nome do objeto na tela). Depois, a varivel fields foi apontada para a propriedade Fields de obj, e aps field foi apontado para o campo "Area" do Browser. Depois a propriedade "Criteria" desse campo foi alterada para que sejam mostrados somente os campos que possuam o nome da Area (presente na varivel vArg, que foi passado ao chamar a tela) em qualquer parte do nome da sua rea, atravs do uso de uma sintaxe SQL com a instruo Like. Para saber mais sobre os comandos SQL, consulte o captulo "Sintaxe SQL". Seja outro exemplo de mostrar no mesmo E3Browser somente os dados dos ltimos 7 dias.
Sub TelaEventos_OnPreShow(vArg) set obj = Item("E3BrowserX1") set fields = obj.Fields set field = fields.Item("E3TimeStamp") Time = FormatDateTime((Now-7),3) field.Criteria = "E3TimeStamp >#"&Time&"#" End Sub

Neste exemplo a varivel Time foi criada com a hora Local menos 7, j que a funo Now retorna o nmero de dias desde 1899. Logo depois, setado o criterio do campo E3TimeStamp para qualquer data que seja maior que hoje menos 7 dias, ou seja, os ltimos 7 dias. Deve-se lembrar tambm, de acordo com o captulo "Formatao de Valores", que as datas neste caso devem sempre ser expressadas entre cancelas "#".

Manual E3

245

1.65. Objetos do E3Browser


O Objeto E3Browser possui alguns objetos internos que fazem parte da configurao do objeto: Objeto Campos e Objeto Coleo de campos.

1.65.1.Objeto Campos
O objeto Campos utilizado para configurar os campos da tabela, de forma que possa ser navegado entre eles e modificar a consulta de cada um. Atravs desta opo, possvel configurar quais os campos que sero mostrados e criar um filtro nos campos.

As propriedades deste objeto so as seguintes: Propriedades dos Campos


PROPRIEDADES BkColor Color Criteria Format Name Sort Visible Width DESCRIO

Determina a cor de fundo do texto da tabela no E3Browser. Determina a cor do campo da tabela. Seta ou retorna a propriedade que muda a consulta atual na tabela. Determina o formato do valor no campo da tabela. Determina o nome do campo na tabela. Determina a ordenao dos campos na tabela. Determina a visibilidade dos campos na tabela. Determina a ltura dos campos na tabela do E3Browser.

246

MANUAL

E3

ELIPSE E3

1.65.2.Objeto Coleo de Campos


O objeto Coleo de campos retorna um objeto coleo que contm uma lista com todos os campos da tabela, de forma que possa ser navegado entre os campos e modificar a consulta de cada um. Atravs desta opo, possvel configurar quais os campos que sero mostrados e criar um filtro nos campos.

As propriedades e mtodo deste objeto so as seguintes: Propriedades da Coleo de Campos


PROPRIEDADES Count Item DESCRIO

Seta ou retorna a quantidade de campos da tabela. Retorna um objeto filho deste objeto conforme o nome especificado.

Mtodos da Coleo de Campos


MTODOS Add Remove DESCRIO

Adiciona um campo na tabela do E3Browser. Remove um campo na tabela do E3Browser.

Manual E3

247

1 6

Captulo

16. E3Chart

O objeto E3Chart (ou Grfico) um componente responsvel pela visualizao em forma grfica, de dados em tempo real e dados histricos. Atravs de suas propriedades, so inseridas penas, dentre as quais suas configuraes sero demostradas no grfico do E3Chart. Para que este recurso seja utilizado, o objeto deve ser registrado no Studio (ActiveX E3Chart.ocx). O grfico pode conter vrios registros (linhas , pontos ...), que so chamados de penas. Cada pena associada a tags ou a Consultas. Voc pode definir que cada pena esteja associada a uma varivel de tempo real ou ento a um campo no Banco de Dados; nesse caso devem ser especificadas Consultas do E3Chart. Atravs da propriedade DataSourceType, possvel determinar o tipo de consulta (histrica ou tempo real). O objeto Pena representa o registro grfico no E3Chart. Atravs deste objeto, podese determinar o tipo de pena (histrica ou tempo real), assim como criar uma coleo de penas. possvel configurar o estilo e aparncia de uma pena e determinar a sua origem de dados.

Para que o E3Chart seja utilizado, necessrio que o objeto esteja registrado no sistema. Isto pode ser visto, clicando com o boto direito do mouse e verificando se o objeto mencionado. Para utilizar os recursos do E3Chart, siga os seguintes procedimentos: Insira o E3Chart na tela, clicando como o boto direito do mouse e escolher a opo E3Chart;
248
MANUAL

E3

ELIPSE E3

Este objeto tambm pode ser inserido atravs da Barra de Ferramentas Objeto, selecionando a opo Tabela de Dados;

Depois de inser-lo na tela, verifique o seu domnio. O Domnio indica a origem dos dados em tempo real do E3Chart. Se os dados requeridos para o E3Server sejam de outro computador que esteja rodando em rede, necessrio especificar no campo Domain, o local onde os dados sero buscados. Ex: //Usuario. Quando os dados requeridos estiverem no servidor local (na mesmo computador), a propriedade Domain pode ficar em branco.

Em seguida, entre nas propriedades do objeto atravs do duplo click com o boto esquerdo do mouse, ou clicando com o boto direito e acessando a opo Propriedades. As propriedades deste objeto so as seguintes:

Manual E3

249

Propriedades do E3Chart

250

MANUAL

E3

ELIPSE E3 PROPRIEDADES ChartType Domain GridBackground GridBkColor HorGrid DESCRIO

HorGridColor HorMinorTicks HorScaleBegin HorScaleEnd HorScaleFormat HorTicksUnit IsotropicScale ChartPens Queries RefreshTime ScaleFont ShowBackground GridBackground ShowLeftScale ShowTopScale TimeSpan VerGrid

VerGridColor VerMinorTicks

Seta ou retorna o estilo do grfico do E3Chart. Seta ou retorna o domnio da aplicao do E3Chart. Seta ou retorna a cor de fundo do grfico do E3Chart. Seta ou retorna a cor do grid horizontal do E3Chart. Seta ou retorna o estilo da linha do grid horizontal do objeto E3Chart. As opes disponveis nesta propriedade so as seguintes: 0- Solid: Aplica uma linha slida no grid horizontal do E3Chart; 1- Dash: Aplica uma linha linha tracejada no grid horizontal do E3Chart; 2- Dot: Aplica uma linha pontilhada no grid horizontal do E3Chart; 3- Dashdot: Aplica uma linha trao e ponto no grid horizontal do E3Chart;4- Dashdotdot: Aplica uma linha trao ponto ponto no grid horizontal do E3Chart;5-Invisible: Aplica uma linha invisvel no grid horizontal do E3Chart. Seta ou retorna a cor do grid horizontal do objeto E3Chart. Seta ou retorna o nmero de marcas pequenas entre as marcas principais do E3Chart. Determina o valor na esquerda da escala horizontal do E3Chart. Seta ou retorna o valor da base da escala horizontal do E3Chart. Seta a formatao do texto da escala horizontal do E3Chart. Seta ou retorna o intervalo entre as marcas principais. Seta ou retorna a escala isomtrica do E3Chart. Retorna o objeto PenCollection do Grfico. Retorna o objeto QueryCollection do E3Chart. Seta ou retorna o tempo de atualizao do E3Chart. Determina a fonte que ser utilizada no objeto E3Chart. Determina a exibio do fundo do grfico no objeto E3Chart. Seta ou retorna a cor de fundo do grfico do E3Chart. Determina a exibio da escala na esquerda do objeto E3Chart. Determina a exibio da escala no topo do objeto E3Chart. Determina a exibio do intervalo de grfico com escala rolante. Seta ou retorna o estilo da linha vertical do grid do objeto E3Chart. As opes disponveis desta propriedade so as seguintes:Solid: Aplica uma linha slida no grid vertical do E3Chart;Dash: Aplica uma linha linha tracejada no grid vertical do E3Chart;Dot: Aplica uma linha pontilhada no grid vertical do E3Chart;Dashdot: Aplica uma linha trao e ponto no grid vertical do E3Chart;Dashdotdot: Aplica uma linha trao ponto ponto no grid vertical do E3Chart;Invisible: Aplica uma linha invisvel no grid vertical do E3Chart. Seta ou retorna a cor da linha vertical do grid no objeto E3Chart. Seta ou retorna o nmero de marcas pequenas entre as marcas principais do E3Chart.
251

Manual E3

VerScaleBegin VerScaleEnd VerScaleFormat

Seta ou retorna o valor no topo da escala vertical do objeto E3Chart. Determina o valor na base da escala vertical do objeto E3Chart. Determina a formatao do texto da escala vertical do E3Chart. As opes disponveis para esta propriedade so as seguintes: Geral Nmero Este formato no tem formatao especfica, automtico. Apresenta nmeros com parte inteira e fracionria. Permite especificar a quantidade de casas decimais aps a vrgula, caso queira utilizar um nmero real. Pode-se usar separador de 1000 ou nmeros negativos. Apresenta valores numricos como datas e horas (quando vlidos). Use o formato de hora para apresentar apenas a parte de hora Apresenta valores numricos como horas e datas (quando vlidos). Use o formato de data para apresentar apenas a parte da data. Multiplica o nmero por 100 e adiciona o smbolo de percentual. Apresenta o nmero em notao de mantissa e expoente. Ideal para nmeros de magnitude bem variada. Permite configurar o nmero de casas decimais. Permite formatar nmeros inteiros em bases no decimais (hexadecimal, octal e binria. Permite a edio direta do cdigo de formatao desejado.

Data

Hora

Porcentagem Cientfico

Especial Outros
VerTicksUnit

Seta ou retorna o intervalo entre as marcas verticais principais do E3Chart.

1.66. Tipos de escala e Cor


Existem vrios tipos de escalas e configuraes de cor para o objeto e seus componentes. Abaixo sero especificadas cada uma das opes:
252
MANUAL

E3

ELIPSE E3

Para cada tipo de escala que voc escolher vai aparecer um tela diferente.Os tipos de escalas e configuraes disponveis so as seguintes:

1.66.1.Usar escala de Dados no eixo Horizontal e Vertical


Esta uma escala para exibir dados numricos no eixo horizontal e vertical. Mostra um intervalo de tempo definido por uma data inicial e final.

Usar a escala de tempo atualizado conforme especificao. padro do E3, mostrar os ltimos 60 segundos, mas possvel especificar outro valor no campo. Aps configurar o tempo, necessrio especificar se os dados sero mostrados na Base ou no Topo da escala.

Manual E3

253

Para maiores informaes, clique no boto Propriedades e especifique as informaes desejadas. Atravs desta opo, possvel visualizar uma escala numrica nos dois eixos.

A escala vertical so definidas as dimenses da escala, referentes ao valor do topo e base. Pode-se especificar como a escala ser mostrada (optando por esquerda ou direita na tela). Para maiores configuraes, clique no boto Propriedades.

254

MANUAL

E3

ELIPSE E3

1.66.2.Escala de Tempo Fixa


Este tipo de escala muito utilizada para a demostrao de dados histricos.

Na grade horizontal necessrio especificar a data inicial e a data final que deseja-se visualizar os dados da escala.

Manual E3

255

Aps esta configurao, especifique se deseja visualizar os dados na base ou no topo da escala. Para maiores informaes, clique no boto propriedades.

256

MANUAL

E3

ELIPSE E3

Na grade horizontal especificado as dimenses da escala, determinando o valor na base e no topo. Aps, necessrio determinar como os dados sero mostrados, indicando se na base ou no topo da escala. Para maiores informaes, clique no boto Propriedades.

Opo habilitada: Usar uma escala de tempo fixa

Figura: Opes habilitadas atravs do clique com o boto direito sobre o objeto

Manual E3

257

1.66.3.Escala Mvel de tempo


Atravs desta opo possvel configurar o E3Chart a utilizar uma escala mvel de tempo, pela qual os dados sero atualizados conforme valor especificado no campo.

Na Grade Horizontal, so definidas as informaes marcadores e estilo da grade.

referentes escala,

Na opo Mostrar os ltimos, determine o tempo pela qual deseja que os dados sejam atualizados no E3Chart. Na opo Marcadores, especifique o intervalo entre os marcadores e defina se deseja ou no que seja automtico. Informe a quantidade marcas pequenas e a sua formatao. Caso desejar, especifique o estilo da grade, informando o estilo e cor da linha.

258

MANUAL

E3

ELIPSE E3

Opo habilitada: Usar escala mvel de tempo atualizada a cada minuto. Atravs desta opo, possvel utilizar a escala mvel de tempo, atualizada a cada minuto, conforme especificao determinada nas propriedades.

Figura1: Configurao E3Chart

Manual E3

259

1.67. Penas
O objeto Pena representa o registro grfico no E3Chart. Cada pena configurada para exibir dados em tempo real ou dados histricos vindos de uma consulta. Quando este objeto inserido no grfico, recebe o nome de Pen, porm possvel renome-lo atravs da propriedade Name. Para utilizar este recurso, siga os seguintes procedimentos: Insira o objeto E3Chart no projeto;

Acesse as propriedades do objeto, atravs do clique com o boto direito e selecionando a opo propriedades ou pelo duplo clique sobre o objeto. As penas representam os valores plotados no grfico. Na tela de penas voc tem uma viso de todas as penas, podendo inser-las ou remov-las ou configurar.

Figura1: Configurao E3Chart

260

MANUAL

E3

ELIPSE E3

As propriedades e mtodos das penas so os seguintes: Propriedades das Penas


PROPRIEDADES BufferSize BkColor Color DataSourceType DESCRIO

DataOffSet DigitalData

HorDataSource QueryName Name PenType UseTimeStamp VerDataSource Visible Width

Determina o nmero de pontos mantidos na pena, caso os dados sejam em tempo real. Determina a cor do fundo da pena. Determina a cor da pena no Grfico. Determina o tipo da origem dos dados da pena. As opes disponveis desta propriedade so as seguintes: - Tempo real: A origem dos dados sero atualizados em tempo real. - Histrica: A origem dos dados sero atualizados conforme a consulta mencionada. Determina o deslocamento opcional para os dados da pena. Determina o estilo de plotagem digital da pena no Grfico. Se a propriedade estiver setada para True, o estilo de protagem digital supe que a variao do dado seja de forma digital, ou seja, que seu valor em relao ao ltimo variou instantneamente. Caso contrrio, a variao considerada linear e os pontos so unidos por um segmento de reta. Determina o nome do dado a ser mostrado no eixo horizontal. Determina o nome da consulta a ser realizada no Grfico. Determina o nome da pena no Grfico. Determina o estilo da pena no Grfico. Determina a varivel horizontal no dado a ser mostrado no Grfico. Determina o nome do dado a ser mostrado no eixo vertical. Indica se a pena est visvel no Grfico. Determina a largura da linha da pena no Grfico.

Mtodos das Penas


MTODOS Connect DESCRIO

Disconnect

Faz com que a pena passe a receber os dados de tempo real associados as propriedades HorDataSource e VerDataSource. Se a pena j estiver conectada, o mtodo no utilizado. Limpa os dados atuais, e faz com que a pena no receba mais os dados de tempo real do seu tag associado. Se a pena j estiver desconectada no faz nada. Pode ser utilizado para trocar um tag em modo de execuo.

Manual E3

261

As penas representam os valores plotados no grfico. A tela de penas voc tem uma viso de todas as penas, podendo inser-las ou remov-las. Depois de criada a pena tem que ser configurada. Para isso basta clicar em Configurao. Os dados da pena podem ser de dois tipos:

1.67.1.Varivel atualizada em tempo real


Significa que a pena vai receber os valores vindos de varivies do E3. Se a opo TimeStamp estiver selecionada significa que no eixo horizontal ser mostrado o tempo que em o valor foi alterado. Caso contrrio outra varivel pode ser definida para se fazer um grfico de tipo Dado x Dado.

Figura1: Configurao da Pena

262

MANUAL

E3

ELIPSE E3

1.67.2.Histrico usando consulta


Na primeira vez que esta tela for chamada nenhuma consulta esta disponvel. Para utiliz-la, clique em Nova Consulta e informe qual campo da consulta voc deseja usar no eixo horizontal e no eixo vertical.

Figura1: Configurao Pena

Os campos disponveis so os seguintes: Campos Consulta: Determina a consulta da pena. Atravs do boto Consulta, possvel configurar as especificaes da consulta e determinar a fonte de dados da mesma. No eixo vertical, usar o campo: Determina o campo que ser utilizado no eixo vertical. No eixo horizontal, usar o campo: Determina o campo que ser utilizado no eixo hosizontal.

O sistema abrir uma tela para configurao da consulta na Pena:

Manual E3

263

Configurao das consultas Servidor de Dados o nome do DBServer usado no E3. Os campos devem ser os campos que esto definidos na tabela (por exemplo uma tabela de histrico) e que voc deseja utilizar em alguma das pena.

Figura1: Configurao da Consulta

Os campos disponveis para esta opo so os seguintes: Campos Nome da consulta: Determina o nome da consulta que ser utilizada na pena. Servidor de BD: Determina o servidor de Banco de Dados da consulta. Tabela: Determina a tabela da Consulta. Domnio: Determina o domnio pela qual o Banco de Dados fornece a Consulta os dados para a pena histrica. Se o domnio estiver em branco, o servidor local. Campos da Tabela: Neste item, determinada a configurao para cada campo da tabela: nome, filtro e ordenao dos campos.

264

MANUAL

E3

ELIPSE E3

1.67.3.Configurao da aparncia da pena


Atravs desta opo, possvel configurar todas as opes referentes a estilo, cor de fundo, nome da pena, etc. Tais especificaes so visualizadas em runtime.

1.67.4.Configurao avanada da pena


Caso voc desejar mudar a quantidade de dados mantidos na pena mude o nmero de amostras. (Opo vlida para penas de dados em tempo real). A opo de deslocar os dados serve, por exemplo, para se comparar dados do ms passado com dados do ms atual. Para isso nos dados da pena do mes passado voc pode deslocar os dados 30 dias para frente.

Manual E3

265

1.68. Criando um E3Chart Histrico


Criaremos um objeto grfico para mostrar os dados do histrico. Para isso, siga os seguintes procedimentos: Crie uma tela chamada AnaliseHistorica e nela insira um objeto E3Chart. Chame as pginas de propriedades deste objeto e entre na pgina Geral. Configure o grfico para Usar uma escala de tempo fixa. Nna pgina Grade Horizontal, configure um intervalo de tempo de at 2 minutos apartir do horrio atual e na pgina Grade Vertical, configure a escala para 0 a 100. Na pgina Penas, criaremos as penas do histricos. Clique sobre o boto de adicionar e ser mostrada a janela de configurao da pena. Em primeiro lugar deve-se selecionar a pena do tipo histrica criando uma nova consulta:

Figura1: Configurao Consulta

Ao selecionar a opo de Nova Consulta ser mostrada outra janela onde devero ser configurados os seguintes parmetros: Nome da Consulta = Consulta Servidor de Dados = ServidorDados Tabela = Trafo

266

MANUAL

E3

ELIPSE E3

Figura1: Configurao Consulta

Ao clicar em fechar ser mostrada novamente a tela anterior. Agora necessrio selecionar o nome da consulta no campo apropriado e nos campos e selecionar para ser mostrado no eixo vertical o campo Corrente e no horizontal E3TimeStamp. Repetir esta operao mais duas vezes usando a consulta j criada e selecionando para o eixo vertical os campos Tenso e Potencia. Isto far com que tenhamos um grfico de 3 penas. Sua tela dever ficar parecida com a figura abaixo:

Figura1: Tela E3Chart

Manual E3

267

1.69. Objeto Coleo de Penas


O objeto Coleo de Penas (PenCollection) representa a coleo de Penas contidas no E3Chart.

A propriedade especfica deste objeto a Propriedade Count, pela qual conta o nmero de penas na Coleo de penas. Os mtodos disponveis desta propriedade so os seguintes: Mtodos da Coleo de Penas
MTODOS AddPen ChangePenPos Item DESCRIO

Remove

Adiciona uma nova penas ao E3Chart. Modifica a posio da pena no E3Chart. O mtodo Item retorna o objeto pena na coleo de penas, especificado pelo ndice. Sendo numrico, corresponde ao ndice, e se for texto, corresponde ao nome da pena. Remove uma pena do E3Chart.

268

MANUAL

E3

ELIPSE E3

1.70. Objeto Consulta (Query)


O objeto Consulta (ou Query) retorna a consulta no banco de dados.

As propriedades disponveis para esta opo so as seguintes: Propriedades da Consulta


PROPRIEDADES AddQuery Count DBServer Domain FieldCount FieldName Name Remove TableName DESCRIO

Adiciona uma consulta na coleo de consultas do E3Chart. Seta ou retorna o nmero de consultas do Grfico. Determina o nome do servidor da consulta no Grfico. Especifica o domnio da consulta como origem dos dados. Determina o nmero de campos da consulta. Especifica o nome do campo da consulta no Grfico. Determina o nome da consulta no Grfico. Remove uma consulta na coleo de consultas do E3Chart. Determina o nome da tabela da consulta no Grfico.

Os mtodos disponveis para este objeto so os seguintes:


Manual E3 269

Mtodos da Consulta
MTODOS AddFields FieldsFilter FieldOrder Item RemoveField DESCRIO

Adiciona um campo consulta do Grfico. Especifica o filtro usado no campo do Grfico. Especifica a ordenao de campos na consulta no Grfico. Seta ou retorna a consulta atravs do nome ou ndice. Remove um campo da consulta no Grfico.

1.71. Objeto Coleo de Consultas


O objeto Coleo de Consultas (ou QueryCollection) representa a coleo de consultas (Objeto Query) do E3Chart.

Os mtodos desta opo so os seguintes: Mtodos da Coleo de Consulta


MTODOS AddQuery RemoveQuery DESCRIO

Adiciona uma consulta na coleo de consultas do E3Chart. Remove uma consulta na coleo de consultas do E3Chart.

270

MANUAL

E3

ELIPSE E3

1 7

Captulo

17. Frmulas

Voc pode inserir um mdulo de frmulas em seu projeto, quando necessitar armazenar e transferir conjuntos de valores para determinados agrupamentos de variveis, de forma a criar configuraes ou setups pr-definidos que podem ser usados em vrias situaes. O mdulo de frmulas fornece ferramentas para facilitar a criao e manuteno desses conjuntos de valores, sendo que o nome dado para cada conjunto de valores a frmula. Cada frmula deve ser associada um Template, que pode ser compreendido como a formatao das tabelas de um Banco de Dados. O Template informa quantas variveis faro parte da frmula, o tipo de dados que poder ser armazenado em cada varivel, e os tipos de permisses e restries. As frmulas criadas para um determinado template podero ser enviadas e/ou carregadas para um template e tambm para grupos de variveis, desde que obedeam uma relao um por um com cada elemento do template. Cada grupo de variveis definido como uma Unidade (Unit) e podem ser definidas vrias unidades para um mesmo template. Assim, voc for enviar valores de uma frmula para um conjunto de tags, a frmula a origem dos dados e as Unidades so o destino dos dados. Caso queira guardar em uma frmula os valores atuais de certos tags, estes ltimos so a origem dos dados e a frmula o destino. O template apenas define a quantidade, tipos e restries dos dados nessas operaes. Para utilizar este recurso, clique com o boto direito do mouse no nome do projeto e selecione o tem Frmula.

Manual E3

271

Aps inserir a frmula em seu aplicativo, voc pode configurar a partir de um duplo clique sobre o mdulo, atravs do Wizard de Frmulas. Deve ser informado o nome da Tabela onde sero guardadas as frmulas e o servidor de Banco de Dados. Em seguida, so definidos os templates. Este campos podem ser inseridos atravs do clique no atalho ou atravs da tecla Insert.

Em cada linha de definio deve ser informado o nome do Campo e o tipo de dado, que pode ser inteiro, double, texto e data/hora. A terceira coluna refere-se s restries do campo. As restries sero utilizadas quando a frmula for enviada
272
MANUAL

E3

ELIPSE E3

unidade, verificando se os valores desejados podem ser escritos nas variveis de destino.

A seguir so definidas as unidades, incluindo os links para as variveis que representaro cada tem do template dentro da unidade.

Manual E3

273

1 8

Captulo

18. Controles ActiveX

Em seguida, so definidas as configuraes especficas da templates, onde a cada conjunto de valores uma receita de dados que definem um certo comportamento relativo a uma unidade. Pode-se definir um conjunto de valores diferentes a cada configurao diferente.

Feito todas as configuraes necessria, clique em Finish, para finalizar a caixa de dilogo da frmula. Para exerccos sobre Frmulas, verifique o Tutorial do E3.

Os objetos grficos, chamados de ActiveX, so componentes que podem ser desenvolvidos por qualquer pessoa em linguagens como C/C++, Visual Basic, Delphi, etc... e podem ser inseridos em qualquer software que possua um ActiveX Container, como o E3. Os ActiveX so compostos de objetos de interface grfica com o usurio e podem ser inseridos nas telas, e ento serem movidos, redimensionados, etc.., e suas
274
MANUAL

E3

ELIPSE E3

propriedades podem ser editadas como qualquer outro tipo de objeto. Para tantos, os objetos devem estar registrados no sistema. Eles permitem que sejam visualizadas graficamente, aes que ocorrem no sistema, como por exemplo, a monitorao do alarme, conforme objeto E3Alarm. Dentre os principais objetos esto: Objeto E3 Alarms, Objeto E3Browser e Objeto E3Chart . O E3 permite que qualquer ActiveX possa ter suas propriedades exportadas associadas um tag ou outra propriedade qualquer de uma aplicao quando o objeto estiver sendo usado. Para utilizar este recurso, siga os seguintes procedimentos: No Organizer, escolha a aba Classes e clique com o boto direito do mouse. O mesmo vai habilitar uma caixa de opes, dentre as quais, voc deve escolher Adicionar ActiveX.

Manual E3

275

Escolha o ActiveX que deseja inserir no projeto.

Clique em Ok para inser-lo na tela. Atravs do boto Atualizar, possvel atualizar os dados no sistema. Na instalao do E3, j existem pr-configurados os seguintes objetos: - Sumrio de alarmes - E3AlarmControl Control. - Tabela de dados - E3BrowserXControl. - Grfico - E3Chart Control. - Controles do Windows MSForms: CheckBox (Caixa de seleo); MSForms Combox (Lista de seleo); MSForms CommandButton (Boto de Comando); MSForms Label (Display); MSForms ListBox (Lista de seleo); MSForms ScrollBar (Barra de rolagem); MSForms OptionButton (Boto de opes); MSForms SpinButton (Boto Incremento/Decremento); MSForms ToogleButton (Boto Liga-Desliga), etc. Alguns objetos ActiveX esto previamente registrados no E3, e so descritos abaixo:

276

MANUAL

E3

ELIPSE E3

1.72. Caixa de Seleo


Use uma Caixa de seleo para dar ao usurio uma escolha entre dois valores tais como Sim/No, Verdadeiro/Falso, ou On/Off. Quando o usurio seleciona uma caixa de texto, este indica uma marca especial (tal como um X) e seu estado atual sim, verdadeiro, ou On; se o usurio no selecionar a caixa de seleo, ele est vazio e seu estado No, falso, ou Off; dependendo do valor da propriedade TripleState, uma caixa de texto pode tambm ter um valor nulo. Se uma caixa de seleo for associado a uma fonte de dados, ao mudar a caixa de texto os dados da fonte tambm sero mudados. Uma caixa de seleo desabilitado mostra o valor atual, mas escurecido e no permite mudanas pelo usurio. Voc pode tambm usar uma caixa de seleo dentro de uma caixa de grupo para realizar mltiplas selees. O usurio pode selecionar um ou mais itens marcando a caixa de seleo correspondente. A propriedade padro a propriedade Value. O evento padro o evento OnClick. Nota: O objeto Lista tambm permite inserir uma marca de verificao por opes selecionadas. Dependendo de sua aplicao, voc pode usar a lista de seleo em vez de usar um grupo de controles da caixa de seleo.

Para utilizar este objeto, siga os seguintes procedimentos: Para que a Caixa de seleo seja utilizada, necessrio que o objeto esteja registrado no sistema. Isto pode ser visto, clicando com o boto direito do mouse e verificando se o objeto mencionado. Para utilizar os recursos da Caixa de seleo, siga os seguintes procedimentos: Insira a Caixa de seleo na tela e caso necessite, configure as suas propriedades gerais; Propriedades da Caixa de seleo
PROPRIEDADES Accelerator Aligmnent SpecialEffect Text Align TripleState WordWrap DESCRIO

Seta ou retorna as teclas de atalho. Define o alinhamento do objeto na tela. Especifica a aparncia visual de um objeto. Define o alinhamento do texto do objeto na tela. Define se poder ser atribudo ou no o estado nulo ao objeto. Indica se o texto de um controle envolvem automaticamente na extremidade de uma linha.

Manual E3

277

1.73. Boto de opes


Use um boto de opes para mostrar se um nico tem em um grupo est selecionado. Note que cada boto de opes em um quadro mutuamente exclusivo. Se um boto de opes for associado a uma fonte de dados, ele pode mostrar ao valor daquela fonte de dados como Sim/No, Verdadeiro/Falso, ou On/Off. Se o usurio selecionar o boto de opes o valor ser sim, verdadeiro, ou On; se o usurio no selecionar o boto de opes, o valor ser No, falso, ou Off. Um boto de opes desabilitado fica escurecido e no mostra um valor. Dependendo do valor da propriedade TripleState, um boto de opes pode tambm ter um valor nulo. Voc pode tambm usar um boto de opes dentro de uma caixa de grupo para realizar mltiplas selees. A propriedade padro de um boto de opes a propriedade Value. O evento padro de um boto de opes o evento OnClick.

Para utilizar este objeto, siga os seguintes procedimentos: Insira o Boto de opes na tela; Caso necessite, configure as propriedades gerais deste objeto. Propriedades do boto de opes
PROPRIEDADES Accelerator Aligment SpecialEffect TextAlign TripleState WordWrap DESCRIO

Seta ou retorna as teclas de atalho Define o alinhamento do objeto na tela. Especifica a aparncia visual de um objeto. Define o alinhamento do texto do objeto na tela. Define se poder ser atribudo ou no o estado nulo ao objeto. Indica se o texto de um controle envolvem automaticamente na extremidade de uma linha.

278

MANUAL

E3

ELIPSE E3

1.74. Lista de Seleo


Combina as caractersticas de uma lista de seleo e de um editor de texto. O usurio pode digitar um valor novo, como em um editor de texto, ou selecionar um valor existente como em uma lista de seleo. Observe que se uma lista for limitado a uma fonte de dados, ento o valor que for inserido pelo usurio ser inserido naquela fonte de dados. Se uma lista multicolunas for associado, ento a propriedade BoundColumn determina que valor armazenado na origem dos dados. A lista em um lista consiste em uma fileira de dados. Cada fileira pode ter uma ou mais colunas, que podem aparecer com ou sem ttulos. A propriedade padro de uma lista a propriedade Value, e o evento padro o OnChange.

Nota: Se voc quiser que mais do que uma nica linha da lista aparea, voc pode querer usar uma Lista de seleo em vez de uma lista. Se voc quiser usar uma lista de seleo e limitar os valores queles da lista, voc pode ajustar a propriedade Style da lista de seleo de forma que o controle parea uma lista drop-down.

Para utilizar este objeto, siga os seguintes procedimentos: Insira a Lista de Seleo na tela; Caso necessite, configure as prpriedades do objeto.

Manual E3

279

Propriedades da Lista de seleo


PROPRIEDADES BorderColor BorderStyle BoundColumn ColumnCount ColumnHeads ColumnWidths DragBehavior DropButtonStyle EnterFieldBehavior HideSelection IMEMode ListIndex ListRows ListStyle ListWidth MatchEntry MaxLenght SelectionMargin ShowDropButtonWhe n SpecialEffect Style TextAlign TextColumn TopIndex DESCRIO

Determina a cor da borda do objeto. Determina o estilo da borda do objeto. Identifica a fonte de dados do objeto. Especifica o nmero de colunas no objeto. Insere um ttulo acima da coluna da lista Define a altura das colunas no objeto. Determina os movimentos do objeto pelo mouse. Especifica o smbolo indicado na tecla do objeto. Define se o objeto incorpora o comportamento da seleo. Determina a seleo do texto do objeto. Especifica a modalidade do tempo do funcionamento do mtodo de entrada (IME) para um controle. Determina o ndice da opo que foi selecionada pelo usurio. Determina o nmero mximo de linhas no objeto. Define o estilo das linhas do objeto. Determina a altura das linhas do objeto. Seta ou retorna o valor indicado no objeto. Determina o tamanho mximo das llinhas do objeto. Especifica se o usurio pode selecionar uma linha do texto seleciondo a regio. Especifica quando mostrar a tecla de navegao do objeto Especifica a aparncia visual de um objeto. Define o estilo do objeto na tela. Define o alinhamento texto do objeto na tela. Identifica a coluna no objeto, para armazenar na propriedade do texto quando o usurio seleciona uma linha. Especifica o tipo de ponteiro indicado quando o usurio posiciona o mouse sobre o objeto.

280

MANUAL

E3

ELIPSE E3

1.75. Boto de Comando


Inicia, termina ou interrompe uma ao ou srie de aes. O Script associado ao evento Click do boto determina o que o boto faz. Por exemplo, voc pode criar um boto que abre uma tela. Voc tambm pode mostrar um texto, um desenho ou ambos. A propriedade padro de um boto a propriedade Value. O evento padro de um boto o evento OnClick.

Para utilizar este objeto, siga os seguintes procedimentos: Insira o Boto de Comando na tela e caso necessite, configure as propriedades gerais deste objeto. Caso necessite, configure as propriedades gerais deste objeto. Propriedades da Boto de commando
PROPRIEDADES Accelerator TakefocusOnClick WordWrap DESCRIO

Seta ou retorna as teclas de atalho. Especifica o foco do objeto. Indica se o texto de um controle envolvem automaticamente na extremidade de uma linha.

1.76. Texto
O Texto mostra um texto descritivo, tal como ttulos, textos em geral, desenhos ou instrues rpidas. Um texto no mostra valores de fontes de dados nenhuma, e sempre dessassociado. A propriedade padro de um texto Caption (que pode ser associado a uma fonte de dados) e o evento padro OnClick.

Para utilizar este objeto, siga os seguintes procedimentos: Insira objeto Texto na tela e caso necessite, configure as propriedades gerais deste objeto. Caso necessite, configure as propriedades gerais deste objeto.

Manual E3

281

Propriedades da Boto de commando


PROPRIEDADES Accelerator BorderColor BorderStyle SpecialEffect TextAlign WordWrap DESCRIO

Seta ou retorna as teclas de atalho. Determina a cor da borda do objeto. Determina o estilo da borda do objeto. Especifica a aparncia visual de um objeto. Define o alinhamento do objeto na tela. Indica se o texto de um controle envolvem automaticamente na extremidade de uma linha.

1.77. Lista
Mostra uma lista de valores e permite a selao de um ou mais valores. Se a lista est associado a uma fonte de dados, ento a lista armazena o valor selecionado naquela fonte de dados. A lista pode aparecer como uma lista ou como um grupo de controles boto de opes ou caixa de seleo. A propriedade padro de uma lista Value, e o evento padro o OnClick. Nota: Voc no pode digitar texto em uma lista tipo drop-down.

Para utilizar este objeto, siga os seguintes procedimentos: Insira a Lista de Seleo na tela; Caso necessite, configure as propriedades gerais deste objeto.

282

MANUAL

E3

ELIPSE E3

Propriedades da Lista
PROPRIEDADES BorderColor BorderStyle BoundColumn ColumnCount ColumnHeads ColumnWidths DragBehavior DESCRIO

Determina a cor da borda do objeto. Determina o estilo da borda do objeto. Identifica a fonte de dados do objeto. Especifica o nmero de colunas no objeto. Insere um ttulo acima da coluna da lista. Especifica a altura das colunas no objeto. Especifica se o sistema permite que o objeto seja movimentado pelo mouse.

1.78. Barra de Rolagem


Retorna ou seta o valor de outro controle baseado na posio da caixa de deslocamento barra de rolagem. A barra de rolagem um controle stand-alone que voc pode inserir em uma tela. Ele visualmente como a barra de rolagem que visto em certos objetos como a lista de seleo ou na poro drop-down de uma lista. Entretanto, diferentemente das barras de rolagem desses exemplos, a barra de rolagem stand-alone no uma parte de nenhum outro controle. Para fazer com que a barra de rolagem mostrar ou guardar o valor de outra varivel, voc deve escrever cdigo em VBScript para seus eventos e mtodos. Por exemplo, para usar o barra de rolagem para atualizar o valor de um editor de texto, voc pode escrever um script que l a propriedade Value da barra de rolagem e ento setar a propriedade Value de um editor de texto. O Evento padro de uma barra de rolagem o Change, e a propriedade padro Value.

Nota: Para criar uma barra de rolagem horizontal ou vertical, arraste a extremidades de redimensionamento horizontal ou verticalmente na tela. Para utilizar este objeto, siga os seguintes procedimentos: Insira a Barra de Rolagem na tela e caso necessite, configure as propriedades:
Propriedades da Barra de rolagem
PROPRIEDADES SmallChange ProportionalThumb DESCRIO

Especifica a quantidade de movimento que ocorre quando o usurio movimenta o objeto a partir do cursor. Especifica se o tamanho da caixa de rolagem acompanha a dimenso do objeto.

Manual E3

283

1.79. Boto Incremento-Decremento


Este boto utilizado para incrementar e decrementar nmeros. Ao clicar em um boto incremento/decremento, somente o valor do boto incremento/decremento mudado. Voc pode escrever um cdigo que usa o boto incremento/decremento para atualizar o valor de outro objeto. Por exemplo, voc pode usar um boto incremento/decremento para mudar o ms, ano ou dia mostrado numa data. Voc tambm pode usar um boto incremento/decremento para escolher entre uma faixa de valores numa lista de itens, ou para mudar o valor mostrado em uma caixa de texto. Outra opo simplesmente associar a propriedade Value do boto incremento/decremento diretamente uma propriedade de outro objeto, como Caption ou Value de um texto ou editor de texto. O Evento padro de um boto incremento/decremento o Change, e a propriedade padro Value.

Nota: Para criar um boto incremento/decremento horizontal ou vertical, arraste a extremidades de redimensionamento horizontal ou verticalmente na tela.

Para utilizar este objeto, siga os seguintes procedimentos: Insira o Boto Incremento e Decremento na tela; Caso necessite, configure as propriedades do objeto:
Propriedades do Boto Incremento-Decremento
PROPRIEDADES Delay SmallChange DESCRIO

Especifica o status dos eventos do objeto. Especifica a quantidade de movimento que ocorre quando o usurio movimenta o objeto a partir do cursor.

284

MANUAL

E3

ELIPSE E3

1.80. Editor de Texto


O Editor de Texto mostra uma informao de um usurio ou de uma fonte de dados. similar ao objeto Setpoint padro do E3, porm segue definies padro do sistema operacional Windows. O editor de texto o controle mais comumente usado para mostrar informao digitada pelo usurio. Tambm pode mostrar um conjunto de dados, tal como uma tabela, consulta, planilha ou resultado de clculo. Se for associado a uma fonte de dados, ao modificar o o editor de texto a fonte de dados tambm ser modificada. Uma formatao aplicada a qualquer pedao de texto num editor de texto afetar todo o texto naquele controle. Por exemplo, se voc muda a fonte ou tamanho de qualquer caracter no controle, a mudana afetar todos os caracteres. A propriedade padro de um editor de texto Value, e o evento padro o Change.

Para utilizar este objeto, siga os seguintes procedimentos: Insira o Editor de Texto na tela. Caso necessite, configure as propriedades gerais deste objeto.

Manual E3

285

Propriedades do Editor de Texto


PROPRIEDADES AutoWordSelect DESCRIO

Especifica se um objeto ter o sua dimenso ajustada automaticamente. DragBehavior Especifica se o sistema permite que o objeto seja movimentado pelo mouse. EnterFieldBehavior Define se o objeto incorpora o comportamento da seleo. EnterkeyBehavior Define se possvel pressionar a tecla Enter no objeto. IMEMode Especifica a modalidade do tempo do funcionamento do mtodo de entrada (IME) para um controle. IntegralHeight Especifica o status das linhas do objeto. Multiline Define se o objeto vai possuir ou no linhas mltiplas. PasswordChar Especifica se os caracteres que so especificados atravs da edio esto incorporados ao objeto. Scrollbars Define as especificaes referentes a barra de rolagem no objeto. SelectionMargins Especifica se o usurio pode selecionar uma linha do texto seleciondo a regio. SpecialEffect Especifica a aparncia visual de um objeto. TabKeyBehavior Define se o Tab permitido na regio da edio. TextAlign Determina o alinhamento do texto no objeto. WordWrap Indica se o texto de um controle envolvem automaticamente na extremidade de uma linha. Propriedades visveis somente no App Browser CanPaste Especifica se o editor de texto contm os dados inseridos atravs do mtodo Paste (colagem) CurLine Especificao ponto de insero no editor de texto. CurTargetX Recupera a posio horizontal inicial do ponto de insero do objeto. LineCount Retorna o nmero de linhas do objeto. SelLength Seta ou retorna o nmero de caracteres selecionados no editor de texto. SelStart Indica o ponto inicial do texto selecionado, ou o ponto de insero, caso nenhum texto for selecionado. SelText Retorna a seleo do texto do editor de texto.

1.81. Boto Liga-Desliga


Use um Boto Liga/Desliga para mostrar se um item est selecionado.
286
MANUAL

E3

ELIPSE E3

Se o boto Liga/Desliga est associado a uma fonte de dados, ele mostra o valor atual daquela fonte de dados, como Sim/No, Verdadeiro/Falso ou On/Off, ou alguma outra escolha entre duas opes. Se o usurio selecionar o boto Liga/Desliga, o valor ser Sim, Verdadeiro ou On, e caso contrrio, No, Falso ou Off. Um boto Liga/Desliga desabiltado mostra um valor, mas est escurecido e no permite modificaes do usurio. A propriedade padro de um boto Liga/Desliga Value, e o evento padro o Click.

Para utilizar este objeto, siga os seguintes procedimentos: Insira o Boto Liga/Desliga na tela; Caso necessite, configure as propriedades deste objeto.
Propriedades do Boto Liga-Desliga
PROPRIEDADES Delay SmallChange DESCRIO

Especifica o status dos eventos do objeto. Especifica a quantidade de movimento que ocorre quando o usurio movimenta o objeto a partir do cursor.

Propriedades Padro dos Objetos ActiveX As propriedades padro dos objetos acima so as seguintes:

Manual E3

287

Propriedades dos ActiveX


PROPRIEDADES Accelerator Alignment AutoSize AutoTab BackColor BackStyle BorderColor BorderStyle Enable Font Forecolor GroupName Locked Max Min MouseIcon MousePointer Picture Orientation Text DESCRIO

Seta ou retorna o controle de um objeto. Define o alinhamento do objeto na tela. Especifica se um objeto ter o sua dimenso ajustada automaticamente. Determina a insero ou no de uma aba no objeto. Define a cor de frente do objeto na tela. Define o estilo do objeto na tela. Seta ou retorna o nmero inteiro da cor da borda/linha deste objeto. Seta ou retorna o estilo da borda/linha deste objeto. Seta ou retorna o boleano que habilita a funcionalidade deste objeto. Seta ou retorna a fonte do objeto. Seta ou retorna o boleano que habilita a funcionalidade deste objeto. Cria um grupo mtuo de controles exclusivos para o objeto. Especifica se um controle pode ser editado. Define a especificao mxima do objeto na tela. Define a especificao mnima do objeto na tela. Atribui um cone ao objeto. Especifica o tipo de ponteiro indicado quando o usurio posiciona o mouse sobre um objeto. Especifica a figura (bitmap) atribuda ao objeto. Define a orientao do objeto na tela. Define o estilo do texto do objeto na tela.

Tambm h os objetos E3Chart (grfico), E3Alarm (Sumrio de Alarmes) e E3Browser. Para saber maiores informaes, consulte os captulos referentes.

288

MANUAL

E3

ELIPSE E3

1 9

Captulo

19. Bibliotecas

O E3 possui ferramentas que permitem transformar qualquer objeto ou conjunto de objetos de sua aplicao em bibliotecas. As bibliotecas podem ser formadas de objetos ou grupos de objetos que venham a ser freqentemente utilizados, e podem ser subseqentemente reutilizados em sua aplicao. O E3 fornece dois tipos de bibliotecas para o usurio: uma biblioteca de smbolos grficos vetoriais, que podem ser livremente utilizadas em suas aplicaes, e uma ferramenta de bibliotecas prpria chamada de ElipseX.

1.82. Biblioteca de Smbolos


A Biblioteca de smbolos pode ser acessada atravs do Organizer no Tab Biblioteca. Esto disponveis uma srie de elementos grficos vetoriais, divididos em categorias, que podem ser arrastados para as telas ou ento para os ElipseX. Esto disponveis os seguintes smbolos: 3D ISA Symbols, Ar Condicionado, Arquitetura, Setas, ASHRAE (Controles e Equipamentos), ASHRAE (Dutos), ASHRAE (Canos), Formatos Bsicos, Sopradores e Ventiladores, Prdios, Processos Qumicos, Computadores, Contineres, Controladores, Esteiras e Linhas de Produo, Dutos, Eltrica, Tubos Flexveis, Medidores de Vazo, Smbolos Gerais, Aquecimento, HVAC, cones e Bitmaps, Miscelnea Industrial, Smbolos Internacionais, Smbolos ISA, Mapas e Bandeiras, Manuseio de Materiais, Canos, Misturadores, Motores, Natureza, Interfaces Homem Mquina, Painis, Acessrios Industriais, Dispositivos de Potncia, Resfriamento de Processos, Aquecimento de Processos, Bombas, Segurana, Escalas, Canos Segmentados, Sensores, Cortes em Tanques, Texturas, Vlvulas, Veculos, gua e Abastecimento, Fios e Cabos.

Manual E3

289

Para utilizar este recurso, siga os seguintes procedimentos: A Biblioteca de Smbolos do E3 pode ser vista pelo Organizer no Tab "Biblioteca". Selecionando este Tab, teremos acesso aos conjuntos de smbolos, que esto agrupados em categorias, onde so selecionadas atravs do lista na parte superior. Para inserir um objeto da biblioteca de smbolos em uma tela, basta clicar no objeto desejado e arrast-lo para a tela. Depois de inserido, o objeto pode ser livremente editado e trabalhado de acordo com as caractersticas descritas para os objetos de imagem, como por exemplo, mudar a cor de preenchimento atravs das propriedades "OverrideFillMode", "OverrideFillColor" e "OverrideLineColor" sem a necessidade de transformar o objeto em um objeto grfico do E3.

290

MANUAL

E3

ELIPSE E3

Para criar uma nova Biblioteca no E3, siga os seguintes procedimentos:

Acesse o menu , selecione o tem Novo Projeto e clique em Prximo ;

Na opo Tipo de Aplicao, selecione a opo Biblioteca de componentes do E3. Determine o nome da sua biblioteca e clique em prximo; Determine as especificaes referentes ao domnio. Clique em Concluir.

1.83. ElipseX
Os ElipseX so as bibliotecas de objetos do E3, que vo alm da biblioteca de smbolos descrita anteriormente. Os ElipseX podem conter alm de um desenho,
Manual E3 291

variveis internas que podem ser exportadas para a aplicao, alm de lgicas de programao (scripts) que vo estar presentes em todas as cpias do objeto que est sendo criado, diminuindo a necessidade de repetio de cdigo em diversas partes de seu aplicativo. Dentro de uma biblioteca ElipseX, podem ser inseridos dois tipos de objetos, que so os objetos grficos (XControls) e os objetos de dados (XObjects). Podem ser inseridos nos XControls os seguintes itens: Primitivas de Desenho (Retas, Retngulos, Crculos, etc...), Objetos Grficos Vetoriais, incluindo objetos da biblioteca de smbolos (WMF, EMF, etc...), Objetos Grficos noVetoriais (BMP, JPEG, GIF,etc...), Controles ActiveX do E3 (E3Chart, E3Browser, E3Alarm, Controles ActiveX de terceiros e Outros XControls). J as bibliotecas de dados, podem conter quaisquer tipos de objetos no-grficos, que so executados no E3Server. Podemos inserir em um XObject os seguintes objetos: IODriver, DataServer, DBServer, Formulas, AlarmConfig, AlarmServer, DBServer, Objetos COM, dentre outros. Os ElipseX so salvos em arquivos com extenso LIB, que podem ser criados atravs do menu Arquivo do E3 Studio - Novo Projeto, selecionando a opo "Salvar como..." da caixa de dilogo a opo "E3 Object Library (lib)", e informe um nome e diretrio para o arquivo, que ser criado com a extenso LIB. Dentro de um mesmo arquivo LIB podem existir qualquer numero de componentes ElipseX, sejam eles Xcontrols ou Xobjects. Voc poder ter tambm vrias bibliotecas diferentes (vrios LIBs) dentro do mesmo Domnio.

1.83.1.XControls
O XControl define uma interface grfica com o usurio, que pode ser composta de quaisquer objetos do E3, que ter o propsito de ser multiplicada facilmente por seu projeto. Voc poder criar um XControl clicando com o boto direito do mouse sobre o arquivo LIB criado em seu domnio, escolhendo a opo Inserir Xcontrol. Ao inserir um XControl, aberta uma janela composta de duas partes: a superior, onde podem ser inseridas variveis, que so as propriedades que sero "exportadas" pelo objeto, que podero ser associadas um tag ou outra propriedade qualquer de uma aplicao quando o objeto estiver sendo usado numa aplicao; e a parte grfica, que equivale uma Tela, onde podem ser inseridos os objetos grficos descritos anteriormente. As variveis a serem exportadas, que so os Xmethods, podem ser inseridas pressionando-se a tecla "Insert" do teclado, e deve ser definidas as seguintes propriedades para cada uma delas:

292

MANUAL

E3

ELIPSE E3

Nome, que ser a nome da varivel a ser visualizada na Janela de Propriedades quando em utilizao na sua aplicao; Tipo, que o tipo de dado a ser suportado pela varivel. Podem ser utilizados todos os tipos descritos no Captulo "Arquitetura de Projetos", que podem tambem ser visualizados pelo Tab "Classes" do Organizer, na classe "Standard" - folder "Types". Alguns exemplos so: Boolean, Byte, Integer, Date, String, Variant, Color, etc... interessante observar que podem ser declarados como Tipos, os objetos de Dados (XObjects). Desta forma, voc poder criar um objeto grfico que possui como propriedade um objeto de dados. O objeto de dados pode funcionar neste caso como uma "struct" ou "classe", como utilizado nas linguagens C/C++. Valor inicial: Indica o tipo do valor inicial, que estar especificado atravs da propriedade DefaultValue. Public: Indica se o Xmethod ser visvel fora da Biblioteca. Caso contrrio, ser uma propriedade interna somente. Texto de Ajuda: Texto de declarao e documentao da varivel.

As variveis a serem exportadas propriedades podem ser inseridas pressionando-se a tecla "Insert" do teclado, e deve ser definidas as seguintes propriedades para cada uma delas: A edio do objeto grfico pode ser feita da mesma forma quando voc est editando uma tela, possuindo os mesmos recursos grficos e opes.

Voc poder inserir os Xcontrols em qualquer tela, ou ainda dentro de outro Xcontrol clicando com o boto direito do mouse sobre a tela ou Xcontrol de destino, escolhendo a opo Inserir, como mostrado abaixo.

Manual E3

293

A partir deste momento, o seu Xcontrol ter um nome dentro da tela, e ser entendido como uma cpia da definio original. Assim, voc deve definir (se necessrio) os valores e/ou associaes que esta copia especifica ter no contexto que est sendo utilizada. Exemplo: Suponha voc criou um objeto Bomba, que possui um Xmethod com o nome de Estado, que receber uma informao externa revelando se a bomba est ligada ou desligada, o que far com que ela mude sua cor. Ao inserir este objeto na tela, o E3 automaticamente renomeia o objeto para Bomba1. Voc poder manter este nome ou renome-lo para outro que desejar. Depois, dever informar qual varivel ser associada ao Xmethod Estado. Suponha que certo tag de comunicao representa o estado dessa bomba; logo, dever ser feita uma associao entre a propriedade Estado e o referido tag. O mesmo trabalho dever ser feito para outras instncias (cpias) do objeto Bomba que se fizerem necessrias no projeto.

1.83.2.XObjects
Alm dos Objetos grficos XControls, voc pode criar uma biblioteca de dados, denominada XObject. Com ela, voc pode definir uma estrutura de dados, que ser executada no servidor. Tal estrutura poder realizar clculos, associaes, comunicaes, verificao de alarmes, registro histrico, etc..., que independam de que alguma interface grfica (Viewer) esteja aberta ou sendo executada naquele momento. Para criar um Xobject, clique com o boto direito do mouse sobre o arquivo LIB no Organizer e escolha a opo Inserir Xobject.

294

MANUAL

E3

ELIPSE E3

Ao inserir um XObject, aberta uma janela onde podem ser inseridas variveis, que so as propriedades que sero "exportadas" pelo objeto, denominadas Xmethods, que podero ser associadas a um tag ou outra propriedade qualquer de uma aplicao quando o objeto estiver sendo usado numa aplicao. As variveis a serem exportadas, as propriedades podem ser inseridas ,pressionando-se a tecla "Insert" do teclado, e deve ser definidas as seguintes propriedades para cada uma delas: Boolean, Byte, Integer, Date, String, Variant, Color,etc. interessante observar que podem ser declarados como Tipos, outros objetos de Dados (XObjects). Desta forma, voc poder criar um objeto de dados que possui como propriedade outro objeto de dados. Os objetos de dados podem funcionar neste caso como uma "struct" ou "classe", como utilizado nas linguagens C/C++. As variveis a serem exportadas propriedades podem ser inseridas pressionando-se a tecla "Insert" do teclado, e deve ser definidas as seguintes propriedades para cada uma delas: Nome, que ser a nome da varivel a ser visualizada na Janela de Propriedades quando em utilizao na sua aplicao; Tipo, que o tipo de dado a ser suportado pela varivel. Podem ser utilizados todos os tipos descritos no Captulo "Arquitetura de Projetos", que podem tambem ser visualizados pelo Tab "Classes" do Organizer, na classe "Standard" - folder "Types". Alguns exemplos so: Boolean, Byte, Integer, Date, String, Variant, Color, etc... interessante observar que podem ser declarados como Tipos, outros objetos de Dados (XObjects). Desta forma, voc poder criar um objeto de dados que possui como propriedade outro objeto de dados. Os objetos de dados podem funcionar neste caso como uma "struct" ou "classe", como utilizado nas linguagens C/C++. Publico: Indica se a propriedade poder ser manipulada externamente na biblioteca; Gravao: Indica que a cada mudana do valor, este dever ser armazenado em disco; Texto de Ajuda: Texto de declarao e documentao da varivel.

Alm dos XMethods, podem ser inseridos num Xobject qualquer mdulo do E3 que seja executado no servidor, a saber:
Manual E3

Driver de Comunicao e Driver de Comunicao OPC; AlarmConfig; AlarmServer;


295

DBServer; Formula; Servidor de Dados; Histricos.

Isto permite que voc possa definir como uma biblioteca, um sistema complexo de gerenciamento, que poder ser facilmente replicado quantas vezes forem necessrias em seu aplicativo. Importante: Veja que tanto o Xcontrol quanto o Xobject s podero se relacionar com o mundo externo atravs dos Xmethods ( ou ainda atravs do Mouse e teclado, no caso dos Xcontrols), ou ainda atravs do compartilhamento de algum outro recurso ou propriedade externa. Isso significa que voc no poder acessar dados internos de um Xobject ou Xcontrol seno de dentro do prprio objeto. Voc poder inserir os XObjects em qualquer Servidor de Dados, clicando com o boto direito do mouse sobre o Servidor de Dados, escolhendo a opo Inserir, como mostrado abaixo.

Note que mesmo que seu arquivo ou arquivos de biblioteca possuam vrios Xcontrols e Xobjects, ao tentar inserir uma biblioteca o E3 Studio exibir para as telas somente os Xcontrols, e para os Servidores de Dados somente os Xobjetcs.

1.83.3.Programao nos ElipseX


Durante a edio de scripts nos ElipseX devemos prestar ateno nomenclatura dos objetos e propriedades. Isto porque o Script que for criado na objeto tambm
296
MANUAL

E3

ELIPSE E3

existir em cada insero do mesmo em uma tela da aplicao ou servidor de dados (o que chamado de cpia ou instncia). Como no se sabe de antemo qual a propriedade qual uma varivel estar ligada, os scripts que utilizem informaes "externas" devero utilizar variveis internas, que sero substitudas pelas variveis "reais" durante a utilizao da biblioteca. Caso tenha declarado um objeto de dados (XObject) como o tipo de dado de uma dos XMethods de um XControl, voc poder utilizar as propriedades do XObject da mesma forma em seus scripts. Para isso, voc deve informar, quando na utilizao do XControl, o nome e localizao do XObject (inserido em algum Servidor de Dados em seu Domnio) para que o XControl receba os dados adequados. Suponha a descrio de objetos e propriedades abaixo: XObject Calculo1: Xmethod: Nome:X, Tipo:Integer Xmethod: Nome:Y, Tipo:Byte Xmethod: Nome:Parte1, Tipo: Calculo2 XObject Calculo2: Xmethod: Nome: Dado1, Tipo: Integer Xmethod: Nome: Dado2, Tipo: Integer XControl GraficoExemplo: Xmethod: Nome:Propriedade1, Tipo: Integer Xmethod: Nome: Calculos, Tipo: Calculo1 Para melhor exemplificar, podemos visualizar o esquema abaixo:

Para criar um script no objeto GraficoExemplo, suas propriedades podem ser utilizadas da seguinte forma: GraficoExemplo.Propriedade1 GraficoExemplo.Calculos.X
Manual E3 297

GraficoExemplo.Calculos.Y GraficoExemplo.Calculos.Parte1.Dado1 GraficoExemplo.Calculos.Parte1.Dado2 Para criar um script no objeto Calculo1, suas propriedades podem ser utilizadas da seguinte forma: Calculo1.X Calculo1.Y Calculo1.Parte1.Dado1 Calculo1.Parte1.Dado2 Para criar um script no objeto Calculo2, suas propriedades podem ser utilizadas da seguinte forma: Calculo2.X Calculo2.Y Para utilizar os ElipseX, proceda da seguinte forma: Insira o(s) Xobject(s) em algum Servidor de Dados. Defina um nome para o objeto.

Faa associaes das propriedades do Xobject com suas variveis reais presentes no servidor; Insira o(s) Xcontrols em alguma tela ou telas.

Defina um nome para o objeto. Faa associaes das propriedades do Xcontrol com as variveis reais presentes no servidor, incluindo a identificao do Xobjects que foram criados no Servidor de Dados.

298

MANUAL

E3

ELIPSE E3

2 0

Captulo

20.

Relatrios

Os Relatrios permitem que sejam visualizados e impressos os dados armazenados em banco de dados (Alarmes, Histricos e Receitas), alm de valores instantneos de variveis do sistema. Os dados podem ser impressos tanto em formato texto como em formato grfico, atravs do objeto E3Chart. Para utilizar este recurso, siga os seguinte procedimentos: Para criar um relatrio, clique com o boto direito no projeto e selecione a opo Relatrio.

Figura: Insero do relatrio

Caso necessite, configure as propriedades ou mtodos do objeto: Propriedade do Relatrio


PROPRIEDADES SourceQuery DESCRIO

Determina a fonte de dados da consulta do relatrio.

Manual E3

299

Propriedade da pgina do Relatrio

300

MANUAL

E3

ELIPSE E3 PROPRIEDADES PageBottomMargin PageLeftMargin PageRightMargin PageTopMargin AllowSplitter DocumentName DESCRIO

Determina a margem de fundo do relatrio. Determina a margem esquerda do relatrio. Determina a margem direita do relatrio. Determina a margem do topo do relatrio. Determina se a tela pode ser dividida em duas sees. Seta ou retorna o nome do documento no relatrio. O nome do documento aparece no spooler e pode ser usado para identificar facilmente o relatrio. Seta ou retorna o nmero mximo de pginas do relatrio. Quando o nmero mximo de pginas alcanado, o relatrio pra de processar o documento. Retorna a referncia do relatrio, permitindo que o objeto retorne as informaes de seu pai. Seta ou retorna a largura da rea imprimvel do relatrio. Seta ou retorna a rgua no relatrio em runtime. Habilita o script do relatrio. Seta ou retorna a linguagem script, utilizada para escrita e interpretao do mesmo. Seta ou retorna a caixa de dilogo com os parmetros da Consulta quando o relatrio estiver sendo executado. Retorna o status do relatrio. Seta ou retorna a barra de ferramentas da janela de prvia de impresso do relatrio. Determina a visibilidade do relatrio na tela. Seta ou retorna a barra de ferramentas na janela de prvia de impresso do relatrio. Determina as informaes especoficadas pelo usurio no relatrio. Retorna a verso do retatrio e o nmero do build. Adiciona uma imagem marca d agua no fundo do relatrio. Determina o alinhamento da imagem marca dagua no fundo do relatrio. Indica o nmero de pginas do relatrio que recebero a imagem marca dagua.

MaxPages

ParentReport PrintWidth RulerVisible ScriptDebuggerEnabled Script Language ShowParameterUI Status TocEnabled TocVisible ToolbarVisible UserData Version WaterMark WaterMarkAlignment WaterMarkPrintOnPages

Manual E3

301

WaterMarkSizeMode

Seta ou retorna o tamanho da imagem marca dagua.

Mtodos do Relatrio
MTODOS Export GetExportFilt er Print PrintPreview Query DESCRIO

Exporta os dados do relatrio para a extenso especificada. Retorna um objeto que especificou os parmetros da exportao. Imprime o relatrio. Faz uma prvia de impresso do relatrio na tela. Retorna o objeto Consulta corrente selecionado no relatrio.

Um relatrio contm um grupo de controles que so processados e impressos ao mesmo tempo, como uma simples unidade. Os relatrios so definidos pelos seguintes tipos de sees: Cabealho e rodap de pgina e Detalhes (local onde inserido o contedo do relatrio).

O relatrio contm os seguintes componentes:

302

MANUAL

E3

ELIPSE E3

1.84. Objeto Consulta


Este objeto permite que seja especificada a origem dos dados do banco de dados que ser visualizado no relatrio. Se a propriedade SourceQuery for especificada, o relatrio ir buscar os dados do banco de dados indicado. Caso contrrio, o relatrio buscar os dados da consulta padro do sistema. Para utilizar este recurso, siga os seguintes procedimentos: Aps ter criado o relatrio no projeto, o mesmo cria o objeto consulta.

Caso deseje criar uma nova consulta, clique com o boto direito do mouse sobre o relatrio e escolha a opo Consulta. Caso necessite, configure as propriedades do objeto:

Manual E3

303

Propriedades da Consulta
PROPRIEDADES DataSource Fields Name OrderBy Table Where DESCRIO

Determina a fonte de dados do relatrio (Banco de Dados). Determina os campos da tabela no relatrio. Determina o nome da consulta. Ordena os campos da tabela. Determina a tabela de contedo do relatrio. Determina quais os parmetros que sero mostrados no relatrio, conforme a condio especificada, como um filtro.

1.85. Componentes do Relatrio


Num relatrio pode existir uma seo com componentes do relatrio ou vrias sees, que so chamadas de Grupos. Um relatrio pode ter, por exemplo, uma seo de cabealho de pgina que imprime um cabealho no incio do relatrio. Isto geralmente usado para imprimir um ttulo de relatrio, uma tabela de sumrio, um chart ou qualquer informao que necessite aparecer somente uma vez no comeo do relatrio. Os componentes do relatrio so os seguintes:

1.85.1. Cabealho de Pgina (PageHeader)


O Cabealho uma rea na margem superior da pgina de um relatrio. Nele, pode-se inserir textos, grficos, nmeros, datas, etc. Atravs deste tem, possvel configurar o cabealho da pgina do relatrio.

As propriedades do rodap de pgina so as seguintes:

304

MANUAL

E3

ELIPSE E3

Propriedade do Cabealho de Pgina


PROPRIEDADES BackColor BackStyle CanGrow CanShrink Height Name Type Visible DESCRIO

Seta ou retorna a cor de fundo do objeto. Determina o estilo do cabealho: (0- Transparente 1- Normal) Determina a aplicao strech ao texto da pgina do relatrio. Determina se a altura da seo ser ajustada ao contedo Determina a altura do cabealho na pgina. Determina o nome do cabealho. Determina o tipo de cabealho na pgina e caso necessite, mud-lo para outro objeto. Determina a visibilidade do cabealho no relatrio.

1.85.2.Cabealho de Grupo (GroupFooter)


Num relatrio pode existir uma seo com componentes do relatrio ou vrias sees, que so chamadas de Grupos. Este recurso utilizado para organizar os cabealhos de pgina que so inseridos no relatrio. Esta opo est disponvel atravs do clique com o boto direito no relatrio e escolhendo a opo Insert Group Header/Footer.

As propriedades do grupo de cabealhos de pgina so as seguintes:

Manual E3

305

Propriedade do Cabealho de grupo


PROPRIEDADES BackColor BackStyle CanGrow CanShrink ColumnLayiout DataField Height IsRepeating KeepTogether Name NewColumn NewPage Type PrintAtBottom Visible DESCRIO

Determina a cor do grupo de cabealhos de pgina. Determina o estilo do objeto: 0- Transparente e 1- Normal Determina a aplicao strech ao texto no relatrio. Determina a altura da seo a ser dimensionada, para acompanhar o tamanho de seus componentes. Determina o layout da coluna. Retorna o campo dos dados do relatrio. Determina a altura do rodap no relatrio. Retorna True se a seo repetida na ltima pgina. Determina a diviso da seo do cabealho de grupo. Determina o nome do objeto. Insere uma nova quebra de coluna no objeto. Insere uma nova quebra de pgina no objeto. Determina o tipo de cabealho de grupo. Determina a rea imprimvel do cabealho de grupo. Determina a visibilidade do objeto.

1.85.3. Detalhes de Pgina (Details)


O objeto Detalhes possibilita implementar detalhes, objetos e outros componentes no contedo do relatrio.

As propriedades deste objeto so as seguintes:

306

MANUAL

E3

ELIPSE E3

Propriedade dos Detalhes de Pgina


PROPRIEDADES BackColor BackStyle CanGrow CanShrink ColumnCount ColumnDirection ColumnSpacing Height IsRepeating KeepTogether Name NewColumn NewPage Type Visible DESCRIO

Determina a cor do relatrio. Determina o estilo do relatrio: 0- Transparente 1- Normal Determina a aplicao strech ao texto da pgina do relatrio. Determina se a altura da seo ser ajustada ao contedo do relatrio. Determina o nmero de colunas utilizadas no relatrio. Determina a direo das colunas do relatrio. Determina o espaamento das colunas no relatrio. Determina a altura do relatrio. Retorna True se a seo repetida na ltima pgina do relatrio Determina se a seo pode ser dividida na pgina, caso o contedo do relatrio ultrapasse a rea destinada. Determina o nome do relatrio. Determina novas colunas no relatrio. Determina novas pginas no relatrio. Determina o tipo de cabealho na pgina e caso necessite, mud-lo para outro objeto. Determina a visibilidade do relatrio.

1.85.4. Rodap de Pgina (PageFooter)


O Rodap uma rea na margem inferior da pgina de um relatrio. Nele, pode-se inserir textos, grficos, nmeros, datas, etc. Atravs deste tem, possvel configurar o rodap da pgina do relatrio.

As propriedades do rodap de pgina so as seguintes:


Manual E3 307

Propriedade do Rodap de pgina


PROPRIEDADES BackColor BackStyle CanGrow CanShrink Height IsRepeating Name Type DESCRIO

Determina a cor do rodap. Determina o estilo do rodap. As opes disponveis so: 0- Transparente e 1- Normal Determina a aplicao strech ao texto no relatrio. Determina a altura da seo a ser dimensionada, para acompanhar o tamanho de seus componentes. Determina a altura do rodap no relatrio. Retorna True se a seo repetida na ltima pgina. Determina o nome do rodap. Determina o tipo de rodap na pgina e caso necessite, mud-lo para outro objeto. As opes disponveis so: 0- ReportHeader 1- ReportFooter 2-PageHeader 3- PageFooter 4-GroupHeader 5-GroupFooter 6-Detail Determina a visibilidade do rodap na pgina.

Visible

1.85.5.Rodap de Grupo (GroupFooter)


Num relatrio pode existir uma seo com componentes do relatrio ou vrias sees, que so chamadas de Grupos. Este recurso utilizado para organizar os rodaps que so inseridos no relatrio. Esta opo est disponvel atravs do clique com o boto direito no relatrio e escolhendo a opo Insert Group Header/Footer.

As propriedades do grupo de rodaps de pgina so as seguintes:


308
MANUAL

E3

ELIPSE E3

Propriedade do Rodap de Grupo


PROPRIEDADES BackColor BackStyle CanGrow CanShrink ColumnLayiout Height IsRepeating KeepTogether Name NewColumn NewPage Type PrintAtBottom Visible DESCRIO

Determina a cor do grupo de rodaps. Determina o estilo do objeto: 0- Transparente e 1- Normal Determina a aplicao strech ao texto no relatrio. Determina a altura da seo a ser dimensionada, para acompanhar o tamanho de seus componentes. Determina o layout da coluna. Determina a altura do rodap no relatrio. Retorna True se a seo repetida na ltima pgina. Determina a diviso da seo do rodap de grupo. Determina o nome do objeto. Insere uma nova quebra de coluna no objeto. Insere uma nova quebra de pgina no objeto. Determina o tipo de rodap de grupo da pgina. Determina a rea imprimvel do rodap de grupo. Determina a visibilidade do objeto.

1.86. Objetos do Relatrio


A ferramenta Relatrio possui vrios objetos que podem ser agregados ao mesmo, sendo acessados atravs da Barra de Ferramentas Relatrio.

Atravs da Barra de Ferramentas Relatrio, possvel acessar os recursos disponveis desta opo:

1.86.1.Prvia de Impresso (Preview)


Atravs desta opo, possvel visualizar uma prvia da impresso do relatrio. Assim possvel verificar configuraes de margem, figuras, etc.

Manual E3

309

Figura1: Prvia de impresso do relatrio

tems da prvia de impresso

310

MANUAL

E3

ELIPSE E3 CONE DESCRIO

Lista o contedo do relatrio. Imprime o relatrio, abrindo a tela de configurao de impresso. Copia o contedo selecionado. Procura o tem desejado no relatrio. Mostra as pginas disponveis no relatrio. Enquadra as pginas do relatrio para visualizao. Menos Zoom na pgina. Mais Zoom na pgina. Porcentagem de zoom na pgina.

1.86.2. Configuraes do Relatrio (Report Setting)


Atravs desta opo, possvel configurar as especificaes do relatrio. Nestas configuraes, possvel determinar Configuraes de Pgina, Configuraes de Impresso, Configuraes da Grade e Estilo do Relatrio. CONFIGURAES DE PGINA (Page especificaes referentes a pgina do relatrio. Setup): Configura as

Figura2: Configuraes do relatrio

tems da configurao do Relatrio

Manual E3

311

TEM Top Margim Bottom Margin Left Margin Right Margin Gutter Mirror Margins

CONFIGURAES DA PGINA ( PAGE SETUP) DESCRIO

Determina a margem do topo da pgina. Determina a margem do contedo da pgina. Determina a margem esquerda da pgina. Determina a margem direita da pgina. Determina a margem da pgina. Habilita/Desabilita a margem espelhada da pgina.

CONFIGURAO DE IMPRESSORA (Printer Setting): Configura as especificaes referentes a impresso do relatrio.

Figura3: Configuraes de impresso do relatrio

tems da configurao do Relatrio


312
MANUAL

E3

ELIPSE E3 CONFIGURAES DA IMPRESSORA ( PRINTER SETTING) TEM DESCRIO Paper Size Determina o tamanho do papel. Width Height Orientation

Determina a largura do papel. Determina a altura do papel. Determina a orientao do papel na impressora (Printer Default Configuraes de acordo com a impressora padro; Portait - Layout da pgina na vertical; Landscape Layout da pgina na horizontal). Ordena a impresso. Duplica a impresso. Determina as configuraes e o tipo de papel para a impresso.

Collate Duplex PaperBin

CONFIGURAES DA GRADE (Grid Settings): Determina as configuraes referentes as grades do relatrio.

Figura4: Configuraes da grade

tems da configurao do Relatrio

Manual E3

313

TEM Show Grid

CONFIGURAES DA GRADE ( GRID SETTINGS) DESCRIO

Habilita/Desabilita a grade. Habilita/Desabilita o alinhamento dos controles na grade. Determina o nmero de colunas na grade. Determina o nmero de linhas na grade. Determina o tipo de unidade da rgua (pixel ou centmetros).

Align Controls to Grid Grid Columns Grid Rows Ruler Units

CONFIGURAES DE ESTILO (Style): Determina as configuraes referentes ao estilo do relatrio.

Figura5: Configuraes de impresso do relatrio

tems da configurao do Relatrio


CONFIGURAES DE ESTILO DO RELATRIO ( STYLE) TEM DESCRIO New/Delete/Lista Determina o estilo do relatrio. Pode-se inserir um novo estilo

(atravs do boto New), deletar um estilo (atravs do boto Delete) ou utilizar os estilos existentes na lista.
Font/ Colors / Misc

Determinam as especificaes do estilo do relatrio (fontes, cores de fundo e frente, orientao, etc).

314

MANUAL

E3

ELIPSE E3

1.86.3.Editor de Scripts
Atravs desta opo, possvel editar scripts para o relatrio. No campo Object necessrio especificar o objeto que deseja criar o script e no tem Events, o evento do relatrio em que ocorrer a ao.

1.86.4.Linha
Objeto bsico de reta que liga dois pontos quaisquer. Permite o desenho de retas, atravs de dois pontos especificados na sua criao ou em polgonos. Propriedade da Linha
PROPRIEDADES LineColor LineStyle LineWeight Name Tag Visible X1 X2 Y1 Y2 DESCRIO

Determina a cor da linha. Determina o estilo da linha. Determina a largura da linha. Determina o nome da linha. Determina o tag que ser agregado a linha. Determina se a linha estar visvel ou no no relatrio. Determina as especificaes do eixo X1 da linha. Determina as especificaes do eixo X2 da linha. Determina as especificaes do eixo Y1 da linha. Determina as especificaes do eixo Y2 da linha.

Manual E3

315

1.86.5.Retngulo
Este objeto permite o desenho de retngulos, utilizando toda a largura/altura do objeto. Criado a partir de dois vrtices. Propriedade do Retngulo
PROPRIEDADES BackColor BackStyle Height Left LineColor LineStyle LineWeight Name Shape Tag Top Visible Width DESCRIO

Determina a cor do retngulo. Determina o estilo do retngulo. As opes disponveis so: 0Transparente, 1-Slido. Determina a altura do retngulo. Determina as especificaes da esquerda do retngulo. Determina a cor da linha do retngulo. Determina o estilo da linha do retngulo. Determina o tamanho da largura da linha do retngulo. Determina o nome do retngulo. Determina a forma do objeto: 0- Retngulo, 1- Elipse, 2Retngulo Arredondado. Determina o tag que ser agregado ao objeto. Determina o topo do retngulo. Determina a visibilidade do objeto. Determina a largura do objeto.

316

MANUAL

E3

ELIPSE E3

1.86.6.Retngulo Arredondado
Retngulo criado atravs de dois vrtices com a opo dos cantos serem arredondados a partir de um fator de arredondamento. Ao ser inserido ou editado, exibe um pequeno ponto prximo ao canto superior esquerdo do objeto, que permite modificar o fator de arredondamento.

Propriedade do Retngulo Arredondado


PROPRIEDADES BackColor BackStyle Height LineColor LineStyle DESCRIO

Determina a cor do retngulo arredondado. Determina o estilo do retngulo arredondado. As opes disponveis so: 0- Transparent, 1- Normal. Determina a altura do objeto. Deetrmina a cor da linha do objeto. Determina o estilo da linha do retngulo arredondado. As opes disponveis so: 0-Transparente, 1-Slido, 2- Trao, 3Ponto, 4-Trao e ponto. Determina a forma do objeto: 0- Retngulo, 1- Elipse, 2Retngulo Arredondado. Determina o tag que ser agregado ao objeto. Determina o topo do retngulo. Determina a visibilidade do objeto. Determina a largura do objeto.

Shape Tag Top Visible Width

Manual E3

317

1.86.7.Elipse
Este objeto permite o desenho de crculos e elipses, utilizando todo a largura/altura e definindo o centro do crculo no centro do retngulo. Propriedade da Elipse
PROPRIEDADES BackColor BackStyle Height LineColor LineStyle Shape Tag Top Visible Width DESCRIO

Determina a cor de frente do objeto. Determina o estilo do objeto: 0- Transparente, 1- Slido. Determina a altura da elipse. Determina a cor da linha da elipse. Determina o estilo da linha da elipse. Determina a forma do objeto: 0- Retngulo, 1- Elipse, 2Retngulo Arredondado. Determina o tag que ser agregado ao objeto. Determina o topo do objeto. Determina a visibilidade do objeto. Determina a largura do objeto.

1.86.8.Label
Possibilita de criao de um texto. Ao definir a rea na tela, podemos digitar diretamente o texto desejado, que aceita tambm mltiplas linhas. Propriedade do Label
PROPRIEDADES Alignment Angle BackColor Caption ClassName Font Hiperlink Left Style VerticalAlignment DESCRIO

Determina o alinhamento do objeto. Determina o ngulo do objeto. Determina a cor do objeto. Determina o texto que ser visualizado e atribudo ao objeto. Determina o nome da classe do objeto. Determina a fonte do objeto. Determina o link que ser atribudo ao objeto. Determina as especificaes a esquerda do objeto. Determina o estilo do objeto. Determina o alinhamento vertical do objeto.

318

MANUAL

E3

ELIPSE E3

1.86.9. Figura
Este objeto permite mostrar imagens que estejam armazenadas em arquivos, estejam eles dentro ou fora do arquivo do aplicativo. Propriedade da Figura
PROPRIEDADES BackColor BackStyle DataField Forecolor Hiperlink Height Left LineColor LineStyle DESCRIO

Determina a cor do objeto. Determina o estilo da figura. As opes disponveis so: 0Transparente, 1- Slido. Retorna o campo dos dados do relatrio. Determina a cor de frente da figura. Determina as especificaes do hiperlink. Determina a altura do objeto. Determina as especificaes da esquerda do retngulo. Determina a cor da linha da figura. Determina o estilo da linha da figura: As opes disponveis so: 0-Transparente, 1-Slido, 2- Trao, 3- Ponto, 4-Trao e ponto. Determina a largura da linha do objeto. Determina o nome do objeto. Determina a figura do objeto. Determina o alinhamento da figura. Determina o tamanho da figura. Determina o tag que ser agregado ao tag. Determina o topo do objeto. Determina a visibilidade da figura. Determina a largura do objeto.

LineWeight Name Picture PictureAlignment SizeMode Tag Top Visible Width

1.86.10. Campo
Atravs do objeto Campo, possvel associar um campo da tabela no banco de dados. Este campo especificado na propriedade DataField.
Manual E3 319

Propriedade do Campo
PROPRIEDADES Alignment BackColor BackStyle CanGrow CanShrink Classname DataField Font Forecolor Height Hiperlink Left Multline Name OutPutFormat Style SumaryDistinctFie ld SumaryFunc SumaryGroup SumaryRunning SumaryType Tag Text Top VerticalAligment Visible Width DESCRIO

Determina o alinhamento do objeto. Determina a cor do objeto. Determina o estilo do objeto. Determina a aplicao strech ao texto no relatrio. Determina se a altura da seo ser ajustada ao contedo no relatrio. Determina o nome da classe do objeto. Retona o campo dos dados do relatrio. Determina a fonte do objeto. Determina a cor de de frente do objeto. Determina a altura do objeto. Determina as especificaes referentes ao hiperlink do objeto. Determina as especificaes da esquerda do objeto. Determina se o objeto vai ter mltiplas linhas. Determina o nome do objeto. Seta ou retorna o string usado para formatao do texto. Determina o estilo do objeto. Determina o nome do campo usado no sumrio. Seta o tipo de sumrio usado na propriedade DataField. Determina o sumrio do grupo de cabealho de pgina. Determina se a customizao do sumrio acumulativa ou por nveis. Determina o tipo de sumrio da pgina. Determina o tag que ser agregado ao objeto. Determina o texto no objeto. Determina o topo do objeto. Determina o alinhamento vertical do objeto. Determina a visibilidade do objeto. Determina a largura do objeto.

320

MANUAL

E3

ELIPSE E3

1.86.11. Cdigo de Barras


O Cdigo de Barras uma representao numrica ou alfanumrica, utilizada em vrias aplicaes, decifrada atravs de scanners, canetas e equipamentos de leitura ptica, para um determinado fim. uma sequncia de linhas verticais, em que toda a informao que caracteriza o tem em questo esto contidas nas larguras das barras, nas larguras dos espaos, ou em ambas. Num sistema de cdigo de barras, a sequncia de nmeros obtida pelo equipamento de leitura ptica automaticamente inserido num sistema computacional que processar a informao, evitando que o operador tenha que digitar o cdigo manualmente, acelerando assim um processo de consulta, por exemplo. Propriedade de Cdigo de Barras
PROPRIEDADES Alignment BackColor BarWidth Caption CaptionPosition Direction Font ForeColor Height Left Name Style Tag Top Visible Width DESCRIO

Determina o alinhamento do objeto no relatrio. Determina a cor do objeto. Determina a largura do objeto. Determina o contedo que ser inserido no objeto. Determina a posio do texto no objeto. Determina a direo do cdigo de barras. Determina a fonte do objeto. Determina a cor de frente do objeto. Determina a altura do objeto. Determina as especificaes da esquerda doobjeto. Determina o nome do objeto. Determina o estilo do objeto. Determina o tag que ser associado ao tag. Determina as especificaes do topo do objeto. Determina a visibilidade do objeto. Determina a largura do objeto.

1.86.12. Quebra de pgina


Uma Quebra de pgina o ponto em que uma pgina termina e a outra comea no relatrio. Se voc insere suas prprias quebras de pgina para que as informaes sejam iniciadas forosamente em um novo relatrio, adicione quebras de pgina
Manual E3 321

manuais (ou foradas). Ocasionalmente voc poder encontrar uma quebra de pgina manual indesejada no documento. As quebras de pgina automticas contm apenas a linha pontilhada e s podero ser vistas no modo de exibio Normal e as quebras de pgina manuais incluem a expresso "Quebra de pgina" no centro da linha pontilhada e podem ser vistas nos modos de exibio Normal e Layout de impresso. Propriedade da Quebra de pgina
PROPRIEDADES Enabled CanGrow CanShrink CloseBorder Height Left Tag Top Visible Width DESCRIO

Habilita o objeto. Determina a aplicao strech ao texto no relatrio. Determina se a altura da seo ser ajustada ao contedo no relatrio. Determina o fechamento da borda do objeto. Determina a altura do objeto. Determina as especificaes da esquerda do objeto. Determina o tag que ser associado ao objeto. Determina o topo do objeto. Determina a visibilidade do objeto. Determina a largura do objeto.

1.86.13. Tabela
Uma tabela um objeto composto das linhas e das colunas pelas quais so inseridos textos e/ou grficos.
322
MANUAL

E3

ELIPSE E3

As tabelas nos relatrios so usadas para organizar e apresentar a informao.

Voc pode tambm usar tabelas criar disposies de pgina, ou criar o texto, grficos e tabelas animadas como em uma pgina html. As propriedades disponveis so as seguintes:

Propriedade da Quebra de pgina


PROPRIEDADES BackColor CanGrow CloseBorder Height Left Name Top Visible Width DESCRIO

Determina a cor do objeto. Determina a aplicao strech ao texto no relatrio. Determina o fechamento da borda do objeto. Determina a altura do objeto. Determina as especificaes da esquerda doobjeto. Determina o nome do objeto. Determina o topo do objeto. Determina a visibilidade do objeto. Determina a largura do objeto.

1.86.14. E3Chart
Este objeto utilizado para visualizar os dados do relatrio em formato grfico. Para tanto, basta utilizar os mesmos recursos do E3Chart, descritos no captulo E3Chart.
Manual E3 323

1.86.15. Enviar para frente / Enviar para trs


Atravs deste tpico, possvel enviar um objeto para frente ou para trs do relatrio. Ao escolher as opes Enviar para frente ou Enviar para trs, o objeto selecionado ser colocado na primeira ou ltima posio na ordem de sobreposies. Para maiores informaes referentes a este tem, verifique o tpico Sobreposio de objetos, descrito anteriormente.

1.87. Exemplos de utilizao dos Relatrios


Abaixo segue alguns exemplos de utilizao dos recursos dos Relatrios:
324
MANUAL

E3

ELIPSE E3

Setando o caminho de um bitmap na hora de imprimir um relatrio: Para utilizar este recurso, escreva o seguinte script no evento OnFormat dos objetos Cabealho de pgina (PageHeader) ou cabealho do relatrio (ReportHeader):
Sub OnFormat Report.Sections(ReportHeader).Controls(Image2).Picture = LoadPicture (C:\correio\teste.bmp) End Sub

Utilizando um E3Chart dentro de um relatrio: Para utilizar este recurso, chame o mtodo LoadData () do E3Chart no evento OnFormat na seo que contm o grfico:
Sub OnFormat Report.Sections(ReportHeader).Controls(E3Chart1).LoadData() End Sub

Setando o valor de um objeto Cdigo de Barras (BarCode) dentro da seo Detalhes Para utilizar este recurso, escreva o script no evento OnFormat da seo Detalhes:
Sub OnFormat Report.Sections(Detail).Controls(BarCode1).Caption = Right (Report.Field (E3TimeStamp), 8) End Sub

Capturando uma tela e gerando uma prvia de impresso Para utilizar este recurso, escreva o seguinte script:
Sub Rect_Click() Manual E3 325

Screen.CaptureScreen(C:\correio\teste.bmp) Application.LoadReport([Relatrio3]).PrintPreview() End Sub

Gerando um Menu que permite exportar um relatrio Para utilizar este recurso, escreva o seguinte script:
Sub [Retngulo3_Click]() Set report = Application.LoadReport([Relatrio3]) Select case Application.SelectMenu(PDF|Excel|HTML|RTF|Texto|TIFF|Texto(CSV)) Case 1 Report.Export PDF, C:\correio\reports\report.pdf MsgBox Exportado para PDF! Case 2 Case 3 Case 4 Case 5 Case 6 Case 7 Report.Export EXCEL, C:\correio\reports\report.XLS MsgBox Exportado para XLS! Report.Export HTML, C:\correio\reports\report.html MsgBox Exportado para HTML! Report.Export RTF, C:\correio\reports\report.rtf MsgBox Exportado para RTF! Report.Export TEXT, C:\correio\reports\report.txt MsgBox Exportado para XLS! Report.Export TIFF, C:\correio\reports\report.tiff MsgBox Exportado para TIFF!

Set reportFilter = report.GetExportFilter(TEXT) reportFilter.FileName=C:\correio\reports\report2.txt reportFilter.TextDelimiter=, report.Export reportFilter MsgBox Exportado para TXT usando filtro! End Select End Sub

326

MANUAL

E3

ELIPSE E3

Como Criar Relatrios mostrando "Pgina N de M" Para criar um relatrio que a cada pgina imprime um indicativo de "Pgina N de M" onde N a pgina atual e M o total de pginas, crie dois Labels e dois Campos. Os dois Labels correspondem aos textos "Pgina" e "de", que devem ser inseridos na propriedade Caption. Os dois campos correspondem aos valores N e M, com as seguintes propriedades: Campo N: Name: txtPageNumber SummaryGroup: GroupHeader1 SummaryRunning: 1-ddSRGroup SummaryType: 4-ddSMPageCount

Campo M Name: txtPageCount SummaryGroup: GroupHeader1 SummaryType: 4-ddSMPageCount

Como criar Relatrios imprimindo somente mdias de valores a cada 5 minutos Para isso devemos criar um novo Grupo no Relatrio. O Grupo criado tem um Header e um Footer. Layout geral :
PageHeader: Contm GroupHeader:

o titulo das Colunas

Fica vazio, porm a sua propriedade DataField tem o valor: =CLng(E3TimeStamp*288), isso porque o E3TimeStamp a data/hora do dado no formato gregoriano (dias desde 1/1/1900), sendo a parte inteira o numero de dias e a parte fracionaria as horas e minutos. Multiplicando por 288 teremos um numero inteiro correspondente ao total de 5 minutos desde 1/1/1900. A funo CLng converte para um nmero inteiro de 32 bits eliminando a parte fracionria, de modo que no apaream os minutos e segundos intermedirios. O Grupo criado vai ser impresso cada vez que esse numero inteiro mudar, ou seja, a cada cinco minutos. Verifique as propriedades NewColumn e NewPage, que devem estar em 0 - ddNPNone .

Manual E3

327

2 1

Captulo

21.
Detail:

Ajuda e Suporte Tcnico

Contm os DataFields para os campos da tabela. A propriedade visible estar em false, de modo que cada uma das aquisies que comporo a mdia de 5 minutos sero computadas porm no impressas.
GroupFooter:

Contm campos que representam as mdias dos campos. Para

isso: DataField: Nomes dos Campos da Tabela ( o mesmo que na seo de detalhe) SummaryFunc: 1 ddSFAvg SummaryRunning: 1 ddSRGroup SummaryType: 1 - ddSGrandTotal

A nica exceo para a Data/Hora que ser um campo padro com a propriedade DataField "=CLng(E3TimeStamp*288)/288".
ReportFooter: Em

Branco (ou como quiser)

Se a consulta for entre 0:00 de um dia e outro, o resultado sero 288 linhas impressas com a mdia dos campos a cada 5 minutos.

A Elipse Software possui diversas formas para ajudar a responder as suas dvidas. Fontes de documentao incluem o Help on-line, o manual do usurio, notas tcnicas e um site na Internet (www.elipse.com.br) onde podem ser encontradas as mais diversas informaes inclusive downloads das verses mais atualizadas.

328

MANUAL

E3

ELIPSE E3

1.88. Opes de ajuda no sistema


O E3 Studio dispe de vrios tipos de Ajuda, pela qual o usurio pode verificar tens do sistema. Dentre estas opes esto: Vbscript Help (Guia de referncia), Manual, Tutorial e Help do sistema (Guia de referncia).

1.88.1.VBScriptHelp
Atravs desta opo, possvel dispor da Ajuda do VBScript, pela qual contm informaes sobre o VB Script. Para dispor deste recurso, basta acess-lo atravs do grupo de programas criado do E3, selecionar a opo Manuais Guia de referncia do VBScript.

1.88.2.Manual de Instrues
Atravs do manual de instrues do E3 Studio, possvel verificar todos os recursos disponveis do sistema. O manual vem no Kit do sistema, e tambm est disponvel virtualmente no Grupo do E3 Studio. Para acess-lo, basta clicar no grupo de programas do E3 Manuais Manual; O manual do sistema em extenso DOC ser aberto no sistema. Este material pode ser atualizado no site da pgina.

Manual E3

329

1.88.3.Ajuda On-Line (Guia de Referncias)


Atravs desta opo, possvel acionar a Ajuda do sistema tendo ou no o E3 aberto. Nesta opo possvel uma descrio detalhada das propriedades e mtodos do E3, assim como demais informaes. A Ajuda tambm pode ser aberta no sistema, atravs do boto F1 ou no menu Ajuda, pela qual contm as demais opes deste tpico (Contedo, Procurar, ndice, Suporte Tcnico e Sobre o E3). Para dispor deste recurso, basta acess-lo atravs do grupo de programas criado do E3, selecionar a opo Manuais Guia de Referncia, conforme figura demostrativa abaixo:

330

MANUAL

E3

ELIPSE E3

As opes disponveis nesta opo so as seguintes: Contedo: Mostra o contedo da Ajuda do sistema. Procurar: Procura o tem especificado na Ajuda e mostra as opes disponveis. ndice: Faz a procura na Ajuda atravs do ndice. Suporte Tcnico: Abre uma caixa de e-mail, para que seja enviado um e-mail para o suporte tcnico da elipse. Veja mais detalhes em SUPORTE TCNICO. Sobre o E3: Traz informaes referentes ao E3 Studio, e mostra a verso do sistema.

Manual E3

331

1.89. Dvidas mais Frequentes


Neste tem voc encontrar informaes, dicas e outras especificaes sobre o sistema: Alarmes 1. Quais so e como funcionam os tipos de alarmes do E3? O E3 prov mtodos para realizar a especificao e gerenciamento de alarmes e eventos de variveis de um processo. Qualquer varivel ou propriedade pode ser verificada em relao ao acontecimento de condies especiais.Existem quatro tipos de alarmes: Alarme Analgico: Permite monitorar uma varivel analgica, pela especificao de at 4 nveis de alarmes que so: LOLO (Muito Baixo), LO (Baixo), HI (Alto) e HIHI (Muito Alto). Alarme Banda Morta: Utilizado para controlar uma varivel dentro de uma faixa especfica de valores. especificado um valor de setpoint e uma banda morta, que ser quantas unidades este valor poder alterar acima ou abaixo do setpoint. Por exemplo, um controle de temperaturas, onde a temperatura ambiente dever ficar em 22 C, podendo variar at 2 graus acima ou abaixo: Valor do setpoint: 22 Banda Morta : 2 Ento o Alarme pode variar de (22-2)=20 at (22+2)=24, assim se houver uma variao entre 20 e 24 no ativar o alarme, caso o valor do tag saia desta faixa de valores, o alarme estar ativo. Alarme Digital: Permite que se controle quando uma varivel atingir um valor especfico. Possibilita, por exemplo, que se monitore uma varivel digital, na borda de subida (em 1 ou TRUE) ou borda de descida (em 0 ou FALSE). Tambm podese controlar variveis string. Por exemplo, quando determinado tag tiver o valor "Erro" ativar o alarme. Alarme Taxa de Variao: utilizado para monitorar variaes muito rpidas em uma varivel de processo. Exemplo: Este alarme funciona da seguinte forma : se h variao muito rpida em uma tag, por exemplo, e se esta variao deste tag for de 3 em 3 segundos divide esta variao por 3 para deixar em 1 segundo faz um comparativo desta variao com o valor setado na configurao da "variao do alarme" e se esta variao da tag for maior do que o valor setado, ento estado de alarme.Este alarme destinado a aplicaes de medida de vazo, de presso ou aplicaes onde h uma grande variao nas unidades ou medidas.
332
MANUAL

E3

ELIPSE E3

2. Como fao para acessar em tempo de execuo as propriedades de uma alarme? O E3 possui uma funo para acesso as propriedades dos objetos alarmes chamada GetAlarm(). Utilize o mtodo GetAlarm para verificar ou modificar em execuo as propriedades de uma determinada fonte de alarme atravs do uso de um script. O objeto Fonte de Alarme pode ser qualquer um dos quatro tipos disponveis (Analgico, Digital, Taxa de Variao e BandaMorta ). A depender do tipo de Fonte de Alarme, a funo retornar as seguintes propriedades: Objeto AnalogLevelAlarm: Responsvel pela definio de alarme de nveis. Propriedades deste objeto (tem 4 nveis de alarme): LevelDeadBand - banda morta para o alarme de nveis LevelReturnMessage - mensagem de retorno de alarme LoLoLimit - Limite para o nvel de alarme BaixoBaixo LoLoMessage - o da mensagem de alarme BaixoBaixo LoLoSeverity - Importncia do nvel de alarme BaixoBaixo. Conjunto de valores: 0 - Alta, 1 - Mdia, 2 Baixa LoLoAckRequired - Se este nvel de alarme BaixoBaixo necessita reconhecimento LoLoLink - link de ajuda para o nvel de alarme BaixoBaixo Lo - Habilita/Desabilita a verificao de alarme Baixo LoLimit - Limite para o nvel de alarme Baixo LoMessage - o da mensagem de alarme Baixo LoSeverity - Importncia do nvel de alarme Baixo. Conjunto de valores: 0 - Alta, 1 - Mdia, 2 Baixa LoAckRequired - Se este nvel de alarme Baixo necessita reconhecimento LoLink - link de ajuda para o nvel de alarme Baixo Hi - Habilita/Desabilita a verificao de alarme Alto

Manual E3

333

HiLimit - Limite para o nvel de alarme Alto HiMessage - o da mensagem de alarme Alto HiSeverity - Importncia do nvel de alarme Alto. Conjunto de valores: 0 - Alta, 1 Mdia, 2 Baixa HiAckRequired - Se este nvel de alarme Alto necessita reconhecimento HiLink - link de ajuda para o nvel de alarme Alto HiHi - Habilita/Desabilita a verificao de alarme AltoAlto HiHiLimit - Limite para o nvel de alarme AltoAlto HiHiMessage - o da mensagem de alarme AltoAlto HiHiSeverity - Importncia do nvel de alarme AltoAlto. Conjunto de valores: 0 Alta, 1 - Mdia, 2 Baixa HiHiAckRequired - Se este nvel de alarme AltoAlto necessita reconhecimento HiHiLink - link de ajuda para o nvel de alarme AltoAlto

Objeto DigitalAlarm: Responsvel por configuraes de alarme digital. Propriedades deste objeto: DigitalReturnMessage - mensagem de retorno de alarme digital Digital - Habilita/Desabilita a verificao de alarme digital DigitalLimit - Limite para o alarme digital DigitalMessage - o da mensagem de alarme digital DigitalSeverity - Importncia do alarme digital. Conjunto de valores: 0 - Alta, 1 Mdia, 2 Baixa DigitalAckRequired - Se este alarme digital necessita reconhecimento DigitalLink - link de ajuda para o nvel de alarme digital

334

MANUAL

E3

ELIPSE E3

Objeto ROCAlarm: Responsvel por configuraes de alarme de taxa de mudana. Propriedades deste objeto: ROCReturnMessage - Mensagem de retorno de alarme de taxa de mudana ROC - Habilita/Desabilita a verificao de alarme de taxa de mudana ROCLimit - Limite para o alarme de taxa de mudana. Para o alarme ocorrer, basta que o valor do tag associado ultrapasse esse valor em um segundo. ROCMessage - Mensagem de alarme de taxa de mudana ROCSeverity - Importncia do alarme de taxa de mudana. Conjunto de valores: 0 Alta, 1 - Mdia, 2 Baixa ROCAckRequired - Se este alarme de taxa de mudana necessita reconhecimento ROCLink - Link de ajuda para o nvel de alarme de taxa de mudana

Objeto DeadBandAlarm: Responsvel por configuraes de alarme de banda morta. Propriedades deste objeto: DeadBandSetpoint - Limite de banda morta do alarme. Cada vez que o valor do tag associado ultrapassadar o valor desta propriedade + ou - o valor de deadBandLimit, o alarme ocorrer. DeadBandReturnMessage - Mensagem de retorno de alarme de banda morta DeadBand - Habilita/Desabilita a verificao de alarme de banda morta DeadBandLimit - Limite para o alarme de banda morta. DeadBandMessage - Mensagem de alarme de banda morta DeadBandSeverity - Importncia do alarme de banda morta. Conjunto de valores: 0 - Alta, 1 - Mdia, 2 Baixa DeadBandAckRequired - Se este alarme de banda morta necessita reconhecimento DeadBandLink - link de ajuda para o nvel de alarme de banda morta

Manual E3

335

Exemplo:
Sub Botao1_Click() Dim val 'Quando clica no botao muda o nivel de alarme Lo do AlarmSource BatteryLevel Application.GetObject("ConfigAlarmes1.Area1.BatteryLevel").Ge tAlarm().LoLimit = 10 End Sub

DBServer 1. O que e para que serve um Servidor de Banco de Dados? Um DBServer, ou Servidor de Banco de Dados, o tem do aplicativo que ir concentrar todas as gravaes e consultas de dados em disco do projeto. Ele ser o tem responsvel por passar a disco todos os dados vindos de Alarmes, Histricos e Frmulas, assim como tambm ser responsvel pela visualizao destes dados. Frmulas 1. O que so e para que servem as Frmulas no E3? Este recurso serve para armazenar e transferir um conjunto de valores para um conjunto de variveis. similar as receitas do Elipse SCADA. Abaixo alguns conceitos: Templates: so os campos da frmula, podem possuir algum tipo de restrio. Unidades: so os conjuntos de variveis ligadas aos campos. Valores: so os conjuntos de valores que sero transferidos para as unidades. Para inserir o mdulo Frmula execute os seguintes passos: Clique com o boto direito do mouse no projeto, em "Inserir", selecione o tem "Frmula"; este ser adicionado dentro do projeto. D um duplo clique em frmula, ser aberto um Wizard para a configurao do mesmo. Nesta primeira janela digite o nome da tabela onde sero armazenados os dados da frmula e selecione o servidor de banco de dados. Crie os templates e configure o nome,tipo do campo e restries para cada template. Na janela de restries poder ser configurado o tipo de limites para cada campo. Passe para a prxima. Crie as unidades e configure as variveis de cada campo para cada unidade.

336

MANUAL

E3

ELIPSE E3

Criar os Conjuntos de Valores e configurar o valor de cada campo em cada conjunto. Agora a frmula est configurada e pronta para ser utilizada. 2. Qual a funo que carrega um conjunto de valor em uma unidade? Estas so as funes disponveis para este fim: objeto.LoadFormulaDlg(bstrformulaName) - carrega um conjunto de valor em uma unidade, onde bstrformulaName o nome do mdulo dentro do projeto e objeto um objeto do tipo Viewer. Quando executada ela abre uma janela para ser selecionado um conjunto de valor e uma unidade, e tambm possibilita a mudana dos valores a serem carregados. Exemplo: Application.LoadFormulaDlg "Formula1" objeto.LoadFormulaValues bstrformulaName, bstrunitName, bstrvalueName carrega o conjunto de valor especificado(Ex.: Valor 1 ) na unidade especificada(Ex.: Unidade 1). Mostrando a janela para modificar os valores a serem carregados. Exemplo:Application.LoadFormulaValues "Formula1", Unidade 1, Valor 1 objeto.LoadFormulaValuesQuiet bstrformulaName, bstrunitName, bstrvalueName - carrega o conjunto de valor especificado(Ex.: Valor 1 ) na unidade especificada(Ex.: Unidade 1), porm, no mostra a janela para modificar os valores a serem carregados. Exemplo: Application.LoadFormulaValuesQuiet "Formula1", Unidade 1, Valor 1 3. Como criar uma unidade ou conjunto de valor em tempo de execuo? Deve-se utilizar as seguintes funes: objeto.CreateUnit bstrunitName cria uma nova unidade(Ex.: Unidade 4), onde objeto o mdulo(Ex.: Formula1) onde ser criado o novo conjunto. Exemplo: Application.GetObject("Formula1").CreateUnit Unidade 4 objeto.CreateValue bstrvalueName cria um novo conjunto de valor(Ex.: Valor 5), onde objeto o mdulo(Ex.: Formula1) onde ser criado o novo conjunto. Exemplo: Application.GetObject("Formula1").CreateValue Valor 5 4. Como modificar os valores de um determinado conjunto de valor em tempo de execuo? Deve utilizar a seguinte funo: objeto.SetValueData bstrValueName, bstrTemplateName, bstrData - atualiza o template (Ex.: Campo 1) de um determinado conjunto de valores (Ex.: Valor 1) com um determinado valor (Ex.: 10). Onde objeto o mdulo que contm o conjunto de valor.

Manual E3

337

Exemplo: Application.GetObject("Formula1").SetValueData Valor 1, Campo 1, 10 5. Como deletar um conjunto de valor em tempo de execuo? Deve-se utilizar a seguinte funo: objeto.DeleteValue bstrvalueName deleta o conjunto de valor especificado na funo (Ex.: Valor 1), onde objeto o mdulo(Ex.: Formula1) que contm o conjunto Exemplo: Application.GetObject("Formula1").DeleteValue Valor 1 Histricos 1. Como criar um histrico? Em primeiro lugar necessrio ter um DBServer no domnio, caso ainda no exista nenhum, pode-se adicionar um novo com um clique do boto direito sobre o projeto, selecionar a opo Inserir - Banco de dados. O Banco de dados dever estar configurado para acessar uma base de dados vlida. Aps a verificao do DBServer, vamos inserir um novo histrico no projeto seguindo os mesmos passos do DBServer, clique do boto direito sobre o projeto, Inserir - > Histrico. Ser criado um item com o nome de Hist1 e ser exibida uma janela de configurao do histrico. Na janela de configurao iremos criar os campos do histrico e configurar como o mesmo ser salvo. Clicando sobre o cone podero ser adicionados novos campos para o histrico, definindo as colunas de sua tabela. Este campos criados sero associados a tags ou propriedades do projeto. Para fazer esta associao basta clicar sobre o boto com os "3 pontos" (...) e na janela do App Browser escolher os tags desejados. Para cada campo, dever ser selecionado o tipo de dado equivalente ao dado que a fonte conter. Os tipos possveis so: fdTExt =Texto fdInteger = Inteiros fdDouble = valores fracionais fdDateTime = Data e Hora

338

MANUAL

E3

ELIPSE E3

Sendo que para os campos de tipo texto deve-se selecionar tambm o tamanho do campo em caracteres. Aps selecionar as fontes de dados e os tipos de dados, clique no boto de propriedades da tabela .

No primeiro campo, deve ser configurado o nome do servidor de banco de dados utilizado pelo histrico. Aps deve ser escolhido um nome para a tabela onde sero salvos os dados e o tempo de escrita para este histrico. Este tempo em milisegundos, e se for deixado em zero, desabilitar a escrita automtica do histrico, ficando obrigatria a gravao por eventos. No quadro Avanado, configurada a quantidade de dados que sero mantidos em disco. Pode-se, por exemplo, configurar um histrico para manter em disco todos os dados do ltimo ms, na troca de ms, descartar todos os dados antigos e iniciar uma nova tabela. Para isto basta selecionar a quantidade de dados que ter uma tabela (1 hora, 1 dia, 1 ms, etc) e o nmero de tabelas a serem mantidas em disco. Com isto podemos ainda ter 1 tabela por ms e ter em disco armazenadas as ltimas 12 tabelas por exemplo. Feita esta configurao clique em OK. Na janela principal, clique sobre o

cone , o qual ir criar a estrutura de dados no histrico. Feito isto o histrico estar pronto para gravao de dados, caso tenha sido escolhida a opo de gravao por evento, basta selecionar o evento desejado e inserir a seguinte linha de cdigo: Application.GetObject("Hist1").WriteRecord Fui inserir um ActiveX na minha tela e ocorreu um erro 80040112. O que isto significa? Este erro indica que o ActiveX a ser inserido no est licenciado em sua mquina. Durante o instanciamento, o controle procura no registro por sua chave de licena (HKEY_CLASSES_ROOT\Licenses) e caso no a encontre retorna este erro. Existem chaves de licena para objetos ActiveX tanto para ambientes de desenvolvimento quanto para runtime. Para resolver este problema, voc tem que adquirir a licena deste ActiveX e registr-lo em seu micro.

Manual E3

339

1.90. Suporte Tcnico


VERIFIQUE A DOCUMENTAO DO PRODUTO Esta uma das formas mais produtivas para encontrar as respostas s suas questes. Voc pode consultar a seguinte documentao: Help On-line. Inclui informaes de procedimentos e referncia a respeito das principais caractersticas, funes e mensagens de erro. Voc pode acessar a Ajuda atravs do menu Ajuda, ou pressionando F1 em um tpico ou janela em que voc deseja as informaes. Manual do Usurio, que fornecido em formato eletrnico no CD de instalao do software.

REPRODUZA O PROBLEMA Reproduzir o problema o primeiro passo para resolv-lo. Uma vez que voc consiga reproduzi-lo, pode comear a encontrar solues. As seguintes questes podem ajudar a especificar melhor o problema: O problema ocorre com apenas uma aplicao? Voc deve tentar outra aplicao para ver se consegue reproduzir o problema com ela. Se voc no consegue reproduzir o problema com outras aplicaes, pense no que h de especifico na aplicao em que o problema se manifesta. O problema ocorre apenas na sua mquina? Se ocorrer, pode estar relacionado configurao do seu sistema. Tente usar um driver de vdeo diferente ou modificar a configurao do seu sistema para ver se o problema ainda persiste. Uma boa idia tentar fazer com que a sua mquina no possua configuraes muito diferentes das da mdia. Qual a verso do E3 Studio que voc est usando? Voc pode verificar a verso do software usando o comando Sobre no menu Ajuda. Aplicaes geradas em verses anteriores so totalmente compatveis, entretanto aplicaes geradas em verses mais novas no podem ser editadas ou executadas em verses anteriores. Sob que circunstncias o problema ocorre? A quantidade de memria disponvel afeta o problema? E os outros programas que esto executando no sistema? Existe espao suficiente em disco?

340

MANUAL

E3

ELIPSE E3

ISOLE O PROBLEMA Depois de verificar sob que circunstncia ocorre o problema, voc tem mais subsdios para tentar isol-lo. Uma vez isolado o problema muito mais fcil e rpido encontrar solues. Tente isolar o componente que est causando o problema. Voc pode usar as informaes a respeito de que condies ele produz para ajudar a isol-lo. Se o problema ocorre com um Script, voc pode tentar criar um pequeno exemplo e se ele muito grande, tente dividi-lo e execut-lo passo a passo.

1.90.1.Servios de Suporte
No Brasil, os seguintes servios de suporte esto disponveis: Servios Eletrnicos Estes servios esto disponveis 24 horas por dia, 7 dias por semana, incluindo feriados. Internet: Voc pode enviar um e-mail para Porto Alegre - RS (suporte@elipse.com.br), So Paulo - SP (suporte-sp@elipse.com.br) ou Curitiba PR (suporte-pr@elipse.com.br); Assunto: "Suporte". Voc tambm pode acessar a Home Page da Elipse, onde pode obter as ltimas informaes sobre o Elipse Windows, bem como a ltima verso do software e da Ajuda (www.elipse.com.br). Suporte por Fax O servio de Fax um meio fcil e rpido de resolver seus problemas. Tente descrever seu problema e suas conseqncias passo a passo. Seu fax deve conter as seguintes informaes:
Manual E3

A verso do E3 que voc esta usando; O nmero da sua licena de uso; A configurao do seu hardware (CPU, Memria, Rede, etc.); Seu Sistema Operacional, cdigo de Release e/ou Service Pack; A mensagem de erro que aparece (se houver); Seu nome, empresa e telefone/fax.
341

Para enviar um fax ligue para:


Porto Alegre: (0XX51) 3222-6226 So Paulo: (0XX11) 3061-2828 Curitiba: (0XX41) 342-0120

Suporte por telefone O suporte por telefone est disponvel das 9:00 AM at 6:00 PM, de segunda a sexta. Quando quiser usar este servio, deve ter seu computador por perto e executando o E3. Voc precisa tambm, de toda a documentao disponvel e as seguintes informaes: A verso do Elipse E3 que voc esta usando; O nmero da sua licena de uso; A configurao do seu hardware (CPU, Memria, Rede, etc.); Seu Sistema Operacional, cdigo de Release e/ou Service Pack; A mensagem de erro que aparece (se houver); Seu nome, empresa e telefone/fax; Uma descrio resumida do problema e suas circunstncias; Uma descrio resumida de como voc est tentando resolver o problema.

Ligue para:
Porto Alegre: (0XX51) 3346-4699 So Paulo: (0XX11) 3061-2828 Curitiba: (0XX41) 342-0120.

Atualizado em 01/02/2003

342

MANUAL

E3