Mu 224000

Manual de Utilizao Srie BluePlant
Rev. A 12/2013 Cd. Doc.: MU224000
Condies Gerais de Fornecimento Nenhuma parte deste documento pode ser copiada ou reproduzida sem o consentimento prvio e por escrito da Altus Sistemas de Automao S.A., que se reserva o direito de efetuar alteraes sem prvio comunicado. Conforme o Cdigo de Defesa do Consumidor vigente no Brasil, informamos, a seguir, aos clientes que utilizam nossos produtos aspectos relacionados com a segurana de pessoas e instalaes. Os equipamentos de automao industrial fabricados pela Altus so robustos e confiveis devido ao rgido controle de qualidade a que so submetidos. No entanto, equipamentos eletrnicos de controle industrial (controladores programveis, comandos numricos, etc.) podem causar danos s mquinas ou processos por eles controlados em caso de defeito em suas partes e peas ou de erros de programao ou instalao, podendo inclusive colocar em risco vidas humanas. O usurio deve analisar as possveis consequncias destes defeitos e providenciar instalaes adicionais externas de segurana que, em caso de necessidade, sirvam para preservar a segurana do sistema, principalmente nos casos da instalao inicial e de testes. Os equipamentos fabricados pela Altus no trazem riscos ambientais diretos, no emitindo nenhum tipo de poluente durante sua utilizao. No entanto, no que se refere ao descarte dos equipamentos, importante salientar que quaisquer componentes eletrnicos incorporados em produtos contm materiais nocivos natureza quando descartados de forma inadequada. Recomenda-se, portanto, que quando da inutilizao deste tipo de produto, o mesmo seja encaminhado para usinas de reciclagem que deem o devido tratamento para os resduos. imprescindvel a leitura completa dos manuais e/ou caractersticas tcnicas do produto antes da instalao ou utilizao do mesmo. Os exemplos e figuras deste documento so apresentados apenas para fins ilustrativos. Devido s possveis atualizaes e melhorias que os produtos possam incorrer, a Altus no assume a responsabilidade pelo uso destes exemplos e figuras em aplicaes reais. Os mesmos devem ser utilizados apenas para auxiliar na familiarizao e treinamento do usurio com os produtos e suas caractersticas. A Altus garante os seus equipamentos conforme descrito nas Condies Gerais de Fornecimento, anexada s propostas comerciais. A Altus garante que seus equipamentos funcionam de acordo com as descries contidas explicitamente em seus manuais e/ou caractersticas tcnicas, no garantindo a satisfao de algum tipo particular de aplicao dos equipamentos. A Altus desconsiderar qualquer outra garantia, direta ou implcita, principalmente quando se tratar de fornecimento de terceiros. Os pedidos de informaes adicionais sobre o fornecimento e/ou caractersticas dos equipamentos e servios Altus devem ser feitos por escrito. A Altus no se responsabiliza por informaes fornecidas sobre seus equipamentos sem registro formal. DIREITOS AUTORAIS Nexto, Srie Ponto, MasterTool, Grano, WebPLC e BluePlant so marcas registradas da Altus Sistemas de Automao S.A. Windows, Windows NT e Windows Vista so marcas registradas da Microsoft Corporation.
Sumrio
Sumrio
1. SUPORTE TCNICO BLUEPLANT ............................................................................................................. 1 Introduo ao BluePlant ................................................................................................................................... 1 Documentos Relacionados a este Manual........................................................................................................ 1 Inspeo Visual .................................................................................................................................................. 2 Suporte Tcnico ................................................................................................................................................. 2 Mensagens de Advertncia Utilizadas neste Manual ..................................................................................... 2 2. SRIE BLUEPLANT........................................................................................................................................ 3 Caractersticas do BluePlant ............................................................................................................................ 3 Modelos do BluePlant ....................................................................................................................................... 3 Produtos Relacionados ...................................................................................................................................... 4 Solues para Integrador de Sistemas ............................................................................................................. 5 Acessrios ........................................................................................................................................................... 5 3. DESCRIO TCNICA DO BLUEPLANT ................................................................................................. 6 Caractersticas Gerais dos Modelos BluePlant ............................................................................................... 6 Caractersticas Gerais Comuns ........................................................................................................................ 7 Caractersticas Gerais ....................................................................................................................................... 8 Software com Segurana Intrnseca ............................................................................................................ 8 Mecanismo Grfico Superior ...................................................................................................................... 8 Recursos de Manuteno, Teste e Diagnstico Avanado .......................................................................... 8 Servidores e Extenses .NET Incorporados ................................................................................................ 8 Caractersticas Inovadoras do Produto ........................................................................................................... 9 Banco de Dados em Tempo Real (Tags) ..................................................................................................... 9 Linguagens .NET e Scripts.......................................................................................................................... 9 Alarmes e Segurana ................................................................................................................................. 10 Tendncia e Historiadores ......................................................................................................................... 10 Dispositivos e Redes ................................................................................................................................. 11 Conjunto de Dados .................................................................................................................................... 12 Relatrios .................................................................................................................................................. 12 Telas do Cliente......................................................................................................................................... 13 Objetos do Runtime................................................................................................................................... 13 Isolao de Mdulo ................................................................................................................................... 13 Ferramentas do Runtime e Diagnstico .................................................................................................... 13 Implantao e Teste de Projeto ................................................................................................................. 14 Drivers de Comunicao ........................................................................................................................... 15 4. BLUEPLANT................................................................................................................................................... 16 Requisitos Mnimos para Instalao e Operao ......................................................................................... 16 Instalao ......................................................................................................................................................... 17 Licenas e Hardkey ......................................................................................................................................... 19 Iniciando com o BluePlant .............................................................................................................................. 20 Gerenciamento de Projeto ......................................................................................................................... 20 Primeiros Passos com o BluePlant ................................................................................................................. 22 Selecionando o Projeto Demo ................................................................................................................... 22 Criando um Novo Projeto ......................................................................................................................... 22
ii
Sumrio Interface do Usurio .................................................................................................................................. 23 Criando Tags no Projeto............................................................................................................................ 24 Associando tags a um protocolo comunicao.......................................................................................... 25 Incluindo objetos na tela principal ............................................................................................................ 27 Executando um Projeto ............................................................................................................................. 30 5. MENU PRINCIPAL DO BLUEPLANT ....................................................................................................... 35 Edio da Aplicao ........................................................................................................................................ 35 Diagramao da Aplicao ............................................................................................................................. 36 Execuo da Aplicao .................................................................................................................................... 36 Informaes da Aplicao............................................................................................................................... 37 6. COMPONENTES DO BLUEPLANT ........................................................................................................... 39 Menu Edit......................................................................................................................................................... 39 Editando Tags............................................................................................................................................ 39 Editando as configuraes de segurana ................................................................................................... 48 Editando Dispositivos ............................................................................................................................... 51 Editando Alarmes ...................................................................................................................................... 59 Editando Banco de Dados ......................................................................................................................... 62 Editando Scripts ........................................................................................................................................ 74 Editando Displays ..................................................................................................................................... 78 Editando Relatrios ................................................................................................................................... 84 Menu Draw ...................................................................................................................................................... 87 Ferramentas de Seleo ............................................................................................................................. 89 Objetos Geomtricos. ................................................................................................................................ 90 Componentes de Tela ................................................................................................................................ 90 Entrada e Sada de Texto........................................................................................................................... 90 Biblioteca de Smbolos ............................................................................................................................. 92 Controles Avanados ................................................................................................................................ 92 Alarme ....................................................................................................................................................... 92 Tendncia .................................................................................................................................................. 94 Grade de Dados ......................................................................................................................................... 96 Barra de Ferramentas Horizontal .............................................................................................................. 98 Configurao Dinmica............................................................................................................................. 99 CodeBehind ............................................................................................................................................. 105 Smbolos.................................................................................................................................................. 106 Menu Info ....................................................................................................................................................... 110 Project ..................................................................................................................................................... 110 Redundancy ............................................................................................................................................. 112 Track ....................................................................................................................................................... 114 Notes ....................................................................................................................................................... 116 Ferramentas da Aplicao ............................................................................................................................ 117 Tstartup ................................................................................................................................................... 117 PropertyWatch......................................................................................................................................... 118 TraceWindow .......................................................................................................................................... 119 ModuleInformation ................................................................................................................................. 120 Objetos Runtime ............................................................................................................................................ 121 Namespace Tag ....................................................................................................................................... 123 Namespace Security ................................................................................................................................ 131 Namespace Alarm ................................................................................................................................... 134 Namespace Device .................................................................................................................................. 139 Namespace Dataset ................................................................................................................................. 141 Namespace Script .................................................................................................................................... 152 Namespace Display ................................................................................................................................. 154
iii
Sumrio Namespace Report .................................................................................................................................. 155 Namespace Info ....................................................................................................................................... 157 Namespace Server ................................................................................................................................... 162 Namespace Client.................................................................................................................................... 164 Configuraes Avanadas ............................................................................................................................. 170 Linhas de Comando................................................................................................................................. 170 Executando o BluePlant como um Servio do Windows ........................................................................ 171 Clientes Remotos .................................................................................................................................... 171 Instalando o Web Server no IIS .............................................................................................................. 172 7. CENRIOS DE SISTEMAS TPICOS ....................................................................................................... 179 Configuraes dos Sistemas .......................................................................................................................... 179 Sistema Standalone ................................................................................................................................. 179 Sistema de Entradas e Sadas Distribudas .............................................................................................. 179 Sistema Cliente e Servidor ...................................................................................................................... 180 Sistema de Servidor Redundante............................................................................................................. 181 Sistema de Controle ................................................................................................................................ 183 Sistema de Controle Distribudo e Distribuido Redundante ................................................................... 184 Sistema de Compartilhamento de Carga ................................................................................................. 185 8. GLOSSRIO ................................................................................................................................................. 186
iv
1. Suporte Tcnico BluePlant
1. Suporte Tcnico BluePlant

Introduo ao BluePlant
O BluePlant da Altus a soluo definitiva para superviso e sistemas de aquisio de dados e controle. A reputao da Altus est associada excelncia no fornecimento de sistemas de automao e produtos para controle de processos, como Controladores Programveis (CPs) e Unidades Terminais Remotas (UTRs), oferecendo desempenho superior, tecnologia no estado da arte e caractersticas como redundncia, alterao online, troca a quente, alta conectividade e outras funcionalidades avanadas. Esta vasta experincia em sistemas de automao industrial serviu de base para o desenvolvimento deste software SCADA/IHM. A experincia e o portflio diversificado de produtos garantem Altus uma posio-chave no fornecimento de solues completas em automao. O BluePlant atende requisitos de alto desempenho, recursos de conectividade ampliados, interface grfica de usurio extremamente rica e poderosa e mecanismos avanados de aquisio de dados em tempo real. A seleo de drivers incorporados no BluePlant, a capacidade de engenharia distribuda, a redundncia, o suporte OPC garantem uma experincia nova e nica com o BluePlant. Criado no Microsoft Windows Presentation Foundation (WPF), a tecnologia do BluePlant permite obter melhores resultados com as placas grficas atuais, resultando em aplicaes de desempenho excepcional. O BluePlant inclui tambm as funcionalidades padro encontradas nesse tipo de produtos, tais como interao com servidores de banco de dados (SQL, PI, Oracle, Sybase, Informix e outros), barramentos de rede personalizados, mdulo de notificao de eventos e servidor de alarme fcil de utilizar, componente de registro e relatrio, servidor de histrico avanado, gerenciamento de lgica de negcios, bem como suporte para clientes locais e remotos, executando em computadores, Web, tablets e smartphones.
Figura 1-1. Altus BluePlant
Documentos Relacionados a este Manual

Para obter informaes adicionais sobre a Srie BluePlant podem ser consultados outros documentos (manuais e caractersticas tcnicas) alm deste. Estes documentos encontram-se disponveis em sua ltima reviso em www.altus.com.br.
1. Suporte Tcnico BluePlant Cada produto possui um documento denominado Caracterstica Tcnica (CT), onde se encontram as caractersticas do produto em questo. Adicionalmente o produto pode possuir Manuais de Utilizao (os cdigos dos manuais so citados na CT). Aconselha-se o seguinte documento como fonte de informao adicional: Caractersticas Tcnicas BluePlant CT124000
Inspeo Visual
Antes de proceder instalao, recomendvel fazer uma inspeo visual cuidadosa dos equipamentos, verificando se no h danos causados pelo transporte. Verifique se todos os componentes de seu pedido esto em perfeito estado. Em caso de defeitos, informe a companhia transportadora e o representante ou distribuidor Altus mais prximo. importante registrar o nmero de srie de cada equipamento recebido, bem como as revises de software, caso existentes. Essas informaes sero necessrias caso se necessite contatar o Suporte Tcnico da Altus.
Suporte Tcnico
Para entrar em contato com o Suporte Tcnico da Altus em So Leopoldo, RS, ligue para +55 51 3589-9500. Para conhecer os centros de Suporte Tcnico da Altus existentes em outras localidades, consulte nosso site (www.altus.com.br) ou envie um e-mail para altus@altus.com.br. Se o equipamento j estiver instalado, tenha em mos as seguintes informaes ao solicitar assistncia: A configurao do sistema instalado (sistema operacional, banco de dados, arquitetura utilizada e atendimento dos requisitos de hardware - computador) O modelo de BluePlant utilizado e acessrios adicionais O contedo do projeto (mdulos utilizados), obtido atravs do programador BluePlant
Mensagens de Advertncia Utilizadas neste Manual

Neste manual, as mensagens de advertncia apresentaro os seguintes formatos e significados: PERIGO: Relatam causas potenciais, que se no observadas, levam a danos integridade fsica e sade, patrimnio, meio ambiente e perda da produo.
CUIDADO: Relatam detalhes de configurao, aplicao e instalao que devem ser seguidos para evitar condies que possam levar a falha do sistema e suas consequncias relacionadas.
ATENO: Indicam detalhes importantes de configurao, aplicao ou instalao para obteno da mxima performance operacional do sistema.
2. Srie BluePlant
2. Srie BluePlant
Caractersticas do BluePlant
O BluePlant executa nativamente em mquinas de 64 bits com .NET Framework 4. H diferentes modelos de produtos para permitir a escolha da melhor soluo de acordo com as necessidades. O BluePlant pode atender desde solues de grande porte at aplicaes embarcadas. Os modelos do BluePlant so compatveis com o legado de computadores de 32 bits. As telas do cliente podem ser executadas em navegadores Web nos computadores com Windows e nos dispositivos mveis baseados em Windows.
Caractersticas BluePlant Enterprise Projetado para gerenciamento de plantas de processo, inteligncia de negcios (Business Intelligence - BI), painis em tempo real, SCADA, IHM avanado, controle de processo e otimizao. Permite clientes e aquisio de dados distribudos. O tamanho da aplicao parte de 150 pontos de comunicao Projetado para painis, computadores industriais, dispositivos embarcados e sistemas autnomos. Aplicado principalmente em interface de mquinas e pequenos projetos centralizados. O tamanho da aplicao varia de 150 at 1500 pontos de comunicao Projetado somente para avaliao, e no para instalao em campo, limitada em 75 pontos de comunicao e uma hora de execuo do Runtime Projetado para escolas e universidades. O tamanho da aplicao varia de 150 at 1500 pontos de comunicao e uma hora de execuo do Runtime
BluePlant Lite
BluePlant Express
BluePlant Student
Tabela 2-1. Modelos de BluePlant Para atender as necessidades de integradores de sistemas foram criadas solues que permitem o desenvolvimento de projetos como no BluePlant Lite ou BluePlant Enterprise. Essas solues para integradores de sistemas executam o Runtime por apenas uma hora para que possam ser realizados os testes do projeto. Aps esse perodo, necessrio reiniciar o Runtime. Todas as solues para integradores de sistemas comunicam plenamente com os controladores programveis atravs dos principais drivers de comunicao incorporados nos produtos.
Modelos do BluePlant
O BluePlant dividido em famlia/modelos de acordo com as funcionalidades e requisitos de cada aplicao. Desta forma possvel utilizar o modelo de BluePlant adequado ao tamanho da aplicao para otimizar o desempenho do sistema. Deve ser levado em considerao a quantidade total de tags disponveis, sendo esta quantidade 10 vezes a quantidade de pontos de comunicao. Os pontos de comunicao esto includos na quantidade total. Os modelos disponveis seguem na Tabela 2-1 e na Tabela 2-2 esto as quantidades de pontos de comunicao para cada modelo de BluePlant.
2. Srie BluePlant
BluePlant Enterprise (Pontos de comunicao) 150 300 500 1500 2500 5000 15000 25000 50000 100000 Ultimate
BluePlant Lite (Pontos de comunicao) 150 300 500 1500 -
BluePlant Express (Pontos de comunicao) 75 -
BluePlant Student (Pontos de comunicao) 150 300 500 1500 -
Tabela 2-2. Quantidade de Pontos de Comunicao por Modelo de BluePlant
Produtos Relacionados
A tabela a seguir indica os cdigos que devem ser utilizados para adquirir o produto:
BluePlant Enterprise Pontos de comunicao 75 150 300 500 1.500 2.500 5.000 15.000 25.000 50.000 100.000 Ultimate Engineering Runtime BP1203 BP1205 BP1207 BP1209 BP1211 BP1213 BP1215 BP1217 BP1219 BP1221 BP1299 Runtime BP1103 BP1105 BP1107 BP1109 BP1111 BP1113 BP1115 BP1117 BP1119 BP1121 BP1199 BluePlant Lite Engineering Runtime BP2203 BP2205 BP2207 BP2209 Runtime BP2103 BP2105 BP2107 BP2109 BluePlant Express Engineering Runtime BP6400 BluePlant Student Engineering Runtime BP4400 -
Tabela 2-3. Produtos Relacionados por Modelo de BluePlant Notas: Ultimate: Aplicaes com mais de 100.000 tags devem utilizar essa licena. BluePlant Enterprise: Esse modelo acompanha um cliente completo para o BluePlant (cliente rich remoto), demais acessrios devem ser requisitados separadamente. BluePlant Lite: Esse modelo acompanha um cliente completo para o BluePlant (cliente rich remoto) e um cliente web completo para Internet Explorer.
2. Srie BluePlant
Solues para Integrador de Sistemas

A tabela abaixo apresenta os cdigos de produtos que atendem as necessidades de integradores de sistemas.
Cdigo BP5001 BP5003 BP5010 BP5020 Descrio Soluo para integradores de sistemas com licenas temporrias 1 ano Soluo para integradores de sistemas com licenas temporrias 3 anos Soluo para integradores de sistemas BluePlant Lite Soluo para integradores de sistemas BluePlant Lite/Enterprise
Tabela 2-4. Solues para Integradores de Sistemas Notas: BP5001, BP5003: Soluo que permite desenvolver projetos tanto no BluePlant Lite como no BluePlant Enterprise, com licenas temporrias vlidas por 1 (um) ano (BP5001) e 3 (trs) anos (BP5003) a partir da data de gravao. BP5010: Soluo que permite desenvolver projetos para o BluePlant Lite somente, sem limite de validade da licena. BP5020: Soluo que permite desenvolver projetos para o BluePlant Lite e BluePlant Enterprise, sem limite de validade da licena.
Acessrios
A tabela abaixo contm os cdigos dos acessrios que podem ser adquiridos. Estes acessrios somente esto disponveis no modelo BluePlant Enterprise.
Cdigo BP9501 BP9601 BP9701 Descrio Cliente web de visualizao para Internet Explorer Cliente rich completo Cliente web completo para Internet Explorer
Tabela 2-5. Acessrios para BluePlant Enterprise
3. Descrio Tcnica do BluePlant

Este captulo apresenta as caractersticas tcnicas dos modelos de BluePlant, abordando as partes integrantes do sistema, sua arquitetura e caractersticas gerais.
Caractersticas Gerais dos Modelos BluePlant

BluePlant Lite Limite de execuo do Runtime Servidor OPC DA Linguagem C# Execuo multi-threading de scripts Matriz de tags (mltiplas dimenses) Tipos do usurio (mltiplos nveis) Extenso SDK e integrao de toolkits Configurao da tabela de histrico Servidor para clientes iPad e iPhone Clientes rich remotos concorrentes Clientes web remotos concorrentes (completo e/ou visualizao) Redundncia de ns de dispositivos Redundncia de servidores Relatrio atravs de objetos grficos Condies estendidas de alarmes Controle de verso de projeto Controle de alteraes por objetos Compresso automtica do histrico Controle de acesso WPF Hot start Modo teste No Sim No No No No No No No No Sim, somente um 1 cliente web completo No No No No No No No No No No BluePlant Student Sim Sim Sim No No No No No No Sim Sim Sim No Sim Sim Sim Sim No Sim No Sim BluePlant Express Sim No Sim No No No No No No Sim Sim Sim No Sim Sim Sim Sim No Sim No Sim BluePlant Enterprise No Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim
Notas: Limite de execuo do Runtime: Execuo do Runtime limitada em uma hora. O Runtime pode ser reiniciado. Linguagem C#: possvel criar scripts utilizando a linguagem C#. Execuo multi-threading de scripts: Essa funcionalidade permite criar scripts e gerar diferentes threads para cada script criado. Quando essa caracterstica est habilitada, a execuo das threads concorrente. Quando essa caracterstica no est habilitada, a execuo das threads sequencial.
6
Tipos do usurio (mltiplos nveis): permitido criar novos tipos de dados, sendo possvel utilizar at quatro nveis encadeados de tipos de dados. Extenso SDK e integrao de toolkits: possvel criar bibliotecas proprietrias (dlls), com funes especficas e utilizar em projetos. Clientes rich remotos concorrentes: BluePlant Enterprise deve ser instalado na mquina remota e as licenas devem estar presentes na mquina servidora. O nmero de clientes rich remotos concorrentes depende do nmero de licenas adquiridas. Clientes web remotos concorrentes (completo e/ou visualizao): O nmero de clientes web remotos concorrentes tanto de visualizao quanto o completo depende do nmero de licenas adquiridas, exceto para o BluePlant Lite que permite somente um cliente remoto completo e nenhum cliente remoto de visualizao. Redundncia de servidores: Para utilizar essa funcionalidade so necessrios dois servidores e duas hardkeys com as suas respectivas licenas. Cada servidor deve ter a sua prpria hardkey e ento possvel configurar os servidores como um par redundante. Controle de alteraes por objetos: Essa caracterstica permite controlar as alteraes feitas em telas, tags, scripts, mdulos e outras modificaes em objetos no projeto. Hot start: possvel modificar a aplicao e recarreg-la sem parar o sistema.
Caractersticas Gerais Comuns

BluePlant Lite, BluePlant Express, BluePlant Student e BluePlant Enterprise Protocolos simultneos Cliente OPC Abertura de mltiplos projetos Linguagem VisualBasic .NET Scripts para avaliaes de expresses matemticas. Scripts para criar classes .NET e tarefas Integrao com base de dados SQL Historiador e Logger Alarme e Proteo Editor Grfico WPF Ferramentas de engenharia e depurao Editor de relatrio Controle de alteraes por tabelas Localization Todas os modelos do BluePlant possuem pelo menos quatro canais Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim
3. Descrio Tcnica do BluePlant Notas: Protocolos simultneos: Execuo simultnea de drivers de comunicao durante a execuo do Runtime. Controle de alteraes por tabelas: O controle de alteraes por tabelas informa o que foi modificado, removido ou inserido, mas no informa onde as alteraes foram feitas. Localization: Essa caracterstica traduz textos de telas e alarmes no Runtime.
Caractersticas Gerais
Software com Segurana Intrnseca A caracterstica de Segurana Intrnseca confere segurana e confiabilidade ao produto, uma das bases fundamentais para o desenvolvimento da plataforma BluePlant que no h nenhum uso de cdigo C ou C++, eliminando totalmente o risco de problemas com ponteiro e/ou excees de memria. Cada tarefa de execuo e processo, seja interna ou criada para ser executada no mbito do BluePlant, executada em seu prprio espao alocado e "protegido" com controle de exceo interno, isolamento de memria, controle multitarefa e sincronizao em tempo real. A metodologia de desenvolvimento de software empregada com VBA, VBScript, matemtica e lgica proprietria, onde os potenciais problemas podem ser detectados em Runtime, foram eliminados e substitudos por linguagens compiladas do .NET, com validao completa dos scripts antes da execuo pelo Runtime com proteo interna que confere desempenho superior, maior estabilidade operacional e segurana. Mecanismo Grfico Superior Os grficos no BluePlant so do tipo Windows Presentation Foundation (WPF) com sistema interno utilizando XAML. Isso permite a integrao com mapas geoespaciais e modelos 3D. Os modelos 3D podem ser apresentados diretamente, bem como vinculados a dados dinmicos com respostas associadas e comportamentos baseados em eventos e valores em tempo real. Um poderoso editor grfico WPF est includo no BluePlant. Os clientes Web dependem de XBAP (aplicativos baseados em navegador e Silverlight) de forma que no h nenhuma exigncia para a instalao de qualquer componente externo ActiveX. Alm do suporte que permite que pginas da Web sejam apresentadas em smartphones, o BluePlant oferece suporte para grficos e relatrios em iPad e iPhone da Apple. Recursos de Manuteno, Teste e Diagnstico Avanado O sistema possibilita a troca de verses do projeto, permitindo que as aplicaes em modo teste sejam executadas lado a lado, no mesmo servidor, com as aplicaes no modo produo para validao e garantia da qualidade, incluindo a anlise da utilizao da UCP e das estatsticas de comunicao dos mdulos do Runtime e redes fornecidas. As opes de hot-standby interna para redundncia, locais alternativos de funcionamento e recuperao de desastres tambm esto incorporadas. Servidores e Extenses .NET Incorporados Alm dos mdulos incorporados para banco de dados em tempo real, SQL externo e conexes ERP, servidor de alarmes e eventos, servidor de histricos e emisso de relatrios, o BluePlant permite acesso completo ao Microsoft .NET Framework, permitindo customizao e extensibilidade avanadas, sem o acrscimo de qualquer tipo de aplicao de terceiros ou ferramenta externa. Alm das caractersticas indicadas anteriormente, o BluePlant foi projetado a partir de um "campo verde" e foi criado totalmente sem empregar qualquer cdigo herdado. um aplicativo de cdigo
8
3. Descrio Tcnica do BluePlant 100% gerenciado que permite utilizar e aproveitar o potencial pleno do Microsoft .NET Framework tanto atualmente, como futuramente. O BluePlant possui uma interface de configurao criada inteiramente a partir do Microsoft Windows Presentation Foundation Graphics (WPF) e suporta integralmente software como servios (SaaS) implantao combinada com instalaes locais, permitindo acessar e colaborar no desenvolvimento de projetos em todo o mundo com apenas um navegador de internet.
Caractersticas Inovadoras do Produto

Banco de Dados em Tempo Real (Tags) O BluePlant suporta os seguintes tipos de pontos de dados em tempo real: Digital (Booleano), Analgico (Inteiro, Double e Decimal), Mensagem de Texto, Contador, Temporizador e variveis de data e hora. Alm disso, podem ser definidos tipos prprios com vrios nveis de encadeamento, tags de referncia e matrizes tridimensionais. O banco de dados em tempo real garante, sem a necessidade de qualquer programao adicional, a sincronizao de dados entre vrios processos no servidor e mltiplas estaes cliente. Um vasto conjunto de propriedades internas, tais como qualidade de dados, estampa de tempo, bloqueio de estado e valor bloqueado, permitem e simplificam a criao de aplicaes.
Banco de dados em tempo real (Tags) Suporte estendido a tipos de tags Tag do tipo tabela de dados incorporado Tags de referncia Tag do tipo matriz Tipos e estruturas definidas pelo usurio Propriedades do Tag Digital, Analgico Inteiro, Analgico Double, Analgico Decimal, Texto, Temporizador, Contador, Date/Time (variveis de data e hora) Acesso aos resultados da consulta do conjunto de dados no objeto de tabela de dados .NET padro Utilizao de tags de referncia para chavear o link do Tag na execuo do Runtime Definio de tags do tipo matriz (uma a trs dimenses, dependendo da verso do produto) Definio de tipos prprios para o banco de dados em tempo real Amplo conjunto de propriedades de tag acessveis na configurao do Runtime
Tabela 3-1. Banco de Dados em Tempo Real (Tags)
Linguagens .NET e Scripts BluePlant um sistema SCADA que suporta as linguagens do Microsoft .NET em completa integrao com o Microsoft .NET Framework. Os scripts e lgicas do projeto podem ser escritos em C# ou VB.NET, e um conversor de linguagem integrado permite alternar dinamicamente o cdigo criado entre as linguagens. No ambiente do BluePlant, possvel compilar, realizar a referncia cruzada dos objetos e acessar diretamente (usando o Intellisense) as classes .NET e objetos do projeto, incluindo alarmes, relatrios e ns de comunicao. As linguagens .NET fornecem um ambiente mais poderoso quando comparado com o VBA ou VBScript, que so linguagens interpretadas e no compiladas. Essas tecnologias deixam muitos erros de programao que so encontrados somente quando projeto em VBA ou VBScript executado em tempo real, resultando muitas vezes em consequncias e resultados indesejados. O ambiente gerenciado do Microsoft .NET Framework d suporte para localizar e se recuperar das excees, proporcionando assim um ambiente altamente confivel para o sistema do Runtime e as aplicaes.
Linguagens .NET e Scripts Criao de funes VB.NET e procedimentos Execuo de scripts em eventos e programao Suporte a bibliotecas de classe Editor .NET integrado com Intellisense Suporte a excees e mensagens de rastreamento Acessar objetos no BluePlant diretamente a partir do cdigo Fcil conexo com tags e eventos do processo usando scripts Criao de classes prprias acessveis de outros scripts e telas Auxiliar na seleo de nomes da tag e propriedades de objetos Todo o .NET Framework, componentes externos e servios so facilmente integrados
Tabela 3-2. Linguagens .NET e Scripts
Alarmes e Segurana Podem ser definidos vrios nveis de alarme para cada ponto ou Tag e toda uma gama de comportamentos, tais como registro, reconhecimento, exibio, etc. os quais so pr-definidos para facilitar a configurao. O sistema de segurana pode definir nveis de acesso para cada objeto de tela. Condies de alarme e de segurana so automaticamente replicadas nas aplicaes redundantes.
Alarmes e Segurana Mltiplas condies de alarme Alta resoluo Objetos de visualizao integrados Grupo de alarme e item de objetos Hi, HiHi, Lo, LoLo, taxa de alterao e desvio Intervalo da estampa de tempo em milissegundo (quando disponvel), usando o tempo remoto de E/S, no a hora do computador Objeto grfico online e histrico, quando executado localmente ou na Web Acessar as propriedades dos alarmes diretamente, por exemplo, "total de alarmes ativos", sem a necessidade de criar tags na aplicao
Tabela 3-3. Alarmes e Segurana
Tendncia e Historiadores O BluePlant permite criar arquivos de historiador em bancos de dados externos, tais como Microsoft SQL Server ou Oracle, ou mesmo usar o banco de dados SQL integrado. Ele possibilita salvar os dados com base na alterao de dados ou disparadores de grupo e tem uma opo exclusiva de faixa de tempo que impede o registro de dados com uma estampa de tempo menor do que um valor prdefinido, permitindo a criao de bancos de dados mais compactos. O acesso a um servidor de PI da OSIsoft tambm possvel. O recurso de estampa de tempo pode utilizar um valor fornecido diretamente a partir da E/S remota, ao invs do computador, garantindo maior preciso no evento. A organizao das amostras permite incluir ou remover tags do registro sem perder a compatibilidade com os ltimos dados. Um objeto completo do tipo grfico de tendncia tambm fornecido para a visualizao de dados online e histricos.
10
Tendncia e Historiadores Conexo com banco de dados ADO Banco de dados SQL integrado Alta resoluo Disparador por Tag ou grupo Banda morta do historiador por Tag Configurao do intervalo de tempo mnimo Tabelas de banco de dados com mltiplos tags Objeto de visualizao de tendncia integrado Informaes do historiador podem ser salvas em qualquer base de dados externa com suporte ADO.NET Quando no definidos como um banco de dados externo, o log acontece no banco de dados SQL integrado Intervalo da estampa de tempo em milissegundos (quando disponvel), usando o tempo de E/S remoto, no a hora do computador Permitir o salvamento de um registro de acordo com a alterao do Tag ou baseado em eventos de processo Permitir a definio de uma variao mnima de Tag para disparo do registro Permitir a definio de um intervalo mnimo para gravao, permitindo a criao de bancos de dados mais compactos Permitir a criao de um grupo de tags e armazena-os na mesma tabela de dados para acelerar a gravao e carregamento Objeto grfico de histrico e online executado localmente ou na Web
Tabela 3-4. Tendncia e Historiadores
Dispositivos e Redes O BluePlant fornecido com um driver OPC DA para coleta de informaes de dispositivos remotos. Alm do OPC, o BluePlant tambm oferece suporte a drivers de comunicao personalizados para acessar diretamente CPs, sistemas remotos de E/S, barramentos de campo padres, laos nicos e mltiplos, scanners, leitores de cdigo de barras, dispositivos RFID e monitores digitais. A ferramenta de configurao de dispositivo pode importar bancos de dados de servidores OPC, arquivos de texto ou CSV. Se o dispositivo for compatvel, automaticamente implementa sistemas multitarefa em redes TCP/IP ou cenrios multi-seriais. A sintaxe de endereamento segue a conveno de nomenclatura do dispositivo remoto, tornando a configurao e a manuteno muito mais fceis. Um conjunto completo de ferramentas de desempenho e diagnstico est includo tambm.
Dispositivos e Redes Importao de configuraes de pontos de dados Comunicao executada em processo isolado Fcil comunicao com vrios canais Nomeao abstrata para ns e estaes Criao dinmica de blocos otimizados Configurao de pontos segue a sintaxe do dispositivo Propriedades de canais e ns Customizao de eventos de escrita Copiar e colar do Microsoft Excel, importar bancos de dados de servidores CSV ou OPC Proteo total para o ambiente do Runtime e desempenho avanado em processadores multi-core Criar automaticamente mltiplas tarefas nos protocolos multi-serial ou TCP/IP Fornecer maneira fcil de renomear e manter o endereo IP e a configurao de rede de E/S Seleo simples de pontos de leitura e escrita, baseada no protocolo, e criao de blocos otimizados Enderear pontos do dispositivo, esse endereamento usado nas ferramentas de programao do CP Acessar as propriedades diretamente, por exemplo, status do n e tags da aplicao no so necessrios Configurao fcil para comandos e eventos, escrita de todos os eventos ou apenas no caso de alterao de valor
Tabela 3-5. Dispositivos e Redes
11
3. Descrio Tcnica do BluePlant Conjunto de Dados O mdulo de conjunto de dados includo no BluePlant fornece uma interface de fcil operao para a troca de dados em tempo real com bancos de dados externos, XML, CSV ou arquivos de texto, bem como a possibilidade de acessar tabelas e consultas SQL. Para os mais populares bancos de dados e fontes de dados (Microsoft SQL Server, Oracle, Arquivos CSV, Microsoft Access, PI, Firebird, Informix e Excel), o BluePlant fornece configuraes prdefinidas que reduzem o gerenciamento de configuraes a um clique do mouse. Qualquer banco de dados que oferea suporte a ODBC, ADO.NET ou OLE-DB tambm pode ser acessado. Um banco de dados DB SQL integrado fornecido como opo de banco de dados local para a aplicao. Os dados coletados via conjunto de dados podem ser mapeados dinamicamente em tempo real para pontos/tags e podem ser usados em scripts ou relatrios ou ainda apresentados em telas usando um poderoso objeto visual de grade de dados.
Conjunto de dados Acessar textos, CSV e arquivos XML Definio de mltiplas fontes de banco de dados Mapeamento de tags com tabelas de dados Definio de consultas e mapeamentos Poderoso objeto de visualizao de grade de dados Propriedades de tabela e consultas Definir a ligao em tempo real com tags e contedo de arquivo Gerenciar facilmente mltiplas conexes de banco de dados Utilitrio de configurao de alto nvel para gerenciar as tabelas de banco de dados usadas no projeto Gerenciar vrias consultas disparadas por eventos de processo e condies de filtro usando pontos de dados em tempo real Abrangente e poderoso objeto de grade de dados para criar interfaces de usurio tanto locais quanto na Web Acessar propriedades (por exemplo, contagem de linhas) diretamente, sem a necessidade de criao de tags na aplicao
Tabela 3-6. Conjunto de Dados
Relatrios BluePlant oferece suporte a servios Web, XML e outras interfaces de troca de dados com o objetivo de fornecer dados para as ferramentas de relatrios externas. Em contraste com outros pacotes, onde os relatrios so necessariamente criados em outra ferramenta, o BluePlant tem seu prprio editor de relatrio interno. O editor de relatrio permite a incluso de texto dinmico, smbolo grfico dinmico e grficos, e pesquisas em banco de dados, em um editor completo e de fcil utilizao. Os relatrios podem ser salvos nos formatos texto, HTML, PDF ou XPS e facilmente apresentados em clientes remotos e telas Web.
Relatrios Editor integrado Suporte a texto, HTML e XPS Copiar e colar Tags em tempo real facilmente inseridas Editor de texto fcil de usar, permitindo a incluso de tabelas, imagens, hiperlinks e formatao de texto Salvar relatrios em vrios formatos, como XPS, por exemplo, permitindo fcil implantao em ambientes distribudos Editar no Microsoft Word ou em editor HTML ou RTF, basta copiar e colar o contedo do BluePlant Com apenas um clique, o usurio pode adicionar valores de dados em tempo real aos relatrios
Tabela 3-7. Relatrios Nota: No possvel fazer relatrios baseados em resultados dinmicos a partir do banco de dados, ou seja, a pesquisa deve sempre retornar um nmero exato de linhas.
12
3. Descrio Tcnica do BluePlant Telas do Cliente O editor grfico integrado no BluePlant utiliza a tecnologia WPF da Microsoft para permitir a criao de interfaces completas de usurio com mapeamento em tempo real de valores e tags do processo: um poderoso e completo conjunto de animaes dinmicas tambm est includo. As telas so salvas internamente usando XAML, o qual fornece independncia de resoluo, isolamento do cdigo e fcil extensibilidade. Uma biblioteca de smbolos, onde os smbolos tambm podem manter um vnculo dinmico com a biblioteca, acelera criao de processos sinticos. Todas as tecnologias do cliente oferecem suporte de servidor redundante. Trs tecnologias so utilizadas em clientes remotos: BluePlant Visualizer Clients: executado como uma aplicao desktop e permite bloquear o chaveamento de tarefas do Windows (teclas CTRL+ALT+DEL e ALT+TAB do Windows). Isto ideal para operadores/usurios de intranet com demandas de segurana Web Smart Clients: utiliza a tecnologia .NET Smart Client da Microsoft e em clientes remotos possvel instalar com um nico clique e sem requisitos de administrador. A aplicao atualizada automaticamente nos clientes remotos quando atualizado no servidor. O BluePlant usa todo o potencial do computador remoto e ainda mantm as vantagens de uma instalao centralizada Web XBAP Partial Trust Clients: as telas do cliente podem ser executadas diretamente a partir de navegadores da Web, sem necessidade de instalao de qualquer software (inclusive controles do ActiveX). O Partial Trust Clients garante que as telas do cliente sejam executadas em um ambiente completamente isolado. Assim como nos Smart Clients, quando o aplicativo atualizado no servidor, tambm atualizado automaticamente nos clientes
Objetos do Runtime Mais avanada do que a maioria dos sistemas, onde necessrio criar tags ou variveis para todas as propriedades internas e customizar lgicas para projetos, o BluePlant permite que as aplicaes acessem diretamente todos os objetos do Runtime criados no projeto. Isso significa que tags temporrios no so necessrios para gerenciar o status dos ns da rede do CP, do nmero total de alarmes em um grupo ou do nmero de linhas em um conjunto de dados. possvel acessar os objetos do Runtime (que representem um n da rede), um grupo de alarme ou conjunto de dados e exibir as informaes necessrias ou tomar uma ao diretamente atravs das propriedades integradas. Isolao de Mdulo Para um melhor desempenho, segurana e confiabilidade, os mdulos da UCP com maior consumo e sensibilidade, tais como scripts, conjuntos de dados, dispositivos (drivers de comunicao), relatrios e telas, so executados em seus prprios processos ou no domnio da aplicao em sua prpria tarefa, independentemente do banco de dados em tempo real do servidor. Alm das vantagens descritas anteriormente, a arquitetura do BluePlant tambm permite a distribuio da aquisio de dados da aplicao, ou qualquer aplicao intensiva da UCP em diferentes computadores em um ambiente distribudo, proporcionando uma maior flexibilidade para implementar vrios cenrios redundantes e consequente simplificao da manuteno em campo. Ferramentas do Runtime e Diagnstico A ferramenta de monitorao de propriedade permite verificar e simular valores em todos os mdulos e objetos e tambm iniciar e parar todos os mdulos individualmente. A ferramenta de janela de rastreamento automaticamente gera mensagens de sistema sobre eventos importantes no Runtime e pode ser facilmente estendida para emitir mensagens especficas relacionadas com eventos de script, alteraes de dados de tags/pontos ou aes do usurio.
13
3. Descrio Tcnica do BluePlant A ferramenta de informaes do mdulo uma ferramenta de desempenho e perfil avanado que fornece informaes internas de todo o ambiente do Runtime.
Ferramentas de Diagnstico e do Runtime Modo teste Informaes do mdulo Ferramenta de localizao Janela de rastreamento Monitorao de propriedade Executar projetos com proteo, como, somente leitura em dispositivos externos ou arquivos temporrios no historiador Ferramentas avanadas para perfil de desempenho e diagnsticos de sistemas internos Criar interface de usurio do operador em vrias linguagens e, dinamicamente, alterna entre elas no Runtime Ao criar uma aplicao esta ferramenta fornece monitorao de Tag e mensagens de diagnstico do sistema Verificar e simular valores de Tag e propriedades, iniciar e parar mdulos funcionais
Tabela 3-8. Ferramentas do Runtime e de Diagnstico
Implantao e Teste de Projeto Antes de executar uma aplicao ou projeto, pode ser utilizado o exclusivo Modo Teste do BluePlant o qual pode executar o projeto ou a aplicao em um ambiente de teste seguro. No Modo Teste, no possvel enviar comandos para os controladores remotos (apenas comandos de leitura so enviados), alarmes e historiadores salvam os dados em arquivos temporrios e os bancos de dados externos de tempo real so acessados em modo somente leitura. Aps concluir com sucesso o teste, preciso executar a opo "Inicializar" para obter a funcionalidade completa. Quando o projeto ou aplicao esto prontos para serem implantados no campo, deve ser utilizado o recurso Publicar para configurar as opes de redundncia (se aplicvel) e para criar uma cpia do projeto somente leitura, verso controlada, cpia do projeto para a instalao em campo.
Ferramentas de Implantao e Teste de Projeto Abertura de vrios projetos Engenharia remota Execuo como servio do Windows Proteo de chaveamento de aplicaes Atalhos de inicializao Projeto de arquivo nico e recursos embarcados Abrir vrios projetos simultaneamente no computador Acessar e editar remotamente a configurao do projeto Executar o Runtime no servidor, instalado como um servio do Windows Proteger contra chaveamentos de aplicaes no autorizadas em interfaces do operador usando as teclas CTRL+ALT+DEL do Windows ou outras Utilizar atalhos simples de inicializao e parmetros para customizao de inicializao A configurao de todo o projeto salva em um nico arquivo protegido, incluindo todas as imagens e bitmaps usados em telas e relatrios
Tabela 3-9. Ferramentas de Implantao e Teste de Projeto
14
Drivers de Comunicao Esto disponveis vrios drivers para os principais fabricantes de CPs e sistemas de automao.
Drivers de Comunicao ALNET I Altus ALNET II FBS MODBUS Allen Bradley RTU-TCP RTU-TCP Escravo CIP (Control Logix) DA OPC XML-DA UA Xi Siemens S7 Ethernet
Tabela 3-10. Drivers de Comunicao
15
4. BluePlant
4. BluePlant
Requisitos Mnimos para Instalao e Operao
Os modelos BluePlant Student, BluePlant Express e BluePlant Lite apresentam quatro canais disponveis e o modelo BluePlant Enterprise conta com 64. As tabelas a seguir mostram os requisitos mnimos para instalao e operao do BluePlant usando diferentes quantidades de canais.
BluePlant Express, BluePlant Student, BluePlant Lite e BluePlant Enterprise (at 4 canais) Plataforma PC com Windows XP (32 bits), Windows Vista (32 bits), Windows 7 (32 bits ou 64 bits), Windows 8 (32 bits ou 64 bits), Windows Server2008 ou Windows Server2012 Intel Core 2 Duo (mnimo) 1 Gbyte (mnimo), 2 Gbytes (recomendado) 2 Gbytes (mnimo), 4 Gbytes (recomendado) 1024 x 768 (mnimo), 1280 x 1024 (recomendado) Qualquer idioma
Processador Espao em disco Memria RAM Resoluo Idioma
Tabela 4-1. Configurao para at 4 Canais

BluePlant Enterprise (at 8 canais) Plataforma PC com Windows XP (32 bits), Windows Vista (32 bits), Windows 7 (32 bits ou 64 bits), Windows 8 (32 bits ou 64 bits), Windows Server2008 ou Windows Server2012 Intel Core i5 (mnimo) 1 Gbyte (mnimo), 2 Gbytes (recomendado) 4 Gbytes (mnimo), 6 Gbytes (recomendado) 1024 x 768 (mnimo), 1280 x 1024 (recomendado) Qualquer idioma
Tabela 4-2. Configurao para at 8 Canais

BluePlant Enterprise (at 16 canais) Plataforma PC com Windows XP (32 bits), Windows Vista (32 bits), Windows 7 (32 bits ou 64 bits), Windows 8 (32 bits ou 64 bits), Windows Server2008 ou Windows Server2012 Intel Core i7 (mnimo) 1 Gbyte (mnimo), 2 Gbytes (recomendado) 6 Gbytes (mnimo), 8 Gbytes (recomendado) 1024 x 768 (mnimo), 1280 x 1024 (recomendado) Qualquer idioma
Tabela 4-3. Configurao para at 16 Canais Nota: Plataforma: necessria a instalao do Microsoft .NET Framework 4.0.
16
4. BluePlant ATENO: A quantidade de canais e o desempenho da aquisio de dados so os principais motivos para selecionar os requisitos de operao. Se forem necessrios mais de 16 canais ou se existirem outras demandas especficas do projeto, recomenda-se fortemente contatar o Suporte Tcnico da Altus atravs do site www.altus.com.br ou e-mail altus@altus.com.br.
Instalao
Para executar a instalao do software BluePlant necessrio realizar o download do arquivo de instalao a partir do site www.altus.com.br. Em seguida, devem ser fechados todos os programas em execuo no PC, clicar duas vezes no arquivo de instalao e depois em Next. A tela do contrato de licena que aparecer deve ser lida atentamente. Caso os termos da licena sejam aceitos, selecionar a opo para continuar a instalao. A tela de instalao a seguir ir aparecer, para prosseguir clicar no boto Next.
Figura 4-1. Tela do Contrato de Licena do BluePlant Durante a instalao, aparecer outra tela de licena, a qual deve ser lida atentamente. Este acordo do software Advosol OPC Core Components. Este software oferece um suporte completo na plataforma .NET para todos os principais padres OPC. OPC um conjunto de especificaes normatizadas. Tais padres resultaram da colaborao de vrios dos principais fornecedores de automao em todo o mundo trabalhando em cooperao com a Microsoft. A especificao definiu um conjunto padro de objetos, interfaces e mtodos para uso em controle de processos e aplicaes de automao para facilitar a interoperabilidade. Atualmente, existem centenas de clientes e servidores OPC Data Access. Caso os termos sejam aceitos, a caixa de verificao deve ser marcada para continuar a instalao. A prxima tela da instalao ir aparecer, para prosseguir, clicar no boto Next.
17
4. BluePlant
Figura 4-2. Tela do Contrato de Licena do Advosol A tela de instalao do Advosol OPC Core Components deve aparecer. Aguardar enquanto os arquivos necessrios so instalados no computador. Isso pode levar alguns minutos dependendo da configurao do computador.
Figura 4-3. Tela de Instalao do Advosol Aps a concluso da instalao do Advosol OPC Core Components, inicia a instalao do BluePlant. Aguardar enquanto os arquivos necessrios so instalados no computador. Isso pode levar alguns minutos dependendo da configurao do computador.
18
4. BluePlant
Figura 4-4. Tela de Instalao do BluePlant Aps a concluso da instalao, a tela a seguir ser exibida. Clicar no boto Finish para concluir o procedimento de instalao.
Figura 4-5. Tela de Encerramento de Instalao do BluePlant O BluePlant est instalado e pronto para usar. Para execut-lo, clicar no atalho "BluePlant", criado durante a instalao, no Menu Iniciar.
Licenas e Hardkey
O BluePlant possui alguns modelos onde suas caractersticas so habilitadas atravs de licenas presentes em uma hardkey. A hardkey um meio fsico onde esto presentes as licenas requisitadas e para que o BluePlant libere as funcionalidades presentes na hardkey, a mesma deve ser conectada ao servidor onde ser executado o projeto.
19
4. BluePlant Na Tabela 2-1, podem ser conferidos os modelos BluePlant disponveis e exceto o modelo Express, todos demais so habilitados por licenas presentes em hardkey. Uma vez que a hardkey conectada no servidor, as informaes podem ser visualizadas atravs da guia License conforme Figura 4-9. ATENO: Devem ser tomados cuidados para que a hardkey no seja danificada, pois nestes casos se o acesso s informaes presentes na hardkey for comprometido, as funcionalidades habilitadas no mais estaro disponveis. Neste caso deve-se entrar em contato com o Suporte Tcnico da Altus atravs do site www.altus.com.br ou e-mail altus@altus.com.br.
Iniciando com o BluePlant

Uma vez instalado o BluePlant no computador, um duplo clique no cone apresentado abaixo, permite abrir a ferramenta.
Figura 4-6. cone do BluePlant
Gerenciamento de Projeto Aps a inicializao do BluePlant deve aparecer a janela de Gerenciamento do Projeto. No centro da tela inicial, em sua parte superior, encontram-se as guias denominadas Projects, Server, e License
Figura 4-7. Tela de Gerenciamento de Projeto
20
4. BluePlant Em seguida aparece a estrutura de menus padro Web do BluePlant. Este design permite um acesso mais eficiente ao leque de ferramentas, reduzindo a quantidade de cliques. Alm disso, uma tabela lista os projetos que podem ser acessados. Na guia Projects, esto os cones para criar um projeto New Project, para abrir um projeto selecionado Open Project... e para localizar outros projetos Find Project... que no esto localizados no diretrio padro do BluePlant. A guia Server tem a aparncia mostrada na Figura 4-8 onde duas opes esto disponveis: Localhost e Remote. A primeira significa que o projeto ser executado localmente e a segunda que o projeto ser executado a partir de um servidor remoto.
Figura 4-8. Guia Servidor A terceira guia refere-se licena do produto, incluindo o modelo, a verso do produto, famlia, nmero de srie, cdigo do produto entre outras informaes presentes na hardkey como pode ser visto na Figura 4-9.
21
4. BluePlant
Figura 4-9. Guia Licenas
Primeiros Passos com o BluePlant

Esta seo apresenta uma sequncia de operaes para a criao de um projeto simples ou abertura de um projeto existente. Junto com a ferramenta disponibilizado um demo que permite uma viso simplificada dos recursos disponveis no BluePlant. O detalhamento das funcionalidades ilustradas aqui ser explorado no decorrer deste manual. Selecionando o Projeto Demo A partir da guia Projects... no editor de projetos, pode ser selecionado o projeto Demo.tproj, o qual contempla uma viso geral das funcionalidades e recursos do BluePlant. Para abrir o projeto, basta selecionar o projeto presente na lista e clicar em Open Project. Criando um Novo Projeto As configuraes bsicas do projeto a ser criado so definidas a partir da janela de abertura do BluePlant clicando em New Project... que pode ser visto na Figura 4-7. Na janela seguinte, apresentada na Figura 4-10, esto indicados os passos para criar um novo projeto.
22
4. BluePlant
Figura 4-10. Criando um Novo Projeto 1. Indicao de novo projeto 2. Definio do nome do projeto, descrio e diretrio onde ser gerado o projeto 3. Configuraes iniciais tais como: famlia e modelo do produto, plataforma, cultura e cdigo (script) padro 4. Ajustes da resoluo da tela 5. Boto para criar um novo projeto e iniciar o desenvolvimento da aplicao O novo projeto criado est referenciado na lista da janela de abertura do BluePlant. Interface do Usurio A configurao da interface do usurio opera como uma pgina da Web front-end onde se pode facilmente navegar entre os itens e edit-los. Os dados so salvos automaticamente no back-end, sem a necessidade de abrir/salvar/fechar os menus. A interface do usurio contempla, esquerda, o menu principal no topo e o submenu logo abaixo o qual se altera quando se seleciona outro item do menu principal. Alm disso, direita, esto as guias da rea de trabalho e, mais acima, uma barra de links rpidos e itens recentes. A Figura 4-11 ilustra a interface do usurio.
23
4. BluePlant
Figura 4-11. Interface do Usurio
Criando Tags no Projeto No ambiente de edio possvel editar objetos como, por exemplo, tags. A Figura 4-12 mostra o caminho para a edio de tags. Neste exemplo, foram criados dois tags analgicos: o valor bruto de um medidor de potncia eltrica a ser lido do controlador programvel denominado de Power_PV e o valor de engenharia desta medio chamado de Power_ENG.
Figura 4-12. Editando Tags do Projeto
24
4. BluePlant Os passos para a criao desses tags esto listados a seguir conforme numerao indicada na figura anterior. 1. 2. 3. 4. Acessar o menu Edit Selecionar a opo Tags Acessar a aba Objects na qual aparecer a tabela com os tags do usurio Digitar os dados relativos ao novo tag da aplicao na linha marcada com um asterisco (*). Para confirmar a incluso na tabela deve ser pressionada a tecla ENTER 5. Selecionar as opes de configurao dos tags atravs das colunas da tabela desejadas clicando com o boto direito do mouse no cabealho de uma coluna e marcando os itens para exibio Tambm possvel criar um novo tag acessando a barra de ferramentas no topo do ambiente de edio. Basta clicar no cone e configurar os parmetros do tag. A Figura 4-13 mostra o processo de criao de um tag vetor de uma dimenso, com trs posies do tipo analgico inteiro a partir do Menu Editar. Um tag vetor um conjunto de tags com o mesmo nome, cuja identificao se d atravs de ndices. Neste exemplo, o acesso em outros locais da aplicao a esse tag, se d via sintaxe TT[0], TT[1], TT[2] e TT[3].
Figura 4-13. Processo de Criao de Tags
Associando tags a um protocolo comunicao Para realizar a associao das tags criadas a um protocolo de comunicao, os passos descritos a seguir devem ser executados.
Figura 4-14. Processo de Criao de Canal de Comunicao

25
4. BluePlant 1. 2. 3. 4. 5. Acessar o menu Edit Selecionar a opo Devices Acessar a guia Channels na qual deve aparecer o campo com os protocolos disponveis Selecionar no campo Installed Protocols o protocolo de comunicao a ser utilizado Para confirmar a criao do canal, clicar no boto Create new...
Uma vez o protocolo selecionado e confirmada a criao do canal, uma janela com as propriedades do protocolo deve aparecer, como pode ser visto na Figura 4-15.
Figura 4-15. Opes de Protocolos para Criao de um Canal Na guia Nodes o local onde so criados os ns de acordo com os canais existentes. Para mais detalhes de como criar e configurar ns, pode ser consultado no captulo Editando Dispositivos.
Figura 4-16. Incluso e Configurao de Ns Na guia Points onde so criadas as associaes entre os tags, o n e os endereos do protocolo, alm de configuraes de tipos de acesso, escalas e tipos de dados.
Figura 4-17. Associao de Tags com Ns e Endereos de Protocolos

26
4. BluePlant Ao selecionar o campo TagName da guia Point, deve abrir uma janela como apresentado na Figura 4-18, onde esto todos os tags criados e podem ser selecionados para associar ao n criado.
Figura 4-18. Seleo do Tag para Associar a um N
Incluindo objetos na tela principal No menu Draw possvel criar as telas que compem a aplicao. As telas so formadas por objetos, tais como smbolos e textos. Vamos explorar a incluso desses dois tipos de objetos na tela principal padro. Incluso de Smbolo Para realizar a incluso de um smbolo do tipo tacmetro na tela principal (MainPage), as seguintes etapas podem ser contempladas: 1. 2. 3. 4. 5. Selecionar Menu Draw Acessar a aba Drawing Abrir a biblioteca de smbolos Selecionar o smbolo do tacmetro, posicionando-o no local desejado Configurar as propriedades do smbolo
Esses passos esto referenciados na Figura 4-19 conforme a numerao correspondente.
27
4. BluePlant
Figura 4-19. Incluso de um Smbolo do Tipo Tacmetro Para associar um tag ao smbolo, as seguintes etapas podem ser consideradas: 1. Clicar com o boto direito do mouse no smbolo 2. Selecionar a opo Symbol links A Figura 4-20 mostra essas etapas de associao de tag.
28
4. BluePlant
Figura 4-20. Associao de Tag a um Smbolo Na janela seguinte possvel configurar o tag e seus parmetros conforme descrito nos passos a seguir: 1. Configurar as propriedades do smbolo (rtulo e valores mximo/mnimo) 2. Associar um tag ao smbolo no campo RotateValue Neste caso foi utilizado o tag cliente SimulationAnalog para simular o movimento do ponteiro do medidor. A Figura 4-21 mostra essa configurao.
Figura 4-21. Configurao do Tag Associado ao Smbolo
29
4. BluePlant Incluso de Texto No menu Draw para incluir um texto na tela podemos proceder conforme segue: Selecionar a opo de Sada de Texto: 1. Posicionar o texto no local desejado 2. Configurar as propriedades do texto A Figura 4-22 ilustra esta sequncia.
Figura 4-22. Incluso de um Texto
Executando um Projeto O ambiente de execuo (Run) fornece acesso a todos os recursos de execuo do projeto. Os seguintes mdulos esto disponveis e so explorados nesta seo: Build (Compilar), Test (Testar), Startup (Inicializao) e Publish (Publicar). Alm disso, nesse menu esto includas as seguintes ferramentas: UseCount (Contagem de uso), Localization (Localizao) e Extensions (Extenses), as quais sero exploradas no decorrer desse manual. Compilao do Projeto A compilao verifica o projeto em relao a eventuais erros e otimiza o sistema para operao rpida e eficiente. O tempo necessrio para compilar um projeto depende de seu tamanho e a capacidade de processamento do computador. Para compilar o projeto os seguintes passos servem como orientao: 1. 2. 3. 4. Selecionar o menu Run Selecionar a opo Build Acessar a aba Messages Compilar o projeto
30
4. BluePlant 5. Confirmar a compilao A Figura 4-23 ilustra o processo de compilao do projeto.
Figura 4-23. Compilao do Projeto A Figura 4-24 mostra a janela de progresso da compilao.
Figura 4-24. Progresso da Compilao A Figura 4-25 ilustra o resultado da compilao e os erros, se existirem.
Figura 4-25. Resultado da Compilao
31
4. BluePlant Teste do Projeto A Figura 4-26 mostra os passos descritos para testar o projeto.
Figura 4-26. Teste do Projeto 1. Selecionar o menu Run 2. Selecionar a opo Test, que executa o projeto em modo teste. possvel configurar o teste, as ferramentas de diagnsticos e os mdulos a serem testados 3. Iniciar o teste com as configuraes definidas, confirmando atravs do boto Run Test A Figura 4-27 mostra o resultado da execuo do teste do projeto.
Figura 4-27. Execuo do Teste do Projeto Para finalizar o teste do projeto o usurio pode abrir o menu File e selecionar a opo Shutdown conforme representado na Figura 4-27.
32
4. BluePlant Inicializao do Projeto A Figura 4-28 mostra a sequncia para inicializao do projeto.
Figura 4-28. Execuo da Inicializao do Projeto 1. Selecionar o menu Run 2. Selecionar a opo Startup, que permite configurar a inicializao, as ferramentas de diagnsticos e os mdulos a serem inicializados 3. Iniciar a execuo do projeto com as configuraes definidas, atravs do boto Run Startup Juntamente com a visualizao da tela principal do projeto ser aberta uma janela mostrando o status e as mensagens de inicializao conforme pode ser observado na Figura 4-29.
Figura 4-29. Status da Inicializao do Projeto
33
4. BluePlant Publicao do Projeto Quando o projeto est pronto para ser executado no campo, deve ser utilizado o recurso de publicao para configurar as opes de redundncia (se aplicvel) e para criar uma cpia do projeto na modalidade somente leitura com verso controlada, ou seja, uma cpia do projeto para a execuo em campo. A extenso do arquivo gerado por ocasio da publicao .teng. A Figura 4-30 mostra a sequncia para publicao do projeto.
Figura 4-30. Publicao do Projeto 1. 2. 3. 4. Selecionar menu Run Acessar a opo Publish, que permite acessar as configuraes da publicao do projeto Clicar no boto Publish, que dispara a publicao do projeto com as configuraes definidas Janela de confirmao para publicao do projeto
Finalizada a publicao, uma janela similar mostrada na Figura 4-31 ser exibida indicando o caminho de publicao do projeto.
Figura 4-31. Caminho da Publicao do Projeto
34
5. Menu Principal do BluePlant

Cada sistema de superviso gerencia certo nmero de objetos tambm denominados entidades que descrevem as variveis de processo controladas e os elementos habituais do controle. A atividade de configurao de um supervisrio compreende usualmente duas etapas: Definir cada varivel de processo na base de dados Definir sinticos, grficos e relatrios
No sistema existem variveis simples, primitivas e compostas, estas ltimas formadas a partir das primeiras. Nesse contexto o nome da varivel recebe o nome de Tag. Neste captulo so descritos os quatro menus bsicos do BluePlant: Edit, Draw, Run e Info, os quais contm as ferramentas necessrias para o desenvolvimento de um projeto de um sistema de superviso contemplando as etapas tpicas indicadas anteriormente. Esses quatro menus so descritos nas sees Edio da Aplicao, Diagramao da Aplicao, Execuo da Aplicao e Informaes da Aplicao respectivamente.
Edio da Aplicao
O menu Edit permite acessar as ferramentas para a edio de um projeto no BluePlant. A Figura 5-1 ilustra a seleo desse menu.
Figura 5-1. Menu Edit Os itens que compem o menu Edit esto numerados na figura anterior e so descritos na sequncia: 1. Barra de seleo do menu de edio do projeto 2. Barra de ferramentas do menu de edio, contendo os recursos para a configurao dos seguintes elementos: tags, usurios e suas polticas de segurana, dispositivos e seus protocolos de comunicao, alarmes, banco de dados, linguagem Script, displays e relatrios 3. Atalhos na barra de ferramentas superior, incluindo as definies para criao de um novo tag, as propriedades das tags e as configuraes de usurios bem como seu acesso aos elementos da aplicao
35
Diagramao da Aplicao
No menu Draw possvel criar as telas e smbolos que compem a aplicao. A Figura 5-2 ilustra a incluso de smbolos na tela principal (MainPage) com o auxilio das barras de ferramenta associadas.
Figura 5-2. Menu Draw Os itens que compem o menu Draw esto numerados na figura anterior e so descritos na sequncia: 1. Barra de seleo do menu de edio do projeto 2. Barra de ferramentas vertical usada para incluir, manipular e configurar os elementos que vo compor as telas da aplicao 3. Barra de ferramentas horizontal localizada abaixo da guia da tela, a qual contm comandos para agrupar, combinar, alinhar, bloquear o(s) componente(s) selecionado(s), entre outros 4. Barra de ferramentas TopToolBar localizada na parte superior da tela principal do menu Draw, a qual possui cones com as seguintes funes: criar novo(s) display(s), apagar display(s), salvar display(s) e visualizar o(s) display(s) j existente(s) no projeto
Execuo da Aplicao
O menu Run permite o acesso a todas as funcionalidades de execuo do projeto. Os itens de menu disponveis neste ambiente so: Buid, Test, Startup, Publish e o mdulo Tools. A Figura 5-3 ilustra esse menu.
36
Figura 5-3. Menu Run Os itens que compem o menu Run esto numerados na figura anterior e so descritos na sequncia: 1. Barra de seleo do menu de execuo do projeto 2. Funcionalidades da execuo do projeto o Comando Build, o qual prepara um projeto para execuo e o salva no Histrico de Compilao do Projeto. Ele est dividido em Compilao de Mensagens e Compilao de Histrico. A Compilao de Mensagens exibe as informaes de status, erros, localizao e mdulo. A Compilao de Histrico exibe as informaes de compilao, erros, data da execuo e usurios o Comando Test, contemplando as configuraes associadas ao teste do projeto o Comando Startup para inicializar as configuraes do projeto o Comando Publish que permite acessar as configuraes da publicao do projeto 3. Mdulo Tools, incluindo as funcionalidades contagem de tags e objetos, via comandos "UseCount" e "CrossReference", configuraes de traduo no Runtime (Localization) e ferramentas de execuo e Add-ons (Extentions)
Informaes da Aplicao
O ambiente Info permite o acesso s informaes do projeto. A Figura 5-4 ilustra esse menu.
37
Figura 5-4. Menu Info Os itens que compem o menu Info esto numerados na figura anterior e so descritos na sequncia: 1. Barra de seleo do menu de informaes do projeto 2. Informaes da aplicao, incluindo detalhamento das configuraes do projeto (Project), rastreamento das alteraes efetuadas (Track) e notas do usurio (Notes) 3. Informaes do aplicativo onde possvel acessar a ajuda do software e obter informaes sobre a licena de uso da ferramenta
38
6. Componentes do BluePlant
Este captulo detalha as ferramentas de configurao, runtime e aplicativos do BluePlant. A seguinte estruturao foi considerada: Ferramentas de Configurao: menus Edit, Draw, Run e Info Ferramentas de runtime: ferramentas da aplicao, objetos runtime e linhas de comando Aplicativos BluePlant: telas em outros sistemas operacionais e servio no Windows
Menu Edit
O ambiente de edio fornece acesso a todas as funcionalidades necessrias para configurar o projeto e composto pelos itens listados na tabela a seguir.
Funcionalidade Edio de Tags Representao Grfica
Definies de Segurana
Configurao de Dispositivos
Planejamento dos Alarmes
Banco de Dados
Linguagem Script
Projeto das Telas
Configurao de Relatrios
Tabela 6-1. Funcionalidades do Menu de Edit Nas prximas sees sero detalhadas essas funcionalidades. Editando Tags O menu Edit Tags configura o banco de dados de tags em tempo real. Edio de ObjetosTag Use os tags (e suas propriedades pr-definidas) includos na lista a seguir para configurar um banco de dados em tempo real. Tipos disponveis podem ser estendidos e novos tipos criados via tabela EditTagsUserTypes. Nota:
39
6. Componentes do BluePlant "Tag" no contexto de uma configurao de projeto refere-se a uma varivel de processo. A Figura 6-1 ilustra a edio de objetos Tags.
Figura 6-1. Edio de objetos do Tag Os itens que compem o menu de edio de objetos esto numerados na figura anterior e so descritos na sequncia: 1. Selecionar a guia Objects; 2. Digitar os dados relativos ao novo Tag da aplicao na linha marcada com um asterisco (*); 3. Selecionar as opes de configurao dos tags. Clicar com o boto direito do mouse no cabealho de uma coluna e marcar os itens para exibio Na sequncia so explicados cada um dos itens do menu de edio de objeto conforme ilustrado na Figura 6-1. Name Define o nome do tag. Nesta coluna possvel criar ou editar tags. Type Estabelece o tipo do tag. Os tipos disponveis so:
Tipo Digital AnalogInt AnalogDecimal AnalogDouble Text Timer Counter Reference DateTime UserTypes Descrio True ou False Inteiro Decimal Ponto Flutuante Texto Tempo Contagem Objeto referncia apontando para outro objeto Data e hora Tipos definidos pelo usurio
Tabela 6-2. Tipos de Disponveis para Tags
40
6. Componentes do BluePlant Nota: No caso de um tipo Reference, um objeto de referncia deve ser inicializado para apontar para outro objeto. Isso normalmente feito usando a seguinte sintaxe no corpo do script:
@Tag.Reference1.Link = @Tag.TagName.GetName(); @Tag.Reference1.Link = @Tag.TagName.GetName(); (VB) (C#)
Parameters Define parmetros do tag de acordo com o tipo: banda morta para tags analgicos e ajustes para tags do tipo contador e temporizador. Quando criando "Tag de referncia" (ou PONTEIROS) define o tag de referncia de destino na coluna "Tipo de referncia". Min Configura o valor mnimo admissvel para o tag. Max Configura o valor mximo admissvel para o tag. Eng Units Define a unidade de engenharia base para o tag. Format Especifica o formato de exibio de um valor. Para formatos numricos vlidos consulte o tpico Formatos Numricos Padronizados. Exemplo: N1 (nmero com uma casa decimal). Para formatos de data e hora vlidos consulte o tpico Formatos de Data e Hora Padronizados. Exemplo: d (data abreviada). Para uma discusso mais aprofundada sobre caracteres de formato consulte o tpico Tipos de Formatao. Exemplo de formatos numricos:
Especificao N0 N3 X C Descrio Nmero sem casas decimais Nmero com 3 casas decimais Hexadecimal (suportado apenas em tipos inteiros) Moeda
Tabela 6-3. Exemplo de Formatos Numricos
41
6. Componentes do BluePlant Exemplo de formatos DateTime:

Especificao T (somente) d (somente) dd ddd dddd MM MMM yy yyyy hh HH mm ss fff tt Descrio Padro de tempo no formato longo (equivalente a "HH:mm:ss")) Padro de data abreviada (equivalente a "M/d/yyyy" )(ms/dia/ano) (EUA) Representa o dia do ms como um nmero de 01 a 31 Representa o nome abreviado do dia da semana Representa o nome completo do dia da semana Representa o ms como um nmero de 01 a 12 Representa o nome abreviado do ms Representa o ano como um nmero de dois dgitos Representa o ano como um nmero de quatro dgitos Representa a hora como um nmero de 01 a 12 Representa a hora como um nmero de 00 a 23 Representa o minuto como um nmero de 00 a 59 Representa os segundos como um nmero de 00 a 59 Representa os milissegundos como um nmero de 000 a 999 Representa o marcador AM/PM
Tabela 6-4. Exemplo de Formatos DateTime Exemplo: padro de tempo no formato longo Formato = HH:mm:ss (hora;minuto;segundo) Visibility Define a visibilidade do valor do Tag no servidor OPC para projetos remotos. As seguintes opes de configurao esto disponveis: Domain Define o valor do Tag para o projeto inteiro ou um valor especfico para cada tela cliente. As seguintes opes de configurao esto disponveis: Servidor: o valor do Tag consistido em todo o projeto e em todos os clientes Cliente: o valor do Tag local para cada computador remoto executando uma visualizao do cliente (Web ou visor) Privado: define um Tag visvel somente no projeto local e par redundante Protegido: define um Tag do tipo somente leitura visvel no servidor OPC DA para projetos remotos e clientes OPC DA Pblico: define um Tag visvel no servidor OPC DA para projetos remotos e clientes OPC DA
Nota: Tags do tipo cliente no devem ser usados em mdulos do servidor como Device, Alarm, Historian e ServerScripts, uma vez que seus valores so locais (restritos ao computador em execuo) e no so propagados para clientes remotos. A maioria dos tags em um projeto definida como "Servidor". tags "Locais", por sua vez, permitem valores diferentes em cada computador cliente. No entanto, pode-se usar tags "Locais" em dados temporrios especficos para computadores-cliente individuais. A situao mais comum para o uso de tags "Locais" quando dados temporrios so necessrios para gerenciar a Interface do usurio na tela. tags "Locais" permitem ainda valores diferentes em cada computador cliente.
42
6. Componentes do BluePlant Array Quando no definido (em branco) o Tag no do tipo matriz. Ao definir um Array com o valor N uma matriz de 0 at N posies criada. Por exemplo, ao criar um Tag Array de tamanho "5", a matriz criada a partir do Tag[0] ao Tag[5], significando que 6 elementos so criados. Esse mtodo contempla dois estilos de programao: a indexao a partir do zero e a contagem a partir do 1. Nota: Em relao extenso de Array por nveis de contas, as verses Lite e Express esto limitadas a matrizes unidimensionais. A verso Enterprise permite criar matrizes com at trs dimenses. Exemplo 1
Campo Name: TagAnalog Campo Array: 2
Cria 3 elementos: TagAnalog[0] TagAnalog[1] TagAnalog[2] Sintaxe de acesso:

C#: TagAnalog[1] VB.NET: TagAnalog(1)
Exemplo 2
Campo Name: Temp Campo Array: 1,2
Cria 6 elementos: Temp[0][0] Temp[0][1] Temp[0][2] Temp[1][0] Temp[1][1] Temp[1][2] Sintaxe de acesso:
C#: Temp[1,2] VB.NET: Temp(1,2)
Startup Value Estabelece o valor de inicializao do Tag. Quando deixado em branco nenhum valor de inicializao aplicado. Retentive Especifica se as Propriedades do Tag so retidas quando do encerramento do aplicativo, sendo usadas como valores de inicializao na prxima execuo. As seguintes opes de configurao esto disponveis: No-Retentivo: o valor do Tag no salvo ValueOnly: o valor do Tag salvo quando modificado e pode ser usado como valor de inicializao na prxima execuo Propriedades: todas as propriedades do Tag so salvas quando este modificado para serem usadas na prxima inicializao
Nota: Durante a edio necessrio pressionar a tecla ENTER na clula da tabela para a confirmao das configuraes efetuadas. Edio de Tipos Definidos pelo Usurio Um tag de tipo existente pode ser localizado no campo "Tipo Personalizado do Usurio". Clique estrutura. para apagar um tag de tipo estrutura existente e para criar um novo tag de tipo
43
6. Componentes do BluePlant Um tag de tipo do usurio pode ser usado da mesma forma que os tags incorporados. Nota: Nas verses Express e Lite os tags de tipo do usurio podem ser usados somente na lista principal de tags. A verso Enterprise permite a criao de um tipo do usurio com at quatro nveis. Exemplo: ao criar um tipo do usurio PID com os seguintes membros: 'setpoint' e 'PV', pode-se criar um tag denominado 'loop' do tipo PID, sendo que a sintaxe para acesso ao seu valor :
loop.setpoint e loop.PV
A Figura 6-2 ilustra a edio de tipos definidos pelo usurio.
Figura 6-2. Edio de Templates Tag Os itens que compem o menu de edio de tipos esto numerados na figura anterior e so descritos na sequncia: 1. Selecionar a opo Templates 2. Selecionar a opo User Custom Type clicando com o boto esquerdo do mouse em New para criar um novo elemento e em Del para excluir o elemento 3. Digitar os dados relativos ao novo tipo na linha marcada com um asterisco (*) 4. Selecionar as opes desejadas de configurao da coluna Tipo da tabela clicando com o boto direito do mouse no cabealho de uma coluna e marcando os itens para exibio Na sequncia so explicados cada um dos itens do menu de edio de templates conforme ilustrado na Figura 6-2. Name Define o nome do elemento. Nesta coluna possvel criar ou editar tipos do usurio.
44
Type Define o tipo de tag. As opes de configurao de tipo do componente do tag so:
Tipo Digital AnalogInt AnalogDecimal AnalogDouble Text Timer Counter Reference DateTime UserTypes Descrio True ou False Inteiro Decimal Ponto Flutuante Texto Tempo Contagem Objeto referncia apontando para outro objeto Data e hora Tipos definidos pelo usurio
Tabela 6-5. Tipos de Dados Base para Gerar Novos Tipos do Usurio
Array Quando no definido o tag no do tipo matriz. Ao definir um array com o valor N, uma matriz de 0 at N posies criada. Por exemplo, ao criar um tag array de tamanho cinco (5), a matriz criada a partir do tag[0] ao tag[5], significando que 6 elementos so criados. As verses Lite e Express esto limitadas a matrizes unidimensionais. A verso Enterprise permite criar matrizes com at trs dimenses. Reference Configura tags do tipo referncia. Este campo especifica o tipo de destino quando um tag reference criado. Um tag de referncia pode apontar - de forma dinmica e em Runtime - para diferentes tags conforme os tipos definidos neste campo. Min/Max Define o valor mnimo e mximo do tag. No se podem definir valores de Tag menores do que o valor mnimo ou maiores do que o valor mximo. Eng Units Define a unidade de engenharia base para o Tag. Start Value Estabelece o valor de inicializao do Tag. Quando deixado em branco nenhum valor de inicializao aplicado. Retentive Especifica se as propriedades do Tag so retidas quando do encerramento do aplicativo, sendo usadas como valores de inicializao na prxima execuo. As opes disponveis so: No retentivo: o valor do Tag no salvo ValueOnly: o valor do Tag salvo quando modificado para ser usado como valor de inicializao na prxima execuo
45
6. Componentes do BluePlant Todas as propriedades do tag so salvas quando este modificado para serem usadas na prxima inicializao. Ao aplicar propriedades retentivas, as modificaes so salvas no banco de dados<project>.retentiv. O uso de configuraes retentivas para tags cujos valores mudam rapidamente no recomendado uma vez que isso pode piorar o desempenho da execuo. Este o caso, por exemplo, das variveis do processo que so consideradas crticas e/ou esto associadas a condies de segurana. Edio de Historiador possvel configurar um banco de dados de Historiador para registrar alteraes nos tags. Para selecionar uma Tabela de Historiador existente pesquise no campo "Tabelas de Historiador". Clique para apagar uma Tabela de Historiador existente ou clique para configurar uma nova Tabela de Historiador. A Figura 6-3 mostra as configuraes da Tabela do Historiador.
Figura 6-3. Configuraes da Tabela do Historiador O banco de dados onde os tags so salvos definido em EditDatasetDBs no DB chamado "TagHistorian". A Figura 6 4 ilustra as configuraes associadas ao historiador de tags.
Figura 6-4. Edio de Historiador
46
6. Componentes do BluePlant Os itens que compem a tabela de edio de historiador esto numerados na figura anterior e so descritos na sequncia: 1. Selecionar a guia Historian clicando com boto esquerdo do mouse 2. Na opo Historian Tables clicar com o boto esquerdo do mouse em New para criar uma nova tabela e em Del para excluir uma tabela. O boto Config permite acesso s configuraes da tabela do historiador mostradas na Figura 6-3 3. Digitar os dados relativos ao Tag cujas alteraes desejam-se registrar na linha marcada com um asterisco (*) Na sequncia so explicados cada um dos itens do menu de edio de historiador conforme ilustrado na Figura 6-4. TagName Indica o nome do tag. Nesta coluna possvel inserir ou remover tags do historiador. DeadBand Configura a banda morta do Historiador. O evento de salvamento no registro disparado somente se o tag tem seu valor alterado acima da banda morta especificada. Exemplos: Banda morta configurada 10. Valor atual 20. Todos os novos valores (10 ou mais) maiores do que o valor anterior so adicionados ao registro do historiador. Valor alterado para 35 (diferena em relao ao valor anterior que era 20:15). Resultado: valor adicionado ao registro do historiador. Valor alterado para 50 (diferena em relao ao valor anterior que era 35: 15). Resultado: valor adicionado ao registro do historiador. Valor alterado para 55 (diferena em relao ao valor anterior que era 50: 5). Resultado: valor no adicionado ao registro do historiador. Deviation Se o SaveOnChange estiver definido nas configuraes da tabela e o Tag sofrer uma alterao maior do que o parmetro Deviation (valor anterior e atual > Deviation), o valor ser salvo imediatamente (no aguarda o prximo TimeSpan). RateOfChange Se o Tag RateOfChange (unidades de engenharia por segundo) for maior que o parmetro RateOfChange especificado e SaveOnChange estiver habilitado, a tabela ser salva imediatamente (no aguarda o prximo TimeSpan). HistorianTable Define a tabela do banco de dados onde os tags "Historiador" so salvos. Clique para editar as configuraes da tabela do historiador conforme mostrado na Figura 6-3. As opes de configurao so: TableName: nome da tabela do banco de dados TimeSpan: tempo mnimo entre registros Trigger: a tabela salva a cada alterao no disparo AutoCreate: cria automaticamente uma tabela quando esta no encontrada no banco de dados LifeTime: quando definido (maior que "0") exclui registros mais antigos do que o ciclo de vida
47
6. Componentes do BluePlant Description: descrio definida pelo usurio para fins de documentao
Associao de Tags possvel configurar dados de associao entre tags ou propriedades, de forma que quando os dados alteram seu valor os elementos a eles associados alteram-se automaticamente. A associao de dados pode tambm significar que se outra representao dos dados em um elemento alterar-se, ento os dados subjacentes sero tambm atualizados automaticamente. A Figura 6-5 mostra essa seleo.
Figura 6-5. Edio de Associao de Tags Os itens que compem o menu de edio de associaes esto numerados na figura anterior e so descritos na sequncia: 1. Selecionar a guia Bindings clicando com boto esquerdo do mouse 2. Digitar os dados relativos ao Tag na linha marcada com um asterisco (*) Na sequncia so explicados os itens do menu de edio de associaes conforme ilustrado na Figura 6-5. Name Especifica o nome do tag associado. BindingMode Define o modo de associao com as seguintes opes de configurao: OneTime (na inicializao) OneWay (nome do tag altera-se quando a sourceproperty alterar-se) TwoWay (qualquer alterao no nome do Tag ou na sourceproperty altera o campo oposto) OneWayToSource (sourceproperty altera-se quando o nome do tag alterar-se)
Source Property Estabelece a propriedade da fonte de dados. Editando as configuraes de segurana O menu Edit Security define as permisses do usurio e nveis de acesso ao projeto.
48
6. Componentes do BluePlant Edio de Usurios Define os usurios do projeto e as permisses relacionadas. As Ids dos nveis Administrador e Hspede apresentam atributos incorporados. Algumas permisses de usurio permanecem ativas independentemente da alterao de nome ou de permisses, conforme segue: Usurio Administrator (ID:2): a ID do Administrator permanece a mesma mesmo se o nome do usurio ou as permisses forem alteradas. O Administrator o nico usurio que pode apagar ou bloquear usurios e pode definir senhas para as interfaces do Banco de Dados. Usurio Guest (ID:0): esta ID usada para usurios de login annimo. Usurios hspedes no possuem senhas atribudas. Entretanto, suas permisses podem ser alteradas. Quando o sistema inicializado sem Usurio(s) definido (ou se um login annimo) se aplicam as permisses de segurana definidas para o usurio hspede. A Figura 6-6 mostra a edio dos perfis dos usurios no mbito da segurana.
Figura 6-6. Edio de Perfis de Usurios Os passos para edio/incluso de perfis de usurios esto numerados na Figura 6-6 e so descritos a seguir: 1. 2. 3. 4. 5. Selecionar o menu Edit Acessar o item Security Clicar na guia Users para acesso aos usurios do sistema Digitar os dados relativos aos usurios da aplicao na linha marcada com um asterisco (*) Selecionar as permisses disponveis que o usurio adicionado ou em edio pode ter no sistema
ATENO possvel configurar uma senha e uma dica da senha para cada usurio. Edio de Permisses Define a configurao e os privilgios de execuo para cada grupo de permisso. A Figura 6 7 ilustra essa seleo.
49
Figura 6-7. Edio de Permisses de Segurana Os passos para editar as permisses existentes esto ilustrados na Figura 6-7 e descritos a seguir: 1. 2. 3. 4. 5. 6. Selecionar o menu Edit Acessar o item Security Clicar na guia Permissions para acesso s permisses do sistema Digitar os dados relativos s permisses dos usurios na linha marcada com um asterisco (*) Configurar as permisses de edio na coluna Edit Configurar as permisses do Runtime na coluna Run
ATENO: A configurao das permisses de edio, serve para que os usurios configurados com esta permisso possam realizar determinados tipos de modificaes no projeto. As configuraes das permisses do Runtime servem para que os usurios configurados com esta permisso possam realizar determinadas aes durante a execuo do projeto. Name Estabelece o nome do grupo de permisso. Edit Define os privilgios de grupos de permisso para edio e desenho. As opes disponveis so: Unrestricted (irrestrito) EditTags (Edio de tags) Security (Segurana) Scripts (Scripts) Datasets (Banco de dados) Reports (Relatrio) Publish (Publicao) Notes (Notas) Historian(Historiador) Alarms (Alarmes)
50
6. Componentes do BluePlant Run Define os privilgios de Execuo de Grupos de Permisso (Runtime). As opes disponveis so: Unrestricted (irrestrito) Test (teste) Startup (inicializao) Shutdown (parada) ClientStart (inicializao do cliente) ClientShutdown (parada do cliente) StartTools (ferramentas de inicializao) ToolsSetValues (valores de ajuste das ferramentas de inicializao) CreateUsers (criao de usurios) SwitchApplication (alternar aplicao) WebAccess (acesso via Web) Devices (Dispositivos) Displays (Telas) Startup (inicializao) Settings (Configuraes) CreateTags (Criao de novas tags)
Editando Dispositivos O BluePlant fornecido com um driver OPC DA para coleta de informaes de dispositivos remotos. Alm do OPC, o BluePlant tambm oferece suporte a drivers de comunicao personalizados para acessar diretamente CPs, sistemas remotos de E/S, barramentos de campo padronizados, laos nicos e mltiplos, scanners, leitores de cdigo de barras, dispositivos RFID e monitores digitais. Consulte o manual de suporte ao Dispositivo para mais informaes sobre protocolo e programao de cada dispositivo. ATENO: Para mais informaes sobre as configuraes dos dispositivos (canais, ns e pontos de comunicao) deve ser acessado atravs do boto Help na guia Channels. Canais A aba Channels configura os protocolos e os canais de comunicao. A Figura 6 8 ilustra essa seleo.
Figura 6-8. Edio de Canais de Comunicao
51
6. Componentes do BluePlant Os itens que compem o menu de edio de canais de comunicao esto numerados na figura anterior e so descritos na sequncia: 1. Selecionar a opo Channels 2. Observar que os dados relativos aos protocolos instalados aparecem na linha marcada com uma seta () Na sequncia so explicados os itens do menu de edio de canais de comunicao conforme ilustrado na Figura 6-8. Name Estabelece o nome do canal. Protocol Define o protocolo de comunicao em execuo em um Canal especfico. ProtocolOptions Contempla a configurao especfica do protocolo. Interface Indica a interface de comunicao para o canal. As interfaces disponveis dependem do protocolo escolhido. A Tabela 6-6 mostra as interfaces disponveis para cada protocolo.
Protocolo Altus ALNET I Altus ALNET II ControlLogix - Rockwell Protocolo CIP Altus FBs - Facon MODBUS Master - TCP/IP e RS-232C MODBUS Slave - TCP/IP e RS-232C OPCXmlDA - OPC Xml/DA Client Siemens Protocolo S7 Interfaces disponveis Serial e Multiserial TCP/IP TCP/IP Serial, Multiserial e TCP/IP Serial, Multiserial e TCP/IP Serial e TCP/IP OPC TCP/IP
Tabela 6-6. Protocolos e Interfaces
Settings Inclui a definio das configuraes da interface de comunicao. Cada tipo de interface possui ajustes especficos como, por exemplo, porta de comunicao, velocidade, bits de dados, bits de parada, paridade e sinais de controle. Um duplo clique na clula Settings permite acessar o menu suspenso com as configuraes associadas interface. Timeout Configuraes de timeout para a interface de comunicao. Criando um Canal de Comunicao O boto seleo. pode ser utilizado para criar um novo canal. A Figura 6 9 ilustra essa
52
Figura 6-9. Edio de um Novo Canal de Comunicao Na sequncia ser explicado o passo a passo para a criao de um novo canal de comunicao conforme exemplo ilustrado na Figura 6-9. 1. Selecionar a opo Protocol clicando com o boto esquerdo do mouse 2. Selecionar nas opes existentes, aquela desejada. Neste caso: Altus ALNET II 3. Finalizar clicando com o boto esquerdo do mouse no boto Ok Ns No mbito da computao, um n um ponto ou terminal na rede, onde uma mensagem pode ser criada, recebida ou transmitida. No contexto dos sistemas de superviso operando em rede, o n pode ser um dispositivo eletrnico ativo que est ligado a uma rede, e capaz de enviar, receber ou transmitir informaes atravs de um canal de comunicao. A Figura 6-10 mostra o menu de edio de ns para um determinado canal de comunicao. Um canal de comunicao que, conforme indicado anteriormente, est associado a um protocolo especfico e pode conter um ou mais ns, caracterizando os dispositivos conectados a esse canal.
Figura 6-10. Edio do N para o Canal de Comunicao Os passos para editar ou incluir os ns existentes esto ilustrado na Figura 6-10 e descritos a seguir: 1. Selecionar o menu Edit 2. Acessar o item Devices 3. Clicar na guia Nodes para acesso s configuraes dos ns
53
6. Componentes do BluePlant 4. Incluir ou editar o nome do n na linha marcada com um asterisco (*) 5. Selecionar o Channel (protocolo) previamente adicionado no projeto 6. Indicar atravs da coluna PrimaryStation qual o endereo do equipamento que estar relacionado ao n Name Indica o nome do n. Channel Informa o canal de comunicao associado a este n. Primary Station Referencia a estao do N. Define o Endereo IP, Porta e SlaveID. A sintaxe do campo da estao depende do protocolo. A figura a seguir mostra um exemplo de parametrizao no caso do protocolo ALNET.
Figura 6-11. Parametrizao da Estao Primria
Backup Station Define o Endereo IP, Nmero de porta e SlaveID. Se este campo estiver definido, ao ocorrer uma falha de comunicao na estao principal, o sistema automaticamente tentar estabelecer uma comunicao com a estao de backup. Points Define os valores de aquisio de dados dos dispositivos de campo e mapeia os valores nos tags.
54
Figura 6-12. Edio de Pontos Os passos para editar ou incluir os pontos de comunicao esto ilustrado na Figura 6-12 e descritos a seguir: 1. 2. 3. 4. 5. 6. Selecionar o menu Edit Acessar o item Devices Clicar na guia Points para acesso s configuraes dos pontos de comunicao Incluir ou editar o nome da tag existente (selecionvel) na linha marcada com um asterisco (*) Selecionar o n (dispositivo configurado) previamente adicionado no projeto Indicar atravs da coluna Address qual o endereo do dado a ser recebido ou enviado do equipamento especificado
Name Define o TagName a ser lido ou escrito no Dispositivo identificado. Nodes Define o N de comunicao associado ao ponto do dispositivo. Address Indica o endereo do ponto no dispositivo. A sintaxe do campo de endereo depende do protocolo. A Figura 6-13 ilustra um exemplo de parametrizao do endereo (operando) no caso do protocolo ALNET.
55
Figura 6-13. Exemplo de Parametrizao do Endereo
Date Type Define a converso de dados aplicada aos dados de comunicao. A maioria dos protocolos deve utilizar a opo NATIVE. Neste caso, o protocolo automaticamente tratar da converso de dados. Se um DataType diferente do NATIVE for selecionado, os protocolos padro so sobrescritos. Os tipos de dados possveis so: Modifiers Fornece a seleo de bit e outras configuraes de dados de comunicao, podendo haver mudanas de acordo com o protocolo. Os seguintes campos podem ser definidos: Bit (unidade bsica de informao binria 0/1) ByteSwap (permuta de bytes) WordSwap (permuta de palavra)
56
Native (automtico) Bit (binrio 1 bit) Byte (octeto 8 bits) Char (menor unidade enderevel da mquina que pode conter caracteres bsicos 8 bits) Short (nmero inteiro com sinal - 16 bits) Dword (nmero inteiro 16 bits) Integer (nmero sem ponto decimal) Long (nmero inteiro com sinal 32 bits) ULong (nmero inteiro sem sinal 32 bits) BCD (nmero decimal codificado como binrio) LBCD (Long BCD) Single (nmero de ponto flutuante com preciso simples) Real (nmero real ponto flutuante) ASCII (codificao de caracteres de sete bits baseada no alfabeto ingls) Unicode (representao e manipulao de texto) OPCDateTime (data e hora padro OPC) Timer (codificao de tempo) Counter (codificao de contagem) Control (tipo de dado de controle)
6. Componentes do BluePlant AccessType Define o comportamento de leitura e escrita para cada ponto. Scaling Estabelece a converso de escala aplicada usando os dados de comunicao. As configuraes de converso de escala so: None (nenhuma converso) TagMinMax (escala baseada no valor mnimo e mximo do tag) Liner (escala linear) Equation (escala via equao) Stringlength (comprimento do string)
A Figura 6-14 ilustra a parametrizao de converso de escala baseada na opo TagMinMax.
Figura 6-14. Converso de Escala
Tipo de Acesso Define as caractersticas do tipo de acesso comuns aos pontos do dispositivo. Ver Figura 6-15. H trs tipos de acesso padro: ReadWrite (leitura e escrita) Write (escrita) Read (somente leitura)
57
Figura 6-15. Tipo de Acesso
Clique em
para criar um novo AccessType.
Figura 6-16. AccessType Na sequncia so explicados os principais itens do menu de tipo de acesso conforme ilustrado na Figura 6-16. Name Indica o nome do tipo de acesso. ReadPooling Define a leitura por pooling. Os atributos associados so: Selecionado = always = leitura por polling ativa No selecionado = never= leitura por polling inativa
58
6. Componentes do BluePlant PoolingRate Define a taxa de leitura por pooling para cada AccessType se ReadPooling estiver selecionado. OnStartup Define o ponto de leitura na inicializao. Os atributos associados so: WriteEnable Habilita ou desabilita a escrita quando ocorrer um evento. Os atributos associados so: WriteEvent Configura o tipo de acesso de escrita ao ponto. Os atributos associados so: Changed - escreve quando o Tag vinculado alterado ChangedUp - escreve quando o Tag vinculado sofre um aumento de valor ChangedDown - escreve quando o Tag vinculado sofre um decrscimo de valor Selecionado = true = habilita a escrita No selecionado = false = desabilita a escrita Selecionado = true = habilita a leitura na inicializao No selecionado = false = desabilita a leitura na inicializao
AcceptUnsolicited Define os atributos de aceite de mensagem no solicitada. Os atributos associados so: Selecionado - habilita mensagem no solicitada No selecionado - desabilita mensagem no solicitada
Editando Alarmes Um Alarme pode ser configurado atravs da associao de um Tag com um Grupo de Alarmes especfico e um valor limite. Para exibir um item de Alarme previamente configurado desenhe um objeto de alarme no ambiente de telas do seu projeto (Draw), inserindo o smbolo ferramentas esquerda. (Alarm Window) a partir da barra de
Os mtodos para o reconhecimento de Alarmes incluem objetos de alarme na tela, propriedades do Tag, grupos de alarme ou propriedades do item alarme, bem como os campos "AckAll" (global) e "AckMostPriority". Notas: Reconhecer todos os alarmes: pode-se usar a propriedade <Alarm.AckAll> que reconhece todos os alarmes configurados em um projeto com <Edit.Alarms.Items>. Reconhecer alarme nico ou alarme de alta prioridade: a propriedade {Alarm.PriorityItem.UnAck} permite o reconhecimento do Alarme de alta prioridade configurado em <Edit.Alarms.Items> na coluna "Prioridade". Se este for o nico Alarme ou se este for de alta prioridade ele ser reconhecido, mas somente se estiver Ativo ou Normalizado. Reconhecer alarme especfico: para reconhecer um alarme especfico, use a propriedade <Alarm.Items.IDxx.Unack>.
59
6. Componentes do BluePlant Grupos de Alarme Define o comportamento do tratamento de alarme comum para um grupo de itens de Alarme.
Figura 6-17. Grupos de Alarmes Os passos para editar ou incluir os grupos de alarmes esto ilustrados na Figura 6-17 e descritos a seguir: 1. 2. 3. 4. 5. Name Indica o nome definido pelo usurio para o grupo de alarmes. Os grupos de alarme "Warning", "Critical" e "SystemEvents" so incorporados e no podem ser excludos, embora seus nomes e configuraes possam ser alterados. AckRequired Configura as opes de reconhecimento para os alarmes do grupo. Os atributos associados so: Sound Habilita ou desabilita os sons do alarme quando houver alarmes ativos em um grupo. Os atributos associados so: Nenhum = 0: sem som Bip = 1: um bip regular ser tocado em cada computador cliente enquanto houver alarmes sem reconhecimento No = 0 - Pontos de alarme definidos no grupo no requerem reconhecimento Sim = 1 - Alarmes definidos no grupo requerem reconhecimento Selecionar o menu Edit Acessar o item Alarms Clicar na guia Groups para acesso s configuraes dos grupos de alarmes Incluir ou editar o nome do grupo de alarmes na linha marcada com um asterisco (*) Selecionar as configuraes do grupo especificadas nas colunas apresentadas na imagem acima
Show Configura a exibio ou no do alarme (inclui a visualizao no objeto alarmes online).
60
Log Events Define o tipo de arquivamento de Historiador em eventos de Alarme. Os seguintes tipos so possveis: None (sem log) Active (log quando o evento estiver ativo) ActiveAck (log quando o evento estiver ativo e for reconhecido) ActiveNorm (log quando o evento retorna ao normal) All (log em todas as condies acima)
Nota: O banco de dados na qual os tags so salvos definido em EditDatasetDBs no DB denominado "AlarmHistorian". Colors Define a customizao da tela de Alarme para cada linha de Alarme de acordo com seu grupo principal. Itens de Alarme Configura tags para gerar alarmes sob condies definidas.
Figura 6-18. Itens de Alarmes Os passos para editar ou incluir os grupos de alarmes esto ilustrados na Figura 6 18. e descritos a seguir: 1. 2. 3. 4. 5. 6. 7. 8. Selecionar o menu Edit Acessar o item Alarms Clicar na guia Itens para acesso as configuraes dos itens de alarmes Incluir ou editar o nome do tag que gera o alarme na linha marcada com um asterisco (*) Selecionar a condio de gerao de alarme Configurar o limite que dispara o alarme Selecionar o grupo previamente criado com as caractersticas do alarme Inserir mensagem que ser apresentada caso o alarme seja disparado
61
6. Componentes do BluePlant Name Define o TagName que ser avaliado para gerar o Alarme. Condition Condio de avaliao para gerar alarmes. Opes... Limit Define o valor para avaliar as condies do alarme. Group Define o nome do Grupo no EditAlarmGroups onde o comportamento do item Alarme est especificado. Os grupos pr-definidos so: Priority Define a Prioridade do Alarme. "0" a prioridade mais alta. Message Define uma Mensagem a ser exibida quando ocorrer o Alarme. Campos de mensagem podem conter valores de Tag avaliados quando da gerao do Alarme. Para tanto acrescente o nome do Tag desejado na mensagem usando a notao de vinculao XAML entre chaves, conforme ilustrado no exemplo a seguir:
ValordoTag = {NomedoTag.Value}.
Hi: Tag >= limite HiHi: Tag >= limite (quando reconhecido automaticamente, reconhece o alarme Hi para o mesmo Tag) Lo: Tag <= limite LoLo: Tag <= limite (quando reconhecido automaticamente, reconhece o alarme Lo para o mesmo Tag) RateOfChange: Taxa de alterao do Tag >= limite DeviationMinor: Valor absoluto (Tag - Setpoint) > limite (Setpoint definido na coluna Setpoint) DeviationMajor: Valor absoluto (Tag - Setpoint) > limite (Setpoint definido na coluna Setpoint) Equal: Tag = limite GreaterThan: Tag > limite GreaterEqual: Tag >= limite LessThan: Tag < limite LessEqual: Tag <= limite Changed: valor do Tag foi alterado ChangedUp: valor do Tag aumentou ChangedDown: valor do Tag diminuiu
Critical (mensagens crticas que exigem reconhecimento) SystemEvent (log de eventos de sistema) Warning (mensagens de advertncia que no exigem reconhecimento)
Editando Banco de Dados Conforme mencionado anteriormente, o mdulo de conjunto de dados (Datasets) includo no BluePlant fornece uma interface de fcil operao para a troca de dados em tempo real com bancos de dados externos, XML, CSV ou arquivos de texto, bem como a possibilidade de acessar tabelas e
62
6. Componentes do BluePlant consultas SQL. O banco de dados em tempo real garante, sem a necessidade de qualquer programao adicional, a sincronizao de dados entre vrios processos no servidor e mltiplas estaes cliente. Um vasto conjunto de propriedades internas, tais como qualidade de dados, estampa de tempo, bloqueio de estado e valor bloqueado simplificam a criao de aplicaes. DBs Atravs da guia DBs possvel acessar a configurao do banco de dados. A partir do boto possvel selecionar o provedor do banco de dados e uma nova conexo. Name Estabelece o nome para o DB. Provider Seleciona o fornecedor para o DB quando da criao de uma nova conexo de base de dados. Os fornecedores padro so: Odbc Data Provider - Permite o acesso a um banco de dados ODBC atravs de um driver ODBC nativo OleDb DataProvider - Fornece aplicativos para acesso aos dados armazenados em diversas fontes de informao SqlClient Data Provider - uma coleo de classes que podem ser usadas para acessar bancos de dados SQL Server Microsoft SQL Server Compact Data Provider - Fornece acesso aos bancos de dados Microsoft SQL Server Compact TatsoftDB 4 direct connection Permite acesso ao banco de dados TatsoftDB 4
Outros fornecedores podem ser criados adicionando-se modelos XML ao produto na subpasta "DBProviders" localizada na pasta de instalao do software BluePlant. Exemplos de provedores de dados: Database Seleciona o banco de dados quando da criao do objeto DB. A lista de base de dados disponveis criada dinamicamente baseada em fornecedores encontrados na subpasta "DBProviders" localizada na pasta de instalao do software BluePlant. As bases de dados mais comuns so: Microsoft Access Database Microsoft Excel Database ODBC DSN ODBC FILEDSN SQL Server Database OdbcDataProvider Firebird database Microsoft Access Database Microsoft Excel Database ODBC using DSN ODBC using fileDSN Oracle Database SQL Server Database
63
6. Componentes do BluePlant Connectionstring Esta coluna permite definir a string de conexo usada para comunicar-se com o banco de dados. Para tanto, digite o caminho da fonte de dados onde est localizado o arquivo do banco de dados. Clique em NameLogon Define o nome do logon para conectar-se com o banco de dados. Password Senha solicitada para conectar-se com o banco de dados. Este campo pode ser editado somente pelo usurio Administrador (usurio ID: 2). Conexo com Excel Conecta o Excel usando um driver ODBC, ODBC DSN ou OleDB. Para a conexo via ODBC devese proceder conforme segue: 1. Selecione e nomeie uma faixa de linhas e colunas na planilha. Isto permitir ao BluePlant ler as informaes como uma tabela 2. Escolha um dos seguintes processos de nomeao de acordo com a verso do Microsoft Excel No Microsoft Office 2007: clique com o boto direito na seleo e escolha "Nomear uma Faixa". A Figura 6-19 ilustra essa opo. para testar se a fonte de dados foi localizada e est vlida.
Figura 6-19. Conexo com Excel 2007 No Microsoft Office 2003: no Microsoft Excel v para "Inserir > Nome > Definir". A Figura 6-20 ilustra essa opo.
64
Figura 6-20. Conexo com Excel 2003 D um nome seleo (por exemplo, "itemsTable"). O arquivo Excel est pronto para uso.
Figura 6-21. Configurao da Conexo com Provider Excel 2003 Os passos para criar uma nova conexo com banco de dados esto ilustrados na Figura 6-21 e descritos a seguir: 1. 2. 3. 4. 5. Selecionar o menu Edit Acessar o item Datasets Clicar na guia DBs para acesso as conexes criadas com bancos de dados Boto para criar uma nova conexo com Excel 2003, conforme pode ser visto na Figura 6-22 Na coluna Connectionstring onde se configura a conexo e teste com o banco de dados. Na Figura 6-23 pode ser visualizada a configurao e teste
65
Figura 6-22. Criar uma Nova Conexo com Banco de Dados
Figura 6-23. Teste da Conexo com Banco de Dados Por outro lado, para configurar uma base de dados do tipo ODBC DSN proceda conforme indicado a seguir: No painel de controle do computador selecione "Administrative Tools" e d um clique duplo em "Data Sources (ODBC)", conforme Figura 6-24. No caso onde o sistema operacional for Windows 64 bits, o acesso atravs do arquivo C:\Windows\SysWOW64\odbccad32.exe.
Figura 6-24. ODBC com DSN
66
Figura 6-25. "ODBC Data Source Administrator" Na janela "ODBC Data Source Administrator" clique na opo de Add.... Ser solicitado que seja selecionado um driver. Selecione o "Microsoft Excel Driver (*.xls)" e seguinte tela deve aparecer conforme a Figura 6-26.
Figura 6-26. Configurao da base de dados Clique em Selecionar pasta de trabalho e selecione o nome do arquivo Excel criado anteriormente. (por exemplo, "excelDatasource"). Para acesso de Escrita desmarque a checkbox "Somente leitura". No namespace do Datasets do BluePlant, escolher a guia "DBs" e criar um novo provider na opo correspondente. Nas opes do "Odbc Data Provider" escolha "ODBC using DSN" e clique em Ok. Na coluna Connectionstring da nova linha, entre com DSN no campo apropriado e clique no boto teste para verificar a conexo com o Excel.
67
Figura 6-27. Teste da Conexo Base de Dados ODBC Para conectar o provider OLEDB com o Excel, pode ser feito atravs dos passos abaixo: No namespace do Datasets do BluePlant, escolha a guia "DBs. Selecione a opo "OleDb data provider" na caixa-combo e crie um novo provider na opo correspondente. Escolha "Microsoft Excel Database" e clique em Ok. Clique na coluna Connectionstring do novo provider inserido, entre com o caminho e o nome do arquivo Excel (.xls) no campo "DataSource" conforme mostrado na Figura 6-28.
Figura 6-28. Teste da Conexo Base de Dados OLEDB
Conexo com Banco de Dados Oracle O provider Oracle Oracle.DataAccess.Client utilizado no exemplo de conexo com banco de dados Oracle, est disponvel para download gratuito no seguinte endereo: http://www.oracle.com/technology/software/tech/windows/odpnet/index.html Para criar uma conexo com banco de dados Oracle clique em provider instalado conforme mostrado na Figura 6-29. e selecione o
68
Figura 6-29. Inserindo Provider Oracle Deve ser inserido o usurio e senha do banco de dados para garantir que a conexo seja estabelecida. Para a insero as colunas LogonName e Logon Password devem ser preenchidas com usurio e senhas previamente cadastradas no banco de dados.
Figura 6-30. Usurio e Senha para Conexo com Banco de Dados Oracle Acessar os campos da coluna ConnectionString para inserir as configuraes do endereo IP, porta e o SID do banco para estabelecer a conexo, conforme pode ser visto na Figura 6-31.
Figura 6-31. Configurao do Endereo IP, Porta e SID do Banco de Dados Oracle Depois de configurado o endereo IP, porta e SID, para verificar se a conexo com o banco de dados Oracle est funcionado, basta clicar no boto Test e deve aparecer o resultado semelhante ao da Figura 6-32.
69
Figura 6-32. Teste de Conexo com Banco de Dados Oracle
ATENO: O provider utilizado no exemplo para conexo com banco de dados Oracle, requer clientes Oracle na verso 9.2 ou anteriores. O provider Oracle que acompanha o BluePlant o System.Data.OracleClient, requer clientes Oracle na verso 8.1.7 ou superiores. Conexo com Banco de Dados SQLServer
Figura 6-33. Insero de um Provider SQLServer Os passos para criar uma nova conexo com banco de dados SQLServer esto ilustrados na Figura 6-33 e descritos a seguir: 1. 2. 3. 4. 5. 6. Selecionar o menu Edit Acessar o item Datasets Clicar na guia DBs para acesso as conexes criadas com bancos de dados Atravs do boto Crate new..., criar uma nova conexo com banco de dados SQLServer Configurar o usurio e senha do banco de dados nas colunas LogonName e LogonPassword Na coluna Connectionstring deve ser configurada a conexo e realizar teste de conexo com o banco de dados SQLServer
Tables A guia Tables permite acessar as tabelas de dados a partir das bases de dados configuradas (DBs). A Figura 6 27 ilustra essa seleo.
70
Figura 6-34. Edio de Tabelas de Dados Os passos para editar ou incluir tabelas esto ilustrado na Figura 6-34 e descritos a seguir: 1. 2. 3. 4. 5. 6. 7. 8. Name Indica o nome da Tabela usada nos objetos Runtime. DB Indica o nome da DB (conexo da Base de Dados) a qual pertence tabela de dados. TableName Indica o nome da tabela assim como no banco de dados. WhereCondition Indica qual a condio em que a instruo SQL ser executada. Access Define a poltica de segurana com operaes permitidas para esta DataTable. As opes so: Read (leitura) Insert (insero) ReadWrite (leitura e escrita) Unrestricted (irrestrita) Selecionar o menu Edit Acessar o item Datasets Clicar na guia Tables para acesso s configuraes das tabelas Incluir ou editar o nome da tabela na linha marcada com um asterisco (*) Selecionar qual conexo com o banco de dados previamente criado ser utilizada Selecionar qual a tabela do banco de dados que ir comunicar Selecionar qual a permisso de acesso ao banco de dados para a tabela que configurada Configurar na coluna Mapping os tags relacionados com as colunas da tabela do bando de dados
71
6. Componentes do BluePlant Mapping Mapeia os contedos da tabela de dados com os objetos Tag. Ao executar os comandos de seleo e prximo, a primeira linha no resultado selecionado aplicada aos tags. Ento, ao executar o comando de atualizao, os contedos do Tag so escritos na linha. Queries Esta guia mapeia as bases de dados configuradas (DBs) conforme mostrado na Figura 6-35.
Figura 6-35. Edio de Queries Os passos para editar ou incluir instrues SQL(queries) esto ilustrados na Figura 6-35 e descritos a seguir: 1. 2. 3. 4. 5. 6. 7. Name Nome para o objeto Query usado nos objetos de Runtime. DB Nome da conexo do banco de dados usada para o armazenamento dos queries. SQLStatement Instruo SQL utilizada para realizar consultas no banco de dados. Selecionar o menu Edit Acessar o item Datasets Clicar na guia Queries para acesso s configuraes das instrues SQL Incluir ou editar o nome da instruo na linha marcada com um asterisco (*) Selecionar qual conexo com o banco de dados previamente criado que ser utilizada Configurar a instruo SQL na coluna SqlStatement Configurar na coluna Mapping os tags relacionados s colunas da tabela do bando de dados.
72
6. Componentes do BluePlant Mapping Mapeia os contedos da tabela de dados em tags. Ao executar o comando de seleo, a primeira linha no resultado aplicada aos tags. Files A guia Files define o(s) arquivo(s) para a troca de informaes com os bancos de dados conforme ilustrado na Figura 6-36.
Figura 6-36. Edio Arquivos de Bancos de Dados Os itens que compem o menu edio de arquivos de bancos de dados esto numerados na figura anterior e so descritos na sequncia: 1. Selecionar a opo files clicar com o boto esquerdo do mouse 2. Clicar com o boto direito do mouse em um cabealho de coluna para visualizar os itens desejados 3. Observar que os dados relativos aos arquivos iro aparecer nas linhas da tabela Na sequncia so explicados os itens de edio de arquivos de bancos de dados conforme a ilustrao da Figura 6-36. Name Define o nome do arquivo usado nos objetos de Runtime. FileName Nome do arquivo e caminho. Exemplo: C:\BDs\file1.txt. FileType Caracteriza os tipos de arquivo. Os tipos de arquivo possveis so: ASCII (codificao de caracteres de sete bits baseada no alfabeto ingls) Unicode (representao e manipulao de texto) XML (linguagem de marcao para a criao de documentos com dados organizados hierarquicamente)
73
6. Componentes do BluePlant Objects Mapeia os contedos do arquivo com objetos Tag. Editando Scripts Um script pode ser executado na ocorrncia de um evento de disparo ou ciclicamente atravs da definio de um intervalo de tempo para tal. As opes que compem o menu de edio de scripts esto detalhadas na sequncia. Tasks A Figura 6-37 enfatiza a aba Tasks para edio de tarefas de script. Existem quatro tarefas incorporadas: ServerStartup o script executado na mquina do Servidor (TServer.exe) quando o projeto entra em execuo ServerShutdown - o script executado na mquina do Servidor na parada da operao ClientStartup - o script executado em cada mquina cliente quando o TVisualizer.exe (mdulo de telas) inicia sua execuo ClientShutdown - o script executado em cada mquina cliente quando o mdulo de telas encerrado
Figura 6-37. Edio de Tarefas de Script Os itens que compem o menu de edio de tarefas de script esto numerados na figura anterior e so descritos na sequncia: 1. Selecionar a guia Tasks 2. Selecionar as opes de configurao das colunas da tabela desejadas clicando com o boto direito do mouse no cabealho de uma coluna e marcando os itens para exibio 3. Observar: os dados relativos s tarefas de script iro aparecer nas linhas da tabela Na sequncia so explicados os itens do menu edio de tarefas de script conforme a ilustrao da Figura 6-37. Name Indica o nome para o objeto Script. Code Define a linguagem do Script. O usurio pode selecionar entre VBdotNet ou CSharp.
74
6. Componentes do BluePlant Trigger Tag ou objeto que dispara a execuo da Tarefa. A tarefa executada quando o valor do objeto muda. Period Perodo de tempo para executar uma Tarefa. Domain Define se o Script executado na estao do Servidor ou em cada estao Cliente. BuildStatus Indica o status da ltima compilao: verde significa compilado com sucesso e vermelho indica erro de compilao BuildErrors Status de contagem de erro a partir da ltima compilao do Script. Atributos associados: ReadOnly (somente leitura). Classes Nesta opo esto listadas as classes definidas pelo usurio via biblioteca de mtodos. A Figura 6-38 mostra esse item do menu Script. H duas UserClasses incorporadas: ServerMain: biblioteca de mtodos disponvel para todas as tarefas do servidor e clientes ClientMain: biblioteca de mtodos disponvel para todos clientes scripts, inclusive telas scripts
Figura 6-38. Classes de Script Os itens que compem o menu de edio de classes de script esto numerados na figura anterior e so descritos na sequncia: 1. Selecionar a guia Classes 2. Selecionar as opes de configurao das colunas da tabela desejadas clicando com o boto direito do mouse no cabealho de uma coluna e marcando os itens para exibio 3. Observar: os dados relativos s classes de script iro aparecer nas linhas da tabela
75
6. Componentes do BluePlant Na sequncia so explicados os itens do menu de edio de tarefas de script conforme a ilustrao da Figura 6-38. Name Indica o nome da classe do usurio. Code Indica a linguagem do Script. O usurio pode selecionar entre VBdotNet ou CSharp. Domain Define se os mtodos nessa classe de usurio sero visveis para os scripts do Servidor ou Cliente. CodeEditor Trata-se do painel editor de cdigo das tarefas e classes de usurio conforme ilustrado na Figura 6-39 (Item 1). As opes de linguagem de programao so: VBdotNet ou CSharp. A seleo da linguagem est ilustrada na Figura 6-39 (Item 2). Informaes sobre a sintaxe das linguagens de programao podem ser obtidas no seguinte endereo http://www.microsoft.com/net.
Figura 6-39. CodeEditor
76
6. Componentes do BluePlant Utilizando Tarefas de Script
Figura 6-40. Tarefas de Scripts Os passos para editar ou incluir uma tarefa de script esto ilustrados na Figura 6-40 e descritos a seguir: 1. 2. 3. 4. 5. Selecionar o menu Edit Acessar o item Scripts Clicar na guia Tasks para acesso s tarefas de scripts configuradas no sistema Incluir ou editar o nome da tarefa na linha marcada com um asterisco (*) Configurar a varivel de disparo ou o perodo que a tarefa de script ser executada, atravs das colunas Trigger ou Period 6. Selecionar em qual ambiente (cliente ou servidor) a tarefa ser executada A Figura 6-41 a seguir apresenta os passos para a codificao da tarefa de script chamando o mtodo de uma classe existente.
Figura 6-41. CodeEditor das Tarefas de Scripts
77
6. Componentes do BluePlant 1. 2. 3. 4. Clicar na guia CodeEditor para acesso ao ambiente de codificao Digitar o cdigo no espao demarcado Clicar no cone para compilar o cdigo Verificar a existncia de erros no script codificado
ATENO: Para utilizar os namespaces no ambiente de codificao obrigatrio digitar o caractere @ antes do namespace, caso contrrio ser utilizado como uma varivel local gerando possveis erros na compilao. Editando Displays A opo Displays do menu Edit permite a configurao do mdulo associado s telas. Esse mdulo contempla o repositrio das telas (Displays), seus modos de operao (Layouts) e imagens (Resources). Displays A guia Displays, quando selecionada, lista as telas que compem o projeto. A visualizao da lista de telas pode ser no formato de tabela ou carto. O seletor Card View/Table View permite alternar o modo de visualizao. A Figura 6-42 ilustra esse ambiente no formato de tabela.
Figura 6-42. Edio de Displays Os itens que compem o menu de edio de telas esto numerados na figura anterior e so descritos na sequncia: 1. Acesso guia Displays 2. Clicar com o boto direito do mouse em qualquer um dos cabealhos de coluna para selecionar as opes de configurao a serem exibidas 3. Clicar na linha da tela para alterar as configuraes
78
6. Componentes do BluePlant Name Nome da tela. Mode Modo de operao da tela (Pgina, Dilogo ou Popup). Essas opes so detalhadas na sequncia: Pgina: este o modo de exibio padro. Quando uma Pgina aberta automaticamente, a ltima pgina do layout atual fechada Dilogo: uma tela de Dilogo se abre como um "Window Modal Dialog". Isto significa que os comandos em todas as outras telas abertas ficam desabilitados. Ao clicar em OK no dilogo o mtodo On OK na tela CodeBehind executado Popup: uma tela de popup abre-se acima das outras telas. Ao abrir uma nova Pgina, por padro, todas as telas de popup so fechadas
Preview Visualizao da imagem da tela. AlowSelection Marca indicando se a tela est listada no objeto DisplaySelection quando em execuo. AllowSelection uma funo utilizada pelo criador da aplicao/projeto para remover a seleo de pgina, teste e outras telas do operador padro e assegurar que os itens removidos estejam disponveis somente para contextos especficos da aplicao. O mtodo incorporado para definir a seleo da tela ao rodar a aplicao a funo "PageSelecter" que configurada na guia Editar>Telas>Telas. Para impedir essa seleo pelo operador padro remova o marcador da pgina ou da opo "AllowSelection" na coluna dos objetos. RunSecurity Grupos de permisses de segurana exigidos para abrir esta tela durante o Runtime. Clique no campo "Run Security" para abrir a janela "Run Security Selection". Aps concluir as selees clique em qualquer lugar na tabela para fechar a janela de seleo. Suas selees aparecero no campo "RunSecurity" da linha da tabela.
Figura 6-43. Permisses no Runtime
Configurando Mltiplos Monitores Os passos para configurar mltiplos monitores esto ilustrados na Figura 6-44 e descritos abaixo:
79
Figura 6-44. Configurando Mltiplos Monitores 1. 2. 3. 4. 5. 6. Selecionar o menu Edit Acessar o item Displays Clicar na guia Displays para acesso as configuraes das telas j existentes no projeto Configurar a quantidade de monitores que deseja utilizar Selecionar para cada monitor o layout correspondente que ir abrir quando executar o projeto Clicar no boto Clients a realizar a configurao dos Clientes rich no Runtime (uma configurao nica para todos os clientes rich). Conforme Figura 6-45
80
Figura 6-45. Configuraes dos Clientes Rich
Layouts Edita os layouts do projeto. Layouts so containers (DockPanels) que definem o modo da tela durante a execuo. A ltima tela listada no layout aquela que ser alterada sob o comando Client.OpenDisplay(). As demais que permanecem abertas normalmente contm informaes tais como menus de navegao, linhas de alarme e informaes de aplicao global. O projeto pode ter apenas um layout, ou pode ser alterado dinamicamente atravs do comando Client.OpenLayout(). Clique para criar um novo layout. Clique ou para acrescentar ou excluir pginas no
layout selecionado e para navegar para cima e para baixo na lista da pgina. As dimenses do layout podem ser definidas usando os campos largura e altura, podendo alterar o fundo para uma cor ou imagem. A Figura 6-46 ilustra a configurao dos layouts.
81
Figura 6-46. Edio de Layouts Os passos para editar e incluir um novo layout esto ilustrados na Figura 6 46 descritos a seguir: 1. 2. 3. 4. 5. Selecionar o menu Edit Acessar o item Displays Clicar na guia Layouts para acesso as configuraes dos layouts j existentes no sistema. Clicar no boto New para adicionar um novo layout Configurar as dimenses e cor de fundo do layout correspondente .
6. Configurar a quantidade de telas que o layout ir apresentar utilizando os botes 7. Selecionar as telas e suas posies no layout Page
Nome da tela usada neste Layout. Somente telas do modo PGINA podem ser includas em layouts. Docking Define a posio de encaixe da Tela. As opes possveis so: Esquerda Topo Direita Inferior
A posio de encaixe pode ser alterada clicando-se uma vez no campo da tabela e selecionando-se a posio desejada.
82
6. Componentes do BluePlant HorizontalAling Define o alinhamento horizontal. As opes possveis so: VerticalAling Define o alinhamento vertical. As opes possveis so: Margins Define as margens da tela dentro do DockPanel. Todas as medidas da tela no projeto (tamanho, largura, etc.) so em unidades WPF (Windows Presentation Foundation). Resources Esta guia lista os recursos das telas. Para habilitar uma execuo distribuda para as telas em Runtime e Clientes Web (ao usar imagens em telas e relatrios), importe a(s) imagem(ns) para os recursos do projeto atravs de em vez de selecionar um nome de arquivo. Um benefcio adicional da guia Recursos que quando a imagem substituda no ResourceDictionary (o Nome do Recurso no alterado) todas as referncias a este recurso nas Telas e Relatrios so automaticamente atualizadas. A Figura 6-47 ilustra as trs etapas do menu de edio de recursos. Topo Centro Inferior Esquerda Centro Direita
83
Figura 6-47. Edio de Recursos Os passos para importar novas imagens esto ilustrados na Figura 6 47 e so descritos a seguir: 1. 2. 3. 4. Name Nome para o objeto Recurso. Clique no campo da tabela para alterar o nome do objeto. Preview Visualizao da imagem do Recurso. Editando Relatrios O editor de relatrio permite a incluso de texto dinmico, smbolo dinmico, grfico, conjunto de dados e consulta de resultados em um editor completo e de fcil utilizao. A configurao da guia Reports est ilustrada na Figura 6-48. Selecionar o menu Edit Acessar o item Displays Clicar na guia Resources para acesso a todas as imagens j importadas para o projeto Clicar no boto Import Images... para selecionar e importar a imagem
84
Figura 6-48. Configurao de Relatrios Os passos para editar ou incluir um novo relatrio esto ilustrados na Figura 6-48 e so descritos a seguir: 1. 2. 3. 4. 5. Selecionar o menu Edit Acessar o item Reports Clicar na guia Reports para acesso a todos os relatrios previamente criados no projeto Incluir ou editar o nome do relatrio na linha marcada com um asterisco (*) Configurar as caractersticas do relatrio como alinhamento dos dados, formato e nome do arquivo no qual ser gerado o relatrio 6. Clicar na guia TextEditor para editar o formato do relatrio. A Figura 6-49 mostra com maiores detalhes
85
Figura 6-49. Edio de Relatrio
Name Indica o nome do relatrio a ser gerado. Padding Define os ajustes ao substituir um TagName por seus valores. As opes possveis so: Compact (compacto), PadRight (ajuste direita) e PadLeft (ajuste esquerda). O ajuste usa o nmero de valor exato configurado no modelo do relatrio ao cri-lo no Runtime. O valor do alinhamento esquerda ou direita dentro do espao est tambm includo. SaveFormat Define o formato do arquivo usado ao salvar o relatrio. As opes possveis so: XPS, HTML, Unicode, PDF e ASCII. Save File Name Define o nome do arquivo usado e onde ser salvo o relatrio. Este campo pode incluir os valores dos tags avaliados quando da gerao de um alarme, por exemplo. Para tanto, acrescente o nome do Tag nesta clula da tabela usando a notao de associao XAML entre chaves. Exemplo:
C:\MYREPORT.XPS C:\MYREPORT-MONTH{SERVER.MONTH}-DAY{SERVER.DAY}.XPS
TextEditor Esta guia contempla um editor de texto para criao de relatrios conforme ilustrado na Figura 6-50.
86
Figura 6-50. Editor de Texto A Figura 6-51 mostra a edio e salvamento de um relatrio com o auxlio do editor de texto embutido no software.
Figura 6-51. Edio e Salvamento no Editor de Texto A Figura 6-52 mostra a consolidao do formulrio editado na figura anterior com algumas configuraes disponveis no menu de edio de relatrios.
Figura 6-52. Configurao de um Relatrio
Menu Draw
O ambiente de telas fornece acesso a todas as ferramentas de diagramao para compilar as telas da aplicao. Este ambiente inclui as seguintes opes: tela, cdigos e smbolos. A opo Draw permite o desenho de Telas e Smbolos. Use a barra de ferramentas vertical na tela para selecionar um componente ou use a ferramenta de seleo para mover, agrupar e redimensionar componentes. A Figura 6-53 mostra a barra de ferramentas vertical.
87
Figura 6-53. Menu Draw e Barra de Ferramentas Vertical Os passos para a incluso de um smbolo na tela esto numerados na figura anterior e so descritos na sequncia: 1. Selecionar o smbolo a ser includo, clicando uma vez no desenho correspondente na barra de ferramentas vertical. O smbolo ser destacado 2. Clicar e arrastar o smbolo para a tela 3. Soltar o boto esquerdo do mouse para finalizar a incluso do smbolo A barra de ferramentas horizontal (localizada na parte inferior da tela) contm comandos para agrupar, combinar, alinhar e bloquear o(s) smbolo(s) selecionado(s). A seguir ser descrito o uso da barra de ferramenta horizontal, bem como alguns comandos do menu de contexto conforme ilustra a Figura 6-54.
Figura 6-54. Menu Draw e Barra de Ferramenta Horizontal
88
6. Componentes do BluePlant A sequncia de passos para a configurao das propriedades de um smbolo : 1. Selecionar smbolo com o boto esquerdo do mouse. Para selecionar mltiplos smbolos use SHIFT+CLICAR COM BOTO ESQUERDO em cada componente desejado 2. Clicar no smbolo com o boto direito do mouse para abrir o menu de contexto 3. Selecionar a opo desejada no menu de contexto 4. Aplicar as propriedades desejadas para o(s) smbolo(s) usando a barra de ferramentas Os itens que compem a Barra de Ferramentas Vertical ilustrada na Figura 6-55 esto detalhados na sequncia.
Figura 6-55. Barra de Ferramentas Vertical
Ferramentas de Seleo Use as ferramentas de seleo para selecionar um objeto e modificar a rea de visualizao do desenho. Ferramenta de Seleo Clique uma vez no objeto para selecion-lo. A tecla CTRL+CLIQUE DO MOUSE permite a seleo de vrios objetos ao mesmo tempo, assim como grupos de objetos. Mantenha pressionada a tecla CTRL enquanto clica em cada objeto. Para alternar a visualizao entre os vrios objetos selecionados utilize a tecla SHIFT+CLIQUE DO MOUSE. Clique em uma rea aberta da tela e selecione um grupo de elementos, destacando os elementos desejados enquanto mantm pressionado o boto esquerdo do mouse. Clique duas vezes em um objeto para abrir a janela de configurao dinmica que fornece as configuraes para as propriedades do objeto dinmico. Ferramenta de Seleo Direta Use esta ferramenta para selecionar um objeto dentro de um grupo e modificar suas propriedades. Clique uma vez no objeto para selecion-lo. possvel adicionar, remover e modificar os pontos em
89
6. Componentes do BluePlant uma Polyline atravs desta ferramenta. Para mover o ponto, selecione-o com um clique e pressione o boto esquerdo do mouse. Arraste o ponto para a sua nova posio. Clique duas vezes em um ponto para adicionar um novo ponto adjacente ao ponto selecionado. Clique no boto direito do mouse em um ponto para excluir o ponto selecionado. Ferramenta Mo Use a ferramenta de mo para modificar a janela de exibio. Clique uma vez na tela de fundo e, mantendo pressionado o boto esquerdo do mouse, mude a tela para a posio desejada. Objetos Geomtricos. Cria um objeto Retngulo. Cria um objeto Elipse. Cria um objeto Polgono. Cria um objeto Polyline. Clique com o boto direito do mouse para finalizar o uso de cada ferramenta. Para mais informaes de como adicionar, modificar e remover pontos aps a criao de um polgono ou polyline est descrito na seo Ferramentas de Seleo. Componentes de Tela Estes objetos criam componentes de telas. Cria um objeto Boto. Cria um objeto Checkbox. D um clique com o boto direito no cone do componente para acessar as ferramentas em um menu popup horizontal. Aps a ferramenta ter sido selecionada no menu horizontal, ela torna-se a ferramenta padro para aquela posio na barra vertical. Cria um objeto RadioButton. Cria uma ComboBox. Cria uma ListBox. Cria uma PasswordBox. Cria um Controle DatePicker. Cria uma DateTimeTextBox. Entrada e Sada de Texto Use as ferramentas de texto para criar objetos de entrada ou sada de texto. Cria um objeto TextOutput (TextBlock) conforme ilustrado na Figura 6-56.
90
Figura 6-56. Objeto TextOutput Um clique com o boto direito do mouse no objeto permite acessar o menu suspenso de edio associado sada de texto, incluindo sua Configurao Dinmica que tambm pode ser acessada atravs de um duplo clique no objeto. Cria um objeto TextIO (TextBox object) conforme mostrado na Figura 6-57.
Figura 6-57. Objeto TextIO Um clique com o boto direito do mouse no objeto permite acessar o menu suspenso de edio associado entrada/sada de texto, incluindo sua Configurao Dinmica que tambm pode ser
91
6. Componentes do BluePlant acessada atravs de um duplo clique no objeto. Por exemplo, para vincular o TextIO com o Tag, d um clique duplo no objeto TextIO e, na janela de configurao dinmica, escolha a dinmica TextIO. Biblioteca de Smbolos Abre a biblioteca de smbolos. Esta biblioteca inclui smbolos incorporados e definidos pelo usurio. Controles Avanados Cria um objeto WebBrowser. D um clique com o boto direito no cone do componente para acessar as ferramentas em um menu popup horizontal. Aps a ferramenta ter sido selecionada no menu horizontal, ela torna-se a ferramenta padro para aquela posio na barra vertical. Cria um objeto PageSelector. Cria um objeto ReportViewer. Cria um objeto XpsViewer. Cria um objeto CircularPanel. Cria um objeto Calculadora. Inclui um componente controle WPF. Alarme Objeto alarme para controlar advertncias. Cria uma Janela de Alarme. Este item permite criar e posicionar a janela de alarme que tem a aparncia mostrada na Figura 6-58.
Figura 6-58. Janela de Alarmes
92
Figura 6-59. Configurao da Janela de Alarme Control Name: Nome qualquer dado ao controle. utilizado via CodeBehind para relacionar o objeto grfico a uma classe .Net. (TAlarmWindow) MaxLines: Nmero mximo de linhas que ser apresentado no objeto. O filtro feito no servidor, portanto, os dados nem chegam a ser enviados do servidor para o cliente com a finalidade de ganhar desempenho. List: Tipos de alarmes que sero apresentados no objeto. OnlineAlarms: Somente alarmes online AlarmsHistory: Somente alarmes histricos Events: Somente eventos AlarmsHistory+Events: alarmes histricos mais os eventos
History Interval: DateTimeOffset representando o incio do perodo de histrico. History Interval (To): DateTimeOffset representando o fim do perodo de histrico. Ack by Page: Configurao de um objeto que quando recebe um trigger reconhece todos os alarmes visveis no objeto de alarme. Show Column Titles: Habilita mostrar os ttulos das colunas. Show group control: Habilita a rea onde pode arrastar os nomes das colunas para fazer agrupamentos.
93
6. Componentes do BluePlant Show group control (Label): Texto que aparecer dentro da rea do "Group control:" AllowSort: Habilita a funcionalidade de sort no lado direito de cada coluna. Allow Column Reorder: Habilita a funcionalidade de arrastar a coluna para o lugar de outra coluna trocando assim a ordem entre elas. Display Value Column as String: Habilita substituir na coluna "Value" o valor pela sua string correspondente, configurado no dicionrio. Filter: Este campo um "where" de um sql statement, portanto, a sintaxe vlida qualquer coisa vlida em um where sql, levando em conta os nomes das colunas existente no objeto.Ex:
[TagName] = 'Tag.Tag1' AND [Group] = 'Alarm.Group.Critical'
Refresh: Configurao de um objeto que quando recebe um trigger faz um refresh do objeto de alarme. Display Millisecond: Habilita a visualizao dos milissegundos na formatao das datas. Ack Selected Line: Configura o hotkey ou combinao de hotkeys para reconhecer a linha selecionada no objeto de alarme. Lista de Columns: Atravs das setas para cima e para baixo, podemos mudar a ordem na qual as colunas sero visualizadas no objeto de alarme. Para cada coluna podemos configurar: Visible: Habilita se a coluna estar visvel ou no. Allow Filter: Habilita a opo de Filtro na coluna. Show in column chooser: Permite selecionar e arrastar a coluna. Title: Configura o ttulo que ser visualizado no cabealho da coluna. Width: Configura a largura da coluna. Sort: Configura o tipo de sort sue ser aplicado automaticamente na coluna. Tendncia O objeto Tendncia mostra o registro do historiador de um tag. Cria uma janela de tendncia. Posicione a janela de tendncia e com um duplo clique abra a janela de configurao. Campos associados:
94
Figura 6-60. Configurao da Janela de Tendncia ControlName: Define um nome para o controle, desta forma pode ser acessado no script cdigo associado. Consulte: Acesso ao objeto Tela no script associado. 0(online) 1(history): 0 - o controle mostra os dados online. 1 - o controle mostra os dados do historiador. Ex:
Tag.onLineHist
OnlineTrigger: Taxa de atualizao do controle de tendncia online.Ex:

00:00:01 ou {Tag.trendTimeSpan}
HistoryDateTime: O ponto inicial para o controle de tendncia do historiador. Ex:

{Tag.initialTrendHistory}
Max Samples: Define a quantidade mxima de amostras a serem coletadas do banco de dados Window: Define a cor da tela de fundo do controle de tendncia Labels: Define a cor dos rtulos do controle de tendncia Cursor Enable: Habilita (selecionado) ou desabilita (no selecionado) o cursor vertical CursorPosition (%): Indica a posio do cursor, onde 0 significa posio inicial e 100 a posio final. Ex:
Tag.cursorPos
Cursor Output: Indica o valor do eixo X para a posio atual do cursor. Ex:
Tag.cursorOut
Cursor Color: Define a cor do cursor Legenda das canetas: Define a posio da legenda das canetas no controle de tendncia. Eixo Y
95
6. Componentes do BluePlant Range: Define os valores mnimo e mximo para o eixo Y. Labels: Define a quantidade de linhas de grade horizontais. Format: Formato dos valores no eixo Y. Para formatos numricos vlidos, consulte o item referente ao formato dos tags. Ex: N1 (nmero com 1 casa decimal). Eixo X Interval: Define o TimeSpan do eixo X. Labels: Define a quantidade de linhas de grade horizontais. Format: O formato do eixo X definido por dois campos: formato da primeira e da segunda linha. Isto especialmente til para representar marcas de rtulo que requerem dois nveis de informao. Para formatos de data e tempo vlidos consulte o item referente ao formato dos tags. Ex: T (Tempo) para o formato da primeira linha, d (data abreviada) para o formato da segunda linha. Canetas Visvel: Mostra (1) ou oculta (0) a caneta selecionada. Ex: 1 ou {showPen1} Tag: Define o Tag que fornecer o valor para a caneta. Min: Referncia de escala linear para o valor do tag, de acordo com a faixa do eixo Y. Max: Referncia de escala linear para o valor do tag, de acordo com a faixa do eixo Y. Caneta: Define o estilo, cor e espessura da linha da caneta. Marca: Define a marca para cada ponto na linha de tendncia. CursorValue: Define o tag que receber o valor real do eixo Y, de acordo com a posio do cursor. Ex:
Tag.pen1CursorValue.
FieldName: Define o nome da caneta. Escala do Eixo Y: Considera-se, por padro, o mnimo como zero e o mximo como 100. O controle de tendncia permite que vrias canetas sejam exibidas junto. Quando as suas canetas no esto na mesma faixa use as dicas abaixo para ajustar os dados no mesmo grfico e assim obter uma melhor visualizao. Se alguma caneta apresentar uma faixa inferior, 0 a 1, por exemplo, pode-se configurar a propriedade mxima da caneta para 1. Assim, quando o valor do real for 1, o valor 100 ser exibido no grfico (escala 100/1). Se alguma caneta apresentar uma faixa superior, 0 a 1000, por exemplo, pode-se configurar a propriedade mxima da caneta para 1000. Assim, quando o valor do real for 1000, o valor 100 ser exibido no grfico (escala 1/10). Grade de Dados Cria uma janela DataGrid. Posicione a janela DataGrid e d um duplo clique para abrir a janela de configurao.
96
Figura 6-61. Configurao da Janela do DataGrid Control Name: Nome qualquer dado ao controle. utilizado via CodeBehind para relacionar o objeto grfico a uma classe .Net. (TDataGridWindow) Data Source: Objeto dataset no qual quer se mostrar o contedo no DataGrid. Pode ser tanto Dataset.Table quanto Dataset.Query. Selected Values: Tag array do tipo Text, onde o contedo de cada coluna ser colocado dentro de cada posio do array. Selected Index: Objeto que recebe qual a linha que esta selecionada. Lines Count: Objeto que recebe a quantidade de linhas existente no DataGrid. Theme: Seleo do tema visual que ser utilizado. Binding mode: Seleciona a forma do fluxo de dados: OneTime: O objeto grid populado somente uma nica vez. OneWay: Os dados somente saem do banco de dados para popular o GRID. TwoWay: Os dados saem do banco para popular o GRID, e quando modificado no GRID so atualizados tambm no banco de dados. OneWayToSource: Os dados so somente atualizados do GRID para o banco de dados. Allow Insert: Habilita insero de novas linhas no objeto DataGrid.
97
6. Componentes do BluePlant Show group control: Habilita a rea onde se podem arrastar os nomes das colunas para fazer agrupamentos. Show group control (Label): Texto sue aparecer dentro da rea do "Group control:" Show Column Titles: Habilita mostrar os ttulos das colunas. AllowSort: Habilita a funcionalidade de sort no lado direito de cada coluna. Auto Create Column: Habilita as colunas a serem criadas automaticamente em funo das colunas existentes no datatable do Dataset.Table ou Dataset.Query. Filter: Este campo um "where" de um sql statement, portanto, a sintaxe vlida qualquer coisa vlida em um where sql, levando em conta os nomes das colunas existentes no objeto.Ex:
[Col1] = 'ABC' AND [Col2] = 'DEF'
Refresh: Configurao de um objeto que quando recebe um trigger faz um refresh do objeto GRID. Lista de Columns: Atravs das setas para cima e para baixo, podemos mudar a ordem na qual as colunas sero visualizadas no objeto, e com os botes + e - podemos adicionar ou remover colunas. Para cada coluna podemos configurar: Visible: Habilita se a coluna estar visvel ou no. Editable: Habilita se o contedo da coluna poder ser modificado. Show in column chooser: Permite selecionar e arrastar a coluna. FieldName: Nome da coluna no banco. Se esta informao estiver errada no ser possvel associar a coluna ao datatable do banco. FieldType: Tipo correspondente coluna no banco de dados. Title: Configura o ttulo que ser visualizado no cabealho da coluna. Width: Configura a largura da coluna. Sort: Configura o tipo de sort sue que ser aplicado automaticamente na coluna. Barra de Ferramentas Horizontal
Representao Grfica dos elementos Descrio Open Grid Settings: Configurao e ajuste da grade Zoom: Ajuste de aproximao ou afastamento da tela Group: Realiza o agrupamento dos objetos selecionados Ungroup. Realiza o desagrupamento dos objetos selecionados Union: Realiza a unio de objetos geomtricos gerando um nico objeto Intersect: Realiza a interseco de objetos geomtricos gerando um nico objeto Exclude: Realiza a excluso da forma geomtrica frontal dentre os objetos selecionados gerando um novo objeto Exclusive-Or: Realiza a excluso da interseco das formas geomtricas selecionadas gerando um novo objeto Align Left: Realiza os alinhamentos dos objetos esquerda do ltimo objeto selecionado Align Horizontal Center: Centraliza os objetos horizontalmente sendo referncia o ltimo objeto selecionado Aling Right: Realiza os alinhamentos dos objetos direita do ltimo objeto selecionado
98
Aling Top: Realiza os alinhamentos dos objetos na parte superior do ltimo objeto selecionado Align Vertical Center: Centraliza os objetos verticalmente sendo referncia o ltimo objeto selecionado Align Bottom: Realiza os alinhamentos dos objetos na parte inferior do ltimo objeto selecionado Move to The Front: Movimenta para frente os objetos selecionados Move to The Back: Movimenta para trs os objetos selecionados Resize Width: Realiza o ajuste da largura dos objetos selecionados tendo como base o ltimo objeto selecionado Resize Height: Realiza o ajuste da altura dos objetos selecionados tendo como base o ltimo objeto selecionado Space Evenly Horizontally: Realiza o espaamento horizontal igual entre os objetos selecionados Space Evenly Vertically: Realiza o espaamento vertical igual entre os objetos selecionados Flip Horizontally: Realiza a inverso horizontal dos objetos selecionados Flip Vertically: Realiza a inverso vertical dos objetos selecionados Lock Element: Bloqueia todos os objetos selecionados Unlock Element: Desbloqueia o objeto selecionado atravs da Ferramenta de Seleo Direta Unlock All Elements Realiza o desbloqueio de todos os elementos da tela
Tabela 6-7. Elementos da Barra de Ferramentas Horizontal
Configurao Dinmica A opo Dynamic permite acessar a janela de Configurao Dinmica. Selecione a dinmica ou no a fim de habilit-la ou desabilit-la respectivamente. A Figura 6-62 ilustra essa configurao.
Figura 6-62. Configurao Dinmica Os itens que compem a configurao dinmica como mostrado na Figura 6-62 so descritos na sequncia:
99
6. Componentes do BluePlant Action Executa aes disparadas pela interface do usurio. As configuraes associadas so: Event: escolha um dos eventos do Mouse. Mais de um evento pode ser selecionado para cada ao o Ex: uma ao para MouseLeftButtonDown (ao pressionar o boto esquerdo do mouse) e outra para MouseLeftButtonUp (ao soltar o boto esquerdo do mouse) Action: escolha uma ao para o evento determinado. Nenhum: sem ao SetValue: define um valor para o objeto Object: objeto que receber o valor Value: valor que ser passado ao objeto ToggleValue: alterna o valor do objeto. Se o valor atual do objeto zero, o valor ser 1. Se o valor atual do objeto diferente de zero, o valor ser 0. A opo Objeto define o objeto que ser alternado OpenDisplay: abre uma tela. O campo Tela indica o nome da tela que ser aberta CloseDisplay: fecha a tela OpenLayout: abre um Layout. Layout: o nome do Layout que ser aberto RunScript: executa um script localizado no Cdigo Associado Tela. Escreva o novo nome do mtodo e clique em Novo Boto ou selecione um dos mtodos existentes na ComboBox RunExpressions: executa a expresso determinada Expression: digite a expresso. Ex: Tag.a + 1, ou Tag.a + Tag.b, ou Math.Cos(Tag.angle) * Math.PI Result (opcional): digite o Tag ou a propriedade que receber o valor da expresso
Exemplos: 1. Executar Expresses: Somar dois valores e passar o resultado para outro Tag. Expresso:
Tag.quantity1 + Tag.quantity2
Resultado:
Tag.totalQuantity
2. Incrementar um Tag Expresso:

TagCounter + 1
Resultado:
TagCounter
3. Incrementar um Tag (0 - 10) Expresso:

If(TagCounter < 10 , TagCounter + 1 , 0)
Resultado:
TagCounter
Estes campos relacionados s expresses esto ilustrados na Figura 6-62. Shine Altera a aparncia do objeto dinamicamente. As configuraes associadas so: IsMouseOver: Entre com um Tag que receber o OverValue ou o NotOverValue.
100
6. Componentes do BluePlant OverValue: Valor IsMouseOver quando o mouse est sobre o objeto. NotOverValue: Valor IsMouseOver quando o mouse NO est sobre o objeto. Aparncia Mouse Est Sobre: A aparncia do objeto quando o mouse est sobre ele. Opacidade: Opacidade do objeto (0 = transparente, 1 = opaco). Escala: Tamanho do objeto (0.5 = metade, 1 = mesmo tamanho, 1.5 = uma vez e meia, 2 = tamanho duplo). OuterGlow: Define a cor OuterGlow, a checkbox habilita ou desabilita o mesmo. TextColor: Define a cor do texto, a checkbox habilita ou desabilita o mesmo. Aparncia Mouse No Est Sobre: A aparncia do objeto quando o mouse no est sobre ele. Opacidade: Opacidade do objeto (0 = transparente, 1 = opaco). Escala: Tamanho do objeto (0.5 = metade, 1 = mesmo tamanho, 1.5 = uma vez e meia, 2 = tamanho duplo). Aparncia Selecionado: A aparncia do objeto quando est selecionado IsSelected: Define se o objeto est selecionado ou no. Opacidade: Opacidade do objeto (0 = transparente, 1 = opaco). Escala: Tamanho do objeto (0.5 = metade, 1 = mesmo tamanho, 1.5 = uma vez e meia, 2 = tamanho duplo). Referncia de Escala: Dinmica da escala. Centro Esquerda Acima Direita Abaixo TextIO Dinmica de Entrada e Sada de Texto. composta pelas configuraes ilustradas a seguir: Campo Modo Conexo: Existem dois caminhos: entrada e sada permitidas onde, na primeira, somente a entrada permitida (o valor do tag atual no mostrado, mas novos valores podem ser inseridos.) e, na segunda, somente a sada permitida. Campo Texto: Indica o texto que ser mostrado no objeto. Se o texto um valor de Tag ou uma propriedade, ele deve estar entre chaves, por exemplo: {Tag.analogInt1}. Campo DesignModeCaption: Valor mostrado no modo design. ShowObjectNames: o contedo do campo Texto exatamente como . ShowPlaceHolders: os caracteres ### so mostrados, a quantidade de caracteres definida pelo campo MaxLength.
Campo Faixa de Entrada: Define a faixa numrica para o valor inserido. CampoMaxLength: Define a quantidade mxima de caracteres. Nota: Se o texto um valor de Tag ou uma propriedade, ele deve estar entre chaves, por exemplo:
101
{Tag.analogInt1}
HyperLink Abre um hyperlink. HyperLink type: escolha uma das opes http, ftp, file, mailto, telnet. Url: configure o url que ser aberto. FillColor Altera a cor de preenchimento do objeto dinamicamente. Expression: representa o valor usado para a dinmica FillColor. ChangeColor: altera a cor de preenchimento com as seguintes configuraes... UsingLimits: a cor resultante ser dada quando o valor for igual ou maior que um dos limites AbsoluteValue: a cor ser o valor da expresso, neste caso o valor deve ser uma cor vlida. Ex: "White" ou "#FFFFFFFF"
Exemplo de uso de limites: 1 - Vermelho 10 - Azul Quando o valor for 0, o objeto ter sua prpria cor (dinmica de preenchimento de cor no ter ao) Quando o valor for de 1 a 9, o objeto ter a cor vermelha. Quando o valor for maior que 10, o objeto ter a cor azul. LineColor Altera a cor da linha do objeto dinamicamente. Expression: Representa o valor usado para a dinmica LineColor. ChangeColor: Altera a cor da linha com as seguintes configuraes... UsingLimits: a cor resultante ser dada quando o valor for igual ou maior que um dos limites AbsoluteValue: a cor ser o valor da expresso, neste caso o valor deve ser uma cor vlida. Ex: "White" ou #FFFFFFFF"
Exemplo de uso de limites: 1 - Vermelho 10 - Azul Quando o valor for 0, o objeto ter sua prpria cor (dinmica de preenchimento de cor no ter ao). Quando o valor for de 1 a 9, o objeto ter a cor vermelha. Quando o valor for maior que 10, o objeto ter a cor azul. TextColor Altera a cor do texto do objeto dinamicamente. Expression: Representa o valor usado para a dinmica de TextColor. ChangeColor: Altera a cor do texto com as seguintes configuraes... UsingLimits: a cor resultante ser dada quando o valor for igual ou maior que um dos limites
102
6. Componentes do BluePlant AbsoluteValue: A cor ser o valor da expresso, neste caso o valor deve ser uma cor vlida. Ex: "White" ou "#FFFFFFFF"
Exemplo de uso de limites: 1 - Vermelho 10 - Azul Quando o valor for 0, o objeto ter sua prpria cor (dinmica de preenchimento de cor no ter ao) Quando o valor for de 1 a 9, o objeto ter a cor vermelha. Quando o valor for maior que 10, o objeto ter a cor azul. Bargraph Dinmica de Grfico de Barras. Expression: Representa o valor usado para a dinmica de grfico de barras. Faixa de valor: Os valores mnimos e mximos que correspondero ao percentual de preenchimento mnimo e mximo. Preenchimento (%): O percentual de preenchimento do grfico de barras mnimo e mximo. Cor da Barra: Cor do grfico de barras. Orientao: Orientao do grfico de barras.
Representao Grfica dos elementos Descrio Movimentao das barras do grfico da parte inferior para superior Movimentao das barras do grfico do centro para as extremidades horizontais Movimentao das barras do grfico da parte superior para inferior Movimentao das barras do grfico da esquerda para direita Movimentao das barras do grfico do centro para as extremidades verticais Movimentao das barras do grfico da direita para a esquerda
Tabela 6-8. Grfico de Barras
Visibility Altera a visibilidade e opacidade do objeto dinamicamente. Visvel: Entre com um tag, propriedade ou expresso retornando um valor. Considere o valor resultante: zero - Objeto ser visvel e maior que zero - Objeto ser oculto. Dica: A string que aparecer como dica. Opacidade: Configuraes. Valor do Objeto: o valor usado para definir a opacidade Faixa: os valores mnimos e mximos que correspondero opacidade mnima e mxima Opacidade: a opacidade mnima e mxima (0 - invisvel, 0.5 - um pouco transparente, 1 - opaco)
Move and Drag Move o objeto dinamicamente.

103
6. Componentes do BluePlant Modo de Associao: Configuraes. Scale Altera o tamanho do objeto dinamicamente. Escala de largura: Configuraes. Expresso: representa o valor usado para a escala de largura Faixa: os valores mnimos e mximos que correspondero ao percentual de escala de largura mnima e mxima Escala (%): o percentual de escala de largura mnima e mxima Dois Caminhos: movimento de entrada e sada Somente Entrada: movimento somente de entrada, o objeto no se move quando seu valor alterado Somente Sada: movimento somente de sada, o objeto no se move com a interao do usurio
Movimento Horizontal: Configuraes. Object Value: representa o valor usado para o movimento horizontal Faixa: os valores mnimos e mximos que correspondero posio horizontal mnima e mxima Posio: posio horizontal mnima e mxima
Movimento Vertical: Configuraes. Valor do Objeto: representa o valor usado para o movimento vertical Faixa: os valores mnimos e mximos que correspondero posio vertical mnima e mxima Posio: posio vertical mnima e mxima
Escala de altura: Configuraes. Expresso: representa o valor usado para a escala de altura Faixa: os valores mnimos e mximos que correspondero ao percentual de escala de altura mnima e mxima Escala (%): o percentual de escala de altura mnima e mxima Referncia de escala: Centro: Escala com referncia no centro do objeto. Esquerda: Escala com referncia esquerda do objeto. Acima: Escala com referncia na parte superior do objeto. Direita: Escala com referncia direita do objeto. Abaixo: Escala com referncia na parte inferior do objeto. Rotate Gira o objeto dinamicamente. Valor do Objeto: Representa o valor usado para a rotao. Valor do ngulo: Os valores mnimos e mximos que correspondero ao ngulo mnimo e mximo. Ex: 0 a 100. ngulo: ngulo de rotao mnimo e mximo. Ex: 0 a 360. Referncia de Centro: Centro: Rotao com referncia no centro do objeto.
104
6. Componentes do BluePlant Esquerda: Rotao com referncia esquerda do objeto. Acima: Rotao com referncia na parte superior do objeto Direita: Rotao com referncia direita do objeto. Abaixo: Rotao com referncia na parte inferior do objeto. Skew Inclina o objeto dinamicamente. Inclinao do eixo X: configuraes. Valor do Objeto: representa o valor usado para a inclinao do eixo X Faixa: os valores mnimos e mximos que correspondero ao ngulo mnimo e mximo de inclinao do eixo X Ex: 0 a 100 Inclinao (): os valores mnimos e mximos de inclinao do eixo X Ex: 0 a 180
Inclinao do eixo Y: configuraes. Valor do Objeto: representa o valor usado para a inclinao do eixo Y Faixa: os valores mnimos e mximos que correspondero ao ngulo mnimo e mximo de inclinao do eixo Y. Ex: 0 a 100 Inclinao (): o ngulo de inclinao do eixo Y mnimo e mximo. Ex: 0 a 180 Referncia de Escala: Centro: Inclinao com referncia no centro do objeto. Esquerda: Inclinao com referncia esquerda do objeto. Acima: Inclinao com referncia na parte superior do objeto. Direita: Inclinao com referncia direita do objeto. Abaixo: Inclinao com referncia na parte inferior do objeto. TextOutput Dinmica de Sada de Texto. Texto: Indica o texto que ser mostrado no objeto. Se o texto um valor de Tag ou propriedade ele deve estar entre chaves. Exemplo:
{Tag.analogInt1}.
Localizvel: Indica se e texto deve ser traduzido ao mudar o dicionrio. DesignModeCaption: O valor mostrado no modo design: ShowObjectNames: o contedo do campo Texto mostrado exatamente como est ShowPlaceHolders: os caracteres ### so mostrados, a quantidade de caracteres definida pelo campo MaxLength
MaxLength: Define a mxima quantidade de caracteres. CodeBehind Use DrawCodeBehind para definir um conjunto de funes vinculadas s telas conforme ilustrado na Figura 6-63.
105
Figura 6-63. CodeBehind Estas funes podem ser executadas na abertura ou fechamento, ou quando a tela aberta, dependendo do cdigo configurado. Pode-se usar o cdigo associado para definir os mtodos de uso dos comandos de entrada e de mouse a serem executados em uma tela especfica. Para telas tipo DILOGO use o mtodo DialogOnOk incorporado, o qual chamado quando o boto OK incorporado pressionado. Se no mtodo retornar "TRUE", o dilogo fechado. Se retornar "FALSE" continuar aberto. Este mtodo normalmente usado para garantir a validao dos dados no dilogo (o usurio solicitado a corrigir itens incorretos antes do fechamento do dilogo). Opes: DisplayOpening(): executado quando a tela est abrindo DisplayIsOpen(): chamado em um intervalo regular enquanto a tela aberta DisplayClosing(): executado quando a tela est fechando DialogOnOK(): chamado quando o boto OK pressionado em uma tela de Dilogo
Retorno "1" permite o fechamento do dilogo. Retorno "0" evita que o dilogo seja fechado. Pode-se acrescentar variveis .NET e mtodos nesta pgina. Nota: Em funo das telas cliente serem projetadas para execuo em ambientes distribudos e Web recomenda-se evitar o uso de funes que no permitam execuo de confiana parcial ou que se refiram a caminhos de arquivo fsico. Smbolos Smbolos so objetos definidos pelo usurio contendo desenhos e propriedades dinmicas. A Figura 6-64 mostra um smbolo e o menu de contexto associado.
106
Figura 6-64. Menu Contexto do Smbolo Para simplificar o uso de smbolos em outras telas e aplicaes pode-se definir rtulos em propriedades dinmicas onde um TagName esperado. Use a sintaxe:
#LabelName: ou #LabelName:DefaultValue.
Quando usar smbolos em telas ou relatrios selecione novos nomes de tags na janela de configurao a serem aplicados nos campos de Rtulo definidos. Um conjunto de Smbolos que visvel a todos os projetos incorporado ao BluePlant framework. Estes smbolos so definidos no arquivo SymbolLibrary.tproj localizado na pasta de instalao binria do Produto. O arquivo da biblioteca de smbolo global pode ser editado como um arquivo de projeto. Pode-se tambm criar e salvar seus prprios smbolos. Criando Smbolo As imagens da Figura 6-65, Figura 6-66 e Figura 6-67 apresentam os passos necessrios para criar um smbolo. Os procedimentos tambm esto descritos a seguir:
107
Figura 6-65. Criando um Smbolo 1. 2. 3. 4. Selecionar o menu Draw Clicar na guia Drawing Selecionar o objeto retngulo Desenhar um retngulo na tela e clicar duas vezes no objeto criado. A tela abaixo dever aparecer
Figura 6-66. Configurao Dinmica 5. Selecionar a opo Bargraph 6. Digitar no campo Expression a sintaxe abaixo para expor a propriedade Nvel:
#Nivel:Server.Second
Nota:
108
6. Componentes do BluePlant As propriedades de um smbolo so expostas atravs do uso de mnemnicos, que so:
#<nome>:<valor> ou #<nome>:(<expression>)
7. 8. 9. 10. 11. 12.
Fechar a tela de Dynamics Configuration Selecionar todos os objetos que compem o smbolo, neste caso o retngulo Clicar com boto direito do mouse para abertura do menu de contexto Selecionar a opo "Make new Symbol" Preencher as informaes: Nome do smbolo, categoria, descrio e clicar em YES Este smbolo estar disponvel para ser inserido em qualquer ponto do projeto atravs do Symbol Library
Figura 6-67. Configurao Dinmica 13. Ir no icone Symbol Library como mostrado na figura acima e inserir o smbolo criado na tela 14. Ir na tela de configurao do smbolo dando um duplo click. Aparecer uma propriedade "Nivel" com o valor "Server.Second" que pode ser alterado para o tag desejado, podendo cada smbolo ter o seu valor de nvel independente Modificando um Smbolo Os passos a seguir, descrevem o que deve ser feito para que um smbolo seja modificado. 1. 2. 3. 4. 5. 6. 7. 8. Selecionar o smbolo que se deseja modificar Clicar com o boto direito do mouse para abertura do menu de contexto Selecionar a opo "Edit <nome do smbolo>" Fazer todas as alteraes desejadas no smbolo Selecionar todos os objetos que compem o smbolo Clicar com boto direito do mouse para abertura do menu de contexto. Selecionar a opo "Update <nome do smbolo>" Todos os smbolos com este nome da tela corrente sero alterados, se desejar que todos os smbolos com este nome do projeto sejam alterados ser necessrio fazer um build salvando as telas
109
Menu Info
Project Submenu de informaes do projeto atual. Version A guia Version, ilustrada na Figura 6-68, contm informaes sobre o projeto atual. Alguns campos de informao tambm esto disponveis durante o Runtime usando Namespace Info.
Figura 6-68. Guia Version Os itens que compem o menu de informao esto numerados na figura anterior e so descritos na sequncia: 1. Selecionar a opo Info 2. Selecionar a opo Project 3. Selecionar a opo Version para exibio dos dados relativos ao projeto Settings Na sequncia so explicados os itens da guia Settings conforme ilustrado na Figura 6-69.
110
Figura 6-69. Guia Settings Os itens que compem a guia Settings esto numerados na figura anterior e so descritos na sequncia: 1. Selecionar a opo Info 2. Selecionar a opo Project 3. Selecionar a opo Settings Na sequncia so explicados os itens do menu Info Settings conforme mostrado na Figura 6-69. Configuraes do Projeto Define as configuraes globais para o projeto. Alguns campos de informao tambm esto disponveis durante o Runtime usando Namespace Info. BluePlant Model Seleciona o Modelo de BluePlant correspondente. As seguintes opes esto disponveis: Model Seleciona o modelo de Runtime. As seguintes opes de Runtime esto disponveis: 75 150 300 500 1.500 2.500 5.000 15.000 25000
111
Express Enterprise Student Lite
6. Componentes do BluePlant Culture Info Seleciona o idioma do projeto. Target Framework Seleciona o framework, plataforma o qual o BluePlant executa. Code Language Seleciona a linguagem do Script. As seguintes Linguagens podem ser selecionadas: VBdotNet CSharp 50.000 100.000 1.000.000
Default Page Size Define o tamanho padro da pgina. A Figura 6-70 ilustra essa seleo.
Figura 6-70. Ajuste do Tamanho da Pgina
Redundancy Na sequncia so explicados os itens da guia Redundancy conforme ilustrado na Figura 6-71.
112
Figura 6-71. Guia Redundancy Enable configuration: Opo para habilitar a redundncia no projeto. Primary Server IP: Campo para configurao do endereo IP do servidor denominado primrio. Secondary Server IP: Campo para configurao do endereo IP do servidor denominado secundrio. Port: Nmero da porta que o servidor ir utilizar para comunicar com os outros mdulos e servidores. On Primary Startup: Define o comportamento do servidor primrio quando este for iniciado. Switch to primary, put secondary in standy-by If secondary is active, put primary in stand-by
Historian Replication: Define quais histricos iro fazer replicao de dados automticos. None Alarm Historian Tag Historian Alarm and Tag Historian
Connection Timeout: Tempo especificado que o servidor reserva para aguardar quando no h comunicao entre os servidores redundantes e assume como ativo. Server Command Line: Linha de comando utilizada para iniciar os servidores. Client Command: Linha de comando utilizada para iniciar os clientes. Web command: URL utilizada para acessar o projeto atravs do Internet Explorer. Mais informaes sobre o comportamento de servidores redundantes pode ser encontrado em Cenrios de Sistemas Tpicos.
113
6. Componentes do BluePlant Track Tables Esta guia do menu Info, opo Track, rastreia o status das tabelas de configurao. A Figura 6-72 mostra essa seleo.
Figura 6-72. Guia Tables do Menu Info, Opo Track Os itens que compem o menu Info - Track - Tables esto numerados na figura anterior e so descritos na sequncia: 1. 2. 3. 4. Selecionar a opo Info Selecionar a opo Track Selecionar a opo Tables Clicar com o boto direito do mouse em qualquer um dos cabealhos de coluna e selecionar as opes a serem exibidas
Os itens da guia Tables so explicados a seguir e podem ser visualizados na Figura 6-72. TableName Nome da Tabela do projeto. Atributos: ReadOnly (somente leitura). Lines Nmero atual de linhas na tabela de configurao. Atributos: ReadOnly (somente leitura). DateModified Data da ltima alterao. Atributos: ReadOnly. ChangedSinceBuild Alteraes desde a ltima execuo do comando de compilao. Atributos: ReadOnly (somente leitura). ChangedSincePublish Alteraes desde a ltima execuo do comando de publicao. Atributos: ReadOnly (somente leitura). Comments Comentrios definidos pelo usurio. Atributos: editvel.
114
6. Componentes do BluePlant Changes Esta guia do menu Info opo Track, rastreia as modificaes do projeto. A Figura 6-73 mostra essa seleo. O campo Tracking define quando as mudanas sero salvas.
Figura 6-73. Guia Changes do Menu Info, Opo Track Os itens que compem o menu Info - Track - Changes esto numerados na figura anterior e so descritos abaixo: 1. 2. 3. 4. Selecionar a opo Info Selecionar a opo Track Selecionar a opo Changes Clicar com o boto direito do mouse em qualquer um dos cabealhos de coluna e selecionar as opes a serem exibidas
Module Nome do mdulo onde o objeto est definido. Atributos: ReadOnly (somente leitura). ObjectName Nome do objeto ou ndice de linhas. Atributos: ReadOnly (somente leitura). RowState Operao executada no objeto. Atributos: ReadOnly (somente leitura). Build Nmero de compilao do projeto quando a operao foi executada. Atributos: ReadOnly (somente leitura). Date Data de modificao da execuo. Atributos: ReadOnly (somente leitura). Comments Comentrios definidos pelo usurio. Atributos: editvel.
115
6. Componentes do BluePlant Releases Esta guia do menu Info opo Track rastreia as verses publicadas do projeto. A Figura 6-74 mostra essa seleo.
Figura 6-74. Guia Releases do Menu Info, Opo Track Os itens que compem o menu Info - Track - Releases esto numerados na figura anterior e so descritos a seguir: 1. 2. 3. 4. Selecionar a opo Info Selecionar a opo Track Selecionar a opo Releases Clicar com o boto direito do mouse em qualquer um dos cabealhos de coluna para selecionar as opes a serem exibidas
Os itens da guia Releases esto explicados abaixo e podem ser visualizados conforme Figura 6-74. Versionstring Verso publicada. Atributos: ReadOnly (somente leitura). Build Nmero da compilao quando a verso foi publicada. Atributos: ReadOnly (somente leitura). DatePublished Data de publicao da verso para este projeto. Atributos: ReadOnly (somente leitura). User Nome do usurio que publicou esta verso. Atributos: ReadOnly (somente leitura). Notes Permite a criao de notas e mensagens tipo "PostIt" visualizveis por todos os membros da equipe de design do projeto. As notas so visveis na rea de trabalho durante a edio do projeto. Esta interface fornece uma tabela do tipo "quadro de mensagens" para a criao dos lembretes crticos (notas) que so acessadas por todo o pessoal envolvido no desenvolvimento do projeto. Quando o usurio clica em uma mensagem "fechada" ela permanece fechada, porm no excluda. Para excluir uma mensagem selecione a nota na tabela, d um duplo clique e selecione "Excluir Linha Selecionada". Um clique em "IsOpen" na linha de mensagem faz com que ela seja aberta.
116
6. Componentes do BluePlant Para implementar mensagens para os operadores de projeto durante a execuo do mesmo use a funo OpenPopupNote() disponvel nas opes de objetos runtime do cliente. Esta guia do menu Info opo Notes edita notas do usurio sobre a configurao do projeto. A Figura 6-75 mostra essa seleo.
Figura 6-75. Guia Notes do Menu Info Opo Notes Os itens que compem o menu Info - Notes - Notes esto numerados na Figura 6-75 e so descritos a seguir: 1. 2. 3. 4. Selecionar a opo Info Selecionar a opo Notes Selecionar a guia Notes Clicar com o boto direito do mouse em qualquer um dos cabealhos de coluna e selecionar as opes a serem exibidas
Ferramentas da Aplicao
Esta seo explora as ferramentas disponveis no BluePlant. Tstartup Ao executar o projeto usando o Gerenciador ou interfaces de boas-vindas, a janela TStartup aparece conforme ilustrado na Figura 6-76. Contedo: informaes sobre Status dos Mdulos (rodando, parado ou pausado). Os comandos associados so: Boto Play: inicia a execuo do mdulo Boto Stop: interrompe a execuo de um mdulo, fecha as conexes e libera os recursos Boto Pause: pausa a execuo do mdulo, geralmente usado pelo recurso de redundncia de servidores Boto Shutdown: para o servidor BluePlant (TServer) e todos os mdulos Boto Watch: inicia o PropertyWatch Boto Trace: inicia o TraceWindow Boto Info: inicia o ModuleInformation TStartup PropertyWatch TraceWindow ModuleInformation
117
Figura 6-76. Janela de Startup Pode-se chamar a janela de Startup usando a linha de comando. Os comandos disponveis podem ser consultados na seo Linhas de Comando (Tstartup). PropertyWatch O PropertyWatch pode ser usado para acessar o servidor de Domnio de tags e Propriedades e mudar seus valores conforme ilustrado na Figura 6-77.
Figura 6-77. PropertyWatch Pode-se chamar o PropertyWach usando a linha de comando. Os comandos disponveis podem ser consultados na seo Linhas de Comando (PropertyWatch).
118
6. Componentes do BluePlant TraceWindow A TraceWindow usada para capturar as mensagens dos mdulos de Runtime do BluePlant conforme ilustrado na Figura 6-78. Estas mensagens so teis para compreender o comportamento em Runtime.
Figura 6-78. TraceWindow Ajustes: As opes de ajuste mostradas na Figura 6-79 so: Modules: determina de quais mdulos a TraceWindow recebe mensagens Type: determina os tipos de mensagem que a TraceWindow recebe
Pode-se adicionar uma Tag ou propriedade no campo ObjectName, de maneira que, ao clicar no boto Add, uma notificao ser enviada para a TraceWindow sempre que o objeto mudar o seu valor. Sadas: Grid: indica o nmero mximo de arquivos que aparecem na grade File: um nome de arquivo pode ser definido para armazenamento das mensagens
119
Figura 6-79. Configuraes Pode-se chamar a TraceWindow usando a linha de comando e parmetros especficos. Para enviar mensagens para a TraceWindow do projeto, deve-se chamar a funo Info.Trace(string str). TraceWindow Message Seleciona os tipos de mensagem da janela de rastreamento. Os seguintes tipos de mensagem da janela de rastreamento esto disponveis: Erro Informao Advertncia Depurao
ModuleInformation ModuleInformation contm informaes avanadas sobre a execuo dos mdulos conforme ilustrado na Figura 6-80.
120
Figura 6-80. Informaes do Mdulo Pode-se chamar o ModuleInformation usando a linha de comando e parmetros especficos.
Objetos Runtime
Esta funcionalidade permite visualizar todos os elementos abertos, incluindo Telas, Scripts e Relatrios. Os objetos do Runtime esto em grupos que contem informaes especficas de suas funcionalidades, sendo chamados de Namespace. Segue a lista dos Namespaces disponveis: Namespace Tag Namespace Security Namespace Alarm Namespace Device Namespace Dataset Namespace Script Namespace Display Namespace Report Namespace Info Namespace Server Namespace Client
Durante a configurao do projeto, digite diretamente no campo. O "Intellisense" guiar o usurio em relao aos namespaces vlidos para aquele campo assim como os membros disponveis. No Editor de Cdigo (interfaces ScriptCodeEditor e DrawCodeBehind) e na dinmica TextOutput necessrio utilizar o prefixo "@" para evitar conflito com os Namespaces.NET. Exemplo: Nos dilogos e grades (Figura 6-81), use:
Tag.Analog1 Alarm.Group.Warning.TotalActive Device.Node.Node1.Status
121
Figura 6-81. Namespaces em Dilogos No cdigo script (Figura 6-82), use:

@Tag.Analog1 @Alarm.Group.Warning.TotalActive @Device.Node.Node1.Status
Figura 6-82. Namespaces em Scripts
122
6. Componentes do BluePlant Alguns campos nas Grades e Dilogos so permitidos somente para um tipo de objeto (um namespace), por exemplo, "Tag" ou "Display". Quando o usurio digita um Namespace neste campo o Intellisense o levar at os objetos disponveis. Namespace Tag Todas as variveis de tempo real do projeto, ou "Tags de Projeto", como so normalmente chamadas nos contextos de automao de processos, esto disponveis neste Namespace. Os tags so criados na interface EditTagsObjects. Use a sintaxe Tag.Namespace para referir-se ao tag criado e Tag.namespace.Min para acessar a Propriedade "Mnimo". Para cada tag definido um tipo para o seu valor. Os seguintes tipos incorporados esto disponveis: Digital AnalogInt AnalogDouble AnalogDecimal Text TDateTime Counter Timer Reference
A sintaxe tag.<TagName> est disponvel para todos os tipos de tag. Para saber o tipo de um tag em particular possvel acessar propriedades adicionais e mtodos usando a sintaxe: Tag.<TagName>.<PropertyName>. O elemento TagObj mostra propriedades e mtodos disponveis para todos os tipos de tag. Por outro lado, Analog mostra as propriedades comuns a todos tags Analgicos (refere-se ao tipo de tag para propriedades especficas). So permitidos os tipos criados pelo usurio em combinao com os tipos incorporados. ClassTagObj Classes de base para todos os objetos tag. ForceValue Fora a propriedade de valor do objeto ao valor dado como parmetro. Parmetros: valor do objeto. Exemplo:
@Tag.AnalogInt1.ForceValue(10); @Tag.AnalogInt1.ForceValue(10); (VB) (C#)
Tostring Retorna uma string que representa o objeto atual. Exemplo:

Dim s as string; @Tag.AnalogInt1 = 33; s = Tag.AnalogInt1.Tostring(); string s; @Tag.AnalogInt1 = 33; s = Tag.AnalogInt1.Tostring(); (VB) (C#)
Neste exemplo, S ser avaliado como "33".
123
6. Componentes do BluePlant Alarm Disable Fornece ou define o estado de alarme desabilitado do Tag. Se 0 (zero), a propriedade AlarmDisable no fica ativa. No caso de valores diferentes de 0 (zero), a propriedade AlarmDisable fica ativa. Quando a propriedade AlarmDisable no est ativa, todos os alarmes associados ao Tag atual no so tratados. Exemplo:
@Tag.AnalogDecimal1.AlarmDisable = 1; @Tag.AnalogDecimal1.AlarmDisable = 1; (VB) (C#)
Neste exemplo, os alarmes associados ao objeto AnalogDecimal1 no sero tratados. Alarm State Fornece ou define o estado de alarme do Tag. Se 0 (zero): fora de estado de alarme. No caso de valores diferentes de 0 (zero): em estado de alarme. Exemplo:
Dim alarmState as Int; (VB) alarmState = @Tag.AnalogDecimal1.AlarmState; int alarmState; (C#) alarmState = @Tag.AnalogDecimal1.AlarmState;
GetName Fornece o nome do Tag. Exemplo:

@Tag.ReferenceTagName.Link = @Tag.TagName.GetName(); @Tag.ReferenceTagName.Link = @Tag.TagName.GetName(); (VB) (C#)
AlarmUnack Fornece ou define o estado de reconhecimento do Tag atual. Se 0 (zero): alarme atual reconhecido. No caso de valores diferentes de 0 (zero): alarme atual no reconhecido. Exemplo:
Dim alarmStatus as Int; (VB) alarmStatus = @Tag.AnalogDecimal1.AlarmUnack; int alarmStatus; (C#) alarmStatus = @Tag.AnalogDecimal1.AlarmUnack;
Changed Fornece ou define o estado alterado do valor do Tag. True: valor alterado. False: valor inalterado. Domain Fornece ou define a propriedade de Domnio do Tag. Se 0 (zero): servidor. Se 1: cliente. EngUnits Fornece ou define as unidades de engenharia usadas para quantificar o Tag. Format Fornece ou define o formato do valor do Tag para fins de exibio. Historian Fornece o objeto HistoryItem onde o Tag atual est configurado como TagName. Se tags duplicados forem permitidos nas tabelas de Historiadores, ento o Historiador apontar para o ltimo objeto HistoryItem onde o Tag atual est configurado como TagName. Exemplo:
124
@Tag.AnalogInt1.Historian.Deadband = 3; @Tag.AnalogInt1.Historian.Deadband = 3; (VB) (C#)
Locked Fornece ou define o estado bloqueado do Tag. Quando um Tag est bloqueado, o valor usado para o processamento origina-se da propriedade LockValue e no da propriedade de valor. Se 0 (zero): desbloqueado. No caso de valores diferentes de 0 (zero): bloqueado. Exemplo:
@Tag.AnalogDouble1.Locked = 1; @Tag.AnalogDouble1.Locked = 1; (VB) (C#)
Quality Fornece ou define o estado de qualidade do Tag. Valores permitidos:

Valor 0 192 Qualidade Ruim Bom
Tabela 6-9. Valores Padres Exemplo:

@Tag.AnalogInt1.Quality = 192; @Tag.AnalogInt1.Quality = 192; (VB) (C#)
Retentive Fornece ou define a propriedade Retentiva do Tag, a qual especifica se a propriedade de Valor do Tag deve ser salva quando a aplicao for encerrada. O valor salvo ento usado como o valor de inicializao na execuo da prxima aplicao. Se 0 (zero): no retentivo. No caso de valores diferentes de 0 (zero): retentivo. Exemplo:
@Tag.AnalogInt1.Retentive = 1; @Tag.AnalogInt1.Retentive = 1; (VB) (C#)
TimeStamp Fornece ou define a propriedade Timestamp do tag. Exemplo:

Dim dt coo DateTimeOffset; dt = @Tag.AnalogDouble1.Timestamp; DateTimeOffset dt; dt = @Tag.AnalogDouble1.Timestamp; (VB) (C#)
ValueType Fornece a propriedade ValueType do Tag. Exemplo:

Dim doubleType as Integer; doubleType = @Tag.AnalogDouble1.ValueType; int doubleType; doubleType = @Tag.AnalogDouble1.ValueType; (VB) (C#)
Visibility Fornece ou define o estado de visibilidade do Tag. Se 0 (zero): privado, 1: protegido e 2: pblico. Exemplo:
Dim visibilityState as Integer;
125
(VB)
visibilityState = @Tag.AnalogDouble3.Visibility; int visibilityState; visibilityState = @Tag.AnalogDouble3.Visibility; (C#)
Class Digital Propriedades do Runtime para Classe Digital. Valores possveis: 0 = false e 1 = true. Equivalente no script: Toogle Alterna a propriedade de valor do Tag entre 0 (zero) e 1. Se o valor atual 0 (zero), ento o novo valor 1. Se o valor atual 1, ento o novo valor 0 (zero). Exemplo:
Dim newValue as Byte; newValue = @Tag.Digital1.ToggleValue(); byte newValue; newValue = @Tag.Digital1.ToggleValue(); (VB) (C#)
C#: int32 VB: int .NET: int
Lock Fornece ou define a propriedade LockedValue do Tag. Quando um Tag est bloqueado, o valor usado para o processamento origina-se da propriedade LockValue e no da propriedade Valor. Exemplo:
@Tag.Digital1.LockValue = 1; @Tag.Digital1.LockValue = 1; (VB) (C#)
State Fornece a propriedade de Estado do Tag digital. Valor = 0 corresponde ao estado = False (VB) ou estado = false (C#). Valor = 1 corresponde ao estado = True (VB) ou estado= true (C#). Value Fornece ou define a propriedade de Valor do Tag digital. Valores vlidos: 0 (zero) ou 1. Exemplo:
@Tag.Digital1.Value = 1; @Tag.Digital1.Value = 1; (VB) (C#)
126
Class Analog Propriedades do Runtime para Analog Class.

Membro Bit0 Bit1 Bit10 Bit11 Bit12 Bit13 Bit14 Bit15 Bit16 Bit17 Bit18 Bit19 Bit2 Bit20 Bit21 Bit22 Bit23 Bit24 Bit25 Bit26 Bit27 Bit28 Bit29 Bit3 Bit30 Bit31 Bit4 Bit5 Bit6 Bit7 Bit8 Bit9 Hi HiHi Lo LoLo Descrio Fornece ou define o bit 0 do valor do tag. Fornece ou define o bit 1 do valor do tag. Fornece ou define o bit 10 do valor do tag. Fornece ou define o bit 11 do valor do tag. Fornece ou define o bit 12 do valor do tag. Fornece ou define o bit 13 do valor do tag. Fornece ou define o bit 14 do valor do tag. Fornece ou define o bit 15 do valor do tag. Fornece ou define o bit 16 do valor do tag. Fornece ou define o bit 17 do valor do tag. Fornece ou define o bit 18 do valor do tag. Fornece ou define o bit 19 do valor do tag. Fornece ou define o bit 2 do valor do tag. Fornece ou define o bit 20 do valor do tag. Fornece ou define o bit 21 do valor do tag. Fornece ou define o bit 22 do valor do tag. Fornece ou define o bit 23 do valor do tag. Fornece ou define o bit 24 do valor do tag. Fornece ou define o bit 25 do valor do tag. Fornece ou define o bit 26 do valor do tag. Fornece ou define o bit 27 do valor do tag. Fornece ou define o bit 28 do valor do tag. Fornece ou define o bit 29 do valor do tag. Fornece ou define o bit 3 do valor do tag. Fornece ou define o bit 30 do valor do tag. Fornece ou define o bit 31 do valor do tag. Fornece ou define o bit 4 do valor do tag. Fornece ou define o bit 5 do valor do tag. Fornece ou define o bit 6 do valor do tag. Fornece ou define o bit 7 do valor do tag. Fornece ou define o bit 8 do valor do tag. Fornece ou define o bit 9 do valor do tag. Fornece ou define o limite high do tag. Fornece ou define o limite high-high do tag. Fornece ou define o limite low do tag. Fornece ou define o limite low-low do tag
Tabela 6-10. Propriedades do Runtime para Analog Class
Class Analog<T> Propriedades de Runtime para Classe Analog <T>. Deadband Fornece ou define a banda morta do Tag analgico. Exemplo:
@Tag.AnalogDouble1.Deadband = 5; @Tag.AnalogDouble1.Deadband = 5; (VB) (C#)
127
6. Componentes do BluePlant LockValue Fornece ou define o valor de bloqueio do Tag analgico. Exemplo:
@Tag.AnalogDouble1.LockValue = 50; @Tag.AnalogDouble1.LockValue = 50; (VB) (C#)
Analog.Min Fornece ou define o valor mximo do Tag analgico. Exemplo:

@Tag.AnalogDouble1.Max = 100; @Tag.AnalogDouble1.Max = 100; (VB) (C#)
StartValue Fornece ou define o valor inicial do tag analgico. Exemplo:

@Tag.AnalogDouble1.StartValue = 50; @Tag.AnalogDouble1.StartValue = 50; (VB) (C#)
State Fornece ou define o estado do Tag analgico. Se o valor igual a 0 (zero), o estado FALSE. Se o valor diferente de 0 (zero), o estado TRUE. Exemplo:
Dim state as Boolean; state = @Tag.AnalogDouble1.State; bool state; state = @Tag.AnalogDouble1.State; Value @Tag.AnalogDouble1.Value = 55; @Tag.AnalogDouble1 = 55; @Tag.AnalogDouble1.Value = 55; @Tag.AnalogDouble1 = 55; (VB) (C#) (VB) ou (C#) ou
Class AnalogInt Propriedades do Runtime para AnalogInt Class. Class AnalogDecimal Propriedades do Runtime para Classe Decimal Analgica. Class AnalogDoble Propriedades do Runtime para Classe AnalogDouble. Class Text Propriedades do runtime para classe texto. LockValue Fornece ou define o valor de bloqueio do tag de texto. Exemplo:
@Tag.Text1.LockValue = "Welcome"; @Tag.Text1.LockValue = "Welcome"; (VB) (C#)
128
6. Componentes do BluePlant Value Fornece ou define o valor do tag de texto. Exemplo:

@Tag.Text1.Value @Tag.Text1 = "My @Tag.Text1.Value @Tag.Text1 = "My = "My text"; text"; = "My text"; text"; (VB) ou (C#) ou
Class TDataTime Propriedades do Runtime para ClasseTDataTime. LockValue Fornece ou define o valor de bloqueio do Tag de TDataTime. Exemplo:
@Tag.Text1.LockValue = "Welcome"; @Tag.Text1.LockValue = "Welcome"; (VB) (C#)
Value Fornece ou define o valor do Tag de TDataTime. Exemplo:

@Tag.Text1.Value @Tag.Text1 = "My @Tag.Text1.Value @Tag.Text1 = "My = "My text"; text"; = "My text"; text"; (VB) ou (C#) ou
Class Counter Define propriedades do Runtime para Classe Counter. Event Fornece o evento do Tag Counter. Valores possveis: "Change", "ChangeUp" e "ChangeDown". Exemplo:
Dim counter1Event as string; counter1Event = @Tag.Counter1.Event; string counter1Event; counter1Event = @Tag.Counter1.Event; (VB) (C#)
Model Fornece o modelo do Tag Counter. Valores possveis: "Up" e "Down". Exemplo:
Dim counter1Model as string; counter1Model = @Tag.Counter1.Model; string counter1Model; counter1Model = @Tag.Counter1.Model; (VB) (C#)
Trigger Fornece ou define o disparo do Tag Counter. Exemplo:

@Tag.Counter1.Trigger = "Tag.Digital1"; @Tag.Counter1.Trigger = "Tag.Digital1"; (VB) (C#)
129
6. Componentes do BluePlant Class Timer Propriedades do Runtime para Classe Timer. Interval Fornece ou define o intervalo do Tag Timer. Trata-se de uma string que representa o intervalo de tempo exibido no formato "hh:mm:ss.mmm". Exemplo:
@Tag.Timer1.Interval = "0:0:10"; @Tag.Timer1.Interval = "0:0:10"; (VB) (C#)
Model Fornece o modelo do Tag Timer. Valores possveis: "SquareWave", "Pulse" e "Comparer". Exemplo:
Dim timerModel as string; timerModel = @Tag.Timer1.Model; string timerModel; timerModel = @Tag.Timer1.Model; (VB) (C#)
Class Reference Propriedades de Runtime para a Classe Reference. Link Fornece ou define o link do Tag Reference. Exemplo:
@Tag.Reference1.Link = @Tag.TagName.GetName(); @Tag.Reference1.Link = @Tag.TagName.GetName(); (VB) (C#)
Class TDataTable Propriedades do Runtime para Classe TDataTable. Initialize Define uma nova referncia ao objeto Tabela. Este mtodo usado somente internamente. Table Fornece uma cpia do objeto DataTable. Exemplo:
Dim dt as New TDataTable(parent, id); Dim table As DataTable; table = dt.Table; TDataTable dt = new TDataTable(parent, id); DataTable table; table = dt.Table; (VB) (C#)
OverwriteOnUpdate Fornece ou define o operando OverwriteOnUpdate. Esta propriedade usada somente internamente. Update Atualiza o objeto Tabela. Este mtodo usado somente internamente. Parmetros: DataTable table
130
6. Componentes do BluePlant Classe UserType Propriedades do Runtime para Classe UserType. Namespace Security Class ModuleSecurity Propriedades do Runtime para objetos ModuleSecurity. GetPasswordHint Retorna (exibe) a dica de senha para o nome do usurio selecionado. Parmetro: string userName. Exemplo:
Dim pswHint As string = @Security.GetPasswordHint("User"); (VB) string pswHint = @Security.GetPasswordHint("User"); (C#)
AddRuntimeUser Acrescenta um usurio lista de usurios de Runtime. Parmetros associados: string name; string permissionsStr; string password; string passwordHint; string policyStr; string profileEmail; string profilePhone e string profileCompleteName. Exemplo:
@Security.AddRuntimeUser("User", "User", "psw", "remember", "Default", "a@b.com", "67521855", "Alfred Burns"); (VB) @Security.AddRuntimeUser("User", "User", "psw", "remember", "Default", "a@b.com", "67521855", "Alfred Burns"); (C#)
GetListOfUserNames Retorna a lista de nomes dos usurios de Runtime separados por \n (nova linha). Exemplo:
Dim userList as string; userList = @Security.GetListOfUserNames(); string userList; userList = @Security.GetListOfUserNames(); (VB) (C#)
RemoveRuntimeUser Remove o usurio de Runtime da lista de usurios. Parmetro: string name. Exemplo:
@Security.RemoveRuntimeUser("User"); @Security.RemoveRuntimeUser("User"); (VB) (C#)
Permission Fornece a lista de permisso. Refere-se aos objetos SecurityPermission. Exemplo:

Dim permissionList as SecurityPermissionList; permissionList = @Security.Permission; SecurityPermissionList permissionList; permissionList = @Security.Permission; (VB) (C#)
User Fornece a lista de usurios. Fornece acesso aos objetos SecurityUser. Exemplo:
Dim userList as SecurityUserList; userList = @Security.User; SecurityUserList userList; userList = @Security.User;
131
(VB) (C#)
6. Componentes do BluePlant Policy Fornece a lista de Poltica. Exemplo:

Dim policyList as SecurityPolicyList; policyList = @Security.Policy; SecurityPolicyList policyList; policyList = @Security.Policy; (VB) (C#)
Class SecurityPermission Propriedades do Runtime para objetos SecurityPermission. DateCreated Fornece a data e hora em que a SecurityPermission foi criada. Exemplo:
Dim permissionDate as DateTime; (VB) permissionDate = @Security.Permission.Administrator.DateCreated; DateTime permissionDate; (C#) permissionDate = @Security.Permission.Administrator.DateCreated;
DateModified Fornece a data e hora em que a SecurityPermission foi modificada. Exemplo:

Dim permissionDate as DateTime; (VB) permissionDate = @Security.Permission.Administrator.DateModified; DateTime permissionDate; (C#) permissionDate = @Security.Permission.Administrator.DateModified;
Description Fornece a descrio da SecurityPermission. Exemplo:

Dim permissionDescription as string; (VB) permissionDescription = @Security.Permission.Administrator.Description; int permissionDescription; (C#) permissionDescription = @Security.Permission.Administrator.Description;
Edit Fornece a permisso de Edio. Exemplo:

Dim editPermission as Integer; (VB) editPermission = @Security.Permission.Administrator.Edit; int editPermission; (C#) editPermission = @Security.Permission.Administrator.Edit;
Name Fornece o nome SecurityPermission. Exemplo:

Dim permissionName as string; (VB) permissionName = @Security.Permission.Administrator.Name; string permissionName; (C#) permissionName = @Security.Permission.Administrator.Name;
Run Fornece a permisso de execuo. Exemplo:

Dim runPermission as Integer;
132
(VB)
runPermission = @Security.Permission.Administrator.Run; int runtPermission; (C#) runPermission = @Security.Permission.Administrator.Run;
Class SecurityUser Propriedades do Runtime para objetos SecurityUser. DateCreated Fornece a data e hora em que o SecurityUser foi criado. Exemplo:
Dim userDate as DateTime; (VB) userDate = @Security.User.Guest.DateCreated; DateTime userDate; (C#) permissionDate = @Security.User.Guest.DateCreated;
DateModified Fornece a data e hora em que o SecurityUser foi modificado. Exemplo:

Dim userDate as DateTime; (VB) userDate = @Security.User.Guest.DateModified; DateTime userDate; (C#) userDate = @Security.User.Guest.DateModified;
PolicyName Fornece o nome das polticas do SecurityUser. Exemplo:

Dim userPolicyName as string; (VB) userPolicyName = @Security.User.Guest.PolicyName; string userPolicyName; (C#) userPolicyName = @Security.User.Guest.PolicyName;
SecurityUser.Blocked Fornece o estado bloqueado do SecurityUser. Exemplo:

Dim blockedState as Boolean; (VB) blockedState = @Security.User.Guest.Blocked; bool blocked; (C#) blocked = @Security.User.Guest.Blocked;
SecurityUser.Deleted Fornece o estado excludo do SecurityUser. Exemplo:

Dim deletedState as Boolean; (VB) deletedState = @Security.User.Guest.Deleted; bool deleted; (C#) deleted = @Security.User.Guest.Deleted;
SecurityUser.Name Fornece o nome do SecurityUser. Exemplo:

Dim userName as string; (VB) userName = @Security.User.Guest.Name; string userName; (C#) userName = @Security.User.Guest.Name;
133
6. Componentes do BluePlant SecurityUser.PasswordHint Fornece a dica de senha dos SecurityUsers. Exemplo:

Dim pswHint as string; (VB) pswHint = @Security.User.Guest.PasswordHint; string pswHint; (C#) pswHint = @Security.User.Guest.PasswordHint;
SecurityUser.Permissions Fornece as permisses do SecurityUser. Exemplo:

Dim userPermissions as Long; (VB) userPermissions = @Security.User.Guest.Permissions; long userPermissions; (C#) userPermissions = @Security.User.Guest.Permissions;
SecurityUser.PermissionsName Fornece o nome das permisses do SecurityUser. Exemplo:

Dim permissionsName as string; (VB) permissionsName = @Security.User.Guest.Permissions; string permissionsName; (C#) permissionsName = @Security.User.Guest.Permissions;
SecurityUser.Policy Fornece as polticas do SecurityUser. Exemplo:

Dim userPolicy as Long; (VB) userPolicy = @Security.User.Guest.Policy; long userPolicy; (C#) userPolicy = @Security.User.Guest.Policy;
SecurityUser.Profile Fornece o perfil do SecurityUser. Exemplo:

Dim userProfile as string; (VB) userProfile = @Security.User.Guest.Profile; string userProfile; (C#) userProfile = @Security.User.Guest.Profile;
Namespace Alarm Objetos de Runtime e mtodos relacionados ao mdulo de alarme. Class AlarmGroup Propriedades do Runtime para objetos de Grupo de Alarmes. AckAll Reconhece todos os itens de alarme que pertencem a este grupo. Alterna a propriedade definida para AckAll. Valores permitidos: 0: reconhecimento se o valor era 1e 1: reconhecimento se o valor era 0. Exemplo:
@Alarm.AckAll = (@Alarm.AckAll==0) ? 1 : 0;
134
6. Componentes do BluePlant AckRequired Fornece o Reconhecimento do operador exigido definido. Se 0: sem exigncia de reconhecimento. Se 1: reconhecimento exigido. Exemplo:
int AckReq = @Alarm.Group.Critical.AckRequired; se (AckReq == 1) @Alarm.AckAll = (@Alarm.AckAll==0) ? 1 : 0;
Colors Representa as cores de primeiro plano e plano de fundo para cada estado de alarme. Esta propriedade representa o valor configurado na coluna Cores. Description Descrio do Grupo de Alarmes configurada em EditAlarmsGroups. Exemplo:
@Tag.string = @Alarm.Group.Critical.Description;
Disable Habilita/Desabilita um Grupo de Alarmes. Se 0: habilita um Grupo de Alarmes. Se 1: desabilita um Grupo de Alarmes. Exemplo:
@Alarm.Group.Critical.Disable = 1;
Id Fornece a ID de um Grupo de Alarmes. Exemplo:

@Tag.Int = @Alarm.Group.Critical.Id;
LogEvents Fornece o tipo de arquivamento de Historiador em eventos de Alarme. Os valores permitidos so: 0 - Nenhum 1 - Ativo 2 - ActiveAck 3 - ActiveNorm 4 - All
Exemplo:
@Tag.Int = @Alarm.Group.Critical.LogEvents;
PriorityItem Retorna o item de Alarme de maior prioridade de um Grupo de Alarmes. Exemplo:

@ALARM.PRIORITYITEM PITEM = @ALARM.GROUP.CRITICAL.PRIORITYITEM;
Show Fornece um valor configurado para exibir/ocultar um Alarme. Valores permitidos: 0 - Nenhum 1 - Lista
Exemplo:
@Tag.Int = @Alarm.Group.Critical.Show;
135
6. Componentes do BluePlant Sound Propriedade para descrever se o Som do Grupo de Alarmes est habilitado ou no. Valores permitidos: 0 - Nenhum 1 - Beep
Exemplo:
@Tag.Int = @Alarm.Group.Critical.Sound;
TotalCount Fornece o nmero de Alarmes Ativos. Exemplo:

@Tag.Int = @Alarm.Group.Critical.TotalCount;
UnAckCount Fornece o nmero de Alarmes Sem Reconhecimento. Exemplo:

@Tag.Int = @Alarm.Group.Critical.UnAckCount;
Class AlarmItem Propriedades do Runtime para objetos de Itens de Alarme. AckTime Horrio em que o Alarme est definido em "Reconhecimento". ActiveTime Horrio em que o Item de Alarme iniciou. Alarm Propriedade para verificar se o Item de Alarme est ativo. ColorBG Configurada a Cor do Plano de Fundo do Item de Alarme. ColorFG Configurada a Cor do Primeiro Plano do Item de Alarme. Condition Configura a condio de avaliao para gerar um Item de Alarme. Os valores permitidos esto descritos a seguir. Hi (alto) HiHi (alto-alto) Lo (baixo) LoLo (baixo-baixo) RateOfChange (taxa de variao) DeviationMinor (desvio para mais) DeviationMajor (desvio para menos)
136
6. Componentes do BluePlant Deadband Banda morta de um item de alarme definido. Configura o tempo de inatividade do item de alarme. O valor escolhido pelo usurio. Disable Propriedade para desabilitar/habilitar um item de alarme. Valores permitidos: Group Um Grupo ao qual pertence um Item de Alarme. Id ID do objeto (uso interno). Limit Fornece o valor definido para avaliar as condies do item de Alarme. Message Fornece a mensagem configurada para ser exibida quando ocorre o Alarme. NormTime Tempo que o Alarme leva para voltar ao "Normal". Priority Fornece uma Prioridade do Item de Alarme. O valor escolhido pelo usurio. Setpoint Fornece o valor definido para avaliar as condies do Item de Alarme. SetPointDeadband Representa a banda morta para a propriedade SetPoint. Usada para as seguintes condies de alarme: DeviationMinor e DeviationMajor. 0 - Habilitar 1 - Desabilitar Equal (igual) GreaterThan (maior que) GreaterEqual (maior ou igual) LessThan (menor que) LessEqual (menor ou igual) Changed (alterado) ChangedUp (alterado para cima) ChangedDown (alterado para baixo)
137
6. Componentes do BluePlant State Fornece o estado de um item de alarme. Um item de alarme pode ser: Ativo, Reconhecimento, Normal e TagName. Neste ltimo caso fornece o TagName definido que ser avaliado para gerar um Item de Alarme. UnAck Propriedade Ler/Definir um item de alarme de reconhecimento. Valores permitidos: 0 - No Reconhecer Item de Alarme 1 - Reconhecer Item de Alarme
Class ModuleAlarm Mtodos do Runtime e propriedades para o mdulo de alarme. AckAll Dispara esta propriedade para reconhecer todos os Alarmes. BeepState Indica se o beep est configurado para ON (valor = 1) no computador cliente. Group Fornece acesso aos objetos do Grupo de Alarmes. InitializationMessage L/Define a Mensagem Inicial a ser exibida. Item Acesso aos objetos do Item de Alarme. LastErrorMessage Contm a mensagem de descrio do erro mais recente ocorrido no Mdulo Alarme. LastStoredTimeStamp Contm o TimeStamp do erro mais recente ocorrido no Mdulo Alarme. PriorityItem Referncia ao Item de Alarme online de maior prioridade. QueryActive Objeto TDataTable com a lista atual de Alarmes ativos. TotalCount Contagem total de Alarmes ativos.
138
6. Componentes do BluePlant UnAckCount Contagem total de Alarmes que exigem reconhecimento. Namespace Device Objetos Runtime e mtodos relacionados ao Dispositivo. Class DeviceAccessType Propriedades do Runtime para objetos DeviceAccessType. AcceptUnsolicited Quando configurado como true, os pontos do dispositivo so autorizados a receber mensagens no solicitadas. O canal do dispositivo deve ter a propriedade AcceptUnsolicited configurada para "true" para permitir mensagens no solicitadas. ReadOnStartup Quando configurado como true, o ponto do dispositivo ser lido na inicializao do Mdulo Dispositivo. ReadPooling Quando configurado como true, indica que o Pooling lido est habilitado para este ponto do dispositivo. ReadPoolingRate Indica a taxa de Pooling para o grupo de pontos. WriteEnable Quando configurado como true, o ponto do dispositivo ser escrito para o dispositivo quando o valor deste se alterar. Class DeviceChannel Propriedades do Runtime para objetos DeviceChannel. Activity Indicao de atividade. O mdulo dispositivo alterna este valor para cada operao completada neste Canal.
139
LastErrorCode ltimo Cdigo do Estado de Erro (mais recente) ocorrido neste canal. Valores permitidos:
Valor 0 -1 -2 -3 -4 -5 -6 -100 -101 -102 -103 -104 -105 -106 -107 -108 -109 -110 -111 -112 -113 -114 -115 -200 -201 -202 -203 -204 -205 -206 -207 Success BuildCommandException ParseCommandUnsolicitedException ParseReplyException BuildReplyUnsolicitedException ChannelException NodeException Base Send Error Base SendAndWait Error TCP Create Error 1 TCP Create Error 2 TCP Create SocketError TCP Connect Callback Error TCP Receive Error UDP Create Error UDP Receive Error Serial Create Error Serial Receive Error TCP NotConnected Start message timeout Receiving bytes timeout End message timeout Connect timeout ProtocolError InvalidProtocol InvalidStation InvalidCommand InvalidMsgSequence InvalidCheckSum InvalidAddress InvalidModifiers Descrio
Tabela 6-11. Cdigos de Estado para Canal ou N Nota: Valor: Valores positivos so cdigos de erro de protocolos especficos. LastErrorDateTime TimeStamp do ltimo erro (mais recente) ocorrido neste canal. Status Status atual para este canal. Valores permitidos podem ser vistos na Tabela 6-11. Class DeviceNode Propriedades do Runtime para objetos DeviceNode.
140
6. Componentes do BluePlant Activity Indicao de atividade. O dispositivo alterna este valor para cada operao executada neste N. BackupStation Estao de backup atual para este N. IsBackup Indicao de estao de Backup ativa. IsPrimary Indicao de PrimaryStation ativa. IsRedundancyEnabled Indicao de redundncia de N. LastErrorCode ltimo estado de cdigo de erro (mais recente) ocorrido neste N. Valores permitidos podem ser vistos na Tabela 6-11. LastErrorDateTime DateTime para o ltimo (mais recente) erro neste N. PrimaryStation Estao principal atual para este N. Status Status atual para este N. Valores permitidos podem ser vistos na Tabela 6-11. Class ModuleDevice Mtodos do Runtime e propriedades para o Mdulo Dispositivo. AccessType Acesso aos objetos DeviceAccessType. Channel Acesso aos objetos DeviceChannel. Node Acesso aos objetos DeviceNode. Namespace Dataset Objetos de Runtime e mtodos relacionados base de dados.
141
6. Componentes do BluePlant Class DatasetDB Propriedades do Runtime para objetos DatasetDB. Connectionstring String usada para conectar-se com o banco de dados. Database Nome do banco de dados do objeto DB. Id Identificao (ID) do objeto (Uso Interno). LogonName Nome de logon usada para conectar-se com o banco de dados. Provider Provider do banco de dados selecionado. Class DatasetFile Propriedades do Runtime para objetos DatasetFile. LoadCommand Carrega os valores dos tags configurados na propriedade Objetos a partir do arquivo indicado pela propriedade Nome do arquivo. O parmetro associado string statusMessage, ou seja, a mensagem com o status do comando de carga. SaveCommand Salva os valores dos tags configurados na propriedade Objetos a partir do arquivo indicado pela propriedade Nome do Arquivo. O parmetro associado string statusMessage ou seja, a mensagem com o status do comando de salvamento. Completed O valor desta propriedade aumentado quando uma operao concluda. Description Fornece a descrio do DatasetFile configurado. Disable Desabilita os comandos para o DatasetFile quando o valor maior que zero. Valores permitidos: 0 = Habilita os comandos para o DatasetFile 1 = Desabilita os comandos para o DatasetFile
142
6. Componentes do BluePlant FileName Caminho completo do arquivo que ser criado ou carregado. Esta propriedade representa o valor configurado na coluna FileName. FileType Indica o formato do arquivo. Valores permitidos: ASCII = 0 Unicode = 1 XML = 2
Esta propriedade representa o valor configurado na coluna FileType. Id Identificao (ID) do objeto (Uso Interno). LastStatus Fornece o status da ltima (mais recente) operao assncrona. Valores permitidos: Zero = xito Diferente de zero = Cdigo de erro
LastStatusMessage Fornece a mensagem de status da ltima (mais recente) operao assncrona. Load Envia um comando Carregar assncrono quando o valor alterado. O valor da propriedade LoadExecuted alterado quando a operao concluda. Exemplo:
if (@Dataset.File.File1Unicode.Load.Equals(0)) @Dataset.File.File1Unicode.Load = 1; else @Dataset.File.File1Unicode.Load = 0;
LoadExecuted O valor desta propriedade alterado quando o comando Carregar assncrono se completa. Objects Contm os tags e ndices a serem salvos ou carregados. Os valores permitidos so TagName, o qual representa o nome do Tag (o ndice inicial tambm pode ser especificado) e Index, indicando o ndice (se o Tag um array, e o ndice inicial especificado). Exemplo:
TagName Tag.doubleArray[0] Tag.textArray[2] Tag.SelectStatusMsg ndice 10 5
Tabela 6-12. Exemplo da Opo Objects
143
6. Componentes do BluePlant Save Envia um comando Salvar quando o valor alterado. O valor da propriedade SaveExecuted alterado quando a operao se conclui. Exemplo:
if (@Dataset.File.File1Unicode.Save.Equals(0)) @Dataset.File.File1Unicode.Save= 1; else @Dataset.File.File1Unicode.Save= 0;
SaveExecuted O valor desta propriedade alterado quando o comando de salvamento assncrono se completa. Class DatasetQuery Propriedades do Runtime para objetos DatasetQuery. ExecuteCommand Executa um comando sncrono de acordo com o SqlStatement. Os valores de retorno em relao ao status da operao esto indicados a seguir: Zero = xito Diferente de zero = Cdigo do erro
ExecuteCommandWithStatus Executa um comando sncrono de acordo com o SqlStatement; exibe uma mensagem de status. Os valores de retorno em relao ao status da operao esto indicados a seguir: Zero = xito Diferente de zero = Cdigo do erro
Parmetros: out string statusMessage. A mensagem indica o status do comando Next. NextCommand Executa um comando sncrono Next que aumenta o valor da propriedade CursorIndex. Os valores de retorno em relao ao status da operao esto indicados a seguir: Zero = xito Diferente de zero = Cdigo do erro
Os tags configurados na coluna de mapeamento recebero o valor da prxima linha. NextCommandWithStatus Executa um comando sncrono Next que aumenta o valor da propriedade CusorIndex e exibe uma mensagem de status. Os valores de retorno em relao ao status da operao esto indicados a seguir: Zero = xito Diferente de zero = Cdigo do erro
O parmetro associado out string statusMessage, ou seja, a mensagem que indica o status do comando Next. Os tags configurados na coluna mapeamento recebero o valor da prxima linha.
144
6. Componentes do BluePlant SelectCommand Executa um comando sncrono Selecionar, de acordo com o SqlStatement. Os valores de retorno so: DataTable em caso de xito; caso contrrio, nulo. Os tags configurados na coluna mapeamento recebero o valor da primeira linha. Exemplo:
DataTable dataTable = @Dataset.Query.query1.SelectCommand(); if (dataTable != null && dataTable.Rows.Count > 0) { @Tag.firstItem = dataTable.Rows[0]["Item"].Tostring(); }
SelectCommandWithStatus Executa um comando sncrono Selecionar, de acordo com o SqlStatement, e exibe informao de status. Os valores de retorno so: DataTable em caso de xito; caso contrrio, nulo. O primeiro parmetro associado : out int status. O status da operao est indicado a seguir: Zero = xito Diferente de zero = Cdigo do erro
O segundo parmetro associado : out string statusMessage, ou seja, a mensagem que indica o status do comando Select. Os tags configurados na coluna mapeamento recebero o valor da primeira linha. Exemplo:
int status; string statusMessage; DataTable dataTable; dataTable = @Dataset.Query.query1.SelectCommandWithStatus(out status, out statusMessage); if (status == 0 && dataTable != null && dataTable.Rows.Count > 0)) { @Tag.firstItem = dataTable.Rows[0]["Item"].Tostring(); }
AsyncContents Contm a TDataTable resultante de um dos comandos assncronos, tais como Select ou Update. Completed O valor desta propriedade aumenta quando uma operao assncrona se conclui. CursorIndex Definir a posio da linha atual no DatasetTable resultante. DB Fornece o DB configurado em EditDatasetsTables. Description Fornece a descrio do DatasetQuery.
145
Disable Desabilita os comandos para o DatasetQuery quando o valor maior que zero. Valores permitidos: Execute O valor da propriedade Execute se altera quando a operao concluda. Exemplo:
if (@Dataset.Query.Query1.Execute.Equals(0)) @Dataset.Query.Query1.Execute = 1; else @Dataset.Query.Query1.Execute = 0;
0 = Habilita os comandos para o DatasetQuery 1 = Desabilita os comandos para o DatasetQuery
ExecuteCompleted O valor da propriedade ExecuteCompleted se altera quando a operao concluda. Id Identificao (ID) do Objeto (Uso Interno). LastStatus Fornece o status da ltima (mais recente) operao assncrona. Valores permitidos: Zero = xito Diferente de zero = Cdigo do erro
LastStatusMessage Fornece a mensagem de status para a ltima (mais recente) operao assncrona, onde uma string vazia indica xito. Mapping Fornece o mapeamento das colunas do DataTable resultantes com os tags. Valores de retorno:
TagName int_Id txt_Name txt_Description Coluna ID Nome Descrio
Tabela 6-13. Mapeamento das Colunas do DataTable Resultado:

Tag.int_Id=ID; Tag.txt_Name=Name; Tag.txt_Description=Description;
Next Envia um comando Next assncrono quando o valor alterado. O valor da propriedade NextExecuted se altera quando a operao concluda. Exemplo:
if (@Dataset.Query.Query1.Next.Equals(0))
146
@Dataset.Query.Query1.Next = 1; else @Dataset.Query.Query1.Next = 0;
NextExecuted O valor desta propriedade se altera quando o comando assncrono Next se completa. RowCount Fornece o nmero total de linhas na DatasetTable resultante. Select Envia um comando Select assncrono quando o valor alterado. O valor da propriedade SelectExecuted se altera quando a operao concluda. Exemplo:
if (@Dataset.Query.Query1.Select.Equals(0)) @Dataset.Query.Query1.Select= 1; else @Dataset.Query.Query1.Select= 0;
SelectExecuted O valor desta propriedade se altera quando o comando Select assncrono se completa. O valor da propriedade SelectExecuted se altera quando a operao concluda. SqlStatement Define o comando SQL a ser executado. Class DatasetTable Propriedades do Runtime para objetos DatasetTable. DeleteCommand Exclui a linha atual da DatasetTable. Os valores de retorno em relao ao status da operao esto indicados a seguir: Zero = xito Diferente de zero = Cdigo do erro
O ndice da linha atual definido pela propriedade CursorIndex. DeleteCommandWithStatus Exclui a linha atual da DatasetTable e fornece uma mensagem de status. Os valores de retorno em relao ao status da operao esto indicados a seguir: Zero = xito Diferente de zero = Cdigo do erro
Parmetros: out string statusMessage. A mensagem indica o status do comando de excluso onde uma string vazia significa xito. O ndice da linha atual definido pela propriedade CursorIndex.
147
6. Componentes do BluePlant InsertCommand Insere os valores dos tags configurados na coluna mapeamento na DatasetTable na posio indicada pela propriedade CursorIndex. Os valores de retorno em relao ao status da operao esto indicados a seguir: Zero = xito Diferente de zero = Cdigo do erro
InsertCommandWithStatus Insere os valores dos tags configurados na coluna mapeamento na DatasetTable na posio indicada pela propriedade CursorIndex e fornece uma mensagem de status. Os valores de retorno em relao ao status da operao esto indicados a seguir: Zero = xito Diferente de zero = Cdigo do erro
O parmetro associado : out string statusMessage, ou seja, a mensagem que indica o status do comando de insero, onde uma string vazia significa xito. NextCommand Executa um comando Next sncrono o qual aumenta o valor da propriedade CursorIndex. Os valores de retorno em relao ao status da operao esto indicados a seguir: Zero = xito Diferente de zero = Cdigo do erro
Os tags configurados na coluna mapeamento recebero o valor da prxima linha. NextCommandWithStatus Executa um comando Next sncrono o qual aumenta o valor da propriedade CursorIndex e fornece uma mensagem de status. Os valores de retorno em relao ao status da operao esto indicados a seguir: Zero = xito Diferente de zero = Cdigo do erro
O parmetro associado : out string statusMessage, ou seja, a mensagem que indica o status do comando Next, onde uma string vazia significa xito. Os tags configurados na coluna mapeamento recebero o valor da prxima linha. SelectCommand Executa um comando Select sncrono na DatasetTable. Valor de retorno: DataTable em caso de xito; caso contrrio nulo. Os tags configurados na coluna mapeamento recebero o valor da primeira linha. Exemplo:
DataTable dataTable = @Dataset.Table.table1.SelectCommand(); if (dataTable != null && dataTable.Rows.Count > 0) { @Tag.firstItem = dataTable.Rows[0]["Item"].Tostring(); }
SelectCommandWithStatus Executa um comando Select sncrono na DatasetTable e fornece uma mensagem de status. Valor de retorno: DataTable em caso de xito; caso contrrio nulo.
148
6. Componentes do BluePlant Parmetro 1: out int status. Status da operao de seleo: Zero = sucesso Diferente de zero = cdigo de erro
Parmetros 2: out string statusMessage. A mensagem indica o status do comando Selecionar, onde uma string vazia significa sucesso. Os tags configurados na coluna mapeamento recebero o valor da primeira linha. Exemplo:
int status; string statusMessage; DataTable dataTable; dataTable = @Dataset.Table.table1.SelectCommandWithStatus(out status, out statusMessage); if(status == 0 && dataTable != null && dataTable.Rows.Count > 0)) { @Tag.firstItem = dataTable.Rows[0]["Item"].Tostring(); }
UpdateCommand Atualiza a linha atual da DatasetTable com os valores dos tags configurados na coluna mapeamento. Os valores de retorno so: DataTable em caso de xito; caso contrrio nulo. O ndice da linha atual definido pela propriedade CursorIndex. UpdateCommandWithStatus Atualiza a linha atual da DatasetTable com os valores dos tags configurados na coluna mapeamento e fornece uma mensagem de status. Valor de retorno: DataTable em caso de xito; caso contrrio nulo. Parmetro 1: out int status. Status da operao de atualizao: Zero = xito Diferente de zero = cdigo de erro
Parmetro 2: out string statusMessage. A mensagem indica o status do comando de atualizao, onde uma string vazia significa xito. O ndice da linha atual definido pela propriedade CursorIndex. Access Tipo de Acesso ao DatasetTable. Valores permitidos: 0 - Ler 1 - Inserir 2 - Ler/Escrever 3 - Irrestrito
AsyncContents Contm a TDataTable resultante de um dos comandos assncronos, tais como <i>Select ou Update. Completed O valor desta propriedade aumenta quando uma operao assncrona se conclui. CursorIndex Define a posio da linha atual na DatasetTable.
149
6. Componentes do BluePlant DB Fornece o DB configurado em EditDatasetsTables. Delete Envia um comando Delete assncrono quando o valor se altera. O valor da propriedade DeleteExecuted alterado quando a operao concluda. Exemplo:
if (@Dataset.Table.table1.Delete.Equals(0)) @Dataset.Table.table1.Delete= 1; else @Dataset.Table.table1.Delete = 0;
DeleteExecuted O valor desta propriedade se altera quando o comando Delete assncrono se completa. Description Fornece a Descrio do DatasetTable. Disable Desabilita os comandos para a DatasetTable quando o valor maior que zero. Valores permitidos: Id Identificao (ID) do Objeto (Uso Interno). Insert Envia um comando Insert assncrono quando o valor se altera. O valor da propriedade InsertExecuted altera quando a operao concluda. Exemplo:
if (@Dataset.Table.table1.Insert.Equals(0)) @Dataset.Table.table1.Insert= 1; else @Dataset.Table.table1.Insert = 0;
0 = Habilita os comandos para o DatasetTable 1 = Desabilita os comandos para o DatasetTable
InsertExecuted O valor desta propriedade alterado quando o comando Insert assncrono se completa. LastStatus Fornece o status da ltima (mais recente) operao assncrona. Valores permitidos: Zero = xito Diferente de zero = cdigo de erro
LastStatusMessage Fornece a mensagem de status da ltima (mais recente) operao assncrona, onde uma string vazia significa xito.
150
6. Componentes do BluePlant Mapping Fornece o mapeamento das colunas da DataTable com os tags. Exemplo:
TagName int_Id txt_Nome txt_Descrio Coluna ID Nome Descrio
Tabela 6-14. Mapping Resultado:

Tag.int_Id=ID; Tag.txt_Name=Name; Tag.txt_Description=Description;
Next Envia um comando Next assncrono quando o valor alterado. O valor da propriedade NextExecuted altera quando a operao concluda. Exemplo:
if (@Dataset.Table.table1.Next.Equals(0)) @Dataset.Table.table1.Next= 1; else @Dataset.Table.table1.Next = 0;
NextExecuted O valor desta propriedade alterado quando o comando assncrono Next se completa. RowCount Fornece o nmero total de linhas na DatasetTable. Select Envia um comando Select assncrono quando o valor alterado. SelectExecuted O valor da propriedade SelectExecuted se altera quando a operao concluda. Exemplo:
if (@Dataset.Table.table1.Select.Equals(0)) @Dataset.Table.table1.Select = 1; else @Dataset.Table.table1.Select = 0;
TableName Fornece o nome da tabela de dados. Update Envia um comando Update assncrono quando o valor alterado. O valor da propriedade UpdateExecuted altera quando a operao concluda. Exemplo:
if (@Dataset.Table.table1.Update.Equals(0)) @Dataset.Table.table1.Update = 1;
151
else @Dataset.Table.table1.Update = 0;
UpdateExecuted O valor desta propriedade alterado quando o comando Update assncrono se completa. WhereCondition Define a condio Onde para a DatasetTable. A clusula SQL WHERE usada para selecionar dados condicionalmente. Exemplo:
Tipo 1 1 2 Preo($) 27 120 50 DateAdded 10/02/2008 07/10/2010 12/01/2009
Tabela 6-15. SQL WHERE

@Dataset.Table.table1.WhereCondition = "DateAdded > '01/01/2010'";
O comando retornar somente os itens onde DateAdded for maior que 01/01/2010 Class ModuleDataset Mtodos do Runtime e propriedades para o Mdulo Dataset. DB Fornece acesso aos objetos DatasetDB. File Fornece acesso aos objetos DatasetFile. Query Fornece acesso aos objetos DatasetQuery. Table Fornece acesso aos objetos DatasetTable. Namespace Script Objetos Runtime e mtodos relacionados programao (Script). Class ModuleScript Mtodos do Runtime e propriedades para o Mdulo Script. RunTasksSimultaneous Habilita a execuo simultnea de tarefas (Multi-Threading). Valores permitidos: 0 - Execuo simultnea NO permitida 1 - Execuo simultnea permitida
152
6. Componentes do BluePlant Task Acesso aos objetos ScriptTask. Sintaxe:

Script.Task.<TaskName>.
UserClass Acesso aos objetos ScriptUserClass. Sintaxe:

Script.UserClass.<UserClassName>.
Class ScriptTask Classe de Tarefas Script. Description Fornece a Descrio da ScriptTask configurada em EditScriptsTasks. Disable Desabilita a execuo da ScriptTask quando o valor maior que zero. Valores permitidos: Domain Indica o Domnio da ScriptTask. Os valores permitidos so 0: Servidor e 1: Cliente. No caso de Servidor o ScriptTask executado no contexto do Servidor e no pode acessar os objetos Cliente, isto , telas ou tags de domnio do cliente. J no caso de Cliente o ScriptTask executado em cada Cliente onde o ModuleScript esteja em execuo. ErrorMessage Contm a mensagem com o ltimo (mais recente) erro ocorrido na execuo do script. Event Reservado para uso futuro. ExecutionsCount Fornece a quantidade de execues desde que o mdulo foi iniciado. LastCPUTime Fornece o tempo da UCP utilizado durante a ltima (mais recente) execuo do script. LastExecution Contm o TimeSpan da ltima (mais recente) execuo do script. Zero = xito Diferente de zero = cdigo de erro
153
6. Componentes do BluePlant Period Perodo de tempo exigido para executar uma Tarefa. Esta propriedade representa o valor configurado em EditScriptsTasks. Running Indica se o script atual est em execuo. Valores permitidos: 0 - ScriptTask NO est em execuo 1 - ScriptTask est em execuo
StopExecutionOnError Indica se a execuo do script deve ser interrompida em caso de erro. Trigger Fornece o Tag ou Objeto que dispara a execuo da Tarefa. Esta propriedade representa o valor configurado em EditScriptsTasks. Namespace Display Objetos Runtime e mtodos relacionados s telas da aplicao. Class Display Propriedades do Runtime para objetos Tela. Sintaxe: Display.<DisplayName> Close Fecha a tela selecionada. Open Abre a tela selecionada. Description Fornece a descrio da tela configurada em EditDisplaysDisplays. Id Identificao (ID) do Objeto (Uso Interno). IsOpened Indica se a tela selecionada est aberta. Class Layout Propriedades do Runtime para objetos Layout. Sintaxe: Layout.<LayoutName>. OpenCommand Abre o layout selecionado.
154
6. Componentes do BluePlant Description Fornece a descrio do layout, configurado em EditDisplaysLayouts. Id ID do Objeto (Uso Interno). IsOpened Indica se o layout selecionado est aberto. Namespace Report Objetos de Runtime e mtodos relacionados ao Mdulo Relatrio. Class ModuleReport Acesso aos objetos <ReportItem>. Class ReportItem Propriedades de Runtime para objetos Relatrio. OpenCommand Abre o relatrio selecionado. Valores de retorno: True = xito False = erro
O ReportViewer pode ser usado para visualizar o contedo do relatrio. SaveCommand Salva o relatrio selecionado no caminho indicado pela propriedade SaveFileName. Valores de retorno: Append Indica se o relatrio ser sobrescrito ou acrescentado nos comandos Salvar. Valores permitidos: Completed O valor desta propriedade aumenta quando a operao Salvar ou Carregar concluda. Description Fornece a descrio do ReportItem configurada em EditReportsReports. Disable Desabilita as operaes ReportItem quando o valor maior que zero. Valores de retorno:
155
True = xito False = erro
0 - Relatrio sobrescrito nos comandos Salvar 1 - Relatrio acrescentado nos comandos Salvar
6. Componentes do BluePlant Id Identificao (ID) do Objeto (Uso Interno). LastStatus Fornece ou define o status do ltimo ReportItem processado. Valores permitidos: Success = 0 InvalidMode = 1 Disabled = 2 NoObjectsConfigured = 3 ReportException = 4 InvalidContent = 5 ModuleStopped = 6 ModulePaused = 7 Zero = Habilita o ReportItem Maior que zero = Desabilita o ReportItem
LastStatusMessage Fornece ou define a mensagem de status do ltimo ReportItem processado. Valores permitidos: "Success" "InvalidMode" "Disabled" "NoObjectsConfigured" "ReportException" "InvalidContent" "ModuleStopped" "ModulePaused"
OpenExecuted Fornece ou define o estado OpenExecuted no relatrio. Valores permitidos: Padding Fornece o valor de ajuste no Relatrio. Valores permitidos: Compact = 0 PadRight = 1 PadLeft = 2 0 (zero) - Comando Abrir no executado 1 - Comando Abrir executado
SaveExecuted Fornece ou define o estado SaveExecuted no relatrio. Valores permitidos: 0 (zero) - Comando Salvar no executado 1 - Comando Salvar executado
156
6. Componentes do BluePlant SaveFileName Fornece ou define o caminho completo usado ao salvar o Relatrio. SaveFormat Fornece ou define o formato de salvamento no Relatrio. Valores permitidos: XPS = 0 Html = 1 Unicode = 2 ASCII = 3 PDF = 4
Namespace Info Objetos Runtime e mtodos relacionados s informaes do projeto. Class ModuleInfo Trace Rastreia um objeto do sistema. As referncias a este objeto so exibidas na janela de rastreamento. Parmetro: string text. Exemplo:
@Info.Trace("Digital1") @Info.Trace("Digital1"); (VB) (C#)
License Fornece o objeto InfoLicense que representa a licena atual. ExecutionPath Fornece o caminho de execuo onde esto instalados os mdulos executveis do sistema. Module Fornece o objeto InfoModuleList que representa a lista dos mdulos. OnlineConfig Fornece o estado de configurao online. Valores permitidos: Project Fornece o objeto InfoProjectVersion que representa a informao da verso do projeto. ProjectSettings Fornece o objeto InfoProjectSettings que representa a informao das configuraes do projeto. TestMode Fornece o estado do modo teste do projeto. Valores permitidos:
157
TRUE - configurao online habilitada FALSE - configurao online desabilitada
6. Componentes do BluePlant TRUE - Projeto est no modo teste FALSE - Projeto no est no modo teste
TestModeSync Fornece o estado de sincronizao do modo teste. Se 0 (zero), a sincronizao do modo teste est desabilitada. Se diferente de 0 (zero), a sincronizao do modo teste est habilitada. A sincronizao do modo Teste permite ao Modo Teste trabalhar com os valores disponveis dos tags atuais a partir da execuo da inicializao. Nota: TestModeSync: Esta funcionalidade est disponvel apenas na verso Enterprise. Class InfoprojectVersion CurrentBuild Fornece o nmero atual do compilador. DateCreated Fornece o objeto DateTime que representa a data em que a verso do projeto foi criada. DateModified Fornece o objeto DateTime que representa a data em que a verso do projeto foi modificada. Description Fornece a descrio da verso do projeto. ProductFamily Fornece a famlia do produto desta verso do projeto. Valores possveis: ProductModel Fornece o modelo do produto da verso do projeto. Valores possveis: 75 150 300 500 1500 2500 5000 15000 25000 50000 100000 1000000
158
"Student" "Express" "Lite" "Enterprise"
6. Componentes do BluePlant ProductName Fornece o nome do produto da verso do projeto. Valor possvel: "BluePlant". ProductVersion Fornece a verso do produto desta verso do projeto. ProjectName Fornece o nome do projeto desta verso do produto. ProjectPath Fornece o caminho desta verso do projeto. TargetFramework Fornece o framework destino desta verso do projeto. Versionstring Fornece a string desta verso do projeto. Exemplo: "1.0 (Editing)". Class InfoProjectSettings CultureInfo Fornece o idioma do projeto. Class InfoModuleList Alarm Fornece o objeto InfoModule para o mdulo Alarme. DataSet Fornece o objeto InfoModule para o mdulo DataSet. Device Fornece o objeto InfoModule para o mdulo Dispositivo. Display Fornece o objeto InfoModule para o mdulo Tela. Historian Fornece o objeto InfoModule para o mdulo Historiador. ModuleInformation Fornece o objeto InfoModule para o mdulo ModuleInformation.
159
6. Componentes do BluePlant OPCServer Fornece o objeto InfoModule para o mdulo OPCServer. PropertyWatch Fornece o objeto InfoModule para o mdulo PropertyWatch. Report Fornece o objeto InfoModule para o mdulo Report. ReportServer Fornece o objeto InfoModule para o mdulo ReportServer. Script Fornece o objeto InfoModule para o mdulo Script. Security Fornece o objeto InfoModule para o mdulo Segurana. Server Fornece o objeto InfoModule para o mdulo Servidor. TraceWindow Fornece o objeto InfoModule para o mdulo TraceWindow. Class InfoLicense AllowedRichClients Fornece o estado AllowedRichDevices. Valores permitidos: Zero - clientes Rich no permitidos Diferente de zero - clientes Rich permitidos
AllowedRunInstances Fornece o estado AllowedRunInstances. Valores permitidos: Zero - instncias de execuo no permitidas Diferente de zero - instncias de execuo permitidas
AllowedTagElements Fornece o estado AllowedTagElements. Valores permitidos: Zero - elementos do Tag no permitidos Diferente de zero - elementos do Tag permitidos
AllowedWebClients Fornece o estado AllowedWebClients. Valores permitidos:

160
6. Componentes do BluePlant DateCreated Fornece a data e hora em que a licena foi criada. DateModified Fornece a data e hora em que a licena foi modificada. ExpirationDate Fornece a data e hora em que a licena expira. LicenseMedia Fornece informao sobre a mdia da licena. Valores possveis: LicenseType Fornece informao sobre o tipo da licena. Valores possveis: "None" "Run" "Eng_Run" "Developer" "Hardkey" "Softkey" Zero - clientes Web no permitidos Diferente de zero - clientes Web permitidos
ProductFamily Fornece a famlia do produto da licena. Valores possveis: ProductModel Fornece um valor numrico que caracteriza o modelo do produto licenciado considerando as seguintes opes: 75, 150, 300, 500, 1.500, 2.500, 5.000, 15.000, 25000, 50.000, 100.000, 1.000.000. ProductVersion Fornece a verso de produto da licena. SerialNumber Fornece o nmero de srie da licena. ServerConnected Fornece o endereo completo do servidor. "Student" "Express" "Lite" "Enterprise"
161
6. Componentes do BluePlant AllowedEngineeringUsers Fornece o estado AllowedEngineeringUsers. Valores permitidos: Zero - usurios de engenharia no permitidos Diferente de zero - usurios de engenharia permitidos
AllowedDevices Fornece o estado AllowedDevices. Valores permitidos: Zero - dispositivos no permitidos Diferente de zero - dispositivos permitidos
Class InfoModule IsPaused Fornece ou define o estado IsPaused do mdulo. Valores permitidos: IsRunning Fornece ou define o estado IsRunning do mdulo. Valores permitidos: TRUE - mdulo em execuo FALSE - mdulo no est em execuo TRUE - mdulo est pausado FALSE - mdulo no est pausado
Namespace Server Objetos Runtime e mtodos relacionados ao servidor. ServerStation A classe ServerStation contm informaes sobre o computador no qual o Servidor do Runtime (programa TServer.exe) est sendo executado. LoadProjectVersion Carrega o projeto mostrado pelo caminho especificado. O caminho deve apontar para um projeto vlido no servidor. Valores permitidos: TRUE em caso de xito e FALSE em caso de falha. Parmetro associado: string projectPathName. SwitchToStandby Transfere a execuo para o computador reserva se a redundncia est habilitada. Valores permitidos: TRUE em caso de xito e FALSE em caso de falha. HttpAddress Fornece o endereo http do servidor.
162
IsPrimary Fornece o estado IsPrimary. Valores permitidos: TRUE - servidor principal FALSE - servidor no principal
IsRedundancyEnabled Fornece o estado IsPrimary do servidor. Valores permitidos: IsSecondary Fornece o estado IsSecondary. Valores permitidos: TRUE - servidor secundrio FALSE - servidor no secundrio TRUE - redundncia habilitada FALSE - redundncia desabilitada
IsStandByActive Fornece o estado IsStandByActive. Valor padro: TRUE - servidor reserva est ativo FALSE - servidor reserva est inativo
IsSwitchToPrimaryEnabled Fornece o estado IsSwitchToPrimayEnabled. Valores permitidos: TRUE - opo de troca para o principal habilitada FALSE - opo de troca para o principal desabilitada
ServerStation.ComputerIP Fornece ou define o IP do computador do servidor. ServerStation.ComputerName Fornece ou define o nome do computador do servidor. ServerStation.Date Fornece a data do servidor. ServerStation.Day Fornece o dia do ms do servidor. ServerStation.DayOfWeek Fornece o dia da semana do servidor. ServerStation.DayOfYear Fornece o dia do ano do servidor. Valores permitidos: 1 a 366.
163
6. Componentes do BluePlant ServerStation.Hour Fornece a hora do dia do servidor. ServerStation.Minute Fornece o componente minuto da data do servidor. ServerStation.Month Fornece o componente ms da data do servidor. ServerStation.Now Fornece a data local do servidor e offset de tempo. ServerStation.Second Fornece o componente segundo da data do servidor. ServerStation.ShutDown Fornece ou define o estado de desligamento do servidor. Valores permitidos: TRUE - servidor est sendo desligado FALSE - servidor no est sendo desligado
ServerStation.Startup Fornece o estado de inicializao do servidor. Valores permitidos: TRUE - servidor foi inicializado FALSE - servidor no foi inicializado
ServerStation.Ticks Fornece o nmero de marcaes que representam a data e hora do servidor. ServerStation.Time Fornece a hora do dia do servidor. ServerStation.Year Fornece o componente ano da data do servidor. TimeMs Fornece a hora do dia do servidor (inclusive milissegundos). Namespace Client Objetos de Runtime e mtodos relacionados ao Namespace do Cliente. Class ClientStation A classe ClientStation contm informaes sobre o computador no qual o cliente est em execuo (TVisualizer.Exe ou clientes Web).
164
6. Componentes do BluePlant ChangeUserPassword Altera a senha do usurio referenciado. Valor de retorno: TRUE em caso de sucesso e FALSE em caso de falha. Parmetros associados: string username, string oldPassword e string newPassword. CloseDisplay Fecha a tela referenciada. Parmetro associado: string displayName. GetPasswordHint Fornece a dica de senha para o usurio referenciado. Valor de Retorno: a dica da senha. Parmetro associado: string userName. Locale Retorna o texto localizado. Valor de Retorno: texto localizado. Parmetro associado: string text. LogOn Executa o logon do usurio especificado com a senha especificada. Parmetros associados: string username e string password. Valores de retorno: LogOnGuest Executa o logon do usurio como "Guest". OpenDisplay Abre a tela na pgina do ltimo layout. Parmetro associado: string displayName OpenDisplayAtIndex Abre a tela na pgina do layout especificado pelo ndice. Parmetros: string displayName e int index. OpenLayout Abre o layout referenciado. O parmetro associado : string layoutName. OpenPopupNote Abre uma nota de popup com ttulo e descrio especificados. Os parmetros associados so: string title, string description, bool isReadOnly, double left e double top. OK = 0 ServerNotAvailable = 1 InvalidLogon = 2 ServerNotConnected = 3 UserBlocked = 4 UserDeleted = 5 CannotStartModule = 6 InvalidUserName = 10 InvalidPassword = 11 PermissionsRestrictions = 12 UnknownError = 99
165
6. Componentes do BluePlant OpenPreviousPage Abre a pgina exibida anteriormente. Valores permitidos: TRUE em caso de sucesso FALSE em caso de falha
SaveLayoutAsImage Salva o layout como uma imagem. O caminho para o arquivo ser definido no dilogo seguinte. SaveLayoutAsImageFile Salva o layout como arquivo de imagem. O parmetro associado : string fileName. SwitchToStandby Troca o servidor para o modo Standby. Os valores permitidos so: BeepOff Fornece ou define o estado de beep desligado do cliente. Os valores permitidos so: BlinkFast Fornece a propriedade de piscar rpido do cliente. Esta propriedade uma varivel digital que alterna de 0 a 1 e de 1 a 0, permanecendo 500 milissegundos em cada estado. BlinkSlow Fornece a propriedade de piscar devagar. Esta propriedade uma varvel digital que alterna entre 0 e 1, permanecendo 250 ms em cada estado. ComputerIP Fornece o IP do computador. ComputerName Fornece o nome do computador. CultureInfo Fornece ou define a seleo de idioma do cliente. CurrentPage Fornece o nome da pgina do cliente exibida atualmente. CurrentUser Fornece o usurio atual do cliente.
166
TRUE em caso de sucesso FALSE em caso de falha
TRUE - beep desligado FALSE - beep ligado
6. Componentes do BluePlant Date Fornece a data do cliente. DateTime Fornece a data e hora do cliente. Day Fornece o dia do ms do cliente. DayOfWeek Fornece o dia da semana do cliente. DayOfYear Fornece o dia do ano do cliente. Dictionary Fornece ou define o dicionrio do cliente. Hour Fornece o componente hora da data do cliente. InputPassword Fornece ou define a senha de entrada do cliente. Esta uma varivel auxiliar usada na janela de logon padro do sistema. InputUserName Fornece ou define o nome do usurio de entrada do cliente. Esta uma varivel auxiliar usada na janela de logon padro do sistema. IsWebBrowser Fornece o estado IsWebBrowser do cliente. LayoutName Fornece ou define o nome do layout do cliente. Millisecond Fornece o componente milissegundo da data do cliente. Minute Fornece o componente minuto da data do cliente. Month Fornece o componente ms da data do cliente.
167
6. Componentes do BluePlant Now Fornece a data local do cliente e offset de tempo. OnScreenKeyboard Fornece ou define o estado de tela e teclado do cliente. PreviousPage Fornece o nome da pgina anterior do cliente. Second Fornece o componente segundo da data do cliente. SelectedPage Fornece ou define o nome da pgina selecionada do cliente. ServerHttpAddress Fornece o endereo http do cliente. ShutDown Fornece ou define o estado de desligamento do cliente. Os valores permitidos so: TRUE - cliente est desligado FALSE - cliente no est desligado
SimulationAnalog Fornece uma varivel de simulao [int] analgica, a qual varia de 0 a 100 (em incrementos de 1); retorna a 0 em um ciclo e ento repete o mesmo padro (onda dente de serra). SimulationDigital Fornece uma varivel de simulao digital que alterna entre 0 e 1, permanecendo 3 segundos em cada estado. SimulationDouble Fornece uma varivel de simulao [double] analgica, a qual varia de 0 a 100; retorna de 100 a 0, e ento repete o mesmo padro. Startup Fornece o estado de inicializao do cliente. Valores permitidos: Ticks Fornece o nmero de marcaes que representam a data e hora do cliente. TRUE - cliente foi inicializado FALSE - cliente no foi inicializado
168
6. Componentes do BluePlant Time Fornece o horrio do dia do cliente. TimeMs Fornece o horrio do dia do cliente incluindo milissegundos. Tomorrow Fornece o componente dia da data de amanh do cliente. UserName Fornece o nome de usurio do cliente. UtcNow Fornece a data UTC e offset de horrio do cliente. Year Fornece o componente ano da data do cliente. Yesterday Fornece o componente dia da data de ontem do cliente. CurrentPage Fornece o nome da pagina atual. DateTime Fornece a data e hora da pgina do cliente exibida atualmente. IsWebBrowser Fornece o estado IsWebBrowser do cliente. Os valores permitidos so: TRUE - o cliente est em execuo com um navegador da Web FALSE - o cliente no est em execuo com um navegador da Web
OnScreenKeyboard Fornece ou define o estado de tela e teclado do cliente. Parmetro associado: public bool OnScreenKeyboard { get; set; }. Os valores permitidos so: PreviousPage Fornece o nome da pgina anterior do cliente. ServerHttpAddress Fornece o endereo http do cliente.
169
TRUE - funcionalidade do teclado e tela est ativa FALSE - funcionalidade do teclado e tela no est ativa
6. Componentes do BluePlant SimulationAnalog Fornece uma varivel de simulao [int] analgica, a qual varia de 0 a 100 (em incrementos de 1); retorna a 0 em um ciclo e ento repete o mesmo padro (onda dente de serra). SimulationDouble Fornece uma varivel de simulao [double] analgica, a qual varia de 0 a 100; retorna de 100 a 0, e ento repete o mesmo padro.
Configuraes Avanadas
Esta seo contm informao adicional sobre os aplicativos do BluePlant incluindo: Linha de Comando Executando o BluePlant como um Servio do Windows Clientes Remotos Instalando o Web Server no IIS
Linhas de Comando As informaes sobre as ferramentas BluePlant e executveis que podem ser chamados usando linhas de comando e parmetros especficos esto descritos a seguir. TStartup Inicializa o projeto BluePlant. TVisualizer Inicializa o Mdulo BluePlant Visualizer. TraceWindow Inicializa a ferramenta BluePlant TraceWindow. PropertyWatch Inicializa a ferramenta de diagnstico PropertyWatch. ModuleInformation Inicializa a ferramenta de diagnstico Mdulo Informao. DisableTaskSwitchProtection O usurio precisa executar o arquivo de batch file para instalar o driver do dispositivo que pode bloquear CTRL+ALT+DEL enquanto o TVisualizer est em execuo. RegServer Registra o servidor BluePlant OPC. UnRegServer Cancela o registro do servidor BluePlant OPC.
170
6. Componentes do BluePlant Executando o BluePlant como um Servio do Windows Este procedimento descreve como instalar aplicaes BluePlant do servidor Runtime para execuo como um servio do Windows. Por favor, observe que, para permitir a Engenharia Distribuda e tambm para servir pginas para clientes Web, o usurio tambm precisa ter um servidor Web habilitado. Consulte o tpico Installing Web Server in IIS para informaes sobre esse procedimento. A fim de executar o aplicativo como um servio do Windows:
<.NET Framework Install Path>\installutil <Install Path>\<BluePlant Version>\TStartupAsService.exe.
No prompt do DOS (deve-se Executar como Administrador), execute o seguinte comando:

C:\Windows\Microsoft.NET\Framework\v4.0.30319>installutil "C:\Program Files\Altus\bp-2012.1\TStartupAsService.exe"
Em seguida, o usurio precisa incluir a linha de comando para o servio, que a mesma do programa tStartup.exe: /project:<projectNameAndPath>. No est disponvel ainda um utilitrio para configurar o registro. O usurio precisa fazer isso manualmente. Deve-se definir no Registro do Windows e configurar os parmetros. Abra o Editor de Registro (regedit) e v para a seguinte chave:
"HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\TStartup\ImagePath" "C:\Program Files\Altus\bp-2012.1\TStartupAsService.exe" "/project:C:\BluePlant Projects\Project1.tproj"
Note que nos exemplos acima, deve-se alterar o caminho de instalao do aplicativo para a instalao no seu computador. Finalmente, nas janelas "Services" (Ferramentas Administrativas), deve-se configurar o "TStartup Service". Pode-se configur-lo como "Automatic", de forma que o projeto selecionado abra quando o computador inicializado. Clientes Remotos O nico pr-requisito para executar o aplicativo no cliente remoto a instalao do .Net Framework. O aplicativo no precisa ser instalado nos computadores clientes. Uma vez que o servidor BluePlant tenha o WebServer (IIS ou TWebServer) em execuo, pode-se digitar o seguinte endereo do navegador Internet Explorer: Cliente Rich:
http://<server ip or name>/<BluePlant Version>/tvisualizerremote.application
Cliente Web:
http://<server ip or name>/<BluePlant Version>/tvisualizerweb.xbap
Dependendo da verso do Internet Explorer a seguinte configurao deve ser feita: Desativar o modo protegido na Zona Internet ou Intranet conforme ilustrado na Figura 6-83.
171
Figura 6-83. Desativar o Modo Protegido Habilitar aplicaes do navegador XAML conforme mostrado na Figura 6-84.
Figura 6-84. Habilitar Aplicaes do Navegador XAML Exemplo: Cliente Remoto Rich: http://127.0.0.1/bp-2012.1/TVisualizerRemote.application Cliente Web: http://127.0.0.1/bp-2012.1/TVisualizerWeb.xbap Instalando o Web Server no IIS Ao instalar o aplicativo, se o IIS for localizado, o usurio no ser capaz de instalar o nosso servidor Web embutido (TWebServer.exe). O programa ir rodar sem o servidor Web, acessando remotamente configuraes do projeto e servindo pginas Web em Runtime. Todas as outras ferramentas de execuo ou engenharia do BluePlant sero executadas sem a necessidade de instalar o TWebServer ou configurar o IIS. Se o usurio desejar habilitar o acesso de engenharia remoto e os clientes Web usando o IIS, ele precisa instalar alguns servios no IIS. Este manual explica como instalar servios BluePlant no IIS. Esta descrio refere-se ao IIS 7.x, mas outras verses no apresentam muitas diferenas. Outro cenrio em que o IIS necessrio quando o usurio quer executar o RUNTIME como um servio do Windows, e ainda ser capaz de fornecer pginas da Web, clientes iPad e engenharia remota. Pode-se instalar trs servios dentro do IIS, o primeiro deles o TProjectServer que permite acessar remotamente suas configuraes de projeto. O outro servio o TVisualizerWeb/TVisualizerRemote que permite o acesso remoto a interfaces em Runtime.. Finalmente, o iDataPanel o servio para fornecer dados para dispositivos iOS. Use as seguintes instrues passo-a-passo para configurar o IIS
172
6. Componentes do BluePlant Procedimento de Instalao Este procedimento pode ser executado no Windows 7, x64, com o IIS 7.5. Com verses mais antigas do sistema operacional e do IIS, o procedimento pode ser ligeiramente diferente, como a definio de um Virtual Directory em vez de Add Application. Verifique se o IIS est instalado e funcionando, por exemplo, tentando abrir pginas HTML Habilite o ASP.Net e manipuladores .Svc para o Servio WCF
Instalao no IIS 7.x Se o IIS foi instalado aps a instalao do. NET Framework necessrio executar o procedimento descrito em http://msdn.microsoft.com/en-us/library/ms752252.aspx que consiste em executar os seguintes programas usando o prompt de comando como administrador (conforme ilustrado nas figuras a seguir):
"aspnet_regiis i enable" (do diretrio de instalao do .NET Framework*)
Figura 6-85. Procedimento de Instalao para o IIS 7.x

"ServiceModelReg.exe" -r (do diretrio de instalao do .NET Framework*)
Figura 6-86. ServiceModelReg.exe O diretrio de instalao do .NET Framework : C:\Windows\Microsoft.NET\Framework\v4.0.30319, ou C:\Windows\Microsoft.NET\Framework64\v4.0.30319 (para Windows x64) Instalao no IIS 8.0 No caso do IIS 8.0 o procedimento est descrito a seguir. V para "Program and Features", escolha Turn Windows features on or off.
Figura 6-87. Chaveamento de Funcionalidades do Windows

173
6. Componentes do BluePlant Habilite a opo "Internet Information Services - World Wide Web Services - Application Development Features - ASP.NET 4.5".
Figura 6-88. Funcionalidades do Windows Habilite a opo "HTTP Activation" (no .Net Framework 4.5 Advanced Services).
Figura 6-89. Ativao HTTP Verifique se a extenso ".svc" mapeada para a pasta est mapeada para "aspnet_isapi.dll" (no site msdn.microsoft, link anterior, explicado como verificar isso para vrias verses IIS).
174
Figura 6-90. Mapeamento da Extenso Na pasta de instalao do BluePlant, execute o utilitrio: InstallTWebServer.exe /uninstall, o qual remover a instalao atual do TWebServer conforme ilustrado na Figura 6-91.
Figura 6-91. Utilitrio InstallTWebServer Na sequncia verifique se o TWebServer est definido para iniciar automaticamente. Abra o Editor do Registro do Windows (regedit.exe) e v para a seguinte chave:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run.
Se for identificada uma referncia a "TWebServer", apague-a. No IIS 7.x, abra "Sites/Default Web Site/Add Application" e configure a informao para os servios conforme ilustrado na Figura 6-92.
Figura 6-92. Informao para servios
175
6. Componentes do BluePlant Os ajustes para o TProjectServer apresentadas na Figura 6-93 so: Alias:TProjectServer Physical Path (1): verifique e corrija para a pasta de instalao BluePlant Application Pool: configure para qualquer conjunto baseado no .NET 4.0
Exemplo: ASP.NET v4.0.
Figura 6-93. ProjectServer O acesso como Everyone (pelo menos para leitura) deve ser configurado. No IE, use a URL "http://localhost/tprojectserver/service.svc" para verificar se o servio foi corretamente instalado. Ela mostrar uma pgina com informaes sobre o servio. Os ajustes para o TVisualizerWeb/TVisualizerRemote so: Alias: verso do BluePlant, por exemplo: bp-2012.1 Physical Path: pasta de instalao do BluePlant para a verso especfica Application Pool: configure para qualquer conjunto baseado no .NET 4.0 Exemplo: ASP.NET v4.0
Nota: Security: A opo Security deve estar habilitada para "Everyone", pelo menos para leitura! No IE, use a URL http://localhost/bp-2012.1/service.svc" para verificar se o servio foi corretamente instalado. Ela deve mostrar uma pgina com informaes sobre o servio. Os ajustes para o Servio iDataPanel apresentados Figura 6-94 so: Alias: iDataPanel Physical Path (1): pasta de instalao do BluePlant para a verso especfica Application Pool: configure para qualquer conjunto baseado no .NET 4.0
Exemplo: ASP.NET v4.0.
176
Figura 6-94. Servio iDataPanel Nota: Security: A opo Security deve estar habilitada para "Everyone", pelo menos para leitura. No IE, use a URL "http://localhost/iDataPanel/iDataPanelService.svc" para verificar se o servio foi corretamente instalado. Ela mostrar uma pgina com informaes sobre o servio. Os ajustes para o iDataPanelImages (Diretrio Virtual) ilustrados nas figuras a seguir so: Alias: iDataPanelImages Physical Path: C:\BluePlant Projects\iDataPanelImages
Figura 6-95. Diretrio Virtual
177
Figura 6-96. Acrescentar Diretrio Virtual Notas: Security: A opo Security deve estar habilitada para "Everyone", pelo menos para leitura. Anonymous Authentication deve estar habilitada para os servios conforme pode ser visto na Figura 6-97.
Figura 6-97. Autenticao O IIS deve ser reiniciado aps a configurao dos servios.
178
7. Cenrios de Sistemas Tpicos

Este captulo descreve os cenrios tpicos de utilizao do BluePlant para atender demandas que contemplam as reas de produo, utilidades e manufatura. Alm disso, o projeto completo da aplicao pode incluir uma combinao desses cenrios com o objetivo de atender as demandas de customizao do cliente. Independentemente do cenrio considerado deve-se ter em mente que o BluePlant se constitui em um pacote nico de forma que o servidor sempre um BluePlant. No entanto, todos os mdulos do BluePlant como Alarme, Historiador, Dispositivo, Banco de Dados etc, podem estar em computadores diferentes sendo gerenciados pelo Servidor BluePlant gerando assim um sistema distribudo. Com base nessas premissas podemos ter as configuraes descritas a seguir.
Configuraes dos Sistemas

Sistema Standalone Esse sistema caracteriza-se por uma instalao do BluePlant executando o servidor e o cliente SCADA no mesmo computador.
Figura 7-1. Sistema Stand Alone
Sistema de Entradas e Sadas Distribudas Esse sistema caracteriza-se por uma mquina BluePlant servidora e mdulos de dispositivos rodando em computadores dedicados comunicao com o processo. Nesse caso o cliente SCADA pode estar no mesmo computador do servidor ou em outro computador. A Figura 7-2 ilustra essa configurao.
179
Figura 7-2. Sistema de Entradas e Sadas Distribudas Este modelo tambm til em plantas que contm dispositivos com porta serial ou comunicaes com capacidades limitadas. Colocando servidores de E/S no cho de fbrica de interface com esses dispositivos, possvel otimizar as comunicaes em redes lentas ou de baixa largura de banda melhorando o desempenho global. Apesar da distribuio geogrfica dos servidores de E/S em vrias plantas, este tipo de arquitetura pode ser configurada como um sistema de cluster nico, desde que este seja capaz de suportar vrios servidores de E/S. Sistema Cliente e Servidor Esse sistema contempla um servidor BluePlant onde os mdulos Alarme, Historiador, Banco de Dados esto sendo executados e os Clientes SCADA em outros computadores da rede LAN. A Figura 7-3 mostra esse sistema.
180
Figura 7-3. Sistema Cliente e Servidor A arquitetura cliente-servidor permite que os clientes possam ser distribudos em vrios computadores em uma LAN, criando um sistema que oferece benefcios de flexibilidade e desempenho. Este tipo de arquitetura tambm pode ser configurada como um sistema de cluster nico. Sistema de Servidor Redundante Neste caso temos dois computadores distintos executando os servidores BluePlant, onde a redundncia feita automaticamente pelo prprio supervisrio.. Desta forma necessrio apenas determinar os endereos IP das estaes primria e secundria. possvel termos as seguintes configuraes de redundncia: O banco de dados de Alarme e/ou Historiador sendo executado em uma terceira mquina dedicada a histricos, conforme a Figura 7-4. Banco de Dados Local nos servidores primrio e secundrio so utilizados para armazenar os histricos dos mdulos de Alarme e/ou Historiador, realizando o sincronismo de dados entre eles de forma automtica conforme Figura 7-5.
181
Figura 7-4. Sistema Servidor Redundante Terceira Mquina
Figura 7-5. Sistema Servidor Redundante Banco de Dados Local A possibilidade de definir os servidores primrio e secundrio dentro de um projeto permite a integrao do hardware de redundncia na infraestrutura do sistema. Isso ajuda a evitar situaes onde ocorrer um erro em um servidor no sistema global, tornando-o inoperante. Sistemas deste tipo so interessantes para garantir operao ininterrupta e confiabilidade na coleta de dados. Outra configurao possivel a redundncia nos dispositivos de comunicao, onde o(s) servidor(es) tem opces de comunicar com o dispositivo primrio ou com um dispositivo reserva. Essa redundncia habilitada configurando os endereos IPs dos dispositivos. O BluePlant fica responsvel por gerenciar a troca entre o dispositivo primrio e reserva quando houver algum falha na comunicao entre dispositivo e supervisrio.
182
Figura 7-6. Sistema Servidor Redundante com Redundncia nos Dispositivos
Sistema de Controle Neste caso podemos ter vrios servidores em plantas distintas (projetos diferentes) em uma arquitetura distribuda. Essa configurao permite que, em uma sala de controle, se possa acessar qualquer uma dessas plantas atravs de clientes especficos. importante mencionar que os clientes das plantas no estaro integrados em uma s mquina, de forma que necessrio especificar qual planta deseja-se visualizar. A Figura 7-7 ilustra esse sistema.
Figura 7-7. Sistema de Controle

183
7. Cenrios de Sistemas Tpicos Nesse cenrio, o sistema organizado em locais discretos controlados por operadores locais apoiados pelos servidores redundantes locais. Ao mesmo tempo, pode-se caracterizar um nvel de gesto em uma sala de controle central que monitora simultaneamente todos os sites. Cada site representado no projeto como um cluster separado, agrupando seus servidores primrio e standby. Sistema de Controle Distribudo e Distribuido Redundante Esse sistema contempla uma maquina BluePlant servidora e mdulos Alarme, Historiador, Banco de Dados e Clientes SCADA em outros computadores da rede LAN, de maneira que cada mdulo executado em um computador distinto. A Figura 7-8 mostra esse sistema.
Figura 7-8. Sistema de Controle Distribudo A arquitetura cliente-servidor permite que os mdulos sejam distribudos atravs de vrios computadores em uma LAN, criando um sistema que oferece benefcios de flexibilidade e desempenho. Cada componente identificado, no mbito do projeto, por um endereo, permitindo que sua localizao e requisitos de hardware possam ser considerados de forma independente. Este tipo de arquitetura tambm pode ser configurada como um sistema de cluster nico. O prximo cenrio trata-se de um sistema redundante, mas com seu par em localizao diferente. Esta configurao demanda uma rede com elevadas taxas de transmisso entre as localidades, visto que a quantidade de dados trocada entre os pares servidores expressiva. A Figura 7-9 mostra essa configurao.
Figura 7-9. Sistema de Controle Distribudo Redundante
184
7. Cenrios de Sistemas Tpicos Neste cenrio, o projeto contempla sites operados localmente cada um contendo seu prprio conjunto de servidores e clientes. No caso de algum site tornar-se inoperante, o monitoramento ininterrupto garantido distribuindo-se os servidores primrio e secundrio entre os diferentes sites, ou colocando-se os servidores como secundrio numa localizao central. Um cluster usado para definir o papel dos servidores em cada local, podendo ser visualizado em um projeto comum, sendo executado em cada cliente. Sistema de Compartilhamento de Carga similar ao sistema cliente e servidor mencionado anteriormente, mas com redundncia somente no mdulo de dispositivo. Esse sistema possibilita uma melhor utilizao da infraestrutura disponvel, visto que permite o compartilhamento da carga de trabalho entre diferentes computadores e UCPs. Esta abordagem pode ser usada para melhorar o desempenho da rede, os tempos de acesso de dados e a estabilidade geral do sistema. Alm disso, por meio de clusters possvel executar mltiplos servidores do mesmo tipo em um computador nico. Por outro lado, a distribuio dos servidores em dois clusters permite que os mesmos operem como unidades redundantes entre si reduzindo o nmero de computadores exigidos.
185
8. Glossrio
8. Glossrio
AppDomain Limite fornecido pelo CLR (Common Language Runtime) englobando os objetos criados a partir do mesmo escopo da aplicao. Os domnios da aplicao ajudam a isolar os objetos criados em uma aplicao de outros objetos criados em outras aplicaes. O TRuntime.exe executado em um AppDomain diferente (mdulo do dispositivo ou visualizador) dos outros mdulos. Termo relacionado ao Microsoft dotNet. Assembly Designer Device Module Domain, Server Domain, Client Domain "Assembly" refere-se a um arquivo executvel (.EXE) ou biblioteca (.DLL) criada com o uso de cdigo gerenciado e framework Microsoft .NET. Termo relacionado ao Microsoft dotNet. Componente de desenvolvimento do gerenciador do programa usado para projetar telas sinticas. Telas sinticas so representaes grficas de processos industriais gerados no ambiente de desenho. Mdulo que permite a implementao de protocolos de comunicao (Dispositivos) em mquinas remotas com o servidor no qual o projeto est sendo executado, mantendo o Runtime. Refere-se aos valores e localizao de objetos quando em execuo. "Objeto de domnio de servidor em execuo no servidor" significa o objeto em execuo no servidor. Valores associados a esse objeto abrangem todo o sistema. "Domnio do cliente" significa que o objeto est sendo executado na estao do cliente e cada mquina cliente pode apresentar valores diferentes. Caractersticas e programas que implementam funes do sistema interno que so executadas sem nenhuma configurao do usurio. Exemplos: tarefa de sincronizao de rede e gerador de relatrio de plano de fundo. Algumas ferramentas BluePlant, por exemplo, ModuleInformation.exe, podem exibir informaes de status destes mdulos internos. No entanto, estas informaes so exigidas somente para otimizaes de sistemas avanados. Exemplo: mdulo de sincronizao. Main Project File "Main Project File" refere-se base de dados SQL do BluePlant-codificado que contm a configurao do projeto. A extenso .TPROJ mostra o projeto atual em desenvolvimento. A extenso .TENG mostra os projetos Somente Leitura publicados. Parmetro auxiliar para marcar pontos de leitura e escrita em um dispositivo, tratamento de arrays, mscaras de bit, strings, swap e outras operaes nas quais a definio de Tipo de Dado no pode caracteriz-los completamente (parmetros adicionais so exigidos para definir o Tipo de Dado). Programa que acessa o banco de dados em tempo real (RtDB), podendo ser composto de um ou mais Assemblies. Exemplo: Manager.XBAP um mdulo de configurao de projeto que fornece ao usurio o acesso ao seu nome online atravs do URL do navegador. Espao de endereo. Todos os objetos criados com Namespace apresentam nomes exclusivos. O Namespace tambm pode ser entendido como uma configurao para criar hierarquia entre os objetos. Exemplo: todas as variveis de processo so agrupadas no Tag, namespace, todos os relatrios criados so agrupados no relatrio namespace. ObjectType (RunObj type) Objects, RunTime Objects Determina o tipo de objetos de Runtime. Por exemplo, um objeto pode apresentar os seguintes tipos de Runtime: display, report e ScriptFunction,Tela, Relatrio ou Funo Script. Objetos de Runtime so os objetos visveis (atravs dos seus nomes) acessados via scripts ou exibidos no projeto. Exemplos: tags, Relatrios, Telas e outros. Tambm deve ser usado pelos desenvolvedores de mdulo. Um mdulo de alarme, por exemplo, inicializar e atualizar os valores dos objetos de Runtime associados com os alarmes. ObjectValues, PropertyValue Objetos de Runtime (tags, Ns de dispositivos, etc.) podem ter uma ou mais propriedades definidas. O objeto TAG (e seu valor) apresenta propriedades, tais como: mnimo, mximo e descrio. Durante a configurao especfica do projeto so exigidos os itens "PropertyValue" ou "ObjectValue". Especifique o nome completo at o valor da propriedade final, isto , TAG.myTag.Min ou Tag.MyTag.Description. Para algumas configuraes como itens de alarme, historiador ou pontos do dispositivo especificando o OBJETO principal (Tag.MyTag neste exemplo), o sistema assumir, por padro, a propriedade de valor para executar a operao. ObjectWatch Parameters (TagConfiguration) Project projectDB or ProjectDatabase Property RunDB, Runtime Database Utilidade de diagnstico para verificar e modificar valores dos objetos quando em execuo. Definio dos parmetros de comportamento e valores dos tags de processamento. Exemplo: CounterUP para contadores, ou DeadBand smoothing tags para Inteiros. Conjunto de configuraes BluePlant, desenhos de telas, relatrios, documentos e notas do usurio criadas e editadas como uma entidade nica. ProjectDB (or ProjectDatabase) uma base de dados proprietria com informaes de configurao. Corresponde aos arquivos com extenso <projeto>.Tproj (por exemplo, Atual) ou <projeto> _ VERSION.Teng (tipo Release). Propriedade (valor) associado a um Tag ou a um objeto de Runtime. Base de dados de tempo real criada quando o projeto est em execuo. Todos os objetos de Runtime acessveis via script (tais como tags e relatrios) so gerados internamente com cdigo encapsulado e
Internal Module
Modifier (Device/Points) Module
Namespace
186
8. Glossrio
acessveis atravs da classe RunDB. O RunDB corresponde ao primeiro nvel da rvore de objetos de Runtime. Runtime Runtime Startup Projeto com mdulos de Runtime carregados e em execuo. Operao que permite a execuo de um projeto. Esta operao pode ser executada a partir do programa TStartup.exe na verso atual do BluePlant, ou a partir do TServer.exe na verso publicada do projeto. RuntimeDB RuntimeDB uma cpia do banco de dados do ProjectDB que contm informaes especficas sobre o RuntimeDB quando a verso do Runtime publicada. Corresponde aos arquivos com <projeto> _ <verso>.trun. Tag Tag type Varivel de processo. Nome de um Namespace que inclui todas as variveis criadas pelo usurio em uma configurao do projeto. Define o tipo de objetos no Tag do Namespace. Exemplo: Digital, Analgico e Texto. Esses tags representam uma classe de propriedades acessadas diretamente, tais como: Min, Max, valor, Qualidade. Cada propriedade criada internamente como ValueType. Task (Script.Task) Programa de tarefas escrito em VB.NET (ou C #) executado no servidor ou no cliente durante o Runtime do projeto. A execuo ser no servidor ou cliente dependendo da propriedade de domnio configurada no script. Programa que realiza a configurao do projeto. Inverte o valor de uma varivel. Valores maiores que zero so convertidos a zero; zero convertido ao valor "1". Partial Trust: Ambiente no qual uma aplicao tem acesso limitado aos recursos (acesso restrito a arquivos de pastas particulares, execuo de outras aplicaes, etc.). Aplicaes XBAP que so executadas com um navegador (Internet Explorer, por exemplo) devem utilizar o modo "Partial Trust". Full Trust: Ambiente no qual uma aplicao tem acesso a todos os recursos do sistema. Aplicaes instaladas em um computador geralmente so executadas no modo "Full Trust". Termo relacionado ao Microsoft dotNet. TWelcome Visibility (Tag Visibility) BluePlant inicial e tela de seleo do projeto. Refere-se ao sistema de Tag. Os tags podem ser pblicos, protegidos ou privados. Pblico: o valor do Tag durante a execuo est disponvel para acesso por programas externos via TCP/IP ou Servidor OPC. O valor do Tag necessariamente global ou compartilhado em todas as estaes cliente (Domnio do Servidor). Protegido: somente leitura. Privado: um Tag definido como "Privado" no pode ser acessado por aplicaes externas (Servidor OPC, TCP/IP) e ser executado em um Cliente ou em um Servidor, de acordo com a configurao da aplicao com as seguintes caractersticas: Tags usados somente em mdulos chamados pelo client e (tais como telas e Relatrios) e que so executados no escopo deste. Podem apresentar valores diferentes em cada mquina cliente (Domnio do Cliente); Tags usados em modulo servidores, tais como dispositivos e alarmes. Apresentam um nico valor no sistema (Domnio do Servidor). Xbap XAML browser application (XBAP) uma aplicao executada dentro de um browser (IE). Termo relacionado ao Microsoft dotNet.
TManager Toggle Partial Trust, Full Trust
187

Mu 224000

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Mu 224000

Cargado por

Copyright:

Formatos disponibles

Manual de Utilizao Srie BluePlant

Rev. A 12/2013 Cd. Doc.: MU224000

1. Suporte Tcnico BluePlant

1. Suporte Tcnico BluePlant

Figura 1-1. Altus BluePlant

Documentos Relacionados a este Manual

Mensagens de Advertncia Utilizadas neste Manual

BluePlant Lite (Pontos de comunicao) 150 300 500 1500 -

BluePlant Express (Pontos de comunicao) 75 -

BluePlant Student (Pontos de comunicao) 150 300 500 1500 -

Tabela 2-2. Quantidade de Pontos de Comunicao por Modelo de BluePlant

Solues para Integrador de Sistemas

Tabela 2-5. Acessrios para BluePlant Enterprise

3. Descrio Tcnica do BluePlant

3. Descrio Tcnica do BluePlant

Caractersticas Gerais dos Modelos BluePlant

3. Descrio Tcnica do BluePlant

Caractersticas Gerais Comuns

Caractersticas Inovadoras do Produto

Tabela 3-1. Banco de Dados em Tempo Real (Tags)

3. Descrio Tcnica do BluePlant

Tabela 3-2. Linguagens .NET e Scripts

Tabela 3-3. Alarmes e Segurana

3. Descrio Tcnica do BluePlant

Tabela 3-4. Tendncia e Historiadores

Tabela 3-5. Dispositivos e Redes

Tabela 3-6. Conjunto de Dados

Tabela 3-8. Ferramentas do Runtime e de Diagnstico

Tabela 3-9. Ferramentas de Implantao e Teste de Projeto

3. Descrio Tcnica do BluePlant

Tabela 3-10. Drivers de Comunicao

Processador Espao em disco Memria RAM Resoluo Idioma

Tabela 4-1. Configurao para at 4 Canais

Processador Espao em disco Memria RAM Resoluo Idioma

Tabela 4-2. Configurao para at 8 Canais

Processador Espao em disco Memria RAM Resoluo Idioma

Iniciando com o BluePlant

Figura 4-6. cone do BluePlant

Figura 4-7. Tela de Gerenciamento de Projeto

Figura 4-9. Guia Licenas

Primeiros Passos com o BluePlant

Figura 4-11. Interface do Usurio

Figura 4-12. Editando Tags do Projeto

Figura 4-13. Processo de Criao de Tags

Figura 4-14. Processo de Criao de Canal de Comunicao

Figura 4-17. Associao de Tags com Ns e Endereos de Protocolos

Figura 4-18. Seleo do Tag para Associar a um N

Esses passos esto referenciados na Figura 4-19 conforme a numerao correspondente.

Figura 4-21. Configurao do Tag Associado ao Smbolo

Figura 4-22. Incluso de um Texto

4. BluePlant 5. Confirmar a compilao A Figura 4-23 ilustra o processo de compilao do projeto.

Figura 4-25. Resultado da Compilao

Figura 4-29. Status da Inicializao do Projeto

Figura 4-31. Caminho da Publicao do Projeto

5. Menu Principal do BluePlant

5. Menu Principal do BluePlant

5. Menu Principal do BluePlant

5. Menu Principal do BluePlant

5. Menu Principal do BluePlant

Planejamento dos Alarmes

Projeto das Telas

Tabela 6-2. Tipos de Disponveis para Tags

Tabela 6-3. Exemplo de Formatos Numricos

6. Componentes do BluePlant Exemplo de formatos DateTime: