Manual Portugues ISW v6.1 SP2

InduSoft Web Studio v6.1 A-0

Guia do Usuário e

Manual de Referências

Técnicas

InduSoft Web Studio 6.1

www.iwsdobrasil.com.br

InduSoft Web Studio 6.1 sp2 IWS 20/06/2007 © Copyright IWS do Brasil Informática Ltda.

InduSoft Web Studio

Página 1

© IWS do Brasil Informática Ltda. E-mail: [email protected]

Copyright © 2007 IWS do Brasil Informática Ltda.

Todos os direitos reservados. Este documento é registrado e não pode ser reproduzido ou copiado de qualquer forma, sem que seja feita uma

solicitação por escrito IWS do Brasil Informática Ltda. Windows, Windows XP, Windows 2000, e Windows NT são marcas registradas da Microsoft Corporation nos

Estados Unidos da América e outros países. Todas as outras marcas ou nomes de produtos são registros ou marcas registradas de seus respectivos

fabricantes.


InduSoft Web Studio

Página 2

Conteúdo

Sobre essa Publicação ..........................................................................................................................11 A quem é Endereçada essa Publicação .......................................................................................12 Convenções ......................................................................................................................................12

Convenções de Texto ...............................................................................................................12 Mouse e Convenções de Seleção ............................................................................................13 Convenções do Windows .........................................................................................................13

Recursos Adicionais .......................................................................................................................15 Trabalhando com Suporte Técnico ..............................................................................................15

Capítulo 1: O que é o InduSoft Web Studio?....................................................................................19 Visão Geral do Produto ..................................................................................................................19 Recursos do Produto ......................................................................................................................20

Capítulo 2: Instalando o InduSoft Web Studio.................................................................................22 Antes de Começar...........................................................................................................................22 Instalando o IWS.............................................................................................................................24 Instalando o CEView ......................................................................................................................26 Desisntalando o InduSoft Web Studio e CEView.......................................................................28 Licenciando seu Produto ...............................................................................................................30

Versões do Produto ..................................................................................................................30 Licenças Inválidas ....................................................................................................................31

Modos de Execução ........................................................................................................................31 Tipos de Proteção............................................................................................................................33 Configurações da Licença..............................................................................................................34 Instalando Licenças de Hardkey para o InduSoft Web Studio ................................................35

Instalando uma Nova Licença ................................................................................................35 Atualizando a Licença de Hardkey Atual .............................................................................35

Instalando uma Licença de SoftKey para o InduSoft Web Studio ..........................................37 Instalando uma Nova Licença ................................................................................................37 Atualizando a Licença Atual...................................................................................................39

Instalando uma Licença de SoftKey para CEView ....................................................................42 Instalando ou Atualizando uma Licença (Localmente) ......................................................42 Instalando ou Atualizando uma Licença (Remotamente) ..................................................45

Capítulo 3: Trabalhando com o Ambiente de Desenvolvimento do IWS ......................................48 Navegando no Ambiente de Desenvolvimento............................................................................48

Utilizando a Barra de Título ...................................................................................................49 Utilizando a Barra de Menu ...................................................................................................50 Recursos do menu anexo........................................................................................................51 Reposicionando a barra de menu..........................................................................................52 Utilizando a Barra de Ferramentas .......................................................................................52 Posicionando um barra de ferramentas ...............................................................................52 Utilizando o Workspace...........................................................................................................53


InduSoft Web Studio

Página 3

Tab Database ............................................................................................................................55 Tab Graphics ............................................................................................................................56 Tab Tasks ..................................................................................................................................57 Tab Communications ..............................................................................................................58 Utilizando o Editor Tela/Planilha ..........................................................................................59

Utilizando o ícone Database Spy..................................................................................................69 Utilizando a Janela Output...........................................................................................................70

Utilizando o ícone Status Bar ................................................................................................71 Customizando o Workspace..........................................................................................................72 Interfaces Padrão ............................................................................................................................72

Virtual Keyboard ......................................................................................................................72 Fontes ........................................................................................................................................73 Interface Color ..........................................................................................................................75

Tarefas Comuns de Execução.......................................................................................................78 Accessando Projetos e Arquivos.............................................................................................79 Abrindo projetos .......................................................................................................................79 Abrindo arquivos ......................................................................................................................80 Fechando projetos....................................................................................................................80 Fechando arquivos...................................................................................................................80 Utilizando Botões Comuns .....................................................................................................80 Utilizando Select All .................................................................................................................82 Cortar, Copiar, Colar Objetos.................................................................................................82 Encontrando Informações do Sistema..................................................................................83 Pesquisando Tags - Utilizando a opção ícone Find.............................................................84 Utilizando a opção Go To ........................................................................................................84 Utilizando a Barra de Ferramentas Tag Properties ............................................................85 Utilizando o ícone Object Finder............................................................................................85 Utilizando a opção X-ref..........................................................................................................86 Utilizando a opção Global Tags Replace ...............................................................................86 Substituindo Tags ....................................................................................................................87 Testando Exibições ..................................................................................................................89 Verificando a Aplicação ...........................................................................................................89 Rodando Aplicações .................................................................................................................90 Restaurando Padrões...............................................................................................................90 Salvando seu Trabalho............................................................................................................90 Imprimindo Telas do Projeto ..................................................................................................91

Dicas e Truques ..............................................................................................................................93 Configurando o Foco na Janela Object Properties no Editor de Tela ..............................93

Importando um Banco de Dados .................................................................................................93 passo 1: Selecionar o tipo de origem.....................................................................................94 passo 2: Configurar os parâmetros do tipo de origem .......................................................95 passo 3: Filtrar os tags............................................................................................................96


InduSoft Web Studio

Página 4

Importando a partir de outros Banco de Dados do InduSoft Web Studio ......................97 Importando a partir de OPC Server Databases .................................................................101 Importando a partir de CSV Databases..............................................................................102 Importando a partir de ODBC Databases ..........................................................................103 Importando a partir de RSLogix™ 5000 CSV Databases ................................................104 Importando a partir de the PanelMate™ Database Wizard .............................................105 Importando a partir de OMRON CX Programmer Databases .........................................106 Importando a partir de TwinCAT PLC Databases .............................................................108

Módulos de Desenvolvimento .....................................................................................................108 Gráficos....................................................................................................................................108 Tarefas .....................................................................................................................................109

Comunicações Gerais...................................................................................................................110 Capítulo 4: Compreendendo a Estrutura do IWS ..........................................................................111

Compreendendo a Estrutura Interna e o Fluxo de Dados .....................................................111 Executando/Mudando Módulos do IWS ...................................................................................113 Executando/Alternando o Background Task...........................................................................118

Capítulo 5: Trabalhando com Tags ..................................................................................................121 O que é um Tag? ...........................................................................................................................121 Projetando um Tag .......................................................................................................................122

Escolhendo o Tipo de Tag .....................................................................................................122 Tags básicos ............................................................................................................................122 Tags de Array ..........................................................................................................................123 Tags Class ...............................................................................................................................124 Tags Indiretos .........................................................................................................................125 Escolhendo Tipo de Dados do Tag.......................................................................................125 Compartilhando Tags com um Web Thin Client ...............................................................125 Escolhendo Propriedades de Tag .........................................................................................126

Criando Tag database da Aplicação...........................................................................................129 Adicionando Tags para a Planilha da Aplicação ...............................................................130 Adicionando Tags “On-the-Fly”............................................................................................131 Reiniciando o Tags database ................................................................................................132

Criando Classes ............................................................................................................................132 Configurando Propriedades de Tag............................................................................................134

Configurando os Parâmetros de Propriedades do Tag .....................................................136 Configurando os Alarmes – Tab de Propriedades de Alarmes ........................................137 Configurando Propriedades do Histórico............................................................................139

Utilizando Tags em Sua Aplicação .............................................................................................140 Editando Tags ...............................................................................................................................140

Do Datasheet de Tags da Aplicação ....................................................................................141 Da pasta Tag List ...................................................................................................................141

Deletando Tags..............................................................................................................................142


InduSoft Web Studio

Página 5

Capítulo 6: Criando e Configurando um Projeto............................................................................143 Criando Aplicação para um Novo Projeto .................................................................................143

Especificando a Resolução Padrão de uma Tela ...............................................................146 Compartilhando Tags de Banco de Dados do Programa de Controle Baseado em PC147

Especificando Configurações de Projeto Adicionais ................................................................149 Provendo informações de Identificação do Projeto............................................................150 Configurando as Parâmetros do Tab Options ...................................................................150 Habilitando Tradução de Linguagem ..................................................................................153 Especificando o nível de licença para Target System .......................................................154 Salvando arquivos históricos de alarme.............................................................................155 Compartilhando tags com aplicação de controle baseada em pc...................................155 Communicação com Drivers e OPC (Buffer) ......................................................................155 Especificando um porta TCP ................................................................................................155 Configurando configurações do banco de dados para salvar históricos de

Alarme/evento..................................................................................................................156 Janela do Diálogo Database Configuration........................................................................156 Configurando um Banco de Dados Padrão para Todos os Históricos de Tarefas........160 Configurando os Parâmetros da Área de Trabalho de Runtime .....................................161 Configurando os Parâmetros de Comunicação .................................................................165 Configurando Seu Projeto para Acesso Remoto a Web ....................................................166 Especificando Parâmetros Web Thin Client.......................................................................169 Habilitando Mensagens de Aviso .........................................................................................172

Iniciando Módulos de Runtime no Target system ...................................................................174 Capítulo 7: Configurando Telas e Gráficos .....................................................................................178

Trabalhando em um Ambiente Orientado pelo Objeto ...........................................................178 Trabalhando com Atributos de Tela ..........................................................................................179 Especificando Cores de Background .........................................................................................184 Utilizando Objetos e Dinâmicas .................................................................................................185

Utilizando a Barra de Ferramentas Mode ..........................................................................185 Utilizando a Barra de Ferramentas Align e Distribute.....................................................187 botões Object Alignment .......................................................................................................188 botões Changing Object Layers ...........................................................................................191

Botões Object Grouping e Ungrouping .....................................................................................192 Utilizando Grupos de Telas .........................................................................................................193

Utilizando a Barra de Ferramentas da Web.......................................................................194 Salvando Telas em Formato HTML ............................................................................................194

Utilizando a Barra de Ferramentas Bitmap .......................................................................197 Utilizando a barra de ferramentas Static Objects.............................................................198 Utilizando a Barra de Ferramentas Dynamic Properties .................................................204 Utilizando a Barra de Ferramentas Active Objects...........................................................214

Utilizando a Biblioteca .................................................................................................................289 Utilizando Paste Link.............................................................................................................290


InduSoft Web Studio

Página 6

Pasta Symbols ........................................................................................................................290 Capítulo 8: Configurando Planilhas de Tarefas .............................................................................291

Configurando uma Tarefa de Alarme ........................................................................................292 Configurando uma Tarefa Trend ................................................................................................302

Convertendo Arquivos Históricos de Trend de Binário para Texto ................................310 Convertendo Arquivos Históricos Trend de Texto para Binário......................................311 Criando Históricos Batch......................................................................................................311

Configurando Tarefas Recipes ....................................................................................................312 Configurando a Tarefa Reports ..................................................................................................314 Configurando uma tarefa ODBC ................................................................................................316 Configurando uma Tarefa Math .................................................................................................319 Configurando uma Tarefa Scheduler ........................................................................................320

Capítulo 9: Configurações de Evento...............................................................................................322 Configurando Parâmetros de Eventos......................................................................................323

Capítulo 10: Comunicação ................................................................................................................327 Configurando um Driver..............................................................................................................327

Configurando Planilhas de Driver .......................................................................................335 Executando o Driver ..............................................................................................................344

Configurando OPC........................................................................................................................344 Configurando um OPC Client...............................................................................................345 Resolvendo Problemas de OPC ............................................................................................347 Configurando um OPC Server..............................................................................................348

Configurando TCP/IP...................................................................................................................348 Configurando Client .............................................................................................................349 Configurando Parâmetros Customizados...........................................................................349 Configurando TCP/IP Server ................................................................................................350

Configurando DDE .......................................................................................................................350 Configurando DDE Client .....................................................................................................350 Configurando DDE Server ....................................................................................................351

Capítulo 11: Configurando um Sistema de Segurança.................................................................353 Inserindo uma Senha ............................................................................................................353

Definindo Grupos .........................................................................................................................354 Definindo Usuários.......................................................................................................................358

Sistema de Segurança Remoto ............................................................................................366 Configurando o Nível de Acesso de Segurança..................................................................367

Definindo Usuários.......................................................................................................................368 Especificando Usuários Guest .............................................................................................368

Logging On/Off .............................................................................................................................369 Capítulo 12: Testando e Corrigindo Erros em Sua Aplicação......................................................370

Testando sua Aplicação ...............................................................................................................370 Corrigindo Erros da Aplicação a partir do Database Spy ......................................................371 Corrigindo Erros da Aplicação a partir da Janela Output .....................................................372


InduSoft Web Studio

Página 7

Utilizando o Módulo LogWin (NT e CE) .....................................................................................374 Utilizando Ferramentas Remotas...............................................................................................376

Utilizando Database Spy Remoto ........................................................................................377 Utilizando LogWin Remoto....................................................................................................377

Capítulo 13: Configurando uma Web Solution ..............................................................................378 Antes de Começar.........................................................................................................................380

Definindo um Diretório Home ..............................................................................................380 Instalando e Registrando ISSymbol.ocx .............................................................................380 Rodando o Web Server ..........................................................................................................381 Rodando O TCP/IP Server ....................................................................................................383

Testando a Aplicação ...................................................................................................................387 Capítulo 14: Gerenciando Aplicações Remotamente.....................................................................390

Fazendo o Download da Aplicação.............................................................................................390 Configurando a Target station .............................................................................................390 Configurando a Estação de Desenvolvimento ...................................................................391

Monitorando/Gerenciando Aplicações a partir de uma Estação Remota ...........................395 Capítulo 15: Linguagens de Script: IWS e VBScript .....................................................................396

Trabalhando com com Linguagem de Script do IWS, Expressões e Funções.....................396 Utilizando Tags..............................................................................................................................396 Especificando Tipos de Dados ....................................................................................................396

Acessando Tag database .......................................................................................................397 Operações Aritiméticas..........................................................................................................397 Operações Lógicas..................................................................................................................398

Utilizando Funções .......................................................................................................................398 Visão Geral do VBScript ..............................................................................................................400 VBScript no IWS ...........................................................................................................................400

Global Procedures ..................................................................................................................402 Graphic Module - Graphics Script ......................................................................................403 Graphic Module - Screen Script ..........................................................................................405 Graphic Module – Dinâmica Command .............................................................................406 Graphic Module - ActiveX Events........................................................................................407 Tarefa Background - Startup Script ...................................................................................410 Tarefa Background – Grupos Script....................................................................................411

Referência de Linguagem ............................................................................................................413 Constantes ..............................................................................................................................413 Erros.........................................................................................................................................417 Funções ...................................................................................................................................420 Palavras-Chave .......................................................................................................................421 Métodos....................................................................................................................................421 Objetos e Coleções .................................................................................................................421 Operadores ..............................................................................................................................423 Propriedades ...........................................................................................................................424


InduSoft Web Studio

Página 8

Demonstrações .......................................................................................................................425 Dicas e Truques ............................................................................................................................427

VBScript Editor - IntelliSense ..............................................................................................427 VBScript comparado a VBA..................................................................................................429 Eventos de Tela.......................................................................................................................430 Funções MsgBox() e InputBox() ...........................................................................................431 Suporte para objetos ActiveX ...............................................................................................431 Logical Operator NOT ............................................................................................................431 Verdadeiro e Falso..................................................................................................................432 Suporte Windows CE.............................................................................................................433 Escopo e Tempo de Vida de Variáveis.................................................................................433 Declarando Variáveis.............................................................................................................433 Criando Constantes ...............................................................................................................434 Precedência de Operadores VBScript .................................................................................434 Utilizando Demonstrações Condicionais ............................................................................435 Executando em Loop Através do Código ............................................................................437 Procedimentos em VBScript .................................................................................................440

Capítulo 16: Utilizando a Ferramenta/Editor de Tradução .........................................................442 Configurações do Projeto para Tradução Automática ............................................................443

Configurando Object Properties para Objetos de Tela .....................................................444 Translation Editor ........................................................................................................................445

Editando Planilhas.................................................................................................................446 Salvando suas planilhas..............................................................................................................448 Executando as Funções de Tradução........................................................................................448

Utilizando SetTranslationFile(“strFileName”).....................................................................449 Utilizando Ext(“strText”)........................................................................................................451

Fechando o Translation Editor ...................................................................................................451 Capítulo 17: Interface Banco de Dados do IWS .............................................................................452

Conceitos Gerais ...........................................................................................................................453 Banco de Dados Relacionais SQL........................................................................................453 Formato Histórico ..................................................................................................................455 Bancos de Dados Primários e Secundários .......................................................................456 Banco de Dados Padrão ........................................................................................................457 Estabelecendo Link do Banco de Dados através de um DB Provider Remoto .............458

Configurando Parâmetros dos Bancos de Dados ....................................................................459 Diálogo Database Configuration ..........................................................................................460

Studio Database Gateway ...........................................................................................................463 Resolvendo Problemas do Banco de Dados ..............................................................................474

Database FAQ .........................................................................................................................474 Apêndice do Banco de Dados A: Utilizando Banco de Dados ODBC ...................................478 Apêndice do Banco de Dados B: Utilizando Microsoft SQL Server.......................................479 Apêndice do Banco de Dados C: Utilizando Banco de Dados ORACLE ...............................481


InduSoft Web Studio

Página 9

Apêndice do Banco de Dados D: Utilizando Banco de Dados de Acesso da Microsoft......483 Apêndice do Banco de Dados E: Utilizando SQL Server CE ..................................................484 Apêndice do Banco de Dados F: Utilizando Sybase ................................................................485 Apêndice do Banco de Dados G: Utilizando Microsoft Excel .................................................485 Apêndice do Banco de Dados H: Utilizando MySQL ...............................................................489

Capítulo 18: Web Solution.................................................................................................................491 Camada de Controle ISSymbol...................................................................................................492 Como Funciona .............................................................................................................................493 Configurando uma Aplicação Baseada na Web .......................................................................494 Arquiteturas Típicas.....................................................................................................................495

Arquitetura 1: Web server e Web Thin Clients em uma mesma rede de trabalho ......495 Arquitetura 2: Web server e Web Thin Client sem uma mesma rede de trabalho; web

server e data server em estações diferentes ................................................................497 Arquitetura 3: Servidores Redundantes e Web Thin Client stations na mesma rede de

trabalho .............................................................................................................................499 Arquitetura 4: Web server e Web Thin Clients em redes de trabalhos diferentes .......501

Capítulo 19: Correção de Problemas................................................................................................504 Antes de entrar em contato com o Suporte Técnico ...............................................................504 Verificando sua Aplicação ...........................................................................................................505 Erros Comuns ...............................................................................................................................506

Banco de Dados & Sistema de Segurança .........................................................................506 Gráficos....................................................................................................................................507 Tarefas .....................................................................................................................................508 Comunicação ..........................................................................................................................509 Resolução de Erros Gerais....................................................................................................510

Apêndice A. Funções do InduSoft Web Studio ...............................................................................516 Protótipos e Descrições de Funções...........................................................................................527 Funções Log Message...................................................................................................................528 Funções Aritiméticas....................................................................................................................529 Funções Estatísticas ....................................................................................................................542 Funções Logarítimicas .................................................................................................................546 Funções Lógicas............................................................................................................................548 Funções String ..............................................................................................................................551 Funções Data e Hora....................................................................................................................569 Funções Trigonométricas ............................................................................................................575 Abrindo e Fechando Janelas.......................................................................................................580 Funções de Segurança.................................................................................................................583 Funções do Módulo Atividade.....................................................................................................590 Funções de Arquivo ......................................................................................................................613 Funções Gráficas ..........................................................................................................................631 Funções de Tradução ...................................................................................................................635 Funções Multimídia......................................................................................................................637


InduSoft Web Studio

Página 10

Funções Informações do Sistema...............................................................................................638 Função Loop ..................................................................................................................................660 Função Database Access .............................................................................................................661 Funções ODBC..............................................................................................................................662 Funções Mail .................................................................................................................................683 Funções Dial-Up ...........................................................................................................................689 Funções ActiveX............................................................................................................................711 Event Logger Funções ..................................................................................................................714 Funções FTP ..................................................................................................................................716 Funções do Banco de Dados.......................................................................................................721


InduSoft Web Studio

Página 11

Sobre essa Publicação Esse Guia do Usuário e Referências Técnicas foi projetado para ajudá-lo a obter os melhores resultados, a partir da utilização de seu software InduSoft® Web Studio. Essa publicação prove informações e instruções técnicas passo a passo, para todas as tarefas que necessitem criar Aplicações HMI/SCADA habilitadas para Web.

As informações nessa publicação é organizada em capítulos, da seguinte forma:

• Esse Capítulo: Descreve o propósito, conteúdo e organização do Guia do Usuário e Referências Técnicas do IWS. Além disso, esse Capítulo contém as seguintes informações:

o Explica como formatar e utilizar o mouse e as convenções do Windows

o Cita outras publicações, as quais fornecem informações sobre o InduSoft Web Studio

o Explica como entrar em contato com os representantes do suporte técnico da InduSoft

• Capítulo 1. Sobre o InduSoft Web Studio Fornece uma visão geral de alto nível sobre a utilização do produto, assim como seus recursos e Funções.

• Capítulo 2. Instalando o InduSoft Web Studio: Fornece instruções passo a passo para instalação, licenciamento, inicialização e desinstalação tanto do InduSoft Web Studio quanto do CEView.

• Capítulo 3. Trabalhando com o Ambiente de Desenvolvimento do IWS: Descreve a interface do InduSoft Web Studio (ou ambiente de desenvolvimento), além de explicar algumas habilidades técnicas básicas que devem ser compreendidas, antes da criação de uma nova Aplicação.

• Capítulo 4. Compreendendo a Estrutura do IWS: Descreve a estrutura interna do InduSoft Web Studio, incluindo como ocorre o fluxo de dados através dos módulos de runtime, além de prover informações sobre como esses módulos são executados.

• Capítulo 5. Trabalhando com Tags: Explica coiceitos básicos sobre o banco de dados do produto, os tipos de tags (arrays, classes e pointers), valores e parâmetros de tags. Seguindo os conceitos da discussão, esse Capítulo fornece instruções para criar e editar tags para suas Aplicações.

• Capítulo 6. Criando e Configurando um Projeto: Fornece funções passo a passo para criar e configurar um novo projeto na Aplicação.

• Capítulo 7. Configurando Telas e Gráficos: Explica como utilizar as diferentes ferramentas de desenvolvimento do InduSoft Web Studio para a criação das telas e dos gráficos de sua aplicação.

• Capítulo 8. Configurando Planilhas de Tarefa: Explica como criar e configurar as diferentes planilhas de tarefas no InduSoft Web Studio para as Aplicações de seus projetos.

• Capítulo 9. Configurações de Evento. Descreve o logging e os recursos de entrega de eventos.

• Capítulo 10. Comunicação: Desscreve como configurar o InduSoft Web Studio para ler e escrever as variáveis de tags de sua aplicação, para ou a partir da memória do equipamento. As informações incluem instruções para configuração de drivers de comunicação OPC, TCP/IP, e DDE (troca de dados dinâmicos).

• Capítulo 11. Configurando um Sistema de Segurança: Explica como configurar e gerenciar um sistema de segurança para suas Aplicações.

• Capítulo 12. Testando e Corrigindo Erros de sua Aplicação: Discute como testar e corrigir erros de suas Aplicações utilizando ferramentas como Database spy e output window. Esse Capítulo inclui uma lista de possíveis mensagens de erro, além de métodos para corrigir tais erros..

• Capítulo 13. Configurando a Web Solution: Explica como configurar e rodar sua Aplicação na Web.

• Capítulo 14. Gerenciando Aplicaçãos Remotamente: Explica como fazer download, monitorar e corrigir erros das Aplicações, a partir de estação de trabalho de runtime remota.


InduSoft Web Studio

Página 12

• Capítulo 15. Trabalhando com a Linguagem de Script do IWS, Expressões e suas Funções: Descreve a sintaxe da linguagem de script do InduSoft Web Studio, que inclue mais de 200 Funções.

• Capítulo 16. Utilizando O Editor de Tradução: Explica como utilizar o Editor de Tradução para traduzir o texto em suas Aplicações, de uma língua para alguma outra.

• Capítulo 17. Interface do Banco de Dados do IWS: Explica como conectar o InduSoft Web Studio a banco de dados compatíveis.

• Capítulo 18. Solução da Web: Explica como utilizar o Web Thin Client para visualizar a interface gráfica em uma estação remota.

• Capítulo 19. Resolvendo Problemas: Fornece instruções para verificação de Aplicações, descreve alguns erros de desenvolvimento comuns e explica o que fazer caso seja necessário entrar em contato com um representante da equipe de suporte.

• Apêndice As. Funções do Studio: Contém tabelas e informações, as quais descrevem as diferentes funções disponíveis tanto no InduSoft Web Studio como no CEView.

A quem é Endereçada essa Publicação

Esse Guia do Usuário e Manual de Referências Técnicas é um documento destinado a ser de fácil compreensão, fornecendo informações úteis tanto para novatos quanto para usuários experientes do InduSoft Web Studio.

• Novos Usuários: Essa publicação utiliza procedimentos passoa a passo para o processo de desenvolvimento da Aplicação. Certifique-se de que os capítulos de introdução tenham sido lido e compreendidos, os quais descrevem os recursos do produto e seu ambiente de desenvolvimento.

• Usuários Experientes: Essa publicação oferece instruções avançadas, dicas e informações sobre correção de erros para ajudar na obtenção de resultados satisfatórios nas Aplicações construídas no seu produto.

Nota: Nós assumimos que você esteja familiarizado com o ambiente de trabalho do Windows. Caso você desconheça alguma de suas funções de procedimento, recomendamos a utilização do recurso Help (Start → Help) ou consultar a documentação de seu Microsoft Windows.

Convenções

Essa seção descreve o texto, mouse e as convenções do Windows utilizadas em todas as publicações da InduSoft.

Convenções de Texto

As seguintes convenções de texto e técnicas de formatação são utilizadas nessa publicação para auxílio na identificação rápida de certos tipos de informações:

• Nome de arquivos e texto tela/mensagem são indicados com a utilização do texto bold, monospace (por exemplo: \DRunStartup.exe).


InduSoft Web Studio

Página 13

Quando informações são solicitadas, tais como um nome de arquivo, uma entrada é indicada entre brackets < > e indicam a utilização do texto em bold, italic monospace (por exemplo, <Project folder>\Redist\CEView\<Processor Type>\).

Neste exemplo, você deve digitar o nome da pasta do projeto e o tipo do processador para completar a entrada.

• Botões, opções de menu e teclas do teclado estão indicados para a utilização de uma typeface narrow bold (por exemplo, “Aperte a tecla Enter.”)

• O texto que requer ênfase especial (como advertencias, novos termos, ou nomes do produto) é indicado pela utilização de itálicos para chamar sua atenção para aquele item (por exemplo, “Do not save the file.”)

• Além disso, essa publicação separa alguns textos em boxes Tip, Note, e Caution para auxilixar na identificação rápida e fácil de informações. o Tips ( ) fornece informações úteis para salvar o período de desenvolvimento ou para

melhorar a performace da aplicação.

o Notes ( ) fornece informações relacionadas ao texto ao redor (geralmente o parágrafo que precede a nota) para auxiliar na obtenção de maiores informações para a compreensão de um conceito ou para o fornecimento de informações adicionais.

o Cautions ( ) fornece informações necessarias para a prevenção de erros que podem causar problemas quando a aplicação estiver rodando, podendo resultar em danos para a aplicação.

Mouse e Convenções de Seleção

Em razão de a minoria dos PCs utilizados para o desenvolvimento da aplicação rodarem uma versão do Windows que requer a utilização de um mouse, essa publicação partirá do princípio de que o usuário esteja utilizando um mouse. Geralmente, o mouse do PC é configurado de forma tal que o botão esquerdo do mouse é o botão principal, sendo o botão da direita para uso secundário.

Essa publicação utiliza as seguintes convenções de seleção e mouse:

• Double-click significa clicar duas vezes em um objeto com o botão esquerdo do mouse. • Right-click significa clicar uma vez no objeto com o botão direito do mouse. • Click e Select significa clicar uma vez no objeto com o botão esquerdo.

Em geral, você deve clicar nos botões e selecionar a partir das listas. • Select também significa que você deve utilizar seu equipamento para evidenciar ou especificar

um item na tela do computador. Selecionar um objeto com um toque na tela usualmente é igual a selecionar o objeto com o mouse, exceto ao tocar (selecionar) um objeto de tela ou seção. Para selecionar objetos com seu teclado, deve-se utilizar tipicamente a tecla Tab para circular pelas opções, a tecla Enter para abrir menus e a tecla Alt juntamente a uma letra para selecionar um objeto que tenha uma linha sublinhada.

• Drag significa apertar o botão apropriado do mouse e movê-lo antes de soltar o botão. Geralmente uma sombra do objeto move-se juntamente ao cursos do mouse.

• Para instruções sobre como selecionar múltiplas barras de menu e/ou opções de menu, utilize as setas para ilustrar a seqüência de seleção. Por exemplo, caso você vizualize . . . Selecione Start → Programs → InduSoft Web Studio → Register para registrar seu produto.

. . . você deve clicar no botão Start do Windows, selecionar a opção Programs selecionar a opção InduSoft Web Studio e a opção Register.

Convenções do Windows

Essa publicação utiliza as seguintes convenções do Windows:

• Dialog boxes (ou diálogos) são janelas que permitem inserir informações.

• Text boxes (ou campos) são áreas em um diálogo, onde você pode alterar o texto.


InduSoft Web Studio

Página 14

• Radio buttons são círculos brancos nos quais o ponto em preto aparece ou desaparece, quando clica-se no botão. O ponto indica que a opção ou função está enabled (ativada). O círculo em branco indica que a opção/função está disabled (inativada).

• Check-boxes são quadrados brancos nos quais um visto de verificação ( ) aparece ou desaperece ao serem selecionados. O visto de verificação indica que a opção ou função está enabled (ativada) e quadrado em branco indica opção/função disabled (inativada).

• Buttons são boxes contendo texto ou gráficos que executam uma ação juntamente ao programa. Os botões aparecem como “pressionados” quando clicados.

Tipo do Botão Descrição

Clique para executar uma ação.

Por exemplo, clque em Save para salvar seu projeto ou clique em Cancel para cancelar a operação em andamento.

Clique em um botão contendo texto com reticências (...) para abrir o diálogo a ele relacionado.

Por exemplo, clique no botão Options para abrir o diálogo Options.

Clique para executar uma ação.

Por exemplo, clique no botão Open Library para abrir o diálogo Symbol Library.

Alguns botões estão duplicados, o que significa que clicar o botão é um recurso, modo ou exibição on/off particular.

Por exemplo, clique no botão Output Window para alterar entre on/off na output window (LogWin), na janela do ambiente de desenvolvimento.

Tabela de Exemplos de Botões

• Lists são painéis (boxes brancas ) em janelas ou diálogos contendo duas ou mais opções selecionáveis.

• Combo-Boxes são setas que, ao serem selecionadas, mostram parte ou toda uma lista escondida de outra forma.

• Interface refere-se a toda a janela do InduSoft Web Studio (ambiente de desenvolvimento).

• Dockable windows são janelas que podem se mover para uma interface, e juntar-se a ela.

• Toolbars são janelas dockable que contêm somente botões e caixas de texto.


InduSoft Web Studio

Página 15

Recursos Adicionais Para maiores informações sobre o InduSoft Web Studio, estão disponíveis os seguintes recursos:

Recurso Descrição

Publicações Relacionadas

• Guia Inicial do InduSoft Web Studio: Projetado para usuários novatos, essa publicação contém informações sobre as Funções básicas do InduSoft Web Studio. Essa publicação é fornecida na pasta de Documentação, no CD-ROM do IWS ou no menu Help localizado na barra de menu principal.

• Guias do Usuário de Drivers Individuais: Explica como configurar drivers individuais InduSoft, de acordo com suas características únicas de protocolo. Um guia do usuário costumizado está incluído em cada driver InduSoft. Essas publicações são fornecidas no subdiretório DRV da pasta do InduSoft Web Studio, no CD-ROM do IWS ou no menu Help localizado na barra de menu principal.

• Perguntas Freqüêntes Sobre o InduSoft Web Studio (FAQ): Lista a maioria das perguntas geralmente questionadas, com respostas sobre o InduSoft Web Studio.

Site da InduSoft Visite o site www.InduSoft.com para mais informações sobre os produtos InduSoft, downloads e demos disponíveis, FAQ do produto, informações de driver, oportunidades de treinamento, distribuidores, além das últimas novidades da InduSoft.

Tabela de Informações sobre Recursos

Trabalhando com Suporte Técnico Os engenheiros especializados em suporte da InduSoft estão empenhados em resolver quaisquer dúvidas e questões a respeito dos produtos rápida e acuradamente. Nossos centros de suporte técnico localizam-se em Austin, Texas e São Paulo, Brasil.

Suporte Contato

Austin, Texas Telefone: 877-INDUSOFT (877-463-8763)

Fax: 512-349-0375

Email: [email protected]

São Paulo, Brasil Telefone: +55 11 3849-2000

Fax: +55 11 3849-2000 ext. 26

Email: [email protected]

Nossas opções de suporte técnico incluem:

• Suporte Eletrônico

• Suporte via telefone

• Atualização das versões do Produto


InduSoft Web Studio

Página 16

• Acesso à página da IWS para suporte técnico (http://www.iwsdobrasil.com.br) • Sistema FaxBack

Ao requisitar suporte técnico, por favor tenha as seguintes informações em mãos:

Nome do Contratante

Informações para Contato

Método de contato de preferência

E-mail Telefone Celular Outro

Setor Industrial (Por exemplo Automotivo, Farmacêutico, Fabricante):

Número de estações supervisionadas:

Uma Duas Três Outras

Campo do Equipamento (Por exemplo, Allen Bradley Data Highway Plus):

Fabricante:

Modelo:

Quantidade:

Protocolo:

Driver(s) da InduSoft:

Ambiente do Computador:

Tópico Sub-Item Características

Hardware Hardware 32-bit Workstation

Vendedor

Número do Modelo

Procesador

Relógio

Memória RAM

Outras informações com as quais nossos engenheiros podem colaborar sobre o hardware:


InduSoft Web Studio

Página 17

Ambiente do Computador (cont.):


Software Hardware do Sistema Operacional

Tipo

Versão

Pacote de Serviços

Linguagem

Outras informações com as quais nossos engenheiros podem colaborar sobre o software:


Software Microsoft Internet Explorer Hardware

Software

Versão

Pacote de Serviços

Linguagem

Outras informações com as quais nossos engenheiros podem colaborar sobre a instalação do Microsoft Internet Explorer:


Software InduSoft Hardware

Software

Versão

Pacote de Serviços

Outras informações com as quais nossos engenheiros podem colaborar sobre a instalação do Indusoft:


InduSoft Web Studio

Página 18

Ambiente do Computador (cont.):


Software CEView Hardware

Software

Versão

Pacote de Serviços

Outras informações com as quais nossos engenheiros podem colaborar sobre a instalação do CEView:

Descrição do Problema:

Formulário de Informações sobre o Cliente


InduSoft Web Studio

Página 19

Capítulo 1: O que é o InduSoft Web Studio?

O InduSoft Web Studio (IWS) é um programa de software poderoso, completo e integrado, o qual permite o desenvolvimento e construções com recursos ricos de IHMs (Interfaces Homem-Máquina (Human-Machine Interface) ou Aplicações em SCADA (Controle Supervisório e Aquisição de Dados) para:

• Aquisição de dados

• Estações de Supervisão Locais

• Estações de Supervisão Remotas

• Concentradores de Dados em processos distribuídos

• Comunicação de dados com sistemas da corporação

Visão Geral do Produto As aplicações IWS rodam em microcomputadores conectados em tempo real com máquinas ou processadores através de controladores programáveis, equipamentos remotos de I/O e outros equipamentos para aquisição de dados.

Essas aplicações consistem em telas de interface operadoras, drivers de PLC configurável (controlador lógico programável). Além de outros equipamentos I/O controláveis, contém um banco de dados de tags da aplicação e módulos opcionais, como monitores de alarme, lógica, trend charts, recipes, schedulers, e um sistema de segurança. A interface da Aplicação do IWS com sistemas I/O industriais e outras aplicações em modo runtime utilizam os seguintes protocolos:

• ODBC (Open Database Connectivity)

• DDE (Dynamic Data Exchange)

• NetDDE (Network Dynamic Data Exchange)

• OPC (Open Connectivity)

• TCP/IP (Transmission Control Protocol/Internet Protocol)

Após o desenvolvimento de uma aplicação, pode-se rodá-la em sua estação de trabalho de desenvolvimento ou fazer um download da aplicação para uma estação de trabalho em runtime (utilizando uma conexão TCP/IP ou em série) e assim rodá-la com a utilização dos softwares InduSoft Web Studio ou CEView. A estação de trabalho processa dados escaneados dos equipamentos conectados, de acordo com parâmetros definidos na Aplicação, os quais processam, exibem, armazenam e atualizam dados.

O InduSoft Web Studio consiste de:

• Software para Sistema de Desenvolvimento que roda em uma área de trabalho, laptop ou PC industrial que rode Windows® NT/2000/XP

• Software de Sistema de Runtime que roda em uma estação de trabalho de interface operadora rodando Windows NT/2000/XP ou Windows CE

Nota: O software do sistema de runtime (CEView) para o sistema operacional Windows CE é geralmente pré-carregado em uma IHM. Caso necessário, você pode atualizar a versão do CEView do software do sistema de desenvolvimento, fazendo o download da versão atual para a IHM.


InduSoft Web Studio

Página 20

Recursos do Produto O InduSoft Web Studio fornece os seguintes recursos:

• Ambiente de Desenvolvimento integrado, com barra de ferramentas, diálogos e menus;

o Menus de atalho, os quais podem ser acessados dando um clique com o botão direito do mouse em qualquer area do ambiente de desenvolvimento (As opções variam de acordo com o contexto)

o Barra de ferramentas customizáveis e flutuantes

o Tarefas, objetos e controles organizados em um explorador tree-view

• Objetos com muito recursos e dinâmicos (habilidade para modificar propriedades do objeto, executar comandos ou inserir valores para tags utilizados na construção de telas em runtime):

o Objetos configuráveis, como botões, retângulos, elipses, polígonos, linhas e texto

o Propriedades Dinâmicas, como gráficos de barras, coloração, redimensionamento, posição, exibir/não exibir, rotação, comando, hyperlink e texto de entrada/saída

o Lista de alarmes históricos exibida Online

o Trending histórico e Online

o Ferramentas de Alinhamento e Distribuição

o Criar e editar Camada de fundo de bitmap

o Importação de Gráficos

o Caixas para objeto ActiveX

• Gerenciamento e configuração remotos e Online

• Arquitetura complacente a Microsoft, com OPC complete e suporte XML

• Interface na Web habilitada, a qual exporta telas da Aplicação para um “thin” client através da Internet/intranet e por troca de dados online através do protocolo TCP/IP

• Biblioteca de Símbolos, com mais de 100 símbolos e objetos dinâmicos, como pushbuttons, meters, sliders, switches, text e exibições númericas, indicadores LED-style, tubulação, bombas, icons, veículos, válvulas, molduras, motores, medidores e controles comuns

• Ferramentas de Correção de erros:

o Janela Database Spy para monitorar/forçar valores de tag e executar funções

o Módulo de LogWin para gravar OPC, DDE, e transações TCP/IP, ativação de módulos, tags de log, etc

o Referência cruzada para locar tags através do projeto

o Sistema Online e diagnósticos de rede de trabalho

• Tags Database poderosos e flexíveis (Boolean, Integer, Real, e tags de String), tags de array, classes, e apontadores de tags indiretos

• Abre Arquitetura com trocas de API e valores de tags com software externo

• Editor de tradução, o qual capacita a tradução da Aplicação para várias linguagens diferentes, além de alterá-las enquanto o sistema de runtime está online

• Módulos Cliente e Servidor TCP/IP para trocar valores de tag e configurar sistemas redundantes

• Mais de 200 drivers para diferentes equipamentos (como PLC) a partir de diferentes fabricantes: Allen-Bradley, Siemens, GE-Fanuc, assim como protocolos padrão como MODBUS RTU/ASCII, DeviceNet, Profibus, Interbus, etc

• OPC Server e OPC Client com Browser OPC integrado

• Segurança de runtime através de senhas para Telas e Objetos (256 níveis)

• Expressões de lógicas e uma linguagem de script com mais de 200 funções


InduSoft Web Studio

Página 21

• Construtores de Receita e Relatório (nos formatos ASCII, UNICODE, e RTF) integrados no produto

• Calendários de evento baseado em data, hora e condição dos dados (resolução de 100ms)

• Aplicação com multi-camadas, significando que planilhas modulares e telas podem juntar-se facilmente a outras Aplicações

• Integração completa com programas de controle baseados em PC (banco de dados para importação de tags) como ISaGRAF, SteepleChase, Think&Do, e ASAP

• Funções Dial-Up para disparar, monitorar e manipular uma conexão dial-up com o RAS Server das estações remotas

• Funções para enviar email a partir do IWS (ou CEView)

• Documentação do Projeto em tempo real

• Conversor de resolução de tela

Nota: O IWS fornece diferentes tipos de produtos, de acordo com cada nível da aplicação a ser construída. Porém, o IWS não suporta alguns recursos em certos tipos do produto (como o CEView). Pode-se revisar a documentação TargetVersions.pdf no CD-ROM do InduSoft Web Studio para informações mais detalhadas sobre as limitações de cada um dos produtos.


InduSoft Web Studio

Página 22

Capítulo 2: Instalando o InduSoft Web Studio Esse capítulo explica como instalar, licenciar, rodar e desinstalar o InduSoft Web Studio (IWS) e o CEView™. Pode-se instalar o IWS a partir do CR-ROM do InduSoft Web Studio CD-ROM ou criar disquetes de instalação de 3.5 polegadas. Para aplicações do Windows CE, pode-se utilizar o IWS para fazer um download do CEView (software de runtime) para a IHM do Windows CE HMI por link serial ou TCP/IP.

O programa de instalação do IWS cria automaticamente os diretórios necessaries, copia arquivos para seu drive do harware e cria o ícone InduSoft Web Studio em sua pasta Desktop.

Notas:

Caso você esteja utilizando o Windows CE:

Para utilizar o IWS para fazer um download do CEView (o software de runtime) para a IHM do Windows CE utilize um link serial ou TCP/IP.

Ao instalar o InduSoft Web Studio em computadores com Windows NT/2000/XP, o IWS armazena os arquivos de runtime do CEView runtime nas seguintes pastas:

<InduSoft Web Studio Folder>\Redist\CEView\<Processou Type>\

Onde:

<Installation Folder> é o diretório de instalação escolhido durante a instalação (C:\Program Files\InduSoft Web Studio é o diretório de instalação padrão).

<Processor Type> é a plataforma do processador. A InduSoft fornece um runtime do CEView para a maioria das plataformas de processados suportadas pelo sistema operacional WinCE.

Antes de Começar

Nota: Deve-se ter privilégios de Administrador para estações de trabalho Windows NT/2000/XP nas quais você esteja instalando (ou desinstalando) o InduSoft Web Studio.

Antes de instalar o software do IWS, deve-se fazer o seguinte:

• Desinstale quaisquer outras versões mais antigas e instale aquelas mais recentes em um diretório diferente). Além disso, não pode-se instalar a mesma versão do IWS em dois caminhos diferentes de um mesmo computador.

• Requerimentos do Sistema

Para desenvolver aplicações do IWS, deve-se instalar os seguintes hardwares e softwares:

o Computador IBM compatível com um processador Intel® Pentium IV-compatível ou mais atualizado

o Sistema operacional de servidor Windows 2000/XP/2003

o Sistema operacional Windows NT/2000/XP ou Windows CE v3.00 para runtime

o Um mínimo de random-acess de 512MB (memória RAM)- memória de 1GB ou maiores são recomendadas

o MS Internet Explorer 6.0 ou mais atualizado


InduSoft Web Studio

Página 23

o Mínimo de 500MB de espaço em disco rígido livre, para instalação do produto e da aplicação (arquivos históricos/banco de dados que requerem espaço adicional em disco)

o Adaptador para Ethernet

o Adaptador de exibição VGA ou SVGA 100% IBM-compatível, com 64MB de memória RAM de Video (VRAM) ou maiores

o Equipamento de apontamento (mouse, trackball ou touch-screen) Microsoft-compatível

o Teclado padrão com teclas de função de F1 a F12

o Drive de CD-ROM (opcional)

o Drive floppy de 3.5 polegadasinch (opcional)

o Porta paralela (opcional)

o Porta USB (opcional)

o Porta serial COM e adaptadores (opcional)

Notas:

• Os requerimentos descritos acima são baseados em aplicações típicas. Dependendo de sua aplicação específica, os requisitos mínimos podem variar.

• Aplicações desenvolvidas com oInduSoft Web Studio podem rodar em dispositivos melhorados pelo sistema operacional do Windows CE (Windows CE v3.0 ou Windows CE .NET) como IHMs industriais ou PDAs (PocketPC). Consulte o vendedor de hardware para obter seus requisitos ao rodar suas aplicações sob sistema operacional Windows CE.

• Além do sistema operacional descrito acima, a estação Web Thin Client podem rodar os sistemas operacionais Windows 98 ou Windows ME.

• Ao utilizar uma Hardkey ao inves de uma Softkey para licenciar o produto, a porta paralela ou USB devem estar disponíveis no computador local.

Alguns dos itens listados acima como opcionais podem ser obrigatórios, dependendo de sua Aplicação. Por exemplo, caso você precise trocar dados com um PLC via uma interface serial, o computador deve prover uma porta COM serial.


InduSoft Web Studio

Página 24

Instalando o IWS Utilize os seguintes procedimentos para instalar o IWS a partir do CD-ROM:

Ligue seu computador e tenha certeza de que não existe nenhum outro programa rodando.

Insira o CD-ROM de instalação no driver do computador.

Uma janela Welcome to Indusoft deverá aparecer automaticamente:

Janela Welcome to InduSoft

Caso a janela Welcome to Indusoft não aparecer, você pode iniciar o programa do Windows Explorer. Navegar para o diretório <D>:\Installation (onde <D> é o seu drive de CD-ROM), e a seguir rodar o arquivo Setup.exe (clicar no ícone InduSoft Web Studio fará com que esse programa rode).

A janela Welcome to Indusoft contém as seguintes pastas:

Welcome to InduSoft Web Studio v6.1: Página principal

About InduSoft: Contém apresentações em PowerPoint sobre a InduSoft.

Installation: Contém links de instalação do InduSoft.

Documentation: Contém toda a documentação do IWS em formato .pdf.

Sample Aplications: Contém amostras de Aplicações para auxiliar no desenvolvimento de suas próprias aplicações, além de fornecer exemplos para auxiliar no desenvolvimento de suas próprias Aplicações com a utilização do InduSoft Web Studio.

Technical / Application Notes: Contém documentos técnicos em formato .pdf.

Viewer Utilities: Contém o Microsoft PowerPoint Viewer (necessário para visualizar as apresentações fornecidas pela InduSoft em formato .ppt), Adobe® Reader® (necessário para visualizar os documentos da InduSoft fornecidos em formato .pdf), e WinZip® (para retirar do “zip” os arquivos comprimidos).


InduSoft Web Studio

Página 25

Na janela Welcome to Indusoft, clique no link Installation, e depois no link do InduSoft Web

Studio desejado para iniciar a instalação: InduSoft Web Studio Installation Wizard.

Um diálogo Setup aparece para infomá-lo de que o Wizard está carregando.

Siga as seguintes instruções, founecidas pelo Wizard, para prosseguir a instalação, a qual inclui:

Ler e aceitar o Contrato de Licença

Inserir um nome de usuário e o nome de sua companhia

Escolher um local de destino (aeitar o destino padrão)

Selecionar os componentes para instalação (aceitar o padrão)

Um diálogo Setup Status é exibido enquanto o programa é instalado, e o diálogo Setup Complete aparecerá assim que a instalação esteja concluída:

Diálogo de instalação concluída

Deve-se reiniciar o computador para continuar. Assim, clique no radio buttom Yes, I want to restart my computer now e clique em Finish.

Caso deseja-se instalar o Service Pack, instale-o agora da mesma maneira.

Após reiniciar o computador, clique duas vezes no ícone InduSoft Web Studio na área de trabalho ou selecione Start → All Programs → InduSoft Web Studio � InduSoft Web Studio para iniciar o programa do IWS.


InduSoft Web Studio

Página 26

Inicializando o InduSoft Web Studio

Dica: Pode-se rodar o ambiente de desenvolvimento sob qualquer configuração de video; porém, para rodar Aplicações em plataforma CE, recomendamos configurar suas configurações Display de video para uma resolução de 800x600 (ou mais avançada) e com a utilização de 256 cores (ou mais) para obtenção de um ambiente mais convidativo. A resolução da aplicação (dimensões da tela) é independente da resolução do sistema operacional.

Nota: O Microsoft .NET Framework 1.1 será automaticamente instalado, iniciando com o Pacote de Serviços 3 do IWS v.6. Veja em Utilizando Banco de Dados ODBC Interface do Banco de Dados do IWS para maiores informações.

Instalando o CEView

Nota: O software do sistema de runtime (CEView) para o sistema operacional Windows CE é geralmente pré-carregado na IHM. Se necessário, pode-se atualizar a versão do CEView para o software do sistema de desenvolvimento efetuando-se o download da versão atual para a IHM.

Ao instalar o InduSoft Web Studio no Windows NT/2000/XP, o IWS armazena os arquivos de runtime do CEView na seguinte pasta:

<InduSoft Web Studio Folder>\Redist\<OS Version>\<Processor Type>\

Onde:

• <InduSoft Web Studio Folder> é o diretório de instalação escolhido durante a instalação (C:\Program Files\InduSoft Web Studio é o diretório padrão para instalação).

• <OS Version> é a versão do sistema operacional na qual o CEView será instalado. A subpasta do CEView armazena os arquivos para WinCE v3.0. A pasta WinCE 4.0 armazena os arquivos para WinCE v4.0. A pasta WinCE 4.1 armazena os arquivos para WinCE v4.1, e assim por diante.

Da Área de Trabalho

Do Menu Iniciar


InduSoft Web Studio

Página 27

• <Processou Type> é a plataforma do processador. O InduSoft prove um runtime CEView para a maoiria das plataformas processadoras suportadas pelo sistema operacional WinCE.

Para instalar o CEView, siga os seguintes passos:

Ligue o equipamento WinCE, e o diálogo Remote Agent deverá carregar-se automaticamente.

Caso o diálogo não apareça, copie o arquivos CEServer.exe do diretório \InduSoft Web Studio\Redist\CEView\<Processou Type>\BIN no computador com WinNT/2000/XP onde o IWS foi instalado, cole o arquivo em uma pasta \<non-volatile> de seu WinCE, e rode o arquivo.

Nota: Existem diferentes caminhos para copiar-se um arquivo em um equipamento WinCE (por exemplo, pode-se mapear uma pasta compartilhada do computador com WinNT/2000/XP no equipamento WinCE ou utilizar o ActiveSync). Caso seja necessária assistência para copiar esse arquivo para o WinCE, entre em contato com o suporte técnico da InduSoft.

Após a execução do arquivo CEServer.exe, o diálogo Remote Agent será carregado no WinCE.

Clique no botão Setup no diálogo Remote Agent e configure o link (de série ou TCP/IP) para conectar o equipamento ao computador com WinNT/2000/XP.

Nota: A InduSoft recomenda a utilização do link TCP/IP entre o WinCE e seu computador WinNT/2000/XP para a efetuação de downloads e atualização de arquivos.

Inicie o InduSoft Web Studio no computador WinNT/2000/XP.

Seleione Project → Execution Environment a partir da barra de menu principal.

Quando aparecer o diálogo Execution Environment, selecione um tipo de conexão (Network IP, Serial Port ou Microsoft ActiveSync) e configure seus parâmetros (por exemplo, Endereço IP ou Porta COM).

Diálogo do Ambiente de Execução

Clique no botão Connect para conectar o InduSoft Web Studio ao WinCE.

Clique no botão Install System Files, a partir do diálogo Execution Environment (tab Target) para baixar arquivos do CEView para o WinCE.


InduSoft Web Studio

Página 28

Desisntalando o InduSoft Web Studio e CEView Caso seja necessário remover o InduSoft Web Studio de seu sistema, siga as seguintes instruções:

Atenção: Antes de iniciar o procedimento para desinstalação, certifique-se de que todos os arquivos tenham um back-up, pois esses poderão ser úteis no futuro. Salve-os na pasta …\InduSoft Web Studio\.

Além disso, certifique-se de que você possua a versão atual (ou mais recente) do CD-ROM de instalação do InduSoft Web Studio ou disquetes que possam ser reinstalados mais tarde caso seja necessário.

A partir da barra de tarefas do Windows, selecione Start � Settings � Control Panel para abrir o Control Panel.

Abrindo o Control Panel

Clique duas vezes no ícone Add/Remove Programs na janela Control Panel:

Quando o diálogo Add/Remove Programs Properties aparecer, selecione InduSoft Web Studio a partir da lista e, a seguir, clique no botão Add/Remove.


InduSoft Web Studio

Página 29

Removendo o InduSoft Web Studio

Quando o diálogo Confirm File Deletion aparecer, clique em Yes.

Aparecerão os seguintes diálogos: Uninstall Shield Wizard e Remove Programs from Your Compute.

Removendo Programas:Tela de Progresso

Quando a mensagem Uninstall successfully completed aparecer, e o botão OK se tornar ativo, clique no botão.

Verifique que o InduSoft Web Studio não esteja mais listado no diálogo Add/Remove Programs Properties.

Clique no botão Close ( ), para fechar o diálogo Add/Remove Programs Properties. Feche a janela Control Panel.

Abra o Windows Explorer. O browser conterá o diretório InduSoft Web Studio.

Verifique que todos os arquivos e pastas do InduSoft Web Studio fouam deletadas. (Deverão ser deletados manualmente caso ainda permaneçam.)


InduSoft Web Studio

Página 30

Nota: A ferramenta de desinstalação não pode deletar, automaticamente, arquivos que fouam criados ou modificados no \InduSoft Web Studio\Projects\ ou na pasta C:\Documents e Settings\Train3\My Documents\InduSoft Web Studio v6.1 Projects.

Licenciando seu Produto Essa seção explica como licenciar seus produtos InduSoft Web Studio (IWS) e CEView.

Notas:

Essas instruções são válidas para o InduSoft Web Studio v5.1 ou versões mais recentes.

Os arquivos de runtime do CEView para cada plataforma estão armazenados na estação de desenvolvimento durante a instalação do IWS. Pode-se utilizar as ferramentas de gerenciamento remoto do IWS para fazer o download de arquivos de runtime do CEView para o WinCE.

Versões do Produto

IWS e CEView devem possuir a mesma versão, a qual utiliza a sintaxe:

X.Y+SPWW (por exemplo, InduSoft Web Studio v5.0+SP1 e CEView v5.0+SP1)

Onde:

• X: Representa a Family version. A versão familiar é alterada somente queo melhorias são adicionadas às tecnologias e conceitos do produto.

• Y: Representa a Sub-version: A Sub-Versão altera-se que melhorias menores e/ou novos recursos são adicionados ao produto.

• WW: Representa o Service Pack. A versão do Pacote de SErviços altera-se que você deve instalar pacotes adicionais para entrar em concoudância com o seguinte:

o Atualizar arquivos da versão previamente instalada

o Corrigir erros no produto (showstoppers e no-workarounds)

o Fornecer melhorias de menor porte antes da publicação da próxima versão do produto

Cada pacote de Serviços publicado super excede aquele anterior. Por exemplo, SP2 inclui todo o Conteúdo do SP1 e todos os arquivos recentemente atualizados, correção de erros e melhorias. SP3 inclui todos os conteúdos de SP2 e todos os arquivos atualizados, correção de erros, melhorias, e assim por diante.

Atenção: Tanto o IWS quanto o CEView podem executar Aplicações construídas em versões anteriores do produto. Porém, versões mais antigas do IWS e CEView não podem executar Aplicações construídas ou modificadas em versões mais recentes do produto.

Por exemplo, você não pode executar uma aplicação da versão 5.1 do IWS utilizando uma versão 5.0, embora aplicações da versão 5.0 possam ser executadas na versão 5.1 do IWS.


InduSoft Web Studio

Página 31

IMPORTANTE! São nomeadas licenças específicas Family e Sub-version (X.Y) para cada versão, e a licença é válida para somente aquela versão (incluindo o Pacote de Serviços). Porém, a licença não será válida para uma versão mais recente de Family ou Sub-Versions do Produto. A qualquer momento em que você instalar uma nova versão do IWS ou CEView, você deve atualizar a licença atual para a nova versão a qual está sendo instalada. Caso você tenha instalado apenas o Pacote de Serviços, a atualização da licença não é obrigatória.

Licenças Inválidas

Ao tentar rodar o IWS com uma licença inválida, você receberá uma mensagem de aviso, a qual dá as informações necessárias para resolver esse detalhe.

Exemplos:

Versão do software é mais atualizada do que a licença instalada

O target system selecionado não é suportado pela licença atualmente instalada

Modos de Execução O InduSoft Web Studio e o CEView suportam os seguintes modos de execução:

Modo de Execução InduSoft Web Studio CEView

Modo de Validação

Modo Demo

Licenciado somente para Engenharia


InduSoft Web Studio

Página 32

Licenciado somente para Runtime

Licenciado para Engenharia +Runtime

= Aplica; =Não aplica

• Evaluation Mode: Habilita todos os engenheiros do produto e recursos de runtime.

A primeira vez em que o IWS é instalado em seu computador, o produto roda por 40 (quarenta) horas em Evaluation Mode. Esse periodo de validação inclui qualquer tempo para que você rode um modulo de produto (engenheiro ou runtime). Pode-se utilizar esse peróido de validação de forma contínua ou não (por exemplo: 10 horas em um dia, 4 horas em outro, 5 horas por dia, durante 8 dias, 10 horas por dia, por 3 dias ou 5 horas em um dia, por dois dias, etc).

Após rodar as 40 horas em Modo de Validação, o período de validação termina, e o IWS automaticamente converte-se e roda em Demo Mode (veja as descrições a seguir) até que seja instalada uma licença válida (Hardkey ou Softkey).Você não pode reativar o modo de Validação—mesmo em caso de desinstalação e reinstalação do produto em seu computador.

Nota: Cada versão do produto possui um período de validação, o qual é independente de cada versão do InduSoft Web Studio. Por exemplo, se o período de validação de sua versão 5.1 do IWS expirar, e você estiver rodando em Demo Mode por não ter instalado uma licença válida, ao instalar a versão 6.1 do IWS no mesmo computador, a versão mais recente começará a rodar suas próprias 40 horas de validação, e a versão 5.1 continuará rodando somente no Demo Mode.

• Demo Mode: permite habilidade para fazer download e upload de Aplicações para estações remotas, e rodar Aplicações para teste e/ou demonstrações. Pode-se executar tarefas de runtime e utilizar as ferramentas de correção de erros (LogWin e Database Spy), embora estas desliguem automaticamente após rodarem por duas horas ininterruptas. Você pode reiniciar o Demo Mode novamente e rodar por mais duas horas, e assim por diante. Você não pode criar ou modificar telas, planilhas ou configurações da Aplicação em Demo Mode.

As opções de menu a seguir estão disponíveis em Demo Mode:

Arquivo Vizualização Projeto Ferramentas Ajuda

Abrir Projeto Fechar

Barra Ferramentas Zoom Biblioteca

Configurações Status Rodar Aplicação Parar Aplicação

Enviar Projeto para Alvo Execução Ambiente Logon

Controles de Registro Converter Resolução Verificar Aplicação Informações do Sistema

Todas as opções

• Licensed fou Engineering Only: Habilita todas as opções de trabalho por tempo ilimitado.

Esse modo também permite a execução de tarefas de runtime e ferramentas de correção de erros (Database Spy, output window, e módulo LogWin) por 24 horas, continuamente. Após


InduSoft Web Studio

Página 33

esse período, as tarefas se desligarão, mas você pode reiniciá-las e rodá-las por mais 24 horas, e assim por diante. Você pode utilizar essa licença somente para desenvolvimento e teste.

• Licensed for Runtime Only: Capacita todos os runtimes e ferramentas de correção de erros (Database Spy,output window, e módulo LogWin) por tempo ilimitado, mas você não poderá criar ou modificar telas e/ou planilhas.

As opções de menu disponíveis no modo Runtime Only são as mesmas opções listadas para Demo Mode (veja a tabela anteriou).

• Licensed fou Engineering + Runtime: Capacita todas as ferramentas de engenharia, tarefas de runtime e ferramentas para correção de erros (Database Spy, Output window e módulo LogWin) por período ilimitado.

IMPORTANTE! Cada licença contém restrições, assim como quais Tipos de Produtos são suportados para aquela licença. Consulte seu vendedor de software sobre quais tipos de produto estão disponíveis, e quais recursos são habilitados para cada tipo.

Notas: As ferramentas do Ambiente de Execução do IWS estão sempre disponíveis; você poderá fazer uploads ou downloads de arquivos a partir de ou para estações remotas (como equipamentos WinCE remotos) utilizando o diálogo Execution Environment (Project → Execution Environment).

Pode-se selecionar Help → About a partir da barra de menu principal para visualizar qual o Modo de Execução que está em andamento. A tela About InduSoft Web Studio contém informações sobre o Modo de Execução atual. Caso esteja rodando o modo Evaluation, o tempo remanescente de execução aparecerá no campo Modo de Execução.

Verificando Versão, Modo de Execução, e Tempo de Validação Remanescente

Tipos de Proteção O InduSoft Web Studio e CEView suportam os seguintes tipos de proteção:

Tipo de Proteção InduSoft Web Studio CEView

Hardkey

Softkey


InduSoft Web Studio

Página 34

= Aplica ; = Não aplica

• Hardkey: Um chip encapsulado que deve ser fisicamente conectado a uma porta paralela do computador (LPT1) ou da interface USB.

A licença IWS reside no hardkey, e não é possível compartilhá-la com mais de uma cópia do IWS na rede de trabalho. Caso você conecte o hardkey em outro computador, você estará transferindo a licença para esse outro computador.

Utilizar o hardkey não incapacita a conexão de outros equipamentos (como uma impressora) para a porta paralela do computador—o hardkey deve ser eletronicamente transparente para outros equipamentos conectados à porta paralela. Você simplesmente conecta o hardkey ao computador, e então conecta o cabo da impressora no hardkey. Porém, podem ser encontrados problemas nessa tarefa, caso você instale mais de um hardkey (para diferentes produtos) à mesma porta paralela. Por outro lado, ao utilizar o hardkey USB, essa porta não poderá ser compartilhada com outros equipamentos.

Atenção: Cuidado ao instalar ou remover um hardkey da porta paralela do computador. Recomendamos que o computador seja desligado e desconectado da tomada antes de instalar ou remover um hardkey.

• Softkey: Ao instalar o IWS ou CEView, o programa gera um único código, chamado Site Code. Você pode enviar esse código local para seu vendedor do software, o qual poderá gerar um código de licença chamado Site Key para habilitar seu código local. A chave local instala a licença do IWS ou CEView em seu computador ou equipamento ou WinCE.

Nota: Ao instalar um softkey, o IWS recodifica a licença na mémoria não-volátil de seu computador (ou no equipamento WinCE). Caso esse equipamento esteja danificado, você perderá essa licença.

Configurações da Licença Tanto as licenças de hardkey quanto de softkey configuram os seguintes parâmetros:

• Product Type: Especifica quais recursos e restrições estão habilitadas para a Aplicação (como um número máximo de tags suportado, número máximo de drivers rodando simultaneamente, e assim por diante). Consulte seu vendedor de software sobre quais os tipos de produto estão disponíveis e quais recursos estão habilitados para cada tipo.

• Modo de Execução: Especifica as seguintes opções

Engineering Only: Configura e roda a Aplicação para teste somente durante seu desenvolvimento. Você não poderá utilizar essa licença de runtime a longo prazo.

Runtime Only: Roda a Aplicação por tempo ilimitado. Você não poderá utilizar essa licença para desenvolver ou modificar a Aplicação.

Engineering + Runtime: Configura, modifica e roda a Aplicação por tempo ilimitado.

• Number of Web Thin Clients: Especifica quantos Web Thin Clients são suportados simultaneamente pelo servidor. Você pode conectar um ou mais Web Thin Clients ao servidor simultaneamente (em caso de carga adicional), embora a licença instalada no servidor deve suportar esses Web Thin Clients adicionais.


InduSoft Web Studio

Página 35

• Number of Thin Clients (Secure Viewer): Especifica quantos Thin Clients são suportados simultaneamente pelo servidor. Você pode conectar um ou mais Thin Clients ao servidor simultaneamente (em caso de carga adicional), embora a licença instalada no servidor deve suportar esses Thin Clients adicionais.

A opções para adicionar Web Thin Clients e Thin Clients são as seguintes:

Server for InduSoft Web Studio (WinNT/2000/XP): Conecta 0, 1, 2, 4, 8, 16, 32, 64, 128, ou 256 Web Thin Clients e/ou Thin Clients ao servidor simultaneamente.

Server for CEView (WinCE): Conecta 0, 1, 2, 4, ou 8 Web Thin Clients e/ou Thin Clients ao servidor simultaneamente.

• Version Supported: Ao gerar uma licença, essa especificará a versão do produto ao qual ela suporta.

Instalando Licenças de Hardkey para o InduSoft Web Studio Essa seção explica como instalar uma licença de hardkey em um computador Windows NT/2000/XP.

Instalando uma Nova Licença

Para instalar uma nova licença no IWS, siga os seguintes passos:

Instale o InduSoft Web Studio em seu computador utilizando as instruções fornecidas previamente nesse Capítulo.

Conecte o hardkey à porta paralela (LPT1) ou interface USB no computador onde o IWS foi instalado.

Atenção: Cuidado ao instalar ou remover um hardkey de seu computador. Recomendando que o computador seja desligado antes de instalar ou remover um hardkey.

Rode o InduSoft Web Studio.

Atualizando a Licença de Hardkey Atual

Para atualizar sua licença atual do IWS, execute os seguintes passos:

Feche todos os módulos de desenvolvimento e runtime do InduSoft Web Studio.

Assegure-se de que o hardkey esteja conectado à porta paralela (LPT1) ou interface USB no computador onde o IWS está instalado.

Selecione Start → Programs → InduSoft Web Studio → Register to execute the Register module.

Quando o diálogo Protection Manager aparecer, habilite o botão Hardkey na seção Protection Type e a seguir, clique no botão Check.

Gerenciador de Proteção: Selecionar Hardkey


InduSoft Web Studio

Página 36

Caso você não possua uma licença de hardkey válida conectada à porta do computador paralelo ou

interface USB, a seguinte mensagem de erro aparecerá:

Não há Hardkey

Caso você possua uma licença de hardkey válida conectada à porta paralela do computador (LPT1) ou interface USB, o diálogo Hardkey Settings aparecerá, contendo as configurações da licença atual gravadas no hardkey.

Verificando as Configurações do Hardkey

Clique no botão Change License para abrir o diálogo Change License – Hardkey:

Alterando o Diálogo da Licença

Copie o código da caixa de texto Site Code e envie-o ao vendedor do software.

O vendedor do software deverá enviar um Site Key para validar o código local. Digite esse código local no campo Site Key do diálogo Change License – Hardkey e clique no botão Authorize.

Você será requisitado a confirmar a operação. Caso o programa aceite (valide) seu código local, a seguinte mensagem aparecerá:

Registro: foi executado com sucesso


InduSoft Web Studio

Página 37

Nota: Caso seu novo Site Key não esteja válido, uma mensagem de erro aparecerá. Caso isto aconteça, verifique se você digitou o Site Key corretamente. Caso tenha sido digitado corretamente, e a mensagem de erro ainda permanecer, contate o vendedor de seu software para maior assistência.

Você pode atualizar qualquer configuração da licença (Tipo de Produto, Modo de Execução, ou Número de Web Thin Clients) simultaneamente suportados pelo servidor, ou atualizar a versão do software que esteja sendo suportada atualmente. O custom da atualização dependerá das configurações da licença atual e das configurações da licença a qual será atualizada.

Instalando uma Licença de SoftKey para o InduSoft Web Studio Essa seção explica como instalar e atualizar uma licença de SoftKey para o IWS (em Win NT/2000/XP).

Nota: Você deve ter privilégios de Administrador para a estação de trabalho Windows NT/2000/XP na qual você está instalando ou modificando a licença de softkey.

Instalando uma Nova Licença

Para instalar uma nova licença de softkey no IWS, siga os seguintes passos:

Instale o InduSoft Web Studio em seu computador utilizando as instruções fornecidas anteriormente nesse Capítulo.

Execute o módulo Register selecionando Start → Programs → InduSoft Web Studio → Register.

Clque (habilite) o radio button Softkey no grupo Protection Type, e clique no botão Check.

Gerenciador de Proteção: Softkey

Nota: Caso você possua uma licença de hardkey instalada em seu computador, o diálogo Register aparecerá com a mensagem “Warning: this will change the protection method of the software. Continue anyway?”.

Para continuar a instalação do softkey, clique em Yes.

O diólogo Softkey Settings aparecerá.


InduSoft Web Studio

Página 38

o Caso você já possua uma licença de softkey instalada e válida para o InduSoft Web Studio, as configurações dessa licença aparecerão.

o Caso você não tenha uma licença previamente instalada, a caixa de texto Status exibirá a mensagem License not found.

Checking the Softkey Settings

Clique no botão Change License no diálogo Softkey Settings.

Quando o diálogo Change License – Softkey aparecer, copie a informação do código da caixa de texto Site Code e envie-o para o vendedor do software.

Alterar Licença: Softkey

O vendedor de seu software deverá enviar uma Site Key que valide esse Site Code. Digite o Site Key no campo Site Key do diálogo Change License – Softkey e depois clique no botão Authorize.

Você será requisitado a confirmar a operação. Caso o programa aceite (valide) seu Site Key, a seguinte mensagem aparecerá:

A instalação do Site Key foi Executada com Sucesso

Nota: Caso seu novo Site Key não esteja válido, uma mensagem de erro aparecerá. Caso aconteça, certifique-se de que o código local tenha sido digitado corretamente. Se a mensagem de erro ainda permanecer, entre em contato com o vendedor do software para maior assistência.

Feche o módulo Register e rode o InduSoft Web Studio.


InduSoft Web Studio

Página 39

Atualizando a Licença Atual

Para atualizar sua licença do IWS, siga os passos a seguir:

Antes de atualizar uma licença de softkey, você deverá reinstalar o InduSoft Web Studio no mesmo computador onde a licença foi instalada primeiramente.

Atenção: Não desinstale o InduSoft Web Studio antes de obter uma licença atualizada de seu vendedor do software, ou você perderá a licença atual e não será permitida a instalação da licença atual. (Deverá ser feito um novo pedido de instalação.)

Para a instalação da versão mais recente do InduSoft Web Studio, abra a sub-pasta \BIN e rode o programa SKEYUPG.exe.

O diálogo Upgrade Softkey aparecerá:

Diálogo de Atualização do Softkey

No diálogo Upgrade Softkey, clique no botão e quando o diálogo Browse dialog aparecer, selecione o caminho(local) onde a versão anterior (já habilitada) do IWS foi instalada. As informações do caminho especifíco aparecerá automaticamente na caixa de texto Path na seção Old Version.

Encontrando o Softkey Instalado Anteriormente

Clique no botão Save SKEYUPG.BIN file para salvar as informações necessárias para a geração de uma licença atualizada.

Copie o arquivos SKEYUPG.BIN do diretório onde você executou o programa SKEYUPG.exe e envie-os para seu vendedor do software.


InduSoft Web Studio

Página 40

Seu vendedor do software deverá reenviar um Site Key que valide as informações salvas no arquivo SKEYUPG.BIN.

Execute o módulo Register ( Register) para a versão mais recente instalada do InduSoft Web Studio (onde o programa SKEYUPG.exe foi executado para gerar o arquivo SKEYUPG.BIN).

Quando aparecer o diálogo Protection Manager, clique (habilite) o botão Softkey na seção Protection Type e clique no botão Check.

Gerenciador de Proteção: Selecionar Softkey

O diálogo Softkey Settings aparecerá.

Caso você não tenha instalado uma licença anteriormente, a caixa de texto Status exibirá a mensagem “License not found”:

Diálogo de Configuração de Softkey

Caso você já possua uma licença válida de Softkey para o InduSoft Web Studio, as configurações da licença atual aparecerão:

Configurações de Softkey Settings: Licença encontrada

Pode-se atualizar qualquer configuração da licença (Tipo do Produto, Modo de Execução, ou Número de Web Thin Clients) simultaneamente suportadas pelo servidor, ou também atualizar a versão do software a qual está sendo suportado. O custom de atualização dependerá das configurações de sua licança atual, assim como das configurações de sua licança a ser atualizada.


InduSoft Web Studio

Página 41

No diálogo Softkey Settings, clique no botão Change License para abrir o diálogo Change License – Softkey:

Alterar Licença: Softkey

Digite o código local enviado para seu vendedor do software no campo Site Key do diálogo Change License – Softkey.

Clique no botão Authorize.

Caso o Código Local for aceito (validado), a seguinte mensagem aparecerá:

Instalação do Código Local Executada com Sucesso

Nota: Caso o novo código local não seja válido, uma mensagem de erro aparecerá. Caso acontecer, verifique se você digitou o código local corretamente. Se a mensagem ainda permanecer, entre m contato com o vendedor do software para maior assistência.

Feche o módulo Register e rode o InduSoft Web Studio.


InduSoft Web Studio

Página 42

Instalando uma Licença de SoftKey para CEView Existem dois modos de registrar uma licença para o CEView em seu equipamento WinCE:

• Locally: Utilizando o Agente Remoto do WinCE como interface.

• Remotely: Utilizando o InduSoft Web Studio para enviar a licença ao equipamentoWinCE.

Nota: Pode-se obter equipamentos WinCE com a licença para o CEView já instalada e habilitada. Consulte o vendedor do software sobre essa outra possibilidade.

Instalando ou Atualizando uma Licença (Localmente)

Para instalar (ou atualizar uma já existente) uma nova licença de softkey para o CEView (localmente), siga o seguinte procedimento:

Faça o download do programa Remote Agent (CEServer.exe) no caminho \<Non-Volatile Folder> do equipamento WinCE. A pasta \<Non-Volatile Folder> deverá reter esses dados após a reinicialização do equipamento WinCE.

Nota:

O caminho \<Non-Volatile Folder> pode variar de acordo com cada fabricante do equipamento WinCE.

Após instalar o IWS no computador com WinNT/2000/XP, o arquivo do programa Remote Agent (CEServer.exe) é encontrado no caminho:

<InduSoft Web Studio Path>\Redist\<WinCE version>\<Platfoum>\BIN\ CEServer.exe

Onde:

<InduSoft Web Studio Path> é o diretório onde o IWS foi instalado (por exemplo, C:\Program Files\InduSoft Web Studio\).

<WinCE version> indica que a versão do sistema operacional (por exemplo, CEView para Windows CE v3.0, WinCE 4.0 para Windows CE v4.0, WinCE 4.1 para Windows CE v4.1, etc).

<Platfoum> é o tipo de processador do equipamento WinCE (por exemplo, x86).

Nota: Em alguns equipamentos WinCE devices, o caminho \<Non-Volatile Folder> aponta para um cartão de memória (FlashCard memory) conectado ao equipamento. Além disso, antes de fazer o download do Remote Agent (CEServer.exe) para seu WinCE, certifique-se de que este ainda não está carregado (no caminho: \<Non-Volatile Folder>).


InduSoft Web Studio

Página 43

Dicas: Existem dois caminhos para fazer o download do programa Remote Agent (CEServer.exe)para um WinCE:

Pode-se utilizar a utilidade ActiveSync® da Microsoft para fazer download/upload de arquivos de uma estação WinNT/2000/XP para um equipamento WinCE. Você também pode fazer o download do ActiveSync no site da Microsoft. Pode-se utilizar a sintaxe a seguir para mapear uma pasta compartilhada de um computador WinNT/2000/XP para a maioria dos equipamentos WinCE:

net use [<Local Name>] [Remote Name] [/user:<UserName>]

Após executar esse commando, abra a janela Comme Prompt e utilize o comando COPY para copiar os arquivos para o WinCE.

Recomendamos que você configure o equipamento WinCE para que seja executado o programa Remote Agent automaticamente ao ligar o equipamento. Veja a documentação do fabricante do equipamento para maoires informações sobre como configurar o programa de inicialização (Startup) no equipamento.

Caso o programa Remote Agent (CEServer.exe) não inicializar automaticamente ao ligar o equipamento WinCE, você deverá rodá-lo manualmente, a partir de \<Non-Volatile Folder>.

Diálogo Remote Agent

No diálogo Remote Agent, clique no botão Setup para abrir o diálogo Setup:

Diálogo Setup


InduSoft Web Studio

Página 44

Clique no botão License para abrir o diálogo License:

Diálogo License

Clique no botão Change License para abrir o diálogo Change License:

Diálogo Change License

Copie o código (fornecido na caixa de texto Site Code) e envie-o para seu vendedor do software.

Seu vendedor do software deverá reenviar um Site Key que valide esse código local. Digite o Site Key no campo Site Key no diálogo Change License, e clique no botão Authorize.

Caso o código local seja aceito (validado), a seguinte mensagem aparecerá:

Site Key Instalado com Sucesso

Nota: Caso o novo código local não seja validado, aparecerá uma mensagem de erro. Caso aconteça, certifique-se de que o código local tenha sido digitado corretamente. Se a mensagem de erro ainda assim persistir, entre em contato com o vendedor do software para maior assistência.


InduSoft Web Studio

Página 45

Instalando ou Atualizando uma Licença (Remotamente)

Para instalar (ou atualizar) uma licença de SoftKey para CEView (remotamente), siga o seguinte procedimento:

Execute os três primeiros passos descritos na seção anterior.

No diálogo Setup, especifique o tipo de conexão do equipamento (Device Connection) clicando (habilitando) em Serial Port ou TCP/IP. (Caso você habilite o botão Serial Port, você deverá selecionar uma porta a partir da lista combo-box). Clique em OK para fechar o diálogo.

Rode o InduSoft Web Studio na estação WinNT/2000/XP e conecte essa estação ao equipamento WinCE utilizando um link serial ou TCP/IP.

A partir da barra de menu principal do IWS, selecione Project → Execution Environment para abrir o diálogo Execution Environment:

Diálogo Execution Environment

Especifique uma target station, clicando um dos seguintes radio buttons em Target Station (target station):

Local

Network IP e digite o endereço IP no campo apropriado

Serial Port e selecione uma porta a partir da lista de combo-box fornecida

Microsoft ActiveSync

Quando o botão Connect ficar ativo, clique neste botão para conectar-se ao equipamento WinCE no qual o Remote Agent esteja rodando. (Caso você selecione uma Network IP, você deverá inserir o endereço IP na caixa de texto apropriada.)

Dica: Os links TCP/IP possibilitam uma melhor performance de comunicação, quando comparados a links seriais.


InduSoft Web Studio

Página 46

O campo Status deverá exibir a seguinte mensagem:

Connected to CEView <CEView Version>

Conectando-se ao CEView

Selecione o tab CE License para visualizar quais configurações de licença estão instaladas atualmente em seu equipamento WinCE.

CEView License Settings

Na seção License Codes do diálogo Execution Environment, copie as informações exibidas no campo Site Code e envie-as para o vendedor de seu software.

Esse deverá reenviar uma Site Key que valide esse código local enviado. Digite o código local no campo Site Key.

Clique no botão Send para enviar o código para o Remote Agent que esteja rodando no equipamento WinCE.

O programa Remote Agent requisitará a instalação de uma nova licença utilizando o código local enviado pelo InduSoft Web Studio. Caso o código local seja aceito (validado), a seguinte mensagem aparecerá:

Instalação do Código Local Executada com Sucesso


InduSoft Web Studio

Página 47

Nota: Caso o novo código local não seja válido, uma mensagem de erro aparecerá. Caso aconteça, verifique se o código foi digitado corretamente. Se a mensagem ainda assim persistir, entre em contato com seu vendedor do software para maior assistência.

Atenção: Após enviar a licença para o equipamento WinCE, certifique-se de que as configurações de registro foram salvas. Caso essas configurações não sejam salvas, você perderá a licença quando reiniciar o equipamento.


InduSoft Web Studio

Página 48

Capítulo 3: Trabalhando com o Ambiente de Desenvolvimento do IWS Esse Capítulo fornece uma visão geral do ambiente de desenvolvimento do InduSoft Web Studio. As informações estão organizadas nas seguintes seções:

• Navegando na Janela do ambiente de Desenvolvimento

• Utilizando o Editor Tela/Planilha

• Utilizando o Database Spy

• Utilizando a Output window

• Customizando o Workspace

• Módulos de Desenvolvimento

• Comunicações gerais

Navegando no Ambiente de Desenvolvimento

O InduSoft Web Studio utiliza ferramentas padrão e semelhantes às do Windows, além de interfaces que fornecem um ambiente de desenvolvimento integrado e amigável:


InduSoft Web Studio

Página 49

Tal ambiente de desenvolvimento consiste dos seguintes recursos:

• Barra de título

• Barra de Menu

• Barra de Ferramentas

• Workspace

• Editor Tela/Planilha

• Janela Database Spy

• Janela Output (LogWin)

• Barra de Status

Nota: Outras ferramentas do IWS, como Symbol Library e Translation Editor também contêm alguns desses recursos (como barra de menu).

Utilizando a Barra de Título

A barra de título está localizada na janela acima do ambiente de desenvolvimento e contém o ícone da InduSoft, o nome do produto e o nome da tela ativa ou planilha (qualquer que seja planilha).

Exemplo de Barra de Título

A Barra de Títulos também contém os seguintes botões(da esquerda para a direita):

• Botão Minimize ( ): Clque para minimizar a janela do ambiente de desenvolvimento.

• Botão Restore Down/Maximize ( / ): Clique para manipular a janela do ambiente de desenvolvimento para dois tamanhos diferentes:

Restore Down reduz a janela a seu tamanho original (padrão)

Maximize Aumenta a janela, preenchendo toda a tela de seu computador

• Botão Close ( ): Clique para salvar o database e fechar o ambiente de desenvolvimento. Caso você modifique quaisquer telas ou planilhas, o programa requisitará que se salve o trabalho efetuado. A função desse Botão é similar a seleção do comando Exit no menu File.

Nota: Fechar o sistema de desenvolvimento não fecha o sistema de runtime.


InduSoft Web Studio

Página 50

Utilizando a Barra de Menu

A menu bar está localizada logo abaixo da barra de títulos.

Menu Bar

A barra de menu prove acesso aos seguintes menus e as suas opções:

• File: Contém opções que permitem o gerenciamento dos arquivos da aplicação.

• Edit: Contém opções que permitem o gerenciamento de telas e planilhas.

• View: Contém opções que permitem o gerenciamento de ferramentas, além de fornecer atalhos para diálogos usados com maior frequencia.

• Insert: Contém opções que permitem a configuração de tags da aplicação, classes de tags, documentos, drivers, usuários, configurações de segurança, telas, e objetos ActiveX.

• Project: Contém opções que permitem a execução da aplicação local e remotamente, além de fornecer links utilizados para a configuração de parâmetros gerais da aplicação.

• Tools: Contém opções que permitem acesso a links para ferramentas auxiliaries no desenvolvimento.

• Window: Contém opções que permitem o gerenciamento da abertura de telas e planilhas.

• Help: Contém opções para links com informações do produto InduSoft Web Studio e sobre a InduSoft.

Ao clicar no menu, um menu anexo aparecerá, contendo uma variedade de opções relacionadas.

Por exemplo, ao clicar em View, o seguinte menu aparecerá:

Menu Anexo à Opção View

Notas: Opções de menu individuais são discutidas em detalhes ao longo dessa publicação sempre que seu uso seja relacionado a performance de uma tarefa específica.

Em muitos casos, a funcionalidade das opções do menu é duplicada com a utilização

de botões nas diversas barras de tarefas. Por exemplo, você pode clicar no Botão ou selecionar File → Print para abrir o diálogo Print.


InduSoft Web Studio

Página 51

Recursos do menu anexo

Certos recursos em um menu anexo fornecem mais do que você pode esperar ao selecionar um item no menu principal.

• Reticências ( ): Indica que um diálogo ou janela abrirá ao selecionar essa opção. Por exemplo, ao selecionar a opção New, o diálogo New aparecerá.

• Setas ( ): Indica que um menu em cascata (um Segundo menu em anexo) aparecerá ao selecionar essa opção. Por exemplo, ao selecionar a opção Toolbars, o seguinte menu em cascata aparecerá:

Menu em Cascata da Barra de tarefas

• Keyboard Combinations e Function Keys: Indicam um método alternativo (atalho) para selecionar a opção a partir do menu anexo. Por exemplo,

Pressionar as teclas Ctrl e p simultaneamente é o mesmo que selecionar a opção Print no menu File.

Pressionar as teclas Alt e 1 simultaneamente abre/fecha a janela Output.

Pressionar a função F4 abre a janela Zoom.

• Botões Inverter ( ) ou ( ): Clique no Botão para alternar entre deixar o recurso em on

e off .

Por exemplo, se você clicar uma vez no Botão Standard exibido na figura acima, você desligará a barra de tarefas Standard e esta não aparecerá no ambiente de desenvolvimento. Clique no Botão novamente, e a barra de tarefas reaparecerá. De forma similar, clicar no Botão

Workspace, inverters a exibição do Workspace em e off .

• Option Name only: Indica que, ao clicar no nome da opção, o IWS executará a tarefa imediatamente, ou colocará o usuário no modo correto para a execução da tarefa. Por exemplo, selecionando File → Save, o IWS salva imediatamente a tela ativa da Aplicação.


InduSoft Web Studio

Página 52

Reposicionando a barra de menu

A barra de menu é um recurso reposicionável, o que significa que você pode move-la para outro local na janela do ambiente de desenvolvimento.

Para mover e reposicionar a barra de menu:

Clique na barra de menu e arraste-a para o novo local.

Solte o Botão do mouse para anexar ou posicionar a barra de menu.

Utilizando a Barra de Ferramentas

O InduSoft Web Studio provê várias barras de ferramentas que habilitam a execução de diferentes tarefas junto ao programa. Essa seção descreve a função e o local padrão de cada barra de ferramentas.

• A barra de ferramentas a seguir contém ferramentas de uso geral, e são localizadas ao longo da parte superior do Workspace, abaixo da barra de menu (padrão):

Standard

Tag Properties

Execution Control

Web

Align and Distribute

• As barra de ferramentas a seguir contêm ferramentas para edição de telas, e são localizadas ao longo do lado direito da janela do ambiente de desenvolvimento (por padrão):

Mode

Static Objects

Active Objects

Dynamic Properties

Bitmap

Notas:

A barra de ferramentas Bitmap está oculta por padrão. Selecione View → Toolbars → Bitmap do menu principal para exibir ou ocultá-la.

Instruções detalhadas para utilização dessas barra de ferramentas e suas opções são fornecidas ao longo dessa publicação quando essas deverem ser utilizadas para executar uma tarefa específica.

Posicionando um barra de ferramentas

Todas as barras de ferramentas são reposicionáveis,o que significa que você poderá move-las para outro local da janela do ambiente de desenvolvimento. Para mover e posicionar qualquer uma das barras de ferramentas:

Clique na barra de ferramentas e arraste-a para o novo local.

Solte o Botão do mouse para anexar e posicionar a barra de ferramentas em sua nova posição.

Dica: Posicione seu cursor em um Botão e a barra de status (localizada abaixo da interface do IWS) fornecerá uma breve descrição daquele Botão.


InduSoft Web Studio

Página 53

Utilizando o Workspace

A janela Workspace é uma interface amigável que permite encontrar a localização de qualquer componente da aplicação (como tags, telas, planilhas, etc) de forma fácil e rápida.

Pode-se redimensionar, mover ou ocultar a janela Workspace para assim adaptar-se ao seu estilo de desenvolvimento.

Workspace contém quatro tabs:

• Database: Provê acesso a todos os tags do banco de dados e components do sistema de segurança configurados para a aplicação atual.

• Graphics: Provê acesso a todas as telas e símbolos na aplicação.

• Tasks: Provê acesso a todas as planilhas de tarefas na aplicação.

• Comm: Provê acesso a todos os drivers configurados para estabelecer comunicação com outro equipamento ou programa de software utilizando protocolos disponíveis.

Em cada tab, os componentes da aplicação (representados por um ícone e descrição únicos) estão organizados em uma exibição tree-view como a que se segue:

Tabs do Workspace

Clique no Botão ou clique duas vezes na pasta para visualizar os conteúdos da pasta ou clique no Botão para fechar a pasta.

Caso você clique com o Botão direito em qualquer componente no Workspace, um menu exibirá opções relacionados a aquele componente. Por exemplo, o menu pop-up a seguir permite abrir (Open) o tags database da Aplicação, Insert (criar) um novo tag, ou Refresh a visualização atual do tags database da Aplicação:

Clique com o Botão direito para abrir um Menu Pop-Up


InduSoft Web Studio

Página 54

Clicando-se duas vezes no Botão ou nome de qualquer componente em uma pasta, um diálogo, planilha ou tela relacionados ao IWS aparecerá, podendo-se assim editar o componente. Por exemplo:

O restante dessa seção descreve cada um dos tabs do Workspace.

Duplo-clique Development para abrir o diálogo Group Account

Duplo-clique Datasheet View para abrir a Application Tags Worksheet

Duplo-clique Main.scr para abrir a tela de exposição Main.scr


InduSoft Web Studio

Página 55

Tab Database

Selecione o tab Database para acessar todos os tags do banco de dados e os componentes do sistema de segurança disponíveis para a aplicação atual. Esse tab contém as seguintes pastas:

• Aplication Tags contém tags criadas durante o desenvolvimento da aplicação (como tags de tela ou tags de leitura/escrita para preencher equipamento).

Dica: Pode-se escolher os dados nas planilhas de Tags da Aplicação e/ou inserir/remover colunas adicionais clicando-se com o Botão direito e escolhendo a opção aplicável no menu pop-up.

• Classes contém tags compostas, chamadas class tags, criadas para associar um conjunto de valores (mais do que um único valor) ao objeto.

• Shared Database contém tags criadas em um programa de software de controle baseado em PC e depois importadas para o banco de dados de tags do IWS.

Por exemplo, você poderá importar tags SteepleChase tags para o IWS, e Esse lerá/escreverá dados de um produto de controle baseado em PC SteepleChase.

• Internal Tags contém tags pré-definidos com funções pré-determinadas utilizadas pelo IWS para tarefas de supervisão específicas (por exemplo, Date tags mantém a data atual em formato string).

Todos os tags internos são read-only, o que significa que você não poderá adicionar, editar ou remover esses tags do banco de dados.

• Security: Contém contas de segurança de todos de um grupo ou de usuários individuais configurados para a aplicação atual.

• Event Settings: Contém recursos de logging e entrega de eventos.

• Global Procedures: Esta relação é usada declarar e executar os procedimentos que podem ser chamados por toda a outra relação de VBScript disponível no produto.

Você pode visualizar, adicionar e editar tags nas pastas Aplication Tags, Classes, Shared Database, ou Internal Tags como se segue:

• Clique duas vezes em Datasheet View para abrir planilhas Tags, usadas para criar ou modificar tags para sua aplicação.

• Abra uma pasta Tag List ou Member List e clique duas vezes em quaisquer nomes de tags existents para abrir um diálogo Properties. Pode-se também utilizar os parâmetros nesse diálogo para modificar as propriedades de tags já existentes.

Para modificar uma conta Security existente, abra a pasta Groups ou Users e clique duas vezes em um grupo ou nome de usuário. Quando aparecer o diálogo Group Account/User Account, utilize os parâmetros do diálogo para alterar as propriedades da conta existente.


InduSoft Web Studio

Página 56

Notas: Capítulo 5: Trabalhando com Tags fornece instruções para criar e editar tags no banco de dados de Tags do IWS.

Capítulo 11: Configurando um Sistema de Segurança fornece instruções para configurar um sistema de segurança para sua aplicação.

Tab Graphics

Selecione o tab Graphics para acessar todas as telas, páginas da web, objetos da biblioteca, e símbolos da Aplicação.

Esse tab contém as seguintes pastas:

• Screens: Contém todas as telas de exibição criadas para a aplicação atual.

• Group Screen: Contém todos os grupos telas (individuais combinadas a grupos gerenciáveis) criadas para a aplicação atual (Note: Grupos de tela não estão disponíveis para Windows CE.)

• Web Pages: Contém todas as web pages (telas salvas em formato HTML) criadas para a aplicação.

• Symbols: Contém todos os símbolos de um usuário definido, os quais podem ser grupos de imagens e/ou textos. Pode-se criar símbolos customizados para a aplicação e salvá-los nessa pasta.

• Graphics Script: Essa interface pode ser utilizada para executar lógicas nos eventos das telas.

• Essa interface pode ser utilizada para executar lógicas nos eventos

• Library: Contém uma biblioteca de símbolos comuns e gráficos fornecidos juntamente ao InduSoft Web Studio. Clique duas vezes no Botão Library para abrir a utilidade Symbol Library do IWS, que consiste de um painel de lista (contendo todos os grupos de símbolos) e uma tela de exibição.

• Layout: Esta interface indica todas as telas atualmente abertas no Screen Editor e permite a visualização das telas em runtime.

Para abrir a tela Web page ou símbolo para edição, clique duas vezes no Botão apropriado.

Nota: Instruções específicas para edição de telas, Web pages, ou símbolos são fornecidas mais adiante nesse capítulo (“Utilizando o Editor de Tela/Planilha” na página 59) e no Capítulo 7: “Configurando Telas e Gráficos”.


InduSoft Web Studio

Página 57

Tab Tasks

Selecione o tab Tasks para acessar todas as planilhas de tarefas da aplicação atual. Esse tab contém as seguintes pastas de tarefas:

• Alarms: Contém as planilhas Alarm utilizadas para configurar grupos de alarme e tags relacionados a cada grupo de alarme da Aplicação. Pode-se também utilizar a tarefa Alarm para definer as mensagens de alarme geradas pelo IWS.

• Trend: Contém as planilhas Trend utilizadas para configurar grupos históricos que armazenam curvas de tendência para a Aplicação. Pode-se utilizar a tarefa Trend para declarer quais tags devem ter seus valores armazenados em disco, e também para a criação de arquivos históricos para gráficos de tendência. O IWS armazena as amostras em um arquivo histórico binário (*.hst), e exibe ambos em amostras históricas e on-line em uma tela gráfica de tendência.

• Recipes: Contém as planilhas Recipe utilizadas para configurar como os dados são trocados entre o banco de dados da aplicação e os arquivos de disco em formato ASCII ou DBF, e como os valores são transferidos entre arquivos e memória em tempo real.

• Reports: Contém as planilhas Report utilizadas para configurar relatórios (tipo texto) que são enviados para uma impressora ou disco. Tarefas de relatório permitem a configuração de relatórios de texto com dados do sistema, os quais fazem a criação de relatórios com maior facilidade e eficiência.

• ODBC: Contém as planilhas ODBC utilizadas para configurar como a interface ODBC rodará em um ambiente de rede de trabalho. Também utilize configuração padrão Windows ODBC. Pode-se configurar tarefas ODBC para troca de dados entre o IWS e qualquer banco de dados suportem a interface ODBC.

• Math: Contém planilhas Math utilizadas para configurar e implementar métodos de trabalho adicionais a diferentes tarefas do IWS. O IWS executa planilhas Math como Background Tasks durante o runtime. Pode-se configurar planilhas Math para fornecer ambientes livres para cálculos matemáticos e tarefas lógicas requisitadas pela Aplicação.

• Script: Contém as planilhas Script utilizadas para configurar e implementar rotinas adicionais para trabalhar com diferentes tarefas do IWS. O IWS executa planilhas Scipt como Background Tasks durante o runtime. Esta relação é útil para inicializar variáveis ou executar lógicas que devem ser executadas quando a aplicação estiver iniciandoContém planilhas

• Scheduler: Contém planilhas Scheduler utilizadas para configurar eventos utilizando expressões matemáticas definidas, executadas de acordo com período, data ou outros eventos monitorados.

Para abrir as planilhas Task para edição, clique duas vezes no Botão task, e a planilha exibirá a janela Screen/Display.

Nota: Instruções detalhadas para edição de planilhas são fornecidas no Capítulo 8: Configurando Planilhas Task.


InduSoft Web Studio

Página 58

Tab Communications

Selecione o tab Communications para acessar todos os drivers configurados para a sua Aplicação. Drivers são utilizados para estabelecer comunicação com outros equipamentos ou programas de software utilizando protocolos disponíveis.


• Drivers: Coném as planilhas Driver utilizadas para configurar uma interface(s) de comunicação entre a aplicação do projeto e o equipamento remoto (como um PLC ou transmissores).

Communication driver é um arquivo .dll que contém informações específicas a respeito de equipamentos remotos, além de implementar o protocolo de comunicação.

• OPC: Contém planilhas OPC utilizadas para configurar interfaces OPC entre a Aplicação e um OPC. Um módulo OPC Client do InduSoft Web Studio capacita o sistema do IWS a comunicar-se com qualquer equipamento que implemente um OPC Server, pela implementação de um OPC padrão, tarefa descrita no documento OLE for Process Control Data Access Standard Version 2.0, publicado pela OPC Foundation.

• TCP/IP: Contém planilhas TCP/IP utilizadas para configurar interfaces TCP/IP Client para outras estações InduSoft.

Módulos TCP/IP Client e Server do IWS habilitam duas ou mais aplicações para manter seus bancos de dados sincronizados, através da utilização do protocolo TCP/IP para prover comunicação entre aplicações.

• DDE: Contém planilhas DDE utilizadas para configurar um DDE Client para uma aplicação DDE Server (como Microsoft Excel ou qualquer outro programa do Windows que suporte essa interface).

DDE (Dynamic Data Exchange) é um protocolo que permite troca de dados dinâmicos entre aplicações do Windows. Uma conversação DDE é uma interação entre aplicações do servidor e cliente. O IWS prove interfaces que rodam como clientes ou servidores.

Nota: Por padrão, o módulo DDE Client do IWS suporta DDE Servers que acomodem dados de string em formato UNICODE. Caso o DDE Server acomode dados de string em formato ASCII ANSI, os seguintes parâmetros devem ser configurados manualmente no arquivo <AplicaçãoName>.APP (você pode utilizar o Notepad para editar Esse arquivo):

[Options]

DDEANSI=1

Para abrir planilhas nas pastas Drivers, OPC, TCP/IP, ou DDE para edição, clique duas vezes na planilha, e essa exibirá a janela Screen/Worksheet.

Nota: Instruções detalhadas para editar planilhas de comunicação são fornecidas no Capítulo 10: Comunicação.


InduSoft Web Studio

Página 59

Utilizando o Editor Tela/Planilha

Utilize o editor de tela orientado pelo objeto para criar e editar uma variedade de telas e planilhas para suas aplicações. Você poderá inserir informações utilizando seu mouse e teclado, retirar dados de controle para seus processos e atualizar automaticamente telas baseadas e entrada de dados a partir de seus processos.

Outros recursos do editor de tela incluem:

• Simple point-and-Clique, drag-and-drop interface

• Agrupar objetos para preserver os passos da construção de objetos individuais

• Editar objetos sem a necessidade de desagrupar componentes internos do objeto ou grupos

• Acomodar objetos e backgrounds de bitmaps

• Suportar linhas de Status em diálogos e janelas da aplicação

Editor Screen/Workspace

As barras de ferramentas a seguir contêm ferramentas de propósito geral que permitem a execução de diferentes tarefas juntamente ao programa.

• Barra de Ferramentas Standard: Fornece ícones (atalhos) que duplicam a funcionalidade, encontrados nos menus File, Edit, e View.

Barra de Ferramentas Standard

Botão New ( ): Clique para abrir o diálogo New e criar novas aplicações (projetos) ou arquivos como parte de sua aplicação.


InduSoft Web Studio

Página 60

Nota: Utilizar o Botão New é o mesmo que selecionar File → New da barra de menu ou digitar a combinação de teclas Ctrl+N.

Botão Open Project ( ): Clique para localizar e abrir uma Aplicação do InduSoft Web Studio.

Nota: Utilizar o ícone Open Project é o mesmo que selecionar File → Open Project da barra de menu ou abrir a pasta InduSoft Web Studio do Windows Explorer e clicar duas vezes no nome do projeto.

Botão Save ( ): Clque para salvar quaisquer telas ou planilhas ativas.

Nota: Utilizar o ícone Save é o mesmo que selecionar File → Save da barra de menu ou digitar a combinação de teclas Ctrl+S.

A função Save torna-se disponível somente quando você modifica o arquivo ativo.

Botão Save All ( ): Clique para salvar todas as telas ou planilhas abertas.

Nota: Utilizar o ícone Save All é o mesmo que selecionar File → Save All da barra de menu.

A função Save All torna-se disponível somente quando você modifica uma tela ou planilha.

Botão Cut ( ): Clique para remover um objeto selecionado da planilha/tela e armazená-lo n área de transferência, substituindo quaisquer seleções anteriores que estejam na área de transferência. Ustilize-o em combinação com o Botão Paste.

Nota: Utilizar o ícone Cut é o mesmo que selecionar Edit → Cut da barra de menu ou digitar a combinação de teclas Ctrl + X.

Botão Paste ( ): Clique para substituir os conteúdos da área de transferência para o canto esquerdo e acima da tela ativa. Pode-se Paste um objeto ou cópia múltiplas vezes em várias planilhas/telas.

Nota: Utilizar o ícone Paste é o mesmo que selecionar Edit → Paste da barra de menu ou digitar a combinação de teclas Ctrl + V.

Botão Copy ( ): Clique para duplicar um objeto selecionado e armazená-lo na área de transferência. Pode-se utilizar o Botão Paste para mover o objeto copiado para outro local na mesma ou em diferentes telas.


InduSoft Web Studio

Página 61

Nota: Utilizar o ícone Copy é o mesmo que selecionar Edit → Copy da barra de menu ou digitar a combinação de teclas Ctrl+C.

Botão Delete ( ): Clique para deletar a seleção. Caso você delete acidentalmente um objeto, Pode-se restaurá-lo utilizando o Botão Undo.

Note: Utilizar o ícone Delete é o mesmo que selecionar Edit → Delete da barra de menu ou digitar a combinação de teclas Ctrl+X.

Botão Undo ( ): Clique para cancelar a última ação executada ao trabalhar na planilha ou tela. Pode-se cancelar até 20 ações feitas antes da última ação. As ações em propriedades do objeto não ampliam a sequencia do Botão Undo.

Nota: Utilizar o ícone Undo é o mesmo que selecionar Edit → Undo da barra de menu ou digitar a combinação de teclas Ctrl+Z.

Botão Print ( ): Clique para imprimir a tela ou planilha ativa ou especificar propriedades impressora /impressão.

Nota: Utilizar o ícone Print é o mesmo que selecionar File → Print da barra de menu ou digitar a combinação de teclas Ctrl+P.

Botão Workspace Window ( ): Inverter para exibir (abrir) ou remover (fechar) a janela Workspace.

Nota: Utilizar o ícone Workspace Window é o mesmo que selecionar View → Toolbars → Workspace da barra de menu ou digitar a combinação de teclas Alt+ 0.

Botão Output Window ( ): Inverter para exibir (abrir) ou remover (fechar) a janela Output.

Notas: Utilizar o ícone Output Window é o mesmo que selecionar View → Toolbars → Output da barra de menu ou digitar a combinação de teclas Altl+1.

Veja também “Utilizando a Janela Output” na página 70.

Botão Database Spy Window ( ): Inverter para exibir (abrir) ou remover (fechar) a janela Database Spy.


InduSoft Web Studio

Página 62

Notas: Utilizar o ícone Database Spy Window é o mesmo que selecionar View → Toolbars → Database Spy da barra de menu ou digitar a combinação de teclas Alt+2.

Veja também “Utilizando o ícone Database Spy” na página 69.

Botão Library ( ): Clique para abrir a biblioteca dos objetos previamente configurados.

Nota: Utilizar o ícone Library é o mesmo que selecionar View → Library da barra de menu ou digitar a combinação de teclas Ctrl+A.

Veja também Capítulo 7: Configurando Telas e Gráficos.

Botão Layout ( ): Essa interface exibe todas as telas atualmente abertas no Editor de Telas, e permite: • Modificar Screen Attributes: Clique com o Botão direito na tela exibida no tab Layout e utilize

as opções de alinhamento ou o link Screen Attributes para modificar a posição da tela. Pode-se também clicar e arrastar a tela para alterar sua posição (Acima e à Esquerda) ou redimensioná-la (Largura e Altura).

• Visualizar como as telas apresentam-se juntas durante o runtime. Essa opção é especialmente útil ao criar telas de diálogo/pop-up ou grupos de telas.

Nota: As telas abrem o tab Layout de acordo com a ordem que essas telas são abertas no ambiente de desenvolvimento. Ao alterar a posição de tabs das telas no ambiente de desenvolvimento (da esquerda para a direita), voê modificará a ordem na qual essas telas serão exibidas no tab Layout.

Dica:

Clique com o Botão direito no tab Layout para exibir a opção para habilitar/desabilitar o Auto Scale. Caso você habilite essa opção, as telas serão automaticamente auto-escalonadas para acomadarem-se no tab Layout.

Botão Zoom ( ): Clique para alterar o cursor para o modo zoom. Clique e arraste o mouse na tela para selecionar a área onde você deseja efetuar o zoom. Clique com o Botão direito na tela para alterar o cursor para o modo de seleção novamente.

combo-box Zoom ( ): Seleciona a escala de zoom desejada.

Botão Context Sensitive Help ( ): Clique nesse Botão e depois clique na área onde você deseja ler as informações de ajuda.

• Barra de ferramentas Tag Properties: Fornece uma caixa de texto e vários ícones (atalhos) que habilitam a criação, localização, e acesso a diferentes tags, funções e propriedades do tag.

Barra de Ferramentas Tag Properties


InduSoft Web Studio

Página 63

text box Tagname ( ): Digite um nome na caixa de texto para criar um novo tag para sua aplicação. Os botões Cross Reference e Tag Properties irão referenciar esse nome do tag para suas ações.

Botão Object Finder ( ): Clique para abrir o diálogo Object Finder, o qual lista todos os Tags e Funções atualmente configuradas para essa aplicação. Veja “Utilizando o ícone Object Finder” na página 85.

Botão Cross Reference ( ): Clque para pesquisar todas as telas e planilhas da aplicação para o tag anotado no text box Tagname. Essa função escreve um log, detalhando todas as ocorrências do tag para o tab XRef na janela Output. Veja “Utilizando a opção X-ref” na página 86.

Botão Tag Properties ( ): Clique para configurar parâmetros para cada tag. O diálogo Tag Properties é exibido de forma que você possa especificar Esses parâmetros. (Para maaiores informações sobre a especificação de propriedades do tag, veja “Propriedades de Configuração do Tag” no Capítulo 5. Trabalhando com Tags.)

Botão Global Tags Replace ( ): Permite a substituição de qualquer tag(s) de todos os documentos (telas e planilhas) de toda a aplicação. Pode-se editar tanto a coluna From aquanto a coluna To.

• Barra de Ferramentas Execution Control: Permite a execução e gerenciamento de uma aplicação localmente ou de um local remoto.

Barra de ferramentas Execution Control

Botão Test Display ( ): Ativa o modo de exibição teste, o qual permite a configuração da aplicação ao mesmo tempo que visualize-se dinâmicos gráficos online no ambiente de desenvolvimento. O modo de exibição teste não habilita a utilização de Command, dinâmicos de entrada Text I/O, ou execução de planilhas.

Botão Stop display test ( ): Pára o modo de exibição teste.

Botão Run Aplicação ( ): Atualiza os módulos de runtime especificados como Automatic no diálogo Project Status (tab Execution Tasks).

Botão Stop Aplicação ( ): Pára todas as taretas de runtime.

Botão Send project to target ( ): Permite o envio da aplicação para a target station remota.

Botão Execution Environment ( ): Permite o gerenciamento de estações de trabalho remotas.

Nota: Para maiores informações, veja o Capítulo 12: Testando e Corrigindo Erros em Sua Aplicação e Capítulo 14: Gerenciando Aplicações Remotamente..

• Barra de Ferramentas Web: Permite abrir e navegar em arquivos HTML.

Barra de Ferramentas Web


InduSoft Web Studio

Página 64

Nota:

Deve-se instalar o Internet Explorer v4.1 (ou versão mais atual) antes de poder utilizar qualquer uma das ferramentas da barra de ferramentas Web. Veja Capítulo 7: Configurando Telas e Gráficos, e Capítulo 13: Configurando a Web Solution para maiores informações.

Botão Back ( ): Clique para retornar ao último endereço de URL aberto no ambiente de desenvolvimento.

Botão Forward ( ): Clique para retornar ao endereço URL aberto anteriormente, clicando no Botão Back no ambiente de desenvolvimento.

Botão Stop ( ): Clique para cancelar o processo de download de arquivos de um endereço URL específico.

Botão Refresh ( ): Clique para recarregar o endereçoURL especificado no text box Address.

Botão Home ( ): Clique para abrir a Home Page configurada em seu browser Internet Explorer Web.

text box Address ( ): Digite o endereço URL de uma Web page no text box para abrir (fazer download) essa página para seu browser Internet Explorer.

Botão Go ( ): Clique para fazer downloads de páginas específicas no text box Address.

• Barra de Ferramentas Align and Distribute: Permite a edição de objetos de telas. Pode-se redimensionar, alinhar, flip, rotear, dar espaço em objetos de grupo.

Barra de Ferramentas Align and Distribution

Nota: Veja “Utilizando a Barra de Ferramentas Align e Distribute” na página 187 no “Capítulo 7: Configurando Telas e Gráficos” para descrição detalhada e exemplos desses botões.

Botão Resize height ( ): Clique para configurar a altura de todos os objetos selecionados para a mesma a qual foi selecionada para o último objeto (objeto com handles preenchidos). Pode-se utilizar Resize height para redimensionar um objeto, configurando sua altura e largura.


InduSoft Web Studio

Página 65

Botão Resize width ( ): Clique para configurar a largura de todos os objetos selecionados, a mesma do último objeto (objeto com handles preenchidos). Pode-se utilizar Resize width para redimensionar um objeto selecionado utilizando a largura e altura.

Botão Align left ( ): Clique para alinhar todos os objetos selecionados à esquerda do último objeto selecionado.

Botão Align right ( ): Clique para alinhar todos os objetos selecionados à direita do último objeto selecionado.

Botão Align top ( ): Clique para alinhar todos os objetos selecionados acima do último objeto selecionado.

Botão Align bottom ( ): Clique para alinhar todos os objetos selecionados na parte inferior do último objeto selecionado.

Botão Center vertically ( ): Clique para alinhar todos os objetos selecionados ao centro e verticalmente do último objeto selecionado.

Botão Center horizontally ( ): Clique para alinhar todos os objetos selecionados ao centro e horizontalmente ao último objeto selecionado.

Botão Evenly space horizontally ( ): Clique para colocar uma quantia equivalente de espaços horizontais entre uma série de objetos (dois ou mais).

Botão Evenly space vertically ( ): Clique para colocar uma quantia equivalente de espaços verticais entre uma série de objetos (dois ou mais).

Botão Flip horizontally ( ): Clique para inverter o objeto selecionado horizontalmente. O objeto move-se através de uma linha imaginária central até que seja uma imagem espelho do objeto original.

Botão Flip vertically ( ): Clique para inverter o objeto selecionado verticalmente. O objeto move-se através de uma linha imaginária central até que seja uma imagem espelho do objeto original.

Botão Rotate ( ): Clique para rotear o objeto selecionado a 90 graus (um quarto de volta) .

Botão Move to back ( ): Clique para mover um objeto(s) para baixo de outros objetos na tela. O IWS assina o mais baixo ID# para o objeto e move o objeto para baixo de outros objetos na tela.

Botão Move to front ( ): Clique para mover um objeto(s) selecionado para afrente de todos os outros objetos na tela. O IWS assina o maior ID# para o objeto, de modo que Esse move-se para trás de todos os objetos na tela.

Botão Group ( ): Clique para combinar múltiplos objetos em um único objeto para assim facilitar a seleção e manipulação de objetos. (Pode-se acessar cada parte de um grupo no diálogo Object Properties.)

Botão Ungroup ( ): Clique para separar um objeto agrupado em seus componentes individuais.

A barra de ferramentas a seguir contém ferramentas de edição de tela. Tais barras de ferramentas estão localizadas ao longo do lado direito da janela da interface por padrão, e são habilitadas somente ao editar telas gráficas:

• Barra de Ferramentas Mode: Permite a edição de suas telas.


InduSoft Web Studio

Página 66

Barra de Ferramentas Mode

Nota: Veja “Utilizando a Barra de Ferramentas Mode” na página 185 no Capítulo 7: Configurando Telas e Gráficos para uma descrição mais detalhada.

Botão Selection ( ): Clique para exibir um cursor que permitirá selecionar e mover objetos na tela.

Botão Bitmap Editor ( ): Clique para alternar entre as duas camadas básicas de edição (Objects layer e Background Picture layer).

Botão Fill Color ( ): Clique para especificar uma coloração padrão para Polígonos fechados, elipses, retangulos arredondados e retângulos.

Botão Fonts ( ): Clique para especificar a fonte e coloração de objetos de texto selecionados ou para especificar umas fonte padrão e coloração para objetos novos.

Botão Line Color ( ): Clique para especificar uma linha para objetos selecionados ou para configurar uma coloração padrão para novos objetos.

Botão Background Color ( ): Clique para especificar uma coloração de fundo para a tela.

Botão Grid ( ): Clique para especificar se é desejado mostrar ou ocultar o grid no editor de tela.

• Barra de Ferramentas Static Objects: Permite a criação de polígonos, retângulos, linhas, e outros objetos para sua tela.

Barra de Ferramentas Static Objects

Nota: Veja “Utilizando a barra de ferramentas Static Objects” na página 198 no Capítulo 7: Configurando Telas e Gráficos para uma descrição mais detalhada.

Botão Open Polygon ( ): Clique para desenhar um polígono aberto com uma moldura na coloração de fundo especificada.

Botão Closed Polygon ( ): Clique para desenhar um polígono fechado, utilizando uma coloração de moldura especificada.

Botão Line ( ): Clique para desenhar uma linha ortogonal na área de desenho.

Botão Ellipse ( ): Clique para desenhar elipses, cordas, arcos e círculos.

Botão Rounded Rectangle ( ): Clique para desenhar retângulos arredondados (vazios ou preenchidos).

Botão Rectangle ( ): Clique para criar retângulos.

Botão Botão ( ): Clique para criar botões para redimensionamento customizado.


InduSoft Web Studio

Página 67

Botão Text ( ): Clique para criar objetos de texto.

• Barra de Ferramentas Active Objects: Permite a criação de objetos dinâmicos que tipicamente requisitam mais parâmetros do que objetos estáticos. Também fornece dinâmicos embutidos.

Barra de Ferramentas Active Objects

Nota: Veja “Utilizando a Barra de Ferramentas Active Objects” na página 214 no Capítulo 7: Configurando Telas e Gráficos para uma descrição mais detalhada, além de exemplos.

Botão Alarm/Event Control Object ( ): Clique para adicionar um Objeto de Controle Alarme/Evento na sua tela da aplicação.

Botão Trend Control ( ): Clique para exibir pontos de dados (valores) a partir de diferentes fontes de dados em um formato gráfico.

Botão Trend ( ): Clique para selecionar uma área na tela na qual serão exibidas as curvas de tendencias dos dados do tag.

Botão List Box Object ( ): Clique para criar um box de lista em sua tela. Geralmente, ao executar uma aplicação, o box do objeto de lista active exibe uma lista de mensagens.

Botão Smart Message Objects ( ): Clque para criar um ou mais objetos de mensagens, nos quais você poderá exbir mensagens e gráficos ao executar a aplicação.

Botão PushButton ( ): Clique para criar um objeto pushButton utilizando o ícone das propriedades do objeto dinâmico Command com um objeto ou pushBotãos pré-configurados.

Botão ActiveX Control ( ): Clique para abrir o diálogo Insert ActiveX Control. Você poderá utilizar os componentes ActiveX desse diálogo em sua tela.

Botão .NET Control Object ( ): Clique para abrir o diálogo .NET Framework Components. Você poderá utilizar os componentes .NET desse diálogo em sua tela.

Botão Combo-Box ( ): Clique para selecionar uma marca única de uma lista de marcas em um combo-box.

Botão Alarm ( ): Clique para especificar uma área na tela onde exibir mensagens de alarme.

Botão Grid ( ): Clique para especificar uma área na tela para criar um novo objeto Grid.

Botão Check Box Botão ( ): Clique para criar um objeto check-box na tela.

Radio Botão ( ): Clique para criar um objeto radio Botão na tela.

• Barra de Ferramentas Dynamic Properties: Permite a aplicação de dinâmicos para objetos ou grupos de objetos. Dinâmicos permitem a modificação de propriedades do objeto em “fly” (durante o runtime) de acordo com os valores do tag. Alguns dinâmicos também permitem a execução de comandos e inserção de valores (set points) para os tags.


InduSoft Web Studio

Página 68

Barra de Ferramentas Dynamic Properties

Nota: Veja “Utilizando a Barra de Ferramentas Dynamic Properties ” na página 204 no Capítulo 7: Configurando Telas e Gráficos para uma descrição mais detalhada.

Botão Command ( ): Clique para adicionar a propriedade de comando para um objeto ou grupo de objetos selecionados. A propriedade de comando permite clicar no objeto ou pressionar uma tecla pré-definida para executar o comando durante o runtime.

Botão Hyperlink ( ): Clique para adicionar uma propriedade hyperlink para um objeto ou grupo de objetos selecionados. Aplicar essa propriedade permite clicar nesse objeto(s) durante a execução do runtime para iniciar o browser padrão e carregar a URL especificada.

Botão Bargraph ( ): Clique para adicionar propriedades gráficas para um objeto selecionado, e depois clique duas vezes no objeto para abrir o diálogo Object Properties.

Botão Text I/O ( ): Clique para adicionar uma propriedade de texto de entrada e saída para um objeto de texto selecionado. Aplicar a propriedade Text I/O permite a inserção e exibição de valores de tag em tempo real ao utilizar um ícone do teclado ou um keypad da tela para rodar a aplicação.

Botão Colors ( ): Clique para adicionar a propriedade para troca de cores a um objeto selecionado. O dinâmico Colors permite a especificação de até quarto cores em Change Limit.

Botão Position ( ): Clique para especificar quando e onde exibir um objeto, utilizando os valores de tag especificados no ícone.

Botão Resize ( ): Clique para aumentar ou diminuir o tamanho de um objeto selecionado ou símbolo.

Botão Dynamic Rotation ( ): Clique para rotear uma linha.

• Barra de Ferramentas Bitmap: Permite acesso a ferramentas do editor de tela bitmap. (Essa ferramenta está disponível somente quando a camada Background Picture layer está ativa. Pode-se habilitar a camada Background Picture no diálogo Screen Attributes.)

Barra de Ferramentas Bitmap

Note:

A Barra de Ferramentas Bitmap está oculta por padrão.

Veja “Utilizando a Barra de Ferramentas Bitmap ” na página 197 no Capítulo 7: Configurando Telas e Gráficos para uma descrição mais detalhada.

Botão Select Área ( ): Clique para selecionar uma área junto ao Bitmap Screen Editor.

Botão Flood Fill ( ): Clique no Botão Flood Fill e depois clique na tela para pintar a área ao redor com a coloração especificada com a utilização do Botão Fill Color.


InduSoft Web Studio

Página 69

Botão Pixel Editing ( ): Clique para abrir um diálogo Edit Image, onde é possível desenhar bitmaps detalhados, pixel por pixel.

Botão Erase Área ( ): Clique para apagar uma área selecionada da tela.

Botão Change Colors ( ): Clique para tornar transparente uma área selecionada da tela.

Nota: Antes de utilizar Esse Botão, já deve estar especificada cor de preenchimento (Botão Fill Color), selecionado a cor “transparente” (Botão Select Transparent Color), e definido a área de preenchimento (Botão Select Área).

Botão Select Transparent Color ( ): Clique para especificar uma coloração transparente (no Botão Change Colors).

Botão Inverter Transparent Color ( ): Clique para aplicar a cor selecionada utilizando o Botão Select Transparent Color para tornar os bitmaps (selecionados em Bitmap Screen Editor) transparentes.

Utilizando o ícone Database Spy

A janela Database Spy (localizada abaixo do Workspace por padrão) é uma ferramenta de correção de erros do IWS que permite:

• Monitorar e enviar valores para o banco de dados de tags

• Executar e testar funções

• Executar e testar expressões algorítmicas

Exemplo da janela Database Spy

A janela Database Spy consiste dos seguintes elementos:

• Botão Hide Docked Window ( ): Clique para inverter entre janela aberta e fechada. (De froma

alternativa, Pode-se utilizar o Botão no menu View → Toolbars ou Alt+2 para abrir e fechar essa janela.)

• Botão Contract/Expand ( ): Clique para inverter entre contrair e expandir a janela Database Spy.

• DB tabs: Clique em cada tab para acessar um spreadsheet com os seguintes componentes:

Name: Exibe nomes de tags, nomes de funções e equações.


InduSoft Web Studio

Página 70

Value: Exibe valores de retorno e resultados de equações.

Quality: Exibe uma avaliação de qualidade (Good ou Bad) da origem do tag ou função.

Continuous: Exibe se o IWS está reavaliando o tag, função ou equação de forma contínua.

• Scroll bars: Utilize para visualizar áreas da Database Spy que estão difíceis de vizualizar por causa do tamanho tanto da janela quanto da planilha atual.

Notas: O Database Spy é é reposicionável, o que significa que você pode move-lo para outro local no ambiente de desenvolvimento. Clique na barra de título e arraste-o para o novo local. Solte o Botão do mouse para anexar ou reposicionar a janela em seu novo local.

Instruções detalhadas sobre como utilizar o ícone Database Spy são fornecidas no Capítulo 12: Testando e Corrigindo Erros da Aplicação.

Utilizando a Janela Output A janela Output (localizada próxima ao Database Spy por padrão) é outra ferramenta de correção de erros do IWS, similar quanto às funções ao módulo LogWin.

Exemplo de Janela Output

Embora funcione em uma escala menor do que a do LogWin, a janela Output habilita o monitoramento dos componentes de sua aplicação diretamente a partir do ambiente de desenvolvimento. (Para uma descrição detalhada do módulo LogWin, veja o Capítulo 12: Testando e Corrigindo Erros na sua Aplicação.)

A janela Output contém os seguintes elementos:

• tab Log: Utilize Esse tab para coletar dados e monitorar a saída de um ou mais dos seguintes componentes:

Field Read/Write commands

Serial communication

DDE, OPC e TCP/IP messages and transactions

Recipes/Reports

Display Open/Close

Logons/Logouts


InduSoft Web Studio

Página 71

Trace messages

Database messages

Insert dates/times

Tags

Esse recurso loga seus dados em bases first-in, first-out (FIFO) para salvar espaço e memória, além de permitir a pausa na coleta de dados, a fim de revisar os resultados.

• tab XRef: Utilize Esse tab para perquisar e exibir o local (caminho, nome do arquivo, coluna e linha) de cada exemplo onde um tag específico está sendo utilizado junto a sua aplicação. (Veja também “Utilizando a opção X-ref” na página 86.)

• Botão Hide Docked Window ( ): Clique para abrir ou fechar a janela.

De forma alternativa, Pode-se selecionar View → Toolbars da barra de menu e clicar no Botão ou pressionar Alt+1 para abrir/fechar a janela.

• Botão Contract/Expand ( ): Clique para contrair e expandir a janela Output.

• Scroll Bars: Clique e arraste para visualizar áreas da janela Output que estão ocultas por causa do tamanho ou largura de seus dados.

Notas: A janela Output é reposicionável, o que significa que você pode movê-lo para outro local no ambiente de desenvolvimento. Clique na barra de título e arraste a janela para sua nova localização. Solte o Botão do mouse para anexar e reposicioná-lo para sua nova localização.

Instruções detalhadas sobre como utilizar a janela Output são fornecidas no Capítulo 12: Testando Corrigindo Erros na sua Aplicação.

Utilizando o ícone Status Bar

A barra de status (localizada na parte inferior da janela do IWS) contém campos utilizados para identificar os botões da barra de ferramentas que fornecem informações sobre a tela ativa (ou qualquer tela).

Exemplo de Status Bar

Os campos aparecem como se segue (da esquerda para a direita):

• Campo Hint: Fornece uma curta descrição de qualquer Botão da barra de ferramentas, ou exibe objetos que podem ser tocados pelo cursor.

• Campo Caps Lock: Indica se a tecla Caps Lock está on (CAP) ou off (vazio).

• Campo Num Lock: Indica se a tecla Num Lock está on (NUM) ou off (vazio).

• Campo Scroll Lock: Indica se a tecla Scroll Lock está on (SCRL) ou off (vazio).

• Campo ID : Exibe o número ID de um objeto de tela selecionado.

Hint field Caps Lock field

Num Lock field

Scroll Lock field

ID field Screen Coordinate field

Object Size field

No Drag field


InduSoft Web Studio

Página 72

• Campo Screen Coordinate: Exibe a localização atual do cursor (ou apontador) na tela ativa. Onde: X é o número de pixels do limite esquerdo da tela e Y é o número de pixels do topo da tela.

• Campo Object Size: Exibe o tamanho (em pixels) de um objeto selecionado, onde W é a largura e H é altura.

• Campo No DRAG: Indica se a tarefa arrastar está desabilitada (No Drag) ou habilitada (vazio) na tela ativa. Pode-se inverter o recursos No Drag pressionado Ctrl+D.

Nota: Utilize o atalho Ctrl+D para habilitar/desabilitar o recurso No Drag ao editar a tela. Pode-se utilizar o recurso No Drag para evitar que objetos se movam na tela ao alterar suas propriedades.

Customizando o Workspace O InduSoft Web Studio permite que você customize o ambiente de desenvolvimento:

• Botão Hide Docked Window ( ): Clique para inverter entre abrir e fechar a janela. (De forma

alternativa, Pode-se utilizar o Botão no menu View → Toolbars ou Alt+2 para abrir e fechar essa janela.)

• Botão Contract/Expand ( ): Clique para inverter entre contrair e expandir a janela Database Spy.

Interfaces Padrão As interfaces padrão discutidas nessa seção consistem de interfaces básicas que são utilizadas frequentemente à medida que se trabalha no ambiente de desenvolvimento do InduSoft Web Studio. Elas incluem:

• Virtual Keyboard

• Fonts

• Color Interface

Virtual Keyboard

O Virtual Keyboard (VK) do IWS permite ao usuário a inserção de dados (texto ou números) durante o runtime utilizando-se de um equipamento touch-screen, em vez de um teclado físico.

Pode-se habilitar o VK para sua Aplicação no diálogo Runtime Desktop (Project->Settings->Runtime Desktop). Pode-se designar um Virtual Keyboard padrão, bem como aplicar uma Escala (tamanho) para todos os Virtual Keyboards durante o runtime.

Ao configurar os objetos e dinâmicos que suportem dados de entrada, Pode-se assinar um VK do objeto pelo combo-box do VK (padrão ou específico). Estão disponíveis os seguintes VKs padrões:

Nome Figura Descrição

AlphaNumeric

Esse VK é utilizado para inserir valores alfanuméricos (caracteres e/ou números).


InduSoft Web Studio

Página 73

EnhKeypad

Esse VK é utilzado para inserir valores alfanuméricos (caracteres e/ou números) em equipamentos que forneçam uma pequena tela (e.x. PDAs). O Botão -> permite que os usuários naveguem através de diferentes painéis até encontrar o caractere desejado.

Keypad

Esse VK é utilizado para inserir valores numéricos (somente números).

Existem dois meios para se chegar ao VK durante o runtime:

• Clicar no objeto onde um novo valor (dados) pode ser inserido (e.x. Texto com dinâmico de texto I/O configurado com Input Enabled-entrada habilitada).

• Executar a função built-in Keypad().

• Pode-se alterar o idioma do Virtual Keyboard através da função built-in SetKeyboardLanguage().

Dicas: Pode-se cirar novos idiomas para qualquer Virtual Keyboard editando o arquivo VK<Language>.INI na sub-spasta \BIN do IWS, onde <Language> é a marca da linguagem para VKs (e.x. VKEN.INI = Virtual Keyboards em Inglês; VKGE= Virtual Keyboards em Alemão, etc). Consulte seu fornecedor do software para maiores informações sobre como editar e configurar Esse arquivo.

Por padrão, o VK é encontrado perto do objeto na tela a ele associado. Porém, Pode-se configurar os seguintes parâmetros no arquivo <AplicaçãoName>.APP, de forma que o VK sempre estará aberto em uma posição fixa:

[Keypad]

PosX=0 //Coordenada (em pixels) TOP onde o VK deve estar localizado.

PosY=0 //Coordenada (em pixels) LEFT onde o VK deve estar localizado.

Fontes

O IWS suporta qualquer fonte UNICODE disponível para sistema operacional onde o IWS esteja rodando. Portanto, é possivel configurar interfaces com a utilização de caracteres de idiomas que não utilizem caracteres ocidentais de linguagem, como Japonês, Chinês, Árabe, Cirílico, etc.

A fonte utilizada no ambiente de desenvolvimento do IWS (Planilhas, Diálogos, etc.) é a fonte padrão instalada no ambiente de desenvolvimento e depende do idioma do sistema operacional. Clique na opção de menu Edit → Set Font para selecionar uma fonte distinta para o desenvolvimento.


InduSoft Web Studio

Página 74

Ao editar objetos que exibam texto durante o runtime, Pode-se configurar a fonte na qual o texto aparecerá clicando no Botão Fonts na janela Object Properties. O Botão Font abre o diálogo padrão Font:

Diálogo Font

Pode-se configurar o nome da fonte, estilo, tamanho, efeitos e script.

Dica: Pode-se alterar o estilo da fonte de vários objetos simultaneamente, selecionando-os (Precione shift enquanto cliquar em cada um), e clicando no ícone Fonts na barra de ferramentas Mode do editor de tela.

O ícone exibido à esquerda do nome da fonte indica a tecnologia da fonte.

Ícone Tecnologia Descrição

TrueType

OpenType

Outline

Fontes TrueType e OpenType fonts são fontes que são executadas por comandos line e curve. OpenType é uma extensão deType. Ambas podem ser escalonadas e roteadas, têm boa aparência em todos os tamanhos e equiipamentos de output suportados pelo Windows.

O Windows fornece uma seleção de fontes OpenType, incluindo Arial, Courier New, Lucida Console, Times New Roman, Symbol, e Wingdings.

Type 1, do Adobe Systems, Inc., é uma fonte outline projetada para trabalhar com impressoras PostScript printers. Outlines podem ser escalonadas e roteadas. Com tecnologia aberta OpenType, o Windows suporta completamente fontes Type 1.

N/A Vector Fontes Vector são suportadas porque um número de programas são dependentes dela. São executadas a partir de um modelo


InduSoft Web Studio

Página 75

matemático, e são utilizadas primariamente com plotters. O Windows suporta três vector fonts: Modern, Roman e Script.

N/A Raster

Fontes Raster são suportadas porque um número de programas são dependentes dela.

Fontes Raster são armazenadas em arquivos como imagens bitmaps e compostas de uma série de pontos, exibidos em tela ou papel.

É recomendável que se utilize somente as fontes TrueType ou OpenType fonts. Fontes projetadas com outras tcnologias (e.x. Courier) não podem ser escalonadas de forma apropriada e podem causar danos durante o runtime.

Atenção: Ao projetar telas, as fontes que podem ser utilizadas são aquelas disponíveis no sistema operacional de sua estação de desenvolvimento. As fontes na estação de runtime, entretanto, podem aparecer diferentes (e.x. tamanho diferentes em pixels), mesmo se as configurações forem as mesmas em ambas as estações. Tal situação ocorre com maior frequencia quando as aplicações estão rodando em sistema operacional Windows CE, onde as fontes nem sempre se equivalem às proprorções das fontes do Windows NT/2K/XP. Portanto, é importante testar as interfaces gráficas (telas) na plataforma de runtime atual durante o desenvolvimeto da aplicação. Não deve-se esperar até que toda a aplicação tenha sido desenvolvida, ou sera necessário reprojetar as telas de modo que os objetos de texto sejam exibidos da maneira apropriada na plataforma de runtime.

Interface Color

Pode-se editar a cor de um componente utilizando Color interface.

Clique no ícone na barra de ferramentas:

Clique em uma das vinte cores que aparecem ao abrir o box pop-up box:

A cor selecionada sera aplicada ao componente que está sendo editado.

Clique em More Colors… caso você deseje aplicar uma cor diferente. O diálogo Colors abrirá, exibindo as 143 cores padrão de seu sistema operacional.


InduSoft Web Studio

Página 76

Diálogo Colors

Clique no tab Custom para editar os códigos HSL (Hue, Sat, Lum) ou RGB (Red, Green, Blue) de qualquer uma das 143 cores padrão, criando assim uma cor customizada.

Tab Custom Colors

Clique no Botão OK para aplicar a cor selecionada ao componente que está sendo editado.

Dependendo do componente que está sendo editado, a opção Fill Effects estará disponível na interface pop-up (veja o Segundo passo acima). Clique nessa opção para aplicar colorações graduais com diferentes estilos e variações. O diálogo Fill Effects abrirá.


InduSoft Web Studio

Página 77

Diálogo Fill Effects

Selecione duas cores nos campos Start e End, selecione Style, e clique na variante escolhida. Finalmente, clique no Botão OK para aplicar o efeito de preenchimento ao componente que está sendo editado.

Nota: Para aplicações em sistema operacional WinCE, a interface Fill Effects está disponível somente para o objeto Rectangle.

Atenção: Embora Fill Effect seja uma ferramenta útil para melhorar a aparência e sensibilidade das telas, o sistema operacional leva um tempo maior para preencher um objeto com efeitos de preenchimento do que com cores padrão. Deve-se estabelecer um critério para utilizar Esse recurso sem causar uma diminuição na performance do sistema, especialmente sob sistema operacional WinCE.

Utilizando o ícone dinâmico, , Pode-se modificar a coloração de um objeto estático durante o runtime. Ao configurar Esse dinâmico Type = By Color, Pode-se configurar a coloração que sera aplicada no objeto durante o runtime, através do código de cores. A tabela a seguir fornece os valores do código, bem como os valores RGB para as cores mais comumente utilizadas:

Código RGB Cor Nome

R (Red) G (Green) B (Blue) Valor do Código

Black 0 0 0 0 Dark Red 128 0 0 128 Red 255 0 0 255 Pink 255 0 255 16711935 Rose 255 153 204 13408767 Brown 153 51 0 13209 Orange 255 102 0 26367 Light Orange 255 153 0 39423 Gold 255 204 0 52479


InduSoft Web Studio

Página 78

Tan 255 204 153 10079487 Olive Green 51 51 0 13107 Dark Yellow 128 128 0 32896 Lime 153 204 0 52377 Yellow 255 255 0 65535 Light Yellow 255 255 153 10092543 Dark Green 0 51 0 13056 Green 0 128 0 32768 Sea Green 51 153 102 6723891 Bright Green 0 255 0 65280 Light Green 204 255 204 13434828 Dark Teal 0 51 102 7877376 Teal 0 128 128 8421376 Aqua 51 204 204 13421619

Turquoise 0 255 255 16776960 Light Turquoise 204 255 255 16777164 Dark Blue 0 0 128 8388608 Blue 0 0 255 16711680 Light Blue 51 102 255 16737843 Sky Blue 0 204 255 16737843 Pale Blue 153 204 255 16764057 Indigo 51 51 153 10040115 Blue-Gray 102 102 153 10053222 Violet 128 0 128 8388736 Plum 153 51 102 6697881 Lavender 204 153 255 16751052 Gray-80% 51 51 51 3355443 Gray-50% 128 128 128 8421504 Gray-40% 150 150 150 9868950 Gray-25% 192 192 192 12632256 White 255 255 255 16777215

Dica: As funções RGBColor() e RGBComponent() podem ser utilizadas para manipular códigos de cores durante o runtime.

Nota: O número de cores disponíveis ao desenvolver uma aplicação depende dos parâmetros de cores configurados no sistema operacional, na estação de desenvolvimento. O número de cores disponíveis ao rodar a aplicação (runtime) depende dos parâmetros configurados no sistema operacional da estação de runtime.

Tarefas Comuns de Execução As terafas comuns discutidas nessa seção consistem de procedimentos básicos que você poderá utilizar frequentemente, à medida que trabalha com o ambiente de desenvolvimento do InduSoft Web Studio. Tais tarefas incluem:

• Accessar Projetos e Arquivos

• Utilizar botões de comando

• Gerenciar Janelas do Ambiente de Desenvolvimento


InduSoft Web Studio

Página 79

• Alterar Resolução de Tela

• Utilizar menus Pop-up

• Utilizar Select All

• Cortar, Copiar e Colar Objetos

• Utilizar o ícone Symbols Library

• Encontrar informações do sistema

• Procurar tags e Objetos de tela

• Substituir tags

• Testar Exibições

• Verificar a Aplicação

• Rodar a Aplicaçãos

• Restaurar Padrões

• Salvar seu Trabalho

• Imprimir telas do projeto

Accessando Projetos e Arquivos

Para criar um novo projeto, veja o Capítulo 6: Criando e Configurando um Projeto.

Abrindo projetos

Para abrir um projeto, na barra de menu Principal, selecione File → Open Project.

Selecionar a opção Open Project exibe o diálogo Open, o qual lista todas as pastas existentes. Pode-se utilizar o diálogo Open para localizar e abrir um projeto InduSoft Web Studio.

Diálogo Open

Nota: De forma alternativa, Pode-se abrir um novo projeto utilizando um dos seguintes métodos:

Clique no Botão Open Project na barra de ferramentas Standard para exibir o diálogo Open.

Abra o Windows Explorer, localize a pasta InduSoft Web Studio, e clique duas vezes no nome do projeto.


InduSoft Web Studio

Página 80

Abrindo arquivos

Na barra de menu Principal, selecione File → Open File. Selecionar a opção Open File exibe o diálogo Open (como mostrado na seção anterior), o qual lista todas as pastas existentes. Para localizar e abrir um arquivo da aplicação do InduSoft Web Studio nesse diálogo, clique no Botão Files of type, e depois clique em um nome de arquivo para selecioná-lo a partir da lista.

Fechando projetos

Na barra de ferramentas Standard, selecione File → Save para salvar quaisquer telas ou planilhas ativas. A opção Save torna-se habilitada (ativa) somente ao modificar o arquivo ativo.

Nota:

Pode-se também utilizar o Botão Save ( ) na barra de ferramentas Standard ou digitar Ctrl+s para salvar a planilha/tela ativa.

Na barra de ferramentas Standard, selecione File → Save As para salvar telas ou planilhas ativas e especificar um novo nome e localização para esse arquivo.

Selecione a opção Save As HTML para salvar a exibição ativa em formato HTML. Pode-se também seleconar File → Save All na barra de menu para salvar todas as telas ou planilhas abertas. A opção Save All torna-se habilitada (ativa) ao modificar o arquivo ativo.

Nota:

Utilizar File → Save All é o mesmo que apertar o Botão Save All ( ) na barra de ferramentas Standard.

Selecione a opção File → Save All As HTML para salvar todas as exibições da aplicação em formato HTML. Deve-se fechar todos os documentos antes de executar esse comando.

Selecione File → Save Screen Group As HTML para salvar o Screen Group em formato HTML tornando-o disponível para Web Thin Client remoto através de um Browser da Web.

Fechando arquivos

Na barra de menu, selecione File → Close para fechar tela ou planilha ativas. O IWS requisitará salvar ou não todos as alterações não salvas antes de fechar a tela/planilha.

Nota: Utilizar File → Close é o mesmo que utilizar o Botão Exit ( ) localizado na barra de título.

Pode-se também selecionar File → Close All. Selecionar a opção Close All fecha todas as telas ou planilhas abertas. O IWS requisitará salvar ou não todos as alterações não salvas antes de fechar a tela/planilha.

Utilizando Botões Comuns

A tabela a seguir descreve botões que aparecem tipicamente no diálogo e janelas do IWS:


InduSoft Web Studio

Página 81

Botão Propósito

OK Clique nesse Botão para executar e salvar todas as alterações, e fechar o diálogo ou janela.

Apply Clique nesse Botão para executar e salvar todas as alterações, embora deixe o diálogo ou janela abertos.Esse Botão habilita a vizualização dos efeitos das suas alterações antes de fechar a janela/diálogo.

Cancel Clique nesse Botão para fechar o diálogo/janela imdiatamente (descartando quaisquer alterações).

Open Clique nesse Botão para abrir um arquivo. Geralemente, Esse Botão está associado a um combo-box ou list pane. Pode-se utilizar o combo-box ou list pane para especificar um arquivo e depois clicar no Botão Open para abrir o arquivo.

Close Clique nesse Botão para fechar o arquivo, tela diálogo, etc que estejam abertos.

Browse Clique nesse Botão para abrir um diálogo Browse para persquisar por um arquivo ou pasta que estejam abertos.

Back Clique nesse Botão para voltar a uma tela prévia em uma sequencia de telas.

Next Clique nesse Botão par ir para apróxima tela em uma sequencia de telas.

Replace Clique para abrir um diálogo Replace, que habilita a troca de tags ou strings associadas ao objeto de tela selecionado.

Remove Clique para remover um objeto selecionado (highlighted) de uma lista ou uma exibição de tela.

Tabela de Botões Comuns

Alterando a Resolução das Telas Feche para abrir todos os documentos e selecione Tools → Convert Resolution para abrir o diálogo Convert Resolution, o qual permite a alteração da resolução de sua aplicação.

Diálogo Convert Resolution


InduSoft Web Studio

Página 82

Para alterar a resolução de sua aplicação:

Clique (habilite) o radio button da resolução que você deseja utilzar para converter a Aplicação.

Clique no Botão Convert.

Clique no Botão Close para fechar o diálogo ao terminar.

Antes de converter a Aplicação para sua nova resolução, o IWS faz backup de todas as telas em seus tamanhos anteriores em um pasta Backup localizada na pasta Screen de seu diretório \<Aplicação>\. O asterisco (*) próximo à resolução denota resolução (base) atual. (Note: Ao selecionar uma nova resolução, todas as telas serão escalonadas a partir da nova base de resolução)

Utilizando Menus Pop-Up Clicando com o Botão direito em qualquer componente do Workspace, aparecerá um menu exibindo com opções relacionadas àquele componente. Por exemplo, o menu pop-up a seguir habilita Abrir o tags database da Aplicação, Insert (criar) um novo tag ou Refresh para a visualização do banco de dados de tags atual da aplicação:

Clique com o Botão direito para abrir um Menu Pop-Up

Utilizando Select All

Na barra de menu, selecione Edit → Select All para selecionar todos os objetos na tela ativa.

Cortar, Copiar, Colar Objetos

Na barra de menu, selecione Edit → Cut para remover um item selecionado da tela, e armazená-lo no clipboard do Windows (substituindo qualquer objeto selecionado anteriormente que esteja armazenado no clipboard). Pode-se utilizar Cut junto à opção File → Paste para mover um objeto para outro local na mesma tela, ou em outra tela distinta.

Nota:

Utilizar a opção de menu Cut é o mesmo que utilizar o Botão Cut localizado na barra de ferramentas Standard.

Na barra de menu, selecione Edit → Copy para duplicar um item selecionado e armazená-lo no clipboard do Windows. Utilize Copy juntamente à opção Paste para substituir um objeto copiado para outro local na mesma tela, ou em uma tela distinta. Pode-se colar um objeto copiado múltiplas vezes.

Nota:

Utilizar a opção de menu Copy é o mesmo que utilizar o Botão Copy localizado na barra de ferramentas Standard.


InduSoft Web Studio

Página 83

Na barra de menu, selecione Edit → Paste para substituir conteúdos do clipboard do Windows (objetos copiados ou cortados) para uma tela ativada. Caso o clipboard já contenha o objeto, o IWS irá colar esse objeto no canto superior esquerdo da tela. Pode-se colar um objeto recortado ou copiado múltiplas vezes.

Nota: Pode-se facilmente copiar (arrastar) itens selecionados segurando-os simultanemante com o Botão esquerdo do mouse e a tecla Ctrl.

Utilizar a opção de menu Paste é o mesmo que utilizar o Botão Paste localizado na barra de ferramentas Standard.

Pode-se selecionar Edit → Undo para desfazer a última ação executada (e até 20 ações executadas antes desta última) ao trabalhar na tela. (ações Object Properties não aumentam o número de tarefas Undo).

Nota:

Utilizar a opção de menu Undo é o mesmo que utilizar o Botão Undo localizado na barra de ferramentas Standard.

Encontrando Informações do Sistema

Na barra de menu, selecione Tools → System Information para abrir a janela System Information, a qual fornece informações a respeito de:

• System Information: Exibe detalhes a respeito de seu sistema operacional.

• Network Resources: Exibe detalhes a respeito da rede de trabalho de seu computador.

• Aplicaçãos: Lista as Aplicações rodando atualmente.

• ProcEsses: Exibe todas as tarefas do Windows que estão rodando atualmente.

• Services: Lista os serviços do Windows NT/2000 que estão sendo utilizados pelo IWS (somente Windows NT/2000).

Janela System Information


InduSoft Web Studio

Página 84

Nota: Embora você abra a janela System Information a partir do IWS, essa janela fornecerá informações gerais somente a respeito da estação local e rede de trabalho. A janela System Information não exibe informações específicas sobre a aplicação.

Pesquisando Tags - Utilizando a opção ícone Find

Selecione Edit → Find para abrir o diálogo Find, o qual permite a pesquisa de uma palavra na planilha ativa.

Diálogo Find

Digite a string do texto no text box Find What e especifique parâmetros de pesquisa clicando em uma ou mais das seguintes opções:

• Match whole word only: O IWS pesquisa somente o item especificado, não incluindo amostras onde o termo especificado é parte de uma palavra inteira. Por exemplo, especificando a palavra back, o IWS encontrará somente “back”, e não “backward”.

• Match case: O IWS pesquisa pelo termo utilizando o ícone specificado, da forma como foi escrito. Por exemplo, especificando “TankLevel”, o IWS não pesquisará por “tanklevel”.

• Direction: Controla em qual direção o IWS deve pesquisar através da planilha (Up ou Down).

Clique no Botão Find Next para iniciar a busca. (Clique no Botão novamente para organizar a pesquisa da planilha.)

Utilizando a opção Go To

No menu principal, selecione Edit → Go to para pular um linha em uma planilha aberta ou para selecionar um objeto utilizando o número ID do objeto. O IWS aplica um número sequencial de identificação (ID) para cada objeto criado na tela. Ao selecionar um objeto, o número ID aparece na barra de status. Os objetos são numerados de acordo da forma com suas camadas, iniciando- se com zero (o primeiro objeto). Esses objetos são renumerados ao trazê-los para frente ou para trás. Ao agrupar objetos, estes tornam-se um único.

Diálogo Line

Para pular uma linha ou um objeto, selecione Go to. Quando aparecer o diálogo Line, digite o número da linha ou número ID do objeto no text box Number e clique no Botão OK.


InduSoft Web Studio

Página 85

Dica: Caso você possua muitos objetos superpostos, e não é possível selecionar um objeto utilizando o equipamento de apontamento, Pode-se utilizar a opção Go to para editar as propriedades de um objeto que esteja abaixo de outros objetos.

Utilizando a Barra de Ferramentas Tag Properties

A barra de ferramentas Tag Properties fornece um text box, além de vários botões (atalhos) que permitem a criação, localização e acesso a diferentes tags, funções, e propriedades do tag.

Barra de ferramentas Tag Properties

Utilizando o ícone Object Finder

Clique no Botão Object Finder para abrir o diálogo Object Finder, que lista todos os Tags e Funções atualmente configuradas para a aplicação.

Diálogo Object Finder

• Para selecionar uma função/tag já existente, clique duas vezes no nome da função/tag e clique em OK para fechar o diálogo. O nome selecionado aparecerá no text box Tagname.

• Para selecionar um índice array específico, clique no Botão Index após ter especificado o nome do tag array.

• Para selecionar o nome específico de um membro, clique no Botão Member após ter especificado o nome da classe do tag.

• Para criar um novo tag, clique no Botão New.

• Quando aparecer o diálogo New Tag, insira a seguinte informação e depois clique em OK para fechar o diálogo:

Name

Array Size

Type (Boolean, Integer, Real, String, Class:Control, Class:msgonline, or Class:Alr)


InduSoft Web Studio

Página 86

Description

Web data (local ou server)

Utilizando a opção X-ref

Clique no Botão Cross Reference para pesquisar em todas as telas e planilhas da aplicação anotadas no text box Tagname. Essa função escreve um log, detalhando todas as ocorrências do tag, para o tab XRef na janela Output. Por exemplo, os resultados da pesquisa para um tag BlinkFast são os seguintes:

Resultados para XRef

Veja também “Utilizando a Janela Output” na página 70.

Utilizando a opção Global Tags Replace

Ao selecionar o Botão Global Tags Replace na barra de ferramentas Tag Properties, aparecerá o diálogo Global Replace:

Diálogo Global Replace

No diálogo Global Replace, Pode-se substituir qualquer tag(s) de todos os documentos (telas e planilhas) em toda a aplicação. Pode-se editar as colunas From e To.

Ao substituir tags compostas (array size > 0 e/ou Type = Class), Pode-se configurar uma posição específica de array (por exemplo, TagA[1]) ou um mebro de classe (por exemplo, TagB.MemberX) ou ambos (por exemplo, TagC[3].MemberY). Caso você configure somente Main Tag Name (por exemplo, TagC) na coluna From, todos os tags provenientes desse tag principal serão modificados para o tag configurado na coluna To.


InduSoft Web Studio

Página 87

Caso uma substituição inválida seja configurada (por exemplo, substituir o tag Main Tag de um tipo de classe por um tag simples que não seja um tag de classe), o Botão OK sera disabled. Quando o Botão OK for pressionado, os tags configurados no diálogo Global Replace serão substituídos pelo modo como foram configurados na interface do diálogo.

Nota: Deve-se fechar todos os documentos (telas e planilhas) antes de executar esse comando.

Ao alterar o nome do tag na planilha Tags Database, o IWS perguntará se você pretende substituir esse tag em toda a aplicação.

A opção Replace será criada no menu Edit. Utilizar essa opção habilita prontamente o diálogo Global Replace, porém as alterações serão aplicadas somente à tela ou planilha que estão abertas no momento.

Substituindo Tags

Clique duas vezes no objeto para abrir o diálogo Object Properties. Para substituir tags, selecione o Botão Replace localizado no diálogo Object Properties.

Diálogo Object Properties


InduSoft Web Studio

Página 88

Pode-se selecionar um ou mais tags para serem substituídos através do tab Replace Strings. Os tags utilizados atualmente serão exibidos. Você pode digitar em New Tag a direita de cada Current Tag.

Tab Replace Tags

Pode-se também selecionar uma ou mais strings para substituição selecionando o tab Replace Strings. Strings atuais utilizadas serão exibidas. Você poderá digitar em New String à direita de cada Current String.

Ao terminar clique no Botão OK.

Tab Replace Strings


InduSoft Web Studio

Página 89

Testando Exibições

Na barra de menu, selecione Project → Test Display para ativar o modo de testar a exibição, que permite a configuração da aplicação ao mesmo tempo que se visualize dinâmicos gráficos online no ambiente de desenvolvimento. O modo de exibição do tipo teste não habilita a utilização de Comandos ou dinâmicos de entrada Text I/O, bem como execução de planilhas.

Nota:

Utilizar a opção Test Display do menu é o mesmo que utilizar o Botão na barra de ferramentas Execution Control.

Para parar o modo de exibição teste, selecione Project → Stop display test.

Nota:

Utilizar a opção Stop display test do menu é o mesmo que utilizar o Botão na barra de ferramentas Execution Control.

Verificando a Aplicação

Na barra de menu, selecione Tools → Verify Application para recompilar planilhas algorítmicas e telas de lógica, além atualizar os arquivos HTML atuais, utilizando os parâmetros configurados no tab Web (diálogo Project Settings). Os Tags no banco de dados são remapeados para todas as telas e planilhas.

Verificando uma Aplicação

Dica:

Ao salvar uma tela ou planilha, o IWS inclui um apontador para a versão do banco de dados atual. Ao executar a aplicação, o IWS compara a tela ou planilha ao banco de dados da aplicação atual, e caso exista alguma discordância, o IWS recompile as expressões.

Para evitar efetuar essas tarefas durante o runtime da aplicação, recomendamos rodar a função Verify Application antes de fazer download e/ou finalizar uma Aplicação. Deve-se utilizar essa função ao converter uma aplicação para uma nova versão do programa.

Nota: O comando Verify Application deleta os arquivos *.txt e *.tag da pasta \Screen para salvar espaço em disco e limpar a aplicação antes de ser deployed para a estação de runtime.


InduSoft Web Studio

Página 90

Rodando Aplicações

Na barra de menu, selecione Project → Run Application para iniciar os módulos de runtime especificados como Automatic no diálogo Project Status (tab Execution Tasks).

• Ao iniciar o módulo Viewer, ele abre a tela(s) que estão sendo atualmente editadas.

• Caso você não especifique tarefas Automatic, o InduSoft Web Studio iniciará as tarefas Viewer e BGTask automaticamente ao executar Run Aplication.

• Caso você não esteja editando telas atualmente no ambiente de desenvolvimento, o módulo Viewer abre a tela especificada no campo Startup screen no tab Runtime Desktop (diálogo Project Settings).

Nota:

Utilizar a opção Run Application é o mesmo que utilizar o Botão na barra de ferramentas Execution Control.

Atenção: Run Application afeta a aplicação desde sua target station (configurada no diálogo Execution Environment). Ceritifique-se de qual target station está configurada (local ou remota) antes de executar o comando Run Application.

Para parar todas as tarefas de runtime, selecione Project → Stop Application.

Atenção: Stop Application afeta a aplicação desde sua target station (configurada no diálogo Execution Environment). Certifique-se de qual target station está configurada (local ou remota) antes de executar o comando Stop Application.

Nota:

Utilizar o ícone Stop Application é o mesmo que utilizar o Botão na barra de ferramentas Execution Control.

Restaurando Padrões

Na barra de menu, selecione View → Restore Defaults após adicionar ou modificar a interface para retornar ao ambiente de desenvolvimento padrão do IWS. Será necessário fechar e reabrir o IWS para que as alterações sejam aplicadas.

Salvando seu Trabalho

Clique no Botão Save para salvar quaisquer telas ou planilhas ativas.

Notas:

Utilizar o Botão Save é o mesmo que selecionar File → Save da barra de menu ou digitar a combinação de teclas Ctrl+ S.

A função Save torna-se disponível somente quando você modifica o arquivo ativo.

Clique no Botão Save All pilhas abertas.


InduSoft Web Studio

Página 91

Nota:

Utilizar o Botão Save All é o mesmo que selecionar File → Save All na barra de menu.

A função Save All torna-se ativa somente quando você modifica uma tela ou planilha.

Imprimindo Telas do Projeto

Na barra de menu, selecione File → Print Setup para abrir o diálogo Print Setup. A partir desse diálogo, você poderá especificar qual impressora utilizar, e como configurar diferentes opções de impressão, como tamanho do papel e orientação de impressão (retrato ou paisagem).

Diálogo Print Setup

Nota: Para especificar uma impressora padrão:

Vá para o menu Start e selecione Start → Settings → Printers.

Ao aparecer o diálogo Printers, clique com o Botão direito no nome da impressora.

Ao aparecer o menu pop-up, selecione Set As Default.

Um check aparecerá próximo a Set As Default indicando que a impressora selecionada é o padrão.


InduSoft Web Studio

Página 92

Para prever uma tela antes de imprimir, selecione File → Print Preview para abrir a janela Print Preview.

Prevendo uma Planilha de Alarme

Utilize os botões localizados ao longo da parte superior da janela Print Preview como se segue:

• Clique Print para abrir o diálogo Print e imprimir a tela ou planilha (o mesmo que utilizar o comando File → Print).

• Clique Next Page para visualizar a próxima página de uma série de páginas.

• Clique Prev Page para visualizar a página anterior de uma série de páginas.

• Clique Two Page para visualizar duas páginas ao mesmo tempo.

• Clique Zoom In para verificar detalhes.

• Clique Zoom Out Para voltar ao tamanho padrão.

Notas: Os botões Next Page, Prev Page, e Two Page tornam-se ativos somente quando você

está imprimindo mais de uma página.

O Botão Zoom Out torna-se ativo após você efetuar Zoom In.

• Clique Close para fechar a janela Print Preview.

Pode-se também selecionar File → Print na barra de menu e abrir o diálogo Print (idêntico ao diálogo Print Setup discutido previamente). Pode-se utilizar o diálogo Print para imprimir telas ou planilhas ativas.

Nota:

Selecionar o menu Print é o mesmo que utilizar o Botão Print na barra de ferramentas Standard.


InduSoft Web Studio

Página 93

Dicas e Truques Essa seção fornece dicas e truques úties para ajudá-lo a obter vantagem maxima das ferramentas fornecidas pelo IWS, melhorando sua produtividade ao desenvolver aplicações com o uso do IWS.

Configurando o Foco na Janela Object Properties no Editor de Tela

Ao clicar duas vezes em qualquer objeto (ou grupos de objetos) no Editor de tela , a janela Object Properties será iniciada, permitindo a configuração dos parâmetros do objeto selecionado. O conteúdo dessa janela de diálogo varia de acordo com o objeto/dinâmico específico que está sendo editado. Porém, sempre existe um Botão pin no canto esquerdo e acima nessa janela de diálogo:

Diálogo Object Properties

O Botão pin aparece dessa forma, , quando liberado, e quando pressionado, aparecerá assim

.

Quando o Botão pin está liberado, o foco é passado para o objeto na tela assim que esse seja selecionado, portanto, recomendamos que você mantenha esse Botão liberado quando deseja-se manipular (copiar, colar, cortar ou deletar) objetos. Embora a janela Object Properties esteja na parte superior, os commandos do teclado (Ctrl+C, Ctrl+V, Ctrl+X ou Del) são enviados diretamente aos objetos.

Quando o Botão pin está habilitado, o foco é mantido na janela Object Properties, mesmo ao clicar nos objetos da tela. Recomendamos que você mantenha esse Botão habilitado quando desejar modificar as configurações dos objetos. Pode-se clicar em um objeto e digitar um novo valor de propriedade diretamente na janela Object Properties (não é necessário clicar na janela para que o foco volte-se para ela).Além disso, quando o Botão pin está habilitado, a janela Object Properties Não se fecha de forma automática ao clicar na tela.

Importando um Banco de Dados Import Wizard é uma ferramenta poderosa que reduz o tempo de engenharia durante o desenvolvimento da aplicação. Utilizando o ícone Import Wizard, você pode importar tags de diferentes origens de dados diretamente para o Banco de Dados de Tags do IWS. Dependendo da origem dos dados, Pode-se importar não somente nomes de tags como também interfaces de comunicação (o link entre os tags e os endereços PLC).

Ao selecionar File Import Wizard, um diálogo Import Database Wizard aparecerá para guiá-lo através do processo de importação de tags. Existem três passos para a importação de tags a partir desses tipos de origens de dados:


InduSoft Web Studio

Página 94

• Banco de Dados do InduSoft Web Studio

• OPC Server Database

• CSV Database

• ODBC Database

• RSLogix™ 5000 CSV Database

• PanelBuilder™

• OMRON CX Programmer Database

• PanelMate Plus™ Database

passo 1: Selecionar o tipo de origem

Import Wizard – Selecionando o Tipo de Origem de Dados

Clique no Botão data Source Type, de onde os dados estão sendo importados. Clique no Botão Next.


InduSoft Web Studio

Página 95

passo 2: Configurar os parâmetros do tipo de origem

Import Wizard – Selecionando o Tipo de Origem de Dados

A maioria das configurações na segunda janela dependem do tipo de Origem de Dados selecionado no primeiro passo. O screenshot acima é um exemplo de um Tipo de Origem de Dados (OPC Server Database). As configurações mais comuns para qualquer data Source Type são as descritas abaixo:

• Options box: Selecione Do not import duplicated tags caso você não queira tags importados para reescrever tags com o mesmo nome já existente no Banco de Dados de Tags da aplicação atual. Selecione Replace duplicates with tags imported para reescrever tags no Banco de Dados de Tags com tags importados de mesmo nome.

• Use Prefix: Verifique para especificar um prefixo (de até 4 caracteres) para ser concatenado ao nome de tags importados. É vantajoso utilizar um prefixo a fim de diferenciar os tags importados daqueles criados manualmente.

Nota: Para utilizar a opção Remote, o InduSoft Web Studio deverá estar rodando em um computador remoto.

Após configurar os parâmetros nessa janela de diálogo, clique no Botão Next.


InduSoft Web Studio

Página 96

passo 3: Filtrar os tags

O screenshot acima é um exemplo de um Tipo de Origem de Dados (OPC Server Database). Os campos e configurações que são comuns para todos os Tipos de Origem de Dados incluem os que se seguem:

• Grid: Displays the list of tags found on the data source.

Nome do Campo

Descrição

Check-box Habilite para importar tag da origem de dados para o Tags Database da aplicação atual.

Tag Name Nome do tag Size Tamanho Array do tag Type Tipo de dados do tag (Boolean, Integer, Real, String or Class:<ClassName>) Description Descrição do tag

• Check Botão: Clique para selecionar/importar todos os tags no grid.

• Uncheck Botão: Clique para desabilitar todos os tags no grid.

• Filter Botão: Clique para filtrar os tags. A janela de diálogo Filter aparecerá, permitindo a especificação de uma mask para cada coluna no grid. Wild cards (* and ?) podem ser usados para filtrar dados.

• Clear filter Botão: Clique para reiniciar o filtro.

• Import Filtered Tags Only check-box: Cheque essa opção para importar somente os tags que estejam visíves no grid (filtrados).

• Status box: Exibe mensagens descrevendo o status do tag atualmente selecionado no grid. Essa informação é especialmente útil para indicar por que o tag não pode ser importado.


InduSoft Web Studio

Página 97

• Legend box: Desceve o significado das cores que representam o status do tag:

Cor Significado Descrição

Red Error Tag não pode ser importado por não ser suportado pelo IWS. Veja oStatus box para uma descrição detalhada do erro.

Blue Tag will be imported Tagserá importado após clicar no Botão Finish.

Gray Tag can be imported Tag pode ser importado, embora não tenha sido verificado.

• Database size box: Exibe informações resumidas do Import Wizard atual:

Marca Descrição

Current Indica o número de tags configurados no banco de dados de tags da aplicação atual.

Importing Indica o número de tags selecionados para serem importados.

Replacing Indica o número de tags configurados no Banco de Dados de Tags da aplicação atual, os quais serão substituídos pelo tag importado de mesmo nome.

Após selecionar os tags a serem importados, clique no Botão Finish ou clique em Cancel para abortar a operação.

As outras configurações variam de acordo com a origem de dados selecionados no primeiro passo, e são descritos nas seções específicas para cada tipo de origem de dados, como se segue:

o Importando a partir de outros Banco de Dados do InduSoft Web Studio

o Importando a partir de OPC Server Databases

o Importando a partir de CSV Databases

o Importando a partir de ODBC Databases

o Importando a partir de PanelBuilder™ Database Wizard

o Importando a partir de RSLogix 5000 CSV Database Wizard

o Importando a partir de OMRON CX Programmer Databases

o Importando a partir de PanelMate Plus™ Database Wizard

Importando a partir de outros Banco de Dados do InduSoft Web Studio

Esse wizard permite a importação de interfaces (tags e planilhas) a partir de outras aplicações do IWS. Ao importar somente tags, a partir de um computador remoto, a planilha TCP/IP Client poderá ser automaticamente criada para estabelecer um link entre os tags e ambas as estações (local e remota), e compartilhar os valores desses tags entre ambas as estações durante o runtime.


InduSoft Web Studio

Página 98

Importando a partir do InduSoft Web Studio Database Wizard

Campo Descrição Import tags only Quando essa opção está selecionada, os tags de outra aplicação

serão importadas para a aplicação atual. As outras interfaces da aplicação (planilhas) não serão importadas.

Import the whole Aplicação

Quando essa opção está selecionada, as seguintes interfaces de outra aplicação serão importadas para a aplicação atual:

Tags Database

Global Procedures

Tags Database

Global Procedures

Screens

Group Screens

Web Pages

Alarms

Trend


InduSoft Web Studio

Página 99

Recipes

Reports

ODBC

Math

Script

Scheduler

Drivers

OPC

TCP/IP

DDE

Essa opção é útil para unir aplicações e aplicações exemplares de importação (s).

Nota:

Ao selecionar a opção para importar toda a aplicação, as planilhas a seguir serão sempre importadas (exceto aquelas já existentes que possuam o mesmo número na aplicação atual): ODBC, Math, Script, Scheduler, Drivers, OPC, TCP/IP and DDE. Caso exista planilhas com o mesmo número na aplicação atual, as planilhas importadas serão inseridas como planilhas adicionais na Aplicação atual (o número de cada planilha é automaticamente aumentado para evitar substituição de arquivos da aplicação atual.

Do not import duplicated

Quando essa opção está selecionada, as interfaces a seguir não são importadas em caso de já existir uma interface equivalente na Aplicação atual:

Tags Database (tags de mesmo nome não serão importados)

Global Procedures (os Procedimentos globais não serão importados)

Screens (telas com o mesmo nome não serão importadas)

Group Screens (grupos de telas de mesmo nome não serão importados)


InduSoft Web Studio

Página 100

Web Pages (web pages de mesmo nome não serão importadas)

Alarms (alarmes assinados a tags com mesmo nome não serão importados)

Trends (trend logs assinados a tags com mesmo nome não serão importados)

Recipes (recipes com mesmo nome não serão importados)

Reports (reports com mesmo nome não serão importados)

Script (the Startup Script com mesmo nome não será importado) Replace duplicated with imported

Quando essa opção está selecionada, as interfaces de outra aplicação serão importadas, e as interfaces da Aplicação atual com mesmo nome (caso haja) serão reescritas.

Local Selecione essa opção para importar tags de uma Aplicação armazenados no computador local para a aplicação atual. Para isso, clique no Botão Browse e selecione o arquivo *.APP da Aplicação que possua os tags que você deseja importar.

Remote Selecione essa opção para importar tags de uma Aplicação que esteja rodando em uma estação remota. Digite um endereço IP (ou o host name) do computador remoto, no campo Remote. Os tags da aplicação atual do computador remoto estarão disponíveis para importação. Essa opção está disponível para importar tags only, mas não para whole Application.

Generate TCP/IP Client worksheet

Ao selecionar Remote (ao inves de Local) e checar essa opção, o IWS configurará a planilha TCP/IP Client automaticamente a fim de trocar dados com a aplicação remota.

Use Prefix Cheque para especificar um prefixo (de até 4 caracteres) para ser concatenado ao nome dos tags importados. Tal função é útil para utilizar um prefixo a fim de diferenciar os tags importados daqueles criados manualmente.


InduSoft Web Studio

Página 101

Importando a partir de OPC Server Databases

Esse wizard permite importar tags tanto de OPC Servers remotos quanto de Locais. Ao importar tags do OPC Server, a planilha OPC Client é autimaticamente criada para estabelecer um link entre tags, eliminando a necessidade de configurar uma interface de comunicação entre o OPC Client do IWS e um OPC Server externo.

Wizard Import OPC Server Database

• Local/Remote: Fornece as seguites opções:

Server Descrição

Local Selecione essa opção para importar tags de um OPC Server instalando no computador local.

Remote

Selecione essa opção para importar tags de um OPC Server instalando em um computador remoto. Digite o Endereço IP (ou the host name) do computador remoto no campo Remote de onde o IWS está rodando.

• combo-box Merge Local e Remote OPC Servers: Caso voê selecione um Remote server, habilite essa opção para exibir a lista de OPC Servers instalados no computador local e também no computador remoto. Desabilite esse check-box para exibir somente a lista de OPC Servers instalados no computador remoto.

• combo-box Identifier: Exibe a lista de OPC Servers disponíveis.

• Branch: Clique no Botão Browse para selecionar o branch do OPC Server do qual os tags (itens) serão importados. Deixe esse campo em branco caso você deseje importar tags de todos os branches configurados no OPC Server.

• check-box Use the item path for the tagname: Habilite essa opção para concatenar o caminho para o nome do item ao importar tags do OPC Server. Desabilite essa opção para utilizar somente os nomes dos itens configurados no OPC Server.

• No grid exibido no terceiro passo () para esse Data Source Type, existe um campo adicional com a marca OPC, que exibe o nome dos itens existentes no OPC Server.


InduSoft Web Studio

Página 102

Nota: Veja os passos 1, 2 e 3 na seção acima para configurações e campos comuns a todos os Source Types.

Importando a partir de CSV Databases

Esse wizard permite importar tags de um campo de texto no formato CSV (Comma Separated Values) ou qualquer formato similar.

Wizard Import CSV Database

• File Name: Pressione o Botão Browse para selecionar o campo de texto do qual os tags serão importados.

• Data Column box: Selecione um número para cada propriedade de tag que corresponda ao número da coluna no arquivo de importação. Por exemplo, caso Tag, Array Size e Type estejam listados nas segunda, terceira e quarta colunas do arquivo de importação, respectivamente, selecione 2 em Tag, 3 em Array Size e 1 em Type. A propriedade Tag (nome do tag) é obrigatória, embora as outras propriedades sejam opcionais.

Para propriedades que não estejam incluídas no arquivo de texto, selecione a opção Not used. O IWS irá inserir padrões ou deixar o campo em branco, de acordo com a seguinte tabela:

Propriedade Valor Padrão Array Size 0 Type Integer Description <Blank> Web Data Local

• checkbox Delimiters: Selecione o delimitador(es) utilizados no campo de texto para divider uma coluna da outra. Para um arquivo CSV, o delimitador é Comma (padrão). Pode-se selecionar mais de um delimitador em algum momento, além de poder também utilizar a opção Other para inserir um delimitador customizado.


InduSoft Web Studio

Página 103

Nota: Veja os passos 1, 2 e 3 na seção acima para as configurações e campos que são comuns para todos os Source Types.

Importando a partir de ODBC Databases

Esse wizard permite importar tags a partir de um Banco de Dados SQL Relational externo, como Microsoft Access, SQL Server, Oracle, My SQL, Sybase e outros, através da interface ODBC (Open DataBase Connectivity).

Wizard Import ODBC Database

• Botão Select Data Source: Clique para selecionar o ODBC Data Source Name (DSN) vinculado ao banco de dados do qual os tags serão importados. O DSN deve ter sido previamente criado na janela Data Sources (ODBC) (Control Panel Administrative Tools Data Sources [ODBC]). Após selecionar um DSN, os outros campos dessa janela serão povoados de forma automática com informações do banco de dados selecionado.

• combo-box Table: Selecione a tabela que mantenha os dados no banco de dados de importação.

• combo-box Tag: Selecione o nome da coluna que mantenha os tags no banco de dados de importação.

• combo-box Array Size: Selecione o nome da coluna que mantenha o tamanho do array para os tags no banco de dados de importação.

• Type combo-box: Selecione o nome da coluna que mantenha o tipo de tag type no banco de dados de importação.

• Description combo-box: Selecione o nome da coluna que mantenha a descrição do tag no banco de dados de importação.

• Web Data combo-box: Selecione o nome da coluna que mantenha os Dados da Web para os tags no banco de dados de importação.


InduSoft Web Studio

Página 104

Nota: Veja Passos 1, 2 e 3 na seção acima, para as configurações e campos comuns para todos os Source Types.

Importando a partir de RSLogix™ 5000 CSV Databases

Esse wizard permite importar tags a partir de um programa para ControlLogix/FlexiLogix PLC desenvolvido com RSLogix™ 5000 e expostado para um arquivo CSV. Ao importar tags da arquivo CVS RSLogix™ 5000, a planilha do driver ABCIP é automaticamente criada para fazer um link entre os tags importados com o PLC, eliminando a necessidade de configurar a interface de comunicação entre o IWS e o PLC manualmente.

Importing Data from the RSLogix 5000 CSV Database

• PLC Options box: Fornece as seguintes opções:

Option Description

Scope (Folder Name):

Use Full Scope

Do Not Use Scope

Use Limited Scope

Selecione Use Full Scope para importar os tags utilizando o ícone full scope configurado no programa PLC.

Selecione Do Not Use Scope para ignorar o escopo dos tags configurados no programa PLC.

Selecione Use Limited Scope para configurar o número de caracteres do escopo que devem ser utilizados ao importar os tags do programa PLC.

PLC IP Address Digite o Endereço IP do PLC. Essa informação sera utilizada para configurar as planilhas do driver de comunicação automaticamente.


InduSoft Web Studio

Página 105

• CSV File: Clique no Botão Browse para selecionar o arquivo CSV exportado pelo RSLogix™ 5000 com a lista de tags configuradas no programa do PLC.

• L5K File: Clique no botão Browse para selecionar o arquivo L5K salvo pelo RSLogix™ 5000 com a lista de tags UDT (User Defined Type) configurados no porgrama PLC. Esse arquivo é opcional para o wizard. Porém, caso esse arquivo não esteja selecionado, os tags UDT não serão importados.

• Create class tags when suitable: Cheque esse check-box para criar tags e classes de tags UDT importados do programa PLC. Desabilite esse check-box para importar tags como tags simples (diferente de tipo de classe) do programa PLC.

• No grid exibido Passo 3 (Importando um Banco de Dados) para esse Data Source Type, existe um campo adicional com a marca Address, que exibe o nome dos itens do programa RSLogix™.

Nota: Veja Passos 1, 2 e 3 na seção acima, para as configurações e campos comuns para todos os Source Types.

Importando a partir de the PanelMate™ Database Wizard

Atenção: Esse wizard é fornecido como um adicional e requer uma licença para ser habilitado. Consulte seu vendedor do software para maiores informações.

Esse wizard permite importar não somente tags como telas, configurações de alarme e interface de comunicação de um projeto criado com o software PanelMate Plus™ software. Utilizando esse wizard, pode-se converter uma aplicação PanelMate™ Aplicação (desenvolvida com o PanelMate Plus™) para o formato do IWS e rodá-lo sob qualquer plataforma suportada pelo IWS.

Wizard Import PanelBuilder Database


InduSoft Web Studio

Página 106

• Import Screens: Habilite essa opção para importar as telas gráficas (incluindo objetos e dinâmicos) para o IWS.

• PanelMate Model: Pressione o botão Browse para selecionar o diretório onde os arquivos do banco de dados do projeto PanelMate Plus que você pretende importar estão armazenados.

• Aplicação: Após selecionar o caminho correto no campo PanelMate Model, as aplicações disponíveis nesse diretório estarão disponíveis nesse combo-box. Selecione a Aplicação que você pretende importar antes de pressionar o botão Next.

Dica: Consulte a documentação desse import wizard para informações detalhadas sobre como exportar uma Aplicação do software PanelMate Plus™ para o IWS.

Nota: Veja os Passos 1, 2 e 3 na seção acima para as configurações e campos comuns para todos os Source Types.

Importando a partir de OMRON CX Programmer Databases

Atenção: Esse import wizard cria o driver de comunicação para o OMRON, o qual é habilitado somente para clientes que adquiriram o produto diretamente da OMRON. Consulte seu vendedor de software para maiores detalhes. Mais do que isso, o driver de comunicação OMRON comunica-se com PLCs através do FINS Gateway, suportado pelos sistemas operacionais Windows 2000/XP. Portanto, FINS Gateway deve estar instalado no computador para habilitar a comunicação entre o IWS e PLCs através do driver da OMRON.

Esse wizard permite importar tags de um programa para PLCs OMRON desenvolvidos com CX Programmer e exportados para um arquivo CXT. Ao importar tags do arquivo CX Programmer CXT, a planilha de trabalho OMRON é automaticamente criada para estabelecer Link entre tags importados e o PLC, eliminando a necessidade de configurar a interface de comunicação entre o IWS e o PLC manualmente.


InduSoft Web Studio

Página 107

Wizard Import OMRON CX Programmer Database

• Prefix: Esse box permite a concatenação de um dos seguintes tipos e prefixos para os tags importados do programa CX Programmer:

Prefixo Descrição

Custom Habilite essa opção para concatenar um prefixo customizado com até 8 caracteres para o nome dos tags importados.

PLC Habilite essa opção para concatenar o nome ou número do PLC ao nome dos tags importados.

Program Habilite essa opção para concatenar o nome ou o número do Programa ao nome dos tags importados.

• Serial Auto Address: Esse box permite configurar o Network Address e o Initial Node Address para os PLCs configurados no produto com comunicação Serial (caso haja):

Configuração Descrição Network Address

Essa configuração sera aplicada para todos os PLCs configurados no projeto com comunicação Serial.

Node Address

Essa configuração sera aplicada para o primeiro PLC configurado no projeto com comunicação Serial. Tal configuração sera incrementada e aplicada aos PLCs subsequentes configurados no produto com comunicação Serial.

• CXT File: Clique no botão Browse para selecionar o arquivo CXT, exportado pelo CX Programmer, do qual os tags serão importados.

• No grid exibido no Passo 3 para esse Data Source Type, existe um campo adicional com a marca Address, que exibe o nome dos tags do programa CX Programmer.

Nota: Veja os Passos 1, 2 e 3 na seção acima para as configurações e campos comuns para todos os Source Types.


InduSoft Web Studio

Página 108

Importando a partir de TwinCAT PLC Databases

Esse wizard permite importar tags de um programa desenvolvido com o software de controle baseado em PC (TwinCAT PC-Based Control software) pela Beckhoff e exportado para um arquivo Report (*.SYM). Ao importar tags do arquivo TwinCAT PC-Based Control SYM, a planilha de driver do TWCAT é automaticamente criada para estabelecer um link entre tags importados e o projeto PC-Based control, eliminando a necessidade de configurar a interface de comunicação entre o IWS e o software PC-Based Control manualmente.

• TwinCAT PLC: Esse box permite ao usuário configurar os seguintes parâmetros:

Configuração Descrição MAS Net ID Digite o ID AMS Net ID do projeto TwinCAT.

TCP Port

Selecione uma porta TCP utilizada pelo driver para trocar dados com o software TwinCAT PC-Based Control durante o runtime. Pode-se selecionar uma das portas TCP padrão (801, 811, 821 or 831), ou digitar o número de uma porta TCP customizada para ser usada na comunicação.

Report File Clique no botão Browse para selecionar o arquivo .SYM do qual tags devem ser importados.

Módulos de Desenvolvimento

Essa seção mostra uma visão geral de gráficos e módulos de desenvolvimento de tarefas. Para maiores informações, veja o Capítulo 7: Configurando Telas e Gráficos e Capítulo 8: Configurando Planilhas de Tarefas.

Gráficos

A função mais básica executada pelo InduSoft Web Studio é o fornecimento de uma janela dentro do porcesso. A habilidade para exibir o status do processo pela interação com instrumentação (ou computadores), é descrita como um Interface Homem-Máquina (HMI).

O InduSoft Web Studio permite a criação de aplicações que Podem monitorar processos com a utilização de telas coloridas de alta resolução.


InduSoft Web Studio

Página 109

As ferramentas gráficas do InduSoft Web Studio consistem de dois módulos:

• Screen/Worksheet Editor na area de trabalho do InduSoft Web Studio (utilizado para criar ou importar gráficos)

• Viewer do runtime da aplicação

Pode-se utilizar animation links para criar objetos de gráficos dinâmicos ou símbolos. Links de animação provocam a alteração da aparência de objetos e símbolos, refletindo essas alterações no valor de um tag ou em uma expressão. Cada tela é uma associação de objetos dinâmicos e estáticos.

Telas podem ter um bitmap opcional que atua como um background na janela do objeto. Na tela a seguir, por exemplo, as imagens estáticas Podem ser parte de um bitmap no objeto de fundo e objetos animados em camadas de objetos dinâmicos Podem refletir as alterações na planta, dando a impressão de que a tela é tridimensional.

Exemplo de Tela de Emulação do CEView

Todas as tarefas de configuração do IWS requerem um equipamento apontador compatível com o Windows, como mouse ou touch pad. Pode-se rodar a aplicação no Viewer sem a utilização de um apontador caso você configure keypads ou teclas para todos os comandos.

Tarefas

Utiliza-se o tab Tasks do IWS para configurar planilhas tarefa-específicas, cada uma composta de um Cabeçalho (onde você define informações globais da planilha) e um Corpo (onde você configure os tags e expressões utilizadas em cada tarefa).

You can configure the following task-specific worksheets:

• Alarm Groups : Utilize para definir um grupo de alarme, suas características e suas mensagens, que serão reportadas em condições de alarme. O propósito principal desses alarmes é de informar os operadores a respeito de qualquer problema ou alteração de estado durante o processo; dessa forma, ações corretivas podem ser tomadas a tempo.

Para mostrar mensagens de alarme na tela, deve-se criar o objeto de alarme na tela.

• Trend Groups : Utilize para definir grupos de trends, os quais manterão uma sequencia do comportamento das variáveis do processo. Pode-se armazenar amostras em um arquivo histórico e exibir ambos em amostras online, em um gráfico de tendências de tela.

• Recipes : Utilize para ler e escrever arquivos ASCII de e para o hard disk, além de transferir valores entre arquivos e memória de tempo real. Tipicamente, Pode-se armazenar receitas de


InduSoft Web Studio

Página 110

processos, embora tais arquivos possam armazenar qualquer tipo de informação, como operações de log, senhas, etc. Pode-se também utilizar Esse modulo para armazenar dados em formato XML.

• Reports : Utilize para configurar seus próprios relatórios dos dados do sistema, nos formatos ASCII ou RTF. O propósito principal desse módulo é a criação de relatórios de maneira mais simples e mais eficiente.

• Math Worksheets : Utilize para implementar rotinas adicionais para trabalhar com funções básicas do módulos do InduSoft Web Studio. Uma planilha Math é um grupo de linhas programacionais que são executadas como uma das tarefas de Background da aplicação. Pode-se configurar a matemática em blocos, em diferentes planilhas.

Essa planilha fornece um ambiente livre para rotinas de lógica e calculos matemáticos necessarios ao projeto. Para tais propósitos, a linguagem de script é simples e de fácil utilização.

• Scheduler : Utilize para gerar as bases de tempo utilizadas em uma aplicação. O Scheduler é capaz de disparar eventos.

• ODBC Configuration : Utilize para habilitar aplicações do InduSoft Web Studio para acessar quaisquer bancos de dados que sejam compatíveis com o protocolo ODBC (como Access, Excel, Oracle, SQL Server, etc).

Nota: A interface ODBC não está disponível para aplicações em WinCE.

Comunicações Gerais Pode-se habilitar as aplicações do InduSoft Web Studio Aplicaçãos para comunicar (trocar valores de dados) com outras aplicações, equipamentos remotos (como um PLC ou transmissores), e quaisquer dispositivos que implementem Servers OPC ou DDE.

Para habilitar a comunicação, configure task worksheets fornecido pelo IWS. Instruções para configurar essas planilhas são fornecidas no Capítulo 10: Communication nas seguintes seções:

•

• Configurando um Driver: Explica como configurar uma planilha de Driver para implementar um protocolo de comunicação (OPC, TCP/IP, ou DDE).

• Configurando OPC: Explica como configurar uma planilha de OPC para gerenciamento de comunicação entre OPC Clients e Servers locais ou remotos.

• Configurando TCP/IP: Explica como configurar uma planilha TCP/IP para gerenciamento de comunicação entre duas aplicações do IWS.

• Configurando DDE: Explica como configurar uma planilha de DDE para gerenciamento de comunicação entre DDE Clients e Servers locais ou remotos.

Utilize o tab Comm para acessar todas as planilhas configuradas para estabelecer comunicação com outro equipamento ou software utilizando protocolos disponíveis.


InduSoft Web Studio

Página 111

Capítulo 4: Compreendendo a Estrutura do IWS Esse Capítulo explica a estrutura interna do IWS, incluindo a maneira como os dados fluem através do ambiente de runtime do IWS, além dos vários módulos de runtime que podem ser executados.

IMPORTANTE! Para evitar comportamentos não previstos, e garantir a melhor performance quando executar as Aplicações, recomendamos que as informações desse capítulo sejam cuidadosamente lidas e compreendidas antes de iniciar o desenvolvimento de Aplicações complexas.

Compreendendo a Estrutura Interna e o Fluxo de Dados O ambiente de runtime do IWS roda uma estação de trabalho operadora (Rodando em Windows NT/2000/XP/CE). Esta consiste dos seguintes módulos ou threads (elementos do programa que podem ser executados independentemente de outros elementos do programa):

• Background Task (uma tarefa de supervisão): Executa outras tarefas internas (planilhas do IWS). Por exemplo, a tarefa Background executa scripts configurados nas planilhas Math e Scheduler, além de gerenciar parâmetros configurados nas planilhas Alarm, Recipe, Report, e Trend.

• Database Spy (ferramenta para correção de erros):

o Executa Funções e/ou expressões para fins de teste

o Lê dados (como valares de tags) a partir do tags database

o Escreve dados (como valores de tags) para o tags database

• DDE Client: Gerencia comunicação DDE com um servidor DDE (local ou remoto), de acordo com parâmetros configurados nas planilhas DDE Client.

• DDE Server: Gerencia comunicação DDE com um DDE Client (local ou remoto).

• LogWin (ferramenta para correção de erros): Envia mensagens geradas a partir de outros módulos/tarefas.

• Driver Runtime: Gerencia os comandos read/write configurados nas planilhas do Driver.

• OPC Client: Gerencia comunicação OPC com um OPC Server (local ou remoto), de acordo com parâmetros configurados nas planilhas OPC Client.

• OPC Server: Gerencia comunicação OPC com um OPC Client (local ou remoto).

• ODBC Runtime: Gerencia comunicação de dados ODBC com qualquer banco de dados relacionado a SQL, de acordo com parâmetros configurados nas planilhas ODBC.

• TCP/IP Client: Gerencia comunicação TCP/IP com um modulo remoto TCP/IP Server (do IWS), de acordo com parâmetros configurados nas planilhas TCP/IP Client.

• TCP/IP Server: Gerencia mensagens de comunicação TCP/IP com um módulo TCP/IP Client remoto (do IWS).

• Viewer: Executa todos os scripts (On Open, On While, On Close, Command, Hyperlink, etc) configurados para telas da Aplicação, além de atualizar objetos de tela.

Nenhum dos módulos de runtime precedentes troca dados diretamente com um outro modulo ou tarefa. Além disso, módulos de runtime enviam e recebem dados do banco de Tags, o “coração” do IWS.

O banco de Tags controla o fluxo de dados entre módulos. Além, das Tags armazenarem todos os valores de tags e o status de todas as propriedades associadas a cada tag (como condições de alarme, timestamp, qualidade, etc).


InduSoft Web Studio

Página 112

Nota:

Tags são variáveis (como pontos de comunicação em equipamentos de campo, resultados de cálculos, etc) utilizadas em telas e planilhas.

Para informações mais detalhadas sobre tag, valores de tags, e propriedades de tag, veja o Capítulo 5: Trabalhando com Tags.

Fluxo de Dados do IWS

Cada módulo do IWS contém uma tabela virtual de tags que são relevantes para determinado modulo naquele exato período de tempo. O tags database utiliza essa tabela para determinar quais informações devem ser atualizadas para cada módulo. Por exemplo, o Viewer contém uma tabela virtual que lista todos os tags configurados para todas as telas abertas da Aplicação. Caso o valor de um tag se altera, o tags database envia uma mensagem para o Viewer, e este atualiza o valor em todos os objetos onde o tag estiver configurado.


InduSoft Web Studio

Página 113

Por exemplo, se um driver lê um novo valor a partir de um PLC (controlador lógico programável), o driver atualiza o tag a ele associado com esse valor do Tags database. Depois disso, essa nova informação deverá ser exibida na tela da Aplicação, e o Tags database envia um novo valor de tag para a tarefa Viewer, e este atualiza a tela.

Exemplo de Fluxo de Banco de Dados

Note que o driver não envia um novo valor de tag diretamente para o Viewer. Além disso, não existem requisitos de dados entre tarefas—o tags database recebe a informação atualizada e a repassa imediatamente para todas as tarefas de runtime que necessitam desta informação.

IMPORTANTE! O módulo Viewer atualizará um objeto somente quando (pelo menos) um dos valores de tag seja alterado.

Se você configurar um objeto dinâmico (como Text I/O) com uma função que não requer o uso de um tag (por exemplo, NoInputTime()), o Viewer não atualizará o objeto, pois não existem tags associadas àquele objeto.

A Arquitetura do IWS melhora significantemente a performance do fluxo interno de dados, além de torná-lo um processo mais fácil para a adição de novas tarefas internas. Mesmo que cada tarefa trabalhe de forma independente, é possível acessar informações a partir de qualquer outra tarefa através do tags database.

Executando/Mudando Módulos do IWS O IWS é um sistema SCADA composto de módulos que devem ser executados simultaneamente. Baseado no conceito de multitarefas, cada modulo de runtime (Viewer, Driver, and assim adiante) é uma thread e o sistema operacional altera de uma thread para outra simultaneamente.

É um erro de concepção comum o conceito de executar um sistema SCADA ao executar um programa PLC. Um programa de PLC contém um loop simples:


InduSoft Web Studio

Página 114

Loop do Programa do PLC

Porém, em um sistema SCADA, existem vários módulos rodando simultaneamente, e a maioria deles pode ler ou escrever dados. O sistema SCADA modifica dados (valores de tags) continuamente durante execução de tarefas; por isso, o diagrama precedente não é aplicável.

O IWS possui apenas um processo—Studio Manager.exe. Ao executar uma aplicação de runtime, o processo Studio Manager.exe inicia-se no tags database e todos esses módulos configurados para a aplicação. Pode-se especificar quais módulos (como Viewer e Driver) iniciarão durante o runtime (veja “Iniciando Módulos de Runtime no Target system” na página 174).

Cada processo pega uma lista de threads ativos para o sistema operacional. Na verdade, cada processo ativa e desativa cada thread durante o runtime, de acordo com o algorítmo de cada processo. Além disso, ao criar uma thread, um valor prioritário é especificado. O sistema operacional escanea continuamente todos os threads ativos atualmente, e executa as threads de acordo com seus valores prioritários—executando primeiramente threads de alta prioridade. Quando threads com valores de alta prioridade estão ativados, as threads com valores de alta prioridade não são execitados. Caso haja mais de uma thread com o mesmo valor e prioridade, e não existem outras threads com valores de alta prioridade, o sistema operacional alterna-se entre threads com mesma prioridade.


InduSoft Web Studio

Página 115

Nota: Todas as threads do IWS são configurados em prioridade 7: THREAD_PRIORITY_NORMAL. (A maioria dos programas contém esse valor de prioridade.)

Threads de programas em tempo real (como SoftPLCs e Drivers de Equipamentos) são designados com um valor de alta prioridade (THREAD_PRIORITY_HIGHEST); porém, esses programas devem fornecer um mecanismo que deixe-os inativos por algum período de tempo ou de threads com prioridade normal as quais nunca sejam executadas.

O IWS utiliza a biblioteca UNICOMM.DLL para drivers seriais. Essa biblioteca cria uma thread THREAD_PRIORITY_HIGHEST que “descansa” (permanence inativada) até que os dados cheguem ao canal serial. Quando o IWS detecta novos dados em um canal serial, a thread THREAD_PRIORITY_HIGHEST “acorda” (torna-se ativada) e transfere os dados do sistema operacional buffer para o buffer de thread, onde pode ser lido pelo Driver. Essa thread é a única thread de maior prioridade criada pelo IWS.

Caso você permita que as threads permaneçam ativas durante todo o tempo, o uso da CPU deverá ficar em 100% durante todo o tempo também, o que deve ser evitado em razões de performance. Cada programa fornece um mecanismo para previnir que threads fiquem ativadas todo o tempo.

O IWS utiliza os seguintes parâmetros para previnir tal ação:

• TimeSlice (do sistema operacional): Induz o sistema operacional a alternar as threads ativas com valor de mesma prioridade.

Como padrão, o sistema operacional executa cada thread ativa por aproximadamente 20ms, e a seguir, alterna a próxima thread ativa, ou seja, caso haja múltiplas threads ativas com o mesmo valor de prioridade esperando para serem executadas, o sistema operacional não executará qualquer uma que esteja ativada por mais de 20ms.

• TimeSlice (do IWS): Especifica quanto tempo cada thread do IWS é capaz de continuar ativada.

Esse parâmetro deve ser utilizado adicionalmente ao parâmetro TimeSlice do sistema operacional. Configura-se um valor TimeSlice para cada thread do IWS (exceto para Background Task) e especifica-se por quanto tempo cada thread permanecerá continuamente ativa. Contanto que uma thread esteja ativa, o sistema operacional será capaz de alternar para esta determinada thread.

• Period (do IWS): Especifica a quantidade maxima de tempo que cada thread do IWS (exceto Background Task) é capaz de permanecer inativa.

Atenção: Recomendamos que você não modifique esses valores padrão, a menos que absolutamente necessário. Configurar esses parâmetros de forma incorreta pode causar o mal funcionamento de todo o sistema (por exemplo: A uso da CPU rodará com 100% de sua capacidade), além de fazer com que algumas tarefas funcionem de forma não satisfatória.

Caso você necessite mudar os parâmetros padrão, anote os valores antes de fazer as alterações; assim, caso ocorra algum problema de funcionamento, você poderá retornar às configurações originais.


InduSoft Web Studio

Página 116

Para alterar os valores de parâmetro padrão do IWS TimeSlice e Period:

A partir do diretório de instalação do IWS (por exemplo, C:\Program Files\<Installation Folder>\bin), clique duas vezes em \BIN para abrir a pasta.

Clique duas vezes no arquivo Program Settings.INI para abrir o arquivo Notepad da Microsoft®.

A lista a seguir mostra todos os parâmetos contidos nesse arquivo .ini, além de seus valores padrão (em milissegundos).

[Period] DBSpy=1000 UniDDEClient=200 UniDDE=200 Driver=20 LogWin=100 UniODBCRT=100 OPCClient=20 OPCServer=20 TCPClient=100 TCPServer=100 Viewer=50 [TimeSlice] UniDDEClient=100 Driver=10 OPCClient=10 OPCServer=10 TCPClient=200 TCPServer=200 Viewer=200

Nota: Ë possível que você não veja todos esses parâmetros listados acima ao abrir seu arquivo Program Settings.INI. Porém mesmo que um parâmetros não esteja visível na lista, o IWS ainda assim utiliza o parâmetro e seu valor padrão.

Para alterar o valor padrão de um parâmetro exibido: Em Notepad, delete o valor padrão e digite o novo valor.

Para alterar o valor padrão de um parâmetro não exibido na lista: Em Notepad, digite o nome do parâmetro exatamente como mostrado na lista e com o mesmo sinal. Depois, digite o novo valor.

Salve o arquivo (File → Save) e feche o Notepad (File → Exit).


InduSoft Web Studio

Página 117

A figura a seguir mostra como o IWS executa um thread genérico (como o Viewer).

Onde:

• Sinal é o período de tempo Period (configurado para 50ms nesse exemplo).

• Sinal mostra quando um thread está ativo para o sistema operacional.

• Sinal é o período de tempo TimeSlice (configurado para 30ms nesse exemplo).

• Sinal mostra a execução de um thread.

Nesse exemplo, o IWS gera uma mensagem Period a cada 50ms (sinal ). Ao gerar essa mensagem, o thread do IWS torna-se ativo e assim permanece até o período de tempo TimeSlice especificado expirar. O thread então permanece inativo até que o IWS gere a próxima mensagem Period (sinal

).

Enquanto o thread está ativo, o sistema operacional é responsável pela execução do thread. Porém, um thread estar ativo não significa que o sistema operacional executará esse thread imediatamente – o sistema operacional pode estar executando outros threads, por exemplo.

Quando o sistema operacional executa um thread, o timer TimeSlice inicia a contagem, e daí em diante o thread é executado por 20ms (TimeSlice a partir do sistema operacional). Após o período de 20ms, o sistema operacional altera automaticamente para o próximo thread ativo (como o Driver), e assim por diante.

No exemplo acima, o tempo do TimeSlice foi configurado para 30ms, significando que o sistema operacional não é suportado para a execução de mais de um thread em cada TimeSlice do IWS. Porém, especificando valores mais altos para o período de tempo TimeSlice do IWS, é provável que o sistema operacional seja capaz de executar o mesmo thread mais de uma vez em um mesmo período de tempo TimeSlice.

No exemplo a seguir, os valores de Period e TimeSlice foram alterados como se segue, mas o período TimeSlice do sistema operacional padrão (20 ms) não foi alterado.

• Sinal é o período de tempo Period (configurado para 100ms).

• Sinal mostra quando o thread está ativo para o sistema operacional.

• Sinal é o período de tempo TimeSlice do IWS (configurado para 80ms).

• Sinal mostra a execução do thread.


InduSoft Web Studio

Página 118

Configurando um TimeSlice mais Alto

Note que o thread pode ser executado mais de uma vez em um mesmo período de tempo TimeSlice. Quando o TimeSlice do IWS expira, o sistema operacional interrompe a execução do thread; porém, mesmo que os parâmetros Period e TimeSlice do IWS estejam configurados para 100ms e 80ms respectivamente, o sistema operacional não executará esse thread continuamente por mais de 20ms, pois o TimeSlice do sistema operacional está configurado para 20ms.

Quando o sistema operacional não está executando o thread Viewer, a CPU pode executar qualquer outro thread ou até mesmo permanecer ociosa (caso não haja outros threads ativos a serem executados). Lembre-se de que os parâmetros Period e TimeSlice do IWS foram criados para prevenir que todos os threads fiquem ativos em um mesmo período, evitando assim a capacidade de 100% de uso da CPU.

Duante a execução do thread, esse deverá fazer manutenção de suas mensagens pendentes. Por exemplo, o módulo Viewer deve atualizar quaisquer objetos de tela relacionados. Caso não haja mensagens pendentes, o próprio thread se desativará e passará o controle de volta ao sistema operacional. O sistema operacional imediatamente alternará para o próximo thread ativo, ou seja, um thread pode interromper sua própria execução — mesmo se o TimeSlice do sistema operacional ainda não tenha expirado (o que ocorre frequentemente em aplicações de mundo real).

Nota: Os módulos Database Spy, DDE Server, LogWin, e ODBC Runtime não possuem um parâmetro TimeSlice do IWS. Consequentemente, após cada thread manusear todas as suas mensagens pendentes, os threads tornam-se inativos até a próxima mensagem Period de cada um dos threads.

Background Task é uma exceção para processos de execução/alternamento já discutidos. O mecanismo para execução/alternamento do Background Task sera descrito na próxima seção.

Executando/Alternando o Background Task O Background Task executa scripts a partir de planilhas Math e Scheduler (por exemplo, mensagens a partir de planilhas de Alarm e Trend). Além disso, o Background Task executa todos os comandos Recipe e Report quando as Funções Recipe() ou Report() são executadas durante o runtime.

Emboras as tarefas Alarm, Math, Scheduler, e Trend não sejam threads, pode-se especificar ou trocar seus tempos no Period no arquivo Program Settings.INI localizado na pasta C:\Documents and Settings\\Local Settings\Aplicação Data\InduSoft Web Studio v6.1 (veja “Executando/Mudando Módulos do” na página 113).


InduSoft Web Studio

Página 119

Os valores padrão de Period (em milissegundos) são:

[Period]

Math=100

Sched=50

Alarm=100

Trend=1000

Esses valores significam que, a cada 100ms, o IWS gera uma mensagem Period para a tarefa Math. A cada 50ms, o IWS gera uma mensagem Period para a tarefa Scheduler, e assim por diante.

Atenção: Recomendamos que você não modifique os valores padrão do Background Task a menos que seja absolutamente necessário. Configurar qualquer um desses parâmetros de forma incorreta pode acarretar o mal funcionamento do sistema como um todo (por exemplo, uso de 100% da CPU) e/ou fazer com que algumas tarefas funcionem inadequadamente.

Caso você necessite trocar os parâmetros padrão, anote os valores antes de fazer suas alterações. Assim, caso ocorra mau funcionamento, é possível retornar às configurações originais.

Mantenha em mente que o thread Background Task possui a mesma prioridade de qualquer outro thread no IWS (Drivers, Viewer, etc), o que significa que o sistema operacional não executará essa tarefa continuamente por mais de 20ms.

O Background Task executa os comandos Recipe e Report quando as funções Recipe() ou Report() são executadas. Como essas funções são sincrônicas (Recipe() e Report(), uma vez que o Background Task inicie a execução dessas funções, não sera possível alternar para outra tarefa (Alarm, Math, Scheduler, ou Trend) até que essas sejam executadas inteiramente. Executar uma função Recipe() ou Report() geralmente leva alguns milissegundos.

O Backgound Task deve alternar entre tarefas Alarm, Math, Scheduler, e Trend. Quando o Background Task alternar para a tarefa Scheduler, não sera possível alternar para outra tarefa (Alarm, Math, ou Trend) até que todas as planilhas Scheduler sejam executadas. Após a execução de todas as planilhas Scheduler, o Background Task não executará o Scheduler novamente, até que esse receba a próxima mensagem Period para a tarefa Scheduler.

O Backgound Task utilize o mesmo comportamento ao executar as tarefas Alarm e Trend — quando o Backgound Task alterna para uma tarefa Alarm ou Trend, esse não alternará para outra tarefa até que todas as mensagens pendentes sejam manuseadas. Dessa forma, o Backgound Task não executará as tarefas Alarm ou Trend novamente até que o IWS gere a próxima mensagem Period para cada uma dessas tarefas.


InduSoft Web Studio

Página 120

O Backgound Task executa tipicamente as tarefas Alarm, Scheduler, e Trend em alguns milissegundos. Porém, pode lever um tempo maior para executar a tarefa Math, já que essa geralmente contém loops e scripts complexos. Conseqüentemente, o mecanismo utilizado para executar as tarefas Alarm, Scheduler e Trend não podem ser aplicadas para a tarefa Math.

O Background Task executa a tarefa Math por mais de 10ms continuamente antes de alternar para outra tarefa (como Scheduler). O Background Task não pode executar a tarefa Math novamente pelos próximos 50ms; porém, o Background Task pode executar outras tarefas (Alarm, Recipe, Report, Scheduler, ou Trend) durante esse período de 50ms. Após ter executado todas as planilhas Math a ferramenta não iniciará um novo scan das planilhas Math até que o IWS gere uma nova mensagem Period para a tarefa Math.

É importante dar ênfase para o processo de criação desse processo, projetado para prevenir o uso de 100% da capacidade da CPU o tempo todo.

Atenção: Recomendamos precaução ao utilizar a função Math() em uma planilha Scheduler ou para um objeto de tela (como o dinâmico Command).

Quando a tarefa Scheduler executa uma função Math(), nenhuma outra tarefa poderá ser executada pelo Background Task até que o Scheduler tenha executado de forma completa a planilha Math chamada pela função Math(). Esse processo pode levar vários milissegundos ou até segundos, dependendo de como você tenha configurado o script na planilha Math (especialmente para loops).

Caso você configure uma função Math() para um objeto de tela, o Viewer pára a atualização da tela até que o Viewer execute inteiramente a planilha Math chamada pela função Math().

Caso você necessite utilizar a função Math() para a tarefa Scheduler ou um objeto de tela, recomendamos a utilização do seguinte procedimento, prevenindo assim possíveis atrasos no processo:

Especifique um tag auxiliar com valor 1, e as tarefas Scheduler ou Viewer enviarão uma mensagem para o tags database a fim de atualizar esse valor de tag.

Configure o tag em um campo Execution da planilha Math a ser executada. Quando o Background Task escanear a planilha Math, o IWS executará a planilha.

Reinicie o tag na última linha da planilha Math (escreva o valor 0 para o tag auxiliar).

Como resultado, o Background Task não executará a planilha Math no próximo scan, a menos que o tag auxiliar seja configurado como valor 1 novamente.


InduSoft Web Studio

Página 121

Capítulo 5: Trabalhando com Tags Como discutido no Capítulo 4, o banco de tags database é o coração do IWS, já que é o responsável pelo gerenciamento do fluxo de dados entre módulos de runtime, bem como o armazenamento de todos os tags, valores do tag, e propriedades do Tag. O tags database é a media utilizada por todos os módulos para ler ou escrever valores do tag.

Esse Capítulo explica conceitos básicos sobre os tags, valores de tag e propriedades do tag utilizadas no tags database do IWS—incluindo como criar e editar tags para seus projetos.

Nota: Recomendamos a leitura e compreensão dos conceitos discutidos no Capítulo 4: Compreendendo a Estrutura do IWS, antes de ler esse Capítulo.

O que é um Tag? Tags são variáveis projetadas para receber resultados de expressões especificadas em telas e planilhas (como pontos de comunicação em equipamento de campo, resultado de cálculos, pontos de alarme, etc).

Todos os tags são organizados através das seguintes categorias (representadas por pastas no tab Database no Workspace):

• Aplication Tags são tags criadas durante o desenvolvimento da Aplicação.

Por exemplo:

o Tags da tela

o Tags de leitura/escrita para equipamento de campo

o Tags de controle

o Tags auxiliaries utilizados para executar calculos matemáticos

• Classes são tags compostos criados para associar um conjunto de valores (mais de um único valor) com uma classe. Estruturas de classes permitem um alto grau de encapsulamento junto ao tags database.

• Shared Database os tags são criados em um programa de software de controle baseado em PC e depois importados para o tags database do IWS.

Por exemplo, pode-se criar tags em SteepleChase e importá-los para o IWS, assim o IWS poderá ler/escrever dados de SteepleChase ,um produto de controle baseado em PC.

Nota: Pela necessidade de configurar um projeto ANTES de poder compartilhar tags, instruções para tal procedimento são fornecidas no Capítulo 6: Criando e Configurando um Projeto. Veja “Compartilhando Tags database com Programas de Controle Baseados em PC” na página 147.

Não é possível modificar tags compartilhados com o IWS—deve-se modificar os tags no programa de controle baseado em PC original, para depois reimportá-los para o tags database.


InduSoft Web Studio

Página 122

• Internal Tags são tags pré-definidos com funções pré-determinadas, e são utilizados para tarefas de supervisão do IWS. Por exemplo,

o Tags de data apresentam a data atual em formato de string

o Tags de hora apresentam o horário atual em formato de string

A maioria dos tags internos são read-only, significando que você não poderá adicionar, editar ou remover esses tags do banco de dados.

Para ver uma lista de tags internos, selecione o tab Database no Workspace, abra a pasta Internal Tags, e a abra a subpasta Tag List. A figura acima mostra uma lista parcial de tags internos.

Após criar um tag, Pode-se utiliza-lo em qualquer local da aplicação, além de poder utilizar o mesmo tag para mais de um objeto ou atributo.

Projetando um Tag Antes de criar um tag para determinado propósito, você deverá compreender quais os tipos de tags podem ser criados, além dos elementos básicos ou caracteres de um tag, que incluem:

• Tipos de dados de tags

• Compartilhados ou não

• Propriedades do Tag

Após ler as informações fornecdias nessa seção, você sera capaz de criar tags que adequem-se de forma apropriada às necessidades da sua aplicação.

Escolhendo o Tipo de Tag

O IWS permite a criação dos seguintes tipos de tags:

• Basic tags possuem um valor único

• Array tags conjunto de tags que utilizam um mesmo nome com indices únicos.

• Class tags conjuntos de tags compostos que consistem de tipos de dados definidos pelo usuário (Boolean, Integer, Real ou String) ou estruturas de tipo de dados.

• Indirect tags são apontadores que forncem acesso indireto a outro tipo de tag, incluindo classes de tags.

Segue-se uma breve discussão desses tipos de tags.

Tags básicos

Um Tag básico recebe um valor único. Tipicamente, a maioria dos tags definidos para uma aplicação do IWS são tags básicos. Alguns exemplos de um tag básico incluem:

• TankID (para identificar tanques diferentes em sua aplicação)

• Temperature (para identificar a temperature atual de um objeto)

• Status (para identificar se um objeto está aberto ou fechado)


InduSoft Web Studio

Página 123

Tags de Array

Um tag de array consiste de um conjunto de tags que possuem o mesmo nome, embora utilizem indices únicos de array (uma matriz de n linhas e uma coluna) para diferenciação entre cada tag. um array index pode ser um valor fixo, um outro tag ou uma expressão. Tamanhos máximos de array são determinados pelas especificações do produto.

Pode-se utilizar tags de array para:

• Simplificar configurações

• Habilitar multiplexidade em telas, receitas e interfaces de comunicação

• Economizar tempo de desenvolvimento durante declaração de tags

Pode-se especificar tags de array em um dos seguintes formatos:

• Para um tag de array simples, digite <ArrayTagName>[<ArrayIndex>]

• Para um tag de array complexo (onde o índice de array é uma expressão que consiste de um tag e uma operação aritimética), digite <ArrayTagName>[<anothertag>+c]

Onde:

<ArrayTagName> é o nome do tag

[<ArrayIndex>] é o indice único (valor fixo ou outro tag)

+ qualquer operação aritimética

c uma constante numérica

Notas: • Deve-se especificar um índice máximo para cada tag de array, digitando um

valor (n) na coluna Array Size de uma planilha Aplication Tags ou no campo Array Size de um diálogo New Tag. (Veja “Criando Tag database da Aplicação” na página 129).

Ao criar um tag de array de posição n, o IWS na verdade cria n+1 posições (de 0 a n). Por exemplo, se você especificar ArrayTag[15], o array terá 16 elementos; onde 0 é a posição inicial e 15 a posição final.

• Você não deverá utilizar espaços em um tag de array.

Ao ler um tag, o IWS começa pelo primeiro caractere, e continua até encontrar o primeiro espaço ou caractere nulo. Consequentemente, o sistema não reconhece quaisquer caracteres seguidos de espaço com parte de tag de array.

Por exemplo, digitando a[second + 1] o IWS reconhece a[second como o tag, e o considera inválido, pois o IWS não encontra (reconhece) o bracket closing. Porém, se você digitar a[second+1], esse é um tag de array válido.

Pode-se especificar um tag array em qualquer lugar onde você possa. Além disso, em razão dos tags array simplificarem de forma significativa as tarefas de configuração e economizarem tempo no desenvolvimento, sugerimos que estes sejam utilizados sempre que possível.

Por exemplo, suponha que você deseje monitorar a temperatura de quatro tanques. O método de configuração convencional é:

temperature1 high temperature on tank 1





InduSoft Web Studio

Página 124

Pode-se utilizar tags array para simplificar essa tarefa, como se segue (onde [n] representa o número do tanque):

temperature[n] high temperature on tank [n]

A tabela a seguir contém alguns exemplos adicionais de um tag array:

Exemplo de Array Tag Descrição

Tank[1], Tank[2], Tank[500] Arrays simples, onde os índices de array (1, 2 e 500) são constantes numéricas. Por exemplo, número de tanques.

Tank[tk] Arrays simples, onde o índice de array (tk) é um tag. Por exemplo, a tag representando o número de tanques.

Tank[tk+1] Array complexo, onde o índice de array (tk+1) é uma expressão. Por exemplo, o valor de tk (número de tanques) mais 1.

Exemplos de Tag Array

Tags Class

Class tags são tags compostos que permitem um alto grau de encapsulamento com tags database. Onde tags básicos recebem valores únicos, classes são projetados para receber valores múltiplos.

Pode-se criar um tag class-type agrupando tags básicos ou array, os quais se tornam membros de classe. O número máximo de membros para qualquer classe depende da especificação do produto.

Especifica-se tags class-type em um dos seguintes formatos:

• Para uma classe de tag simples, a sintaxe é <TagName>.<ClassMemberName>. (Onde o período é utilizado como separador.)

Por exemplo, caso você deseje monitorar várias condições diferentes (como temperatua, nível e pressão) em um tanque, deve-se criar um tag de classe como se segue:

Tank.Temperature

Tank.Level

Tank.Pressure

• Para criar um tag de classe complexo (utilizando um tag array) a sintaxe é <ArrayTagName>[<ArrayIndex>].<ClassMemberName>. (Onde, novamente, o período é utilizado como separator.)

Caso você deseje monitorar condições de temperatura, nível, e pressão em múltiplos tanques, deve-se criar um class tag como se segue:

Tank[tk].Temperature

Tank[tk].Level

Tank[tk].Pressure

Onde tk é um índice de array, representando o número do tanque.


InduSoft Web Studio

Página 125

Tags Indiretos

Tags indiretos “apontam” para tags de outros bancos de dados (incluindo tags class-type). Utilizando tags indiretos, pode-se economizer tempo no desenvolvimento, já que estes evitam a criação de tags duplicados (e também a lógica de construção neles incluídos).

Pode-se criar um tag indireto a partir de qualquer tag string-type, bastando digitar o símbolo “@” à frente do nome do tag: @<TagName>.

• Para Referir-se a um Tag simples, supor o tag strX (um tag string) guarde o valor To reference a simple tag, assume the strX tag (a string tag) holds the value “Tank,” o qual é o nome de outro tag, e depois a ler de ou escrever para @strX fornece acesso para o valor do tag Tank.

• Para referir-se a um Tag tipo classe e membro, você simplesmente cria um tag string que aponte para a tag class e membro. Por exemplo, se a tag strX (um tag string) guarda o valor “Tank.Level”, o qual é o nome do tag class, então lendo de ou escrevendo para @strX fornece acesso para o valor do tag Tank.Level To reference a class-type tag and member, you simply create a string tag that points to the class tag and the member. Por exemplo, if a tag strX (a string tag) holds the value “Tank.Level,” which is the name of the class tag, then reading from or writing to @strX provides access to the value of the Tank.Level tag.

Pode-se também apontar diretamente para um membro de tag class-type; identificando-se um class-type que Aponte para um membro de classe. Por exemplo: para acessar o membro Tank.Level da classe, deve-se armazenar o valor Tank com o tag strX , e utilizar a sintaxe: @strX.Level.

Escolhendo Tipo de Dados do Tag

Outra consideração sobre como projetar um tag é sobre qual tipo de dados o tag deverá receber. O IWS reconhece os seguintes tipos de dados de Tag como padrão:

• Boolean (um bit): Boolean ou variáveis digitais (0 ou 1). Tipicamente utilizados para deixar objetos ligados ou desligados (off e on) ou para fechar e abrir objetos.

• Integer (quatro bytes): número Integer (positivo, negativo, ou zero). Equivalente ao C-type, signed long integer (uma escala de –2147483648 até 2147483647). Tipicamente utilizado para contar ou configurar todos os números e valores.

• Real (floating point, oito bytes): Número Real que é armazenado internamente como uma palavra dupla. Equivalente ao C-type duplo. Tipcamente utilizado para medidas ou para valores decimais ou fracionários.

• String (dados alfanuméricos, 0–254 cacacteres): String de caractere com até 255 caracteres que suportam letras, números ou caracteres especiais. Suporta tanto caracteres ASCII quanto UNICODE.

Por exemplo: Recipe product X123, 01/01/90, *** On ***

Compartilhando Tags com um Web Thin Client

O IWS permite decider se um valor de tag pode ser compartilhado (exibido) com uma estação Web Thin Client.

• Local: Impede que um valor de tag na estação Server seja compartilhado com estações Web Thin Client.

• Server: Possibilita que um valor de tag seja exibido em uma página HTML, o que torna o valor disponível para um Web Thin Client.

Caso você deseje visualizar e gerenciar todas as suas aplicações remotamente, deve-se certificar-se de que a opção Server está especificada para todos os tags relacionados ao processo de gerenciamento. Por exemplo, caso voê queira responder alarmes remotamente, você deverá habilitar a opção Server para todos os tags relacionados ao gerenciamento de alarme.


InduSoft Web Studio

Página 126

Escolhendo Propriedades de Tag

Propriedades de Tag são atributos (ou parâmetros) que são inerentes a um tag do banco de dados (como valores mínimos/máximos, tamanho, descrição, etc).

Ao definir tags para uma aplicação do IWS, Pode-se especificar propriedades de tag que são utilizadas durante o runtime como campos de tag. Esses campos de tag do runtime são descritos na tabela a seguir.

Tipo de tag Associado ao Campo Nome do Campo do tag

Descrição do Valor Associado a Cada Campo

Boolean Integer Real String

R=Read Only RW=Read+Write

Description Descrição do Tag (no Banco de Dados deTag)

RW

Max Valor máximo que pode ser escrito para o tag durante runtime.

RW

Min Valor mínimo que pode ser escrito para o tag durante runtime

RW

Quality Qualidade do Tag (192=GOOD; 0=BAD).

O Campo atualiza-se cada vez que resultados de expressões são recebidos ou um valor de tarefa de comunicação (Driver ou OPC).

Expressões inválidas (como divisão por zero) ou erros na comunicação de leitura associados ao tag que configurará a qualidade do tag como BAD de forma automática.

R

Size Tamanho do Array. Caso o tag não seja um tag array, o valor retorna para 0.

R

TimeStamp Hora & Data que o valor do tag é alterado.

R

Unit Descrição breve (até nove caracteres) da unidade de engenharia do valor do tag (Por exemplo: Kg).

RW

B0 … B31 Valor (0 ou 1) de qualquer dos 32 bits (b0, b1, b2, … b31) de um tag integer. (B0: LSB B31: MSB).

RW


InduSoft Web Studio

Página 127





Valor Integer contendo o status de todos os alarmes atualmente ativos associados ao tag. Cada bit desse valor de integer indica um status específico, como se segue:

• Bit 0 (LSB): HiHi Alarm active • Bit 1: Hi Alarm active • Bit 2: Lo Alarm active • Bit 3: LoLo Alarm active • Bit 4: Rate Alarm active • Bit 5: Deviation+ Alarm active • Bit 6: Deviation- Alarm active

R AlrStatus

Por exemplo:

If Tag->AlrStatus retorna para valor 2, “Hi” alarm is active. If Tag->AlrStatus retorna para valor 3, “HiHi” and “Hi” alarme ativos simultaneamente. If Tag->AlrStatus retorna para valor 0, não há alarmes ativos associados a esse tag.

Para tags Boolean, somente valores 1 (bit 1), 4 (bit 2) ou 16 (bit 4) os valores são retornados.

Ack Esse campo pode ter dois valores :

• 0: Sem alarmes associados com esse tag.

• 1: Pelo menos um alarme associado com esse tag.

RW

AlrDisable Esse campo pode ter dois valores:

• 0: Habilita alarmes associados com tag. Quando ocorre condição de alarme, o alarme torna-se ativo.

• 1: Desabilita alarme associado com tag. Caso ocorra condição de alarme, o alarme não se tornará ativo.

RW

HiHi • If 0, HiHi alarme inativo. • If 1, HiHi alarm ativo.

R

Hi • If 0, Hi alarme inativo. • If 1, Hi alarme ativo.

R

Lo • If 0, Lo alarme inativo. • If 1, Lo alarme ativo.

R


InduSoft Web Studio

Página 128





LoLo • If 0, LoLo alarme inativo. • If 1, LoLo alarme ativo.

R

Rate • If 0, Rate alarme inativo. • If 1, Rate alarme ativo.

R

Devp • If 0, Dev+ alarme inativo. • If 1, Dev+ alarme ativo.

R

Devm • If 0, Dev- alarme inativo. • If 1, Dev- alarme ativo.

R

HiHiLimit Valor limite para alarme HiHi. RW

HiLimit Valor limite para alarme Hi. RW

LoLimit Valor limite para alarme Lo. RW

LoLoLimit Valor limite para alarme LoLo. RW

RateLimit Valor limite para alarme Rate. RW

DevSetpoint Valor Set point para alarmes Deviation .

RW

DevpLimit Valor limite para alarme Deviation+. RW

DevmLimit Valor limite para alarme Deviation-. RW

Tabela de Campoz de Tag

Para acessar um campo de tag no runtime, digite o nome do tag e campo (utilizando a sintaxe: TagName->Field) no Database Spy, uma janela de comando, ou um campo de execução.

Atenção: Não é possível utilizar campo de tag (como campos Bit) para configurar planilhas Alarm ou Trend.

Embora seja possível aplicar propriedades do tag para tags internos, tais propriedades não persistirão se for feito um download de sua aplicação em um equipamento CE.


InduSoft Web Studio

Página 129

Nota: Caso uma aplicação tente escrever um valor para o tags database que saia da escala especificada nos campos Min e Max, o banco de dados não aceitará o novo valor e escreverá uma mensagem para a window Output do IWS.

Caso você especifique zero (0) para os campos Min e Max, a Aplicação poderá escrever qualquer valor para tipo do tag no tags database.

Criando Tag database da Aplicação Essa seção explica o processo para criação de tags básicos, array e pointero para a aplicação de seu projeto.

Notas: Ao especificar o nome do tag, deve-se aderir às seguintes guidelines:

Seus nomes de tag devem ser únicos — não Pode-se especificar o mesmo nome para dois tags ou (funções) diferentes. Caso você digite um nome de tag já existente, o IWS reconhece que o nome já existe, e não criará o novo tag.

Deve-se iniciar cada nome de tag com uma letra. De outra forma, Pode-se utilizar letras, números e um caractere underscore (_) em seu nome de tag.

Não Pode-se utilizar os seguintes símbolos em um nome de tag:

` ~ ! @ # $ % ^ & * ( ) - = \ + \ [ ] { } < > ?

Pode-se utilizar um máximo de 255 caracteres para um nome de tag ou nome de membro de classe.

Pode-se utilizar caracteres em letra maiúscula ou minuscula, pois o IWS não estabelece diferença entre caracteres em letra maiúscula ou minúscula. Ambos podem ser utilizados para tornar os nomes de tags mais legíveis (por exemplo: TankLevel ao inves de tanklevel). Alguns outros exemplos de nomes de tags incluem: Temperature, pressure1, count.

Para economizer tempo, o IWS permite a criação e edição de tags a partir de uma variedade de localizações junto ao ambiente de desenvolvimento.

• Pode-se adicionar tags utilizando planilha de tags da aplicação

• Pode-se adicionar tags “on-the-fly” a partir de um menu pop-up ou de qualquer text box Tag ou Expression (localizado nos diálogos Object Properties, planilhas, etc)

Instruções e métodos para adição de tags são fornecidas nas próximas duas seções.


InduSoft Web Studio

Página 130

Adicionando Tags para a Planilha da Aplicação

Siga os seguintes passos para criar tags a partir da planilha de tags da aplicação:

Seleione o tab Database e abra a pasta Aplication Tags.

Clique duas vezes no ícone Datasheet View para abrir o datasheet Aplication Tags:

Datasheet Aplication Tags

Localize uma linha vazia no datasheet e configure os seguintes campos. (Dica: Você pode utilizar a tecla Tab para mover para a próxima coluna.)

o Campo Name: Digite um nome utilizando a sintaxe descrita para o tipo de tag que está sendo criado (veja “Criando Tag database da Aplicação”) que adeque-se aos guidelines descritos na página 129.

o Campo Array Size:

Para um tag array, digite um valor para especificar o índice máximo desse array.

Para qualquer outro tipo de tag, digite (0).

o combo-box Type: Clique na seta para selecionar tipos de dados do tag (Boolean, Integer, Real, ou String) na lista. (se necessário, reveja “Escolhendo Tipos de Dados doEscolhendo Tipo de Dados do Tag” na página 125.)

o Campo Description (opcional): Digite uma descrição para fins de documentação.

o combo-box Web Data: Clique na seta para especificar se o valor do tag sera compartilhado (exibido) com estações Web Thin Client.

Local: Impede que um valor de tag do Server seja compartilhado com estações Web Thin Client. Por exemplo, quando você deseja visualizar um valor de tag em sua estação de trabalho, não interferindo no valor de tag exibido em outras estações de trabalho Web Thin Client.

Server: Compartilha um valor de tag do Server com estações Web Thin Client. Por exemplo, quando você deseja compartilhar/vizualizar valores (como On ou Off).

Clique em uma nova linha para criar um outro tag ou salve diretamente o(s) tag(s) no banco de dados de Tags (File → Save) e feche o datasheet Aplication Tags.


InduSoft Web Studio

Página 131

O exemplo a seguir mostra uma variedade de tags configurados em um datasheet Aplication Tags.

Exemplo de Datasheet Aplication Tags

Adicionando Tags “On-the-Fly”

Como alternativa, evitando a abertura do datasheet Aplication Tags cada vez que você deseja criar um novo tag, o IWS permite a criação de tags individuais “on-the-fly”:

• Clique com o botão direito na pasta Aplication Tags, no ícone Datasheet View ou na sub-pasta Tag List e selecione Insert Tag no menu pop-up.

Inserindo um Tag

• Digite um novo nome de tag em um text box Tag/Exp (disponível nos diálogos Object Properties, planilhas, etc). Um diálogo Question aparecerá, e clique em Yes para criar um novo tag.

Criando um Novo Tag


InduSoft Web Studio

Página 132

Utilizar tais procedimentos fará com que um diálogo New Tag apareça:

Diálogo New Tag

Os campos e combo-boxes nesse diálogo correspondem em nome e função às colunas no datasheet Aplication Tags. Consequentemente, Pode-se configurar esse diálogo utilizando as instruções fornecidas nas páginas 130. Ao terminar, clique em OK para salvar o tag no tags database e feche o diálogo New Tag.

Reiniciando o Tags database

Seleione Tools > Reset Tags Database para regravar o tags database na estação local. Esse commando afeta todos os tags armazenados na pasta Aplication Tags. Essa opção é útil para reiniciar tags da aplicação e restaurar valores da aplicação quando essa foi gravada pela primeira vez. Ao parar a aplicação e deixar o ambiente de desenvolvimento aberto, os tags, por padrão, não são reiniciados quando a aplicação é novamente iniciada. Portanto, Pode-se executar esse comando para reiniciá-los antes da aplicação rodar novamente.

Quando esse comando é executado, o Valor Startup configurado para cada tag (diálogo Tags Properties) é escrito ao respectivo tag. Caso você não configure um Startup Value para um tag numérico (Boolean, Integer ou Real), o valor 0 (zero) é escrito para o tag. Caso você não configure um Startup Value para um tag string, o valor vazio (“”) é escrito para o tag.

Esse commando está desabilitado (em cinza) caso haja ao menos uma terefa em runtime na estação local. Deve-se fechar todas as tarefas em runtime (Project > Stop Application) antes de executar esse comando.

Nota: Os tags armazenados nas pastas Internal Tags e Shared Tags (caso haja) não são afetados por esse commando.

Dica:

Caso você deseje reiniciar os tag da aplicação automaticamente sempre que rodar a aplicação (Project > Run Application), Pode-se habilitar a opção Reset Tags Database when starting Application no tab Preferences do diálogo Project Settings.

Criando Classes Para criar um tag class:

No tab Database, clique com o botão direito na pasta Classes, e selecione Insert Class do menu pop-up que aparecer.


InduSoft Web Studio

Página 133

Inserindo Class em Popup

Quando o diálogo Insert Class aparecer, digite um nome no campo Name utilizando a sintaxe da página 124 e as diretrizes indicadas na página 129.

Diálogo Insert Class

Clique em OK para fechar o diálogo Insert Class e a planilha Class: aparecerá automaticamente.

Configure as colunas desta planilha como se segue:

o Campo Name: Digite um nome do membro de classe (Veja página 124).

o combo-box Type: Clique na seta para selecionar o tipo de dados do membro de classe (Boolean, Integer, Real, ou String) na lista.

o Campo Description (opcional): Digite uma descrição do membro de classe (para fins de documentação somente).

Planilha exemplo de CTank

Clique na próxima linha em branco e forneça as informações para o próximo membro de classe que você deseja incluir nessa classe. Ou, caso você tenha terminado de adicionar todos os membros, feche a planilha Class.

Pode-se expandirr a pasta Classes e as subpastas para vizualizar a estrutura dos dados:


InduSoft Web Studio

Página 134

Pasta Classe Expandida

A seguir, utilize as instruções fornecidas em “Criando Tag database da Aplicação” na página 129, para criar e associar um tag com o nova classe.

Note que, ao clicar no botão de seta para visualizar a lista Type, seu novo nome de classe (CTank) já está incluído (veja a linha 5 da figura a seguir). Selecione o nome de classe da lista.

Criando o tag class Tank

Ao terminar, salve seu trabalho e feche a planilha.

Configurando Propriedades de Tag Essa seção explica como configurar propriedades de tag.

No tab Database, abra o datasheet Aplication Tags (ou exiba a lista de tags no Workspace) e coloque o cursor no tag que você deseja configurar propriedades.

Clique no botão Tags Properties na barra de ferramentas Tags Properties.

Um diálogo Tag Properties aparecerá de forma similar ao que se segue:


InduSoft Web Studio

Página 135

Diálogo Tag Properties

Um diálogo Tag Properties pode possuir um, dois ou três tabs, dependendo do tipo de tag selecionado no datasheet:

• Parameters: Utilize esse tab para configurar retenção, startup e propriedades da unidade.

• Alarms - Type: Utilize esse tab para habilitar, configurar e visualizar propriedades de alarme.

• History - Type: Utilize esse tab pata habilitar, configurar e visualizar propriedades históricas.

Nota: Nem todas as propriedades estão disponíveis para todos os tipos de tags. Consequentemente, os recursos de cada tab podem variar, dependendo do tipo de tag selecionado. Por exemplo, valores Minimum e Maximum não são necessarias para tags String.

Reveja a tabela na página 126 para ver quais propriedades estão disponíveis para os diferentes tipos de tags.

Instruções sobre como configurar os parâmetros em cada tab estão disponíveis a seguir.


InduSoft Web Studio

Página 136

Configurando os Parâmetros de Propriedades do Tag

Essa seção explica como configurar todos os diferentes parâmetros de propriedades de tags. Lembre-se de que a variabilidade de cada parâmetro depende do tipo de tag selecionado.

Tag Properties: Tab Parameters

• check-box Retentive Value: Habilite ( ) esse box para salvar continuamente o valor do tag, caso o sistema desligue-se inesperadamente. Ao reiniciar o sistema, o tag reterá o último valor salvo.

Atenção: Especificar o parâmetro Retentive Value para tags com valores alteráveis pode causar o acesso frequente ao disco rígido, o que diminui a perfdormance do programa.

• check-box Retentive Parameters: Habilite ( ) esse box para salvar todas as alterações feitas nos campos de tags durante o runtime.

• Campo Startup Value: Digite um valor do tag para carregar o sistema. O tag utilizará esse valor caso você desabilite a opção Retentive Value.

• Campo Min (acessível durante o runtime): Digite um valor mínimo para o tag em unidade de engenharia.

• Campo Max (acessível durante o runtime): Digite um valor máximo para o tag nas unidades de engenharia.

Caution:

O IWS não pode aceitar valores de tags que saiam das escalas especificadas Min/Max. Porém, o IWS gerará uma mensagem na window Output para mantê-lo informado que o sistema tentou escrever um valor, o qual estava fora dos padrões definidos.

• Campo Unit (acessível durante o runtime): Digite uma string (de até nove (9) caracteres) para especificar as unidades do tag (como Ohms, deg., ou MHz) para propósitos de exibição.


InduSoft Web Studio

Página 137

• check-box Dead Band: Habilite ( ) esse box e digite um valor no text box fornecido para aplicar um valor banda morta para o tag.

Um valor banda morta representa uma variação permitida acima e abaixo do valor central de um tag (não reconhecido para alarmes). Quando o valor de tag exceder a banda morta permitida, o IWS gerará um alarme.

• check-box Smoothing: Habilite ( )esse box para reduzir a taxa de troca para o valor do tag.

Por exemplo, caso você especificar Smoothing para um tag contendo o valor 50, e o a próxima pesquisa, o IWS armazena a media de 50 + 60 no banco de dados, e o novo valor sera igual a 55.

Configurando os Alarmes – Tab de Propriedades de Alarmes

Essa seção explica como visualizar e configurar todas as propriedade de alarme para um tag selecionado.

Diálogo Tag Properties: Tab Alarms - Type

• check-box Alarms Enabled: Habilite ( ) esse box para ligar a função de alarme para esse tag.

• Campo Remote Ack tag: Digite um tag para permitir que um receptor saiba sobre um alarme remotamente, o que ocorre quando os valores do tag são alterados.

• Campo Dead Band Value: Digite um valor para especificar uma variação de banda morta. O IWS utilize esse valor para filtrar alarmes.

Por exemplo, caso você configure o tag TANK com Alarm Limit Value = 90 e Dead Band Value = 5, o IWS gerará um alarme quando TANK for ≥ 95. O alarme retorna para o normal (normalize) quando o valor do TANK for ≤ 90.

• check-box Translation Enabled: Habilitando ( ) esse box permite ao IWS traduzir mensagens de alarme para outro(s) idioma(s). (Para maiores informações sobre tradução de aplicações, leia o Capítulo 16: Utilizando o Translation Editor.)

Nota: O IWS salva automaticamente mensagens de Alarme com o atributo Translation Enabled já habilitado por padrão. Essas mensagens são salvas em um arquivo


InduSoft Web Studio

Página 138

chamado Alarm.txt, localizado no diretório \DATABASE\ de sua aplicação.

• check-boxes Alarm type (disponíveis durante o runtime): Habilita ( ) um ou mais dos seguintes tipos de alarme para esse tag

HiHi: Habilita alarmes Very High

Hi: Habilita alarmes High

Lo: Habilita alarmes Low

LoLo: Habilita alarmes Very Low

Rate: Cria um alarme baseado na taxa de alteração

Deviation+: Cria um alarme baseado em uma derivada do set point assinalado

Deviation–: Cria um alarme baseado em uma derivada do set point assinalado

Por exemplo:

Para SetPoint = 50, Deviation + = 5, Deviation – = 5, e Deviation Dead Band = 0.5 o IWS gera um alarme, onde a temperature é maior que 55.5 ou menor que 44.5 e retorna ao normal quando a temperatura é maior que 45 ou menor que 55.

Ao habilitar quaisquer tipos de alarmes precedentes, os seguintes campos aparecerão no tab Alarms:

Alarm Tab Fields

Configure esses campos (correspondentes às colunas da planilha Alarm) como se segue:

Limit: Digite um valor para especificar limites para o tipo de alarme. Note que o parâmetro Rate também fornece uma lista, a qual permite a especificação de uma taxa para esse limite 1/s(econd), 1/min(ute), e 1/hour.

Message: Digite um string de mensagem para exibir quando o IWS deverá gerar um alarme.

Group: Digite um valor indicando qual número do grupo (número da planilha) esse tab pertence. O IWS utilize esse valor para filtrar alarmes de um ou mais grupos de usuários. Pode-se também utilizar uma virgula ou barra para especificar mais de um grupo (Por exemplo, 1,3,5-6).


InduSoft Web Studio

Página 139

Priority: Digite um número inteiro (de 0 a 255) para indicar prioridade em um grupo. Tags com uma prioridade mais alta devem ter valores de prioridade maiores.

Selection: Digite um string que sera utilizado para filtrar mensagens de alarme. Esse string pode possuir um máximo de sete caracteres (todos os outros caracteres serão ignorados).

• Campo Deviation SetPoint (acessível durante o runtime): Digite um valor indicando um ponto de referência para a derivação.

• Campo Deviation Dead Band (acessível durante o runtime): Digite um valor indicando um valor de banda morta de referência para essa derivação.

• check-box Off: Habilite ( ) esse box para gerar um alarme quando o valor do tag for zero.

• check-box On: Habilite ( ) esse box para gerar um alarme quando o valor do tag for one.

• check-box Changed: Habilite ( ) esse box para gerar um alarme sempre que o valor do tag se altere.

• painel Mnemonic: Utilize os campos Off, On, e Ack para configurar mneumônicos (Por exemplo, Closed ou Open) para os estados do alarme Off, On, e Ack (tags Boolean somente). Durante o runtime, o Objeto Alarm/Event Control exibe esses mneumônicos na coluna Value para tags Boolean associados com a mensagem de alarme.

Nota: Caso você não configure um mneumônico, o Objeto Alarm/Event Control exibe um valor de tag (0 ou 1) na coluna Value.

Configurando Propriedades do Histórico

Essa seção explica como vizualizar e configurar propiedades do histórico para um tag selecionado. Essas propriedades correspondem a colunas, em uma planilha Trend (na qual sera discutida na página 298). O IWS desabilita essas propriedades do tab caso você tenha uma planilha Trend aberta. Antes de utilizar esse diálogo, deve-se já ter criado grupos Trend.

Diálogo Tag Properties: Tab History

Notas: Históricos não suportam tags tipo string.

O IWS salva arquivos históricos automaticamente (.hst) na pasta Aplicação, a menos que você altere esse padrão local explicitamente.


InduSoft Web Studio

Página 140

No diálogo Tag Properties, habilite históricos logando como se segue:

• check-box History Enabled: Habilite ( ) esse box para armazenar exemplos de valores de tag.

• Campo Group Number: Digite o número do grupo associado com esse tag.

• Campo Log Dead Band: Digite um valor para especificar uma variação de Dead Band para logs. Quando o valor do tag for igual ou maior que esse valor, o IWS levará essa amostra para o arquivo histórico.

Configurar esse valor não afeta o valor Dead Band que já deve estar especificado no tab Alarm.

Nota: Embora você possa aplicar propriedades de tag para tags Internos, caso você faça download de tags Internos para equipamento CE, as propriedades do tag não persistirão através do download. Você perderá tais propriedades.

Utilizando Tags em Sua Aplicação Uma vez adicionados tags ao banco de dados de sua aplicação, você poderá utilizar os tags associando-os a objetos na tela da aplicação.

O processo básico para associação de tag à tela consiste dos seguintes passos:

Na tela da aplicação, selecione o objeto no qual você deseja associar o tag.

Clique em um dos botões de propriedades e um diálogo Object Properties aparecerá.

Localize o text box Tag para a propriedade em questão e digite o nome do tag dentro do campo.

Nomes e localizações do text box Tag podem variar, dependendo do tipo de propriedade que você está utilizando. Por exemplo:

Aplicando Tags a um Objeto

Instruções de fácil compreensão para aplicação de tags a objetos de tela são fornecidas ao longo desse manual no momento apropriado.

Editando Tags Pode-se alterar as propriedades de um tag em qualquer momento durante o desenvolvimenhto ou runtime. Essa seção descreve dois métodos que podem ser utilizados para edição de tags.


InduSoft Web Studio

Página 141

Nota: Pode-se clicar com o botão direito em uma propriedade de tag e utilizar os comandos padrão do Windows para cortar (Ctrl+X), copiar (Ctrl+C), ou colar (Ctrl+V) qualquer tag e suas propriedades. Pode-se também desfazer (Ctrl+Z) a última modificação feita em um campo.

Do Datasheet de Tags da Aplicação

Siga os seguintes passos para editar um ou mais tags no datasheet Tags aplication:

Selecione o tab Database e clique duas vezes no botãot Datasheet View .

Quando o datasheet Aplication Tags abrir, localize seu tag.

Clique duas vezes na coluna que contenha as informações a serem alteradas, e digite as novas informações no datasheet.

Ao finalizar a edição, selecione File → Save para salvar suas alterações no tags database.

Dica:

Pode-se escolher os dados no sheet Aplication Tags e/ou inserir/remover colunas adicionais ao sheet clicando-o e escolhendo a opção aplicável, no menu pop-up.

Da pasta Tag List

Utilize os passos a seguir para editar um ou mais tags na pasta Tag List:

Selecione o tab Database e clique duas vezes na pasta Tag List para visualizar uma lista de todos os seus tags.

Localize seu tag e clique duas vezes no nome do tag para abrir um diálogo Properties.

Nota: Pode-se também clicar duas vezes no ícone do tab e selecionar Properties do menu pop-up.

Diálogo Properties

O diálogo Properties contém campos e combo-boxes que correspondem em nome e função a colunas no datasheet Aplication Tags.

Faça suas alterações no diálogo Properties como se segue:

– Par alterar as propriedades atuais Tag Type ou Web Data, clique no botão de seta e selecione a nova informação da lista.


InduSoft Web Studio

Página 142

– Para alterar Array Size ou Description, clique com o cursor no texto existente e digite a nova informação no text box.

Clique em OK para salvar suas alterações ao tags database e feche o diálogo Properties.

Dica:

Pode-se alterar os dados no sheet Aplication Tags e/ou inserir/remover colunas adicionais do sheet clicando com o botão direito e escolhendo a opção aplicável do menu pop-up.

Deletando Tags

Atenção:

Antes de deletar um tag, recomendamos a utilização do botão Object Finder na barra de ferramentas Tag Properties (veja “Utilizando o ícone Object Finder” na página 85) a fim de verificar que você não está utilizando o tag em outra parte da Aplicação (telas planilhas de math, etc). Caso você deletar um tag do banco de dados da aplicação que ainda esteja sendo utilizado, um erro de compilação será causado e sua aplicação funcionará de uma maneira menos satisfatória.

Para deletar um tag do tag database, siga os passos a seguir:

Abra a planilha do projeto Aplication Tags como descrito na página 141.

Localize e clique no nome do tag que você deseja deletar.

Recorte o tag da página como se segue:

Selecione Edit → Cut da barra de menu principal.

– Clique com o botão direito no nome do tag e selecione Cut do menu pop-up.

– Aperte Ctrl+x no teclado.

Quando aparecer o prompt de pop-up “Are You Sure?” clique em Yes para continuar ou em No para cancelar a deleção.

Salve a página (File → Save).


InduSoft Web Studio

Página 143

Capítulo 6: Criando e Configurando um Projeto Esse Capítulo explica como criar e configurar projetos no InduSoft Web Studio. As informações nesse capítulo estão organizadas da seguinte maneira:

• Criando Aplicação para um Novo ProjetoProjeto

• Especificando Configurações Adicionais do Projeto

• Iniciando Módulos de Runtime no Target system

Criando Aplicação para um Novo Projeto Utilize os seguintes passos para criar a aplicação para um novo projeto:

A partir da barra de menu principal, selecione File → New.

Quando o diálogo New aparecer, selecione o tab Project.

Diálogo New: Tab Project

Ë necessário fornecer um nome para a aplicação do projeto, além de indicar onde deverá ser armazenado tanto o projeto quanto todos os arquivos a ele relacionados (como os arquivos de configuração).

Digite um nome na caixa de texto Application name —nunca esquecendo-se de que:

– Você deverá seguir as convenções de nomeação usuais do Windows.

– Não utilize espaços caso você queira acessar seu projeto a partir da Web. (URLs não reconhecem espaços.)

Nomeando o Projeto


InduSoft Web Studio

Página 144

Notas: O IWS armazena todos os projetos, por padrão, no diretório C:\Documents and Settings\My Documents\InduSoft Web Studio v6.1 Projects\, assim esse caminho estará exibido no campo de texto Location (um campo view-only) automaticamente.

A caixa de texto Configuration file também é um campo view-only. O IWS armazena automaticamente seu arquivo de configuração do projeto na mesma pasta onde está seu projeto.

Armazenando Projeto e Arquivos de Configuração

Para salvar seu projeto em um local que não seja no diretório padrão, clique no botão Browse para localizar e selecionar uma pasta.

Selecione um nível de licença a partir da lista Target platform para indicar a plataforma na qual você rodará esse projeto.

Lista Target Platform

Para verificar o nível de sua licença atual, feche todos os módulos do IWS, e depois selecione Start → Programs → InduSoft Web Studio → Register.

Quando o diálogo Protection Manager aparecer, clique no botão Check para abrir o diálogo Hardkey Settings ou Softkey Settings (dependendo do seu tipo de proteção da licença), o qual deverá conter as informações de sua licença atual.

Feche ambos os diálogos quando estiver terminado.


InduSoft Web Studio

Página 145

Verificando o seu nível de Licença

IMPORTANTE!

Caso você tente abrir ou desenvolver uma Aplicação que tenha sido originalemnte desenvolvida com a utilização de uma licença mais avançada do que a existente, o IWS irá impedí-lo de abrir a Aplicação e colocará em modo Demo. Para corrigir essa situação, selecione Project → Settings na barra de menu principal. Quando aparecer o diálogo Project Settings, selecione o tab Options, e clique no botão de seta Target Station. O IWS exibe somente aquelas plataformas alvo as quais são autirizadas para utilizá-lo. Selecione uma dessas plataformas para acomodar seu nível de licença atual.

Embora a licença possa ser alterada (utilizando o diálogo Project Settings), recomendamos que você verifique e selecione seu nível de licença atual, evitando assim a perda de tempo no desenvolvimento da aplicação que requeira um nível de licença não compatível ao atualmente configurado para utilizar o equipamento de runtime. Recomendamos também o desenvolvimento com o menor nível de licença caso você esteja rodando sua aplicação em computadores múltiplos e com diferentes licenças.

Ao terminar a configuração da tab Project, clique em OK para fechar o diálogo New.

O diálogo Project Wizard aparecerá automaticamente, como se segue:


InduSoft Web Studio

Página 146

Diálogo Project Wizard

Enforce Viewer/Web compatibility: Quando esta opção é checada, o modo de engenharia ajuda o usuário a configurar a aplicação, sabendo quais funções funcionarão ou não em plataformas remotas (InduSoft Secure Viewer e Web Thin Client). Nota: Na aplicação precedente esta opção é deschecada para manter compatibilidade.

Utilize esse diálogo para especificar um modelo, configurar a resolução padrão de tela e para indicar que você deseja compartilhar tags com outros banco de dados do produto de softwares do sistema, como Steeplechase ou ISaGRAF.

Instruções para a utilização desses recursos são fornecidas nas seções que se seguem.

Especificando a Resolução Padrão de uma Tela

Utilize os botões no painel Resolution para especificar uma resolução padrão (dimensão para exibição) para as telas da aplicação de seu projeto.

Selecionando uma Resolução Padrão

Nota: Pode-se ajustar a resolução da tela “on-the-fly” selecionando Tools → Convert Resolution. O recurso Convert Resolution utilize a resolução de tela padrão com uma base e converte o tamanho de todas as telas da Aplicação de seu projeto.


InduSoft Web Studio

Página 147

Compartilhando Tags de Banco de Dados do Programa de Controle Baseado em PC

Pode-se configurar seu projeto para que sejam compartilhados tags do banco de dados criados em um programa de controle baseado em PC, como SteepleChase ou SixNet. Ao definer uma relação de compartilhamento e selecionar um banco de dados, o IWS entregará os tags e irá adicioná-los ao banco de dados de sua aplicação. O IWS também configura as planilhas do Driver da Aplicação e tags para utilize-las no outro programa.

Nota: Não é possível modificar tags compartilhadas com o IWS—deve-se modificar os tags no programa de controle baseado em PC, e depois reimportá-las para o tag databases.

Para definer uma relação de compartilhamento entre IWS e um programa de controle baseado em PC, siga os passos a seguir:

Partir do painel Shared Tags no diálogo Project Wizard, selecione um dos seguintes programas de software da lista Name.

First ISaGRAF

ISaGRAF

Think & Do

SteepleChase

SixNet

Open Control

Straton

Quando o botão Configure tornar-se ativo, clique nesse botão para abrir o diálogo Configure:<Program Name>.

Compartilhando Tags

No painel Diretório da Aplicação clique(habilite) um dos seguintes botões:

Create: Cria um diretório para uma nova Aplicação.

Select: Fornece a localização de um diretório de aplicação já existente.


InduSoft Web Studio

Página 148

Digite o caminho do diretório e nome da pasta no campo Select, ou clique no botão Browse para selecionar a localização.

Nota: Os parâmetros restantes no diálogo Configure:<Program Name> poderão variar dependendo do programa selecionado no primeiro passo. Cada programa de controle baseado em PC possui sua própria e costumizada interface. Antes de compartilhar informações entre Aplicação de controle baseado em PC e o IWS, deve-se fornecer as informações sobre a interface do programa de controle.

Utilize a documentação do fabricante para seu programa de controle baseado em PC, e configure os parâmetros restantes no diálogo Configure:<Program Name>:

Parâmetro Descrição

text field Server Name O IWS completa automaticamente esse campo. Para alterar o padrão, digite as informações apropriadas na caixa de texto.

check-box Automatic exchange data Habilitar ( ) esse box permite que os dois programas troquem dados automaticamente.

check-box Communication with Simulation Mode

Habilitar ( ) esse box permite que os dois programas comuniquem-se em Modo de Simulação.

text field IP Address (Think and Do only) Digite o endereço IP da Aplicação controle baseada em PC compartilhada.

Painel de Opções do Projeto:

Campo de texto Name (Steeplechase e SixNet somente)

Digite o nome da Aplicação de controle baseada em PC compartilhado.

Campo de texto Status (Steeplechase somente)

Digite o status atual da Aplicação de controle baseada em PC.

Campo de texto Version (Steeplechase somente)

Digite a versão atual da Aplicação de controle baseada em PC compartilhada.

Campo de texto Last Modification (SixNet somente)

Digite a data quando a Aplicação de controle baseada em PC foi atualizada pela última vez.

Botão Update (Steeplechase e SixNet somente)

Clique nesse botão para atualizar sua Aplicação do IWS com os dados da Aplicação de controle baseada em PC compartilhada.

Configure: Tabelas de Parâmetro <Program Name>


InduSoft Web Studio

Página 149

Especificando Configurações de Projeto Adicionais Após a criação de um novo projeto, você pode utilizar os passos a seguir para configurar alguns parâmetros adicionais para tal projeto:

A partir da barra de menu, selecione Project → Settings tpara abrir o diálogo Project Settings, o qual controla configurações que afetam a Aplicação como um todo.

Diálogo Project Settings –Tab Identification

O diálogo Project Settings contém cinco tabs:

Identification

Options

Runtime Desktop

Communication

Web

Preferences

As descrições de cada tab, e as instruções para os parâmetros de configuração dessas tabs estão na próxima seção.

Ao terminar a configuração dos parâmetros no diálogo Project Settings, clique em OK para fechá-lo.

Nota:

Embora voce possa trocar os parâmetros em Project Settings a qualquer momento durante o desenvolvimento da Aplicação, recomendamos a configuração desses parâmetros já no começo de seu projeto.

Por exemplo, o campo Startup screen define qual tela abrirá ao iniciar sua aplicação. Dessa forma, caso você tente modificar ou rodar a aplicação sem um


InduSoft Web Studio

Página 150

valor legítimo nesse campo, o IWS gerará uma mensagem de erro.

Provendo informações de Identificação do Projeto

Ao abrir o diálogo Project Settings, aparecerá o tab Identification por padrão:

Diálogo Project Settings:Tab Identification

Utilize os campos de texto nesse tab para fornecer as informações a respeito de seu projeto.

Configurar esses campos é uma tarefa opcional, mas as informações podem ser muito úteis caso você esteja compartilhando sua aplicação do projeto com colegas de trabalho, clientes, etc.

Description: Fornece uma breve descrição de seu projeto (como seu propósito).

Revision: Digite o número/letra da revisão atual para manter um traçado das revisões feitas para sua aplicação.

Company: Digite o nome de uma companhia para associar seu projeto com uma companhia particular (por exemplo, o nome de sua companhia ou a companhia de seu cliente).

Author: Digite o nome do autor de seu projeto.

Field Equipment: Forneça o nome ou tipo de equipamento no qual a aplicação do projeto estará rodando.

Notes: Insira quaisquer notas que você ache que sejam úteis.

Ao terminar, clique em outro tab para continuar ou feche o diálogo.

Configurando as Parâmetros do Tab Options

Selecione o tab Options para configurar o que se segue:

• Habilitar tradução de linguagem

• Especificar um target system

• Especificar por quanto tempo salvar um arquivo Alarm History

• Indicar o compartilhamento de tags com outra aplicação do software

• Especificar como buffer comandos de Driver e escrita OPC

• Especificar uma porta TCP


InduSoft Web Studio

Página 151

• Configurar parâmetros para o banco de dados padrão

Diálogo Project Settings –Tab Options

Segue uma descrição dos parâmetros do tab Options:

Target system: Utilize o combo box para especificar o target system para o projeto atual. O target system configura as restrições da aplicação (como o número de tags suportados) e deve aceitar sua licença. A descrição das restrições principais da licença para cada target system são exibidas abaixo do combo-box onde você a escolheu.

Atenção: Caso você especifique um nível de Target System level que não aceite o nível da licença atual na target station, a aplicação não rodará de forma apropriada.

Resolution: Exibe a resolução da aplicação.

Automatic Translation: Clique (habilite) o check box Enable Translation para habilitar o recurso de tradução. Digite o caminho do diretório e o nome do arquivo a ser traduzido no campo de nome em Translation File. O IWS utilize esse arquivo de tradução como uma linguagem padrão ao iniciar a aplicação.


InduSoft Web Studio

Página 152

Advanced:

Startup Column name: Nome da Coluna Inicial.

Ignore space chars at the end and beginning of the text: Ignorar caracteres de espaços no final e no começo do texto.

Keep original text when translation is blank: Manter texto original quando não houver tradução (campo vazio).

Alarm History and Events: Digite um valor no campo History Life Time (em dias) para especificar por quanto tempo deve-se manter os arquivos históricos de evento e alarme. Após a especificação do número de dias, o IWS deleta automaticamente os arquivos históricos existentes mais antigos do que o período especificado. Caso você digite zero nesse campo, o IWS não deletará quaisquer arquivos históricos automaticamente. Nesse caso, deve-se criar um procedimento externo para limpar os arquivos históricos antigos; de outra forma, uma memória livre no computador eventualmente sera deletada.

History Format: Selecione Proprietary para salvar dados históricos de Alarm/Event em formato de propriedade (texto) a partes do IWS ou Banco de Dados para salvar os dados históricos de alarme/Evento em um Banco de Dados Relacional, como um SQL Server, MS Access, Oracle, etc. Caso você selecione Database ao invés de Proprietary, clique em Event Database e Alarm Database para configurar o link com banco de dados externos para dados históricos de Evento e Alarme. Veja na janela de diálogo Database Configuration Dialog Window para maiores informações.

Default Database: Permite a configuração de um Banco de Dados padrão, que deve ser compartilhado por diferentes tarefas e objetos. Veja em Configurando um Banco de Dados Padrão para Todos os Históricos de Tarefas para maoires informações.

Shared Tags: Selecione um terceiro software a partir do combo-box. Clique no botão Configure para configurar os parâmetros para importação de tags a partir de uma das seguintes origens de dados em uma pasta de Banco de Dados compartilhados:

Nome Descrição <None> Não compartilha tags com qualquer software externo

First ISaGRAF Importa tags de um projeto First ISaGRAF para pasta Shared Tags da aplicação atual e, quando habilitado, configura a interface de comunicação com o driver ISAGR automaticamente.

ISaGRAF Importa tags de um projeto ISaGRAF para a pasta Shared Tags da aplicação atual e, quando habilitado, configure a interface de comunicação com o driver ISAGR automaticamente.

Think & Do Importa tags de um projeto Think & Do para a pasta Shared Tags da aplicação atual e, quando habilitado, configure a interface de comunicação com o driver TND automaticamente.

SteepleChase Importa tags de um projeto SteepleChase para a pasta Shared Tags da aplicação atual e configura a interface de comunicação com o driver VLC automaticamente.

SixNet Importa tags de um projeto SixNet para a pasta Shared Tags da aplicação atual e configure a interface de comunicação com o driver SNET automaticamente.


InduSoft Web Studio

Página 153

Open Control Importa tags de um projeto OpenControl para a pasta Shared Tags da aplicação atual e configure a interface de comunicação com o driver OC automaticamente.

Straton Importa tags de um projeto Straton para a pasta Shared Tags da aplicação atual e configura a interface de comunicação com o driver STRAT automaticamente.

Nota Cada controle baseado em PC possui sua própria interface costumizada, a qual requer o fornecimento de informações sobre a aplicação de controle baseada em PC de forma a compartilhar tags com aplicação do IWS.

Habilitando Tradução de Linguagem

Uma das utilidades fornecidas pelo IWS é o Translation Editor, o qual permite a tradução da aplicação a partir de um idioma para outro automaticamente—traduz essas aqplicações para quantos idiomas forem necessários.

Caso você queira traduzir seu projeto para outro idioma, deve-se habilitar o recurso de tradução e especificar um arquivo de tradução padrão, a partir do painel Automatic Translation no tab Options:

Habilite ( ) o check-box Enable Translation.

Utilize a caixa de texto Translation File name para especificar um nome de arquivo de tradução padrão e localização.

O arquivo de tradução padrão do projeto (<project name>.tra) controla o idioma na qual seu ambiente de desenvolvimento e aplicação do projeto serão exibidos.

Por exemplo, caso você especifique um arquivo de tradução padrão em Espanhol , seu ambiente de desenvolvimento e aplicação do projeto aparecerão em Espanhol por padrão.

– Caso o nome do arquivo padrão e localização forem aceitáveis, nenhuma ação sera requisitada.

– Caso você queira especificar um arquivo de tradução distinto ou localização, digite o nome do arquivo e localização na caixa de texto.

Nota: Pode-se salvar arquivos de tradução em qualquer diretório, embora recomendamos que esses arquivos sejam salvos em sua pasta da Web, assim eles poderão ser utilizados por um Web Thin Client.

Por exemplo, caso seu idioma padrão de desenvolvimento seja Inglês, e você deseja tornar o arquivo disponível em Web Thin Clients, você deverá alterar o nome padrão da planilha para English.tra e salvar o arquivo na seguinte pasta:

C:\Program Files\InduSoft Web Studio\Projects\ <Project Name>\Web\English.tra

Após habilitar a ferramenta de tradução para sua aplicação do projeto, vá para o Capítulo 16: Utilizando o Translation Editor para uma descrição da utilidade, e também para finalizar a configuração de seu projeto para tradução.


InduSoft Web Studio

Página 154

Especificando o nível de licença para Target System

O target system no qual você rodará sua aplicação configura as restrições da aplicação (como suportar muitos dos tags). Conseqüentemente, o nível da licença do target system, assim como o nível da estação de desenvolvimento devem ser compatíveis, ou sua Aplicação poderá não rodar da forma apropriada.

Clique no botão de seta do combo-box Target system e selecione seu nível de licença do target system a partir da lista.

Painel do Target system

A resolução padrão de tela é exibida logo abaixo do combo-box. Essa resolução é o valor padrão especificado ao criar o projeto.

Nota: Para alterar essa resolução “on-the-fly,” feche todas as telas e selecione Tools → Convert Resolution a partir da barra de menu. Quando aparecer o diálogo Convert Resolution, defina o tamanho que você deseja utilizar, e a seguir clique no botão Convert.


InduSoft Web Studio

Página 155

Salvando arquivos históricos de alarme

O painel Alarm History permite o controle de quanto tempo os arquivos de históricos de alarme ficarão armazenados em seu sistema.

Digite um valor no campo File Life Time (days) para especificar quantos dias os arquivos de alarme devem ser mantidos. Por exemplo, caso você especifique que sejam 7 dias, o IWS deleta automaticamente todos os arquivos de alarme que tiverem mais de uma semana.

Painel Histórico de Alarme

Compartilhando tags com aplicação de controle baseada em pc

O processo para configurar esse painel é idêntico ao utilizado para a criação de um novo projeto. Reveja “Compartilhando Tags do Banco de Dados do Programa de Software de Controle Baseado em PC” na página 147.

Communicação com Drivers e OPC (Buffer)

Dado que IWS contém múltiplos módulos que podem afetar valores no tag databases, e que somente um módulo pode rodar por vez, é possível que um valor de tag possa trocar várias vezes antes que o driver ou OPC Client receba esse valor e envie-o para o PLC ou OPC Server. Conseqüentemente, o IWS oferece a opção de “amortecer” os valores de tag.

Caso você prefira utilizar o buffer, o IWS enviará cada troca de valor de tag para o PLC ou OPC Server—na ordem na qual a troca é realizada.

Caso você decida não utilizar o buffer, o IWS enviará somente o valor atual para o PLC ou OPC Server.

Utilize os parâmetros do painel Communication para especificar como as trocas são escritas pelos drivers e equipamentos OPC para equipamentos alvo, como PLCs e OPC Servers.

Clique no botão Driver and OPC do combo-box e selecione uma das seguintes opções da lista.

• Send last state: Escreve apenas o valor do tag atual para o equipamento ou OPC Server. (Selecionar essa opção conservará a memória.)

• Send every state: Escreve todos as trocas de valores do tag para o equipamento ou OPC Server. (Selecionar essa opção utiliza maior quantidade de memória, embora assegure uma vizualização completa e apurada das ações ocorrentes.)

Painel Communication

Especificando um porta TCP

Utilize o campo de texto Port no painel TCP para especificar uma porta para os módulos TCP/IP Client e Server do IWS para serem utilizados. Digite o número da porta no campo de texto:


InduSoft Web Studio

Página 156

Painel TCP

Configurando configurações do banco de dados para salvar históricos de Alarme/evento

Configurar uma interface de banco de dados com o IWS é basicamente fazer links de tarefas do IWS (Alarmes, Eventos ou Trends) para tabelas de banco de dados externos via um Povedor específico de Banco de Dados capaz de suportar o banco de dados escolhidos.

Cada tarefa (Alarm, Events or Trend) pode ser configurada para salvar dados para arquivos com o formato de prorpiedade do Studio ou Banco de Dados SQL Relacionados. Utilize o tab Options para configurar o banco de dados e salvar históricos Alarm e Event. (Veja Configurando Parâmetros do Banco de Dados para Salvar Históricos de Trend para instruções sobre como salvar históricos de tarefas de trend.)

Utilize o combo-box History Format para selecionar Banco de Dados, e clique nos botões Alarm Database ou Event Database. A janela do diálogo Database Configuration deverá abrir-se.

Nota:

Alarms e Events devem ser salvos em formato propriedade do IWS ou em Banco de Dados Relacionados externo, embora possam ser salvos em diferentes bancos de dados.

Cada planilha Trend pode ser configurada para salvar dados em formato de propriedade IWS ou em um Banco de Dados Externo Relacional.

Janela do Diálogo Database Configuration

A janela de diálogo Database Configuration permite a configuração de parâmetros necessários para o link do IWS com um Banco de Dados SQL Externo Relacional.


InduSoft Web Studio

Página 157

Janela Database Configuration

combo-box Database: Permite selecionar Primary ou Secondary. Com Primary, todas as configurações exibidas em uma janela Database Configuration aplicarão para a interface do Banco de Dados Primário. Caso não for selecionado, serão aplicados para a interface do Banco de Dados Secundário. Pode-se configurar o banco de dados Secondary nos seguintes modos:

– Disabled: Nesse modo, o IWS salva dados somente no banco de dados Primário.Caso esse esteja indisponível por alguma razão, os dados não são salvos em nenhum outro local. Essa opção pode causar perda de dados, caso o Banco de Dados Primário não esteja disponível.

– Redundant: Nesse modo, o IWS salva dados em ambos os bancos de dados. Caso um deles esteja indisponível, o IWS mantém os dados salvos somente naquele banco de dados disponível no momento. Quando o banco de dados tornar-se disponível novamente, o IWS sincroniza ambos os banco de dados automaticamente.

– Store and Forward: Nesse modo, o IWS salva dados somente no Banco de Dados Primário. Caso este esteja indisponível, o IWS salvará os dados no Banco de Dados Secundário. Quando o primário voltar a estar disponível, o IWS moverá os dados do Banco de Dados Secundário para o Primário.

Utilizando o Banco de Dados Secundário, você pode ampliar a realística do sistema, além de poder utilizá-lo como um backup quando o Banco de Dados Primário não estiver disponível. Essa Arquitetura é particularmente útil quando o Banco de Dados Primário está localizado em uma estação remota. Nesse caso, você poderá configurar um Banco de Dados Secundário na estação local para salvar dados temporariamente se o Banco de Dados Primário não estiver disponível (durante uma falha na rede de trabalho, por exemplo).

check-box Use Application default: Quando esta opção está habilitada, o IWS usará as configurações do Banco de Dados Padrão para a tarefa a ser configurada (Connection string, User name, Password, Retry Interval e Advanced Settings). Quando não habilitada, pode-se configure-las individualmente para a tarefa atual.

Campo Connection string: Esse campo define o banco de dados onde o IWS escreverá e lerá valores e parâmetros principais utilizados ao conectar-se ao banco de dados. Ao inves de


InduSoft Web Studio

Página 158

escrever a string de Conexão manualmente, pode-se pressionar o botão do browse (…) e selecionar o tipo de banco de dados, a partir da janela Data Link Properties.

Janela Data Link Properties

Nota:

A lista de Fornecedores de Banco de Dados exibida na janela Data Link Properties depende dos fornecedores atualmente instalados e disponíveis no computador onde o IWS está rodando. Consulte a documentação do sistema operacional (ou a documentação do banco de dados) para maiores informações a respeito das configurações do Fornecedor para o banco de dados utilizado.

• Campo User name: Nome do usuário utilizado para conectar-se ao banco de dados. Esse nome

do usuário configurado nesse campo deve ser compatível áquele configurado no banco de dados.

• Campo Password: Senha utilizada para conectar-se ao banco de dados. A senha configurada nesse campo deve ser compatível áquela configurada no banco de dados.

• Campo Retry Interval: Caso o IWS esteja desabilitado a conectar-se ao banco de dados por qualquer razão, ele tentará nova conexão automaticamente após o número de segundos configurados nesse campo.

• Botão Advanced: Após pressionar esse botão, você terá acesso a personalização de algumas configurações. Para a maioria das aplicações, o valor padrão dessas configurações não necessitam ser modificados, e por isso devem continuar os mesmos.


InduSoft Web Studio

Página 159

Janela Database Configuration Advanced

– combo box Milissegundos: Você pode configurar como os milissegundos serão salvos ao salvar a data no banco de dados. Cada banco de dados salva a data em um formato diferente; por exemplo, alguns bancos de dados não suportam milissegundos em um campo Date. Estão disponíveis as seguintes opções:

Default: Utiliza o formato pré-definido para o banco de dados atual. Os banco de dados previamente testados pela InduSoft já estão configurados para a opção mais segura. Ao selecionar o Padrão, o IWS utiliza o parâmetro pré-configurado para o tipo de banco de dados atual. Caso você esteja utilizando um banco de dados que não tenha sido previamente testado pela InduSoft, a opção Default tentará salvar os milissegundos em um campo separado.

Disable: Não salva os milissegundos de forma alguma ao salvar a data no banco de dados.

Enable: Salva os milissegundos no mesmo campo onde a data foi salva.

Separate Column: Salva os milissegundos em uma coluna separada. Nesse caso, a data é salva em um campo (sem precisão de milissegundos) e o número de milissegundos é salvo em uma outra coluna. Essa opção está indicada para quando você desejar salvar timestamps com milissegundos precisos, embora o banco de dados que você está utilizando não suporte milissegundos para os campos Date.

Dica:

A opção padrão para cada banco de dados está configurada no arquivo StudioADO.ini, armazenado na sub-pasta \BIN do IWS. Veja “Studio Database Gateway,” no Capítulo 17:Interface do Banco de Dados do IWS, para informações sobre como configurar o arquivo StudioADO.ini.

check-box Save time difference: Quando essa opção estiver habilitada (padrão), o IWS salva o Time Zone em cada registro do banco de dados configurado no computador onde a aplicação está rodando. Essa opção deve estar habilitada para evitar problemas com horários salvos (daylight).

Database Gateway: Insira o Endereço Host Name/IP onde o gateway do banco de dados do Studio estiver rodando. O número da Porta TCP também pode ser especificado, mas caso você não esteja utilizando o padrão, o gateway do banco de dados do Studio deverá ser configurado com a mesma Porta TCP. Veja “Gateway do Banco de Dados do Studio,” no Capítulo 17: Interface do Banco de Dados do IWS, para informações sobre como configurar os parâmetros avançados do Gateway do Banco de Dados do Studio.


InduSoft Web Studio

Página 160

Disable Primary Key: Para alguns módulos, o IWS tentará definir uma chave primária para a tabela de modo a aumentar a performance das consultas. Caso você esteja utilizando um banco de dados que não suporte chaves primárias (e.x. Microsoft Excel), você deverá verificar esse campo.

• Painel Table: Essa area permite a configuração de parâmetros da Tabela onde os dados serão salvos. Todas as tarefas podem compartilhar o mesmo banco de dados. Entretanto, cada tarefa (planilhas Alarm, Events, Trend) devem estar em link com sua própria tabela. A InduSoft não faz verificações em configurações inválidas nesse campo, portanto você deverá certificar-se de que a configuração é válida para o banco de dados que você está utilizando.

• check-box Use default name: quando esta opção estiver habilitada (padrão), o IWS salva e/ou entrega os dados na Tabela com o nome padrão escrito no campo Name.

• check-box Automatically create: Quando essa opção estiver habilitada (padrão), o IWS cria uma tabela com o nome escrito no campo Name automaticamente. Caso essa opção não esteja habilitada, o IWS não criará a tabela. Portanto, caso não sera possível salvar dados no banco de dados, a menos que exista uma tabela configurada com o nome no campo Name manualmente.

• Name: Especifica o nome da tabela do banco de dados onde os dados históricos serão salvos.

• Botão Refresh: Caso o banco de dados esteja disponível, pode-se pressionar o botão Refresh para preencher o combo-box Name com o nome das tabelas atualmente disponíveis no banco de dados. Desse modo, pode-se selecionar a tabela onde os dados históricos deverão ser salvos, ao inves de escrever o nome da tabela manualmente no campo Name.

• Painel Run-Time: Utilize essa area para configurar os valores de run-time. Estão disponíveis os seguintes campos:

• check-box Status (output): O tag nesse campo receberá um dos seguintes valores:

Valor Descrição

0 Desconectado do banco de dados. O banco de dados não está disponível ou a configuração está incorreta.

1 O banco de dados está conectado. 2 O banco de dados está sendo sincronizado.

• Reload (output): Especifica um tag de recarregamento caso você estaeja utilizando curly

brackets em quaisquer dos campos de configuração. Quando você deseja reconectar o banco de dados utilizando os valores atualizados em seus tags, configure o tag nesse campo para valor 1. O IWS atualizará as configuração na tentativa de executar a ação no banco de dados, configurando o tag de volta a quando estiver finalizado.

Configurando um Banco de Dados Padrão para Todos os Históricos de Tarefas

Embora o IWS permita a configuração de diferentes banco de dados para cada tarefa, o mesmo tipo de banco de dados, tipicamente, (ex. SQL Server, MS Access, Oracle, etc) é utilizado por todas as tarefas do mesmo projeto. Portanto, de modo a economizar tempo ao configurar a aplicação, o IWS permite a configuração do Default Database. Ao configurar cada tarefa, você poderá escolher o que será configurado em cada banco de dados padrão. Escolhendo esse método, não sera necessário reconfigurar os mesmos parâmetros para cada tarefa, desde que essas compartilhem o mesmo banco de dados.

As configurações padrão para o Default Database podem ser ajustadas pressionando o botão Configure no box Default Database, no tab Options do diálogo Project Settings.


InduSoft Web Studio

Página 161

A janela do diálogo Default Database Configuration abrirá.

Janela Default Database Configuration

Retorne a seção anterior, janela do diálogo Database Configuration, para auxílio no preenchimento dos campos nessa janela.

Configurando os Parâmetros da Área de Trabalho de Runtime

Ao rodar uma aplicação na estação de trabalho de runtime (ou alvo), o IWS exibe a aplicação em uma janela Viewer. Pode-se configurar a aparência dessa janela Viewer como se segue:

Selecione a aba Runtime Desktop no diálogo Project Settings:


InduSoft Web Studio

Página 162

Diálogo Project Settings –Tab Runtime Desktop

Habilite ( ) um ou mais dos seguintes check-boxes para exibir os recursos na janela Viewer (ou desabilite os boxes para esconder o recurso):

Nota: O IWS salva todas as propriedades exibidas no arquivo .APP da aplicação.

Titlebar: Exibe uma barra de título no topo da janela. Digite um nome no próximo campo para alterar o texto padrão do título na barra.

Minimize Box, Maximize Box, e Close Box: Exibe três botões, podendo minimizar, maximizar ou fechar a janela Viewer.

Start Maximized: Maximiza a janela automaticamente ao rodar a aplicação.

Menu: Exibe uma barra de menu na janela Viewer.

Para especificar quais menus e opções de menu estarão disponíveis na barra de menu, clique no botão Options.


InduSoft Web Studio

Página 163

Diálogo Runtime Menu Options

Resize Border: Permite o redimensionamento da janela Viewer durante o runtime.

Status Line: Exibe uma barra de status na parte inferior da janela Viewer.

Startup screen: Exibe uma tela específica da aplicação ao iniciar seu runtime.

Para especificar uma tela, digite o nome da tela no campo de texto fornecido (por exemplo main).

Show ???? when quality is not GOOD: Exibe marcas a (???) ao invest de valores de tags quando a qualidade do tag não estiver boa.

Hide Taskbar: Esconde a barra de tarefas Windows por padrão.

Enable ToolTips: Exibe Windows ToolTips ao rodar a aplicação.

Para configurar ferramentas para um objeto em sua aplicação, clique duas vezes no objeto para abrir o diálogo Object Properties e digite seu caminho no campo Hint.

Auto Screen Scaling: Dimensiona a tela da aplicação automaticamente ao redimensionar a janela Viewer. Esse recurso está disponível para aplicações locais rodando em Windows NT/2000/XP (ou Web Thin Clients). Esse parâmetro não está disponível para aplicações locais rodando em Windows CE.

Show Object Edge: Troca o limite do objeto ao mover o cursor sob qualquer objeto onde um dinâmico Command foi aplicado.

Change Mouse Cursor Troca o cursor do mouse ao move-lo sob qualquer objeto onde o dinâmico Command foi aplicado.

Mouse Cursor: Exibe o cursor do mouse na janela Viewer.

Virtual Keyboard: O IWS Virtual Keyboard (VK) permite ao usuário inserir dados (textos ou números) durante o runtime utilizando um equipamento touch-screen ou um teclado convencional.

Você pode habilitar o VK para sua aplicação no diálogo Runtime Desktop (item do menu: Project pulldown->Settings->tab Runtime Desktop). Pode-se designar um Default Virtual Keyboard, assim como aplicar uma Escala (dimensionamento) para todos os teclados virtuais durante o runtime.

Ao configurar objetos e dinâmicos que suportam dados de entrada, pode-se selecionar um VK para o objeto através do combo-box VK (padrão ou específico). Estão disponíveis os seguintes VKs padrão:


InduSoft Web Studio

Página 164

Nome Figura Descrição

AlphaNumeric

Esse VK é utilizado para inserir valores

alfanuméricos (símbolos ou números).

EnhKeypad

Esse VK é utilizado para inserir valores

alfanuméricos (caracteres ou números) em

equipamentos que possuam uma tela

pequena (e.x. PDAs). O botão -> permite

aos usuários navegar por diferentes painéis

até encontrar o caractere desejado.

Keypad

Esse VK é utilizado para inserir valores numéricos (somente

números).

Existem duas formas de alcançar um Virtual Keyboard durante o runtime:

• Clique no objeto onde novos valores (dados) possam ser inseridos (e.x. Texto com dinâmico Text I/O configurado com Entrada habilitada).

• Execute a função built-in Keypad() .

• Alterar a linguagem do Virtual Keyboard através da função built-in SetKeyboardLanguage().

Dicas: Pode-se criar uma nova linguagem para qualquer Virtual Keyboard editando o arquivo VK<Language>.INI na sub-pasta \BIN do IWS, onde <Language> é a marcação da linguagem para os VKs (ex. VKEN.INI = Virtual Keyboards em Inglês; VKGE= Virtual Keyboards em Alemão, etc). Consulte seu fornecedor do software para maiores informações a respeito de como editar e configurar esse arquivo.

Por padrão, o VK é posicionado próximo ao objeto na tela associada a ele. Porém, é possível configurar os seguintes parâmetros no arquivo <AplicaçãoName>.APP, e o VK sempre estará aberto em uma posição fixa:

[Keypad]

PosX=0 //Coordenada (em pixels) do TOP coordenado onde o VK deve ser posicionado.

PosY=0 //Coordenada (in pixels) á ESQUERDA de onde o VK deve ser posicionado.


InduSoft Web Studio

Página 165

– Scale: Usando esta opção o usuário pode aumentar ou diminuir os teclados para ficarem de acordo com o melhor tamanho para o target panel. A escala de 100% representa o tamanho default de cada um dos teclados virtuais. As opções de tamanho são de 25% a 400%, mas você pode também determinar um tamanho customizado de escala.

– Show Hint: Especifique aqui o título do Virtual Keybord a ser mostrado no diálogo. – Show Min/Max fields: Habilite esse check-box para a visualização dos valores máximos e

mínimos permitidos pelo tag.

Ao terminar, clique em outra tab para contibuar, ou feche o diálogo.

Configurando os Parâmetros de Comunicação

Utilize esse tab para especificar parâmetros de comunicação relacionados a aplicação em geral.

Project Settings > Tab Communcation

Driver and OPC: Selecione o método utilizado para todos os drivers de comunicação e planilhas OPC configuradas na aplicação atual ao escrever valores para o equipamento PLC remoto

• Send every state: Quando a tarefa de comunicação está configurada para escrever valores para um troca de valores de tag, todas as trocas nos valores de tag serão manipuladas e enviadas para o equipamento quando a a tarefa de comunicação for executada (para Driver ou OPC).

• Send last state: Quando a tarefa de comunicação está configurada para escrever valores sob uma alteração de valores de tag, somente a valor atual (o último) do tag sera enviado para o equipamento quando a tarefa de comunicação (Driver ou OPC) for executada. Quando esse metódo estiver selecionado, caso o valor do tag mude mais de uma vez enquanto tarefa de comunicação não estiver sendo executada, os valores transitórios do tag não serão enviados para o equipamento. Esse é o comportamento desejado para a maioria das aplicações.

TCP: Configurar os parâmetros para os módulos TCP/IP Client e TCP/IP Server:


InduSoft Web Studio

Página 166

• Port: Porta TCP utilizada pelos módulos TCP/IP Client e TCP/IP Server que estejam rodando no computador atual. Ao alterar esse valor na aplicação local, certifique-se de que seja o mesmo valor da aplicação remota comunicando-se com a aplicação local.

• Send Period (ms): Período (em milissegundos) utilizado entre duas mensagens consecutivas, enviadas pelos módulos TCP/IP Client ou TCP/IP Server para a atualização dos valores de tag na estação remota. Tipicamente, um número menor de igualdades têm melhor performance e tráfico mais avançado pela rede de trabalho.

• Enable Cryptography: Verifique essa opção para habilitar a criptografia quando os módulos TCP/IP Client ou TCP/IP Server enviam as mensagens para a estação remota. A criptografia aumenta a segurança do sistema; porém, diminui a eficiência (performance) da aplicação. Ao conectar duas estações via módulos TCP/IP Client e TCP/IP Server, certifique-se de que essa configuração está habilitada para ambas as aplicações, ou desabilitada para as duas igualmente.

Configurando Seu Projeto para Acesso Remoto a Web

Para configurar um projeto da aplicação de forma que Web Thin Clients possam acessar a aplicação a partir da maioria dos browsers da web (como Internet Explorer ou Netscape), utilize o seguinte procedimento:

Selecione o tab Web no diálogo Project Settings:

Project Settings Dialog – Web Tab

Configure os parâmetros nesse tab, como se segue:

campo Data Server IP Adress: Digite os dados do endereço IP server (endereço IP onde a aplicação rodará).

campo Send Period: Especifique a frequência (em milissegundos) com que as estações Server e Web Thin Client podem trocar (enviar) dados.


InduSoft Web Studio

Página 167

check-box Disable Remote Client Commands: Habilite ( ) esse box para evitar que um Web Thin Client remoto dê comandos à sua aplicação.

check-box Enable ToolTips: Habilite ( ) esse box para ver Windows ToolTips ao visualizar as telas da aplicação no Web Thin Client (browser).

check-box Auto Screen Scaling: Habilite essa opção caso esteja rodando a aplicação remotamente em um Web Thin Client e queira que o IWS escalone telas automaticamente ao redimensionar a janela do Browser.

check-box Enable File Compression: Habilite para comprimir arquivos armazenados na pasta \Web da aplicação. Essa opção é útil para a redução no tempo de download—particularmente se uma conexão lenta estiver estabececida entre Server e Web Thin Client.

Pode-se especificar quais computadores estejam habilitados a acessar sua aplicação como Web Thin Clients. Clique no botão IP Security para abrir o diálogo IP Security:

Diálogo IP Security

Utilize os parâmetros desse diálogo para especificar quais computadores poderão ter acesso à sua aplicação:

• Clique no check-box Enable ( ) para ativar os campos From e To.

• Digite os endereços IP de saída e entrada nos campos From e To, respectivamente.

• Aparecerá uma lista de computadores específicos em IP Address Range.

• Clique no botão Add para adicionar endereços IP à lista IP Address Range ou clique no botão Remove para deletar endereços IP da lista.

Notas:

Pode-se especificar os mesmo endereço IP nos campos From e To a fim de limitar a escala a um único endereço IP.

Pode-se também especificar várias escalas.

• Clique em OK para fechar o diálogo IP Security.

Para gerar arquivos de log na máquina Web Thin Client para correção de erros, habilite ( ) o check-box Enable (na painel Log) e indique onde o IWS deverá salvar os arquivos, digitando o nome e local do arquivo no campo de texto FileName.

Para habilitar o Virtual Keyboard para estações Web Thin Client, independentemente da estação local, clique no check-box Virtual Keyboard. Quando esse box estiver habilitado, os campos Default Scale tornam-se ativos.

• Default: Selecione o teclado default utilizado na aplicação. As opções são AlphaNumeric, EnhKeypad e Keypad.


InduSoft Web Studio

Página 168

• Scale: Habilitando essa opção, é possível aumentar ou alargar os teclados para adequarem-se propriamente com o tamanho da tela do painel alvo. Scale: 100% representa tamanho padrão de cada Virtual Keyboard. As opções vão de 25% a 400%, embora você também possa inserir uma escala customizada.

• Show Hint: Especifique aqui o título do Virtual Keybord a ser mostrado no diálogo. • Show Min/Max fields: Habilite esse check-box para a visualização dos valores máximos e

mínimos permitidos pelo tag.

Ao terminar, clique em outra tab para continuar ou feche o diálogo.


InduSoft Web Studio

Página 169

Especificando Parâmetros Web Thin Client

Utilize o procedimento a seguir para especificar parâmetros Web Thin Client:

Selecione a tab Web no diálogo Project Settings:

Configure os parâmetros nesse tab como se segue:

campo Data Server IP Address: Digite o endereço IP (ou host name) da estação servidora de seus dados. A estação servidora de dados é o computador ou equipamento onde o módulo TCP/IP server do IWS está rodando.

Dica: Pode-se utilizar o endereço IP 127.0.0.1 (local host) para acessar o TCP/IP server no computador local (apesar do endereço IP da rede de trabalho). Essa opção é útil para testes locais; porém, não sera possível acessar o servidor de dados de computadores remotos utilizando essa configuração.

campo Send Period (ms): Digite um valor para especificar o período de envio em milissegundos) utilizado para trocar dados entre o servidor e estações Web Thin Client, o que significa que o Web Thin Client enviará um pacote com os novos valores de tag para o servidor a cada n millissegundo(s).

O Send Period do servidor é configurado em Project Settings Communication. O valor padrão é de 1000 (milissegundos). Pode-se configurar um valor menor nesse campo a fim de aumentar a taxa de atualização entre o servidor e os Web Thin Clients, resultando em maior tráfico de informações através da rede de trabalho (a rede de trabalho sera acessada com maior frequencia) caso os tags estejam sendo trocados continuamente (com mais de 1 segundo).


InduSoft Web Studio

Página 170

check-box Disable Remote Client Commands: Clique para habilitar esse box para a prevenção de comandos provenientes de clientes remotos a partir do Web Thin Client para seu servidor. Quando essa opção está habilitada, o Web Thin Client é capaz de ler dados do servidor, embora não possa enviar dados (valores de tag, set-points) para o servidor de tags. Nesse caso, a estação Web Thin Client aparece como um estação Read Only.

check-box Enable ToolTips: Clique nesse box para exibir as ToolTips configureadas nos objetos de tela ao visualize-los no Web Thin Client (browser da web).

check-box Auto Screen Scaling: Clique para habilitar a escala automática de telas exibidas em uma janela do browser da web. Utilizando essa opção, a tela dimensiona-se ao tamanho da janela do browser, de acordo com sua resolução.

Nota: A opção Auto Screen Scaling não é válida para browsers que estejam rodando sob sistemas operacionais Windows CE.

check-box Enable File Compression: Clique para habilitar a compressão de arqueivos armazenados na pasta \Web da Aplicação. Essa opção é útil para reduzir o tempo de download, particularmente se você tiver uma conexão lenta entre seu servidor e o Web Thin Client.

Log (check-box Enable e text field FileName): Clique para habilitar o check box, e digite o nome do arquivo no campo de texto para gerar um arquivo de log na estação Web Thin Client. Também pode-se utilizar esse arquivo de log para correção de erros.

Virtual Keyboard: Quando essa opção está habilitada, o virtual keyboard estará capacitado para estações Web Thin Client. O teclado virtual permite ao usuário a inserção de dados durante o runtime, com touch screen baseado em painéis Web Thin Client.

Default: O usuário pode selecionar o teclado padrão utilizado na aplicação para as estações Web Thin Client.

Scale: Utilizandoessa opção, o usuário poderá aumentar ou redimensionar os teclados para que acomodem-se de forma apropriada ao tamanho da tela do painel alvo. A Escala 100% representa o tamanho padrão de cada teclado virtual.

botão IP Security: Clique nesse botão para abrir o diálogo IP Security.


Utilize os parâmetros desse diálogo para especificar a escala de endereços IP para os computadores que são habilitados a acessar a aplicação como Web Thin Clients. Essa opção é útil para controlar os endereços IP de computadores Web Thin Client os quais são permitidos a conectar-se com o Server.


InduSoft Web Studio

Página 171

Clique no check-box Enable e quando os parâmetros do painel Edit tornarem-se ativos, digite os endereços IP nos campos From e To para especificar a escala dos endereços IP. Utilize os botões Add e Remove para mover os endereços IP para a lista IP Address Range. Quando um Web Thin Client tentar conectar-se ao servidor, este será verificado pela estação, e esse recurso permitirá o acesso somente para aqueles endereços IPs os quais estão adicionados à lista previamente estabelecida no diálogo. O servidor recusará a conexão de Web Thin Clients não encontrados.

Botão Advanced: Clique nesse botão para abrir um diálogo onde você poderá editar as configurações Avançadas para Web. Na maioria dos casos, essas configurações não devem ser modificadas. Porém, dependendo da Arquitetura utilizada em seu projeto, você terá a flexibilidade de configurar configurações avançadas.

• Campo Secondary Data Server IP Address: Digite o endereço IP (ou host name) da estação servidora de dados secundária, o computador ou equipamento onde o módulo TCP/IP server do IWS está rodando. Esse campo deve ser preenchido quando você estiver utilizando servidores de dados redundantes de Web Thin Clients. Caso o servidor primário falhar, o Web Thin Client tentará conexão com o servidor secundário automaticamente.

• Campo BackUp URL: Digite a URL onde os arquivos da web estão armazenados (arquivos da sub-pasta \Web da Aplicação). Essa URL é utilizada para fazer download de arquivos a partir do servidor secundário da web, quando o servidor primário não estiver disponível.

Nota: Ao utilizar browsers da web que estejam rodando sob sistema operacional Windows CE v3.0 ou Windows CE Pocket PC, o campo URL de backup deverá estar configurado com a URL da servidor da web primário, mesmo que você não possua uma Arquitetura redundante.

• Campo ISSymbol download path: Quando o Web Thin Client conecta-se ao servidor, este tenta carregar o controle ISSymbol. Caso este não esteja registrado no computador local (Web Thin Client), o browser tentará fazer seu download a partir da URL especificada nesse campo. A URL padrão é um site da web onde a InduSoft mantém a maioria das versões atulaizadas de ISSymbol disponíveis para download. Talvez seja necessário configurar um local distinto, especialmente quando o computador Web Thin Client não estiver conectado à internet. ISSymbol.cab e ISSymbolA.cab (armazenados na sub-pasta \BIN do IWS) deverão estar disponíveis na URL configurada nesse campo.

Dica: Quando as estações Web Thin Client não possuem acesso à internet, é recomendado que os arquivos ISSymbol.cab e ISSYmbolA.cab estejam disponíveis na estação servidora da web, e que a URL seja configurada por eles nesse campo.

Nota: Browsers da Web que estejam rodando sob sistema operacional Windows CE não são capazes de fazer o download automático do controle ISSymbol (ISSymbolCE.ocx) a partir de um local remoto. Assim, ISSymbolCE.ocx deverá ser registrado manualmente no equipamento com Windows CE para esse poder ser usado como um Web Thin Client.


InduSoft Web Studio

Página 172

check box Web Tunneling Gateway: Habilite essa opção para capacitar o Web Tunneling Gateway. Dependendo da Arquitetura de seu projeto, pode ser necessária a utilização do Web Tunneling Gateway para conduzir computadores Web Thin Client ao servidor de dados.

HTTP Port: Selecione essa opção quando utilizar HTTP com o servidor da web IIS da Microsoft. Pode-se especificar a porta TCP utilizada pelo seu servidor HTTP (80 é a porta TCP padrão para protocolos HTTP).

SSL Port: Selecione essa opção ao utilizar (Secure Socket Layer) com o servidor da web IIS da Microsoft. Pode-se especificar a porta TCP utilizada pelo seu servidor HTTPS (443 é a porta TCP para protocolos HTTPS).

IP Address: Endereço IP do computador onde o Web Tunneling Gateway está rodando. Esse deverá ser o endereço IP do servidor da web acessível a partir da(s) estações Web Thin Client.

Secondary IP Address: Endereço IP do computador web server onde o Web Tunneling Gateway está rodando. Esse deverá ser o endereço IP do web server secundário acessível a partir da(s) estações Web Thin Client. Esse campo deverá ser configurado quando web servers redundantes estiverem sendo utilizados.

Dica: A maioria das configurações da Web podem ser modificadas dinamicamente através da função SetWebConfig(). Essa função é especialmente útil quando deseja-se criar uma aplicação única, e certificar-se de que as configurações da web serão automaticamente configuradas ao rodar a aplicação em diferentes estações, com diferentes endereços IP.

Habilitando Mensagens de Aviso

O IWS permite o controle do aparecimento de mensagens de aviso antes que as telas da aplicação sejam baixadas no target system.

Selecione o tab Preferences.

Clique no check box Display warning messages before downloading screen to the target system para habilitar ( ) ou desabilitar ( ) a função. Quando essa opção estiver habilitada e você modifica o nome de qualquer tag na planilha de Tags da aplicação, você será requisitado a substituir o nome antigo do tag pelo novo para toda a aplicação. Com essa opção está habilitada, o IWS executará o comando de substituição global, a fim de substituir os nomes em todos os documentos da Aplicação (telas e planilhas).

Clique em qualquer das outras mensagenss:

Display confirmation message when renaming application tags: Quando essa opção está habilitada e você deseja modificar o nome de qualquer tag na planilha de Tags da aplicação, você sera requisitado a substituir o nome antigo do tag pelo novo nome em toda a Aplicação. Com essa opção habilitada, o IWS executará a substituição global em todos os documentos da aplicação (telas e planilhas).

Display confirmation message when changing the screen position and size: Quando essa opção está habilitada, você sera requisitado a atualizar screen attributes (Largura, Altura, Superior e à Esquerda) após a modificação dessas telas na interface de Layout.

Display warning message after saving symbols: Opção que exibe ou não uma caixa de diálogo após salvar symbols. É uma mensagem de alerta para que a screen seja salva pois as alterações no .sym não garantem que o symbol inserido numa screen também seja atualizado.


InduSoft Web Studio

Página 173

Quality Feedback Service: Esta seção permite que você configure o IWS ou CEView para gerar arquivos de registro e/ou arquivos de dump com informação útil para eliminar erros e detectar a razão dos problemas, como erros fatais ou problemas causados por hardware ou software.

– Generate a log file when an unexpected error happens: Quando esta opção é checada, os módulos runtime adicionam o arquivo de Dump.txt sempre que um erro interno (exceção) ocorre. Estas exceções não necessariamente terminam os módulos runtime. Entretanto, as exceções podem afetar a estabilidade do sistema, assim devem ser investigadas.

– Generate a log file when an unexpected error happens: Ao checar esta opção, os módulos runtime geram um novo arquivo de Dump (binário) com informação útil sobre as condições de erro. A informação disponível neste arquivo pode ser decodificada somente pelos desnvolvedores do produto. A fim de evitar que um arquivo de Dump sobrescreva quando um erro novo ocorra, estes arquivos são nomeados WinXXX.dmp, onde XXX é um número aleatório (no formato hexadecimal) gerado automaticamente pelo sistema. Conseqüentemente, se mais de um erro ocorrer, você encontrará arquivos de mais de um Dump no mesmo diretório.

– Enable log of memory: Quando esta opção é checada, os módulos runtime adicionam informações sobre o alocamento de memória atual na plataforma runtime ao arquivo de Dump.txt a cada 15 minutos. Após ter começado o IWS ou CEView, você terá que esperar 15 minutos antes que a arquivo de registro (Dump.txt) seja adicionado com o primeiro registro de memória. Esta informação é útil para identificar situações de perda memória.

Todos os arquivos de registro (formato de texto) e os arquivos de Dump (formato binário) são criados na sub pasta \Web\Dump da aplicação.

Mesmo se nenhum dos check-boxes disponíveis nesta relação forem checados, um arquivo de Dump nomeado WinDump.dmp estará gerado caso o IWS ou CEView são terminados por um erro fatal.

O arquivo de Dump.txt será adicionado até que alcançar seu tamanho máximo (2MB). Após ter alcançado seu tamanho máximo, o Dump.txt é suprimido e um arquivo novo é criado.

Quando um arquivo de Dump é gerado, o arquivo de registro indica o nome do arquivo de Dump associado a cada erro. Conseqüentemente, para finalidades de eliminação de erros, é recomendado habilitar todas as opções disponíveis nesta seção e emitir o arquivo de registro (Dump.txt) junto com todas os arquivos de Dump (Win*.dmp) ao seu vendedor do software.

Reset Tags Database when starting Aplicação: Caso essa opção estiver verificada, os tags da aplicação serão reiniciados automaticamente sempre que você rodar a aplicação (Project > Run Application). Veja Tools > Reset Tags Database para maiores detalhes sobre esse recurso.

Enforce Viewer/Web compatibility: Quando esta opção é checada, o modo de engenharia ajuda o usuário a configurar a aplicação, sabendo quais funções funcionarão ou não em plataformas remotas (InduSoft Secure Viewer e Web Thin Client). Nota: Na aplicação precedente esta opção é deschecada para manter compatibilidade.


InduSoft Web Studio

Página 174

Diálogo Project Settings –Tab Preferences

Ao terminar, clique em outro tab ou feche o diálogo.

Iniciando Módulos de Runtime no Target system Após especificar um target system para a aplicação de seu projeto, o, InduSoft Web Studio permite a especificação de quais módulos de runtime de seu projeto deverão ser iniciados automaticamente no target system, e quais deles deverão ser iniciados manualmente.

Nota: O IWS configura, por padrão, certos módulos para iniciarem-se automaticamente, embora permita a alteração desses padrões.

Com o diálogo Project Status, você pode:

• Configurar as tarefas que deverão ser executadas automaticamente assim que a aplicação for iniciada (tab Execution Tasks)

• Iniciar/parar cada tarefa de runtime manualmente (tab Execution Tasks)

• Rever informações a respeito do sistema de desenvolvimento e de suas aplicações (tab Information)

O tab Execution Tasks exibe a lista de tarefas disponíveis para a aplicação atual. Status e modos de startup (Automático ou Manual) também são exibidos.

Para especificar como os módulos serão iniciados no target system, siga os seguintes passos

A partir da barra de menu principal, selecione Project → Status para abrir o diálogo Project Status.


InduSoft Web Studio

Página 175

Selecione o tab Execution Tasks, no qual estão as listas de todos os módulos de runtime associados ao seu projeto, além do status atual do start-up.

Nota: O tab Execution Tasks estará disponível somente quando a opção Target Station do diálogo Execution Environment (Project → Execution Environment) estiver configurado como Local.

Essa lista contém três colunas, incluindo Task Name, Status de runtime configuração de Startup atual (Automatic ou Manual) de cada tarefa de runtime. Por exemplo, veja a figura que se segue:

Diálogo Project Status: Tab Execution Tasks

A lista de tarefas disponíveis nesse diálogo depende do target system configurado no tab Options. A tabela a seguir lista as tarefas que não estarão disponíveis para aplicações projetadas em sistema operacional Windows CE:

Tarefa Disponível para WinCE runtime OS Background Task Sim Database Spy Não DDE Client Runtime Não DDE Server Não HAD OPC Server Não Driver Runtime Sim LogWin Não ODBC Runtime Não OPC Client Runtime Sim Studio Scada OPC Server Sim TCP/IP Client Runtime Sim TCP/IP Server Sim Viewer Sim


InduSoft Web Studio

Página 176

Notas: Como existem muito drivers sendo adicionados constantemente, o módulo Driver runtime inicia por si só todos os drivers configurados na aplicação atual do projeto.

Started não sera exibido na coluna Status quando você iniciar o módulo Driver; porém, aparecerá um ícone para cada driver no canto direito e embaixo da barra de tarefas do Windows.

Para parar um driver individual, clique com o botão direito no ícone e selecone Exit no menu pop-up.

Driver Runtime - OMETH Driver Runtime - KOYO

Verificando que os drivers estejam rodando

Pode-se configurar tarefas para execução automática quando a aplicação é iniciada. Para isso, clique nome da aplicação no tab Execution Tasks, pressione o botão Startup e escolha a opção Automatic.

Diálogo Startup

• As tarefas configuradas como Startup = Automatic são executadas automaticamente quando a aplicação for iniciada; as tarefas configuradas como Startup = Manual não serão.

• Pode-se também Iniciar/Parar cada tarefa de runtime clicando-se no nome, e então pressionando os botões Start ou Stop.

Nota: Caso o tab Execution Tasks não esteja visível, clique em click Project -> Execution Environment e certifique-se de que a Estação Alvo (Target Station) esteja configurada como Local. O tab Execution Tasks estará disponível somente quando o Target Station for local.

Dica:

Pode-se também iniciar/parar cada tarefa durante o runtime utlizando-se das funções built-in StartTask() e EndTask(). É possível também utilizar a função


InduSoft Web Studio

Página 177

IsTaskRunning() para verificar cada tarefa que esteja rodando durante o runtime.

Atenção:

Os comandos disparados pelo diálogo serão executados na estação remota (e não no computador local) assim que você estiver conectado a uma estação remota.

O tab Information do diálogo Project Status exibe a lista de tarefas disponíveis para a aplicação atual, como ilustrado a seguir:

Diálogo Project Status: Tab Information

A maioria das informações importantes exibidas nesse diálogo são aquelas do banco de dados da aplicação (inicial), fornecendo o número de tags da aplicação configurados na aplicação atual. Essas informações são úteis para avaliar quais licenças serão mais apropriadas para a aplicação em questão.

Ao terminar, clique em OK para fechar o diálogo Project Status.

Após criar e configurar um projeto, você poderá fazer o design das telas da aplicação, além de criar suas planilhas de tarefas.

Instruções para a criação de telas são fornecidas no Capítulo 7: Configurando Telas e Gráficos.

Instruções para a criação de planilhas são fornecidas no Capítulo 8: Configurando Planilhas de Tarefas.


InduSoft Web Studio

Página 178

Capítulo 7: Configurando Telas e Gráficos Esse Capítulo fornece informações sobre como configurar telas e gráficos. Antes de criar uma tela na aplicação, você deverá levar em consideração a estrutura da tela. As aplicações em Windows NT/2000/XP permitem que você abra mais de uma tela, mas aplicações em Windows CE criam uma tela padrão com cabeçalho e rodapé (a ser utilizada como modelo temporário), e nessa tela você poderá inserir os objetos. Após criar e inserir objetos na tela, você deverá salvar a tela temporária com nomes diferentes para que telas diferentes sejam criadas. Tipicamente, uma tela da aplicação do InduSoft Web Studio consiste de três áreas básicas (ou tipos de telas):

• Header: Objetos localizados na parte superior da tela, fornecendo informações padrão (data, hora, etc).

• Footer: Objetos localizados na parte inferior da tela (tipicamente, um objeto de alarme exibindo o último alarme).

• Regular: Área entre o cabeçalho e o rodapé, fornecendo informações sobre processos, telas de alarme, tendências, etc.

Utilizando essa estrutura para o desenvolvimento de telas promove as seguintes vantagens:

• Colocar telas de forma conjunta, de acordo com a utilidade na aplicação.

• Configurar apenas uma vez links e dinâmicas comuns para todas as telas.

• Promover um formato padrão para a aplicação.

• Construir telas modulares e utilizá-las em outros projetos.

Trabalhando em um Ambiente Orientado pelo Objeto Selecione o tab Graphics para acessar todas as telas, páginas da web, objetos de biblioteca e símbolos na aplicação.

Tab Graphics


• Screens: Contém todas as telas de exibição criadas para a aplicação atual.

• Group Screen: Contém os grupos de telas completos (telas individuais combinadas em grupos gerenciáveis) criados para a aplicação atual.

Nota: Group Screen não está disponível para Windows CE.


InduSoft Web Studio

Página 179

• Web Pages: Contém todas as páginas da web (telas salvas em formato HTML) criadas para a

aplicação.

• Library: Contém a biblioteca de símbolos e gráficos fornecidos pelo InduSoft Web Studio. Clique duas vezes no botão Library para abrir a utilidade IWS Symbol Library, que consiste de um painel de lista (contendo todos os grupos de símbolos) e uma tela de exibição.

• Symbols: Contém todos os símbolos pré-definidos pelo usuário, que podem ser grupos de imagens e/ou texto. Pode-se criar símbolos personalizados para a aplicação e salvá-los nessa pasta.

Trabalhando com Atributos de Tela A pasta Screens contém telas com compilações gráficas finalizadas e rascunhos do projeto. Para visualizar uma tela, amplie a pasta Screens e as telas aparecerão na janela a direita no Workspace. Clique duas vezes na tela para abri-la.

Para criar uma nova tela, abra o diálogo Screen Attributes utilizando um dos seguintes métodos:

Clique no botão New ( ) na barra de ferramentas Standard. Quando o diálogo New Document abrir, clique em Display, e depois clique em OK.

Clique com o botão direito na pasta Screens, selecione Insert, e clique no pop-up:

Criando uma Nova Tela

Selecione File → New da barra de menu. Quando o diálogo New Document abrir, clique em Display, e depois em OK.


InduSoft Web Studio

Página 180

Selecione Insert → Screen da barra de menu. Quando o diálogo New Document abrir, clique em Display, e depois em OK.

Diálogo Screen Attributes

Para exibir o diálogo Screen Attributes para uma tela de saída, selecione View → Screen Attributes da barra de menu.

Utilize os parâmetros no diálogo Screen Attributes como se segue:

• text box Description: Digite uma descrição do atributo da tela para fins de documentação. O texto inserido nesse campo será exibido na barra de status (por padrão) localizado na parte inferior e à esquerda da tela quando você está em modo Run Aplication.

• área Background Picture: Especifique os seguintes parâmetros para background.

check-box Enable background: Clique para habilitar ou desabilitar (padrão) o uso de bitmaps de background.

combo-box Enable Background: Clique para selecionar uma das seguintes opções de background do Windows NT/2000/XP:

BMP TIF DXF EPS WMF IMG JPG

WPG PCD PNG FMF FPX FAX TGA

Nota: O Windows CE suporta somente .BMPs.


InduSoft Web Studio

Página 181

check-box Shared Image: Clique (habilite) para salvar um arquivo .BMP em formato comprimido. Ativado somente quando o check-box Enable Background tenha sido selecionado.

Atenção: Não é possível ler o arquivo .BMP salvo em formato comprimido caso você modifique ou instale os valores de configuração do Windows em um ambiente com a utilização de diferentes números de cores. Recomendamos que as telas sejam salvas em formato não comprimido, caso você deseje alternar entre diferentes configurações. Em Windows CE, os bitmaps devem ser cor-16.

• área Size: Digite um número inteiro nos boxes Width e/ou Height para especificar o tamanho (em pixels) da janela selecionada.

• área Location: Digite um número inteiro nos campos Top e/ou Left para especificar a localização da janela (em pixels) em relação a tela atual.

Atenção: Caso você utilize o mouse (apontador) para redimensionar um janela diretamente (estilo Thin ou Resizing) e depois Selecionar View → Screen Attributes da barra de menu, o IWS solicitará a atualização do tamanho e localização da tela atual.

• Campo Security: Especifique o mesmo nível de segurança para a janela (padrão é zero) definido para acesso do usuário, utilizando o tab Security no tab Database.

• check-box Hide: Clique para manter a tela gravada na memória após solicitá-la pela primeira vez, facilitando o carregamento mais rápido ao abrir a tela. O IWS executará Screen Logics normalmente.

Habilitar esse recurso (padrão é como desabilitado) causa uma utilização elevada de pesquisas GDI, conseqüentemente, recomendamos que, durante o desenvolvimento, você mantenha o monitoramento dessas pesquisas utilizando a função InfoResources.

• área Runtime Properties: Especifique os seguintes parâmetros para definir as propriedades da janela ao rodar a aplicação.

Titlebar: Clique nesse box para habilitar/desabilitar uma Titlebar para a nova tela. Mesmo se você não verificar esse check-box, você poderá configurar texto para a Titlebar; porém, a Barra de Título será exibida somente se essa opção estiver habilitada.

Dicas:

Pode-se modificar o texto da Titlebar dinamicamente durante o runtime, configurando tags entre colchetes. O valor do(s) tag(s) está concatenado com o texto da Titlebar.

Configurar texto dinâmicas na Titlebar é útil mesmo quando esse não está visível nas telas. Quando o comando Print é disparado dos objetos Grid ou Alarm/Event Control, o texto da Titlebar da tela onde o objeto é configurado será imprimido no cabeçalho dessas telas.

check-box System Menu: Clique para habilitar o menu do sistema.

check-box Maximize Box: Clique (habilite) para ativar o botão Maximize.

check-box Minimize Box: Clique para ativar o botão Minimize.

Style: Clique para selecionar um estilo para a janela (padrão é Replace).

• Overlapped abre uma janela sem fechar qualquer outra janela.

• Popup abre uma janela que permanecerá á frente das outras janelas, deixando as outras também habilitadas.


InduSoft Web Studio

Página 182

• Dialog abre uma janela que permanecerá à frente das outras janelas, embora desabilite as outras janelas até que você feche aquela janela aberta.

• Replace abre uma janela e fecha quaisquer outras janelas Replace e Popup style.

Border: Clique para selecionar um estilo para as bordas:

• None: Sem bordas. Não permite redimensionamento ou barra de títulos.

• Thin: Janela de bordas finas que não poderá ser redimensionada durante runtime.

• Resizing (padrão): Borda Normal que pode ser redimensionada durante o runtime.

text box Don’t Redraw: Digite um tag ou valor para controlar como os dinâmicas de tela serão atualizados. Especificar um valor maior que zero desabilita todos os dinâmicas da tela.

área Screen Logics: Clique (habilite) os boxes para executar Funções matemáticas em um ou mais desses eventos: On Open, While Open, On Close.

Após habilitar um evento, clique no botão correspondente para abrir um diálogo onde você poderá inserir as informações a seguir:

• Tag Name: Digite o nome de um tag para receber um valor de retorno a partir da coluna Expression.

• Expression: Digite uma expressão matemática ou função a ser executada. O valor de retorno é aplicado ao campo Tag Name.

• Trigger (somente diálogo While Open). Digite um tag para que funcione como um disparador (qualquer alteração de valor) para execução dessa planilha. Caso você deixe esse campo em branco, o IWS executará a planilha no tempo mínimo que seu sistema é capaz de suportar.

área Focus: Utilize as opções a seguir para configurar o comportamento do foco ao utilizar um grupo de telas (mais de uma tela aberta simultaneamente):

• Receive focus on open: Habilite essa opção para trazer o foco ao primeiro objeto sensível a foco, quando esse estiver aberto.

• Share tab order with other screens: Habilite essa opção para alternar o foco de objetos dessa tela para objetos configurados em outras telas. Tal tarefa ocorrerá após apertar a tecla Tab enquanto o último objeto sensível a foco estiver em foco na tela.

• Tab Order: Digite um número (0 - 32767) para configurar a ordem do tab. Quando existem mais de uma tela abertas, e você deseja apertar a tecla Tab (durante o runtime), o foco alterna entre entre as telas com o menor número Tab Order, para as telas com o maior número Tab Order, e volta para a tela o o número mais baixo Tab Order (e assim por diante).

Dica:

Para configurar a ordem em que as telas do grupo serão abertas quando determinado grupo de telas é solicitado, clique com o botão direito no nome do grupo da tela no tab Graphics do workspace.


InduSoft Web Studio

Página 183

• Clique no botão Save ( ) na barra de ferramentas Standard ou selecione File → Save (ou File → Save As) da barra de menu para salvar a nova tela. Quando o diálogo Save (ou Save As) aparecer, digite <filename>.scr (ou <filename>) no campo File name.

Especificando o Nome do Arquivo

• Amplie as pastas no tab Graphics para visualizar a tela salva:

Verificando a Nova Tela


InduSoft Web Studio

Página 184

Especificando Cores de Background

Para alterar a cor de background da tela, clique no botão Background Color ( ), localizado na barra de ferramentas Tools toolbar e clique com o botão direito na tela em branco. Escolha Background Color do menu pop-up.

Quando o diálogo Color aparecer, clique em uma cor, e depois clique em OK.

Diálogo Color

Dica:

Clique duas vezes em uma cor para selecionar a cor desejada, e o diálogo Color será fechado automaticamente.

Nota:

Dependendo da paleta configurada para seu sistema, as cores dos objetos gráficos importadas para o ambiente poderão ter distorções da cor. Caso isso aconteça, altare a paleta configurada para seu sistema.


InduSoft Web Studio

Página 185

Utilizando Objetos e Dinâmicas O InduSoft Web Studio fornece objetos e dinâmicas com recursos completos (habilidade para modificar propriedades do objeto, executar comandos ou inserir valores para tags utilizadas na construção de telas flutuantes em runtime).

Utilizando a Barra de Ferramentas Mode

A barra de ferramentas Mode fornece botões para edição geral da tela.

Barra de Ferramentas Mode

A barra de ferramentas Mode posuui os seguintes botões

• Botão Selection ( ): Clique para exibir um cursor o qual permite selecionar ou mover objetos na tela.

• Botão Bitmap Editor ( ): Clique para alternar entre duas camadas de edição básicas:

Camada Objects: A camada na qual você cria os objetos dinâmicas para seu sistema.

Camada Background Picture: A camada de background estática da mesma tela.

Quando a camada Background Picture está ativa a barra de ferramentas Bitmap será exibida automaticamente.

Nota: Você pode desabilitar automaticamente o botão Bitmap Editor ao desabilitar o check-box Enable Background (somente tipo .BMP) no diálogo Screen Attributes.

• Botão Fill Color ( ): Clique para especificar uma cor de preenchimento padrão para os seguintes objetos:

Polígonos fechados

Elipses

Retângulos arredondados

Retângulos

Dica:

Para economizar tempo no desenvolvimento, selecione vários objetos (de qualquer tipo especificado na lista anterior) e utilize Fill Color para especificar um preenchimento padrão.

• Botão Fonts ( ): Clique para especificar a fonte e cor para objetos de texto selecionados para novos objetos de texto.

Dica: Para economizar tempo no desenvolvimento, selecione vários objetos de texto e utilize o botão Fonts para especificar configurações de fonte e cor para todos os objetos de uma vez só. (Não é possível utilizar essa função para objetos de texto agrupados.)


InduSoft Web Studio

Página 186

• Botão Line Color ( ): Clique para especificar um cor para linha para objetos selecionados ou para configurar uma cor padrão para novos objetos, incluindo os que se seguem:

Pólígonos abertos

Polígonos fechados

Linhas

Elipses

Retângulo arredondado

Retângulos

Ao clicar no botão Line Color, o diálogo Line Selection aparecerá. Utilize esse diálogo para especifcar os estilos de linha e cor para objetos selecionados:

Diálogo Line Selection

Dica: Para economizar tempo no desenvolvimento, pode-se selecionar vários dos objetos anteriores e utilizar o botão Line Color para especificar uma cor para a linha para todos os objetos.

• Botão Background Color ( ): Clique para especificar uma cor de background para a tela.

Nota: Esse botão desabilita-se automaticamente quando você habilitar o check-box Enable Background no diálogo Screen Attributes.

• Botão Grid ( ): Clique para especificações sobre exibir ou ocultar a grade no editor de tela.

Dica: Pode-se utilizar o diálogo Grid para configurar as configuraçõs padrão para um grid. Para abrir esse diálogo, clique com o botão direito na tela e selecione Grid Settings quando aparecer o menu pop-up.


InduSoft Web Studio

Página 187

Utilizando a Barra de Ferramentas Align e Distribute

A barra de ferramentas Align and Distribute fornece botões que permitem a edição de objetos na tela.

Barra de Ferramentas Align and Distribute

Utilize as seguintes opções da barra de ferramentas para redimensionamento:

• Botão Resize height ( ): Clique para configurar a altura de todos os objetos selecionado, que seja igual a altura do objeto selecionado (o objeto com os handles preenchidos). Pode-se utilizar Resize height para redimensionar um objeto configurando sua altura para um tamanho igual a sua largura.

• Botão Resize width ( ): Clique para configurar a largura de todos os objetos selecionados para largura do último objeto selecionado (o objeto com handles preenchidos). Pode-se utilizar Resize width para redimensionar um objeto selecionado configurando sua largura para uma tamanho igual a sua altura.

Dica:

Pode-se utilizar Resize width e Resize height para criar círculos a partir de uma elipse ou quadrados a partir de retângulos. Selecione somente um objeto antes de utilizar essas ferramentas.

Pode-se também utilizar o cursor, mouse e setas do teclado para redimensionar objetos em sua tela. Ao selecionar um objeto (ou grupos de objetos) com o cursor, Selection handles (quadrados em preto) aparecem em cada canto e no ponto medial de cada lado. Pode-se utilizar esses handles como se segue:

• Para ampliar um objeto, clique em um handle e arraste seu cursor (ou apontador) na direção indicada pelas setas que aparecerão. Clicando e arrastando um lado redimensiona o objeto inteiro (altura e largura), enquanto clicar em um lado redimensiona o objeto somente em uma direção (somente altura ou somente largura).

• Para ampliar um objeto com controle de redimensionamento, clique em um handle e não solte o botão esquerdo do mouse. Clique nas setas do teclado para redimensionar o objeto (na direção indicada pelas setas de redimensionamento) um pixel por vez. Solte o botão do mouse quando o redimensionamento do objeto desejado estiver concluído.

• Para selecionar e redimensionar um polígono aberto ou fechado, desenhe uma caixa de seleção ao redor do polígono e agrupe-o (como descrito em “Botões Object Grouping e Ungrouping” página 192). Depois, clique em um handle e arraste-o para redimensionar o objeto.

• Para alterar a forma de um polígono aberto ou fechado, clique em um handle e uma caixa quadrada aparecerá na base de seu cursor. Arraste o handle para mover sua posição e alterar a forma do polígono.

Notas: Todos os objetos com propriedades dinâmicas e objetos Group of Symbols (incluindo a maioria dos objetos de símbolo e biblioteca) possuem múltiplos diálogos Object Properties e propriedades. Utilize uma lista drop-down no diálogo Object Properties (View → Object Properties) para acessar esses diálogos e propriedades.


InduSoft Web Studio

Página 188

Caso você queira redimensionar um símbolo ou grupos de objetos, o IWS redimensiona todos os objetos em concordância com o símbolo ou grupo.

botões Object Alignment

Ao selecionar uma série de objetos (dois ou mais), pode-se alinhar tais objetos baseados na localização do último objeto selecionado. Ao selecionar objetos, handles sólidas aparecem no último objeto selecionado, e os handles em todos os objetos previamente selecionados tornam-se vazios (não preenchidos).

Nota: De todas as figuras fornecidas, o retângulo representa o último objeto selecionado.

Utilize os botões de alinhamento que se seguem para alinhas uma série de objetos.

• Botão Align left ( ): Clique para alinhar todos os objetos selecionados para o limite esquerdo do último objeto selecionado. Por exemplo :

Alinhando objetos à esquerda

• Botão Align right ( ): Clique para alinhar todos os objetos selecionados para o limite direito do último objeto selecionado. Por exemplo:

Alinhando objetos à direita

• Botão Align top ( ): Clique para alinhar todos os objetos selecionados para o limite superior do último objeto selecionado. Por exemplo:


InduSoft Web Studio

Página 189

Alinhando objetos na parte superior

• Botão Align bottom ( ): Clique para alinhar todos os objetos selecionados para o limite inferior ao último objeto selecionado. Por exemplo:

Alinhando objetos na parte inferior

• Botão Center vertically ( ): Clique para alinhar todos os objetos selecionados ao centro e verticalmente do último objeto selecionado. Por exemplo:

Centrando objetos verticalmente

• Botão Center horizontally ( ): Clique para alinhar todos os objetos selecionados ao centro e horizontalmente ao último objeto selecionado. Por exemplo:

Centrando objetos horizontalmente


InduSoft Web Studio

Página 190

• Botão Evenly space horizontally ( ): Clique para colocar uma quantidade igual de espaços horizontais entre uma série de objetos (dois ou mais). Por exemplo:

Espaçando objetos horizontalmente

• Botão Evenly space vertically ( ): Clique para colocar um quantidade igual de espaços verticais entre uma série de objetos (dois ou mais). Por exemplo:

Espaçando objetos verticalmente

Nota: As funções de espaçamento podem mover o último objeto selecionado (com handles sólidos) por não mais que poucos pixels para espaçamento igual para todos os objetos.

Utilize os botões a seguir para alterar a orientação de um único objeto selecionado ou um grupo de objetos. Não é possível utilizar essas botões com múltiplos objetos selecionados.)

• Botão Flip horizontally ( ): Clique para inverter o objeto selecionado horizontalmente. O objeto rota-se em torno de uma linha imaginária através de seu centro horizontal até ser uma imagem espelho do objeto original. Por exemplo:

Roteando objetos horizontalmente


InduSoft Web Studio

Página 191

• Botão Flip Vertically ( ): Clique para inverter o objeto selecionado verticalmente. O objeto rota-se em torno de uma linha imaginária através de seu centro vertical até ser uma imagem espelho do objeto original. Por exemplo:

Roteando objetos verticalmente

• Botão Rotate ( ): Clique para rotear o objeto selecionado a 90 graus. Por exemplo:

Roteando objetos

botões Changing Object Layers

Utilize os seguintes botões de camada do objeto para mover objetos(s) selecionados para trás ou para a frente de um outro objeto(s) da tela.

Notas: IWS assinala um número único de identificação (ID#) para cada objeto na tela. Esses ID#s sempre iniciam-se em zero e alcançam o total de números de objetos na tela. Pode-se clicar em um objeto para exibir seu ID# na barra de status.

O IWS utiliza ID#s para determinar caso um objeto deve ser exibido a frente ou atrás de outro objeto na tela. Objetos com ID#s mais baixos exibem-se atrás de objetos com ID#s mais altos.

Caso você selecionar um grupo de objetos e movê-los para trás ou para frente de um outro objeto, o grupo selecionado de objetos mantém sua ordem de exibição original.


InduSoft Web Studio

Página 192

• Botão Move to back ( ): Clique para mover um objeto ou objetos selecionados para trás de todos os objetos na tela. O IWS assinala o objeto de menor ID# e move esse objeto para trás de todos os outros objetos na tela. Por exemplo:

Movendo objetos para trás (Selecionando o Retângulo Azul)

Nota: De forma alternativa, clique com o botão direito em um objeto e selecione Move to back do menu pop-up do objeto.

• Botão Move to front ( ): Clique para mover um objeto ou objetos selecionados para a frente de todos os outros objetos na tela. O IWS assinala o objeto com maior ID# e move-o para trás de todos os objetos na tela. Por exemplo:

Movendo objetos para a frente (Selecionando o Círculo Vermelho)

Nota: De forma alternativa, clique com o botão direito em um objeto e selecione Move to front do menu pop-up do objeto.

Botões Object Grouping e Ungrouping Utilize os botões que se seguem para agrupar e deseagrupar dois ou mais objetos selecionados.

Nota: Todos os objetos com propriedades dinâmicas e objetos Group of Symbols (incluindo a maioria dos objetos de símbolos e bibliotecas) possuem múltiplos diálogos e propriedades Object Properties. Pode-se utilizar a lista drop-down no diálogo Object Properties (View → Object Properties) para acessar esses diferentes diálogos e propriedades.

• Botão Group ( ): Clique para combinar múltiplos objetos em um único objeto, facilitando a seleção e manipulação do objeto. (Pode-se acessar cada parte do grupo no diálogo Object Properties.)


InduSoft Web Studio

Página 193

Nota:

De forma alternativa, clique com o botão direito em um objeto e selecione Group do menu pop-up do objeto.

• Botão Ungroup ( ): Clique para separar um objeto agrupado em seus componentes individuais.

Notas:

De forma alternativa, clique com o botão direito em um objeto e selecione Ungroup do menu pop-up do objeto.

Um grupo complexo de objetos pode consistir de vários conjuntos de objetos agrupados (conhecidos como subgrupos). Conseqüentemente, pode haver a necessidade de deseagrupar todos os subgrupos para desagrupar completamente um objeto complexo.

Utilizando Grupos de Telas O IWS fornece um recurso para agrupar telas (screen-grouping) que permite a abertura de um link de telas ao mesmo tempo.

Da barra de menu, selecione Insert � Screen Group para abrir o diálogo Insert Screen Group, onde pode-se criar um novo grupo de telas para sua aplicação.

Diálogo Insert Screen Group

Para criar um novo grupo de telas, digite um nome para o grupo no text box Name ou clique em uma tela fornecida em List of screens. Clique em OK ao terminar.

Nota:

Pode-se também criar um novo grupo de telas a partir do tab Graphics no Workspace. Clique com o botão direito na pasta Group Screen e depois selecione Insert screen group a partir do menu pop-up. A pasta Group Screen combina telas de exibição individuais da pasta Screens para grupos mais gerenciáveis.

Selecione File → Save Screen Group As HTML para salvar Screen Group em formato HTML, tornando-os disponíveis para Web Thin Client remotos através de um Browser da Web.

Para configurar a ordem que as telas de um grupo devem ser abertas quando o grupo determinado é solicitado, clique com o botão direito no nome do grupo da tela (a partir do tab Graphics do Workspace). Clique em Set Open Order no menu pop-up.


InduSoft Web Studio

Página 194

Diálogo Set Open Order

Utilizando a Barra de Ferramentas da Web

A barra de ferramentas da Web fornece botões que permitem abrir e navegar em arquivos HTML.

Barra de ferramentas da Web

Nota:

Deve-se instalar o Internet Explorer v4.1 (ou versões mais atuais) antes de utilizar qualquer das ferramentas na barra de ferramentas da Web.

• Botão Back ( ): Clique para retornar ao último endereço URL aberto no ambiente de desenvolvimento.

• Botão Forward ( ): Clique para retornar a um endereço URL aberto anteriormente, clicando no botão Back do ambiente de desenvolvimento.

• Botão Stop ( ): Clique para cancelar o processo de download de arquivos a partir de um endereço URL específico.

• Botão Refresh ( ): Clique para recarregar um endereço URL especificado no text box Address.

• Botão Home ( ): Clique para abrir a Home Page configurada em seu browser da web Internet Explorer.

• text box Address ( ): Digite um endereço URL da página da Web dentro do text box para abrir (fazer download) daquela página para seu browser da Web Internet Explorer.

• Botão Go ( ): Clique para fazer downloads de páginas especificadas no text box Address.

Salvando Telas em Formato HTML O IWS também habilita o salvamento de telas em formato HTML. Não é possível criar páginas HTML contidas na pasta Web Pages; elas são geradas a partir de telas pré-existentes. Para mais informações sobre como configurar e rodar uma aplicação Web Thin Client, veja Capítulo 13: Configurando uma Web Solution.


InduSoft Web Studio

Página 195

Para criar uma página HTML, deve-se primeiramente criar uma tela de exibição. Configure uma tela normalmente (crie objetos, adicione propriedades, etc), mantendo em mente que essa tela será uma página da Web. Ao terminar, salve a tela normalmente. Depois, com a tela ainda aberta, selecione File → Save As HTML.

Atenção:

As páginas da web que são geradas ao selecionar File → Save As HTML são independentes do arquivo de tela a partir do qual foram gerados. Conseqüentemente, caso você altere aquela tela de exibição, tais alterações não aparecerão na página da Web até que você selecione File → Save As HTML novamente.

Selecione File → Save Screen Group As HTML para salvar Screen Group em formato HTML, tornando-os disponíveis para Web Thin Clients remotos através de um Browser da Web.

Para visualizar páginas da Web, deve-se primeiramente configurar os parâmetros da Web no diálogo Project Settings (tab Web).

Diálogo Project Settings: Tab Web

Abra o diálogo e digite o endereço IP (a partir do qual a aplicação será rodada) no campo Data Server IP Address.

Digite um valor no campo Send Period para especificar o período de envio (em milissegundos) utilizados para trocar dados entre o Server e Web Thin Client stations.


InduSoft Web Studio

Página 196

Clique (habilite) os seguintes check-boxes caso seja aplicável:

check-box Disable Remote Client Commands: Clique (habilite) esse box para previnir que um cliente remoto tenha a permissão para comandos a partir de seu Web Thin Client para seu Server.

check-box Enable ToolTips: Clique (habilite) esse box para ver Windows ToolTips ao visualizar as telas da aplicação em Web Thin Client (browser).

check-box Auto Screen Scaling: Clique (habilite) esse box para escalar telas de escala exibidas em uma janela do Browser automaticamente.

Habilite esse parâmetro caso você esteja rodando em um Web Thin Client remotamente, e você deseja que o IWS escale telas automaticamente quando redimensionar a janela do Browser.

check-box Enable File Compression: Clique (habilite) esse box para comprimir os arquivos armazenados na pasta \Web da Aplicação. Essa opção é útil para reduzir tempo de download, particularmente se você possui uma conexão lenta entre seu Server e o Web Thin Client.

Clique no botão IP Security para abrir o diálogo IP Security. Utilize os parâmetros nesse diálogo para especificar a escala de endereços IP para os computadores que são permitidos a ter acesso a Aplicação como Web Thin Clients.


Quando os parâmetros do painel Edit tornarem-se ativos, digite os endereços IP nos campos From e To para especificar a escala de endereço IP. Utilize os botões Add e Remove para mover os endereços IP para a lista IP Address Range. O IWS permitirá aos computadores listados nesse painel o acesso as aplicações como Web Thin Clients.

Para habilitar o log para o Web Thin Client, mova o painel Log, clique (habilite) o check-box Enable e digite um nome do arquivo no campo Filename para a geração de um arquivo de log na Web Thin Client station. Pode-se utilizar esse arquivo de log para correção de erros.

Para habilitar o Virtual Keyboard para Web Thin Client stations, independentemente da estação local, clique no check-box Virtual Keyboard. Quando esse box está habilitado, os campos abaixo tornam-se ativos.

– Default: Selecione o teclado padrão utilizado na aplicação.

– Scale: Com essa opção, pode-se ampliar ou diminuir os teclados para que adaptem-se de forma apropriada com o tamanho da tela do painel alvo. Escala: 100% representa o tamanho padrão de cada Virtual Keyboard. As opções vão de 25% a 400%, embora você possa inserir um número personalizado.

- Show Hint: Especifique aqui o título do Virtual Keybord a ser mostrado no dialogo.

- Show Min/Max fields: Habilite esse check-box para a visualização dos valores máximos e mínimos permitidos pelo tag.


InduSoft Web Studio

Página 197

Clique em OK para fechar o diálogo Project Settings.

Notas: Caso você altere quaisquer informações da Web no diálogo Project Settings, deve-se verificar novamente a Aplicação para que a nova configuração surta efeito. Para verificar a Aplicação, Selecione Tools → Verify da barra de menu. (Caso você tenha janelas abertas no sistema de desenvolvimento, o IWS solicitará o fechamento dessas antes de verificar a Aplicação).

As páginas da Web exibem informações a partir da Aplicação através do Web server. Assim, você deverá estar rodando o sistema em runtime Web server TCP/IP server a fim de visualizar suas páginas da Web.

Utilizando a Barra de Ferramentas Bitmap

Utilize a barra de ferramentas Bitmap para acessar as ferramentas Bitmap Screen Editor (Essa barra de ferramentas estará disponível somente quando a camada Background Picture estiver ativa. Pode-se habilitar a camada Background Picture no diálogo Screen Attributes.)

Barra de ferramentas Bitmap

A barra de ferramentas Bitmap contém os seguintes botões:

• Botão Selecione Área ( ): Clique para selecionar uma área com o Bitmap Screen Editor.

• Botão Flood Fill ( ): Clique no botão Flood Fill e depois clique na tela para pintar a área adjacente com a cor especificada com o botão Fill Color.

• Botão Pixel Editing ( ): Clique para abrir um diálogo Edit Image, onde você poderá desenhar bitmaps detalhados, pixel por pixel.

Diálogo Edit Image


InduSoft Web Studio

Página 198

• Botão Erase Área ( ): Clique para remover uma área selecionada da tela.

• Botão Change colors ( ): Clique para alterar o preenchimento transparente para uma área selecionada.

Nota: Antes de poder utilizar esse botão, você deverá já ter especificado uma cor para preenchimento (Botão Fill Color), selecionado uma cor de transparência (Botão Selection Transparent Color), e definido a área a ser preenchida (Botão Selection Área).

• Botão Selection Transparent Color ( ): Clique para especificar uma cor transparente (referido pelo botão Change Colors).

• Botão Toggle Transparent Color ( ): Clique para aplicar a cor selecionada, utilizando o botão Select Transparent Color para tornar transparente os bitmaps selecionados em Bitmap Screen Editor.

Dica: Pode-se utilizar os comandos Copy (Ctrl+C) e Paste (Ctrl+V) para trocar figuras de bitmap entre Bitmap Screen Editor do IWS e quaisquer outros editores de bitmap (Paint Brush, por exemplo).

Utilizando a barra de ferramentas Static Objects

A barra de ferramentas Static Objects fornece botões a serem utilizados para criar polígonos, retângulos, linhas e outros objetos para sua tela.

Barra de Ferramentas Static Objects

A barra de ferramentas Static Objects contém os seguintes botões:

• Botão Open Polygon ( ): Clique para desenhar um polígono aberto com uma borda na cor especificada para primeiro plano.

Para desenhar um polígono aberto na área de desenho:

Clique com o botão esquerdo do mouse para configurar o ponto de início do polígono.

Mova o cursor para o novo local e clique novamente para adicionar seu Segundo vértice.

Repita esse processo até que você tenha criado a forma do polígono desejado.

Clique duas vezes para finalizar o desenho do polígono.

Para visualizar as propriedades do objeto, clique duas vezes no objeto poígono e o diálogo Object Properties será exibido:


InduSoft Web Studio

Página 199

Diálogo Object Properties: Open Polygon

Utilize o diálogo Object Properties para especificar os seguintes parâmetros para o polígono:

Line: Especifica um estilo de linha fronteiriça, clicando-se nos botões No Line, Solid Line, ou Dashed Line.

Color: Especifica uma cor para linha fronteiriça, clicando-se no botão Color. Quando o diálogo Color abrir, clique em uma cor para selecioná-la, e a seguir feche o diálogo.

Weight: Especifica a largura da linha fronteiriça (em pixels) digitando um número representando a largura da linha dentro de um text box.

• Botão Closed Polygon ( ): Clique para desenhar um polígono fechado, utilizando uma borda na cor especificada para primeiro plano.

Para desenhar um polígono fechado na área de desenho:

Clique com o botão esquerdo do mouse para configurar o ponto de início do polígono.

Mova o cursor para o novo local e clique novamente para desenhar o segundo ponto.

Repita esse processo até que você tenha criado a forma do polígono desejado.

Clique duas vezes para finalizar o desenho do polígono.

Para visualizar as propriedades do objeto, clique duas vezes no objeto polígono. O diálogo Object Properties será exibido:

Diálogo Object Properties: Closed Polygon

Utilize o diálogo Object Properties para especificar os seguintes parâmetros para o polígono:

Line: Especifica o estilo de linha para as bordas, clicando-se nos botões No Line, Solid Line, ou Dashed Line.

Color: Especifica a cor para linha das bordas, clicando-se no botão Color. Quando o diálogo Color abrir, clique em uma cor para selecioná-la e depois feche o diálogo.

Weight: Especifica a largura da borda (em pixels) digitando um número representando a largura da linha dentro do text box.

Fill: Para especificar se o polígono deverá ser preenchido, clique em No Fill ou Fill.

Caso você habilite a opção Fill, pode-se especificar uma cor de preenchimento clicando no botão Color. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

• Botão Line ( ): Clique para desenhar uma linha ortoginal na área de desenho, como se segue:


InduSoft Web Studio

Página 200

Clique com o botão esquerdo do mouse para configurar o ponto de início da linha.

Arraste o cursor para ajustar o tamanho da linha.

Clique novamente para posicionar o objeto.

Para visualizar as propriedades do objeto, clique duas vezes no objeto. O diálogo Object Properties aparecerá:

Object Properties: Line

Utilize o diálogo Object Properties para especificar os seguintes parâmetros para a linha ortogonal:

Line: Especifica o estilo da linha, clicando-se nos botões No Line, Solid Line, ou Dashed Line.

Color: Especifica uma cor para a linha, clicando se no botão Color. Quando o diálogo Color abrir, clique em uma cor para selecioná-la e depois feche o diálogo.

Weight: Especifica a largura da linha (em pixels) digitando um número representando a largura da linha dentro do text box.

• Botão Ellipse ( ): Clique para desenhar elipses, acordes, arcos e anéis. Por exemplo:

Oval, Acorde, Arco, e Anel

Dica: O estilo Ring é particularmente útil ao criar desenhos em plumb.

Para criar uma elipse, siga os seguintes passos:

Clique na área de desenho e arraste o mouse/cursor para criar uma forma oval.

Solte o botão do mouse para finalizar o desenho.

Utilize o diálogo Object Properties para alterar a forma para um acorde, arco, anel, etc.

Clique duas vezes no objeto para visualizar o diálogo Object Properties:

Object Properties: Ellipse


InduSoft Web Studio

Página 201

Utilize o diálogo Object Properties para especificar os seguintes parâmetros para a elipse:

Style: Especifica o estilo do objeto, selecionado Ellipse, Arc, Chord, ou Ring da lista drop-down. A seguir, selecione Left-Bottom, Left-Top, Right-Bottom, ou Right-Top da lista Style para escolher o quadrante no qual a elipse será desenhada.

Por exemplo, para representar uma metade de um cano, crie dois objetos Ring. Especifique um como Left-Bottom e o outro como Right-Bottom e depois una os dois objetos, criando assim um cano pela metade.

Fill: Para especificar se a elipse será preenchida, clique em No Fill ou Fill.

Caso você teha selecionado a opção Fill, especifique uma cor para preenchimento, clicando no retângulo Color. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

Line: Especifica um estilo de linha para as bordas da elipse, clicando-se nos botões No Line, Solid Line, ou Dashed Line.

Color: Especifica a cor das bordas da elipse, clicando-se no botão Color para abrir o diálogo Color. Clique na cor e selecione-a, e depois feche o diálogo.

Weight: Especifica a largura para a linha da borda de uma elipse, digitando um número representando a largura da linha (em pixels) dentro do text box fornecido.

• Botão Rounded Rectangle ( ): Clique para desenhar retângulos arredonados (vazios ou preenchidos), como se segue:

Clique na área de desenho e arraste o mouse/cursor para criar o retângulo.

Solte o botão do mouse para finalizar o desenho do objeto.


Object Properties: Rounded Rectangle

Notas: Não é possível utilizar o botão retângulos arredondados para criar um bar graph para aplicações em Windows CE.

Um retângulo arredondado possui uma marca extra no canto inferior esquerdo, o que permite a modificação do ângulo do arco.


Line: Especifica um estilo de borda, clicando-se nos botões No Line, Solid Line, ou Dashed Line.

Color: Especifica um estilo de cor para bordas, clicando-se no botão Color para abrir o diálogo Color. Clique na cor para selecioná-la e depois feche o diálogo.

Weight: Especifica a largura de uma borda digitando um número representando a largura da linha (em pixels) dentro do text box fornecido.

Fill: Especifica se o retângulo será preenchido, clicando-se em No Fill ou Fill.

Caso você selecionar a opção Fill, especifique uma cor de preenchimento, clicando-se no botão Color. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.


InduSoft Web Studio

Página 202

Color: Especifica uma cor de preenchimento, clicando-se no botão Color para abrir o diálogo Color. Clique em uma cor para selecioná-la e depois feche o diálogo.

Caption: Essa opção não está disponível para esse objeto.

• Botão Rectangle ( ): Clique para criar retângulos, como se segue:

Clique na área de desenho e arraste o mouse/cursor para desenhar o retângulo.

Solte o botão do mouse quando o retângulo estiver no tamanho desejado.


Object Properties: Rectangle


Type: Especifica um estilo de linha para bordas, clicando-se em None, Solid, Dashed, Etched, Raised ou Sunken.

Color: Especifica uma cor para linha de brodas, clicando-se no botão Color para abrir o diálogo Color. Clique na cor para selecioná-la e depois feche o diálogo.

Weight: Especifica a largura de uma linha de borda, digitando um número representando a largura da linha (em pixels) dentro do text box fornecido.

Fill: Especifica se o retângulo deve ser preenchido, clicando-se em No Fill ou Fill.

Caso você tenha selecionado a opção Fill, especifique uma cor de preenchimento, clicando-se no retângulo Color. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

Color: Especifica uma cor de preenchimento, clicando-se no botão Color para abrir o diálogo Color. Clique em uma cor para selecioná-la e depois feche o diálogo.

Caption: Aperte esse botão para abrir o diálogo Caption onde você poderá editar o texto a ser escrito dentro do objeto retângulo.

Selecionando o botão Caption

* Caption: Digite o texto que você deseja exibir dentro do objeto retângulo nesse text box.

* Extern translation (opcional): Especifica um arquivo de tradução externa para o caption retângulo, clicando-se no box.


InduSoft Web Studio

Página 203

* Fonts: Especifica um estilo de fonte para caption, clicando-se no botão Fonts.

* Align: Especifica o alinhamento para o caption do retângulo.

* Multiline: Permite que o texto do retângulo seja exibido em mais de uma linha, quando habilitado.

* Wrap Text: Quando habilitado, o objeto envolve o texto quando necessário.

* Auto gray out: Faz o caption do retângulo tornar-se cinza quando o clique aplicado ao retângulo está desabilitado pelo campo Disable ou devido ao sistema de segurança.

• Botão Button ( ): Clique para criar botões personalizados, como se segue:

Clique na área de desenho e arraste o mouse/cursor para criar a forma do botão.

Solte o botão do mouse quando o botão está do tamanho desejado.


Object Properties: Button

Utilize o diálogo Object Properties para especificar os seguintes parâmetros para o botão:

Caption: Especifica um caption, digitando o texto dentro do text box.

Fonts: Especifica um estilo de fonte para o caption, clicando-se no botão Fonts.

Quando o diálogo Fonts aparecer, especifique os seguintes parâmetros:

* Font (typeface)

* Font style

* Size

* Effects

* Color

* Script style

Weight: Especifica a largura de uma linha de borda, digitando um número representando a largura da linha (em pixels) dentro do text box.

Extern translation (opcional): Especifica um arquivo de tradução externa para a marca inferior, clicando-se (habilitando) no box.

Multiline: Permite o caption do botão ser exibido em mais de uma linha, quando habilitado.

Wrap Text: Quando habilitado, o objeto envolve automaticamente o texto quando necessário.

Auto gray out: Muda o caption do botão para cinza, quando a dinâmica Command aplicada ao botão está desabilitada pelo campo Disable ou devido ao sistema de segurança.

• Botão Text ( ): Clique para criar objetos de texto, como se segue:

Clique na área de desenho. Quando aparecer um cursor, pode-se digitar uma linha de texto.

Após inserir uma string de texto, clique duas vezes no novo objeto de texto para visualizar o diálogo Object Properties.


InduSoft Web Studio

Página 204

Object Properties: Text

Utilize o diálogo Object Properties para especificar os seguintes parâmetros para linhas ortogonais:

Caption: Especifica uma string de texto digitando um caption no text box.

Align: Alinha o texto, selecionando Left, Center, ou Right no combo-box.

Fonts: Especifica um estilo de fonte para o texto, clicando-se no botão Fonts. Quando o diálogo Fonts aparecer, pode-se especificar os seguintes parâmetros:

* Font (typeface)

* Font style

* Size

* Effects

* Color

* Script

Border: Especifica uma borda de texto, clicando-se no box Border.

Para selecionar uma cor para bordas, clique no retângulo Color. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

Background: Especifica uma cor de fundo, clicando-se no botão Color. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

Transparent: Especifica uma cor para bordas, clicando-se no botão Color. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

Extern translation (opcional): Especifica um arquivo de tradução externa para o texto, clicando-se (habilitando) esse box.

Utilizando a Barra de Ferramentas Dynamic Properties

Utilize a barra de ferramentas Dynamic Properties para aplicar dinâmicas a objetos ou um grupo de objetos. Dinâmicas habilitam a modificação de propriedades do objeto durante execução (em runtime) em concordância com valores de tags. Algumas dinâmicas habilitam também a execução de comandos ou inserção de valores (set points) para os tags.

Barra de Ferramentas Dynamic Properties

A barra de ferramentas Dynamic Properties contém os seguintes botões:

• propriedade Command ( ): Clique para adicionar a dinâmica Command para um objeto selecionado ou grupos de objetos. A dinâmica Command habilita você a clicar no objeto ou pressionar uma tecla pré-definida para executar o comando em runtime.

Clique duas vezes no objeto para visualizar as propriedades do objeto.


InduSoft Web Studio

Página 205

Object Properties: Command

A dinâmica Command fornece um tag para cada um dos eventos por ele suportados. Note que mais de um evento pode ser configurado simultaneamente para a mesma dinâmica Command:

Evento Descrição

On Down Executa command/script uma vez quando o usuário clica no objeto com o botão esquerdo do mouse.

On While

Mantém execução de command/script continuamente, enquanto o mouse é pressionado sob o objeto. O período (em milissegundos) de execução para command/script é configurado no campo Rate da tela de diálogo Configuration, exceto para a opção VBScript, que é executada o mais rápido possível.

On Up Executa command/script uma vez que o usuário libera o botão esquerdo do mouse no objeto.

On Right Down Executa command/script uma vez que o usuário clica no objeto com o botão direito do mouse.

On Right Up Executa command/script uma vez que o usuário libera o botão direito do mouse no objeto.

On Double Click

Executa command/script uma vez que o usuário clica duas vezes no objeto com o botão esquerdo do mouse.

Notas: O IWS trata as ações touch-screen do mesmo modo que trata as ações do mouse. Em outras palavras, é transparente para o IWS caso algum evento foi disparado por uma interface touch-screen ou por um mouse regular.

Os eventos On Right Down, On Right Up e On Double Click não são suportados por aplicações do CEView (Rodando em sistema operacional Windows CE).

Ao criar uma aplicação para um equipamento touch-screen, é importante que se mantenha em mente que eventos On Right Down e On Right Up não poderão ser disparados em tais equipamentos.


InduSoft Web Studio

Página 206

Key: Atalho utilizado para disparar eventos On Down, While Down e On Up com a utilização de um teclado. Essa opção é especialmente útil ao criar aplicações para equipamentos em runtime que não forneçam um mouse ou interface touch-screen – o teclado é a única interface física disponível para interagir com a aplicação durante o runtime.

Config: Inicia a tela de diálogo Configuration, onde a dinâmica Command pode ser totalmente configurada.

Esse diálogo permite a configuração dos parâmetros Command, como se segue:

Diálogo Configuration

* Type: Esa configuração define o tipo de ação que deverá ser executada pelo evento da dinâmica Command. Note que cada evento possui seu próprio tipo. Portanto, a mesma dinâmica Command pode ser configurado com diferentes tipos de ação para diferentes eventos. Os seguintes tipos são suportados:

Tipo Descrição

Built-in Language

Permite que você configure um script utilizando a linguagem built-in do IWS. Quando esse tipo é selecionado, o usuário pode configurar até 12 expressões para cada evento no coluna Expression. Essas expressões são executadas sequencialmente a partir da primeira linha até a última quando o evento é disparado. O resultado de cada expressão é registrada para o tag configurado na coluna Tag (caso haja). Consulte o Capítulo Linguagem Buil-in do IWS para maiores informações.

VBScript

Permite que você configure um script utilizando o padrão de linguagem VBScript. Quando esse tipo é selecionado, o usuário pode configurar um script no editor VBScript para a dinâmica Command. Consulte o Capítulo VBScript para maiores informações sobre a linguagem VBScript.

Open Screen Permite que você configure a dinâmica Command para abrir uma tela específica quando o evento é disparado durante o runtime. Esse tipo é equivalente a função built-in Open() do IWS. Você pode também digitar o nome da tela no campo Open Screen ou navegá-lo. Mais do que isso, você


InduSoft Web Studio

Página 207

Tipo Descrição

pode digitar um tag string entre colchetes {TagName} nesse campo. Quando o evento é executado, o IWS tentará abrir a tela nomeada.

Close Screen

Permite que você configure a dinâmica Command para fechar uma tela específica quando o evento é disparado durante o runtime. Esse tipo é equivalente a função built-in Close() do IWS. Você também pode digitar o nome da tela no campo Close Screen ou navegá-la. Você também pode digitar um tag string entre colchetes {TagName} nesse campo. Quando o evento é executado, o IWS tentará fechar a tela nomeada.

Set Tag

Permite que você configure a dinâmica Command para configurar um tag quando o evento é disparado durante o runtime. Você pode também digitar o nome do tag no campo Set Tag ou navegá-lo. Quando o evento é executado, o IWS registrará o valor 1 para o tag configurado nesse campo.

Reset Tag

Permite que você configure a dinâmica Command para reiniciar um tag quando o evento é disparado durante o runtime. Você pode também digitar o nome do tag no campo Reset Tag ou navegá-lo. Quando o evento é executado, o IWS registrará o valor 0 para o tag configurado nesse campo.

Toggle Tag

Permite que você configure a dinâmica Command para inverter um tag quando o evento é disparado durante o runtime. Você pode também digitar o nome do tag no campo Toggle Tag ou navegá-lo. Quando o evento é executado, o IWS inverterá o valor do tag configurado nesse campo.

As configurações a seguir são compartilhadas para todos os eventos:

* Enable Focus: Quando essa opção está habilitada, o objeto que a dinâmica Command ao qual foi aplicada pode receber o foco durante o runtime, através de teclas de navegação.

* Force: Quando essa opção está habilitada, qualquer tag que receba um valor irá gerar eventos baseados em suas alterações, mesmo se o valor do tag em questão não se altere. Por exemplo, caso um tag tenha o valor 0 e a dinâmica Command reescreva o mesmo valor 0 para esse tag 0, qualquer outra tarefa do IWS reconhecerá que esse tag alterou seu valor (mesmo que não tenha alterado) após executar o dinâmico. Essa opção é útil quando você deseja certificar-se de que ações dirigidas por alterações de tag (e.x. Write on Tag Change a partir de um driver de comunicação) são disparadas após a dinâmica Command ser executada.

* Beep: Quando essa opção está habilitada, um som curto é tocado quando Command é executado. Essa opção é útil para fornecer um feed-back audível para o usuário, indicando que Command foi executado, e não indica, entretanto, se a ação disparada pela dinâmica Command foi alcançada com sucesso ou não.

* Release: Quando essa opção está habilitada, o evento On Up é executado quando você arrasta o cursor (ou seu próprio dedo) para fora da área do objeto (caso o botão tenha sido liberado ou não). Essa opção é útil para certificar-se de que o evento On Up será sempre executado após um evento On Down, mesmo que o usuário leve o cursor do mouse para fora da área do objeto antes de liberá-lo.

* Confirm: Quando essa opção está habilitada, o usuário terá que responder uma pergunta de confirmação antes de executar o comando. Essa opção é útil para diminuir disparos acidentais de eventos críticos durante o runtime.

* E-Sign: Quando essa opção está habilitada, o usuário será requisitado a inserir a Assinatura Eletrônica antes de executar o dinâmico.

* Disable: Desabilita a ação pelo usuário quando o resultado da expressão configurada nesse campo é VERDADEIRA (TRUE) (valor diferente de 0).


InduSoft Web Studio

Página 208

* Security: Nïvel de Acesso ao Sistema de Segurança requisitado para o objeto/dinâmico

• Botão Hyperlink ( ): Clique para adicionar a propriedade de hyperlink para um objeto ou grupo de objetos selecionados. Aplicar essa propriedade permite clicar no objeto (s) durante a execução para inicializar o browser padrão e carregar a URL especificada.

Clique duas vezes no objeto para abrir o diálogo Object Properties:

Object Properties: Hyperlink

Pode-se utilizar esse diálogo para especificar os seguintes parâmetros:

combo-box Hyperlink Type: Clique no botão do combo-box para selecionar um protocolo URL da lista. O IWS utiliza esse protocolo ao carregar a URL.

check-box E-Sign: Quando essa opção está habilitada, o usuário é solicitado a inserir uma Assinatura Eletrônica antes de executar o dinâmico.

Campo URL: Digite o endereço da URL que você deseja carregar (Por exemplo: iwsdobrasil.com).

Dica: Você não precisará inserir o tipo de protocolo no campo URL. Ao selecionar um tipo de protocolo da lista Hyperlink Type, o IWS adiciona automaticamente o prefixo do protocolo para o endereço da URL.

Disable: Digite um valor maior que zero nesse campo para desabilitar a propriedade de comando hyperlink para o objeto(s) selecionado.

Campo Security: Digite um valor nesse campo para especificar um nível de segurança para o objeto (s). Caso um usuário efetuar logs on, e não possuir o nível de segurança requisitado, o IWS desabilitará o comando hyperlink para o objeto(s).

• Botão Bargraph ( ): Clique para adicionar propriedades bar graph para um objeto selecionado, e depois clique duas vezes no objeto para abrir o diálogo Object Properties.

Object Properties: BarGraph


InduSoft Web Studio

Página 209

Nota: Não pode-se utilizar o botão retângulo arredondado para criar um bar graph para aplicações em Windows CE.

Utilize o diálogo Object Properties para especificar os seguintes parâmetros:

Campo Tag/Expression: Digite um tag ou uma expressão que determine o nível de bar graph. Pode-se também clicar no botão para procurer entre seus diretórios um tag ou expressão existente.

Campo Minimum Value: Digite uma constante numérica ou valor de tag nesse campo para definir o valor mínimo utilizado para calcular o tamanho das barras.

Campo Maximum Value: Digite uma constante numérica ou um valor de tag nesse campo para definir o valor máximo utilizado para calcular o tamanho das barras.

Dica: O IWS também permite a inserção de constantes em campos de valor tag/numérico. Valores constantes (definidos pelo caractere #) são equivalentes a valores numéricos, embora constantes sejam exibidos no diálogo Tag Replace. Deve-se encontrar constantes úteis para fins de documentação ou para criação de objetos genéricos. Por exemplo: #Name:100.

Onde o valor (100) seguindo o caractere (:) é a constante, e Name é somente a constante mneumônica e não adicionada ao banco de dados.

Foreground Color: Para especificar uma cor de preenchimento para barras, clique no botão do combo-box. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

painel Direction: Clique no radio button Vertical ou Horizontal para especificar a direção de bar graph.

painel Orientation: Clique nos botões Up, Center, ou Down para especificar a orientação dos valores máximos e mínimos ao desenhar as barras.


InduSoft Web Studio

Página 210

• Botão Text I/O ( ): Clique para adiccionar o dinâmico de propiedade de texto input ou output para um objeto de texto selecionado. Aplicar a propriedade Text I/O permite a inserção e exibição de valores de tags em tempo real, caso você esteja utilizando o teclado ou keypad on-screen para rodar uma aplicação.

Nota: Pode-se aplicar essa propriedade de dinâmico somente para objetos de texto que contenham o caractere # (Cada # representa um caractere) para ser substituído por um valor durante o runtime.

Clique duas vezes no objeto para abrir o diálogo Object Properties. Pode-se utilizar esse diálogo para especificar os seguintes parâmetros:

Object Properties: Text I/O

Campo de Texto Tag/Expression: Digite um dos tópicos que se seguem no campo:

* Um tag no qual executar uma operação de entrada e saída

* Uma expressão na qual executar somente uma operação de saída

* Pode-se clicar no botão para procurar em seus diretórios para um tag ou expressão já existentes.

check-box Input Enable: Habilite essa opção para permitir entrada de dados. Desabilite a opção e esse dinâmico executa somente os dados de saída.

check-box Confirm: Habilite essa opção para requisitar usuários a confirmar quaisquer valores configurados durante o runtime.

Campo Minimum Value: Habilite essa opção para definir um valor mínimo para o tag associado a esse objeto de texto. Não será permitida a entrada de um usuário com número menor que esse valor.

Campo Maximum Value: Habilite essa opção para definir um valor máximo para o tag associado a esse objeto de texto. Não será permitida a entrada de um usuário com número maior que esse valor.

check-box Password: Habilite essa opção para ocultar o texto senha para entrada, substituindo o texto por asteriscos (*).

combo-box Fmt (format): Clique no botão do combo-box para selecionar um formato para o campo input/output. (Decimal é o único formato disponível para aplicações em CE.)

check-box E-Sign: Quando essa opção está habilitada, o usuário é solicitado a inserir a Assinatura Eletrônica antes de alterar o valor do tag.

Campo VK: O tipo de Virtual Keyboard utilizado para esse objeto. Você precisa habilitar a opção Virtual Keyboard na interface Project � Settings � Runtime Desktop antes de configurar o Virtual Keyboard para essa interface.


InduSoft Web Studio

Página 211

Campo Disable: Digite um valor maior que zero nesse campo para desabilitar as propriedades de entrada de dados do tag.

Campo Security: Digite um valor nesse campo para especifcar o nível de segurança para um objeto de entrada de dados específico (como definido na seção Security).

Botão Colors ( ): Clique para adicionar a propriedade de alteração de cor para um objeto selecionado. O dinâmico Colors permite a modificação da cor de um objeto estático durante o runtime baseado no valor de um tag ou expressão.

Clique duas vezes no objeto para abrir a caixa de diálogo Object Properties.

Object Properties: Colors


Campo Type: Determina o modo no qual esse dinâmico funcionará:

* By Limit: Ao selecionar esse tipo, pode-se especificar até quatro limites (Change Limit) para esse dinâmico e uma cor para cada limite. Quando o valor do tag ou expressão configurado no campo Tag/Expr alcança os limites, a cor associada com o respectivo limite é aplicada ao objeto.

* By Color: Ao selecionar esse tipo, pode-se especificar o código que deve ser aplicado ao objeto diretamente no campo Tag/Expr. Utilizando esse código, pode-se aplicar ao objeto qualquer cor suportada pelo seu equipamento.

Dica: Pode-se configurar a função RGBColor() no campo Tag/Expr quando Type = By Color, o que permite a configuração da cor por seus códigos RGB. Veja IWS Development Environment -> Standard Interfaces -> Color Interface para uma tabela com os códigos para as cores mais comumente utilizadas.

Campo Tag/Expression: Digite o nome de um tag ou expressão a qual você deseja monitorar. Quando Type = By Limit, o IWS compara o resultado do tag/expressão com os Limites de Alteração especificados para determinar a cor apropriada para o objeto selecionado. Quando Type = By Color, o resultado desse campo configure a cor que será aplicada ao objeto.

Campo Change Limit: Digite um valor limite (uma constante numérica ou tag) para a alteração da cor. Os números devem ser configurados em ordem ascendente, de acordo com a seguinte seqüência de campos exibidos na janela de diálogo Object Properties: Campos esquerda acima, esquerda a baixo, direita acima e direita abaixo. Clicando no botão More, pode-se configurar até 16 limites diferentes para o dinâmico color.


InduSoft Web Studio

Página 212

Caixa de Diálogo Color Limits

combo-box Color: Clique no botão do combo-box para associar uma cor com cada limite de cor. Quando o diálogo Color abrir, clique em uma cor para selecioná-la e depois feche o diálogo.

combo-box Blink: Clique no botão do combo-box para especificar se a alteração de cor deverá piscar, e a velocidade que deverá ocorrer.

Nota: Os campos que se seguem são desabilitados automaticamente quando Type = By Color: Change Limit, Color e Blink.

• Botão Position ( ): Clique para especificar quando e onde exibir uma objetos, utilizando os valores de tags especificados.


Object Properties: Position

Pode-se utilizar esse diálogo para especificar os paramêtros a seguir:

Campo Show on condition: Digite uma expressão nesse campo. Caso o valor de retorno seja zero ou menor, o objeto será oculto (a direção que o slider move-se é determinada pela configuração de Horz: ou Vert: linhas da propriedade. (Nota: Quando um objeto está invisível, utilizar a condição show on também o desabilita.)

check-box Slider: Habilite esse box para operar o objeto como um slider (o que significa arrastar o objeto para aplicar valores correspondentes para os tags).

Campo Sec (security): Digite um valor nesse campo para especificar o nível de segurança requisitado que permita a entrada de operadores com a utilização de objetos slider.


InduSoft Web Studio

Página 213

Campo Tag: Digite um tag associado ao objeto, permitindo que o objeto mova-se horizontalmente e verticalmente através da tela.

Campo Range: Digite valores nesses campos para especificar os limites mais altos e mais baixos para os valores de tags, permitindo ao objeto mover-se através da tela de acordo com o valor do tag junto a essa escala.

Campo Position: Digite valores nesse campo paea especificar quantas alterações de posição (em pixels) pode-se mover um objeto na tela de acordo com a condição estabelecida. Pode-se inserir valores negativos no Segundo campo (posição de destino).

combo-box Reference: Selecione uma das seguintes opções como um ponto de referência a ser utilizado ao mesmo tempo que o objeto é movido na tela. É necessário especificar essa opção somente se você desejar redimensionar o objeto ou movê-lo.

* Left: Canto esquerdo do objeto

* Right: Canto direito do objeto

* Center: Centro do objeto

* Top: Canto superior do objeto

* Bottom: Canto inferior do objeto

• Botão Resize ( ): Clique para aumentar ou diminuir o tamanho de um objeto ou símbolo selecionado. Clique duas vezes no objeto/símbolo para abrir o diálogo Object Properties:

Object Properties: Resize

Utilize o diálogo Object Properties para especificar os seguintes parâmetros:

Campos Tag: Digite valores nos campos Height e Width para aumentar ou diminuir o tamanho na horizontal e na vertical do objeto.

Campos Range: Digite valores para especificar os maiores e menores limites do tag, os quais serão utilizados pelo IWS para aumentar ou diminuir o tamanho do objeto.

Campos Size (%): Digite valores para especifcar uma escala de porcentagem, o qual o IWS utilizará para aumentar e diminuir o tamanho do objeto.

combo-boxes Reference: Selecione um dos seguintes pontos de referência para determinar como o objeto aumenta seu tamanho horizontalmente e verticalmente.

* Left: A partir do lado esquerdo

* Right: A partir do lado direito

* Center: Horizontal e verticalmente a partir do centro do objeto

* Top: A partir do lado de cima

* Bottom: A partir do lado de baixo

• Botão Dynamic Rotation ( ): Clique para rotear uma linha. Clique duas vezes na linha para abrir o diálogo Object Properties:


InduSoft Web Studio

Página 214

Object Properties: Dynamic Rotation

Utilize esse diálogo para especificar os seguintes parâmetros:

Campo Tag/Expression: Digite um nome de tag ou expressão para associar com a linha selecionada. O IWS lê o valor representado na tela utilizando essa variável ou expressão.

área Range: Digite valores de tags Minimum e Maximum utilizados para mover a linha através da tela, de acordo com a condição estabelecida.

área Rotation (degrees): Digite valores de início e término para especificar quantos graus pode-se rotear uma linha na tela (rotação dinâmica).

* Windows NT: Pode-se rotear uma linha em até 360 graus

* Windows CE: Pode-se rotear uma linha não mais do que 90 graus

combo-box Reference: Selecione um dos seguintes pontos de referência para rotear o objeto através da tela:

* Left Top: Canto superior esquerdo do objeto

* Right Bottom: Canto inferior direito do objeto

* Center: Centro do objeto

Utilizando a Barra de Ferramentas Active Objects

A barra de ferramentas Active Objects fornece botões para que você possa criar objetos dinâmicos. Objetos dinâmicos tipicamente requisitam mais parâmetros do que objetos estáticos.

Barra de Ferramentas Active Objects

A barra de ferramentas Active Objects contém os seguintes botões:

• Botão Alarm/Event Control Object ( ): Clique para adicionar um Objeto de Controle Alarm/Event para a tela de sua aplicação.

Para criar e configurar um Objeto de Controle Alarm/Event:

Clique no botão Alarm/Event Control.

Clique na tela e arraste o mouse para criar e ajustar a forma do objeto.


InduSoft Web Studio

Página 215


Object Properties: Alarm/Event Control

Utilize o diálogo Alarm/Event Control de Object Properties para configurar o Objeto de Controle Alarm/Event, como se segue selecione um modo de objeto de alarme no painel Type:

* On Line: Clique (habilite) nesse botão para exibir mensagens de alarme atuais.

* History: Clique (habilite) nesse botão para exibir mensagens de alarme a partir do banco de dados histórico de mensagens.

Clique (habilite) no check-box Show gridlines para exibir gridlines no objeto:

Exibindo um Grid

Clique (habilite) no check-box Show Header para exibir um header no objeto:

Exibindo um Header


InduSoft Web Studio

Página 216

Clique no botão Font para abrir o diálogo Font onde você poderá especificar propriedades de exibição para texto de alarme.

Diálogo Font

Utilize Font, Font Style, e listas Size para especificar um typeface, estilos de fonte e tamanho.

* Clique (habilite) os check-boxes no painel Effects para Strikeout (strikeout text) ou Underline (underlining) o texto de alarme, ou utilize o combo-box para especificar uma cor para o texto de alarme. (Nota: O painel Sample mostra como o texto aparecerá no objeto.)

* Por padrão, o IWS utiliza fontes Western-style. Caso você deseje alterar o padrão, clique no botão Script do combo-box e selecione-o a partir da lista. (Nota: Os conteúdos das listas desse combo-box dependerão de seu sistema operacional.)

* Ao terminar, clique em OK para fechar o diálogo Font.


InduSoft Web Studio

Página 217

Clique no botão Columns para abrir o diálogo Columns onde você poderá especificar propriedades de exibição para colunas no Objeto de Controle Alarm/Event.

Diálogo Columns

* Utilize o box Key para assinalar um atalho para cada coluna, o que permitirá procurer/organizar a informação no objeto Alarm Control por cada coluna, utilizando teclas do teclado ao invés do cursor do mouse.

* A lista Available contém todos os tipos de colunas disponíveis para esse objeto.

* A lista Visible contém todos os tipos de colunas atualmente em uso para o objeto.

* Clique nos botões para mover seleções entre duas listas.

Dica: Utilize o diálogo Columns para exibir o valor mais recentemente substituído pelo novo valor. Para isso, mova ambos, Value e Previous da lista Available para a lista Visible.

* Clique nos botões Move Up ou Move Down para rearranjar a ordem das colunas na lista Visible.

* Utilize os campos Label e Width no painel Properties para alterar o padrão das marcas e larguras em runtime.

* Utilize o combo-box Align para especificar o alinhamento (Left, Center, ou Right) para o texto da mensagem de alarme junto a uma coluna especificada.

* Clique (habilite) o check-box Available during runtime para permitir ao usuário adicionar colunas selecionadas para a lista visível durante o runtime.

* Ao terminar, clique em OK para fechar o diálogo Columns.


InduSoft Web Studio

Página 218

Para filtrar mensagens de alarme durante o runtime, clique no botão Filters. O diálogo Filters será exibido, de forma que você poderá especificar parâmetros de filtração para o Objeto de Controle Alarm/Event.

Diálogo Filters

* Utilize o campo Group para filtrar mensagens de alarme para um ou mais grupos de usuários. Digite o número Group no campo de texto (Por exemplo, 1). Também pode-se utilizar uma virgula ou um traço para especificar mais de um grupo (Por exemplo, 1,3,5-6)

* Utilize o campo Selection para filtrar mensagens de alarme pelo texto Selection configurado na planilha Alarm.

* Utilize os parâmetros de From e To no painel Priority para filtrar mensagens de alarmes baseadas em prioridade. Digite valores nos campos de texto para delimitar a escala de prioridade.


InduSoft Web Studio

Página 219

* Utilize os campos de texto Tagname, Message, e/ou Username no painel Search in columns para especificar um critério para filtração de mensagens de alarme. Digite um tagname, mensagem, e/ou nome de usuário no campo de texto para o qual você deseja a busca pelo IWS.

* Utilize os parâmetros no painel Interval para filtrar mensagens de alarme pelo último número x de mensagens (Latest) ou baseadas em um período de tempo (Period).

* Utilize os parâmetros no painel Initial Sort para configurar o padrão para procura/organização. Selecione um tipo de coluna do combo-box Column, clique no radio button Asc ou Desc para pesquisa em ordem ascendente ou descendente. Clique no check-box Allow sort in runtime caso você deseje habilitar a pesquisa para que ocorra durante o runtime.

Notas: Pode-se configurar nomes de tags (tags string) entre colchetes { } nos campos Group, Selection, Tagname, Message, e Username para modificar as opções de filtragem durante o runtime.

Pode-se configurar nomes de tags inteiros para esses campos no painel Priority e/ou no último campo do painel Interval para modificar tais valores durante o runtime.

Pode-se configurar nomes de tags de string para os campos Period no painel Interval para modificar tais valores de tag durante o runtime.

Pode-se utilizar wildcards (* e ?) ao especificar valores para os campos Selection, Tagname, Message, e Username.

Clique no botão Advanced para abrir o diálogo Advanced onde você poderá especificar propriedades avançadas para o Objeto de Controle Alarm/Event.

Diálogo Advanced


InduSoft Web Studio

Página 220

Utilize os parâmetros no painel Date and Time Format para controlar quais informações sobre data e hora serão exibidas nas mensagens de alarme. Clique (habilite) o check-box para incluir o elemento na tela. (Nota: MS permanece por milissegundos.)

Hint: Veja o texto Sample para ter uma previsão de quais informações aparecerão na tela.

Utilize os parâmetros no painel Ack para controlar como os alarmes devem ser reconhecidos.

* Campo Security: Digite um valor numérico para especificar quais níveis de segurança reconhecem uma mensagem de alarme. Somente os usuários com o nível de segurança especificado poderão responder.

* Campo Ack all tag: Digite um tag para receber um valor. Quando o valor do tag se altera, isso indica que todas as mensagens no objeto de alarme foram reconhecidas.

* Campo Ack tag: Digite um tag para receber um valor. Quando o valor do tag altera-se, isso indica que as mensagens na parte superior do objeto de alarme foi reconhecida.

* check-box Confirm: Clique (habilite) esse box para exibir um diálogo de confirmação quando o usuário tentar reconhecer um único alarme.

* check-box Enable comment (individual ack only): Clique (habilite) esse box para permitir que o usuário insira comentários sobre o alarme, logo após seu reconhecimento.

Utilize os parâmetros no painel Standard dialogs at runtime para controlar:

* Campo View: Digite um tag para receber um valor. Quando o valor do tag se alterar, isso fará com que abra-se um diálogo permitindo que você personalize as colunas visíveis no objeto.

* Campo Filters: Digite um tag para receber um valor. Quando o valor do tag se alterar, isso fará com que abra-se um diálogo permitindo que você filtre as colunas visíveis no objeto.

Utilize os parâmetros no painel Delete Message para controlar quem poderá deletar mensagens de alarme a partir do Histórico de Alarme:

* Security: Utilize esse campo para especificar qual nível de segurança poderá deletar mensagens de alarme. Somente aqueles usuários com o nível de segurança especificado serão permitidos a deletar uma mensagem de alarme.

* Confirm: Clique (habilite) esse box para requisitar o usuário a confirmar uma seleção de mensagem antes que o IWS realmente delete a mensagem de alarme em questão.

* Campo Total items: Digite um tag integer para ver quantos alarmes permanecem após o IWS filtrar o objeto de alarme com a utilização de parâmetros especificados no diálogo Filters.

* Campo Selected tag: Digite um tag string para habilitar o usuário final a clicar em uma mensagem de alarme, a fim de visualizar o nome do tag associado com o evento de alarme.

* Campo Print trigger: Digite um tag nesse campo para imprimir um resumo do alarme a partir de sua impressora padrão quando o valor desse tag se alterar.

* Botão Navigation Triggers...: Insira tags nos campos para navegação pelo objeto de alarme.

Ao terminar, clique OK para fechar o diálogo Advanced.

Utilize o color box Win para selecionar uma cor de background para o Objeto de Controle Alarm/Event. Clique no color box para abrir o pop-up color e depois clique em uma cor para selecioná-la.


InduSoft Web Studio

Página 221

Clique (habilite) o check-box Ext translation para habilitar a tradução externa de mensagens de alarme, utilizando a Ferramenta Translation. (VejaCapítulo 16: Utilizando o Translation Editor para maiores informações.)

check-box E-Sign: Quando essa opções está habilitada, o usuário é solicitado a inserir a Assinatura Eletrônica antes de executar o dinâmico.

Campo VK: Tipo Virtual Keyboard utilizado para esse objeto. É necessário habilitar a opção Virtual Keyboard na interface Project → Settings → Runtime Desktop antes de configurar o Virtual Keyboard para essa interface.

• Trend Control object ( ): Clique para exibir data points (valores) de diferentes origens de dados em um formato gráfico. Os principais recursos fornecidos pelo objeto Trend Control são:

Exibição de múltiplas penas simultâneamente

Suporte para diferentes Data Sources, como Tag, Batch, Database e Text File

Capacibilidade para gerar gráficos X/Y de origiens de dados configurados (veja Trend Control Object - Apêndice A, ainda nessa seção, para um exemplo de um gráfico X/Y)

Exibição simultânea de um número ilimitado de pontos de dados. Esse recurso pode ser limitado pelo hardware utilizado, já que memória disponível e execução podem variar.

Barra de ferramentas Built-in, fornecendo interfaces para o usuário para interagir com o objeto Trend Control durante o runtime

Legenda Built-in, que exibe a informação principal associada a cada pena com link ao objeto

Ferramentas de Zoom e auto-scaling

Orientação horizontal e vertical

Nota: Para compatibilidade com aplicações criadas em versões mais antigas do IWS (legacy), o objeto Trend ainda é suportado e disponível a partir da barra de ferramentas Legacy. Porém, o objeto Trend Control fornece todas as funcionalidades do objeto Trend anterior em adição a outras vantagens. Por isso, recomenda-se a utilização do objeto Trend Control para novos projetos.

Trend Control – Interface de Desenvolvimento Essa seção descreve a interface de desenvolvimento e todas as configurações disponíveis para a formação do objeto na tela.

Embora o objeto Trend Control suporte configurações flexíveis que vão de encontro a necessidades específicas de sua aplicação, a maioria das configurações são estabelecidas por padrões baseados nas interfaces mais comumente utilizadas. Portanto, em muitos casos, você configurará somente pontos de dados (exibidos durante o runtime) que possam ser facilmente executados clicando-se no botão Points da janela Object Property.

Clique na ferramenta Trend Control para adicioná-la a tela de sua aplicação. Clique duas vezes no objeto para iniciar sua janela de diálogo Object Properties, como se segue:


InduSoft Web Studio

Página 222

Diálogo Object Properties: Trend Control

* box Border: Especifica uma linha de borda Type (style) clicando-se em None, Solid, Dashed, Etched, Raised ou Sunken. Pode-se também selecionar a cor da linha de borda com o box color à direita do campo Type.

* box Fill: Clicando-se em Fill, pode-se escolher uma cor de fundo para o objeto Trend Control, através de sua seleção a partir do box color à direita desse radio button. Caso você selecionar No Fill, o fundo do objeto Trend Control permanecerá transparente.

O restante dos botões desse diálogo iniciam outros diálogos para configurações específicas do objeto Trend Control:

* O botão Data Sources no diálogo Object Properties Trend Control inicia esse diálogo:

Diálogo Data Sources

O data source define a localização dos valores de pontos de dados a ele associados. Muitos pontos podem compartilhar o mesmo data source – não há necessidade de criar um data source para cada ponto de dados.

O tag data source está disponível por padrão para o objeo Trend Control. Pode-se adicionar mais Data Sources utilizando o botão New. O nome inserido será utilizado como um alias para estabelecer link entre de data points para o novo data source.

Os outros campos desse diálogo permitem a edição das configurações para data source:

– Source Type: Selecione a origem dos valores de data point. – Campo X-Axis: Insira o nome do campo (coluna) do data source que suportam os

dados Eixo X. – Max. Buffer: A quantidade máxima de dados (em bytes) que serão prendidos na

memória runtime. – Sort: Esta opção é útil para traçar dados de um arquivo de texto. Quando permitida

(checado), classifica os dados e mostra o valor da coluna do cursor até o Max. Buffer


InduSoft Web Studio

Página 223

estiver enchido. Quando desabilitado (deschecado), os dados não são classificados e o valor da coluna do cursor não é mostrado.

– Data Source Settings: Clique para definir as configurações dos tipos de Source Type selecionados.

A tabela a seguir resume as configurações para cada Tipo Data Source:

Tipo de Data Source

Descrição CampoX-Axis Configurações de Data Source

Batch Batch gerado pela tarefa Trend do IWS

Desabilitado. Os dados X-Axis serão entregues automaticamente na posição correta da propriedade do arquivo Batch gerado pelo IWS.

Insira o Nome Batch dos valores data point para entrega. Pode-se configurar um tag entre colchetes nesse campo para alterar essa configuração de forma dinâmica durante o runtime.

Database Banco de Dados SQL Relacional

Nome do Campo que contém os dados X-Axis

Configure os parâmetros para estabelecer link entre esse Data Source a Banco de Dados SQL Relacional, o qual suporta os valores data point. Veja Janela Database Configuration Dialog no Capítulo 17 para mais informações sobre essa janela de diálogo. Leia Objeto Trend Control - Apêndice B para um exemplo de configuração para banco de dados.

Text File

Arquivo de Texto (e.x. CSV file) com valores data point separados por um delimitador específico

Número de colunas que suportam os dados X-Axis. O número 0 refere-se a primeira coluna, 1 refere-se a segunda coluna, etc.

Insira o Nome do Arquivo de Texto que suporta os data points. O caminho padrão é o caminho da aplicação atual. Pode-se configurar um tag entre colchetes para aletrar


InduSoft Web Studio

Página 224

essa configuração de forma dinâmica durante o runtime.

Pode-se também escolher um ou mais delimitadores para dados armazenados nesse arquivo de texto. O valor de cada linha estä escrito entre dois delimitadores. Ao utilizar uma vírgula como delimitador, o objeto grid estará disponível para leitura de dados de arquivos CSV. Pode-se também escolher um delimitador personalizado, verificando a opção Other. Leia Objeto Trend Control - Apêndice A, para um exemplo de como configurar arquivos de texto.

* O botão Points no diálogo Object Properties de Trend Control iniciam o diálogo abaixo:

Diálogo Points

O valor de cada data Point pode ser representado no objeto Trend Control como uma pena durante o runtime. Pode-se selecionar quais data Points deverão estar visíveis durante o runtime (adicionar/remover penas para o gráfico), apesar do número de data Points associados com o objeto Trend Control.

A tabela a seguir resume as propriedades de cada Data Point:

Propriedade Descrição

Point ID de Data Point. Cada data Point possui um único ID, que é assinalado automaticamente quando o data Point é criado nessa interface.

Label A marca associada ao Data Point pode ser exibida em Legenda durante o runtime, promovendo uma breve referência ao usuário sobre cada data Point.

Color Cor da pena utilizada para desenhar valores de Data Point no objeto Trend Control

Data Source Data Source que suporta os valores para o data Point. O Tag Data Source está disponível por padrão. Veja o botão Data Sources acima para maiores informações sobre como tornar Data Sources adicionais disponíveis para o objeto.

Tag/Field O significado desse parâmertro depende do Tipo de Data Source associado ao data Point:


InduSoft Web Studio

Página 225

Tag: Digite o nome do tag com valores a serem exibidos. Caso o tag esteja configurado na tarefa Trend, os dados históricos são entregues automaticamente; de modo contrário, somente valores online são exibidos.

Batch: Digite o nome do tag com valores a serem entregues do arquivo Histórico Batch gerado pela tarefa Trend e exibido no objeto.

Database: Digite o nome do campo (coluna) no Banco de Dados SQL Relacional que suporta os valores data Point.

Text File: Digite o número de uma coluna que suporte valores data Point. O número 0 refere-se a primeira coluna, 1 refere-se a segunda coluna, etc.

Min Valor mínimo exibido na escala Y para o data Point

Max Valor máximo exibido na escala Y para o data Point

Style Configure o estilo da pena (cor, tipo, estado, etc.).Veja o diálogo Pen Style abaixo para maiores informações.

Options

Configure parâmetros opcionais para cada data Point. Pode-se utilizar o diálogo para configurar tais parâmetros ou digitar seus valores diretamente no campo Options, utilizando vírgulas como delimitadores. Veja o diálogo Options acima para maiores informações sobre tais configurações para maiores informações sobre essa configurações.

Hide Pode-se configurar um tag nesse campo. Quando esse tag possui o valor 0, a pena associada ao ponto é exibia no objeto; do contrário, ela estará oculta.

* Diálogo Pena Style: Esse diálogo permite a configuração da pena utilizada para desenhar os valores data Point no objeto durante o runtime. Além disso, esse diálogo pode ser inicializado durante o runtime, permitindo ao usuário a personalização dessas configurações on-the-fly.

Você terá a opção para definir um Hi Limit e um Lo Limit para cada data Point com o diálogo Options. O diálogo Pena Style permite a configuração de diferentes parâmetros para a pena (e.x. color), tanto para valores com limites (State: Normal) quanto para valores sem limites (State: Out of Limits).

Diálogo Pen Style

Após selecionar um Estado (Normal ou Out of Limits), pode-se configurar o estilo para sua pena:


InduSoft Web Studio

Página 226


Use Normal Settings

Disponível somente para estado Out of Limits. Quando verificado, a pena será sempre exibida com as configurações para state Normal state, mesmo se os valores data point não estejam nos limites configurados.

Type Selecione o tipo de linha utilizado para desenhar a pena.

Weight Selecione o peso (espessura) da linha utilizada para desenhar a pena.

Expansion

Selecione os algorítimos utilizados para estabelecer links entre points, como se segue:

: Os pontos consecutivos são interpolados diretamente de um a outro, com a utilização de uma linha. Essa opção é adaptada para valores análogos.

: Os pontos consecutivos são ligados apenas por linhas horizontais e verticais (passos). Essa opção é adaptada para valores Booleanos.

Marker

Selecione o tipo de marcador (caso exista) que deverá ser exibido em cada amostra específica entregue a partir do Data Source e exibido no objeto.

Color Selecione a cor para o Marcador (caso exista) e a linha utilizada para desenhar a pena no objeto.

Marker Size Selecione o tamanho do Marcador (caso exista).

Nota: Ao rodar a aplicação sob sistema operacional WinCE ou em Web Thin Client (qualquer OS), o diálogo Pena Style – disponível durante o runtime – permite ao usuário alterar somente a cor da pena.

* Diálogo Options: Utilize esse diálogo para configurar parâmetros opcionais para cada data Point, como se segue:


InduSoft Web Studio

Página 227

Diálogo Options


Descrição

Esse texto pode ser exibido em legenda, promovendo uma breve descrição sobre data point durante o runtime. Ao utilizar tags, a descrição padrão é aquela configurada para o tag.

Eng. Unit

O texto pode ser exibido em legenda, promovendo a associação entre Engineering Unit e data point durante o runtime. Ao utilizar tags, as unidades padrão são aquelas configuradas para o tag.

Lo Limit

Quando o valor do data point está abaixo desse limite, sua pena pode ser exibida com um estilo diferente (e.x. cor) durante o runtime. Veja o diálogo Pena Style acima para maiores informações. Ao utilizar tags, o padrão Low Limit é o valor Low Alarm configurado para o tag.

Hi Limit

Quando o valor do data point está acima desse limite, sua pena pode ser exibida em um estilo diferente (e.x. cor) durante o runtime. Veja o diálogo Pena Style acima para maiores informações. Ao utilizar tags, o padrão High Limit é o valor High Alarm configurado para o tag.

Hide Scale

Pode-se controlar um tag nesse campo para controle da visibilidade da escala (Eixo Y) associado a essa pena durante o runtime, alterando-se o valor desse tag (0=Mostrar ; 1=Ocultar).

Break Interval Intervalo máximo entre dois pontos consecutivos. Caso o tempo entre duas


InduSoft Web Studio

Página 228

amostras consecutivas seja maior que esse número (em segundos), o Trend Control assume que não há coleção de dados para esse período, e não desenhará uma linha estabelecendo link entre ambas as amostras. Quando o Eixo X é configurado como númerico, o valor nesse campo representa um valor de escala numérica. Caso o Eixo X esteja configurado como data/hora, o valor nesse campo será exibido em segundos.

X Axes off-set

Off-set para esse data point a partir da escala do eixo X configurada para o objeto. Essa opção é útil quando deseja-se exibir dados de dois ou mais data points com a utilização de uma escala em X distinta (período de tempo/valor) para cada um, de forma que Pode-se compará-los. Quando o Eixo X está configurado como numérico, o valor nesse campo representa um valor de escala númerica. Caso o Eixo X esteja configurado como data/hora, o valor nesse campo será exibido em segundos.

Cursor Value

Pode-se configurar um tag nesse campo. Durante o runtime, o objeto Trend Cursor atualiza o valor desse tag com o valor da intersecção entre a pena do data point pena e o cursor Vertical (caso exista).

* Botão Axes: O Botão Axes no diálogo Object Properties de Trend Control inicializa o seguinte diálogo:

Diálogo Axes

Esse diálogo permite a configuração de parâmetros para os eixos X e Y.


InduSoft Web Studio

Página 229

– Data Type: O Eixo X pode exibir tanto valores Data/Hora quanto valores numéricos, de acordo com a configuração.

Tipo de dados Formato da Escala

Date/Time

Numeric

– Period or Range: As configurações disponíveis nessa interface dependem do Tipo de Dados configurado no Eixo X, como se segue:

Tipo de Dados Propriedade Descrição

Type

Start Date/Time: Quando essa opção está selecionada, o valor do tag configurado no campo Time define Data/Hora iniciais para os dados exibidos no objeto.

Hours Before Now: Quando essa opção está selecionada, o valor do tag configurado no campo Time define a quantidade de tempo antes da Data/Hora atual, a qual será utilizada como início Data/Hora para os dados exibidos no objeto.

Duration

Define o Período de dados exibidos no objeto. Pode-se configurar um tag string nesse campo, de forma que você poderá alterar a duração dinamicamente durante o runtime, alterando o valor desse tag> O formato do valor suportado por essa propriedade é HH:MM:SS. E.x. 36:00:00 (trinta e seis horas)

Date/Time (Period)

Time

Esse campo é opcional. O valor do tag configurado nesse campo representa um período de tempo, data ou hora melhor especificadas. O significado desse valor depenaderá da configuração dessa opção para a propriedade Type.

Quando o Tipo é configurado como Start Date/Time, o valor do tag


InduSoft Web Studio

Página 230

configurado nesse campo deverá ser igual ao formato de Data e Hora. E.x.: 02/10/2005 18:30:00.

Quando o Tipo é configurado como Hours Before Now, o valor do tag configurado nesse campo deverá ser igual aos seguintes formatos:

a. Hora (valor de string). E.x. 48:00:00 (quarenta e oito horas)

b. Número de horas (valor real). E.x. 2.5 (duas horas e trinta minutos)

Min Valor Mínimo exibido no Eixo X Numeric

Max Valor Máximo exibido no Eixo X

Nota: Os tags configurados nos campos Period/Range são automaticamente atualizados quando o usuário altera a escala X dinamicamente durante o runtime, com a utilização da barra Time do objeto.

Caso o campo Time seja deixado em branco (ou o tag configurado nesse campo tenha o valor 0), o objeto exibe dados até a Data/Hora atual.

– Grid (Eixo X ou Eixo Y): Pode-se configurar o número de divisões (linhas verticais ou horizontais) desenhadas no objeto para os eixos X e/ou Y respectivamente, assim como a cor dessas linhas.

– Time bar: Quando habilitada, essa barra é exibida abaixo do Eixo X durante o runtime; do contrário, ela está oculta. A barra time é uma interface padrão que pode ser utilizada pelo operador para alteração da escala do Eixo X durante o runtime.

– Scroll bar: Quando habilitada, a barra Scroll é exibida abaixo do Eixo X durante o runtime; do contrário, ela está oculta. A barra time bar é uma interface padrão que pode ser utilizada pelo operador para navegar através da escala do Eixo X durante o runtime. De forma opcional, pode-se configurar um tag no campo Scroll bar, o qual define o período para a barra scroll. Caso esse campo seja deixado vazio, o período será igual ao valor atual para Duração do Eixo X.

– Cursor: O cursor é uma ferramenta ortogonal opcional para o Eixo X, o qual deve ser utilizado durante o runtime para obter o valor de qualquer pena em um ponto específico (intersecção da pena com o cursor). Ao clicar nesse botão, O diálogo Cursor inicializa, e é o local onde você poderá configurar os parâmetros para o cursor vertical opcional, como se segue:

Diálogo Cursor


Enable Quando habilitado, o cursor vertical está visível durante o runtime.

Color Cor da linha desenhada para o cursor

Position (0-100) Pode-de configurar um tag numérico nesse campo, proporcional a posição do cursor no Eixo X, de 0 a 100%. Quando esse valor é


InduSoft Web Studio

Página 231

alterado, a posição do cursor é modificada automaticamente.

Value Output Pode-se configurar um tag string nesse campo, que retorna o valor do Eixo X no qual o cursor está posicionado atualmente.

– Position: Define a posição do Eixo X, bem como sua direção e orientação, como se segue:

Diálogo Position


Placement Posção onde o Eixo X será colocado

Direction Direção do Eixo X

Orientation Orientação do Eixo X

Scale: Define as propriedades do Eixo Y, como se segue:


Min / Max

Padrão mínimo e máximo dos valores exibidos no Eixo Y. Utilizado quando mais de uma pena compartilha de uma mesma escala (Múltiplas Seções desabilitadas), e/ou para os pontos onde os campos Min e Max não estão configurados (deixados em branco).

Multiple Sections Quando habilitada, a escala Y é dividida automaticamente em uma seção para cada pena; do contrário, todas as penas compartilham de uma mesma escala Y.

Format Inicializa um diálogo para Configuração do formato dos nomes exibidos pelo Eixo Y.


InduSoft Web Studio

Página 232

* Botão Legenda: O Botão Legend no diálogo Object Properties de Trend Control inicia esse diálogo:

Diálogo Legenda

– Show: Quando habilitada, a legenda é exibida durante o runtime. Essa interface fornece informações úteis associadas a penas atualmente com links estabelecido com o objeto.

– Available / Visible: Os campos no box Visible são exibidos em legenda durante o runtime. Pode-se adicionar e remover campos do box Visible, utilizando os botões >> e << respectivamente. Além disso, pode-se utilizar os botões Move Up e Move Down para alterar a ordem na qual os campos são exibidos em legenda durante o runtime.

– Properties: Permite a configuração de propriedades para todos os campos marcados nos boxes Available ou Visible:


Label Nome para o campo exibido durante o runtime

Width Largura para o campo (em pixels) durante o runtime.

Align Alinhamento dos dados exibidos no campo

Available during runtime Quando essa opção está habilitada, o usuário pode exibir ou ocultar o campo durante o runtime.

– Maximum size: Define o tamanho de legenda em, termos de números de linhas. Por exemplo, o usuário poderá ter 8 pontos sendo exibidos no objeto trend, caso o tamanho máximo esteja configurado para dois, legenda terá uma barra de rolagem para permitir ao usuário rolar para os outros pontos.


InduSoft Web Studio

Página 233

– Number of items: Número de pontos (padrão) exibidos em legenda. Pode-se permitir ao usuário adicionar/remover pontos durante o runtime apesar do valor estipulado nesse campo.

– Selected Item: Pode-de configurar um tag numérico nesse campo. O objeto registra nesse tag o número de linhas selecionadas. Além diso, pode-se selecionar diferentes linhas a partir do registro de seus valores nesse tag.

– Fonts: Configura a fonte para o texto exibido em legenda.

* Botão Toolbar: O Botão Toolbar no diálogo Object Properties de Trend Control inicia esse diálogo:

Diálogo Toolbar

– Show: Quando esse box está habilitado, a barra de ferramentas é exibida durante o runtime. Essa interface fornece botões úteis para o disparo de ações relacionadas ao objeto. Pode-se configurar os seguintes parâmetros para cada Command (Botão) disponível na barra de ferramentas:


Show Quando esse box está habilitado, o Botão é exibido na barra de ferramentas do objeto Trend durante o runtime.

Activation Tag

Pode-se configurar um tag nesse campo (opcional). Quando o tag altera seu valor, esse dispara o respectivo comando. Essa opção é útil ao criar interfaces personalizadas para disparo de comandos, ao invés de utilizar (ou redundante) a barra de ferramentas.

* Botão Advanced: O Botão Advanced no diálogo Object Properties de Trend Control inicia esse diálogo:


InduSoft Web Studio

Página 234

Diálogo Advanced

Opções Run Mode: As configurações nessa área definem o comportamento do trend quando em modo de execução:

Propriedade Descrição Update trigger Quando o tag configurado nesse campo altera seu valor, o objeto

Trend é atualizado. Update interval Quando diparador de atualização é disapardo e o Eixo X sendo tipo

numérico, o valor nesse campo será adicionado aos valores mínimo e máximo do Eixo X.

Move to current time on run

Quando o Eixo X é tipo Data/Hora e esse campo está habilitado, o comando Run sempre moverá o Eixo X para a hora atual.

Retrieve bounding samples

Quando estiver habilitada, o objeto recupera os dados limitados do objeto (somente os primeiros pontos). Deasbilitar esta opção pode melhorar o desempenho, desde que os pontos limitados do objeto não sejam recuperados do histórico. Por outro lado, o objeto não desenhará as linhas que ligam o primeiro e últimas amostras às extremidades do objeto.

Run-Time Config: As configurações do Objeto Trend modificadas durante o runtime podem ser salvas em arquivos temporários. Essa opção pode ser utilizada para:

Manter os ajustes consistentes, de forma que o usuário poderá fechar a tela e abri-la novamente, ou reiniciar a aplicação, os parâmetros configurados durante o runtime não serão perdidos.

Cria configurações padrão para diferentes cenários, além de carregar a configuração apropriada durante o run-time, baseando-se em uma condição pré-definida, ou na seleção do usuário.


InduSoft Web Studio

Página 235

As propriedades dessa moldura são descritas na tebela abaixo:


Save trigger

Quando o tag configurado nesse campo altera seu valor (e.x. inverte), as configurações atuais do objeto Trend são salvas no arquivo temporário. Esse comando não está disponível para Web Thin Client.

Load trigger Quando o tag configurado nesse campo altera seu valor (e.x.inverte), as configurações do arquivo temporário são carregadas e aplicadas ao objeto Trend durante o runtime.

File Name

Caso esse campo seja deixado em branco, o arquivo temporário é salvo no sub-diretório \Web da aplicação com a sintaxe <ScreenName><ObjectID>TrendControl.stmp (e.x. MyScreen10TrendControl.stmp). A Web Thin Client station salva/carrega o arquivo temporário no diretório Temp padrão do sistema operacional (e.x. \Documents and Settings\<CurrentUser>\Local Settings\Temp).

Pode-se configurar um nome de arquivo personalizado para o arquivo temporário nesse campo ou até configurar um tag string entre colchetes, de forma que o usuário poserá aletar o nome do arquivo de configuração dinamicamente durante o runtime através da alteração do valor desse tag. Caso você não especifique um caminho, o arquivo é salvo no sub-diretório \Web da aplicação por padrão.

Auto Save

Quando esse box está habilitado, as configurações atuais de Trend são salvas automaticamente no arquivo temporário quando a tela onde o Trend está configurado é fechada durante o runtime. Caso o box não esteja habilitado, as configurações são salvas somente quando o comando Save trigger é executado.

Atenção: Após a tela onde o Objeto Trend está configurado ter sido salva, as configurações não são carregadas automaticamente a partir do arquivo temporário quando a tela é aberta novamente, a menos que o comando Load trigger seja executado antes da tela ser fechada.

Custom point Selecioneion: O usuário não pode utilizar esse opção caso queira personalizar a tela para selecionar pontos durante o runtime. As seguintes opções estão disponíveis:


Screen Nome da tela que será aberta para selecionar uma tela específica. Point number Número do ponto. Esse número identifica a linha onde o ponto foi adicionado na

tela de configuração do ponto Add Indicator Configure para 1 caso o usuário esteja adicionando um novo ponto. De modo a

adicionar um novo ponto, o usuário poderá aumentar o número de pontos (veja configuração da legenda) e configurar o Add Indicator de volta para 0.

VK: Tipo de Virtual Keyboard utilizado para esse objeto. Você precisará habilitar a opção Virtual Keyboard da interface Project -> Settings -> Runtime Desktop antes de configurar o Virtual Keyboard para essa interface.


InduSoft Web Studio

Página 236

Ext Translation: Quando essa opção está habilitada, o texto exibido pelo objeto Trend Control será submetido a Ferramenta Translation durante o runtime.

Trend Control –Interface de Runtime Quando habilitada, algumas interfaces podem auxiliar o usuário na interação com Trend Control durante o runtime. Essa seção descreve essas interfaces:

* Toolbar: Os comandos diposníveis na Barra de Ferramentas são descritos na tabela que segue:

Comando Ícone Descrição Tag de Ativação

Run

Configura o Trend para Modo Play. Nesse modo, o Eixo X é continualmente atualizado (Modo Online). Essa opção é desabilitada (em cinza) quando o trend já está em Modo Play.

0 = Play Mode on

1 = Play Modo desligado

Stop

Configura o Trend para o Modo Stop. Nesse modo, o Eixo X não é atualizado continuamente (Modo Histórico), de modo que o usuário poderá visualizar dados históricos em um período congelado de tempo. Essa opção é desabilitada (em cinza) quando o trend já está em Modo Stop.

0 = Modo Stop ligado

1 = Modo Stop desligado

Period Inicia um diálogo, onde o usuário pode modificar as configurações principais na escala do Eixo X

Window Zoom

Permite ao usuário clicar na área Trende arrastar o cursor para selecionar a área que deverá estar visível quando o cursor for liberado. Essa opção é desabilitada (grayed out) quando a opção Multiple Section (para a escala Y) está ativada.

Horizontal Zoom

Permite ao usuário clicar em dois pontos na área Trend, definindo a escala Horizontal que deverá estar disponível

Vertical Zoom

Permite ao usuário clicar em dois pontos na área Trend, definindo a escala Vertical que deverá estar diposnível. Essa opção é desabilitada (grayed out) quando a opção Multiple Section (para a escala Y) está ativa.

Quando o tag de ativação altera seu valor (e.x. toggles), esse comando é executado.

Zoom In

Permite ao usuário efetuar zoom para aproximação (exibição de metade das escalas X e Y atuais) a cada vez que clicarem na área Trend.

0 = Zoom In ligado

1 = Zoom In desligado

Zoom Out Permite ao usuário efetuar zoom para afastamento cada vez que clicarem na área Trend.

0 = Zoom Out ligado

1 = Zoom Out desligado


InduSoft Web Studio

Página 237

Cancel Zoom Cancela o Zoom selecionado

Legenda Properties

Inicializa um diálogo, onde o usuário poderá modificar as configiurações principais da legenda

Pena Style Inicializa um diálogo, onde o usuário poderá modificar o estilo da pena selecionada.

Add Pena Inicializa um diálogo, onde o usuário poderá adicionar uma nova pena para o Objeto Trend

Remove Pena Remove a pena selecionada do Objeto Trend

– Quando o tag de ativação altera seu valor (e.x. toggles), esse comando é executado.

Multiple Sections

Alterna a escala Y para Multiple Sections (uma seção para cada pena) ou Single Section (todas as penas compartilham a mesma seção da escala Y).

0 = Multiple Sections ligado

1 = Multiple Sections desligado

Cursor Alterna o cursor (régua) para visível ou oculto

0 = Cursor ligado

1 = Cursor desligado

Auto Scale

Altera a escala do Eixo Y para adaptar-se a todos os valores das penas que estão sendo monitoradas atualmente.

Quando o tag de ativação altera seu valor (e.x. toggles), esse comando é executado.

* Legend: Os comandos disponíveis na Legenda são descritos na tabela abaixo:

Comando Ícone Descrição

Selecioneion Inicializa um diálogo, onde o usuário pode substituir data points associados a pena selecionada na legenda

Remove Remove a pena selecionada do Objeto Trend

Hide Quando habilitada, a pena selecionada estará visível; do contrário, estará oculta.

Pena Style Inicializa um diálogo, onde o usuário poderá modificar o estilo da pena selecionada.

Scale Quando esse box está habilitado, a escala do Eixo Y estará visível; do contrário, estará oculta. A escala poderá ser oculta somente quando a opção Multiple Sections estiver desligada.

* Scroll bar: Utilizando a barra Scroll, o usuário poderá mover-se através dos valores do Eixo X, de acordo com o período configurado.

* Time bar: Utilizando a barra Time, o usuário poderá modificar a Duração, assim como a Data de início/Hora e/ou a Data/Hora de finalização para os dados exibidos no objeto. Alterar esses valores afetará os tags associados a escala do Eixo X (caso exista).

Objeto Trend Control – Apêndice A – Utilizando o Arquivo de Texto Data Source

O Trend Control pode gerar gráficos a partir de qualquer Arquivo Texto que tenha seus valores organizados em colunas e linhas. As colunas deverão ser separadas umas das outras por caracteres


InduSoft Web Studio

Página 238

especiais (geralmente vírgulas). Cada amostra (um par de valores representando um ponto no gráfico) é representada por uma linha (uma linha no arquivo). Suponha que o usuário queira exibir um gráfico com as informações da tabela a seguir:

Valor X Valor Y1 Valor Y2 0 0 10 1 1 20 2 2 30 3 3 40

Temos uma variável que representa o Eixo X e duas variáveis (Y1 e Y2) que representam linhas diferentes do gráfico. O primeiro passo será converter os dados para um arquivo texto. Caso adotemos a vírgula como separador, o arquivo será exibido dessa maneira

Recomendamos que o arquivo seja salvo na mesma pasta onde a aplicação esteja. Fazendo isso, não teremos que Especificar o caminho complete e a sua aplicação ainda funcionará, mesmo que seja copiada para um outro computador.

Uma vez adicionado o Trend Control para sua tela, clique duas vezes no objeto para abri-lo, e depois em Object Properties e clique em Axis. Altere os Tipos de Dados (Data Type) do Eixo X para numérico, e configure as escalas como mostrado na figura abaixo:


InduSoft Web Studio

Página 239

Clique em Ok nessa Janela e depois, na janela Object Properties, clique no botão Data Sources. Aparecerá a janela que se segue:

Precisamos criar um data source de modo a obter acesso ao arquivo de texto. Clique no novo botão, Especifique o Nome do Data Source “MyTextFile” e clique em Create. Agora, você deverá vizualizar as seguintes informações:

No campo X Axis, precisaremos indicar qual coluna em nosso texto representará o Eixo X. Nesse exemplo, estamos utilizando coluna zero, de modo a inserir zero para esse campo. Depois de clicar no botão Data Source Settings, a seguinte janela aprecerá:


InduSoft Web Studio

Página 240

Caso você tenha copiado o arquivo de texto para a pasta da aplicação, você terá somente que especificar o nome do arquivo; do contrário, insira o caminho completo onde o arquivo está localizado (utilize o botão browse caso necessário). Clique em Ok nessa janela e em Ok novamente para finalizar a configuração de data source e fechar a janela Data Source Configuration.

Agora, precisamos definir nosos Y1 e Y2. Eles serão representados por pontos em nossa Trend Control. Clique duas vezes em Trend Control para obter acesso a janela Object Properties, e depois clique em Points. O próximo passo será definir os pontos de acordo com a figura a seguir:

Após concluir esses passos, rode sua aplicação, e você deverá visualizar uma figura semelhante a que se segue:


InduSoft Web Studio

Página 241

Objeto Trend Control – Apêndice B – Utilizando Data Source Database

O Trend Control pode gerar gráficos de tendência para quaisquer Banco de Dados Relacionais que possam ser acessados através da tecnologia ADO.Net. Esse Apêndice ilustra como acessar um Banco de Dados Microsoft Access; caso você esteja utilizando algum outro tipo de banco de dados, quase todas as definições poderão ser aplicadas; porém, você precisará configurar sua conexão de um outro modo. Para informações sobre como configurar outros bancos de dados, leia os Apêndices na seção Interfaces do Banco de Dados desse manual.

Suponha que você possua um acesso a banco de dados em seu drive C, com o nome “mydata.mdb”, e que você queira gerar um gráfico baseado nas informações contidas na tabela a seguir:

O primeiro passo será adicionar o Trend Control a sua tela. Agora, clique duas vezes no objeto para abri-lo, e depois em Object Properties. Clique em Data Sources. A seguinte janela será exibida:

Precisamos criar uma data source de modo a obter acesso ao banco de dados. Clique no novo botão, Especifique o Nome para Data Source “MyDB” e clique em Create. Agora, você deverá visualizar essas informações:


InduSoft Web Studio

Página 242

Altere o Source Type para Database e especifique Time_Stamp no campo X Axis. Clique no botão Data Source Settings, e a janela a seguir aparecerá:

Desabilite o check box Use application default e clique no botão browse de modo a configurar uma string de conexão. A seguinte janela aparecerá:


InduSoft Web Studio

Página 243

Selecione o Provedor Microsoft Jet 4.0 OLE DB e clique em Next. Na janela a seguir, você deverá especificar o caminho para o banco de dados:


InduSoft Web Studio

Página 244

Clique em Ok para finalizar a configuração da string de conexão. Agora, desabilite a opção Use default name e selecione a tabela de seu banco de dados, como mostrado abaixo:

Clique em Ok nessa janela e em Ok novamente para finalizar a configuração de data source. Feche a janela Data Source Configuration.

Agora, precisaremos definir Temperature e Pressure, as quais serão representadas por pontos em nosso Trend Control. Clique duas vezes em Trend Control novamente para acessar a janela Object Properties. Clique em Points. Seu próximo passo deverá ser definir os pontos de acordo com a figura que se segue:

Caso você rode o trend, esse se inicializará com data/hora atuais. De modo a visualizar os dados no gráfico, você terá que configurar, de maneira apropriada, data/hora iniciais, como mostrado abaixo:


InduSoft Web Studio

Página 245

• Botão Trend ( ): Clique para selecionar uma área na tela na qual exibir curvas de tendência dos dados do tag. Pode-se exibir até oito curvas simultaneamente no objeto, e utilizar os campos de configuração em propriedades do objeto para a especificação de:

Período de tempo a ser exibido

Valores a serem exibidos

Formato do gráfico

Para criar um objeto Trend:

Clique no Botão Trend.

Clique na tela e arraste o mouse para criar e ajustar as formas do objeto.

Clique duas vezes no objeto Trend para abrir o diálogo Object Properties:

Object Properties: Trend

Utilize o diálogo Objeto Trend Properties para especificar os seguintes parâmetros:

Trigger: Digite (ou clique no Botão para selecionar) uma variável para definir como as curvas de tendência serão redesenhadas. Quando o valor desse tag alterar-se, o IWS redesenhará as curvas de tendência exibidas. Você deverá completar esse campo caso você especifique (habilite) trends On Line, embora não seja exigido para trends Históricos.

Campo Update: Digite uma variável para que o IWS possa utilizar na criação do trend. Utilize esse campo somente em conjunção a trends Crisp.

combo-box Curve Type: Selecione um tipo de curva a partir das seguintes opções:


InduSoft Web Studio

Página 246

* X/t: Selecione para plotar valores de curvas de acordo com a vez

* X-Y: Selecione para plotar valores de curvas de acordo com Tag X, um outro tag da aplicação

* Crisp: Selecione para plotar valores de curvas em um formato apropriado para estabelecimento de interfaces com estações VAX

combo-box Orientation: Selecione uma das seguintes opções para especificar como as penas de trend serão orientadas em relação à tela:

* Left-Right: Selecione para plotar da esquerda para a direita, com os últimos valores à direita

* Right-Left: Selecione para plotar da direita para a esquerda, com os últimos valores à esquerda

radio button History: Clique (habilite) para exibir as curvas históricas de trend da aplicação.

Atenção: Para utilizar gráficos tipo históricos para esse objeto Trend, você deverá:

Criar um grupo trend (a partir da pasta Trend no tab Tasks)

Criar tags para esse grupo e configurar os parâmetros Save on Tag Change ou Save on Trigger na planilha Trend Group. Tais tags terão suas amostras armazenadas no disco rígido.

radio button On Line: Clique (habilite) para exibir curvas de trend online para a aplicação.

Nota: Caso você habilite esse botão, você deverá inserir um valor no box de texto Trigger para indicar quando o IWS irá redesenhar as curvas de trend.

combo-box Border Color: Clique para selecionar uma cor para a área de borda do gráfico de trend. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la, e depois feche o diálogo.

combo-box Background Color: Clique para selecionar uma cor de fundo para a área do gráfico de trend. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la, e depois feche o diálogo.

Botão Horizontal Scale: Clique para abrir o diálogo Horizontal Scale, o qual permite a definição de propriedades de escala horizontais para as curvas de trend.

Nota: O conteúdo desse diálogo altera-se dependendo dos parâmetros especificados no diálogo Object Properties Trend.


InduSoft Web Studio

Página 247

Exemplo de Diálogo Horizontal Scale

A seção a seguir explica como configurar todos os parâmetros de Horizontal Scale.

* check-box Scale Visible: Clique (Habilite) para exibir a escala horizontal ou desabilite o box para ocultar a escala horizontal.

* Campo Number of Labels: Digite um valor para especificar quantos nomes você poderá utilizar na escala horizontal.

* área Grid: Utilize os seguintes parâmetros para configurar um grid para o gráfico trend.

Campo Divisions: Especifique quantas linhas de divisão a serem utilizadas no grid. Caso você deixe esse campo em branco, não aparecrão linha na grade.

combo-box Color: Clique para selecionar uma cor para a grade. Quando o diálogo Color aparecer, clique em uma color para selecioná-la e depois feche o diálogo.

* área Scale String Format: Utilize os seguintes parâmetros para especificar um formato para a string de texto na escala horizontal.

Botão Fonts: Clique nesse Botão para abrir o diálog Fonts, o qual permite a seleção de um estilo, cor e tipo de fonte para os nomes dos eixos horizontais.

check-boxes DD/MM/YY (somente Curva X/Y e Gráfico X/t): Clique (check) nesses boxes para adicionar uma data (dias/meses/ano) a string de texto na escala.

check-boxes HH:MM:SS (somente Curva X/Y e Gráfico X/t): Clique (check) nesse boxes para adicionar a hora (horas:minutos:segundos) a string de texto na escala.

* área Vertical Cursor: Utilize os seguintes parâmetros para especificar um formato para o cursor vertical.

check-box Enable: Clique (habilite) para exibir um cursor vertical.

combo-box Color: Clique para selecionar uma cor para o cursor vertical. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

Campo Position (0-100) (torna-se ativo ao habilitar o cursor vertical): Deve-se inserir um valor real de tag, o qual será atualizado pelo IWS utilizando a posição do cursor (0 corresponde ao limite esquerdo e 100 ao limite direito da trend).

Campo Date/Time output (torna-se ativo ao habilitar o cursor horizontal): Inisra um tag name para receber uma string, que será constantemente atualizada com a hora atual do cursor vertical do trend.

* Campo Horizontal axis Duration (Somente curva do tipo X/t) ou Duration (horas) (somente históricos e Gráficos X/t): Digite um tag name ou valor numérico para a largura do trend. Por exemplo: caso você especifique Horizontal axis Duration = 0.03333 (2 minutos) o trend exibirá 2 minutos dos dados, do inicío ao fim.


InduSoft Web Studio

Página 248

* Campo Hours before now: Especifica um tag para executar rolagem na área Trend. O valor desse tag Especifica uma hora de início do trend em relação a hora atual.

Por exemplo: caso você especifique as configurações a seguir, o IWS permitirá a exibição do gráfico trend em até cinco horas antes da hora atual.

Time = 17:00:00

Hours before now = 5

Duration = 1

O trend exibirá 11:00.00 � 12:00.00

Atenção: O diálogo Graphic trend suporta um máximo de 16.000 amostras.

Nota: Ao utilizar o parâmetro Hours Before Now, você estará manipulando dados históricos. Conseqüentemente, deve-se configurar as penas do trend em um grupo de trend (Utilizando a pasta Trend no tab Tasks).

área Type of History Files (somente Gráficos e Históricos X/t): Utilize os seguintes parâmetros para especificar em qual formato os arquivos históricos foram criados.

* Date (padrão): Clique para manipular arquivos criados em formato de data pelo grupo de trend (formato InduSoft).

* Batch: Clique para manipular arquivos criados em formato batch por grupo de trend (formato de arquivo batch).

* Start Date (somente Gráficos e Históricos X/t): Especifica uma data (tipicamente um tag tipa string) em formato DD/MM/YYYY para especificar o ínico das curvas históricas.

* Campo Start Time (somente Gráficos e Históricos X/t): Especifia uma hora (tipicamente um tag tipa string) em formato HH:MM:SS para especificar o início das curvas históricas.

* Campo Tag X (somente Gráfico X/Y): Especifica um tag para X-axis. Deve-se especificar um array e declarar o índice no qual os eixos iniciam-se (Por exemplo, MyTagX[1]).

* Campo Points (somente Gráfico X/Y): Especifica o número de pontos (amostras) no diálogo graph.

* Campo Max (somente Gráfico X/Y): Especifica um valor máximo para a variável X.

* Campo Min (somente Gráfico X/Y): Especifica um valor mínimo para a variável X.

Dica: Pode-se utilizar o módulo Recipe (no tab Tasks) para salvar e carregar informações históricas para o trend X-Y. Veja Capítulo 8: Configurando Planilhas de Tarefas.

• Botão Vertical Scale: Clique para abrir o diálogo Vertical Scale, o qual permite a definição de propriedade de escala vertical para as curvas de trend.


InduSoft Web Studio

Página 249

Exemplo de Diálogo Vertical Scale

check-box Scale Visible: Clique (habilite) para exibir a escala vertical ou desabilite o box para ocultar a escala vertical.

Campo Number of Labels: Digite um valor para especificar quantos nomes poderão ser utilizados na escala vertical.

área Grid: Utilize os seguintes parâmetros para configurar uma grade vertical para o gráfico de trend .

* Campo Divisions: Especifique quantas linhas divisórias serão utilizadas para a grade vertical. Caso você deixe esse campo em branco, não serão exibidas linhas nessa grade.

* Lista drop-down Color: Clique para selecionar uma cor para a grade vertical. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

área Scale String Format: Utilize os seguintes parâmetros para especificar um formato para a string texto em escala vertical.

* Botão Fonts: Clique nesse botão para abrir o diálogo Fonts, o qual permite selecionar um estilo, cor e fonte para os nomes dos eixos verticais.

* Campo Width: Especifica quantos dígitos são permitidos para números na string da escala vertical.

* Campo Decimals: Especifica quantos espaços decimais são permitidos na string da escala vertical.

Por exemplo: Caso você insira Width = 3 e Decimals = 2, a string da escala horizontal poderá utilizar números de três dígitos com dois espaços decimais.

área Scale Range: Utilize os seguintes parâmetros para calcular quantas posições de curva são definidas no diálogo Pens. Pode-se utilizar um valor númerico ou um tag para alterar dinamicamente a escala vertical.

* Campo Minimum: Digite um valor mínimo para a escala do gráfico trend.

* Campo Maximum: Digite um valor máximo para a escala do gráfico trend.

• Botão Pens: Clique para abrir o diálogo Pens:


InduSoft Web Studio

Página 250

Diálogo Pens

Utilize os seguintes parâmetros para configurar as penas utilizadas para desenhar cada curva de um tag.

Campos Tag: Digite tag names a serem monitorados no trend (Por exemplo, MyTagY[1]). Pode-se criar um diálogo Trend genérico, Especificando um tag indireto para definir o tag a ser monitorado.

Botões Line: Clique para selecionar uma cor para as linhas em cada curva de trend. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo. Pode-se utilizar até oito linhas de colorações diferentes em um gráfico trend.

Campos Min e Max: Especifica um valor mínimo e máximo de escala (numérico ou tag) com o qual desenhar a curva.

Nota: Os valores mínimos e máximos de cada tag não necessitam ter os mesmos valores mínimos/máximos como a escala de gráfico trend.

Campos Cursor Value: Digite tags para receber o valor da linha Trend onde esse intersecciona-se com o cursor vertical.

Atenção: O trend On-Line aloca memória para cada ponto dentro do período de visualização. O CEView descartará os valores mais antigos (mesmo que estejam dentro do período de visualização) quando a memária disponível é menor do que o limite crítico (1MB por padrão). Além disso, uma mensagem de precaução é iniciada localmente.


InduSoft Web Studio

Página 251

• Botão SPC: Clique para abrir o diálogo SPC Parameters, o qual você poderá utilizar para retornar valores Mean, Min, Max, e Standard Deviation (-2s, +2s) a partir do período selecionado para cada pena. (Também Pode-se desenhar o resultados no Objeto Trend.)

Diálogo SPC Parameters

Utilize os parâmetros desse diálogo como se segue:

combo-box Pen: Clique no botão de seta para selecionar uma pena da lista.

Disable: Digite um tag no campo de texto. Caso o valor do tag seja diferente de 0 (falso), o IWS desabilitará o recurso SPC.

Campos Tag: Digite um tag name nos campos de texto para retornar valores de Mean, Min, Max, Median, Sum, e/ou Standard Deviation.

check-box Draw: Clique (habilite) nesses boxes para desenhar os resultados dos valores Mean, Min, Max, Median, Sum, e/ou Standard Deviation -2s/+2s no gráfico trend.

Botão Line: Após habilitar o check-box Draw, clique nesse botão para exibir parâmetros para diferentes linhas de penas.

Quando o diálogo Line Selection aparecer, especifique o seguinte:

* painel Line: Clique em um radio button para especificar Solid ou Dashed Line e digite um valor no text box Weight para configurar a espessura da linha.

* combo-box Color: Clique no botão de seta para exibir uma paleta de cores. Clique em um botão Color para selecionar uma cor de linha para a pena e depois clique em OK para fechar o box de paleta de cores.

• Botão List Box Object ( ): Clique para criar um objeto list box em sua tela. Geralmente, ao executar uma aplicação, o objeto list box ativo exibe uma lista de mensagens.

Em uma tela contendo somente um objeto list box e nenhum box de texto, o objeto list box será ativado automaticamente.

Em uma tela contendo múltiplos objetos list box e boxes de entrada de texto, pode-se utilizar um cursor (equipamento de apontamento) ou a tecla Tab para selecionar e ativar um objeto list box.

Pode-se selecionar uma mensagem a partir do objeto list box ativo durante o runtime e registrar o valor da mensagem para um tag. (Caso uma lista esteja longa demais para adaptar-se em uma área visível de um objeto list box, o objeto fornecerá barras de rolagem.)

Use o box Enter Reqd no diálogo Object Properties para configurar mensagens selecionadas como se segue:


InduSoft Web Studio

Página 252

Habilite o box Enter Reqd e utilize as teclas do teclado/keypad, objetos list control de Library, equipamento de apontamento ou teclas pré-definidas contendo a função PostKeys() para rolar através da lista de mensagem. Depois, utilize a tecla Enter para selecionar a mensagem e registrar seu valor para o tag escrito. Pode-se utilizar as teclas Esc e Tab para retornar a mensagem previamente selecionada a qualquer momento, pressionando a tecla Enter.

Desabilite o campo Enter Reqd para registrar o valor de uma mensagem selecionada (highlighted) automaticamente.

Para adicionar objetos list box a uma tela:

Clique no botão List Box na barra de ferramentas Active Objects.

Clique na tela e arraste para criar/ajustar um retângulo ampliável.

* Height e tamanho da fonte determinam quantas mensagens estão visíveis.

* Width determina quanto do comprimentonto das mensagens está visível.

Após criar um retângulo, pode-se ajustar as características de tamanho e fonte para permitir que mais mensagens sejam exibidas no espaço dado.


Object Properties: List Box

Dica: Também pode-se abrir o diálogo Object Properties clicando-se com o botão direito no objeto list box ou selecionando o objeto, pressionando as teclas Alt+Enter e selecionando Properties a partir do menu pop-up resultante.


Lista drop-down Value (localizada abaixo do botão Replace): Clique para selecionar um dos seguintes valores de tag utilizados para o índice da lista de mensagem.

* Boolean

* Integer (padrão)

* LSB (bit menos significante)

Nota: Para maiores informações, veja a discussão sobre o campo State no diálogo Messages Configuration.


InduSoft Web Studio

Página 253

Botão Messages: Clique para abrir o diálogo Messages Configuration.

Diálogo Message Configuration

Utilize os parâmetros nesse diálogo como se segue:

* Campo State (somente leitura): Utilize esse campo para visualizar as mensagens individuais indexadas. O IWS numera esse campo baseando ser no tipo Read/Search Tag selecionado:

Boolean: Fornece dois estados válidos, nomeados de 0 e 1

Integer: Fornece 255 estados válidos, nomeados de 1 a 255

LSB: Fornece 32 estados válidos (32 bits em um valor real) nomeados de 0 a 31

* Campo Message: Digite a mensagem do valor da string exibida no objeto list box. Pode-se utilizar tags em mensagens utilizando a sintaxe {tag name}.

* Campo Value: Digite um valor de mensagem que esteja de acordo com o valor Read/Search Tag especificado (também, o mesmo valor escrito ao tag registrado).

Caso você Especifique LSB para o campo Value, o IWS utiliza o valor especificado no campo State para Read/Search Tag e para registrar o tag.

* Campo de cor Text Foreground: Clique para especificar uma cor de primeiro plano para o texto da mensagem. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

* check-box Text Blink: Clique (habilite) para fazer com que uma mensagem selecionada pisque, uma vez por segundo, quando for exibida.

Botão Fonts: Clique para abrir o diálogo Font, o qual permite a alteração das características (estilo, tamanho, etc) da fonte da mensagem.

text box User Enable: Digite um tag, expressão ou um número (diferente de zero) para selecionar um mensagem na aplicação em runtime. O padrão é 1 (verdadeiro, habilitado).

text box Control Enable: Digite um tag, expressão ou um número (diferente de zero) para selecionar uma mensagem na aplicação em runtime — dependendo do valor atual de Read/Search Tag. O padrão é 1 (verdadeiro, habilitado).

O IWS baseia esse parâmetro no campo Value (diálogo Messages Configuration) que você associa a mensagem selecionada. Habilitar esse campo permite que tag alteradas disparadas pelo processo afetem as mensagens que você poderá selecionar.

text box Read/Search Tag: Digite um tag integer ou Boolean para apontar a uma mensagem selecionada no campo Value da mensagem (diálogo Messages Configuration). Pode-se utilizar os campos Control Enable e User Enable para controlar se o operador ou um processo podem alterar esse tag.


InduSoft Web Studio

Página 254

text box Write Tag (opcional): Digite um tag string para receber o valor Message da última mensagem selecionada. Ao fechar e reabrir a tela que contém um objeto list box, o IWS utiliza esse valor de tag para determinar qual foi a última mensagem selecionada no list box.

check-box E-Sign: Clique (habilite) para requisitar ao usuário a inserção da Assinatura Eletrônica antes de executar o dinâmico.

check-box Row: Clique (habilite) para incluir setas de configuração e desconfiguração (set up e set down) na barra de rolagem do objeto list box.

check-box Page: Clique (habilite) para incluir setas para página acima e página abaixo (page up e page down) na barra de rolagem do objeto list box.

check-box Start/End: Clique (habilite) para incluir setas de início e fim (home e end) na barra de rolagem do objeto list box.

check-box List wrap: Clique (habilite) para continuar a exibição e rolagem da lista de mensagem (iniciar-se no lado oposto) após rolar para o início ou final da lista.

check-box Enter Reqd: Clicando (habilitando) nesse box permite a seleção de mensagens utilizanso somente a tecla Enter, o que evita a utilização da tecla Tab para seleção das mensagens.

boxes Color: Clique no color box para abrir o diálogo Color ou o diálogo 16-color Color Selection. Tais diálogos permitem a especificação ou alteração de cores para o objeto list box. Clique em uma cor para selecioná-la e depois clique em OK para fechar o diálogo.

box Highlight Color: Especifica uma cor para seleção de mensagens (o padrão é azul).

box Text Color: Especifica uma cor para seleção de mensagens de texto (o padrão é preto).

box Win Color: Especifica uma cor de fundo para o objeto list box (o padrão é branco).

box Border Color: Especifica uma cor para as bordas do objeto list box (o padrão é preto).

• Botão Smart Message Objects ( ): Clique para criar um ou mais objetos de mensagens, o qual poderão ser utilizados para exibir mensagens e gráficos baseados em valores de tags ao executar a aplicação. O IWS fornece os seguintes tipos de objetos Message Smart:

Message Display: Habilita a exibição de qualquer uma das mensagens smart com um único objeto de tela.

Multistate Indicator: Habilita a exibição de qualquer uma das mensagens smart mulDicale com um único obejto de tela, além de possuir a habilidade de exibir imagens de bitmap junto as mensagens.

Multistate PushBotão: Habilita a exibição de mensagens e imagens bitmap. Esse objeto também assemelha-se a um alternador de múltiplas posições, o que permite o alternamento (inverter entre) de mensagens, clicando-se no objeto durante o runtime.

Esses tipos de objetos smart messages variam quanto a suas capacidades em exibir mensagens e gráficos, registrar um tag, e controlar quantas mensagens e gráficos serão exibidos na tela. Porém, todos os tipos de objeto podem receber entradas de processo (Valor Read Tag) para determinar qual mensagem deverá ser exibida.

Para adicionar um objeto smart message à tela:

Clique no botão Smart Message e posicione o mouse na tela.

Clique e arraste para criar (e ajuste as dimensões) um retângulo.

Utilize o tamanho do retângulo e fonte para determinar o tamanho do texto e da imagem bitmap que serão exibidos na tela. Mais tarde, você poderá alterar o tamanho da fonte e as características da fonte para permitir que mensagens maiores sejam exibidas em um espaço estipulado.

Clique duas vezes no objeto para abrir o diálogo Object Properties.


InduSoft Web Studio

Página 255

Object Properties: Smart Message


combo-box Type: Clique para selecionar o tipo de objeto smart message. O tipo do objeto diz respeito ao comportamento do objeto durante o runtime, além dos recursos por ele suportados:

* Message Display (padrão)

* Multistate Indicator

* Multistate PushBotão

Lista drop-down Value: Clique que para selecionar os valores do tag utilizados para indexar a lista de mensagens. Selecione o tipo valores utilizados para indexar a lista de mensagens:

* Boolean – Fornece dois estados válidos. Utilize essa seleção quando você desejar exibir uma de duas diferentes mensagens, baseando-se em um valor booleano (0 ou 1).

* Integer (padrão) – Fornece 500 estados válidos. Utilize essa seleção quando você desejar exibir diferentes mensagens baseando-se em valores específicos de um tag Integer.

* LSB (bit menos significante) – Fornece 32 estados válidos (32 bits em um valor inteiro). Utilize essa seleção quando você desejar exibir diferentes mensagens baseando-se em qual bit de tag integer está selecionado. Caso mais de um bit do tag Integer esteja configurado simultaneamente, a mensagem associada ao bit menos significativo configurado (valor 1) será exibida.

Nota: Caso o PushBoutton Multistate seja o tipo Smart Message, somente 16 mensagens diferentes poderão ser associadas ao objeto, mesmo para Integer ou tipos de valores LSB.

text box Read Tag/Expr: Insira o nome de um tag Integer ou Boolean. O valor do tag determinará qual mensagem será exibida pelo objeto durante o runtime.

text box Write Tag (opcional e disponível somente para PushButton Multistate): Insira o nome de um tag integer ou Boolean. O valor associado à mensagem atualmente exibida está registrado a esse tag.

Align: Selecione o alinhamento do texto exibido pelo objeto Smart Message o.

Key (opcional e disponível somente para PushButton Multistate): Atalho utilizado para ir para a próxima mensagem (passo) utilizando um teclado quando o tipo PushButton Multistate está selecionado. Tal opção é especialmente útil ao criar aplicações para equipamentos de runtime que não fornecem um mouse ou interface touch-screen, ou seja, quando a única interface física disponível para a interação com a aplicação durante o runtime é o teclado.


InduSoft Web Studio

Página 256

Lista drop-down Event (disponível somente para PushButton Multistate): Selecione uma das seguintes opções para especificar quando a mensagem deverá ser alterada:

* On Down: Alterna para a próxima mensagem ao clicar no objeto (padrão).

* While Down: Alterna para a próxima mensagem de forma contínua enquanto o botão de baixo do mouse estiver no objeto.

* On Up: Alterna para a próxima mensagem quando libera-se o botão do mouse no objeto.

E-Sign (disponível somente para PushButton Multistate): Quando essa opção está habilitada, o usuário será requisitado a inserir a Assinatura Eletrônica antes da execução do dinâmico.

text box Security (disponível somente para PushButton Multistate): Nível de Acesso ao Sistema de Segurança requisitado para o objeto/dinâmico.

No Line: Quando essa opção está habilitada, a linha da borda do objeto não estará visível.

Line Weight: Define a espessura da linha desenhada em redor do objeto (borda).

Fonts: Inicia o diálogo Fonts, onde você poderá configurar os parâmetros de fonte para o texto exibido no objeto.

Botão Config…: Inicia o diálogo Configuration, onde você poderá configurar as mensagens para o objeto, como se segue:

Exemplo de Diálogo Configuration: Smart Message

o Data Source: As mensagens exibidas pelo objeto também podem ser configuradas diretamente no objeto (Data Source = Static) ou podem ser lidas a partir de arquivo de texto externo (Data Source = Text File). Quando Data Source = Static, o diálogo Configuration será exibido como mostrado na figura acima, e você poderá configurar todos os parâmetros na própria grade. Quando Data Source = Text File, o diálogo Configuration exibirá um campo para inserção do caminho e nome do arquivo a partir do qual as mensagens serão lidas (o arquivo de origem). Veja Source File Format para maiores detalhes sobre o formato do arquivo de texto o qual é suportado pelo objeto Smart Message quando Data Source = Text File.

o Extern translation: Quando essa opção está habilitada, o texto exibido pelo objeto será controlado pela ferramenta Translation durante o runtime.

A tabela a seguir descreve o significado das propriedades associadas a cada mensagem, apesar de Data Source:

Propriedade Descrição Text/Message Mensagem (texto) que será exibida quando selecionada durante o


InduSoft Web Studio

Página 257

runtime. Pode-se concatenar valores de tag para a mensagem, configurando o tag entre colchetes. Por exemplo: O valor do nível é {TagLevel}.

Value

Deve-se associar um único valor a cada mensagem. Durante o runtime, o objeto exibirá a mensagem associada com o valor que ai de encontro ao valor do tag configurado no campo Read Tag. Caso não exista tal mensagem, a mensagem configurada na primeira linha (State = Error) será exibida durante o runtime. Quando o Tipo de objeto está configurado para Multistate PushBotão, o valor associado a mensagem atual também é registrado ao tag configurado no campo Write Tag (caso exista).

Text (FG) Cor de primeiro plano para as mensagens exibidas durante o runtime.

Text (BG) Cor de fundo para as mensagens exibidas durante o runtime. Text Blink Caso habilitado, o texto da mensagem piscará durante o runtime. Rec (FG) Cor da linha (Borda) do retângulo abaixo da mensagem. Rec (BG) Cor de fundo (Preencchimento) do retângulo abaixo da mensagem.

Rec Blink Quando habilitado, o retângulo abaixo da mensagem piscará durante o runtime.

Graphic File

Caminho e nome do arquivo bitmap (*.BMP) (caso exista) que será exibido quando a mensagem associada a ele é selecionada durante o runtime. Caso o caminho não seja especificado, o arquivo bitmap deverá ser armazenado no diretório da aplicação.

Transparent Selecione a cor que será transparente no arquivo do gráfico, caso o check-box En. Transparent esteja habilitado.

En. Transparent

Quando habilitado, a cor selecionada no campo Transparent será configurada para transparente no arquivo do gráfico.

Nota: As propriedades Graphic File, Transparent e En. Transparent não estão disponíveis para o tipo Message Display.

Dica: Pode-se copiar dados a partir desse diálogo e cola-los em uma planilha Excel e vice-versa.

Formato do arquivo de origem

Essa seção descreve o formato do arquivo de texo suportado pelo objeto Smart Message quando Data Source = Text File. A principal vantagem da utilização de um Arquivo de Texto externo em lugar de Valores Estáticos, é que o primeiro promove a flexibilidade para alteração de mensagens durante o runtime, apontando-se para um Arquivo de Texto distinto ou mesmo alterando-o dinamicamente.

O Arquivo Texto deverá ser criado em formato CSV (vírgula separando valores), onde o caractere vírgula (“,”) é utilizado para dividir as colunas (dados) em cada linha do arquivo. Portanto, pode-se utilizar qualquer Editor CSV, como Microsoft Notapad e Microsoft Excel para criar o arquivo CSV com as mensagens e propriedades para o objeto Smart Message.

A Descrição de cada propriedade associada às mensagens é fornecida na seção Smart Message. A ordem dos dados no arquivo CSV é descrita na tabela abaixo:

Coluna # Propriedade Valor Padrão 1 Text/Message - 2 Value -


InduSoft Web Studio

Página 258

3 Text (FG) 0 4 Text (BG) 16777215 5 Text Blink 0 6 Rec (FG) 8421376 7 Rec (BG) 16777215 8 Rec Blink 0 9 Graphic File - 10 Transparent 0 11 En. Transparent 0

Ao configurar mensagens de texto que contenham o caractere vírgula como parte da mensagem, deve-se configurar toda a mensagem entre aspas (e.x. “Warning, Turn the motor Off”); do contrário, a vírgula será interpretada como um separador de dados ao invés de uma parte da mensagem.

A primeira linha desse arquivo é equivalente a State = Error. Em outras palavras, caso não exista mensagem associada ao valor do tag atual configurado no campo Read Tag, a mensagem configurada na primeira linha (State = Error) será exibida durante o runtime.

Os dados configurados na coluna Value column da primeira linha desse arquivo é irrelevante. Tal linha deverá ser sempre configurada, apesar do tipo do objeto (mesmo para PushButton Multistate).

Somente as colunas Text/Message e Value são mandatórias. As outras colunas são opcionais, e os valores padrão serão utilizados caso você não especifique um valor (veja a tabela).

Os campos Text(FG),Text(BG),Rec(FG),Rec(BG) e Transparent podem ser configurados com o código da cor a ele associada. O código pode ser inserido diretamente em formato decimal (e.x. 255) ou hexadecimal, utilizando a sintaxe #value (e.x. #0000FF).

Os campos Text Blink, Rec Blink e En. Transparent podem ser configurados com valores Booleanos 0 ou 1 (0 = Não habilitado; 1 = Habilitado), ou com as palavras-chave FALSE ou TRUE (FALSE = Não habilitado; TRUE = Habilitado).

Exemplo:

Error Message,,0,16777215,1,8421376,16777215,1,error.bmp,0,0

Message Zero,0,0,16777215,0,8421376,16777215,0,opena.bmp,65280,1

Message Ten,10,0,16777215,0,8421376,16777215,0,closed.bmp,65280,1

Message Twenty,20,0,16777215,0,8421376,16777215,0,,0,0

Message Thirty,30,0,16777215,0,8421376,16777215,0,,0,0

Dica: Pode-se utilizar o editor Smart Message (Data Source = Static) para a configuração de mensagens, valores e cores. Para tanto, selecione a configuração, copie e cole em uma planilha Excel worksheet como um arquivo CSV (File > Save As). Tal procedimento promove uma utilização amigável da interface para o usuário na configuração de códigos de cores.

• Botão PushButtons ( ): Clique para criar um objeto pushbutton com a utilização da propriedade do objeto dinâmica Command para um objeto ou pushbuttons pré-configurados.

O IWS fornece os seguintes tipos de botão pré-configurados, todos os quais imitam os botões de painel padrão de um mesmo nome:

Momentary (padrão): Altera estado (Open ou Closed) ao pressionar o botão, e reverte para o estado inicial quando solta-se o botão. Esse tipo de botão é sempre exibido em sua posição normal quando uma tela está sendo criada.


InduSoft Web Studio

Página 259

Maintained: Altera estado (Open or Closed) ao pressionar o botão, embora não reverta seu estado inicial ao soltar o botão. Deve-se pressionar o botão novamente para alterar o estado atual. Esse tipo de botão mantém seu estado através das alterações da tela.

Latched: Altera estado (Open ou Closed) ao pressionar o botão e permanece nese estado até que você o libere, alterando o tag Reset.

O IWS também fornece os seguintes estilos de botões:

Retangular com uma face e luz indicadora

Retangular sem uma face ou lua indicadora (padrão)

Retangular com 3-D

Retangular com aparecência flutuante

Para adicionar um ou mais botões pré-configurados a uma tela:

Clique no botão Pushbutton e posicione o mouse (apontador) na tela.

Clique e arraste para criar/ajustar o tamanho do botão Retangular.

O tamanho do Botão e as características da fonte de texto determinam quanto texto poderá ser exibido, além do tamanho da área de uma tela que poderá ser tocada em uma touch screen. Pode-se redimensionar o botão e alterar as características da fonte posteriormente, permitindo assim que mensagens mais longas sejam exibidas em um espaço específico.


Object Properties: Pushbuttons

Dica: De forma alternativa, clique com o botão direito ou selecione o objeto, pressione as teclas Alt+Enter e selecione Properties a partir do menu pop-up resultante para abrir o diálogo Object Properties.


Lista drop-down Type: Clique para selecionar o tipo de pushbutton (Momentary (padrão), Maintained, ou Latched).

Lista drop-down State: Clique para especificar um estado padrão para o pushbutton (Normally Opena (padrão) ou Normally Closed).

Clique no botão para inverter entre os estados padrão e não padrão (de acordo com seu Tipo especificado). Por exemplo, no estado inicial do botão, poderá estar de acordo com as características Especificadas na área Open do diálogo Configuration (veja abaixo). Clique no botão novamente para inverter para seu estado oposto, que nesse exemplo mostra-se como Closed, e de acordo com as características Especificadas na área Closed.

text box Tag/Exp: Digite um tag ou expressão para realizar o seguinte:


InduSoft Web Studio

Página 260

* Digite um tag para receber Write Value a partir do estado na área apropriada (Open ou Closed) no diálogo Configuration.

* Digite uma expressão para executar On Down, ao pressionar o pushbutton.

Nota: O IWS não registra o resultado de qualquer expressão no campo Tag/Exp para um tag.

text box Indicator: Digite um tag para definir um indicador que faz o botão alterar para uma cor Especificada quando o valor do tag altera-se para dois dos valores Especificados. Deve-se definir cores e valores de tag no diálogo Configuration. Caso você deixe esse campo em branco, o indicador alterará a cor automaticamente ao pressionar o botão.

check-box E-Sign: Selecione (habilite) essa opção para requisitar o usuário a inserir a Assinatura Eletrônica antes de executar o dinâmico.

text box Reset (ativo somente para tipo pushbutton Trancado): Digite um tag para controlar o estado trancado do botão, como se segue:

* Digite zero no valor do tag e o botão permanecerá em um estado trancado após você pressioná-lo.

* Digite um valor diferente de zero para um tag e um botão trancado tornará-se destrancado após pressioná-lo. Deve-se reiniciar o valor do tag para zero antes de poder pressionar o botão novamente.

área Key: Especifica uma tecla do teclado ou cria uma tecla de combinação para inverter um pushbutton quando não se têm equipamento de apontamento (mouse ou touch screen) ou caso você queira criar teclas de atalho em adição a pushbuttons.

Lista drop-down Key: Digite uma tecla no text box ou seleicone uma tecla não numérica da lista drop-down. Insira um caractere único ou somente uma tecla. Números não são entradas válidas para esse campo.

Clique (habilite) no box Shift, Ctrl, ou Alt para criar uma tecla de combinação, significando que as teclas Shift, Ctrl, ou Alt devem ser pressionados com a tecla especificada na lista drop-down.

Clique (habilite) no box para abrir o diálogo Key Modifier, que habilita a modificação de suas combinações de teclas. Pode-se escolher Left, Right ou Left or Right para especificar a posição no teclado das teclas Shift, Ctrl ou Alt na combinação de teclas. Caso você escolha Left or Right, o comando será executado a qualquer momento que essas teclas forem pressionadas em combinação com a tecla especificada na lista drop-down.

Diálogo Key Modifier


InduSoft Web Studio

Página 261

text box Disable: Digite um tag utilizando um valor defirente de zero para desabilitar esse pushbutton. Assim, pressionar esse botão não surtirá efeito algum. Esse box está vazio por padrão, o qual habilita a propriedade command.

check-box Ext Trans.: Clique (habilite) para traduzir o texto automaticamente, utilizando-se das planilhas de tradução pré-configuradas.

text box Security: Digite um valor para especificar um nível de segurança (0 a 255) para esse botão. Caso o usuário não tenha o nível de segurança especificado, o botão torna-se inativo. Caso o usuário tenha o nível de segurança apropriado ou deixar esse campo em branco, o botão permanecerá ativo.

Botão Config: Clique para abrir o diálogo Configuration, o qual permite a especificação dos parâmetros de estilo e estado para o pushbutton:

Diálogo Configuration

Esse diálogo fornece os seguintes parâmetros:

combo-box Style: Clique no botão do combo-box para selecionar o estilo de um pushbutton (Rectangle (padrão) ou Rectangle with Indicator).

combo-box Effect: Clique para selecionar um efeito 3-D para o pushbutton.

* Floating (padrão): Botões assemelham-se a um objeto flat com uma sombra

* 3D: Botões têm limites não nivelados e parecem “mergulhar” na tela quando pressionados.

Pode-se utilizar os parâmetros Style e Effect em combinação para criar quatro botões diferentes, como mostrado nas figuras abaixo:

Estilos de Pushbutton

Align: Especifica o alinhamento para a captação do pushbutton.


InduSoft Web Studio

Página 262

box Botão Color: Clique para especificar uma cor padrão para a área do botão de um um objeto pushbutton que inclui um indicador e uma “faceplate”. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

box Legend Plate Color: Clique para especificar ou alterar uma cor padrão para a área de legenda de um objeto pushbutton que inclui um indicador. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

Uma legenda possui um botão e uma luz indicadora . Esse campo torna-se inativo caso o Estilo do pushbutton não inclua um indicador.

áreas Open e Closed: Os parâmetros a seguir são utilizados para configuração da aparência de um objeto pushbutton, bem como seus possíveis estados: aberto e fechado.

box Color: Clique para especificar uma cor padrão para um indicador em cada Estado. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

Caso você tenha selecionado um estilo de pushbutton que não inclua um indicador, pode-se utilizar esse campo para especificar uma cor de botão para cada Estado.

combo-box Blink: Clique para especificar se a cor escolhida no box Color é capaz de piscar e qual a sua freqüencia para cada estado (None (sem piscar, padrão), Slow, e Fast).

Caso você tenha configurado a cor para piscar, essa alternará entre a cor Especificada no box Color e Legend Plate Color (sendo um indicador) ou o Button Color (sendo um botão).

text box Caption: Utilize esse text box para inserir uma captação do botão. De forma alternativa, pode-se utilizar a legenda, caso o estilo do botão inclua um indicador.

Botão Fonts: Clique para abrir o diálogo Font, o qual pode ser utilizado para especificar ou alterar as características da fonte da mensagem para cada estado.

combo-box Text Blink: Clique para especificar se o texto especificado deverá piscar e a freqüencia com que deverá piscar para cada estado (None (sem piscar, padrão), Slow, e Fast). Ao contrário de uma cor piscante, o texto aparecerá piscando, aparecendo e desaparecendo.

combo-box Write Value: Clique para selecionar um valor no campo. Quando o pushbutton está no estado apropriado (Open ou Closed), o IWS registra esse valor para o tag especificado no campo Tag/Exp (diálogo Object Properties).

• Botão ActiveX Control ( ): Clique para abrir o diálogo Insert ActiveX Control, o qual poderá ser utilizado para a colocação de componentes ActiveX em sua tela.

O diálogo que se abre (como na figura abaixo) contém uma lista de todos os componentes ActiveX registrados em seu computador.

Diálogo Insert ActiveX Control

Clique em um ou mais componentes da lista e depois clique em OK para fechar o diálogo e exibir todos os componentes selecionados em sua tela.


InduSoft Web Studio

Página 263

Controles ActiveX são componentes projetados de acordo com um padrão. O IWS é um armazenador de ActiveX e por isso você poderá configurar e rodar controles ActiveX nas telas criadas com o IWS. Controles ActiveX podem promover as seguintes interfaces:

Properties: Variáveis das quais os valores podem ser lido e/ou registrados para a aplicação (e.x. Object Color, FileName, URL, etc)

Methods: Funções do objeto ActiveX que podem ser diparadas pela aplicação (e.x. abrir um diálogo, executar um cálculo, etc)

Events: Mensagens internas que podem disparar a execução de expressões na aplicação (e.x. Mouse_Click, Download_Completed, etc)

O nome das propriedades, métodos e eventos suportados por cada objeto ActiveX dependem de sua própria implementação.

Existem dois modos distintos para estabelecer interface entre a aplicação e o controle ActiveX:

Utilizando as Funções do ActiveX XGet(), XSet() e XRun()

OU

Utilizando a janela Object Properties para configuração do objeto

Atenção: Ao utilizar controles ActiveX em sua Aplicação, certifique-se de que a target

station (estação runtime) tenha o mesmo ActiveX, registrado da forma apropriada. Os arquivos da aplicação do IWS incluem links para os contoles ActiveX; entretanto, a instalação desses controles na target station deverão ser executadas manualmente. Além disso, quando controles ActiveX são utilizados em telas abertas em Web Thin Clients remotos, os controles ActiveX deverão também ser instalados manualmente nas Web Thin Client stations. Consulte o fornecedor de seu ActiveX para maiores informações sobre instalação.

Ao Configurar Aplicações com ActiveX para CEView, certifique-se de que o controle ActiveX utilizado na Aplicação é suportado na plataforma (sistema operacional Windows CE e tipo de processo) onde você pretende rodar a aplicação. Consulte seu fornecedor do ActiveX para maiores informações sobre as plataformas suportadas.

Clique duas vezes no controle ActiveX para abrir o box de diálogo Object Properties.

Object Properties: ActiveX Control

A janela Object Properties exibe o nome do controle ActiveX. Geralmente, cada controle ActiveX pode ser um arquivo *.dll ou *.ocx registrado em seu computador local. Deve-se assinalar um nome (alias) para o controle ActiveX da aplicação no campo Name (e.x. MyControl). Esse nome será utilizado como referência ao objeto ao configurar as funções ActiveX a partir da linguagem do IWS.


InduSoft Web Studio

Página 264

Nota: Não deve-se configurar dois controles ActiveX em uma mesma tela e com um mesmo nome. Por exemplo, caso você insira dois controles ActiveX “Windows Media Player” em uma mesma tela e nomear um objeto como MyMP1 (Name field), você não poderá colocar o mesmo nome no Segundo objeto dessa mesma tela. Você deverá nomear o segundo objeto como MyMP2, por exemplo.

O botão Property Pages abre a janela padrão para a configuração de Propriedades Estáticas (caso exista). O layout e as opções nessa janela de diálogo dependem da implementação de cada controle ActiveX. Utilize essa interface para configurar propriedades que não deverão ser alteradas durante o runtime (propriedades fixas).

O botão Configuration na janela Object Properties abre diálogos que permitem:

Associar tags a propriedades do objeto ActiveX

Disparar métodos do objeto ActiveX baseados em alteração de tag

Configurar scripts, os quais são executados quando ocorrem Evento do objeto ActiveX

As seções a seguir descrevem como configurar tais interfaces.

Notas: Embora o diálogo Configuration exiba a lista de todas as propriedades,

métodos e eventos, somente os itens necessarios para seu projeto deverão ser configurados.

Os tópicos de tela utilizados nas seções a seguir dizem respeito ao controle ActiveX Windows Media Player. Embora nomes de propriedades, métodos e eventos variem dependendo de cada controle ActiveX, a interface de configuração é a mesma para qualquer controle ActiveX. Os conceitos descritos aqui são aplicados a todos eles.

Configurando Propriedades

O tab Properties fornece uma grade com os seguintes campos:


InduSoft Web Studio

Página 265

Diálogo Configuration –Tab Properties

Property: Lista todas as propriedades disponíveis no objeto ActiveX, além de indicar seus tipos:

– Ícone da Propriedade

– Tipo de propriedade

– – Boolean

– – Integer

– – Real

– – String

Tag/Expression: O tag configurado nesse campo está associado a respectiva propriedade do objeto ActiveX. A coluna Action definirá se o valor desse tag será registrado a propriedade ActiveX ou se o valor da propriedade ActiveX será registrado ao tag (ou ambas as ocorrências).

Nota: Pode-se configurar uma expressão nesse campo caso você deseje registrar o resultado de uma expressão para a propiedade do objeto ActiveX. Porém, nesse caso, o valor da propriedade não será lido de volta a um tag (a menos que se utilize da função XGet()). Portanto, quando uma expressão é configurada nesse campo, o campo Scan será automaticamente configurado para Set.

Action: Define a direção da interface entre o tab ou expressão configurados no campo Tag/Expression e a propriedade do ActiveX de acordo com a tabela a seguir:

– Ação – Descrição

– Get – Lê o valor da propriedade


InduSoft Web Studio

Página 266

ActiveX e registra-os ao tag configurado no campo Tag/Expression.

– Set

– Registra o valor do tag ou expressão configurada no campo Tag/Expression para uma propriedade do ActiveX.

– Get+Set

– Executa ambas as ações (Get e Set). Porém, ao abrir uma tela com o objeto ActiveX, o IWS executa o comando Get antes de executar qualquer comando Set. O tag configurado no campo Tag/Expression será atualizado com o valor da propriedade ActiveX quando o IWS abre a tela onde o ActiveX está configurado.

– Set+Get

– Executa ambas as ações (Get e Set). Porém, ao abrir uma tela com o objeto ActiveX, o IWS executa o comando Set antes de executar qualquer comando Get. A propriedade ActiveX será atualizada com o valor do tag configurado no campo Tag/Expression quando o IWS abre a tela onde o ActiveX está configurado.

Nota: Quando o valor da propriedade está como "Somente Leitura" (Não pode ser modificado pela aplicação), o campo Action é automaticamente configurado para Get.

Scan: Define a efetuação do método polling para obtenção de valores a partir das propriedades do ActiveX, de acordo com a seguinte tabela:

– Scan – Descrição

– No

– O valor da propriedade ActiveX é lido e registrado ao tag configurado no campo Tag/Expression, onde somente a tela com o objeto ActiveX está aberta, e quando o objeto ActiveX


InduSoft Web Studio

Página 267

envia uma mensagem para que o IWS atualize esse tag.

– Always

– O IWS mantém a efetuação de polling do valor da propriedade do ActiveX e atualiza o valor do tag configurado no campo Tag/Expression com esse valor.

Nota: Alguns controles ActiveX são projetados para enviar mensagens a seus containeres (Aplicação), indicando que uma propriedade alterou valor e o novo valor deverá ser lido (Get) novamente. Porém, outros controles ActiveX não implementam esse algorítmo. Nesse caso, o único meio para obtenção dos valores atualizados das propriedades ActiveX é manter o polling desses valores a partir do controle ActiveX (Scan=Always).

Configurando Métodos

Methods fornece uma grade com os seguintes campos:

Diálogo Configuration – Tab Methods Method: Lista todos os métodos disponíveis a partir do objeto ActiveX.

Parameters: Os tags configurados nesse campo são associados com os parâmetros do método correspondente ao objeto ActiveX. Caso o método não suporte parâmetro algum, o texto fixo <None> é exibido no campo Parameters. Do contrário, pode-se digitar os tags associados nos parâmetros do objeto ActiveX. Quando o método possui mais de um parâmetro, pode-se digitar um tag para cada parâmetro, separando-os por uma vírgula (,). Por exemplo, TagA , TagB , TagC. Quando o método é executado, os valores do tag são registrados aos parâmetros do método (parâmetros de entrada), ou, após a execução do método, o ActiveX registrará o valor dos parâmetros para o tag (parâmetros).


InduSoft Web Studio

Página 268

Dica: Ao clicar no botão Browse ( ), aparecerá uma lista de parâmetros suportados pelo método, permitindo a associação de um tag a cada parâmetro.

Trigger: Quando o tag configurado nesse campo altera seu valor, o respectivo método do controle ActiveX é executado.

Return: O tag configurado nesse mapo recebe o valor de retorno pelo método (caso exista).

Configurando Events

O tab Events fornece uma grade com os seguintes campos:

Diálogo Configuration– Tab Events Event: Lista todos os eventos disponíveis no objeto ActiveX.

Parameters: Os tags configurados nesse campo são associados a parâmetros do evento correspondente ao objeto ActiveX. Caso o evento não suporte qualquer parâmetro, o texto fixo <None> é exibido no campo Parameters. Do contrário, pode-se digitar os tags associados aos parâmetros do objeto ActiveX. Quando e evento possui mais de um parâmetro, pode-se digitar um tag para cada parâmetro, separando-se por uma vírgula (,). Por exemplo, TagA , TagB , TagC. Quando o evento é gerado, o valor dos tags são registrados aos parâmetros do evento (parâmetros de entrada), ou os valores do parâmetros são registrados para os tags (parâmetros de saída).

Dica: Ao clicar no botão Browse ( ), aparecerá a lista de parâmetros pore le suportados, permitindo a associação de um tag com cada parâmetro.

Script: O script configurado nesse campo será executado quando o evento for disparado pelo controle ActiveX.


InduSoft Web Studio

Página 269

Dica: Ao clicar no botão Browse ( ), aparecerá um diálogo com o script completo associado ao evento. A janela de diálogo principal exibe somente a expressão configurada na primeira linha do script.

• Botão Combo-Box ( ): Clique para selecionar um nome único a partir da lista de nomes do combo-box.

Caso a lista seja maior que o espaço delimitado, o IWS habilita uma barra de rolagem para a lista. Durante o runtime, selecionando um nome da lista do combo-box se ocultará, e o nome selecionado será exibido no combo-box.

Clique duas vezes no objeto combo-box para abrir o diálogo Object Properties:

Object Properties: Combo-Box

Pode-se utilizar esse diálogo para configurar os seguintes parâmetros:

combo-box Align: Clique para especificar o nome do alinhamento (Left, Center, ou Right) que afeta o alinhamento tanto na lista quanto em seu combo-box.

text box Position/Index: Digite um tag integer, o qual corresponde ao nome atualmente exibido no combo-box. Alterar o valor desse tag alterará o nome a ser exibido.

text box Label: Digite um tag string para receber o valor do nome atualmente exibido no combo-box.

check-box Input Enabled: Clique (habilite) para permitir que um operador selecionando um nome digitando os conteúdos desse nome em um tag no campo Label.

check-box Confirm: Clique (habilite) para requisitar ao operador a confirmação de um comando durante o runtime.

check-box E-Sign: Clique (habilite) para requisitar ao usuário a inserção da Assinatura Eletrônica antes de executar o dinâmico.

Campo VK: tipo de Virtual Keyboard utilizado para esse objeto. Você precisará habilitar a opção Virtual Keyboard na interface Project → Settings → Runtime Desktop antes de configurar o Virtual Keyboard para essa interface.

box Color: Clique para especificar uma cor de fundo para o combo-box. Quando o diálogo Color abrir, clique em uma cor para selecioná-la e depois clique em OK para fechar o diálogo.

text box Disable: Digite um tag com um valor diferente de zero para desabilitar esse combo-box. Digite zero ou deixe esse campo em branco (padrão) para habilitar a propriedade Command. Caso você desabilite o combo-box, este aparecerá em cinza durante o runtime.

text box Security: Digite um nível de segurança para o comando (0 a 255). Caso um operador efetue log on e não possua o nível de segurança especificado, o comando se tornará inativo.


InduSoft Web Studio

Página 270

Caso um operador efetue log on, não possua o nível de segurança especificado oudeixe esse espaço em branco, a propriedade Command permanece ativa.

Botão Fonts: Clique para abrir o diálogo Font. Utilize esse diálogo para alterar as características da fonte de uma mensagem.

Botão Data...: Clique para abrir o diálogo Combo Data, o qual permite a definição de nomes e suas ordens dentro do combo-box.

Diálogo Combo Data

Utilize os parâmetros no diálogo Combo Data como se segue:

Type: Especifica a utilização de Array of labels ou static list of labels para definir o combo-box.

Sort: Clique (habilite) para exibir os conteúdos de seu tag array de nomes em ordem alfabética. Esse parâmetro está disponível somente ao selecionar o tipo Array Tag.

Array Tag: Digite um tag name para uma string tipo tag array contendo os valores do nomes no combo-box.

Number of Items: Digite em um integer ou um tag para especificar quantos nomes poderão ser exibidos no combo-box. Mantenha em mente que o combo-box conta array index 0 como primeiro item. Caso você especifique quatro nomes array, o combo-box exibira array index 0 e array index 3 – somando um total de quarto nomes.

Drop list size (Items): Digite em um integer ou um tag para especificar quantos nomes poderão ser visualizados no combo-box a qualquer momento.

Combo Static Labels List: Especifica o parâmetro Static Labels na área Type para habilitar essa lista a conter nomes. Cada linha da lista significa um nome independente. O nome na primeira linha é designado para o nome na posição 0. O nome na linha seguinte está na posição 1e assim por diante.

• Botão Alarm ( ): Clique para especificar uma área da tela na qual exibir mensagens de alarme.

A seguir, clique na tela e arraste o mouse para designar uma área para mensagens. Ao terminar, clique duas vezes no objeto para abrir o diálogo Object Properties:


InduSoft Web Studio

Página 271

Object Properties: Alarm


Botão On Line: Clique (habilite) nesse Botão para exibir mensagens de alarme online para o objeto.

Botão History: Clique (habilite) nesse Botão para exibir mensagens de alarme de arquivos históricos.

Atenção: Você deverá utilizar a opção Save to Disk, localizada na planilha Alarm (Tab Tasks), para salvar mensagens de alarme especificadas como arquivos históricos.

combo-box Border: Clique para definir uma cor para as bordas da mensagem de alarme. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

combo-box Win: Clique para definir uma cor de fundo para o diálogo Alarm Message. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo.

Campo PgUp: No runtime, inverter o tag nesse campo dispara um comando “page up” para a lista.

Campo PgDown: No runtime, inverter o tag nesse campo dispara um comando “page down” para a lista.

área Message Format: Utilize os seguintes parâmetros para definir um formato para mensagens de alarme. Pode-se formatar alarmes para que incluam datas, horários (horas), nomes, tags e mensagens.

Botão Font: Clique para abrir o diálogo Fonts e Especificar um estilo, tamanho, cor e tipo de fonte para o texto da mensagem de alarme.

check-boxes DD,MM,YY: Clique (habilite) para exibir a data do alarme no texto da mensagem.

check-boxes HH,MM,SS,MSS: Clique (habilite) para exibir o horário do alarme no texto da mensagem.

Nota: Caso você habilite os boxes DD,MM,YY e/ou HH,MM,SS,MSS, o caractere asterisco (*) será exibido entre data/hora do alarme e mensagem do alarme.

Campo Tag: Especifica quantos caracteres são permitidos para um nome de tag.

Campo Message: Especifica quantos caracteres são permitidos para uma mensagem.

check-box Ack: Clique (habilite) para adicionar a hora de reconhecimento de uma mensagem de alarme.

check-box End: Clique (habilite) para adicionar o horário de normalização à mensagem de alarme.


InduSoft Web Studio

Página 272

Botão Selection: Clique para abrir o diálogo Alarm Filters, o qual permite a especificação de filtros para as mensagens de alarme.

Diálogo Alarm Filters

Utilize os seguintes parâmetros para especificar esses filtros:

Campo Group: Insira um valor para selecionar e exibir grupos de alarme no objeto alarm summary.

* Insira zero no campo para selecionar todos os grupos de alarme.

* Insira qualquer valor diferente de zero para selecionar um grupo de alarme específico.

Campo Selection: Digite a string de caractere especificado na coluna Selection na planilha Alarm (tab Tasks). O IWS filtra alarmes de exibição, adaptando esse string de caractere contra a string especificada na planilha Alarm.

Nota: Esse string de caractere deverá ser o mesmo que a string de caractere da planilha Alarm.

Dica: Caso você insira a string de caractere entre colchetes ({ }), pode-se modificar o valor do tag durante o runtime.

Campos Priority Range: Especifica uma escala (baseada na prioridade do alarme, Especificada na coluna priority da planilha Alarm) o qual filtra e exibe mensagens de alarme.

Por exemplo, caso você assinale prioridades de alarme de 1 A 5 na planilha Alarm, e depois assinalar de 0 a 4 nesses campos Priority Range, o IWS exibirá prioridades de alarme de 1 a 4 e não exibirá a prioridade 5.

área Sort: Utilize os radio buttons para especificar e exibir mensagens de alarme como se segue:

Time: Clique (habilite) nesse botão para especificar alarmes de acordo com o horário no qual o alarme foi recebido.

Priority: Clique (habilite) nesse botão para especificar e exibir alarmes de acordo com as propriedades assinaladas nos campos Priority Range.


InduSoft Web Studio

Página 273

Print Tag: Digite um tag name para filtrar e imprimir todos os alarmes, quando alterações são efetuadas ao tag.

Campo Ack Tag: Digite um tag name para filtrar e reconhecer o alarme ativo (na parte superior da lista do objeto alarm) quando você altera o tag.

Dica: Pode-se utilizar o tag interno AckAlr para reconhecer o último alarme da Aplicação.

Campo Ack All Tag: Digite um tag name para reconhecer todos os alarmes ativos e filtrados ao alterar o tag.

Dica: Pode-se utilizar o tag interno AckAll para reconhecer todos os alarmes da Aplicação.

Campo View %: Digite um tag nesse campo (Especifique um tag de 0% a 100%) para controlar quantas mensagens de alarme estão visíveis na lista alarm durante o runtime. Também Pode-se utilizar esse tag para rolar a lista para cima e para baixo durante o runtime.

Lista Alarms com barra de rolagem

• Botão Grid ( ): O objeto Grid permite a leitura/registro de dados em um formato tabular a partir da data source configurada no objeto. Para desenhar, faça o seguinte:

Clique na ferramenta Grid.

Clique na tela, clique no Botão esquerdo do mouse, e arraste o mouse pela tela para criar um box do tamanho desejado (enquanto segura o botão do mouse).

Solte o botão do mouse, e o o objeto Grid aparecerá.

Criando um Objeto Grid


InduSoft Web Studio

Página 274

Clique com o botão direito no objeto Grid e selecione Properties do menu. O diálogo Object Properties abrirá. Utilize esse diálogo para configurar os parâmetros do Objeto Grid:

Object Properties: Grid Object

Data Source: Selecione o tipo de dados de origem. O objeto suporta três origens de dados:

Data Source

Descrição

Text File Exibe dados de um arquivo texto em formatos ASCII ou Unicode (e.x. arquivos CSV).

Class Tag Exibe valores de um Tag Class, onde os membros do tag são campos (colunas) do objeto grid, e cada posição de array é uma linha no objeto grid.

Database Exibe dados de um Banco de Dados Relacional SQL Relational Database, utilizando ADO (objeto ActiveX Database) para trocar dados com o banco de dados.

E-Sign: Ao habilitar essa opção, o usuário será requisitado a inserir a assinatura eletrônica antes de inserir ou modificar dados no objeto.

VK: Selecione um tipo de Virtual Keyboard utilizado para esse objeto. A opção <Use default> seleciona o Virtual Keyboard padrão configurado no desktop da interface Project � Settings � Runtime. Também Pode-se especificar um virtual keyboard diferente para esse ObjetoGrid.

Security: Insira o nível de acesso ao sistema de segurança requisitado para o objeto/dinâmico.

Disable: Pode-se inserir uma expressão nesse campo para desabilitar entrada de dados ou ações pelo usuário.

Highlight Color: Selecione uma cor de fundo para a linha selecionada durante o runtime.

Text Color: Selecione uma cor de texto para a linha selecionada, durante o runtime.

Win Color 1: Selecione uma cor de fundo para as linhas pendentes.

Win Color 2: Selecione uma cor de fuindo para todas as linhas.

Fonts: Clique para iniciar o diálogo Fonts, onde você pode estabelecer as configurações de fonte para o texto a ser exibido no objeto Grid.

Columns: Clique para iniciar o diálogo Columns, onde você pode estabelecer as condigurações (como nome, coluna, largura, etc.) para as colunas do objeto Grid.

Pode-se configurar os parâmetros para cada coluna exibida pelo objeto Grid durante o runtime, como se segue:


InduSoft Web Studio

Página 275

Diálogo Columns

* Column: O Número ID define a posição da coluna na tabela.

* Label: Insira um Título para cada coluna, a qual será exibida como cabeçalho (first) no objeto Grid.

* Field: Insira o nome do campo (coluna) no Banco de Dados SQL Relacional ao qual o objeto Grid é vinculado. Caso esse campo seja deixado em branco, o texto configurado no campo Label será utilizado como Field. (Tal configuração está disponível somente quanto o tipo de Data Source está configurado para o Banco de Dados.)

* Type: Selecione o tipo de interface que será utilizada na coluna. As opções são:

Type Descrição Text Exibe valores alfanuméricos

Numeric Exibe valores numéricos

Picture Exibe a figura (formato *.bmp ou *.ico) do data source. Por exemplo, caso o valor do data source seja MyFile.bmp, o objeto grid exibirá a figura do arquivo MyFile.bmp armazenado na pasta da aplicação. A figura será automaticamente redimensionada para adaptar-se á célula do objeto grid. O arquivo(s) da figura deverão ser armazenados na subpasta \Web da aplicação para suportar esse recurso em Web Thin Client stations. Aplicações em CEView suportam figuras em formato bitmap (*.bmp), mas não em formato ícone (*.ico).

Check-box Exibe interfaces check-box. O check-box será desabilitado caso o valor lido do arquivo seja 0, <NULL> ou "FALSE"; do contrário, o check-box estará habilitado. Por padrão, o IWS utilizará o valor 0 para desabilitado e 1 para habilitado.

Time Exibe o valor em formato Time (e.x. HH:MM:SS). Essa configuração está disponível somente quando o tipo de Data Source está configurado para Banco de Dados.


InduSoft Web Studio

Página 276

Date Exibe o valor em formato Date (e.x. MM/DD/YYYY). Essa configuração está disponível somente quando o tipo Data Source está configurado para Banco de Dados.

Date/Time Exibe o valor em formato Date/Hour (e.x. MM/DD/YYYY HH:MM:SS). Essa configuração está disponível somente quando o tipo Data Source está configurado para Banco de Dados.

Notas: Quando o tipo Data Source está configurado para Database, é

importante certificar-se de que o Tipo para cada coluna configurada no objeto adapte-se ao Tipo do campo respectivo no banco de dados.

Quando o tipo Data Source está configurado para Database, pode-se configurar demonstrações SQL válidas diretamente no Campo (e.x. List(DISTINCT [Cell_Name]) AS [Cell Name]). Também Pode-se configurar os tag names entre colchetes para modificar essa configuração durante o runtime (e.x. {MyFieldName}).

Dica: Caso Picture seja um tipo de coluna, o objeto Grid exibe um ícone padrão ( ) caso o arquivo da figura não seja encontrado durante o runtime. Pode-se configurar uma figura diferente a ser exibida quando o arquivo não for encontrado, copiando-se o arquivo da figura para a subpasta \Web da Aplicação e configurando seu nome no arquivo <AplicaçãoName>.APP, como se segue:

[Objects]

GridPatternPicture=<PictureFileName>

* Width: Insira a largura da coluna, em pixels.

* Align: Selecione um alinhamneto para os dados exibidos na coluna. Existem três opções: Left, Right ou Center.

* Input: Habilite para permitir ao usuário inserir dados nessa coluna durante o runtime.

* Key: Designa um atalho para valores Especificados nesse campo. Um atalho é uma combinação de teclas pressionadas ao mesmo tempo no teclado (e.x. CTRL + C, CTRL + V, etc.). Essa opção é especialmente útil ao criar Aplicações para equipamentos de runtime que não fornecem um mouse ou interface touch-screen, possuindo somente o teclado para interação durante o runtime.

Nota: Quando o tipo Data Source está configurado para Class Tag, e o diálogo Columns é deixado em branco, o objeto exibe os valores de todos os membros do Class Tag com as seguintes configurações padrão para a coluna:

Label = <Name of the Member from the Class tag>

Type = Text

Width = <Minimum size to display the name of the member from


InduSoft Web Studio

Página 277

the class tag on the header of the grid object>

Align = Center

Input = Enabled (checked)

Key = <None>

* Show ID Column: Habilite para exibir o número de cada linha automaticamente.

* Allow sorting columns: Habilite para que o usuário possa Especificar os valores nas colunas durante o runtime, clicando no nome ou utilizando um atalho, configurado para cada coluna. Essa opção estará desabilitada caso a opção Show header do diálogo Advanced não estiver habilitada.

Dica: Utilize os botões Move Up e Move Down para reordenar a exibição das colunas.

Data: Clique para iniciar o diálogo Data, onde você poderá especificar uma data source (data source) para o objeto Grid.

Esse diálogo permite a configuração de parâmetros para data source, como se segue:

* Data Source – Text File

Quando o tipo Data Source é configurado para Text File, pode-se configurar os seguites parâmetros:

File: Insira o nome da origem do arquivo de texto. Pode-se digitar o nome do arquivo e seu caminho ou clicar no botão … para a pesquisa. (Caso o arquivo seja armazenado na pasta da aplicação, pode-se omitir o caminho.)

Delimiters: Configura o delimitador(es) utilizados no arquivo de data source. Por exemplo, caso os dados sejam lidos a partir de um arquivo CSV (valores separados por vírgulas), você deverá selecionar a opção Comma. Também Pode-se escolher um delimitador personalizado, habilitando a opção Other e digitando o delimitador personalizado no campo logo acima.

Dica: Pode-se configurar tag names entre colchetes {TagName} no campo File.


InduSoft Web Studio

Página 278

* Data Source – Class Tag

Quando o tipo de Data Source é configurado para Class Tag, pode-se configurar a seguinte interface:

Class Tag: Insira o nome da origem do tag class principal. (Não especifique um membro específico do tag classe.) Pode-se especificar a posição inicial do array nesse campo (e.x. Mytag[10]); do contrário, 0 (zero) será utilizado, por padrão, para a posição.

Number of Items: Insira o número de posições do array para o Class Tag que deverá ser exibido.

View: Quando tag configurado no campo opcional altera seu valor (e.x. inverte-se) durante o runtime, o objeto grid inicia um diálogo, permitindo que o usuário mostre/oculte ou modifique posições.

* Data Source – Database Quando o tipo de Data Source type é configurado para Database, pode-se configurar os seguintes parâmetros:


InduSoft Web Studio

Página 279

Leia: Janela de Diálogo Database Configuration para maiores informações sobre esse diálogo.

Advanced: Clique para iniciar o diálogo Advanced, onde você poderá configurar vários parâmetros para o objeto Grid.

Esse diálogo permite a configuração dos parâmetros em Advanced, como se segue:


InduSoft Web Studio

Página 280

Diálogo Advanced

* User Enable: Caso o valor desse tag seja TRUE (diferente de 0), o usuário pode selecionar linhas diferentes do objeto, clicando nessas linhas durante o runtime. Esse campo pode ser configurado com um tag ou um valor numérico.

* Selected Values: Os valores de cada coluna da linha selecionada são registrados para cada posição do tag array configurado nesse campo. Além disso, pode-se modificar o valor das células atualmente selecionados no objeto Grid, alterando-se o valor do tag array configurado nesse campo. A posição inicial do array (offset) pode ser configurada nesse campo.

* Row Number: O objeto Grid registra o número de linhas atualmente selecionadas durante o runtime. Além disso, pode-se selecionar linhas diferentes, registrando seus valores nesse tag.

* Reload: Quando o tag configurado nesse campo é invertido, o objeto recarrega e exibe os dados a partir do data source.

* Condition: Esse campo pode ser configurado com a expressão para filtro de dados. Essa expressão deve seguir a sintaxe básica: <ColumnName> <Comparison Operator> <Value> (e.x. ColumnX > 200). Ao utilizar Text File ou Class Tag para Data Sources, <ColumnName> será o valor especificado em the Label. Ao utilizar o Banco de Dados para Data Source, a coluna será o valor especificado em Field. (Caso Field seja deixado em branco, o valor da coluna será aquele especificado em Label.)

Dicas: Pode-se combinar várias condições simultâneamente no campo Condition, utilizando os operadores lógicos AND, OR, e NOT. Por exemplo,


InduSoft Web Studio

Página 281

ColumnAge>‘10’ OR ColumnName=‘John’ AND ColumnDate>‘05/20/2003’.

Pode-se utilizar “wildcards” (* and ?) no campo Condition para filtrar os dados.

Pode-se configurar tags entre colchetes {TagName} no campo Condition para alterar as condições de filtragem durante o runtime.

* Number of Rows: O objeto grid registra o número de linhas atualmente disponíveis no objeto grid ao tag configurado nesse campo.

* Print: Quando o tag configurado nesse campo é invertido, os dados atualmente filtrados no objeto são enviados para impressão.

* Save Trigger: Quando o tag configurado nesse campo é invertido, o data source (Text File ou Database) é atualizado com os valores atuais do objeto grid. Esse campo não está disponível quando o tipo Data Source type for Class Tag, já que os valores dos tags serão atualizados automaticamente assim que você alterar uma célula da grade.

* Insert Trigger: Quando Auto refresh after insert trigger estiver habilitado (checado), o Tag configurado neste campo é usado como um trigger para atualizar a tabela da base de dados. Sempre que o valor do Tag muda, uma fileira nova é adicionada à tabela e os valores do array configurado no campo Inserted Values são introduzidos automaticamente.

* Inserted Values : Se o Insert Trigger estiver sendo usado, então o Tag array configurado neste campo fornece os valores que serão introduzidos. Este campo deve conter somente um Tag array, embora possa ser de qualquer tamanho.

* Save on data change: Quando essa opção está habilitada, os valores são atualizados em data source (Text File ou Database) assim que o usuário insira um novo valor na grade durante o runtime. Essa opção estará desabilitada quando o tipo Data Source for Class Tag, já que os valores dos tags serão atualizados automaticamente assim que você alterar uma célula da grade.

* Enable Slider/Resize: Caso esse box não esteja habilitado, o usuário não será capaz de rolar através da lista arrastando o botão slider ou alterar o tamanho das células durante o runtime.

* Conditional Check-box: Quando essa opção está habilitada, o usuário não poderá desabilitar um check-box no objeto Grid durante o runtime, a menos que todos os check-boxes precedentes na mesma coluna já estejam desabilitados. Essa opção é especialmente útil quando deseja-se obrigar o usuário a seguir uma seqüência pré-definida. Esse campo não está disponível quando o tipo Data Source for Class Tag.

* Show Header: Quando essa opção está habilitada, O cabeçalho do objeto Grid está visível durante o runtime, exibindo o nome de cada coluna.

* Show gridlines: Quando essa opção está habilitada, as linhas em grade do objeto Grid estão visíveis durante o runtime.

* Ext. translation: Quando essa opção está habilitada, o texto exibido pelo objeto Grid estará susceptível ao Ferramenta Translation durante o runtime.

* Disable TAB to navigate through cells: Quando essa opção está habilitada, o usuário poderá navegar somente através das células do objeto Grid com as teclas de seta e a tecla Tab. Você deverá desabilitar a tecla Tab para navegação caso você queria que essa seja utilizada para alternamento de valores para o próximo objeto que suporte foco na tela.

* Auto refresh after insert trigger: Ler Insert Trigger.

* Concatenate Label for picture: faz a seguinte junção entre o conteúdo da coluna Label com o conteúdo da coluna Field para definir o nome de uma


InduSoft Web Studio

Página 282

imagem a ser exibida em cada linha do grid. O nome fica na seguinte forma: <label>_<field>

* Export: Essa interface permite a exportação de dados do objeto grid para um tag class-array, apesar do Data Source selecionado para o objeto. Os seguintes campos deverão ser configurados para suporte a esse recurso:

Campo Descrição Class tag Digite o nome do tag principal do tag class-array o qual

receberá os valores exportados. Cada linha do objeto grid será exportada para uma posição array do tag array através da concordância de linhas. A posição inicial do array pode ser configurada nesse campo; 0 é o padrão.

Trigger Quando o tag configurado nesse campo altera seu valor (e.x. inverte-se), os dados são exportados do objeto Grid para o tag class-array configurado no campo Class tag.

Dicas: O recurso de Exportação (Export) é uma ferramenta poderosa e de fácil utilização para a transferência de dados a partir de diferentes data sources para tags. Após exportar os dados para os tags, pode-se utilizar diferentes tarefas para a manipulação de dados, como a função FileWrite() ou tarefas Recipe ou Report para salvar os dados em arquivos de texto (e.x. arquivos CSV).

• Botão Check Box Object ( ): Clique nesse botão para criar um objeto check box em sua tela.

O botão Check Box Object é útil na criação de interfaces onde usuários podem habilitar/desabilitar uma opção na tela. Para criar um Objeto Check Box:

Clique na área de desenho e arraste o mouse/cursor para desenhar o check box e escrever seu nome.

Solte o botão do mouse quando o tamanho do objeto esteja de acordo.


Diálogo Object Properties: Check Box

Utilize o diálogo Object Properties para especificar os seguintes parâmetros no Objeto Check Box:

Caption: Especifica o título, digitando o texto no text box.

Fonts: Especifica o estilo da fonte para o título, clicando-se no botão Fonts.

E-Sign: Quando essa opção está habilitada, o usuário será requisitado a inserir a Senha Eletrônica antes de executar o comando.


InduSoft Web Studio

Página 283

check-box Confirm: Clique (habilite) nesse box para assegurar-se de que o IWS requisitará a confirmação da ação em runtime.

Lista drop-down Key: Selecione um item da lista a ser associado a tecla do teclado com o objeto ou grupo de objetos. Pode-se então pressionar esse tecla para habilitar/desabilitar o check-box.

Clique (habilite) no box Shift, Ctrl, ou Alt para criar uma combinação de teclas, significando que as teclas Shift, Ctrl, ou Alt deverão ser pressionadas com o item especificado na lista drop-downt.

Clique (habilite) no box para abrir o diálogo Key Modifier, que habilita a modificação de sua combinação de teclas. Pode-se escolher Left, Right ou Left or Right para a especificação da posição no teclado das teclas Shift, Ctrl ou Alt na combinação de teclas. Caso você escolha Left or Right, o comando será executado a qualquer momento que essas teclas forem pressionadas em combinação com o item especificado na lista drop-down.


Campo Disable: Digite um tag ou expressão nesse campo para habilitar e desabilitar o objeto. O objeto check box é desabilitado ao inserir um valor diferente de 0.

Campo Security: Digite um valor nesse campo para especificar um nível de segurança para o objeto, como definido em Security. Quando um usuário efetua o log e não possui o nível de segurança especificado, o IWS desabilita o objeto.

Campo Tag: Quando o usuário clica no check box durante o runtime, o valor desse tag é atualizado. Caso nenhum feedback seja especificado, o valor desse tag também é utilizado para indicar o status atual do objeto.

True Value: Especifica um valor que será utilizado para alterar o estado TRUE e indicar que o controle está em estado TRUE. Para maiores informações sobre estados, leia a tabela states.

* Tri-State: Habilitar o controle significa ter o third state, o qual é exibido quando o tag configurado no campo Feedback assume o valor especificado no campo Tri-State. Caso o campo Feedback seja deixado em branco, o third state será exibido quando o tag configurado no campo Tag assume o valor especificado no campo Tri-State.

* Feedback: Valor que indica o estado do objeto (TRUE, FALSE ou Third-State). Caso o campo Feedback seja deixado em branco, o tag configurado no campo Tag será utilizado como o tag Feedback.

* Ext Trans.: Quando essa opção está habilitada, o título do objeto suporta a tradução.

* Force: Clique (habilite) nesse box para forçar o Tag Database a reconhecer uma alteração do tag quando o usuário clica no objeto, mesmo que o valor do tag em questão não seja alterado.

* Auto gray out: Faz com que o título do objeto seja exibido em cinza quando esse está desabilitado pelo campo Disable ou devido ao Sistema de Segurança.


InduSoft Web Studio

Página 284

* Enable Focus: Quando essa opção está habilitada, o objeto pode receber o foco durante o runtime através das teclas de navegação.

* Push Like: Quando essa opção está habilitada o controle é exibido como um Botão, ao invés da forma padrão: check box

* Fill Color: Especifica a cor de preenchimento para o botão. Essa opção é habilitada somente quando a opção Push Like está habilitada.

Existem dois modos de operação para esse objeto: Normal Mode e Tri-State Mode. Tais modos são descritos abaixo:

NORMAL MODE Quando a opção Tri-State está desabilitada, o objeto opera em Normal Mode, podendo assumir, portanto, somente dois estados:

Estado Forma Forma (tipo empurrar )

FALSE

TRUE

Estados para Normal Mode

Quando o valor do tag configurado em Feedback é igual ao valor configurado em True Value, o estado é configurado para TRUE. Do contrário, o estado é configurado para FALSE. Caso o campo Feedback seja deixado em branco, o tag configurado no campo Tag será utilizado como o tag de Feedback.

Quando o usuário clica no objeto, o tag configurado no campo Tag é atualizado de acordo com a seguinte tabela:

Status Atual Valor registrado para o tag configurado

no campo “Tag” quando o usuário clica no objeto

FALSE Valor configurado no campo True Value

field

TRUE NOT (Valor configurado no campo True

Value)

Nota: Quando o valor configurado em True Value é uma string, o tag configurado no campo Tag será invertido entre uma string vazio e o True Value. Caso o True Value seja deixado em branco, o tag configurado no campo Tag será invertido entre “UNSELECTED” e uma string vazia.


InduSoft Web Studio

Página 285

TRI-STATE MODE Quando a opção Tri-State está habilitada, o objeto opera em Tri-State Mode, podendo portanto, assumir três estados:

Estado Forma Forma

(Botão Tipo Empurrar)

FALSE

TRUE

TRI-STATE

Quando o valor do tag configurado em Feedback é igual ao valor do tag configurado em True Value, o estado é configurado para TRUE. Quando o valor do tag configurado em Feedback é igual ao valor do tag configurado em Tri-State, o estado é configurado para TRI-STATE. Quando nenhuma dessas condições são satisfeitas, o estado é configurado para FALSE. Caso o campo Feedback seja deixado em branco, o tag configurado no campo Tag será utilizado como o tag Feedback.

Atenção: O campo Tri-State não deverá ser configurado com o mesmo valor do campo True Value ou com uma string vazio.

Status Atual Valor registrado para o tag configurado

no campo “Tag” quando o usuário clica no objeto


TRUE NOT (Valor configurado no campo Tri-State)

TRI-STATE NOT (Valor configurado no campo True

Value)

Nota: Caso “NOT (Valor configurado no campo True Value)” seja igual a Tri-State, o valor assinalado para o tag configurado no campo Tag será o mínimo valor inteiro assinalado, diferente de True Value.

Quando True Value é uma string, “NOT (Valor configurado no campo True Value)” resultará em uma string vazia. Caso True Value seja uma string vazia, “NOT (Valor configurado no campo True Value)” resultará em “UNSELECTED”.


InduSoft Web Studio

Página 286

• Botão Radio Button Object ( ): Clique nese botão para criar um objeto check box na sua tela.

O Radio Button Object é útil para a criação de interfaces, onde o usuário pode escolher uma opção a partir da exibiçãa das opções mulDicale. Para criar um Radio Button Object:

Clique na área de desenho e arraste o mouse/cursor para desenhar o radio button e registrar seu nome.

Solte o botão do mouse quando o objeto estiver no tamanho desejado.


Diálogo Object Properties: Radio button

Utilize o diálogo Object Properties para especificar os seguintes parâmetros para o Radio button Object:

Caption: Especifica um título, digitando-se o texto em um text box.

Fonts: Especifica um estilo de fonte para o título, clicando-se no botão Fonts.

E-Sign: Quando essa opção está habilitada, o usuário será requisitado a inserir a Assinatura Eletrônica antes de executar o comando.

check-box Confirm: Clique (habilite) nesse box para assegurar-se de que o IWS requisitará a confirmação da ação em runtime.

Lista drop-down Key: Selecione um item da lista para associar uma tecla do teclado a um objeto ou grupo de objetos. Pode-se então pressionar essa tecla para habilitar/desabilitar o radio button.

Clique (habilite) no box Shift, Ctrl, ou Alt para criar um combinação de teclas, significando que as teclas Shift, Ctrl, ou Alt deverão ser pressionadas com o item especificado na lista drop-down.

Clique (habilite) no box para abrir o diálogo Key Modifier, que habilita a modificação de suas teclas combinadas. Pode-se escolher Left, Right ou Left or Right para especificar a posição das teclas Shift, Ctrl ou Alt no teclado na combinação de teclas. Caso você escolha Left or Right, o comando será executado sempre que essas teclas forem pressionadas em combinação com o item especificado na lista drop-down.


Campo Disable: Digite um tag ou expressão nesse campo para habilitar e desabilitar o objeto. Desabilita-se o objeto radio button ao inserir um valor diferente de 0.


InduSoft Web Studio

Página 287

Campo Security: Digite um valor nesse campo para especificar um nível de segurança para o objeto, como definido em Security. Quando um usuário efetua o log e não possui o nível de segurança especificado, o IWS desabilita o objeto.

Campo Tag: Quando o usuário clica no radio button durante o runtime, o valor desse tag é atualizado. Caso nenhum feedback for especificado, o valor desse tag também é utilizado para indicar o status atual do objeto.

True Value: Especifica um valor que será utilizado para alterar o controle para estado TRUE e indicar que o controle está em estado TRUE. Para maiores informações sobre estados, leia a tabela states.

Advanced: Pressione esse botão para abrir o diálogo Advanced:

Diálogo Advanced

* Tri-State: Se habilitado, o controle possui um estado third state. O third state será exibido quando o tag configurado no campo Feedback assume o valor especificado no campo Tri-State. Caso o campo Feedback seja deixado em branco, o third state será exibido quando o tag configurado no campo Tag assume o valor especificado no campo Tri-State.

* Feedback: Valor que indica o estado do objeto (TRUE, FALSE ou Third-State). Caso o campo Feedback seja deixado em branco, o tag configurado no campo Tag será utilizado como o tag Feedback.

* Ext Trans.: Quando essa opção está habilitada, o título do objeto suporta a tradução.

* Force: Clique (habilite) nesse box para forçar o Tag Database a reconhecer uma alteração de tag quando o usuário clicar no objeto, mesmo que o valor do tag em questão não se altere.

* Auto gray out: Faz com que o título do objeto seja exibido em cinza quando esse está desabilitado pelo campo Disable ou devido ao Sistema de Segurança.

* Enable Focus: Quando essa opção está habilitada, o objeto pode receber o foco durante o runtime através das teclas de navegação.

* Push Like: Quando essa opção está habilitada o controle é exibido como um botão, ao invés da forma padrão radio button.

* Fill Color: Especifica a cor de preenchimento para o botão. Essa opção é habilitada quando a opção Push Like está habilitada.


InduSoft Web Studio

Página 288

Existem dois modos principais de operação para o objeto: Normal Mode e Tri-State Mode. Tais modos são descritos abaixo:

NORMAL MODE

Quando a opção Tri-State está desabilitada, o objeto opera em Normal Mode. Portanto, poderá assumir somente dois estados:

Estado Forma Forma

(Botão Tipo Empurrar)

FALSE

TRUE

Estados em Normal Mode

Quando o valor do tag configurado em Feedback é igual ao valor do tag configurado em True Value, o estado é configurado para TRUE. Do contrário, o estado é configurado para FALSE. Caso o campo Feedback seja deixado em branco, o tag configurado no campo Tag será utilizado como o tag Feedback.

Ao clicar no objeto, o tag configurado no campo Tag é atualizado com o valor configurado no campo True Value.

TRI-STATE MODE Quando a opção Tri-State está habilitada, o objeto opera em Tri-State Mode. Portanto, pode assumir três estados:

State Shape Shape (Push Like)

FALSE

TRUE

TRI-STATE

Quando o valor do tag configurado em Feedback é igual ao valor do tag configurado em True Value, o estado é configurado para TRUE. Quando o valor do tag configurado em Feedback é igual ao valor do tag configurado em Tri-State, o estado é configurado para TRI-STATE. Quando nenhuma dessas condições são satisfeitas, o estado é configurado para FALSE. Caso o campo Feedback seja deixado em branco, o tag configurado no campo Tag será utilizado como o tag Feedback.

Atenção: O campo Tri-State não deverá ser configurado com o mesmo valor que o campo True Value ou com um valor vazio para string.


InduSoft Web Studio

Página 289

Status atual Valor escrito ao tag configurado no

campo “Tag” quando o usuário clica no objeto


TRUE NOT (Valor configurado no campo Tri-State)

TRI-STATE NOT (Valor configurado no campo True

Value)

Utilizando a Biblioteca Symbols são objetos (ou grupos de objetos) reutilizados, que podem ser armazenados para reaproveitamento. O IWS fornece acesso a uma extensa biblioteca de símbolos, o que habilita a adição e reutilização de símbolos de forma rápida e fácil. Pode-se também modificar símbolos existentes em apenas alguns segundos.

Da barra de menu, selecione View → Library para abrir a biblioteca a seguir de objetos e símbolos previamente configurados, incluindo vários objetos com dinâmicos:

Library

Pode-se adicionar símbolos a partir dessa biblioteca para a tela de sua aplicação, o que economiza tempo durante o desenvolvimento.

Nota:

Utilizar a opção de menu Library é o mesmo que utilizar o botão Library na barra de ferramentas padrão.


InduSoft Web Studio

Página 290

Para adicionar uma imagem à tela:

Clique em uma categoria, localizada no painel à esquerda, a fim de ter uma visualização prévia das imagens disponíveis.

Clique duas vezes em uma categoria para importar uma cópia da imagem a ser exibida na tela, a qual mantém seu imagem e fecha o diálogo Libraries.

Clique em qualquer lugar da tela para colocar a imagem selecionada.

Nota: A maioria dos símbolos possuem propriedades pré-definidas. Para alterar tais propriedades, utilize o tab Replace localizado no diálogo Object Properties. Pode-se adicionar uma tela configurada pelo usuário para a biblioteca Symbol. Desenvolva a tela como .scr e copie-a ao diretório \LIB onde o IWS foi instalado.

Utilizando Paste Link

A partir da barra de menu principal, selecione Edit → Paste Link para colar um objeto linked (somente arquivos .BMP) na tela ativa, enquanto mantém-se uma conexão a origem. Um linked object é uma informação (o objeto) criado em um arquivo de origem (outro projeto ou tela). Paste Link atualiza automaticamente um objeto de tela com link, sempre que você atualizar o arquivo de origem, embora o objeto de link não torne-se parte da tela. Caso você coloque um arquivo de link em uma pasta ou subpasta da aplicação, pode-se efetuar o download do arquivo com a Aplicação a estação de trabalho em runtime.

Nota: Essa opção não funcionará em aplicações Windows CE.

Pasta Symbols

A pasta Symbols contém uma coleção de símbolos definidos pelo usuário, as quais são grupos de imagens e/ou texto. Pode-se criar símbolos personalizados para a tela de exibição e salvá-los na pasta Symbols, como se segue.

Clique no ícone Group localizado na barra de ferramentas Object Editing.

Clique em um símbolo e depois selecione Edit → Copy to da barra de menu principal.

Quando abrir o diálogo Save As salve o novo símbolo na pasta Symbols.

Para utilizar um símbolo da pasta Symbol, selecione Edit → Paste from na barra de menu principal. O IWS importa uma cópia do arquivo selecionado automaticamente para a tela ativa.


InduSoft Web Studio

Página 291

Capítulo 8: Configurando Planilhas de Tarefas

Esse capítulo fornece informações sobre como configurar Planilhas de Tarefas. Uma task controla quantos tags diferentes no banco de dados podem ser utilizados em relação a sua aplicação.

Antes de continuar o desenvolvimento de sua aplicação, deve-se criar um script de forma a assimilar certas variáveis. Tais variáveis devem ser atualizadas constantemente, e por isso você deverá criar essa simulação em um planilha Math. Em uma aplicação de mundo real, essas variáveis poderiam ser provenientes de equipamentos de Campo, como um PLC ou um Soft Control.

Utilize o tab Tasks para acessar todas as planilhas de tarefas na aplicação atual.

Workspace: Tab Tasks

Esse tab contém as seguintes pastas de tarefas:

• Alarms: Contém planilhas Alarm utilizadas para configurar grupos de alarme e tags relacionados à aplicação. Pode-se também utilizar a tarefa Alarm para definir mensagens de alarme geradas pelo IWS.

• Trend: Contém as planilhas Trend utilizadas para grupos históricos que armazenam curvas de tendêncas para a aplicação. Pode-se utilizar a tarefa Trend para declarar quais tags devem possuir seus valores armazenados em disco, e para criar arquivos históricos para gráficos de tendências. O IWS armazena as amostras em um arquivo histórico binário (*.hst), e exibe ambos em amostras on-line, em uma tela de gráfico de tendências.

• Recipes: Contém as planilhas Recipe utilizadas para configurar como os dados são trocados entre o banco de dados da aplicação e arquivos de disco em formato ASCII ou DBF, além de como os valores são transferidos entre arquivos e memória em tempo real.

• Reports: Contém as planilhas Report utilizadas para configurar relatórios (tipo texto) que são enviados para impressora ou disco. Tarefas Report permitem a configuração de relatórios de texto com sistema de dados, os quais fazem a criação de relatórios uma tarefa mais simples e eficáz.

• ODBC: Contém as planilhas ODBC utilizadas para configurar como a interface ODBC roda em um ambiente da rede de trabalho e utilize configuração ODBC padrão do Windows. Pode-se configurar tarefas ODBC para trocar dados entre o IWS e quaisquer bancos de dados que suportem uma interface ODBC.

• Math: Contém as planilhas Math utilizadas para configurar e implementar rotinas adicionais para trabalhar com diferentes tarefas do IWS. O IWS executa planilhas Math como Background


InduSoft Web Studio

Página 292

Tasks durante o runtime. Pode-se configurar planilhas Math para prover ambientes livres para rotinas lógicas e cálculos matemáticos requeridos pela Aplicação.

• Script: Contém as planilhas Script utilizadas para configurar e implementar rotinas adicionais para trabalhar com diferentes tarefas do IWS. O IWS executa planilhas Scipt como Background Tasks durante o runtime. Esta relação é útil para inicializar variáveis ou executar lógicas que devem ser executadas quando a aplicação estiver iniciando.

• Scheduler: Contém as planilhas Scheduler utilizadas para configurar eventos utilizando expressões matamáticas definidas, as quais são executadas de acordo com hora, data ou outros eventos de monitoramento.

Para abrir planilhas Task para edição, clique duas vezes no Botão da tarefa e a planilha será exibida na janela Screen/Display.

Configurando uma Tarefa de Alarme A pasta Alarms habilita a configuração de grupos de alarme e tags relacionados a cada grupo. A tarefa Alarm define as mensagens de alarme geradas pelo IWS IWS. O propósito primário de um alarme é informar de quaisquer problemas ou alterações do estado durante o processo, de forma que você pode tomar atitudes a fim de corrigir erros.

Nota: Pode-se configurar essa tarefa para enviar alertas via email para indivíduo(s) designados, o que requer uma conexão à Internet (manualmente com a utilização de uma função dial-up automática) e deve-se executar a função CNFEmail (descrita em “Funções de Mail” no “Apêndice A: Funções do Studio”) do IWS para configurar o SMTP server, e o domínio antes de tentar enviar um email.

Para exibir mensagens de alarme na tela, deve-se criar um objeto de alarme clicando no Botão Alarm ( )

ou Alarm/Event Control ( ) na barra de ferramentas Active Objects. Para uma descrição mais detalhada, veja “Utilizando a Barra de Ferramentas Active Objects” no Capítulo 7: Configurando Telas e Gráficos.

Nota: O IWS incrementa seqüencialmente o número utilizado para identificar uma planilha Alarm para cada objeto criado recentemente na planilha.

Para criaram novo alalrme, utilize um dos métodos a seguir para abrir uma planilha Alarm:

• Clique com o Botão direito na pasta Alarm e selecione Insert do pop-up.

• Selecione File → New da barra de menu ou clique no Botão New na barra de ferramentas Standard para abrir o diálogo New Document. Selecione Alarm Worksheet, e clique em OK.


InduSoft Web Studio

Página 293

Planilha Alarm

A planilha Alarm é dividida em duas áreas:

• área Header (seção acima), que contém informações para todo o grupo

• área Body (seção inferior), onde você define cada tag em um grupo, suas condições de alarme e mensagens.

Utilize os parâmetros Header nessa planilha como se segue:

• Campo Group Name: Digite um nome para distinguir os grupos de alarme.

Atenção: Antes de alterar o Campo Group Name, salve a planilha Alarm, pois as configurações de alarme podem ser perdidas em uma planilha quando não são salvas.

• Campo Description: Digite uma descrição do grupo de alarme para fins de documentação.

• Botão Email Settings: Clique para configurar a aplicação para que essa envie um email automaticamente para pessoa(s) designada(s) quando um evento de alarme ocorre.

IMPORTANTE! Para utilizar esse recurso, deve-se estar conectado a Internet (manualmente ou utilizando uma função dial-up automática) e você deverá ter executado a função CNFEmail (descrita no “Apêndice A: Funções do Studio”) do IWS para configurar o SMTP server, nome do usuário, senha e domínio antes de tentar enviar um email.

O diálogo Email Settings aparecerá:


InduSoft Web Studio

Página 294

Diálogo Email Settings

Esse diálogo contém os seguintes parâmetros:

check-box Enable send automatic email: Clique (habilite) nesse box e digite os endereços de email nos Campos To (exigido), Cc (opcional), e Bcc (opcional) para enviar automaticamente uma mensagem de email para o receptor (en)quando ocorrer um alarme.

Botão Use alarm message: Clique (habilite) nesse Botão para utilizar a mensagem verdadeira de alarme na linha “assunto” do email.

radio button e Campo Custom: Clique (habilite) nesse Botão para inserir e utilizar a linha de assunto como você desejar no email de alarme. Digite o texto na linha de assunto no Campo fornecido.

check-box Send 1 message by email (disponível somente quando você seleciona Custom): Clique (habilite) esse Botão para enviar cada notificação de mensagem de alarme em um email separado. (Por exemplo, caso haja três alarmes, o IWS enviará três emails.)

Esse parâmetro está desabilitado por padrão, o que significa que o IWS enviará todas as mensagens de alarme para receptor designado em um único email.

check-box Remove failed messages from the buffer: Clique (habilite) esse Botão para remover mensagens de alarme do buffer quando a notificação de alarme falhar (não pôde ser entregue).

Painel Send email when alarm is: Clique (habilite) um ou mais dos check-boxes nessa área para salvar um email automaticamente quando o alarme torna-se ativo (active), quando alguém toma conhecimento do alarme (ack), e/ou quando o alarme é normalizado (norm).

Campo Current Status: Digite um tag para receber o status atual do alarme.

Campo Error: Digite um tag para receber o erro que causou o alarme.

Nota: Veja “GetStatusSendEMailExt(optTagName)” no “Apêndice A: Funções do Studio” para uma descrição dos valores retornados para os Campos Current Status e Error.

painel Message Format: Utilize os parâmetros desta área para formatar as mensagens de saída de email

* Clique em um ou mais desses check-boxes para incluir Day, Month, Year, Hours, Minutes, Seconds, e/ou MS (millissegundo) de quando o evento de alarme ocorreu.


InduSoft Web Studio

Página 295

* Clique em um ou mais desses itens na lista Items para incluir a informação de alarme na mensagem de email

* Clique nos radio buttons Space, Tab, ou Other para especificar que tipo de separador utilizar entre elementos da mensagem de evento de alarme

Campo Send trigger: Digite um tag nesse Campo e quando o valor do tag for alterado, o IWS verificará todos os eventos ativos de alarme. Caso haja qualquer evento de alarme do qual uma notificação de alarme não tenha sido enviada, o IWS envia automaticamente uma mensagem de notificação por email para o receptor(es) designado(s).

Campo Max buffer size: Digite um valor para especificar o número máximo de mensagens de alarme para armazenar no buffer. Caso o número de mensagens exceda esse valor, o IWS utiliza o algorítimo FIFO (first in-first out) para gerenciar o buffer, deletando a mensagem mais antiga sempre que ocorrer uma nova mensagem. A capacidade padrão do buffer é de 16,000 mensagens. (Note: Esse Campo também aceita um tag.)

Campo Buffer size: Digite um tag para exibir números de mensagens de alarme que estão atualmente no buffer. (o IWS reinicia esses números após enviar a notificação de email.)

Campo Clear Buffer: Digite um tag para limpar o buffer. Quando o valor de tags se alterar, o IWS deleta todas as mensagens atuais no buffer.

Campo Disable send: Digite um tag para desabilitar o recurso de envio de email. Quando o valor desse tag for verdadeiro (um valor maior que zero), o IWS pára de enviar mensagens existentes ou novas para o buffer.

Após configurar os parâmetros email clique em OK para fechar o diálogo e retornar para a planilha Alarms.

Nota: Os arquivos de email de alarme salvos podem ser identificados pela extensão .aem. Em versões anteriores do IWS, esses arquivos carregavam a extensão .eml; entretanto, vários firewalls bloqueiam automaticamente arquivos *.eml, e esses não podem ser convenientemente baixados para estações remotas através de um firewall..

Na planilha Alarms, continue configurando os parâmetros Header como se segue:

Botão Advanced:

• Campo Disable: Digite um tag para habilitar/desabilitar todos os alarmes no grupo.

Digite um valor maior que zero para desabilitar o grupo e as mensagens de alarme.


InduSoft Web Studio

Página 296

Deixe o Campo em branco ou digite zero para habilitar o grupo

• Campo Total Alarms: Insira um tag inteiro para receber um valor denotando o número total de alarmes ativos (reconhecidos ou não) e alarmes normalizados não reconhecidos.

Quando um alarme retorna ao estado normalizado e foi reconhecido, os módulos de Alarme do IWS não incluirão aquele tag na contagem total.

• Campo Total UnAck: Insira um tag inteiro para receber um valor denotando o número total de alarmes desconhecidos, apesar do estado do alarme (ativos ou normalizados).

Quando um alarme foi reconhecido, o módulo Alarms do IWS logo inclui aquele alarme na contagem total.

A tabela a seguir é fornecida para ilustrar como o módulo Alarms do IWS faz a contagem de mensagens de evento de alarmes para os Campos Total Alarms e Total UnAck:

Estado do Alarme

Estado de Reconhecimento

Contagem para Total de tags Alarm?

Contagem para Total de UnAck Tag?

Inrreeconhecido Sim Sim Ativo

Reconhecido Sim Não

Inrreeconhecido Sim Sim Normalizado

Reconhecido Não Não

Nota: Recomendamos a utilização de nomes de tags únicos para os Campos Total Alarms e Total UnAck para cada planilha Alarms.

Campo Remote Ack Trigger: Quando o valor do tag nesse Campo se altera, todo o grupo terá conhecimento.

área Dead Band Time (sec): Especifica os seguintes parâmetros.

Campo Activation: Insira um número para designar o mínimo de tempo, em segundos, que o tag deverá estar em condição de alarme antes de considerar-se ativo.

Campo Normalization: Insira um número para designar o número de segundos que o tag deverá ficar fora da condição de alarme antes de considerar-se normal novamente.

Box Time Stamp/Value: Cada alarme mantêm um time stamp da última atividade significativa, junto com o valor do Tag naquele tempo. Você pode selecionar o tipo de atividade que atualiza o time stamp:

Activation/Norm (default): O tempo quando a dead band terminou — que é, quando o alarme se tornar ativado ou normalizado.

Last Tag Change: O tempo em que o valor do Tag mudou por último durante o dead band.

Start Condition: O tempo em que a dead band começou.

área On Line: Especifica os seguintes parâmetros.


InduSoft Web Studio

Página 297

check-box Display in Alarm Controls: Quando selecionado, envia mensagens de alarme para um objeto de alarme na tela.

Atenção: Caso você não tenha selecionado a opção Display in Alarm Controls, os alarmes para esse grupo não aparecerão nos objetos de alarme nas telas e impressão durante a execução.

check-box Ack Required: Requer o reconhecimento de mensagens de alarme. Disponíveis somente se o Campo Display in Alarm Controls estiver habilitado.

check-box Beep: Soa o beep até que o alarme tenha sido reconhecido. Disponível somente se os Campos Ack Required e Display in Alarm Controls estiverem habilitados.

check-box Send to Printer: Envia uma mensagem de alarme desse grupo para a impressora, incluindo impressoras remotas. Pode-se utilizar essa opção somente com uma inpressora matriz (ou qualquer impressora que imprima linha por linha).

Atenção: O check-box Send to Printer não deve ser utilizado com impressoras DeskJet ou LaserJet, pois essas utilizam uma página inteira de papel para cada mensagem de alarme. Tais impressoras não são capazes de imprimir apenas uma linha e esperar pelo próximo comando de impressão.

– check-box Save to Disk: Envia mensagens de alarme desse grupo para um arquivo do disco rígido. Deve-se selecionar essa opção caso você deseje objetos históricos de alarme.

– check-box Generate Ack Messages: Gera mensagens sempre que alarmes desse grupo são reconhecidos. Disponível somente se os Campos Save to Disk ou Send to Printer estiverem habilitados.

– check-box Generate Norm Message: Gera mensagens sempre que alarmes desse grupo retornam aos seus estados normais. Disponível somente se os Campos Save to Disk ou Send to Printer estiverem habilitados.

área Colors in Alarm Controls: Especifica os seguintes parâmetros para definir cores dos alarmes para um objeto de alarme. O IWS exibe cada objeto de alarme em uma mensagem de alarme utilizando as cores especificadas para os grupos.

check-box Enable color: Clique para especificar cores.

* retângulo Activation: Clique FG para selecionar uma cor para o texto das mensagens de alarme e BG para selecionar uma cor para o fundo do texto do alarme.

* retângulo Acknowledgment: Clique FG para selecionar uma cor para o texto das mensagens de reconhecimento e BG para selecionar uma cor para o fundo do texto da mensagem de reconhecimento.

* retângulo Normalization: Clique FG para selecionar uma cor para o texto de mensagens de normalidade e BG para selecionar uma cor para o fundo do texto de normalidade.

Quando aparecer o diálogo Color, clique em uma cor e selecione-a. A seguir, feche o diálogo.


InduSoft Web Studio

Página 298

Utilize os parâmetros Body desta planilha como se segue:

• Campo Tag Name: Digite um tag a ser monitorado pelo grupo de alarme.

• Lista drop-down Type: Clique para selecionar um dos seguintes tipos de alarmes. (Pode-se alterar quaisquer desses Campos no módulo de runtime. Para informações adicionais, veja Capítulo 5: Trabalhando com Tags.)

HiHi: Limite de alarme muito alto; gera uma mensagem de alarme quando o valor do tag está igual ou maior que o valor HiHi Limit.

Hi: Limite de alarme alto; gera um alarme quando o valor do tag está igual ou maior que o valor Hi Limit.

Lo: Limite de alarme baixo; gera um valor de tag quando o valor do tag está mais baixo ou igual ao valor Lo Limit.

LoLo: Limite de alarme muito baixo; gera um alarme quando o valor do tag está mais baixo ou igual ao valor LoLo Limit.

Rate: Determina a velocidade da taxa de variação de um tag. Caso a velocidade de variação esteja maior que aquela estabelecida nesse Campo, um alarme será gerado. A velocidade pode ser determinada em segundos, minutos ou horas.

Deviation+: Derivação de uma valor mais alto; gera um alarme quando um aumento no valor do tag é igual ou maior que o limite estabelecido.

Deviation–: Derivação de um valor mais baixo; gera um alarme quando uma diminuição no valor do tag é igual ou maior que o limite estabelecido.

• Campo Limit: Digite um valor para geração de um alarme limite.

• Campo Message: Digite uma mensagem de alarme a ser exibida.

Atenção: Mensagens de alarme podem conter o valor de qualquer tag utilizando-se a sintaxe: message {tag_name}.

• Campo Priority: Digite um número inteiro (de 0 a 255) para indicar a prioridade junto ao grupo. Tags com prioridade alto possuem valor de prioridade maior.

• Campo Selection: Digite um string para filtro nos objetos de resumo de alarme.

Atenção: O Campo Selection deve conter um string com um máximo de 7 caracteres (outros caracteres não serão considerados).

• Alarm summary: Ao habilitar o arquivo de históricos do alarme para um grupo, o IWS salva o arquivo como ALyymmdd.ALH no diretório \app\ALARM da aplicação.

Quando yymmdd referir-se ao ano, mês e dia, o arquivo foi criado.

O IWS salva o arquivo históricos de alarme no seguinte formato:

Alarm Summary P1|P2|P3|P4|P5|P6|P7|P8|P9|P10|P11|P12|P13|P14|P15|P16|P17|P18|P19|P20|P21|P22|P23 P1|P2|P3|P4|P5|P6|P7|P8|P9|P10|P11|P12|P13|P14|P15|P16|P17|P18|P19|P20|P21|P22|P23


InduSoft Web Studio

Página 299

.

.

. P1|P2|P3|P4|P5|P6|P7|P8|P9|P10|P11|P12|P13|P14|P15|P16|P17|P18|P19|P20|P21|P22|P23

Onde os valores são os seguintes:

P1 = Versão do arquivo (Current → 003)

P2 = Data de Início (DD/MM/YYYY)

P3 = Hora de Início (HH:MM:SS)

P4 = Nome do Tag

P5 = Mensagem de Alarme

P6 = Ack onde,

. 0 Indica que o alarme foi reconhecido ou não exige reconhecimento

P7 = Ativo, onde

. 0 Indica que o alarme não está ativo

. 1 Indica que o alarme está ativo

P8 = Valor Limite

P9 = Número do Grupo de Alarme

P10 = Número de Prioridade

P11 = Seleção

P12 = Tipo, onde

. 1 is HiHi

. 2 is Hi (On)

. 4 is Lo (Off)

. 8 is LoLo

. 16 é Rate (Change)

. 32 é Derivação+

. 64 é Derivação-

P13 = AckReq, onde

. 0 Requer reconhecimento (Ack)

. 1 Não requer reconhecimento

P14 = Data de Normalização (DD/MM/YYYY)

P15 = Hora de Normalização (HH:MM:SS)

P16 = Ack Date (DD/MM/YYYY)

P17 = Ack Time (HH:MM:SS)

P18 = Nome do Usuário (esse Campo só existirá se P1 ≥ 001)

P19 = Comentário (esse Campo só existirá se P1 ≥ 001)

P20 = Nome Completo do Usuário (esse Campo só existirá se P1 ≥ 002)

P21 = Station (esse Campo só existirá se P1 ≥ 002)

P22 = Valor Anterior

P23 = Diferença de Tempo (Bias)

Utilize o combo-box History Format para salvar dados de alarme no formato de arquivo Proprietary history do IWS ou de um banco de dados SQL relacional. As opções para ambos são as seguintes:


InduSoft Web Studio

Página 300

• Proprietary

– File Format: Texto (UNICODE). O IWS utiliza o caractere barra vertical (|) para separar os Campos.

– Default Path: …\<Aplication Path>\Alarm\ALYYMMDD.ALH , onde:

YY = Dois últimos dígitos do ano MM = Mês DD = Dia

Database

– Database Type: Escolhido pelo usuário

– Default Table Name: AlarmHistory

A informação salva no arquivo histórico é descrita na seguinte tabela:

Nome do Campo

Tipo de Dados

Caracteristicas

Version Integer Ese Campo é criado quando o Formato de Arquivo é Prioritário. Versão atual: 003

Start_Time TimeStamp

Timestamp indicando quando o alarme é iniciado.

Quando o Formarto de Arquivo é Prioritário, o IWS salva a Data (MM/DD/YYYY) em um Campo e a Hora (HH:MM:SS.MSS) no próximo Campo.

Tag String Nome do tag

Message String Mensagem de alarme

Ack Boolean

0: Indica que o alarme foi reconhecido ou que não requer reconhecimento

1: Indica que o alarme não foi reconhecido

Active Boolean 0: Indica que o alarme está inativo

1: Indica que o alarme está ativo

Value Real Valor do tag quando o alarme de evento ocorreu

Group Integer Número do grupo do alarme

Priority Integer Número de prioridade do alarme

Selection String Valor de Seleção do Alarme

Type Integer

1: HiHi

2: Hi(On)

4: Lo(Off)

8: LoLo

16: Rate(Change)

32: Deviation+

64: Deviation-

Ack_Req Boolean 0: Requer reconhecimento (Ack)

1: Não requer reconhecimento

Norm_Time TimeStamp

Timestamp indicando que o alarme está normalizado.

Quando o Formato do Arquivo é Prioritário, o IWS salva a Data (MM/DD/YYYY) em um Campo e a Hora (HH:MM:SS.MSS) no próximo Campo.


InduSoft Web Studio

Página 301

Ack_Time TimeStamp

Timestamp indicando que o alarme foi reconhecido.

Quando o Formato do Arquivo é Prioritário, o IWS salva a Data (MM/DD/YYYY) em um Campo e a Hora (HH:MM:SS.MSS) no próximo Campo.

User String Usuário logado quando o evento de alarme ocorreu. Esse Campo existe somente para Versão >=1

Comment String Comentário (opcional) digitado pelo operador quando o alarme é reconhecido. Esse Campo existe somente para Versão >=1

User_Full String Nome complete do usuário logado quando um evento de alarme ocorreu. Esse Campo existe somente para Versão >=2

Station String Nome da estação (computador) o evento de alarme ocorreu. Esse Campo existe somente para Versão >=2

Previous_Value Real Valor do tag que ocorreu antes do evento de alarme. Esse Campo existe somente para Versão >=3

Deleted Boolean

0: Mensagem de alarme não foi deletada

1: Mensagem de alarme foi deletada

Esse Campo é criado somente quando o Formato de Arquivo é Banco de Dados.

Bias Integer Diferença (em minuto) das colunas Time Stamp e o período GMT. Esse Campo existe somente para Versão >=3

Last_Update TimeStamp

Time Stamp quando o registro foi criado/modificado. Esse Campo é utilizado para sincronizar os bancos de dados ao utilizar o Banco de Dados Secundário adicionado ao Banco de Dados Primário. Esse Campo é criado somente quando File Format é Database.

Dica:

Ao salvar Alarmes Históricos em um Banco de Dados SQL Relacional (Formato do Arquivo = Database), pode-se costumizar o nome das colunas criados em um banco de dados editando o arquivo <AplicaçãoName>.APP, como se segue:

[Alarm]

<DefaultName>=<NewName>

Por exemplo:

[Alarm]

Message=Alarm_Message

Ack=Acknowledgment

Para informações detalhadas sobre como salvar arquivos históricos de alarme, incluindo instruções para parâmetros de configuração do banco de dados, veja Capítulo 17: Interface de Banco de Dados do IWS.


InduSoft Web Studio

Página 302

Configurando uma Tarefa Trend A pasta Trend habilita a configuração de grupos históricos para armasenamento de curvas de tendências. Pode-se utilizar a tarefa Trend para declarar quais tags devem ter seus valores armazenados em disco, além de criar arquivos históricos para gráficos de tendências. O IWS armazena as amostras em arquivo histórico binário (*.hst), e exibe ambos os arquivos históricos em amostras online, em um gráfico trend em tela.

Para exibir um gráfico trend em tela, clique na ferramenta Trend na barra de ferramentas Active Objects para criar um objeto de trend.

Utilize um dos seguintes métodos para inserir uma nova planilha Trend:

• Clique com o Botão direito na pasta Trend e selecione Insert do pop-up.

• Selecione File → New da barra de menu ou clique na ferramenta New na barra de ferramentas Standard para exibir o diálogo New Document. Clique em Trend Worksheet, e clique em OK.

Uma nova planilha aparecerá, como se segue:

Planilha Trend

A planilha Trend é dividida em duas áreas:

• área Header área (seção superior), que contém informações para todo o grupo

• área Body (seção inferior), onde define-se cada tag no grupo. Essa seção contém várias colunas (Apenas duas são exibidas na figura anterior).

Utilize os parâmetros Header nessa planilha, como se segue:

• Campo Description: Digite uma descrição da planilha para fins de documentação.

• combo-box Type: Clique no Botão de seta para selecionar um tipo de trend da lista. As seguintes opções estão disponíveis:

– Proprietary

* File Format: Binário

* Default Path: …\<Aplication Path>\Hst\GGYYDDMM.HST , onde:



InduSoft Web Studio

Página 303

Nota: O IWS fornece os programas HST2TXT.EXE e TXT2HST.EXE que habilitam a conversão de arquivos históricos de trends salvos em formato de propriedade (.hst) para arquivos de texto (.txt) e vice versa. Para maiores informações sobre esses programas, veja “Convertendo Arquivos Históricos de Trend de Binário para Textoo” na página 310 e “Convertendo Arquivos Históricos Trend de Texto para Binário,” na página 311.

– Database

* Database Type: Escolhido pelo usuário

* Default Table Name: TRENDGGG (GGG = Trend Worksheet Number – e.g. TREND001 for the Trend Worksheet 001)

Note: Para maiores informações sobre a estrutura da tabela do Banco de Dados que o IWS utiliza para salvar arquivos históricos, veja “Dados Salvos em Arquivo Histórico de Trend”.

Database Configuration: Abre o diálogo Database Configuration para inserir as configurações requisitadas para estabelecer o link entre o IWS e um Banco de Dados Relacional SQL Externo, para salvamento de históricos de tendências.

Janela Database Configuration

combo-box Database: Permite selecionar tanto Primary quanto Secondary. Em Primary, todas as configurações exibidas na janela Database Configuration aplicam-se a interface do Banco de Dados Primário. De outra forma, será aplicado a interface do Banco de Dados Secundário. Pode-se configurar o banco de dados Secundário nos seguintes módulos:

Disabled: Nesse módulo, o IWS salva dados somente em Banco de Dados Primário. Caso esse esteja indisponível por qualquer razão, os dados não são salvos em nenhum outro local. Essa opção pode causar perda de dados, caso o Banco de Dados Primário não estiver disponível.

Redundant: Nesse módulo, o IWS salva dados tanto em Banco de Dados Primários quanto Secundários. Caso um destes esteja indisponível por qualquer razão, o IWS mantém os dados salvos naquele que está disponível. Quando o banco de dados, antes indisponível tornar-se apto novamente, o IWS sincroniza ambos os bancos de dados automaticamente.


InduSoft Web Studio

Página 304

Store and Forward: Nesse módulo, O IWS salva dados somente em Banco de Dados Primários. Caso esse tornar-se indisponível, o IWS salva os dados no Banco de Dados Secundário. Quando o Banco de Dados Primário tornar-se apto novamente, o IWS move os dados do Banco de Dados Secundário para o Primário.

Utilizando O Banco de Dados Secundário, pode-se aumentar a realística do sistema e utilizar o Banco de Dados Secundário como um backup quando o Banco de Dados Primário não estiver disponível. Essa arquitetura é particularmente útil quando o Banco de Dados Primário estiver localizado na estação remota. Nesse caso, pode-se configurar um Banco de Dados Secundário na estação local para salvar dados temporariamente, caso o Banco de Dados Primário não esteja disponível (durante uma falha na rede de trabalho, por exemplo).

– combo-box Use Aplicação default: Quando esta opção está habilitada, o IWS utiliza os parâmetros configurados no Banco de Dados Padrão para a tarefa que está sendo configurada (Connection string, User name, Password, Retry Interval e Advanced Settings). Quando não habilitada, pode-se configurar esses parâmetros individualmente a tarefa atual.

– Campo Connection string: Esse Campo define o banco de dados onde o IWS registrará e lerá valores, assim como os parâmetros principais utilizados ao conectar-se ao banco de dados. Ao invés de registrar a Connection string manualmente, pode-se pressionar o Botão browse (…) e selecionar o tipo de banco de dados, na janela Data Link Properties.

Nota:

A Lista de Fornecedores de Banco de Dados mostrada na janela Data Link Properties depende dos fornecedores instalados e disponíveis no computador onde o IWS estiver rodando. Consulte a documentação do sistema operacional (ou a documentação do banco de dados) para maiores informações sobre as


InduSoft Web Studio

Página 305

configurações do Fornecedor para o Banco de Dados que está sendo utilizado.

– Campo name: Nome do usuário para conectá-lo ao banco de dados. O user name

configurado nesse Campo deve estar de acordo com aquele já configurado no banco de dados.

– Campo Password: Senha utilizada para conectar-se ao banco de dados. A senha configiurada nesse Campo deve estar de acordo com aquela configurada no banco de dados.

– Campo Retry Interval: Caso o IWS estiver indisponível para conectar-se ao banco de dados por qualquer razão, automaticamente será reiniciada a conexão após o número de segundos configurado nesse Campo.

– Botão Advanced: Após pressionar esse Botão, você terá acesso a algumas configurações costumizáveis. Para a maioria das aplicações, o valor padrão dessas configurações não necessitam ser modificados, e devem continuar os mesmos.

* combo box Milliseconds: Pode-se configurar como os milissegundos serão salvos quando os dados estão sendo salvos no banco de dados. Cada banco de dados salva a data em um formato diferente; Por exemplo, alguns bancos de dados não suportam milissegundos em um Campo Date. As opções a seguir estão disponíveis:

• Default: Utiliza o formato pré-definido para banco de dados atual. Os banco de dados previamente testados pela InduSoft são configurados para a opção mais cabível. Ao selecionar Default, o IWS utiliza os parâmetros pré-configurados para o tipo de banco de dados atual. Caso você esteja utilizando um banco de dados que não tenha sido previamente configurado pela InduSoft, a opção Default tentará salvar os milssegundos em um Campo separado.

Dica:

A opção padrão para cada banco de dados é configurada no arquivo StudioADO.ini, armazrnado na subpasta \BIN do IWS. Veja a seção Studio Database Gateway para informações sobre como configurar o arquivo StudioADO.ini.

Disable: Não salva os milissegundos ao salvar a data no banco de dados.

Enable: Salva os milissegundos no mesmo Campo onde a data foi salva.


InduSoft Web Studio

Página 306

Separate Column: Salva os milissegundos em uma coluna separada. Nesse caso, a data é salva em um Campo (sem a precisão de milissegundos) e o número de milissegundos é salvo em uma coluna diferente. Essa opção é indicada onde você deseja salvar timestamps com a precisão de milissegundos, apesar de o banco de dados que você está utilizando não suportar milissegundos nos Campos Date.

* check-box Save time difference: Quando essa opção está habilitada, (padrão), o IWS salva o Time Zone configurado no computador onde a aplicação está rodando, em cada registro do banco de dados. Essa opção deve estar habilitada para evitar problemas com salvamento de horas.

* Database Gateway: Insira o Endereço Host Name/IP onde o Studio database gateway estará rodando. O número TCP Port também pode ser especificado, mas caso você não esteja utilizando o padrão, você terá que configurar o Studio database gateway com o mesmo TCP Port. Veja “Studio Database Gateway” para informações sobre como configurar o Studio ADO Gateway.

* Disable Primary Key: Para alguns módulos, o IWS tentará definir uma tecla primária para a tabela de forma a aumentar a velocidade das solicitações. Caso você esteja utilizando um banco de dados que não suporte teclas primárias (e.x. Microsoft Excel), deve-se habilitar esse Campo.

– Painel Table: Essa área permite a configuração de parâmetros da Tabela onde os dados serão salvos. Todas as tarefas podem compartilhar um mesmo banco de dados. Porém, cada tarefa (planilhas Alarm, Events, Trend) devem possuir um link a sua própria Tabela. O InduSoft não habilita configirações inválidas nesse Campo, portanto você deverá certificar-se de que a configuração é adequada para o banco de dados utilizado.

– check-box Use default name: Quando essa opção está habilitada (padrão), o IWS salva e/ou entrega os dados para a Tabela com o nome padrão, escrito no Campo Name.

– check-box Automatically create: Quando essa opção está habilitada (padrão), IWS cria uma tabela com o nome escrito no Campo Name automaticamente. Caso esta opção não esteja habilitada, o IWS não cria a tabela de forma automática. Portanto, não será capaz de salvar dados no banco de dados, a menos que você tenha configurado a tabela com o nome configurado no Campo Name manualmente no banco de dados.

– Name: Especifica o nome da Tabela do banco de dados onde os dados históricos serão salvos.

– Botão Refresh: Caso o banco de dados configurado esteja disponível atualmente, pode-se pressionar o Botão Refresh para preencher o combo-box Name com o nome das tabelas atualmente disponíveis no banco de dados. Dessa forma, pode-se selecionar a tabela onde os dados históricos poderão ser salvos ao em vez de escrever o nome da tabela manualmente no campo Name.

• Painel Run-Time: Essa área permite inserir tags do IWS. Os seguintes Campos estão disponíveis:

– check-box Status (output): O tag nesse Campo receberá um dos seguintes valores:

Valor Descrição

0 Desconectado do banco de dados. O banco de dados não está disponível ou sua configuração está incorreta.

1 O banco de dados foi conectado com sucesso.

2 O banco de dados está sendo sincronizado.


InduSoft Web Studio

Página 307

– Reload (output): Caso você esteja utilizando colchetes em quaisquer dos Campos de configuração, deverá ser especificado o tag de recarregamento. Quando você deseja reconectar-se ao banco de dados utilizando os valores atualizados de seus tags, configure o tag nesse Campo como 1. O IWS atualizará a configuração ao tentar executar um ação no banco de dados e configurará o tag de volta a 0 quando estiver terminado.

Para instruções para configurar um banco de dados padrão para todos os históricos de tarefas (Alarm, Event and Trend), veja Configurando um Banco de Dados Padrão para Todos os Históricos de Tarefas 160.

Para maiores informações sobre como salvar históricos Trend history, incluindo uma explicação dos arquivos salvos, veja Capítulo 17:Interface do Banco de Dados do IWS.

• Painel Save Options: Utilize os parâmetros a seguir para definir quando e como salvar arquivos históricos de trend:

* check-box e Campo Save On Trigger: Clique (habilite) e digite o nome de um tag para salvar amostras de trends quando alguém alterar um tag específico. (Alteração de Tag pode ser um evento de Scheduler.)

* check-box Save On Tag Change: Clique (habilite) para salvar sempre a amostra de trend, quando a alteração de um valor ocorrer em qualquer dos tags daquele grupo.

• Botão Advanced: Clique para exibir a janela a seguir:

Janela Trend Advanced Settings

Painel Batch: O painel Batch fornece os seguintes Campos:

* Start/Stop (input): Insira o tag para iniciar/parar seus batches. Quando o tag nesse Campo está configurado para TRUE (diferente de 0), o IWS iniciará o salvamento de dados para seu arquivo batch (caso você esteja utilizando o formato de propriedade), ou adicionará um novo registro para a tabela BatchHistory em seu banco de dados, indicando que um batch foi iniciado. Note que dados históricos serão salvos de acordo com a configuração nos Campos Save Trigger e Save On Tag Change nas opções da planilha Trend.

* Campo Name (input): Esse Campo representa o nome de batch; seu significado depende do formato selecionado na Planilha Trend:

Caso você tenha selecionado Proprietary no Campo Type, Name deverá ser compilado com formato [Path]<FileName>, onde:

Path: Um Campo opcional. Caso caminho não esteja especificado, o arquivo histórico de batch será armazenado no mesmo caminho do arquivo <Aplicação>.app.

FileName: Nome do arquivo histórico de batch.


InduSoft Web Studio

Página 308

Caso você tenha selecionado Database no Campo Type, o valor nesse Campo será armazenado no Campo Batch_Name da tabela BatchHistory.

Dica:

Pode-se inserir nomes de tags entre colchetes nesse Campo (e.x. C:\MyBatches\{MyTagWithName}{MyTagWithNumber}.hst).

* Delete (input): Quando o tag especificado nesse Campo altera seu valor, o batch será deletado. Com o formato Proprietary, o arquivo histórico de batch será removido. Com o formato Database, será configurado no Campo Delete na tabela BatchHistory para “verdadeiro”, embora os dados históricos salvos permaneçam os mesmos. O objeto Trend vê somente batches que tenham o Campo delete configurado para 0 (zero).

* Existent (output): O tag inserido nesse Campo receberá o valor 1, caso o batch especificado no Campo Name já exista, de outra forma, tag receberá o valor 0.

* Description (output): Esse Campo está disponível somente ao utilizar o formato Database. Quando o tag no Campo Start/Stop altera-se para TRUE, o registro adicionado para a tabela BatchHistory exibirá o string nesse Campo.

Dica:

Pode-se inserir nomes de tags entre colchetes nesse Campo (e.x. {MyTag}).

* Save data even if batch is not Running: Caso esse Campo não esteja habilitado, os dados históricos serão salvos somente quando o tag no Campo Start/Stop estiver como TRUE.

Dica:

Os dados Históricos de Batch podem ser exibidos para o usuário em formato Gráfico ou Tabela. As seções de objeto Trend e Grid explicam como exibir informações nesses formatos.

Painel Disk Space Control: Estão disponíveis as seguintes opções:

* History Life Time (days): Especifica quantos dias manter o arquivo histórico em disco. Após o período especificado, o IWS apaga o arquivo automaticamente. Utilize essa opção somente para arquivos baseados em datas.

* Campo Compress After (days): Especifica quantos dias manter o arquivo histórico de trend em disco (*.hst) antes de comprimir o arquivo. Após o período especificado, o IWS comprime o arquivo automaticamente. Utilize essa opção somente para arquivos baseados em uma data. Essa opção não está disponível para aplicações em WinCE.

* Disable All Data Saving: Insira um tag nesse Campo. Quando o valor desse tag for TRUE (diferente de zero), a tarefa trend pára de gravar dados nessa planilha.

Utilize os parâmetros Body na planilha Trend como se segue:

• Campo Tag Name: Digite o nome do tag a ser salvo no arquivo histórico.

Atenção: Após adicionar ou remover tags de uma planilha Trend, quaisquer arquivos históricos (*.HST) previamente criados não serão compatíveis com a nova configuração. Conseqüentemente, os dados desses arquivos históricos não serão exibidos pelo objeto trend.


InduSoft Web Studio

Página 309

• Campo Dead Band: Digite um valor para filtrar alterações aceitáveis quando Save on Tag Change for utilizado. Por exemplo, Dead Band possui valor = 5. Caso o valor do tag for 50 e altera-se para 52, o sistema não registrará essa variação em um banco de dados, pois esse é menor que 5. Caso a alteração seja igual ou maior que 5, o novo valor será salvo no arquivo histórico.

• Field: Nome do Campo no banco de dados onde o tag será armazenado. Caso esse Campo esteja em branco à esquerda, o nome do tag será utilizado como tag name. Tags Array tags e Classes terão os caracteres ‘[’ , ‘]’ e ‘.’ substituídos por ‘_’.

• Exemplos:

Nome do Tag Campo Padrão

MyArray[1] MyArray_1

MyClass.Member1 MyClass_Member1

MyClass[3].Member2 MyClass_3_Member2


InduSoft Web Studio

Página 310

Convertendo Arquivos Históricos de Trend de Binário para Texto

Por padrão, o IWS salva arquivos históricos de trend em um formato binário (.hst). Caso você deseje possuir esses arquivos em formato .txt, o IWS fornece o programa hst2txt.exe para converter arquivos históricos de trend de formato binário para texto.

Para converter um arquivo, siga o seguinte procedimento:

Em uma janela DOS, altere o diretório (cd) para o diretório Bin do IWS.

c:\>cd \Program Files\InduSoft Web Studio\Bin

Assim que o comando responder, copie Hst2txt.exe no mesmo diretório onde o arquivo .hst está localizado.

Digite Hst2txt.exe e especifique os seguintes parâmetros:

<filename>: Nome do arquivo histórico trend a ser convertido

[<separator>]: Caractere separador de dados (padrão é <TAB>)

[</e>]: Funcionalidade de extensão (converte dados com mais de 10 caracteres)

[</i:HH:MM:SS>]: Inicia a contagem em horas, (HH) minutos (MM), e segundos (SS)

[</f:HH:MM:SS>]: Finaliza a contagem em horas (HH), minutos (MM), e segundos (SS)

[</m>]: Inclui milissegundos na coluna Time (Digite 1 para imprimir o valor em milissegundos em um arquivo de texto criado a partir do arquivo .hst.)

Por exemplo:

Hst2txt.exe 01952010.hst

O programa cria um arquivo texto de planejamento .hdr (header) e um arquivo .txt que pode ser visualizado com a utilização de qualquer editor de texto (Por exemplo, Notepad).

O arquivo .hdr contém o nome dos tags configurados na planilha Trend.

O arquivo.txt contém os valores do tag salvos no arquivo histórico.

Após o programa converter o arquivo, digite Exit para fechar a janela DOS.

Nota: Alternativamente, pode-se utilizar a função HST2TXT em uma planilha Math para converter arquivos binários em formato texto automaticamente, sem a necessidade de utilizar uma janela DOS.


InduSoft Web Studio

Página 311

Convertendo Arquivos Históricos Trend de Texto para Binário

O IWS fornece o programa txt2hst.exe para converter arquivos textos de volta a formato binário.

Para converter um arquivo, utilize o seguinte procedimento:

De uma janela DOS, altere o diretório (cd) para o diretório Bin do IWS.

c:\>cd \Program Files\InduSoft Web Studio\Bin

Quando o comando aparecer, copie txt2hst.exe no mesmo diretório onde o arquivo .txt está localizado.

Quando o comando aparecer, digite txt2hst.exe e especifique os seguintes parâmetros:

<filename>: Nome do arquivo ASCII com dados históricos para conversão

[<separator>]: Caractere separador de dados (padrão <TAB>)

[</e>]: Funcionalidade extendida (valor dos dados com mais de 10 caracteres)

[</i:HH:MM:SS>]: Hora de início do valor dos dados em horas (HH), minutos (MM), e segundos (SS)

[</f:HH:MM:SS>]: Hora de término de valores dos dados em horas (HH), minutos (MM), e segundos (SS)

Por exemplo:

Txt2hst.exe 02950201.txt

O programa cria um arquivo .hdr (header) e converte o arquivo .txt em um arquivo binário .hst.

Após o programa converter o arquivo, digite Exit para fechar a janela DOS.

Nota: Não pode-se criar um script math para o programa txt2hst.exe e utilize-o em uma planilha Math para converter arquivos texto em formato binário como pode-se para hst2txt.exe. O atalho para script math está disponível somente para arquivos binários.

Criando Históricos Batch

O IWS fornece ferramentas poderosas que capacitam a criação e gerenciamento de informações sobre batches históricos. O usuário é capaz de criar batches com a utilização dos seguintes formatos:

Proprietary: Ao utilizar o formato de propriedade, cada batch sera armazenado em um arquivo histórico diferente. O usuário pode salvar dados históricos tanto em arquivos históricos quanto em batches ao mesmo tempo (veja “Configurando uma Tarefa Trend” no Capítulo 8: Configurando Planilhas de Tarefas, para maiores informações sobre tais arquivos).

Database: Os dados históricos utilizados para o batch são salvos na mesma tabela que aqueles salvos em dados históricos; uma tabela adicional, chamada BatchHistory mantém registros com as informações sobre os batches. A lista abaixo descreve os Campos na tabela BatchHistory:

Nome do Campo

Tipo de Dados

Descrição

Group_Number Integer Número do grupo Trend. Esse é o número da planilha criada para especificar os tags que serão armazenados em seu histórico batch.

Batch_Name String Nome do batch

Start_Time TimeStamp Data e Hora que o batch foi iniciado.

End_Time TimeStamp Data e Hora que o batch foi finalizado

Pri_Table String Reservado


InduSoft Web Studio

Página 312

Sec_Table String Reservado

Description String Descrição do Batch

Deleted Boolean 0: Batch não foi deletado 1: Batch foi deletado

Dica:

Pode-se costumizar o nome da tabela e o nome das colunas criadas em um banco de dados editando o arquivo <AplicaçãoName>.APP, como se segue:

[Trend] <DefaultName>=<NewName>

[Trend<Group><PRI|SEC>] BatchHistory=<TableName>

Por exemplo:

[TREND001PRI] BatchHistory=MyTableForPrimaryDB [TREND001SEC] BatchHistory=MyTableForSecondaryDB [Trend] Group_Number=Trend_Worksheet Batch_Name=Load_Number

Configurando Tarefas Recipes A pasta Recipe habilita a configuração de planilhas Recipe para intercâmbio de dados entre o banco de dados da aplicação e arquivos de disco nos formatos ASCII, XML, ou DBF; transferindo valores entre arquivos e memória em tempo real.

Tipicamente, utiliza-se uma planilha Recipe para armazenar receitas de processos, embora possa-se armazenar qualquer tipo de informação (como logs de operação, senhas, etc) nesses arquivos. A tarefa Recipes lê e registra valores de tags da aplicação, além de transferir valores de tags para a aplicação e vice-versa.

Nota: O IWS incrementa seqüencialmente o número que identifica a planilha Recipe para cada planilha recentemente criada.


InduSoft Web Studio

Página 313

Utilize um dos seguintes métodos para criar uma nova planilha Recipe:

• Clique com o Botão direito na pasta Recipes, e clique na tela.

• Selecione File → New na barra de menu ou clique no Botão New na barra de ferramentas Standard para abrir o diálogo New Document. Selecione Recipe Worksheet e clique em OK.

Uma nova planilha Recipe aparecerá:

Planilha Recipe

A planilha Recipe é dividida em duas áreas:

• área Header (seção acima), a qual contém informações para todo o grupo

• área Body área (seção abaixo), onde você define cada tag no grupo.

Utilize os parâmetros Header desta planilha como se segue:


• Save As XML: Clique (habilite) para salvar informações em formato XML, ou (desabilite) para salvar em formato .DAT.

Atenção: Pode-se carregar informações em um arquivo .DAT em tags diferentes utilizando uma segunda planilha Recipe, embora deva-se carregar informações em um arquivo .XML para tags com o mesmo nome do tag do qual os dados foram gerados.

Nota: Da mesma maneira para as páginas HTML, deve-se estar rodando o server da Web para visualizar dados em formato XML a partir da Web, embora as páginas XML no sistema de runtime não necessitem de uma aplicação em andamento para que os dados possam ser visualizados. (Deve-se possuir o Internet Explorer version 5.0 ou mais recentes para visualizar dados em formato XML.)

• Campo File Name: Digite um nome de arquivo relacionado ao grupo de receitas, utilizando um texto estático (File1) ou um valor de tag dinâmico ({FileNameTag}).

• Campo Register Number: Digite um tag para definir o número de registro a ser lido e registrado em um arquivo DBF. O IWS habilita esse Campo para aplicações mais antigas, criadas para a


InduSoft Web Studio

Página 314

utilização de arquivos DBF. Porém, o software desabilita esse Campo para projetos mais recentes.

• check-box Unicode: Clique (habilite) para salvar a receita em formato UNICODE (dois bytes por caractere) ou (desabilite) para salvar a receita em um formato ANSI (um byte por caractere).

Nota: Ao salvar uma planilha, pode-se utilizar qualquer nome de sua preferência (um nome pré-definido não é requisitado).Um arquivo de configfuração que utilize a extensão padrão .RCP (ou .XSL caso você especifique Save As XML) contém configurações de receitas e o Campo File Name contém o nome do arquivo dos dados a serem lidos e registrados.

Utilize os parâmetros Body desta planilha como se segue:

• Campo Tag Name: Digite nomes dos tags a serem atualizados com conteúdos do arquivo ou com valores a serem registrados no arquivo. Caso o tag seja um array, deve-se especificar a primeira posição a ser utilizada.

• Campo Number of Elements: Especifica quantas posições de tag array estão em uso.

Dica:

Pode-se configurar um nome de tag entre colchetes {TagName} nesse Campo, permitindo ao usuário alterar dinamicamente o Número de Elementos configurados na Receita para cada tag array durante o runtime.

Atenção: Ao definir um tag array, sua posição inicial deve ser zero, embora o IWS utiliza o tag em caso de uma configuração de posição inválida.

Para ler ou registrar um grupo de receita, utilize a função InduSoft Scripting Language Recipe.

Configurando a Tarefa Reports O arquivo Reports contém uma definição de relatórios (tipo texto) a serem enviados para uma impressora ou disco. A tarefa Reports permite a configuração de seu próprio relatório (tipo texto) com dados provenientes do sistema. O propósito principal dessa tarefa é criar relatórios de forma mais simples e eficáz.

Nota: O IWS incrementa seqüencialmente o número que identifica a planilha Report para cada planilha recentemente criada.

Para imprimir um relatório, utilize uma função InduSoft Scripting Language em qualquer lugar onde uma expressão é permitida.

Utilize um dos métodos a seguir para inserir uma nova planilha Report:

• Clique com o Botão direito na pasta Reports e clique na tela.

• Selecione File → New na barra de menu ou clique em New na barra de ferramentas Standard para abrir o diálogo New Document. Selecione Report Worksheet e clique em OK.

Uma nova planilha aparecerá:


InduSoft Web Studio

Página 315

Planilha Report

A planilha Report é dividida em duas áreas:

• área Header (seção acima), a qual contém informações para todo o grupo.

• área Body (seção abaixo), onde você define o tag e texto a serem utilizados na geração de um relatório.

Utilize os parâmetros Header desta planilha como se segue:


• check-box Disk Append: para adicionar em um arquivo,

– Habilite o box para adicionar (append) o novo relatório no final de um arquivo já existente

– Desabilite o box para substituir o relatório já existente pelo novo, nesse mesmo arquivo

• check-box Unicode: Clique (habilite) para salvar o relatório em formato UNICODE (dois bytes por caractere) ou (desabilite) para salvar o relatório em formato ANSI (um byte por caractere).

• check-box Log Value into the (Tag/Expression) length: Clique para habilitar o resultado de Expressões/Tags configurados na tarefa Report para encaixar-se entre os colchetes, de acordo com o número de caracteres. Caso você não habilite esse box, o relátorio utilizará somente o número de caracteres do valor dos dados, apesar do tamanho da expressão/tag.

• Campo Output File: Digite o nome do tag para o arquivo de saída (utilizando a sintaxe {tag}) onde os dados estão armazenados ao adicionar para um arquivo, onde o valor do tag é parte do nome do arquivo.

Por exemplo: report{day}.out

Onde o arquivo gerado deve ser report1.out, report2.out ..., de acordo com o valor para dia do tag.


InduSoft Web Studio

Página 316

Nota: Um arquivo de configuração de relatórios utiliza .RCP como a extensão padrão. O Campo Output File é o arquivo onde os dados estão armazenados.

• Botão Edit RTF file: Clique para acessar o relatório como um arquivo RTF, o qual pode-se editar para modificação de layout, etc.

Utilize a porção Body dessa planilha para formatação do relatório. Pode-se configurar um relatório utilizando dados do sistema e indicando onde adicionar valores de tag. Cada nome do tag substituirá o nome do tag {tag_name}. Para tags do tipo real, utilize a seguinte sintaxe: {tag_name n}, onde n é o número de caracteres decimais desejados a serem adicionados.

Nota: Caso você esteja utilizando o editor de relatório padrão (somente texto: ASCII ou UNICODE), o número de caracteres reservados para o valor do tag será igual ao número de caracteres utilizados para digitar o nome do tag (incluindo os dois “curly” brackets). Por exemplo, configure {TagA} no corpo do relatório, reserve seis caracteres para o valor do tag no arquivo do relatório. Tal comportamento não é válido para relatórios em formato RTF.

Configurando uma tarefa ODBC A interface ODBC roda em um ambiente de rede de trabalho, e utiliza a configuração padrão Windows ODBC. A tarefa ODBC é capacitada para troca de dados entre o IWS e qualquer banco de dados que suporte essa interface.

Além de configurar a planilha ODBC, deve-se configurar o driver Windows ODBC padrão. O IWS refere-se ao Usuário DNS (Data Source Name), o qual foi configurado no Painel de Controle (Control Panel). Para maiores informações, veja sua documentação do Windows.

Nota: O IWS incrementa seqüencialmente o número que identifica a planilha ODBC para cada planilha criada recentemente.

Utilize um dos seguintes métodos para inserir uma nova planilha ODBC:

• Clique com o Botão direito na pasta ODBC e clique na tela.

• Selecione File → New na barra de menu ou clique em New na barra de menu Standard para abrir o diálogo New Document. Selecione ODBC Worksheet e clique em OK.



InduSoft Web Studio

Página 317

Planilha ODBC

A planilha ODBC é dividida em duas áreas:

• área Header (seção acima), a qual contém informações para todo o grupo, define tags para iniciar eventos de leitura e registro, configure valores de retorno, suporta parâmetros de acesso, etc.

• área Body (seção abaixo), onde você define cada tag no grupo, além de relacionar tags a Campos do registro atual à tabela do banco de dados.

Utilize os parâmetros de Header nessa planilha como se segue:


• Campo Data Source Name: Digite o mesmo Data Source Name (DSN) especificado no Painel de Controle do Windows, contendo informações sobre acesso a banco de dados específico. Pode-se alterar o nome em Data Source Name durante o runtime configurando um tag entre colchetes nesse Campo. Por exemplo:

{DSNNameTag}

• Campo User: Digite um nome de usuário para acessar o banco de dados> Pode-se alterar o nome User durante o runtime configurando um tag entre colchetes nesse Campo.

• Campo Password: Digite a senha do usuário. Pode-se alterar Password durante o runtime configurando um tag entre colchetes nesse Campo.

• Campo Table: Digite um nome para tabela no banco de dados. Pode-se alterar o nome Table durante o runtime configurando um tag entre colchetes nesse Campo.

• Campo Condition: Digite uma condição de pesquisa ou filtro.

• Campo Status: Digite um valor de retorno (preencha com um nome de tag). O tag deverá relatar 0 para sucesso na operação, e um outro valor para um código de erro.

• Campo Transaction Completed: Digite um tag que troque de valor quando a transação estiver executada.


InduSoft Web Studio

Página 318

• Campo Select, Next, Insert, Delete, ou Update Trigger: Digite um tag para funcionar cada alteração de valor faz com que o sistema execute o comando correspondente. Ao menos um Campo “disparador” é requisitado.

Utilize os parâmetros em Body nessa planilha como se segue:

• Campo Tag Name: Digite os nomes dos tags a serem atualizados com os conteúdos do arquivo ou tags dos quais os valores devem ser registrados no arquivo.

• Column: Digite o local no qual encontrar dados no arquivo (Por exemplo, em um arquivo Excel, digitando em Coluna 1, Linha 1, a coluna inteira define-se como coluna 1).

Deve-se utilizar o Painel de Controle do Windows para configurar a interface ODBC para arquivos em Excel. O procedimento é o seguinte:

Clique em Start → Settings → Control Panel.

Quando a janela Control Panel aparecer, clique duas vezes no Botão ODBC para abrir o diálogo ODBC Data Source Administrator.

No diálogo ODBC Data Source Administrator, clique Excel Files na lista User Data Sources, e clique no Botão Configure.

Quando o diálogo ODBC Microsoft Excel Setup aparecer, digite o nome de configuração do Windows a ser utilizado no Campo DSN da planilha ODBC no Campo Data Source Name.

Clique no Botão Select Workbook para configurar o arquivo Excel que você deseja utilizar.

Retorne ao diálogo ODBC Data Source Administrator e verifique se o DSN do usuário apareceu na lista. Clique em OK para fechar o diálogo.

Após configurar a interface ODBC do Windows, deve-se configurar as planilhas ODBC do IWS.

No tab Tasks, insira uma nova planilha ODBC.

Certifique-se de que você configurou ODBC Runtime para iniciar-se automaticamente, no tab Execution Tasks (Project → Project Status).

Para iniciar essa configuração, só é necessário rodar o projeto. Sua aplicação aplicará os disparadores Select, Next, Insert, Delete e Update, permitindo assim a troca de dados através das linhas do Excel e os tags configurados na planilha.

Consulte sua documentação do Windows para obter os significados de códigos de erro específicos. Segue uma lista de códigos de erro do IWS:

Select command

1 - Error in the ODBCPREPARE function.

2 - Error in the ODBCBINDCOL function.

3 - Error in the ODBCEXECUTE function.

4 - Error in the ODBCSETCH function.

Next command

5 - Error in the ODBCSETCH function.

Insert command



8 - Error in the ODBCCOMMITE function.

Update command




Delete command


InduSoft Web Studio

Página 319




Configurando uma Tarefa Math A pasta Math permite a implementação de rotinas adicionais para trabalhar com funções básicas de diferentes tarefas do IWS. Uma planilha Math contém um grupo de linhas de programação que o IWS executa com uma tarefa de Background durante o runtime. Pode-se configurar a planilha Math para prover ambientes livres para rotinas lógicas e cálculos matemáticos necessários para o projeto. Para tais propósitos, o InduSoft Scripting Language é simples e de fácil utilização.

Nota: O IWS incrementa sequencialemnte o número que identifica a planilha Math para cada planilha criada recentemente.

Utilize um dos seguintes métodos para inserir uma nova planilha Math:

• Clique com o Botão direito na pasta Math e clique na tela.

• Selecione File → New da barra de menu ou clique no Botão New na barra de ferramentas Standard para abrir o diálogo New Document. Selecione Math Worksheet e clique em OK.


Planilha Math

A planilha Math é dividida em duas áreas:

• área Header (seção acima), a qual contém informações detalhadas para todo o grupo

• área Body (seção abaixo), onde você define cada tag, expressão e as e Programming Lines (rotinas lógicas e cálculos matemáticos para funções e operações lógicas no grupo).




InduSoft Web Studio

Página 320

• Campo Execution: Digite uma expressão, tag único ou um valor constante para determinar quando a planilha deve ser executada.

Atenção: O IWS executa a planilha somente quando o resultado do Campo Execution não for zero. Caso você sempre queira a planilha para ser executada, digite 1 (valor constante) no Campo Execution.

Utilize os parâmetros em Body desta planilha como se segue:

• Campo Tag Name: Digite um tag para receber um valor de retorno para o cálculo especificado na coluna the Expression.

• Campo Expression: Digite uma expressão para enviar o valor de retorno para o tag especificado na coluna Tag Name.

Configurando uma Tarefa Scheduler A pasta Scheduler gera eventos com expressões matemáticas definidas para serem executadas de acordo com hora, data ou qualquer evento monitorado.

Nota: O IWS incrementa sequencialmente o número que identifica a planilha Scheduler para cada planilha criada recentemente. Diferentes grupos scheduler possuem somente função organizacional.

Utilize um dos seguintes métodos para inserir uma nova planilha Scheduler:

• Clique com o Botão direito na pasta Scheduler e clique na tela.

• Selecione File → New da barra de menu ou clique em New na barra de ferramentas Standard para abrir o diálogo New Document. Selecione Scheduler Worksheet e clique em OK.


Planilha Scheduler


InduSoft Web Studio

Página 321

A planilha Scheduler é dividida em duas áreas

• área Header (seção acima), a qual contém informações para todo o grupo.

• área Body (seção abaixo), onde você define cada tag, expressão e condição para o grupo.



• Lista drop-down Event: Clique para selecionar um tipo de evento a partir dos segiuintes

Calendar: Gera bases de horário maiores que 24 horas. Por exemplo, pode-se definir um evento que imprima um relatório diariamente, em um horário específico.

Nota: Certifique-se de que o Campo Date esteja completo, caso você deseje uma data específica para execução do evento.

Clock: Gera bases de horário menores que 24 horas (intervalos em minutos ou segundos). Essa função é frequentemente utilizada com gráficos de tendência. Por exemplo, pode-se definir um tag que será incrementado a cada hora.

Change: Evento relacionado a troca de um tag no Campo Trigger.

• Campo Trigger: Digite um tag que dispare uma troca de evento quando o valor desse tag alterar-se. Quando o tag Trigger altera-se, o IWS retorna o valor especificado no Campo Value do tag. Esse Campo é utilizado somente pelo evento alterado.

• Campo Time: Especifica um intervalo de tempo no qual um evento deve ocorrer, quando utilizado um “relógio” em horas – (0 a 23), minutos (0 a 59), e segundos (0 a 59). Também pode-se utilizar esse Campo para especificar uma hora a ser utilizada pelos eventos de calendário.

• Campo Date: Especifica uma data na qual um evento de calendário deve ocorrer – dia (1 a 31), mês (1 a 12), e ano (1900 a 2099). Caso você deixe esse Campo em branco, o evento ocorrerá diariamente. Esse Campo é utilizado somente pelo evento de calendário.

• Campo Tag: Digite um tag para receber o valor retornado pelo Campo Expression.

• Campo Expression: Digite uma expressão para qual tag será enviado o valor de retorno. Esse Campo é utilizado para todos os eventos.

• Campo Disable: Contém uma condição para desabilitação para a função especificada. Deixe esse Campo em branco ou utilize um valor de expressão igual a zero (logicamente verdadeiro) para executar a função. Utilize um valor de expressão igual a um, e a função não será executada (Disable ≥ 1).


InduSoft Web Studio

Página 322

Capítulo 9: Configurações de Evento Esse Capítulo descreve os novos recursos de logging e entrega de evento do InduSoft Web Studio. Um evento pode ser qualquer alteração do tag, geração de relatórios e receitas, abertura e fechamento de telas, logar e deslogar a partir do sistema de segurança, etc. O InduSoft Web Studio salva todos esses eventos em um arquivo log file, o qual pode ser entregue pelo objeto Alarm/Event Control.

Arquivos log de Evento são armazenados na pasta \Alarm da apicação, onde o InduSoft Web Studio salva arquivos históricos. Os nomes dos arquivos log de evento devem estar de acordo com o formato evYYMMDD.evt, onde:

• YY representa os dois últimos dígitos do ano no qual o arquivo log de evento foi gerado

• MM representa o mês no qual o arquivo log de evento foi gerado

• DD representa o dia no qual o arquivo log de evento foi gerado

Por exemplo, um arquivo log para May 7, 2003 deve ser ev030507.evt.

Os arquivos de evento (*.evt) são arquivos texto ASCII criados de acordo com o seguinte formato:

P1|P2|P3|P4|P5|P6|P7|P8|P9|P10|P11|P12|P13

P1|P2|P3|P4|P5|P6|P7|P8|P9|P10|P11|P12|P13

.

.

.

P1|P2|P3|P4|P5|P6|P7|P8|P9|P10|P11|P12|P13

P1 = Versão do arquivo (Current � 1)

P2 = Tipo de evento

. 1 � SECURITY SYSTEM

. 2 � DISPLAY

. 3 � RECIPE

. 4 � REPORT

. 5 � CUSTOM MESSAGES

. 6 � SYSTEM WARNING

. 7 � LOG TAGS

P3 = Hora do Evento (DD/MM/YYYY HH:MM:SS.SSS)

P4 = Nome do Tag

P5 = Valor do Tag

P6 = Source (Not used)

P7 = Nome do Usuário

P8 = Nome Completo do Usuário

P9 = Mensagem de Evento

P10 = Estação

P11 = Comentário

P12 = Valor anterior

P13 = Diferença de Tempo (Bias)


InduSoft Web Studio

Página 323

Configurando Parâmetros de Eventos Utilize os passos abaixo para configurar o recurso de entrega do evento:

Selecione o tab Database. Esse tab contém um novo ícone, chamado Event Settings:

Tab Database: Event Settings

Clique com o botão direito no ícone Event Settings e selecione Open do pop-up para abrir o diálogo Event Settings:

Selecionado Event Settings

Diálogo Event Settings


InduSoft Web Studio

Página 324

Configure os parâmetros no diálogo Event Settings como se segue:

check-box Enable event logger: Habilite esse box para habilitar o monitoramento de eventos (event-logging).

text box Disable: Digite um tag nesse campo. Caso o valor do tag seja diferente de 0 (falso), o InduSoft Web Studio desabilita o Event Logger automaticamente.

check-box Security System: Habilite esse box para incluir eventos de sistema de segurança em arquivo histórico de evento. O IWS loga os seguintes eventos para sistema de segurança:

* Log On / Log Off de usuários

* Usuários criados/ removidos utilizando as funções CreateUser() ou RemoveUser()

* Usuário bloqueado/desbloqueado utilizandos as funções BlockUser() ou UnblockUser()

* Usuário bloqueado pelo sistema de segurança após várias tentativas de entrada com uma senha inválida

* Senha expirou

* Senha modificada

* Tentativa de Log On inválida

check-box Display: Habilite esse box para incluir eventos de Abertura/Fechamento de telas em arquivo de evento histórico.

check-box Recipe: Habilite esse box para incluir eventos de carregar, salvar, iniciar e deletar receitas no arquivo histórico de evento.

check-box Report: Habilite esse box para incluir eventos relatórios salvos em disco ou enviados para impressão no arquivo histórico de evento.

check-box Custom Messages: Habilite esse box para incluir eventos gerados pela função SendEvent(strEvent) no arquivo histórico de evento.

check-box System Warning: Habilite esse box para incluir eventos de avisos gerais do sistema (como Division by zero, Attempted to access invalid array index, etc) no arquivo histórico de evento. O IWS loga os seguintes eventos de aviso do sistema:

* Erros que ocorrem ao enviar alarmes por email

* Tag foi bloqueado/desbloqueado

* Divisão por zero

* Conexão/desconexão do sistema de segurança remoto

check-box Tags: Habilite esse box para capacitor e logar alterações no arquivo histórico de evento. Configure os tags que você deseja que sejam logados na tabela Tags como se segue:

* coluna Tag Name: Digite o nome do tag que você deseja logar no arquivo de evento.

* coluna Dead Band: Digite um valor para comparar e filtrar alterações aceitáveis.

Por exemplo, caso você especifique um valor Dead Band = 5 para um tag de valor = 50 e o valor do tag altera-se para 52, o sistema não registrará essa variação no arquivo histórico de evento, pois a variação foi menor que 5. Porém, caso a alteração do valor do tag for maior ou igual a 5, o sistema salvará o novo valor para o arquivo histórico.

* coluna Message: Digite um string (mensagem) relacionado a essa alteração do tag. Pode-se especificar tags nas mensagens utilizando a sintaxe {tag name}.

O parâmetro Tags pode ser útil caso você deseje gerar um arquivo de log de eventos que não sejam necessariamente condições de alarme (Por exemplo, Motor On, Motor Off, etc).

Utilize o combo-box History Format para salvar dados de evento em formato arquivo histórico de Propriedade do IWS ou para um banco de dados SQL externo relacional. As opções são as seguintes:

• Proprietary


InduSoft Web Studio

Página 325

– File Format: Texto (UNICODE). O IWS utiliza o caractere barra vertical (|) para separar os campos.

– Default Path: …\<Aplication Path>\Alarm\EVYYDDMM.EVT , onde:


Database

– Database Type: Escolhido pelo Usuário

– Default Table Name: EventHistory

A informação salva no arquivo histórico está descrita na tabela a seguir.

Nome do Arquivo

Tipo de Dados

Comentários

Version Integer Esse campo é criado somente quando o Formato do Arquivo é Propriedade. Versão atual: 002

Event_Type Integer

1: SECURITY SYSTEM

2: DISPLAY

3: RECIPE

4: REPORT

5: CUSTOM MESSAGES

6: SYSTEM WARNING

7: LOG TAGS

Event_Time TimeStamp

Timestamp indicando quando o evento ocorreu.

Quando o Formato do Arquivo é Prioridade, o IWS salva Hora do Evento no formato: MM/DD/YYYY HH:MM:SS.MSS.

Event_Info String Nome do Tag

Value Real Valor do tag quando o evento ocorreu

Source String Nome da tarefa que gerou o evento

User String Usuário logado quando o Evento ocorreu

User_Full String Nome complete do usuário logado quando o evento ocorreu

Message String Mensagem de evento

Station String Nome da estação (computador) onde o evento ocorreu.

Comment String Comentário (opcional) digitado pelo operador quando o evento ocorreu. Esse campo existe somente para Versão >=2

Previous_Value Real Valor do tag ocorrido antes do evento. Esse campo existe somente para Versão >=2

Deleted Boolean

0: Mensagem de Evento não foi deletada.

1: Mensagem de evento foi deletada

Esse campo é criado somente quando o Formato do Arquivo é Database.

Bias Integer Diferença (em minutos) das colunas Time Stamp e o horário GMT. Esse campo existe somente para Versão >=2


InduSoft Web Studio

Página 326


Time Stamp quando o registro foi criado/modificado. Esse campo é utilizado para sincronizar os banco de dados ao utilizar o Banco de Dados Secundário além do Banco de Dados Primário. Esse campo é criado somente quando o Formato do Arquivo é Database.

Dica:

Ao salvar os Eventos em um Banco de Dados SQL Relacional (Formato do Arquivo = Database), pode-se costumizar o nome das colunas criadas no banco de dados, editando o arquivo <AplicaçãoName>.APP como se segue:

[EventLogger]


POr exemplo:

[EventLogger]

Event_Info=Information

Message=Event_Message

Para informações detalhadas sobre como salvar arquivos históricos de eventos, incluindo instruções para parâmetros de configuração do banco de dados, veja Capítulo 17: Interface do Banco de Dados do IWS.


InduSoft Web Studio

Página 327

Capítulo 10: Comunicação Esse capítulo explica como habilitar as aplicações do InduSoft Web Studio para comunicação (troca de valores de dados) com outras aplicações, equipamentos remotos (como um PLC ou transmitters), e quaisquer equipamentos que implementem Servers OPC ou DDE.

Para possibilitar comunicação, pode-se configurar planilhas de tarefas fornecidas pelo IWS. Instruções para configuração dessas planilhas são fornecidas nas seguintes seções:

• Explica como configurar uma planilha Driver para implementer um protocolo de comunicação (OPC, TCP/IP, ou DDE).

• Configurando OPC: Explica como configurar uma planilha OPC para gerenciar comunicação entre OPC Clients e Servers locais ou remotos.

• Configurando TCP/IP: Explica como configurar uma planilha TCP/IP para gerenciar comunicação entre duas aplicações do IWS.

• Configurando DDE: Explica como configurar uma planilha DDE para gerenciar comunicação entre DDE Clients e Servers locais ou remotos.

Utilize o tab Comm para acessar todas as planilhas configuradas para estabelecer comununicação com outro equipamento ou software, utilizando protocolos disponíveis.

Workspace: Tab Comm

As pastas no tab Comm são descritas nas páginas subseqüentes.

Configurando um Driver Um driver de comunicação é uma DLL que contém informações específicas sobre o equipamento remoto, e implementa o protocolo de comunicação. Para desenvolver um driver de comunicação, a InduSoft fornece um toolkit para drivers. Consulte a InduSoft para maiores informações.

A pasta Drivers permite a definição da interface de comunicação (ou interfaces) entre o projeto e equipamento remoto, como um PLC, um single-loop e transmitters.

Nota: Consulte o menu Help para uma descrição das funções e características padrões para todos os drivers. Ao desenvolver uma aplicação, pode-se dirigir-se a documentação específica fornecida para cada driver de comunicação. Essa documentação está geralmente localizada no diretório DRV.


InduSoft Web Studio

Página 328

Para configurar um driver de comunicação, deve-se especifdicar os parâmetros da interface (por exemplo, o endereço da estação e o baud rate), especificar endereços do equipamento, e depois estabelecer um link com tags da InduSoft.

Utilize um dos métodos a seguir para adicionar ou remover um driver configurado:

• Clique com o Botão direito na pasta Drivers

• Selecione Insert → Drivers da barra de menu

Ambos os métodos abrem um diálogo Communication Drivers, o qual exibe uma lista de drivers disponíveis.

Diálogo Communication Drivers

Utilize os parâmetros desse diálogo como se segue:

• Campo Available Drivers: Lista todos os drivers disponíveis, e uma breve descrição de cada um deles.

• Botão Help: Clique para abrir o menu Help, que contém instruções detalhadas para configurações do driver atualmente evidenciado no campo Available Drivers.

• Botão Select>>: Clique para selecionar o driver atualmente evidenciado no campo Available Drivers.

• Campo Selected Drivers: Lista todos os drivers selecionados e suas descrições (caso disponíveis).

• Botão Remove: Clique para remover um driver atualmente evidenciado no campo Selected Drivers.

Ao clicar em OK no diálogo Communications Driver, você cria uma subpasta para o driver(s) selecionado(s) na pasta Drivers localizada no tab Comm.

Pode-se clicar com o Botão direito em uma subpasta do driver para acessar a opção Settings, a qual abre o diálogo Communications Parameters.


InduSoft Web Studio

Página 329

Diálogo Sample Communications Parameters

• Campo Connection Type: Habilita drivers seriais para comunicação com conexões de modem, TCP/IP ou UDP. Essa configuração é suportada somente para drivers seriais desenvolvidos com a biblioteca UNICOMM, que inclui a maioria dos drivers seriais disponíveis no produto.

Atenção: A opção Modem não é suportada por Pocket PC v3.00 ou mais antigas.

Nota: Essa seção cobre somente a opção Direct, o que habilita o driver a conectar-se com a utilização de um canal serial normal. Dirija-se a “Utilizando Encapsulação TCP/IP e UDP” e “Utilizando Conexões de Modem” logo abaixo para informações sobre outros tipos de conexão. “Conection Types Test” lista os drivers que têm sido testados com modem e conexões TCP/IP e UDP.

• Campo COM: Clique para selecionar uma porta de comunicação serial.

• Campos Baud Rate, Data Bits, Stop Bits, and Parity: Clique para selecionar parâmetros para uma configuração de porta serial.

• Campos Long1, Long2, String1 e String2: Esses campos são configurações para personalização de drivers. No exemplo acima, o driver utiliza Long1 para configurar o método de detecção do erro, e String1 para definir o tipo de família PLC.

• Botão Advanced: Clique para abrir o diálogo Advanced settings. Utilize esse diálogo para alterar os parâmetros do drivers padrão.


InduSoft Web Studio

Página 330

Diálogo: Advanced Settings

Especifique ou altere os parâmetros do driver padrão como se segue:

• área Timeout (ms)

– Campo Start Message: Especfica o timeout para o início da mensagem.

– Campo End Message: Especfica o timeout para o fim da mensagem.

– Campo Interval between char: Especifica o timeout entre cada caractere.

– Campo Wait CTS: Especifica o timeout para a espera para enviar (Clear to Send wait).

• área Handshake

– Lista drop-down Control RTS: Especifca a utilização do controle “Request to Send”.

– Lista drop-down Verify CTS: Especifica a utilização do tipo de verificação “Clear to Send”.

• check box Disable DTR: Clique (habilite) esse box para desabilitar a função DTR (o driver não configurará o sinal DTR antes de iniciar a comunicação).

• check box Enable IR (disponível somente para plataforma Windows CE): Clique (habilite) esse box para habilitar driver serial para a utilização de uma Interface Infra-vermelha (Infrared interface) (COM2 port) ao inves de uma porta serial padrão para comunicação com o equipamento (como PLC, I/O, computadores portáteis, etc).

• área Protocol

– Campo Retries: Digite um valor numérico para especificar quantas vezes o driver tentará executar o mesmo comando de comunicação antes de considerar um erro de comunicação para esse comando.

– Campo Station: Alguns drivers slave, como o Modbus Slave (MODSL) requisitam um endereço de rede de trabalho slave. Utilize esse campo para especificar o endereço slave.

• área Buffers length (bytes)

– Campo Tx Buffer: Especifica o comprimento de transmissão do buffer (em bytes).

– Campo Rx Buffer: Especifica o comprimento de recepção do buffer (em bytes).


InduSoft Web Studio

Página 331

O IWS fornece duas interfaces, as quais podem ser utilizadas para configurar o driver (associando tags da aplicação InduSoft para endereços de equipamento):

• MAIN DRIVER SHEET: Fornece o método mais fácil para configuração de comunicação entre tags da Aplicação InduSoft e endereços de equipamento. Essa interface permite agrupar tags automaticamente, fornecendo a melhor performance durante o runtime. Não pode-se utilizar essa interface para controle do tempo necessário para escanear um grupo de tags individualmente.

• STANDARD DRIVER SHEETS: Permite o controle do tempo necessário para escanear um grupo de tags individualmente.

Pode-se utilizar ambas as páginas ao mesmo tempo.

Utilizando encapsulação TCP/IP e UDP

A maioria dos drivers serias disponíveis no IWS permitem a utilização de encapsulação TCP/IP ou UDP/IP .O modo de encapsulação foi projetado para fornecer comunicação com equipamentos seriais conectados a servers terminais em sua ethernet ou redes de trabalho sem fio. Um server terminal pode ser visualizado como uma porta serial virtual, e converte mensagens TCP/IP ou UDP/IP em sua Ethernet rede de trabalho sem fio para dados seriais. Uma vez que a mensagem foi convertida para uma forma serial, pode-se conectar-se a equipamentos padrão que suportem comunicações seriais ao server terminal. O diagrama a seguir fornece um exemplo da aplicação dessa solução:

Encapsulação TCP/IP

Pode-se habilitar a encapsulação seguindo-se os passos abaixo:

Clique com o Botão direito na pasta do driver e selecione Settings do menu que será exibido, o que proverá acesso aos parâmetros de comunicação:


InduSoft Web Studio

Página 332

No campo Connection Type, selecione TCP/IP ou UDP/IP:

Selecionando um Tipo de Conexão

Os campos a seguir estarão disponíveis:

• Campo IP Address: Especifica o Endereço IP para o Server terminal. Esse campo aceita tags entre colchetes.

• Campo Port Number: Insira o número da porta TCP/IP ou UDP/IP.

• Campo Status Tag: Esse campo está disponível somente ao utilizar TCP/IP. O tag nesse campo recebe o valor 1 quando a conexão TCP/IP está estabelecida; de outra forma, recebe o valor 0.

• Campo Server Mode: A encapsulação TCP/IP permite o Server Mode, fazendo o servidor terminal responsável por estabelecer a conexão para habilitar a comunicação.

Utilizando conexões de Modem

A maioria dos drivers seriais estão disponíveis no IWS para permitir o uso de conexões de modem. A conexão de modem foi projetada para capacitor comunicação com equipamentos seriais remotos conectados através de uma linha telefônica. O diagrama a seguir fornece uma exemplo sobre como aplicar essa solução:

Conexão do Modem

Pode-se habilitar a conexão do modem seguindo-se os passos abaixo:


InduSoft Web Studio

Página 333

Clique com o Botão direito na pasta do driver, e selecione Settings do menu que será exibido, o que permitirá acesso aos parâmetros de comunicação:

No campo Connection Type, selecione Modem:

Selecionando um Modem

Atenção: A opção Modem não é suportada para Pocket PC v3.00 ou mais antigas.

Os campos a seguir estão disponíveis:

• Lista drop-down Name: Selecione o modem que o driver utilizará para estabelecer conexão. Caso você não saiba o nome do modem, utilize a opção Auto Detect. Auto Detect 1 utilizará o primeiro modem disponível, Auto Detect 2 o segundo, Auto Detect 3 o terceiro, e Auto Detect 4 o quarto, etc.

• Campo Phone: Insira um número de telefone que o driver possa utilizar para conectar-se ao equipamento remoto. Esse campo aceita tags entre colchetes.

• Botão Settings: Clique nesse Botão para configurar os parâmetros do modem. A janela que aparece ao clicar nesse Botão dependerá do sistema operacional que está sendo utilizado, além do tipo de modem utilizado.

Atenção: Os parâmetros configurados clicando-se nesse Botão não são salvos junto a sua aplicação. As informações são salvas no registro do sistema operacional, e são


InduSoft Web Studio

Página 334

válidas somente no computador com o qual você está interagindo. Caso você instale sua aplicação em outro computador, tais parâmetros terão que ser reconfigurados.

• Botão Connection: Clique para abrir a janela Connection Control. As configurações padrão de conexão devem suprir a maioria das aplicações. Porém, pode-se ter controle total sobre a conexão, além de capacitar chamadas de entrada, clicando-se nesse Botão.

Diálogo Connection Control

– Campo Dial out trigger: Quando o valor do tag configurado nesse campo se altera, o driver tentará conectar-se ao equipamento remoto. Caso a conexão já tenha sido estabelecida, o comando ignorado. Não é necessário utilizar esse campo caso esteja utilizando Auto Connect.

– Campo Hang up trigger: Quando o valor do tag configurado nesse campo altera-se, o driver se desconectará do equipamento remoto. Caso o equipamento esteja desconectado, o comando será ignorado Não é necessário utilizar esse campo caso esteja utilizando Disconnect call if idle for more than.

– Campo Auto Connect: Quando essa opção está habilitada, o driver tentará conectar-se ao equipamento remoto antes de enviar qualquer informação. Caso a conexão falhe, a próxima tentative será feita após o Intervalo de Entrega (Retry Interval) ter expirado.

– Campo Disconnect call if idle for more than: Quando essa opção está habilitada, o driver desconecta-se automaticamente do equipamento remoto, caso a comunicação seja executada após o período especificado.

– Campo Enable incoming calls: Habilite essa opção caso você deseje capacitor o driver a receber chamadas do equipamento remoto. Pode-se utilizar o Hang up trigger para arrastar uma chamada uma vez que tenha sido estabelecida. Note que um driver pode utilizar tanto chamadas de entrada quanto chamadas de saída.

• área Status

– Campo Code: Insira um tag para receber um dos seguintes códigos quando o driver estiver rodando:

Código Descrição 0 Disconnected 1 Connected 2 Dialing 3 Dropping 4 Closing line


InduSoft Web Studio

Página 335

– Campo Description:Insira num tag para receber uma descrição completa do status atual. A descrição está associada com o campo Code; porém, possui informações adicionais sobre o status atual.

Connection Type Tests

A maioria dos drivers seriais devem trabalhar com cada tipo de conexão. Porém, a maioria deles são desenvolvidos antes que o tipo de conexão tenha sido criado. A tabela a seguir lista tipos de conexões totalmente testadas junto a certos tipos de conexão; caso o driver que você pretenda utilizar não esteja listado abaixo e você não está certo de que trabalhará da forma correta, entre em contato com seu distribuidor.

Driver Modem TCP/IP UDP/IP MODSL ⌧ ⌧ ⌧ ABKE ⌧ ⌧ ⌧

MODBU ⌧ ⌧ OMETH ⌧

⌧ = Item foi testado = Item não foi testado

Configurando Planilhas de Driver

Essa seção explica como configurar MAIN e STANDARD DRIVER SHEETs (ou tabelas de comunicação) para associar tags da aplicação com os endereços do equipamento. Pode-se configurar múltiplas planilhas de Driver—cada uma delas dividida nas seções Header e Body. O driver MODBU será utilizado para fins de demonstração.

Nota: Nem todos os drivers requerem MAIN DRIVER SHEET. Alguns drivers necessitam somente de uma Planilha Padrão. Consulte a documentação do driver para instruções específicas.


InduSoft Web Studio

Página 336

Configurando a planilha de driver padrão

Siga os seguintes passos para criar uma nova Planilha de Driver PAdrão:

A partir do ambiente de desenvolvimento do IWS, selecione o tab Comm, localizado abaixo do painel Workspace.

No painel Workspace, amplie as pastas Drivers e clique com o Botão direito na subpasta MODBU.

Quando menu pop-up aparecer, selecione a opção Insert:

Inserindo uma Nova Planilha de Driver

A planilha de Driver (<drivername>.drv) contém duas seções:

• Header: Contém todas as informações sobre comando de registro e leitura

• Body: Contém os endereços do operador

Configurando o Header

O Header da planilha de Driver contém informações de configuração necessarias para as funções do driver. Inicialmente, deve-se criar uma nova configuração de driver para cada área com a qual você deseja comunicar-se.

Seção Header da Planilha de Driver

O header contém os seguintes campos:

• Description: Digite uma descrição da planilha, como tipos de área e suas escalas, caso a planilha seja Read, Write, ou Both. Essa descrição está exibida no Workspace, na pasta Drivers.

• Increase read priority: Quando eventos de leitura e registros de planilhas (and there can be more read worksheets with the same read trigger or enabled when idle) acontecem, a planilha de maior prioridade a primeira a ser lida na próxima chamada do read trigger ou do evento “read when idle”.


InduSoft Web Studio

Página 337

• Read Trigger: Contém um tag que sempre gera um evento de leitura quando o valor do tag no campo se altera.

• Enable Read when Idle: Contém um tag ou valor que sempre capacita uma leitura continua quando seu valor for maior que zero.

• Read Completed: Contém um valor de tag que inverte-se quando o evento de leitura está terminado.

• Read Status: Contém um tag que sempre possui seu valor preenchido com um número inteiro quando o evento de leitura termina. Caso esse valor seja igual a zero, o evento foi completado com sucesso. Caso apareça qualquer outro valor, o evento foi completado com erro. Pode-se visualizar a mensagem de erro no módulo Logwin (for NT/2000) ou verificar o arquivo MODBU.MSG no diretório DRV do InduSoft Web Studio.

• Write Trigger: Contém um tag que gera um evento de registro para toda a planilha, sempre que o valor do tag se altere.

IMPORTANTE! Ao utilizar esse recurso, o driver registra o valor do tag na memória PLC. Essa operação faz registros com a utilização de blocos, do primeiro ao ultimo operador da planilha. Caso haja um operador não declarado na planilha, e seu endereço esteja entre o primeiro e últimos blocos, o tag receberá o valor zero. Portanto, certifique-se sobre o que você deseja registrar ao utilizar esse disparador, e verifique se há qualquer tipo de espaço na planilha que possa causar problemas para o sistema ou programas PLC.

• Enable Write on Tag Change: Quando o valor de um dos tags no corpo é diferente do disparador de registro, o IWS registra o tag alterado na planilha (seu valor é maior que zero).

• Write Completed: Contém um valor de tag que inverte-se quando um evento de registro termina.

• Write Status: Contém um tag que sempre preenchido com um valor inteiro ao terminar um evento de leitura. Caso esse valor seja igual a zero, o evento foi concluído com sucesso. Qualquer outro valor indica um erro. Pode-se visualizar a mensagem de erro no módulo Logwin (para NT/2000) ou verificar o arquivo OMPLC.MSG no diretório \DRV do InduSoft Web Studio.

• Station: Deve conter (caso indicado no arquivo help do driver) o ID da CPU, Unit Number, ou Endereço PLC relacionados a essa planilha específica. Cada driver possui uma sintaxe diferente para esse campo.

Por exemplo, o driver GE Fanuc SNP permite a identificação do PLC utilizando todos os caracteres ASCII, mas o OMRON Host Link Protocol permite de 1 a 31 endereços somente, chamado Unit Numbers.

Tipicamente, pode-se utilizar o endereço do PLC em uma rede de trabalho do equipamento.

Também pode-se inserir um tag entre colchetes (Por exemplo: {tag})

Notas: Não pode-se testar a existência de tags inseridas entre colchetes (ou inseridas em uma forma diferente dos tags de outros campos), pois esses ainda não foram criados no tag database. Em outras palavras, o sistema não poderá trabalhar de forma adequada com tags ainda não criados.

Station é um campo de string, e deve ser preenchido da forma correta, ou o driver não funcionará da forma apropriada.


InduSoft Web Studio

Página 338

• Header: Deve conter o header da planilha. Esse campo é extremamente importante. Cada driver possui uma sintaxe diferente para esse campo; porém, deve-se digitar algo como o operator’s type, seguido pelo endereço inicial.

A tabela a seguir contém alguns exemplos:

Driver Header Significado

MODBUS 4X:100 4X indica que essa planilha comunicará com os Holding Registers, a partir do endereço 100 on. No caso de AEG 984, a partir do endereço 400100 on.

OMPLC (Host Link)

IR:0 IR indica que essa planilha comunicará com I/O and Internal Relays, a parir do endereço 0 on. No caso de C200H, a partir do endereço IR00000 on.

FANUC (SNP) %M %M indica que essa planilha comunicará com o %M discrete internal operator.Não há endereço inicial para esse driver.

ABKE (DF1) N7:0 N7 indica que essa planilha comunicará com o arquivo N7, a partir do endereço 0 on. No caso de PLC-5/40, a partir do endereço N7:0.

AS511 (Siemens PG Port)

DB5:10 DB5 indica que essa planilha comunicará com Data Block number 5, a partir de Data word 10 on.

Assim, a sintaxe pode variar para cada tag. A maioria das vezes, esse é o endereço do PLC em uma rede de trabalho do equipamento.

Por exemplo, utilizando a sintaxe do MODBUS:

<reference>:<initial address>

Onde:

<reference> é a referência com a qual você deseja comunicar-se

Por exemplo, caso o header seja 4X:1, o IWS lerá a planilha a partir de 4000001 até o maior offset de configuração na coluna Address.

Pode-se utilizar as seguintes referências:

0X: Coil Status

1X: Input Status (read only)

3X: Input Register (read only)

4X: Holding Register

ID: Report Slave (read only)

Não há limites para o endereço inicial, embora tome cuidado ao especificar limites de endereços. Por exemplo, no PLC não existe 30500. O campo Header aceita a sintaxe 3X:500, mas o runtime não encontrará esse registro.

Onde Read Only estiver indicado, as funções de registro não funcionarão. Não é seguro especificar registro para as funções Input Status, Input Registers e Report Slave.

Esse campo também pode ser preenchido com um tag entre colchetes (Por exemplo: {tag}).


InduSoft Web Studio

Página 339

Nota: Como acontece no campo Station, não pode-se testar a existência de tags inseridos entre colchetes (ou inseridos de uma forma diferente dos tags em outros campos), pois esses ainda não foram criados no tag database. Em outras palavras, o sistema não poderá trabalhar de forma adequada com tags ainda não criados.

Ao criar sua primeira planilha Driver, o campo está em branco. Após você colocar o cursor neste campo (mesmo se você tentar deixá-lo em branco novamente) o IWS automaticamente insere o string padrão 0X:1. A partir desse ponto, você não poderá deixar o campo em branco. Porém, pode-se alterar o valor para outro header válido.

• Min / Max: Torna-se habilitado após clicar ( ) no check-box. Quando selecionado, esse parâmetro capacita uma escala de valores que podem ser convertidos para um formato de engenharia. Tais campos determinam a escala de valores máximos e mínimos. Por exemplo, a memória suporta valores de 0 a 4095, o que significa 0% a 100% na interface do usuário. Essa configuração tem efeito para todos os tags da planilha. Nesse exemplo, os parâmetros Min e Max do tag devem ser configurados de 0 a 100, respectivamente.

Configurando o Body

A seção body da planilha Driver assina o endereço da memória do PLC para tags declarados, além de manusear unidades de engenharia.

Seção Body da Planilha Driver

A seção Body contém quarto colunas:

• Tag Name: Contém tags utilizados pelo driver de comunicação.

• Address: Contém endereços para leitura e registro dos valores do tag para o equipamento.

Como no campo Header, essa coluna é diferente para cada driver. Tipicamente, digita-se o offset para cada endereço inicial configurado no campo Header. Em alguns casos, pode-se indicar o espaço Address específico.

Para o driver de nosso exemplo, digite o offset do endereço inicial configurado no campo Header. Não pode-se inserir um valor negativo de offset—o valor 0 irá substituir o valor negativo.

Div / Add / Max / Min: Configure como se segue:

Coluna Escala de Valores

Significado

Div Any Integer or Real

In read commands: Tag = (Host value) / DIV

In write commands: Host value = Tag * DIV


InduSoft Web Studio

Página 340

Add Any Integer or Real

In read commands: Tag = (Host value) + ADD

In write commands: Host value = Tag – ADD

Min Any Integer or Real

Define o valor mínimo assinalado para o tag, quando o valor host correspondente é igual ao valor definido no campo Min no Header da planilha do driver.

Max Any Integer or Real

Define o valor máximo assinalado para o tag, quando o valor host correspondente é igual ao valor definido no campo Max do Header de planilha do driver.

Notas:

Para operações de leitura: <tag> =((<value in the equipment>) / Div)+ Add

Para operações de registro: <value in the equipment> = (<tag> - Add) * Div

Caso você não configure as colunas como especificado na tabela, as colunas não serão configuradas e os tags da planilha Driver receberão o mesmo valor do endereço configurado.

Utilize os passos a seguir para especificar tags do header:

Especifique os seguintes tags na planilha, nos campos Header. Todos os tags serão arrays, e você deverá digitar cada elemento em cada planilha.

Por exemplo, RdTr[1] no campo Read Trigger da planilha ABKE001.DRV, e RdTr[5] da planilha ABKE005.DRV, etc.

Nome do Tag

Tamanho Tipo Descrição

RdTr 0 Boolean Tag Boolean que estará nos campos "Read Trigger"

RdEn 0 Boolean Tag Boolean que estará nos campos "Enable Read when Idle" fields

RdCpl 0 Boolean Tag Boolean que estará nos campos "Read Complete"

RdSt 0 Integer Tag Integer que estará nos campos "Read Status"

WrTr 0 Boolean Tag Boolean que estará nos campos "Write Trigger"

WrEn 0 Boolean Tag Boolean que estará nos campos "Enable Write when Idle"


InduSoft Web Studio

Página 341

Nome do Tag

Tamanho Tipo Descrição

WrCpl 0 Boolean Tag Boolean que estará nos campos "Write Complete"

WrSt 0 Integer Tag Integer que estará nos campos "Write Status"

Station 0 String Tag String que estará no campo "Header"

Header 0 String Tag String que estará no campo "Station"

Especifique TAG_DRV como um tag Array, tamanho 10, para os tags de comunicação.

Configure uma planilha Driver e uma tela PLC Driver para parecer-se com a seguinte figura:

Configurando a planilha do driver MODBUS


InduSoft Web Studio

Página 342

Tela do Driver PLC

Configurando main driver sheet (MDS)

Quando você adiciona um driver MODBU a sua aplicação, o programa automaticamente adiciona a MAIN Driver Worksheet (MDS) a pasta do driver MODBU como mostrado a seguir:

Selecionando Main Driver Sheet


InduSoft Web Studio

Página 343

Pode-se utilizar o MDS para associar tags do IWS para endereços no PLC. A maioria dos parâmetros MDS são padrões para qualquer driver. Utilize as instruções a seguir para configurar parâmetros específicos do driver MODBU:

Clique duas vezes no ícone Main Driver Sheet para abrir a planilha que se segue:

Planilha Main Driver

Configure os campos a seguir dessa planilha:

Campo Station: Digite o número ID do endereço PLC

Campo I/O Address: Digite o endereço de cada registro PLC, utilizando a seguinte sintaxe:

<Type>:<Address> (Por exemplo, 4X:20) ou

<Type>:<Address>.<Bit> (Por exemplo, 4X:20.6)

Onde:

Type é O tipo do registro. Digite um dos seguintes: 0X, 1X, 3X, 4X, FP, FPS, FP3, FP3S, DW, ou ID.

Address é o endereço de registro do equipamento.

Bit é o número de (0 – 15) da p[alavra referente ao endereço. Esse parâmetro é opcional e pode ser combinado somente com endereços 3X- ou 4X.

Atenção: Deve-se utilizar um valor diferente de zero no campo Station. Não pode-se deixar o campo em branco.


InduSoft Web Studio

Página 344

Executando o Driver

Após adicionar o driver ao projeto, o Studio configura o projeto para que seja executado automaticamente ao iniciar o ambiente de runtime.

Para verificar que a tarefa de runtime do driver está habilitada e será iniciada da forma correta, siga os passos a seguir:

Selecione Project → Status da barra de menu principal.

Aparecerá o diálogo Project Status:

Diálogo Project Status

Verifique se a tarefa Driver Runtime está configurada para Automatic.

Caso as configurações estejam corretas, clique em OK para fechar o diálogo.

Caso a tarefa Driver Runtime esteja configurada para o modo Manual, selecione a linha Driver Runtime. Quando o Botão Startup torna-se ativo, clique no Botão para inverter do modo Startup para automático Automatic.

Clique em OK para fechar o diálogo Project Status.

Inicia a aplicação para rodar o driver.

Configurando OPC A pasta OPC permite a configuração de interfaces OPC entre a aplicação e um Server OPC. O módulo OPC Client da InduSoft permite que o sistema IWS estabeleça comunicação com qualquer equipamento que implemente um OPC server. Antes de utilizar o módulo InduSoft OPC Client da InduSoft, deve-se instalar e configurar o OPC nas máquinas que estejam rodando sua aplicação.

Na máquina do cliente, utilize o programa OPC Client Configuration para configurar o identificador do server, parâmetros de comunicação e os itens que você deseje que sejam conectados. Para acessar a configuração do cliente, adicione um novo documento OPC Client na tabela "COMM".


InduSoft Web Studio

Página 345

Configurando um OPC Client

Utilize os passos a seguir para configurar um OPC Client:

Selecione o tab Comm, clique com o Botão direito na pasta OPC e insira uma nova planilha OPC Client.

Selecione um OPC Server registrado (CimQuestInc.IGOPCAB) no combo-box Server Identifier para registrar InGear OPC AB.

Crie um novo jogo de tags para comunicar-se como o OPC Server , como mostrado:

Na planilha OPC Client, digite OPC_Status no campo OPC Status.

Na primeira linha da coluna Tag Name, digite OPC_N7_0.

Para associar esse tag ao item OPC Server, clique com o Botão direito na coluna Item e clique em OPC Browser para agrupar todos os itens OPC Server configurados. Selecione o item N7_0.

Selecione N7_0


InduSoft Web Studio

Página 346

Sua planilha OPC Client deverá parecer-se com a planilha que se segue:

Planilha OPC Client

A planilha OPC Client contém os campos a seguir:

• Description: Digite uma descrição do módulo OPC para fins de documentação. (O módulo OPC Client ignorará essa informação.)

• Server Identifier: Digite o nome do servidor ao qual você deseja conectar-se. Caso o servidor já esteja instalado em seu computador, pode-se selecionar seu nome a partir da lista.

• Disable: Digite um tag ou uma constante com um valor diferente de zero para desabilitar a comunicação com o OPC server. Especifique como zero, ou deixe o campo em branco para habilitar a comunicação.

• Read Update Rate (ms): Especifique a frequencia com que o servidor deverá atualizar esse grupo (em milissegundos). Especifique zero para indicar que o servidor deverá utilizar a escala mais rápida de atualização.

• Percent Deadband: (válido somente para itens análogos): Especifique a porcentagem de alteração do valor de um item suficiente para causar uma notificação do servidor.

• Status: Status atual. Um status bom é 1.

• Remote Server Name: Nome do nó ou endereço IP do servidor na rede de trabalho do nodo.

• check-box Read after writing: Habilitar esse check-box força a planilha OPC Client a executar um comando de leitura sincronizado, o que fará a leitura do valor de um item do OPC Server logo após um valor ter sido registrado ao item. Essa opção deve ser utilizada para garantir a sincronização entre o valor dos tags do IWS e os itens do OPC Server quando o programa do PLC transfere os valores registrados pelo IWS para o OPC Server.

• Tag Name: Digite os nomes dos tags com link para os itens do servidor.

• Item: Digite o nome dos itens do servidor. Após selecionar um OPC Server, pode-se selecionar itens do Server utilizando o Browser do OPC. Clique com o Botão direito no campo Item e selecione a opção OPC Browser.


InduSoft Web Studio

Página 347

Dica:

Pode-se configurar o nome do tag entre colchetes {TagName} nesse campo, permitindo ao usuário alterar os nomes dos itens dinamicamente durante o runtime.

• Scan: Especifica:

Screen: O IWS executa uma atualização ao abrir um tela contendo o tag especificado.

Always: O IWS executa uma atualização em Taxa de Atualização de Leitura (Read Update Rate) especificado no header da planilha.

Para rodar o modulo run-time do OPC client, pode-se fazê-lo rodar automaticamente no start up ou rodá-lo manualmente, selecionando Project > Status da barra de menu. Após rodar esse programa, um pequeno ícone aparecerá em seu sistema.

Para fechar o modulo de run-time OPC client, clique com o Botão direito no ícone exibido no sistema e clique em Exit.

Nota: O IWS e o CEView também fornecem um modulo de comunicação OPC Server chamado Studio.Scada.OPC. Esse módulo inicia-se automaticamente quando qualquer OPC Client (local ou remoto) tenta conectar-se com o servidor Studio.Scada.OPC server. Um OPC Client pode trocar dados com tags do IWS (Tags da Aplicação, Tags internos e Tags Compartilhados) utilizando a interface OPC.

Além disso pode-se iniciar o módulo OPC Server automaticamente ao iniciar a Aplicação. Selecione o módulo OPC Server no diálogo Project > Status clique no Botão Startup e especifique Automatic.

Dica:

Também pode-se utilizar a interface OPC para trocar dados entre estações remotas rodando o IWS ou CEView. Deve-se configurar o OPC Client em uma estação, e deve-se executar o OPC Server em uma outra estação.

Resolvendo Problemas de OPC

Ao utilizar o OPC e ter problemas ao estabelecer comunicação, deve-se verificar as mensagens exibidas em LogWin.

Caso você esteja utilizando o Windows CE, existem dois modos de verificar o log:

1. LogWin Remoto

2. Log Local

Para informações sobre a utilização desses logs, consulte "Utilizando o Módulo LogWin (NT e CE)" no Guia dos Usuário e Manul de Referências Técnicas.

Caso você encontre mensagens de erro no log, procure-as nesse sistema de ajuda (manual), e siga os passos mostrados na documentação para a resolução de problemas. (Utilize <CTRL> + F para encontrá-los no manual; utilize o Índice para encontrá-los no contexto do sistema de ajuda.)

Caso você necessite de ajuda, entre em contato com seu distribuidor para suporte técnico e, de imediato, forneça-lhe as seguintes informações:

1. Log file

2. Vendedor do Software e o nome do produto do OPC Server/Client que está sendo utilizado

3. Se possível, uma cópia ou versão válida do OPC Server para testes


InduSoft Web Studio

Página 348

4. Informações de contato para o suporte técnico de seu OPC Server/Client

Três possíveis erros e suas soluções estão listadas abaixo:

• Segurança Error Code: 0x80070005 or -2147024891

Razão de erro: Quando um OPC Client tenta conectar-se ao the OPC Server,a camada DCOM geralmente requer autenticação. O computador que está rodando o OPC Server necessita reconhecer o usuário logado ao computador OPC Client, assim como um usuário necessita de privilégios para acessar o OPC Server.

Solução: O primeiro passo é criar um usuário único em ambos os computadores que tenha privilégios de Administrador e a mesma senha. Faça l log desse usuário, e em seguida tente estabelecer a conexão.

Caso você não possa utilizar o mesmo usuário em ambos os computadores por alguns requisitos específicos de sua aplicação, ou caso o problema persista mesmo após você ter logado com o mesmo usuário, leia a documentação abaixo, a qual ajudará a resolver os assuntos relacionados a segurança:

1. DCOM Security Configuration – The DCOM Tutorial at http://www.opcactivex.com/Support/DCOM_Config/DCOMConfigUtility/dcomconfigutility.html

2. Using DCOM with Windows XP + SP2 at http://www.InduSoft.com/Utilizando_DCOM_w_WINXPSP2.pdf

• Name Resolution

Error: Couldn't create connection with advise sink, error: -2147022986 (0x80070776)

Reason for error: Existe um problema de resolução no nome do computador.

Solution: Esse problema pode ser resolvido especificando-se o endereço IP do servidor ao inves do nome especificado no computador.

• Proxy for Windows CE

Error: OPCServer: IIndCP::Advise - Could not query callback interface: 0x80040155

Reason for error: Está faltando o OPCCOMN_PS.dll em seu equipamento Windows CE.

Solution: Deve-se fazer o download de .dll para o equipamento, bem como registrá-lo. .dll deve estar disponível junto a distribuição do Studio, provavelmente em <Studio installation folder>\ Redist\Wince <x.x>\<processor>\

Caso você não encontre .dll na pasta de seu processador, entre em contato com seu distribuidor do Studio.

Configurando um OPC Server

O modulo OPC Client do InduSoft Web Studio permite que o sistema comunique-se com qualquer equipamento que implemente um OPC Server. Veja a documentação do fabricante para instruções de configuração.

Para comunicar-se com um OPC Client de terceiros e ter o IWS como o OPC Server, deve-se certificar-se de que Project → Status → Studio Scada OPC Server está configurado para Automatic. Todos os tags em nosso tag database estarão automaticamente disponíveis. Pode-se ter múltiplas aplicações. Somente os tags da aplicação atual estarão disponíveis.

Configurando TCP/IP Os módulos TCP/IP Client/Server do IWS permitem que duas ou mais aplicações InduSoft mantenham seus bancos de dados sincronizados. Tais módulos utilizam o protocolo TCP/IP da InduSoft para estabelecer comunicação entre as aplicações.


InduSoft Web Studio

Página 349

Antes de utilizar os módulos IWS TCP/IP Client/Server, deve-se instalar e configurar o protocolo TCP/IP nas máquinas que rodarão esses módulos.

Configurando Client

Na máquina do cliente, deve-se utilizar a planilha TCP/IP Client Configuration para configurar o endereço IP do Server e os tags que você deseja compartilhar com o servidor.

Em Workspace, selecione o tab COMM e clique com o Botão direito na pasta TCP para inserir uma nova planilha TCP.

Configure os campos que se seguem:

Description: Digite uma descrição da planilha para fins de documentação. O módulo TCP/IP Client ignorará esse campo.

Connection Status: Digite o nome de um tag. O módulo TCP/IP Client atualiza esse tag de acordo com o status da conexão. Caso o valor do tag seja 0 (zero), a conexão está OK. De outra forma, a biblioteca Windows enviará um código de erro.

Disable: Digite um nome de tag nesse campo. Quando esse tag possui qualquer valor diferente de 0, essa planilha TCP/IP será desabilitada. Utilizando esse campo, pode-se habilitar/desabilitar a planilha TCP/IP Client durante o runtime.

Server IP Address: Digite o Endereço IP do servidor. A entrada pode ser um string ou um tag entre parênteses. Por exemplo, caso você preencha esse campo com {tag_name}, o módulo TCP/IP Client tentará conectar-se ao servidos indicado pelo tag tag_name.

Tag Name: Digite os tags que você deseja compartilhar com o servidor. Caso o tag seja um array ou class (ou ambos), cada elemento e membro será compartilhado. Deve-se digitar o nome do tag somente nesse campo — sem especificar o índice ou membro de classe. Caso você especifique um índice ou classe, o módulo TCP/IP Client irá ignorá-lo.

Remote Tag: Digite o nome do tag a ser estabelecido um link com o tag especificado no campo Tag Name. Esse campo é opcional. Deixando-o em branco, o mesmo nome do tag utilizado para ambos, client e server.

Atenção: Caso seja necessário compartilhar um tag array, o tag no servidor deverá conter o mesmo número de elementos de um tag em client. Caso seja um classe tag, a definição de classe deverá ser a mesma em aplicações server e client. Caso você não siga tais regras, resultados inesperados poderão acontecer.

Configurando Parâmetros Customizados

Pode-se configurar os parâmetros que se seguem no arquivo Aplication Configuration (.APP) (selecione Project → Settings na barra de menu principal):

• [TCP] Port: Número da Porta TCP/IP. O padrão é 1234. Esse parâmetro deve ser o mesmo para as máquinas server e client.

• SendPeriod: Período em milissegundos antes de o módulo client/server atualizar os valores do tag de outra máquina. O padrão é 250.

• ConnectRetryTimeout: Período em segundos antes que o cliente possa tentar reconectar-se ao servidor. O padrão é 30.

Somente o modulo client utiliza ConnectionRetryTimeout.

Pode-se rodar o Módulo TCP/IP Client de forma manual ou automática. Da barra de menu principal, selecione Project → Status. No tab Execution Tasks, configure TCP/IP Client Runtime para Manual ou Automatic.


InduSoft Web Studio

Página 350

Após rodar esse programa, um pequeno ícone aparecerá em seu sistema.

Configurando TCP/IP Server

Na máquina do server, não é necessário configurar qualquer parâmetro, apenas rode o módulo IWS TCP/IP Server. Na janela do ambiente de desenvolvimento, vá para o diálogo Project Settings e configure o TCP/IP Server para rodar automaticamente. Na barra de menu principal, selecione Project → Status. No tab Execution Tasks, configure o TCP/IP Server para Automatic. Ao rodar esse programa, um pequeno ícone aparecerá em seu sistema.

Para fechar o módulo TCP/IP Server do IWS, clique com o Botão direito no ícone do sistema e selecione Exit.

Configurando DDE A pasta DDE permite a configuração de um DDE Client para uma aplicação DDE Server, como em Excel (ou qualquer outro programa do Windows que suporte tal interface).

Dynamic Data Exchange (DDE) é um protocolo para troca dinâmica de dados entre aplicações do Windows, como Excel. Uma conversação DDE é uma interação entre aplicações server e client. O IWS prove interfaces qe rodam como clients ou servers. Veja DDE Client Runtime e DDE Server em Execution Tasks (Project → Status).

• Para rodar como server, inicie a tarefa DDE ou NetDDE como descrito em Execution Tasks.

• Para rodar como client, configure a planilha de interface DDE no tab Comm.

Network Dynamic Data Exchange (NetDDE) é uma extensão do DDE que funciona através de computadores de uma rede de trabalho.

• Para rodar o IWS como server para uma conexão NetDDE, deve-se iniciar a aplicação DDE Server.

• Para rodar o IWS como client para uma conexão NetDDE, utilize as mesmas planilhas de interface DDE com a configuração apropriada para endereçar uma aplicação do IWS.

Notas: Ao rodar NetDDE, o IWS aceita somente os disparadores WRITE. Para leitura de dados, deve-se configurar um comando de escrita no computador server.

Por padrão, o módulo DDE Client do IWS suporta DDE Servers que suportam dados de string em formato UNICODE. Caso o DDE Server suporte dados de string em formato ASCII ANSI, a configuração a seguir deverá ser inserida manualmente no arquivo <AplicaçãoName>.APP (você pode utilizar o Notepad para editar esse arquivo): [Options] DDEANSI=1

Configurando DDE Client

Para abrir uma nova planilha DDE, clique com o Botão direito na pasta DDE e clique na tela.

Uma nova planilha DDE aparecerá:


InduSoft Web Studio

Página 351

Planilha DDE

O diálogo da planilha DDE é dividido em duas áreas:

• área Header (seção acima), contém informações para todo o grupo, e define tags para iniciar a leitura, registro e recebimento do status da conexão

• área Body (seção abaixo), onde você define tags na aplicação e itens relacionados a aplicação DDE server

Cada interface DDE é baseada no endereçamento da aplicação, utilizando as três estruturas a seguir:

• Nome da Aplicação

• Tópico

• Item

Configurando DDE Server

A primeira tarefa é encontrar esses identificadores na aplicação DDE Server.

Utilize os parâmetros da área Header da planilha DDE client como se segue:

• Campo Description: Digite uma descrição da planilha DDE para fins de documentação.

• Campo Aplicação Name: Digite o nome da Aplicação do DDE server.

• Campo Topic: Especifique um tópico na Aplicação server.

• Campo Connect: Digite um tag para controlar a conexão do DDE client do IWS e a aplicação DDE server. Quando esse tag for configurado como 1, ele requisitará uma conexão ao servidor. Caso a conexão não seja possível ou falhe, o IWS configure o zero novamente para zero. Caso a conexão esteja OK, o valor permanecerá como 1.

• Campo Read Trigger: Digite um tag para comandar uma leitura da tabela. Quando esse tag altera seu valor, o IWS gera polling para o DDE server. Pode-se utilizar esse parâmetro somente com DDE local; não pode-se utilize-lo com servers NetDDE.

• Campo Enable Read when Idle: Digite um valor do tag maior que zero para habilitar uma leitura do equipamento.

• Campo Read Status: Contém o status do comando de leitura.

• Campo Write Trigger: Digite um tag para habilitar o IWS a gerar comandos poke ao server.


InduSoft Web Studio

Página 352

• Campo Enable Write on Tag Change: Digite uma valor de tag maior que zero para habilitar o driver de comunicação para verificar continuamente alterações nos valores do tag da planilha. Quando o driver detecta uma ocorrência de alteração, o driver registrará o tag alterado no equipamento, juntamente ao endereço do tag.

• Campo Write Status: Contém o status do comando de registro.

Utilize os parâmetros da área Body do DDE client como se segue:

• Campo Tag Name: Digite um tag para ler ou registrar tags do banco de dados do IWS a partir da aplicação DDE server.

• Campo Item: Digite o espaço ITEM do endereço DDE no server. Consulte a documentação de seu software para informações sobre a sintaxe apropriada para APP, TOPIC, e ITEM.

Pode-se configurar os campos Topic e Item com tags no endereço utilizando a seguinte sintaxe: text {tag}. O IWS valida o valor do tag {tag} para um string e utiliza-o no endereço. Por exemplo:

Topic: topic_{tag_topic_name}_example

Item: {tag_item_name} or A{tag_number}

Configurar uma conexão NetDDE é semelhante a configurar uma conexão DDE, exceto pelo nome e tópico do Header da aplicação. Antes de iniciar seus testes, verifique que o DDE Server foi habilitado na estação com a qual você deseja trocar dados.

Nota: Ao conectar-se a outros servidores que não sejam o IWS, consulte a documentação do servidor para informações sobre a sintaxe apropriada de APP, TOPIC, e ITEM.

Utilize a planilha os parâmetros Header da planilha NetDDE Client para definir os tags que iniciam a leitura e registro, além dos tags que recebem o status da conexão, como se segue:

• Campo Aplicação Name: Digite <computer name>\NDDE$, onde <computer name> deve ser o nome válido de uma rede de trabalho.

• Campo Topic: Digite o nome do tópico UNISOFT$ para conectar-se a outra estação do IWS.

Utilize os parâmetros Body da planilha DDE client para relatar cada tag a cada espaço ITEM do endereço do DDE server:

• Campo Tag Name: Especifica o nome do tag do banco de dados local do IWS que está relacionado a algum nome do tag remoto.

• Campo Item: Especifica o nome do tag remoto que está relacionado ao nome do tag local.


InduSoft Web Studio

Página 353

Capítulo 11: Configurando um Sistema de Segurança Utiliza-se o diálogo Security System para criar grupos e usuários, configurando privilégios de acesso às ferramentas e aplicações do InduSoft Web Studio.

Para acessar esse diálogo, clique com o botão direito na pasta Security no tab Database e selecione Settings do menu pop-up.

Diálogo Security System

Esse diálogo contém os seguintes recursos:

• check-box Enable Security System: Habilite ( ) esse box para capacitar o Sistema de Segurança do IWS.

• Botão Main Password: Abre o diálogo Security System Main Password para que você possa definir senhas que garantam o acesso ao sistema de segurança.

• Botão Groups: Abre o diálogo Groups, onde você cria e mantém o grupo de usuários.

• Botão Users: Abre o diálogo Users, onde você cria e mantém usuários.

• Painél VK: Tipo de Virtual Keyboard utilizado para os diálogos Security System (LogOn, Change Password, etc). É necessário habilitar a opção Virtual Keyboard na interface Project → Settings → Runtime Desktop antes de configurar o Virtual Keyboard para essa interface.

Inserindo uma Senha

Ao clicar no botão Main Password, o diálogo Security System Main Password abre, a fim de que você possa inserir uma senha para acesso ao Sistema de Segurança do InduSoft Web Studio.

Diálogo Security System Main Password

Esse diálogo contém dois campos:

• Campo Password: Digite uma senha.

• Campo Confirm Password: Digite novamente a mesma senha para confirmá-la.

Caso a senha seja diferente, o IWS requisitará que você insira a senha novamente.


InduSoft Web Studio

Página 354

IMPORTANTE!

Após definir sua senha, você deverá utilizá-la cada vez que acessar o Sistema de Segurança, portanto, é imprescindível que você recorde essa senha.

Definindo Grupos O diálogo Group Account capacita a criação e manutenção de grupos de usuários, habilita/desabilita operações e configure escalas de nível de segurança para sistemas de desenvolvimento e runtime.

Acessa-se esse diálogo clicando no botão Groups Account no diálogo Security System. Alternativamente, pode-se abrir a pasta Groups localizada na pasta Security no tab Database, ou selecionando Insert → Security Group a partir da barra de menu principal.

Diálogo Group Account

O recursos desse diálogo incluem:

combo-box Group Account: Identifica o grupo ao qual o usuário pertence.

Nota: Não pode-se deletar o grupo Guest (um grupo padrão).

• Campos Security Level – Development fields and Security Level – Runtime: Define o nível de segurança para um grupo (0 a 255).

Cada objeto utilizado para dados de entrada em uma tela (como comandos de entrada, sliders, ou telas) possui um campo Security Level. Caso o nível de segurança do objeto não esteja na escala de segurança do grupo do usuário logado no momento, esse objeto não estará habilitado. Um nível 0 (zero) significa que o objeto está sempre habilitado.


InduSoft Web Studio

Página 355

• check-boxes Engineering Access: Controla quais tarefas de engenharia (desenvolvimento) os usuários desse grupo poderão acessar ao efetuarem log on.

IMPORTANTE! É possível configurar o nível de segurança para documentos (como planilhas e telas) para assim protegê-los no ambiente de desenvolvimento.

• check-boxes Runtime Access: Controla quais módulos de runtime os usuários desse grupo poderão acessar ao efetuarem log on.

• botão New: Abre o diálogo New Group Account utilizado na criação de novos grupos.

• botão Delete: Deleta o grupo do usuário selecionado atualmente.

Antes de iniciar a configuração de seu sistema de segurança, deve-se decidir quais grupos e usuários você deseja que sejam configurados. Deve-se definir os direitos de cada grupo em seu ambiente.

Utilize o seguinte procedimento para criar esse grupos:

Em Workspace, selecione o tab Database e clique duas vezes na pasta Security para visualizar as sub-pastas.

Clique com o botão direito na pasta Group e selecione Insert Group no menu pop-up:

Inserindo um Group

O diálogo Group Account aparecerá:

Diálogo Group Account


InduSoft Web Studio

Página 356

Lembre-se de que não é possível deletar o grupo padrão chamado Guest, devendo-se assim criar um novo grupo, como se segue.

Clique no botão New e quando aparecer o diálogo New Group Account, digite um nome do grupo no campo fornecido. (Nesse exemplo, digite Operation.) Clique em OK para fechar o diálogo.

Inserindo o Group Name

Retorne para o diálogo Group Account e caso o nome de uma nova conta não aparecer, selecione Operation no combo-box Group Account.

Configure os direitos de acesso para esse grupo, como se segue:

Direitos de Acesso: Operation

Clique no botão New novamente e crie o grupo Maintenance. Clique em OK para fechar o diálogo New Group Account.


InduSoft Web Studio

Página 357

Selecione Maintenance no combo-box Group Account e configure os direitos de acesso para o grupo, como se segue:

Direitos de Acesso: Maintenance

Repita o procedimento mais uma vez para criar a Group Account Development.

Selecione Development no combo-box Group Account e configure os seguintes direitos de acesso:


InduSoft Web Studio

Página 358

Direitos de Acesso: Development

Clique em OK para salvar essa configuração.

Notas:

Cada grupo possui uma escala para nível em desenvolvimento e runtime. Em algumas planilhas (por exemplo, na planilha Math), pode-se configurar um nível de acesso para prover o grupo com acesso à configuração dessa planilha.

Ao logarem-se no sistema, os usuários deverão estar associados ao grupo específico, com escala de nível de acesso (desenvolvimento) para a determinada planilha.

Pode-se também configurar níveis de acesso de modo que somente usuários autorizados possam executar comandos (scripts) configurados no ambiente de desenvolvimento.

Definindo Usuários

A seguir, deve-se criar novos usuários e associá-los a contas de grupos já criados. Siga os seguintes passos:

Em Workspace, selecione o tab Database e clique duas vezes na pasta Security para visualizar as subpastas.

Clique com o botão direito na pasta Users e selecione Insert User no menu pop-up.


InduSoft Web Studio

Página 359

Inserindo Novos Usuários

O diálogo User Account aparecerá:

Diálogo User Account

Lembre-se de que não é possível deletar o usuário padrão Guest. Deve-se criar novos usuários, como se segue.

Clique no botão New e o diálogo New User Account aparecerá. A seguir, digite um nome do usuário nesse campo. (Nesse exemplo, digite Operator_1.) Clique em OK para fechar o diálogo.

Criando Operator_1 User

Para associar esse usuário à conta de grupo, retorne para o diálogo User Account e verifique se Operator_1 ainda aparece no combo-box User.

Selecione Operation no combo-box Security Group.


InduSoft Web Studio

Página 360

Conta do Usuário Operator

Para especificar uma senha para esse usuário, clique no botão Password e o diálogo User Password. Digite oper_1. Clique em OK para fechar o diálogo.

Reabra o diálogo User Account e adicione o próximo usuário:

Clique no botão New e quando aparecer o diálogo New User Account, digite MaintEng_1 no campo User Name. Clique em OK para fechar o diálogo.

Associe esse usuário à conta de grupo Maintenance e clique em Password para definir main_1 como a sua senha.

Criando MaintEng_1 User

Reabra o diálogo User Account mais uma vez, e adicione o último usuário, como se segue:

Clique em New e crie o usuário Developer_1.

Associe esse novo usuário à conta de grupo Development e especifique deve_1 como sua senha.

Criando Developer_1 User

Clique em OK para salvar a configuração.

Agora, caso você queira ampliar a pasta Security, você deverá abrir todas as subpastas e verificar os grupos e usuários recém criados.


InduSoft Web Studio

Página 361

Visão ampla dos Grupos de Segurança e Usuários

Nota: Pode-se também utilizar a função CreateUser para a criação de novos usuários. Junto à aplicação, os usuários criados dessa maneira aparecerão na pasta Users.

Botões de configuração

Pode-se utilizar o check-box User is blocked e o botão Settings (o qual substitui o botão Password utilizado anteriormente) para controlar o acesso do usuário à aplicação. Pode-se também acessar esses recursos a partir do diálogo User Account.

Siga os seguintes passos para abrir esse diálogo e configurar o acesso do usuário:

Em Workspace, amplie a pasta Security e clique com o botão direito em um nome do usuário.

Quando o menu pop-up aparecer, selecione Properties para abrir o diálogo User Account:

Security – User Properties: Diálogo User Account

Se necessário, clique no check-box User is blocked para bloquear o usuário selecionado.

Clique no botão Settings para abrir o diálogo Settings:


InduSoft Web Studio

Página 362

User Account: Diálogo Settings

Configure os parâmetros desse diálogo como se segue:

text box User Full Name (opcional): Digite o nome complete do usuário.

text box New Password: Digite a senha do usuário.

text box Confirm Password: Digite a senha do usuário novamente.

Ao terminar, clique em OK para aplicar as alterações, e a seguir feche o diálogo Settings.


InduSoft Web Studio

Página 363

botão Advanced

Pode-se utilizar o botão Advanced para controlar o acesso do usuário à Aplicação, através do diálogo User Account.

Siga os seguintes passos para abrir esse diálogo e configurar o acesso do usuário:

Em Workspace, amplie as pastas Security e Groups, e clique o botão direito em um nome de grupo.

Quando aparecer o menu pop-up, selecione Properties para abrir o diálogo Group Account.

Clique com o botão direito em Properties

Clique no botão Advanced para abrir o diálogo Advanced:

Group Account: Selecionado o botão Advance


InduSoft Web Studio

Página 364

Group Account: Diálogo Advanced

Configure os parâmetros no diálogo Advanced como se segue:

text box Minimum Password Size: Digite um valor maior do que 0 nesse campo para requisitar um número mínimo de caracteres para uma senha. Todos os usuários assinalados para esse grupo deverão fornecer a uma senha contendo um número mínimo de caracteres. Caso o usuário tente criar uma senha com menos caracteres do que o número requisitado, o InduSoft Web Studio rejeitará a senha e exibirá a seguinte mensagem de aviso:

Mensagem de Aviso para Senha Inválida

text box Password aging: Digite um valor maior do que 0 nesse campo para estabelecer a duração (em dias) de uma senha. Após a especificação do número de dias de validade, InduSoft Web Studio forçará os usuários assinalados nesse grupo a alterar suas senhas. Ao tentar logar-se com a senha antiga, o diálogo Change Password aparecerá automaticamente para o usuário, e esse não poderá completar o processo de log-in até que a nova senha seja fornecida.


InduSoft Web Studio

Página 365

Diálogo Change Password

text box E-signature time-out: Digite um valor maior que 0 nesse campo para especificar um período time-out (em minutos). Os usuários assinalados nesse grupo deverão inserir seus User ID e senha antes que o período de timeout especificado expire, para assim poderem executar os comandos que requeiram uma assinatura eletrônica. Antes do período de timeout expirar, o usuário sera questionado a respeito de sua senha – o sistema assume de forma automática o username logado na última assinatura eletrônica. O sistema reinicia a contagem de time-out logo após uma assinatura eletrônica ser executada.

text box Disable E-signature: Quando o valor neste campo for VERDADEIRO (diferente de zero), a assinatura eletrônica é desabilitada para a aplicação inteira. Ao configurar um Tag neste campo, você pode permitir/incapacitar a assinatura eletrônica dinamicamente durante o runtime.

Auto Log Off: Permite que você desconecte o usuário atual automaticamente

text box Log Off after: O número de minutos depois do qual o usuário atual deve ser desconectado automaticamente. Se este campo estiver em branco (ou com o valor 0), o usuário atual nunca será desconectado automaticamente

radio button Count time after logon: Quando esta opção é selecionada, o usuário atual é desconectado automaticamente após o período de tempo configurado no campo Log Off after desde quando o usuário atual conectar ao sistema

radio button Count time after last action: Quando esta opção é selecionada, o usuário atual é desconectado automaticamente após o período de tempo configurado no campo Log Off after desde que a última ação (ação do mouse ou do teclado) foi executada pelo usuário atual

check-box Enable: Habilite esse box para ativar os seguintes recursos de Account Lockup.

* Text box Lock-up account after: Digite um valor nesse campo para definir o máximo de tentativas permitidas a um usuário para logar-se a uma conta. Caso o usuário exceda o número máximo de tentativas (fornecendo senhas inválidas), o InduSoft Web Studio bloqueará a conta do usuário.

* text-box Reset counter after: Digite um valor nesse campo para definir por quanto tempo, após uma tentativa inválida, o InduSoft Web Studio esperará (em minutos) até que se reinicie a contagem de tentativas.

Nota: Quando um usuário exceder o número específico de tentativas de log-on, o InduSoft Web Studio bloqueará automaticamente, e não reiniciará a contagem — após Reset counter after expirar. O Administrador do Sistema deverá reiniciar a conta do usuário desabilitando o check-box User is blocked no diálogo User Account ou executando a função UnblockUser().

Um círculo vermelho no nome do usuário em Workspace indica que o usuário está bloqueado. Além disso, o box User is blocked estará habilitado. As figuras a seguir são exemplos que indicam que o usuário Eng está bloqueado:


InduSoft Web Studio

Página 366

Exemplo: Usuário bloqueado

Ao terminar, clique em OK para aplicar suas alterações e feche o diálogo Advanced.

Sistema de Segurança Remoto

Caso a sua aplicação seja conectada através de um link TCP/IP, é possível designar uma de suas estações como o sistema de segurança Central, a partir da qual outras estações posam utilizar as definições de Users e Groups. A figura a seguir ilustra essa configuração:

Sistema de Segurança Remoto

Siga o seguinte procedimento para configurar um sistema de segurança central:

Clique com o botão direito na pasta Security no tab Database e selecione Settings no menu pop-up para abrir o diálogo Security System:

Clique com o botão direito em: Security Settings


InduSoft Web Studio

Página 367

Habilite o novo check-box Use preferentially the Remote Security System para designar um sistema de segurança remoto.

Caso a aplicação remota seja conectada com sucesso ao sistema de segurança da estação Server, sera utilizado o sistema de segurança configurado nessa estação. Nesse caso, qualquer alteração implementada no sistema de segurança da Estação Server será incorporada automaticamente pela aplicação remota. As funções do sistema de segurança (como CreateUser(), RemoveUser(), ChangePassword(), etc) serão atualizadas no sistema de segurança da estação Server — mesmo se as funções forem executadas a partir de uma aplicação remota. Como resultado, todas as aplicações em um sistema distribuído podem compatilhar das configurações de um mesmo sistema de segurança.

Caso o sistema remoto não esteja rodando ou não possa ser alcançado e a aplicação não possa ser conectada, uma mensagem (abaixo) será logada na output window e salva no arquivo event:

Error connecting to Remote Security Server ‘192.168.1.255’

Além disso, a aplicação se reverterá utilizando-se das configurações de segurança do computador local. A aplicação remota tentará conectar-se à estação Server do sistema de segurança apenas quando houver um evento associado ao sistema de segurança (como um logging on de usuário), ou seja, não há polling entre a aplicação remota e a estação Server durante o runtime.

Configurando o Nível de Acesso de Segurança Pode-se utilizar os check-boxes Security Level-Development para configurar uma escala única de valores para cada grupo de usuário. Pode-se também configurar uma escala única para qualquer planilha do InduSoft Web Studio (Alarm, Math, Recipe, Report, Scheduler, TCP Client, Trend, e aquelas que não estão disponíveis em CE: DDE Client, OPC Client, e ODBC).

Clicando em qualquer ponto da planilha pode-se ativar a opção Edit → Access Level da barra de menu principal, o que abrirá o diálogo Security, o que permitirá assinar um Access Level para aquela planilha.

Diálogo Security

Assinar um nível de segurança para uma planilha significa que um usuário poderá ter um nível de acesso que caia com o Nível de Segurança especificado – escala de Desenvolvimento para editar aquela planilha.

Por exemplo, UserA de GroupA possui uma escala de nível de acesso de segurança 0-10 e UserB de GroupB possui um escala de nível de acesso de segurança de 5-15. Continuando o exemplo:

• Planilha Math 001 tem Nível de Acesso = 1




Consequentemente,

• Somente UserA pode acessar a Planilha Math 001

• Ambos os usuários podem acessar a Planilha Math 002

• Somente UserB pode acessar a Planilha Math 003


InduSoft Web Studio

Página 368

• Nenhum usuário pode acessar a Planilha Math 004

Definindo Usuários Clique no botão User Account para abrir o diálogo User Account. Pode-se utilizar esse diálogo para criar e manter contas de usuário para sua Aplicação. (Os usuários definidos em sua aplicação para cada grupo utilizando o diálogo Group Account.)

Nota: Alternativamente, pode-se acessar o diálogo User Account da pasta Users localizada na pasta Security no tab Database ou selecionando Insert → User na barra de menu principal.

Diálogo User Account

Utilize os recursos nesse diálogo como se segue:

• combo-box User: Selecione de uma lista de usuários da aplicação.

• combo-box Security Group: Selecione de uma lista de grupos da Aplicação.

• Botão New: Abra o diálogo New User Account para criar um novo usuário.

• Botão Delete: Deleta o usuário selecionado.

• Botão Password: Abre um diálogo User Password para definir senhas do usuário.

Diálogo User Password

Especificando Usuários Guest Após iniciar o InduSoft Web Studio, um usuário estará logado como um usuário Guest (por padrão). Caso nehum dos outros usuários efetuem log on ou o usuário atual efetue log off, o InduSoft Web Studio loga automaticamente o usuário Guest.

O grupo Guest possui privilégios padrão. Os parâmetros da instalação do grupo Guest permitem que todas as tarefas sejam habilitadas por padrão. Devido a isso, você deverá alterar esses parâmetros e configurar alguns poucos privilégios à medida que sejam necessárias para o procedimento de start-up.


InduSoft Web Studio

Página 369

Logging On/Off Após definir os nomes do usuário e suas senhas, utilize a utilidade Logon (Project → Logon) para logar usuários em on e off.

Deforma alternativa, pode-se utilizar as funções de ativação de linguagem de Scripting do InduSoft Web Studio LOGON( ) e LOGOFF( ) para logar ou deslogar usuários (on/off).

Diálogo Log On

Utilize os recursos desse diálogo como se segue:

• Campo User Name: Insira o nome do usuário para efetuar log on.

• Campo Password: Insira a senha do usuário.

• Botão Log Off: Clique para efetuar log off do usuário atual.

Nota: Quando um Logoff é executado, o usuário Guest torna-se logado de forma automática.


InduSoft Web Studio

Página 370

Capítulo 12: Testando e Corrigindo Erros em Sua Aplicação Esse capítulo explica como utilizar as diferentes ferramentas do IWS para testar e corrigir erros nas aplicações de seu projeto.

Testando sua Aplicação Utilize os procedimentos a seguir para testar sua Aplicação:

• Project → Test Display: Ativa o modo de exibição, o qual permite a configuração da aplicação ao mesmo tempo que visualiza dinâmicos gráficos online no ambiente de desenvolvimento. O modo de exibição teste não habilita a utilização Command, dinâmicos Text I/O de entrada ou execução de planilhas.

Nota:

Utilizando a opção do menu Test Display é o mesmo que utilizar o botão na barra de ferramentas Execution Control.

• Project → Stop display test: Pára o modo de exibição teste.

Nota:

Utilizar a opção do menu Stop display test é o mesmo que utilizar o botão na barra de ferramentas Execution Control.

• Project → Run Application: Inicia os módulos de runtime especificados como Automatic no diálogo Project Status (tab Execution Tasks).

Ao iniciar o módulo Viewer, abre-se uma tela (s) que etá sendo atualmente editada.

Caso você não queira especificar nenhuma tarefa como Automatic, o InduSoft Web Studio iniciará as tarefas Viewer e BGTask automaticamente ao executar Run Application.

Caso você não esteja editando telas atualmente no ambiente de desenvolvimento, o módulo Viewer abrirá a tela especificada no campo Startup screen no tab Runtime Desktop (diálogo Project Settings).

Nota:

Utilizar a opção do menu Run Application é o mesmo que utilizar o botão na barra de ferramentas Execution Control.

Atenção: Run Application afeta a aplicação a partir da target station (configurada no diálogo Execution Environment). Certifique-se de que a target station desejada esteja configurada (local ou remota) antes de executar o comando Run Application.

• Project → Stop Application: Pára todas as tarefas de runtime.

Caution: Stop Application afeta a aplicação a partir da target station (configurada no diálogo Execution Environment). Certifique-se de que a target station desejada esteja


InduSoft Web Studio

Página 371

configurada (local ou remotamente) antes de executar o comando Stop Application.

Nota:

Utilizar a opção do menu Stop Application é o mesmo que utilizar o botão na barra de ferramentas Execution Control.

Corrigindo Erros da Aplicação a partir do Database Spy

Notas: A output window é reposicionável, significando que pode-se movê-la para outro local do ambiente de desenvolvimento. Clique uma vez na barra de título e arraste-a para o novo local.. Solte o mouse para anexar ou reposicionar a janela para sua nova localização.

Para uma descrição da janela Database Spy e seus componente, reveja “Utilizando o ícone Database Spy” no Capítulo 3: Trabalhando com o Ambiente de Desenvolvimento do IWS.

O Database Spy é uma ferramenta de correção de erros muito útil, já que habilita:

• Envio de valores para o tag databases e monitoramento de resultados

• Executar diferentes funções e equações

Amostra da Janela Database Spy

O Database Spy contém quarto tabs DB onde pode-se inserir grupos de tags, funções e/ou expressões as quais você deseja testar e corrigir erros.

Cada tab DB contém uma spreadsheet com os seguintes componentes

• Name: Exibe o tagname e/ou função a ser validada nessa linha.

• Value: Exibe valores de retorno e resultados de equações

• Quality: Exibe uma validação da qualidade (Good ou Bad) do tag ou da origem da função

• Continuous: Exibe se o IWS está revalidando tags, funções e equações continuamente.

A criação de diferentes grupos habilita o gerenciamento de múltiplas tarefas de teste/correção de erros. Por exemplo, pode-se criar um conjunto de tags em DB1 para testar uma função de receita, e criar um outro grupo de tags em DB2 para testar a função de tendência.


InduSoft Web Studio

Página 372

Para testar sua aplicação com a utilização do Database Spy, siga o processo a seguir para configurar a spreadsheet:

Clique duas vezes em uma linha vazia na spreadsheet para abrir o diálogo Object Finder

Pode-se utilizar o diálogo Object Finder para adicionar tags, expressões ou funções para a coleção de dados do processo. Pode-se utilizar o diálogo New Tag para enviar dados para testar um tag ou coletar dados para um tag.

* Clique no ícone Toggle Database Spy Window na barra de ferramentas Standard

* Aperte Alt+2 no teclado

* Selecione View → Toolbars → Database Spy para reabrir a janela.

Caso você tenha problemas com alguma função, faça uma cópia da função e utilize o disparador Database Spy ao invés de rodar a aplicação várias vezes no ambiente de desenvolvimento.

Nota: Algumas funções, como report(), recipe() e math(), devem ser executadas como Background Tasks durante o runtime para funcionarem de maneira apropriada.

Corrigindo Erros da Aplicação a partir da Janela Output Utilize a output window(LogWin) (localizada próxima ao Database Spy) para visualizar mensagens de correção de erros fornecidas pelo IWS. (Nota: Pode-se clicar duas vezes no item de uma linha para abrir a planilha ou tela.)

Exemplo de Janela Output

Por exemplo, pode-se verificar a comunicação serial com um PLC.

Notas: A output window é reposicionável, significando que pode-se movê-la para outro local do ambiente de desenvolvimento. Clique uma vez na barra de título e arraste-a para o novo local.. Solte o botão do mouse par anexar ou reposicionar a janela para sua nova localização.

Veja o Capítulo 3: Trabalhando com o Ambiente de Desenvolvimento do IWS para uma descrição detalhada da janela Output.


InduSoft Web Studio

Página 373

A output windowcontém os seguintes tabs:

• tab Log: Semelhante em função ao módulo LogWin, embora forneça funcionalidade limitada para redução do tempo e memória utilizada junto ao ambiente de desenvolvimento. Esse tab utilizao princípio first-in first-out (FIFO) para gerenciar o espaço disponível.

Clique com o botão direito na output windowe o menu pop-up aparecerá:

Clique com o botão direito para exibir Options

Settings: Abre o diálogo Log Settings onde você deverá especificar opções e tags os quais você deseja que sejam procurados e logados pelo IWS para fins de correção de erros.

Diálogo Log Settings

Utilize os dois tabs desse diálogo para especificar o tipo de informação que você deseja que o IWS logue e exiba na janela Output.

* tab Log Options: Habilite ( ) os check-boxes para logar os seguintes eventos:

Comandos Field Read e Field Write

Comunicação Serial

OPC, TCP/IP

Recipes/Reports


InduSoft Web Studio

Página 374

Abrir e fechar a exibição

Log-on e Log-out

Trace, Database, DDE Messages

Inserir data e hora

* tab Log Tags: Utilize o botão Add para abrir o diálogo Object Finder, o qual pode ser utilizado para criar uma lista de tags a serem monitoradas pelo IWS. (Os passos para utilizar o diálogo Object Finder são fornecidas em “Corrigindo Erros da Aplicação a partir doCorrigindo Erros da Aplicação a partir do Database Spy” na página 371.) Utilize os botões Remove ou Remove All para deletar nomes de tag da lista.

Sempre que uma ação específica ocorre ou um valor de tag é alterado, o IWS loga os resultados na janela Output—através do driver, módulos, etc que iniciaram a alteração.

Pause: Selecione (habilite) para parar o processo de coleção de dados temporariamente, e reselecionar (desabilitar) para resumir a coleção de dados.

Hide Window: Selecione para fechar (ocultar) a janela Output.

Para reabrir a janela, pode-se:

* Clicar no ícone Toggle Output Window na barra de ferramentas Standard.

* Apertar Alt+1 do teclado.

* Selecionar View → Toolbars → Output para reabrir a janela.

Cut, Copy, Delete, Select All: Tornam-se ativos ao selecionar uma entrada na janela Output.

Para imprimir os resultados da janela Output, selecione o texto que você deseja imprimir. Clique com o botão direito e selecione Copy do menu pop-up. Pode-se colar os resultados no Notepad (ou em outra aplicação) e imprimir o relatório a partir do NotePad.

Caso você tenha configurações estabelecidas (Utilizando o diálogo Log Settings) no ambiente de desenvolvimento, essas configurações serão transferidas para sua CE station, juntamente com a aplicação, de forma que você possa criar um log a partir da CE station. Pode-se alterar as configurações a partir de sua CE station, ou alterar as configurações do Development e reenviá-las para sua CE station.

• X-Ref tab: Utilize o campo Object Finder para obter um tag e encontrar cada local na aplicação onde o tag está sendo utilizado. Os resultados aparecem nesse tab, fornecendo o caminho e o nome do arquivo, coluna e linha na spreadsheet. Assim, caso algo altere-se no tag e produza resultados inesperados ou incorretos, pode-se localizar todos os exemplos do tag para correção de erros.

Notas: O tab X-Ref não trabalha para Funções, somente tags, embora permita a procura de índices.

Veja também “Utilizando o ícone Object Finder,” no Capítulo 3: Trabalhando com o Ambiente de Desenvolvimeto do IWS.

Utilizando o Módulo LogWin (NT e CE) Esse modulo fornece um histórico continuo de atividades e tags para correção de erros em grandes períodos de tempo. Ele cria um arquivo no qual você pode dump os resultados da coleção de dados, e esse arquivo continua a crescer em tamanho até que você pare o processo de logging (coleção de dados). Utilize o módulo LogWin (local e remoto) para gravar transações DDE, OPC, e TCP/IP, ativar módulos, traçar tags, etc.


InduSoft Web Studio

Página 375

Para iniciar LogWin, vá para Project → Status localmente ou selecione LogWin do menu Tools no box CE.

Iniciando LogWin

Para corrigir erros em Web client, habilite Log selecionando Project → Settings da barra de menu, e depois selecionando o aba Web. Habilite o check-box Enable e digite path+filename na opção FileName. Ao terminar, selecione OK.


InduSoft Web Studio

Página 376

Corrigindo erros em Web Client

Utilizando Ferramentas Remotas O InduSoft Web Studio oferece gerenciamento e configuração da aplicação online (download/upload, comandos, diagnósticos do sistema e rede de trabalho, além de coreção de erros). Pode-se configurar e corrigir erros das aplicações remotamente, utilizando um link TCP/IP.

Pode-se utilizar a barra de ferramentas Execution Control para executar e gerenciar uma aplicação localmente ou a partir de um local remoto.

Barra de Ferramentas Execution Control

• botão Test Display ( ): Permite rodar em modo teste de exibição, o qual permite a configuração de uma aplicação enquanto visualize-se dinâmicos gráficos online no ambiente de desenvolvimento.

• botão Stop Test Display ( ): Permite parar de rodar o modo teste de exibição.

• botão Run Application ( ): Permite iniciar quaisquer módulos de runtime especificados como Automatic.

• botão Stop Application ( ): Permite parar todas as tarefas de runtime.

Atenção: Stop Application afeta a aplicação a partir da target station (configurada no diálogo Execution Environment). Certifique-se de que a target station está configurada (local ou remotamente) antes de executar Stop Application.


InduSoft Web Studio

Página 377

• botão Send project to target ( ): Permite enviar a aplicação para a target station remota.

• botão Execution Environment ( ): Permite o gerenciamento de estações de trabalho remotas.

Com esse botão, pode-se:

Conectar-se a uma estação remota

Enviar/atualizar arquivos do sistema (somente CE)

Enviar/atualizar arquivos da aplicação

Enviar arquivos

Importar arquivos para a Aplicação

Importar logs CE

Licenciar remotamente (somente CE)

Notas: Para uma descrição da barra de ferramentas Execution Control, veja Capítulo 7: Configurando Telas e Gráficos.

Para uma descrição para Configurar o Ambiente de Desenvolvimento, veja Capítulo 14: Gerenciando Aplicações Remotamente.

Utilizando Database Spy Remoto

Selecione a opção do menu Tools → Remote Database Spy para logar-se em um computador remoto que esteja rodando a aplicação Database Spy, e monitorar a aplicação. Quando o diálogo Remote Computer aparecer, insira o endereço Remote IP do computador.

Nota: Nem todos os equipamentos podem suportar o Remote Database Spy.

Utilizando LogWin Remoto

Selecione a opção do menu Tools → Remote LogWin para logar-se em um computador remoto que esteja rodando o LogWin, e monitorar a Aplicação. Quando o diálogo Remote Computer aparecer, insira o endereço Remote IP do computador.

Notas: Nem todos os equipamentos podem suportar o Remote Database Spy.

Para um descrição detalhada de Gerenciando Aplicaçãos remotamente, veja Capítulo 14: Gerenciando Aplicações Remotamente.


InduSoft Web Studio

Página 378

Capítulo 13: Configurando uma Web Solution Esse Capítulo explica como configurar e rodar uma aplicação Web Thin Client. Após desenvolver e testar uma aplicação em seu computador local, o InduSoft Web Studio capacita visualizar e rodar a aplicação em um Web Browser padrão (como Internet Explorer ou Netscape) de qualquer PC padrão, laptop ou equipamento móvel.

Você pode:

Ler e registrar dados diretamente de um PLC ou um equipamento de campo inteligente.

Atualizar dados dinamicamente, baseando-se em valores de registro atuais lidos a partir do PLC.

Fornecer interfaces IHM (como button e text input) para enviar comandos ou setpoints para o PLC ou equipamento.

A figura a seguir ilustra o processo de transferir uma aplicação do ambiente de desenvolvimento do IWS para o Web Thin Client (Browser).

Visualizando aplicações em um Web Thin Client (Browser)

O computador Data Server (Rodando IWS ou CEView) coleta dados (como equipamentos de chão de fábrica) e envia os dados para o Web Thin Client. Um módulo TCP/IP Server (fornecido pelo IWS e/ou CEView) é requisitado para habilitar essa comunicação.


InduSoft Web Studio

Página 379

Nota: O módulo TCP/IP utiliza a porta TCP #1234 por padrão. Deve-se alterar a localização dessa porta (por exemplo, para previnir um conflito ou assuntos relacionados à segurança, como um firewall), veja “Configurando os Parâmetros do Tab Options” no Capítulo 6: Criando e Configurando um Projeto para maiores intruções.

O computador Web Server contém as páginas .html da aplicação (armazenadas em uma pasta \Web). Deve-se ter um Server HTTP Server rodando nesse computador para habilitar o Web Thin Client a efetuar downloads de páginas .html com a utilização do protocolo HTTP. O HTTP Server pode ser o IIS Web Server tipicamente fornecido pela Microsoft ou o IWS Web Server (NTWebServer.exe), fornecido pela InduSoft para sua maior comodidade. O HTTP Server sempre utilize a Porta TCP/IP #80 (reservada para protocolo HTTP).

Notas: A Microsoft fornece Web servers para todos os sistemas operacionais Microsoft. Consulte sua documentação Microsoft para informações sobre como instalar e configurar um IIS Web Server.

Data Server e Web Server podem estar em um mesmo computador (não obrigatório).

Deve-se certificar-se de que existam firewalls entre estações Web Thin Client e Server para bloquear as portas TCP/IP utilizadas pelos Servers TCP/IP e HTTP.

O Web Thin Client efetua downloads de páginas .html a partir do computador Web Server, e requisita um componente ActiveX chamado ISSymbol.ocx para processor as páginas .html junto ao Browser.

Nota: Caso seu computador não tenha um componente ISSymbol.ocx já instalado, o Web Thin Client efetuará o download e inicializará um componente ISSymbol.ocx a partir do site da InduSoft na Web automaticamente.

O componente ISSymbol.ocx efetua downloads de telas e arquivos de banco de dados (<Screen>.SCC, <Screen>.TAGL, <TAGI.BIN>, <CLASS.LST>) a partir do Web Server utilizando o protocolo HTTP sobre TCP/IP.

O componente ISSymbol.ocx também avalia usuários que estejam tentando logar-se ao Web Thin Client. Após autorizar a entrada do usuário, o ISSymbol.ocx exibe a tela da aplicação e inicializa um módulo TCP/IP Client virtual para troca de dados com modulo TCP/IP Server do Servidor de Dados. Esse mádulo TCP/IP Client virtual lê todos os valores do TCP/IP Server.

Ao exibir a tela de sua aplicação no Browser, o Web Thin Client e o Data Server estão habilitados a trocar valores de dados. Consequentemente, se cada tag da tela (configurado como um tag Server) alterar seu valor em quaisquer dos equipamentos em runtime, o novo valor do tag sera enviado imediatamente e automaticamente para todos os outros equipamentos. Não há pooling de dados entre equipamentos, o que resulta em uma melhor performace.

Caso você tenha especificado quaisquer tags indiretos (@<TagName>) para a tela de sua aplicação, os tags para os quais os tags indiretos estão apontando devem ser configurados na mesma tela, ou o Web Thin Client não poderá receber os valores do tag a partir do Data Server.

O Web Thin Client executa funções e expressões configuradas na tela (como o dinâmico Command). Consequentemente, caso você tenha funções que devam ser executadas somente no Server, deve-se configurar as funções em uma planilha Math ou Scheduler do IWS.

O restante desse Capítulo explicará como configurar suas aplicações para um Web Thin Client.


InduSoft Web Studio

Página 380

Antes de Começar

Antes que se possa rodar sua aplicação do IWS Aplicação em um Web Thin Client (Browser), deve-se cumprir as seguintes tarefas:

• Definir uma pasta de diretório Home para suas páginas da Web.

Instalar e registrar o componente ISSymbol.ocx ActiveX.

Certificar-se de que o IIS Web Server esteja apontando para a pasta de diretório Home , e de que o NTWebServer.exe do IWS ou uma cópia deste esteja rodando na pasta de diretório Home.

Nota: A Microsoft fornece Web servers para todos seus sistemas operacionais. Consulte sua documentação Microsoft para informações sobre como instalar e configurar um Web Server.

• Verificar que o TCP/IP Server está rodando.

• Configurar os tags da sua aplicação para Server caso você queira visualizar os resultados desses tags no Browser. (Reveja “Compartilhando Tags comCompartilhando Tags com um Web Thin Client” no Capítulo 5: Trabalhando com Tags.)

Seguem-se instruções para executar tais tarefas.

Definindo um Diretório Home

Deve-se definir uma pasta de diretório Home (somente uma por computador), na qual as páginas da web serão armazenadas. A InduSoft recomenda a utilização da subpasta \Web, localizada na pasta da aplicação do projeto. Por exemplo

C:\Program Files\InduSoft Web Studio\Projects\<project_name>\Web

Nota: Para habilitar a tradução para Web Thin Clients, deve-se copiar manualmente arquivos de tradução (*.TRA) para a pasta \Web.

Instalando e Registrando ISSymbol.ocx

Para visualizar telas das aplicações em um Browser, o Web Thin Client requisita um componente ActiveX chamado ISSymbol.ocx. Esse componente pode ser instalado de uma das seguintes formas:

• Ao instalar o IWS, o programa automaticamente instala e registra esse componente.

• Ao conectar um Web Thin Client à Internet e esse compoente ainda não está instalado, o IWS conecta-se automaticamente ao site da InduSoft na Web, efetuando o download e registrando o componente.

• Pode-se copiar ISSymbol.cab da subpasta do IWS \BIN e colar no diretório \<OSPath>\System32, na estação Web Thin Client station. Utilize o WinZip® para desempacotar (extrair) os arquivos do ISSymbol.cab no diretório \<OSPath>\System32 e registrar o ISSymbol.ocx utilizando o comando regsvr32 ISSymbol.ocx.

O caminho recomendado para registrar o ISSymbol manualmente em um computador que não possua acesso à Internet é seguindo o procedimento abaixo:

Copiar ISSymbolA.cab, ISSymbol.cab e ISSymbolReg.exe da subpasta \BIN do diretório de instalação do InduSoft Web Studio e colar esses arquivos em qualquer diretório da estação Web Thin Client.

Executar o programa ISSymbolReg.exe. Ele registrará o controle ISSymbol automaticamente.


InduSoft Web Studio

Página 381

Nota: Ao utilizar o parâmetro /s (Silent), o ISSymbolReg.exe não exibe qualquer mensagem de texto (por exemplo, ISSymbolReg.exe /s).

Ao utilizar o parâmetro /u (Unregister), o ISSymbol não está registrado (por exemplo, ISSymbolReg.exe /u).

Rodando o Web Server

Deve-se possuir um Web Server rodando e apontando para a pasta do diretório Home (uma pasta em seu computador onde você armazenada páginas da Web). Pode-se utilizar o Windows IIS Web Server ou uma cópia do IWS Web Server (chamado NTWebServer.exe), fornecido junto ao InduSoft Web Studio para sua maior comodidade.

Nota: A maioria dos computadores Windows CE possuem um Web server padrão similar ao IIS, e o IWS prove um Web server semelhante ao NTWebServer.exe. Os passos para configuração de ambos em CE são os mesmos para a configuração do Windows NT/2000/XP (descritos nas seções que se seguem).

Configurando um IIS Web Server

Para configurar o IIS Web Server: Selecione Start → Settings → Control Panel → Administrative Tools → Internet Services

Manager. Quando a janela IIS aparecer, amplie as pastas no painel à esqueda até que você visualize a

pasta Default Web Site.

Clique com o botão direito na pasta Default Web Site, selecione Properties do menu pop-up, e aparecerá o diálogo Default Web Site Properties.


InduSoft Web Studio

Página 382

Seleione o tab Home Directory e especifique o caminho do diretório Home no campo de texto Local Path (similar a figura que se segue):

Configurando o IIS Web Server

Clique em OK para fechar o diálogo.

Configurando o IWS Web Server

Para colocar uma cópia do NTWebServer.exe do IWS em seu diretório Home:

Abra C:\Program Files\InduSoft Web Studio\Bin e localize o arquivo executável NTWebServer.exe.

Copy o arquivo e cole na pasta designada como o diretório Home para suas páginas da Web. Por exemplo,

C:\Program Files\InduSoft Web Studio\Projects\<project name>\Web\NTWebServer.exe


InduSoft Web Studio

Página 383

Rodando O TCP/IP Server

Para verificar que o TCP/IP Server está rodando em seu computador (ou no computador runtime):

Selecione Project → Status da barra de menu principal para abrir o diálogo Project Status dialog.

na aba Execution, verifique que o TCP/IP Server está Started ou ajustado a Automatic.

Verificando Status do TCP/IPServer

Se o TCP/IP Server é ajustado para Manual ou Stopped:

Para ligar o Server imediatamente, clique no botão "Start"

Para configurar o Server para iniciar automaticamente, clique no botão Startup. Quando o diálogo Startup aparecer, selecione o radio buton Automatic e depois clique em OK .

Iniciando o TCP/IP Server Automaticamente

Clique em OK para fechar o diálogo Project Status.


InduSoft Web Studio

Página 384

Configurando a Aplicação Salve a tela de sua aplicação em formato HTML, utilizando os passos a seguir:

Amplie a pasta Screens no Workspace e clique duas vezes no botão Aplication para abrir a tela.

Abrindo a Tela da Aplicação

Selecione File → Save as HTML para salvar a tela (ou Save All as HTML para salvar múltiplas telas abertas) em formato HTML.

O IWS salva automaticamente a tela (como um arquivo .html) em uma pasta Web Pages, a qual representa a pasta /Web do diretório de sua aplicação.

Nova Tela HTML


InduSoft Web Studio

Página 385

A seguir, selecione Project → Settings da barra de menu principal e, quando aparecer o diálogo Project Settings, selecione o tab Web.

Project → Settings → Tab Web

Configure os parâmetros que se seguem nesse tab:

text box Data Server IP: Digite o endereço IP da Server station que esteja rodando o IWS ou CEView. A Web Thin Client station trocará dados online (valores de tags) com a Server station durante o runtime.

Campo Send Period: Digite um valor para especificar a frequencia (em milissegundos) com que Server e Web Thin Client stations trocarão os dados.

check-box Disable Remote Client Commands: Habilite esse box para prevenir um cliente remoto de obter comandos para seu Server através do Web Thin Client.

check-box Enable ToolTips: Habilite esse box para visualizar Windows ToolTips nas telas na aplicação no Web Thin Client (browser).

check-box Auto Screen Scaling: Habilite esse box caso você deseje que todas as telas exibidas no Browser sejam escalonadas automaticamente ao redimensionar a janela do Browser.

check-box Enable File Compression: Habilite esse box para comprimir os arquivos armazenados na pasta \Web da aplicação do projeto.

Comprimir arquivos pode reduzir de forma significativa o tempo para efetuar downloads — particularmente ao utilizar uma conexão lenta entre Server e Web Thin Client.


InduSoft Web Studio

Página 386

Botão IP Security: Clicar nesse botão abre o diálogo IP Security.


Utilize os parâmetros nesse diálogo para controlar quais computadores terão acesso a essa aplicação como Web Thin Clients.

Habilite o check-box Enable, e quando os parâmetros do painel Edit tornarem-se ativos, digite o endereço IP nos campos From e To para especificar a escala de endereços IP. Utilize os botões Add e Remove para mover os endereços IP para a lista IP Address Range. O IWS permite que os computadores listados nesse painel tenham acesso às aplicações como Web Thin Clients.

Log (check-box Enable e text field FileName): Habilite o check-box e digite um nome do arquivo no campo de texto para gerar um arquivo de log na Web Thin Client station. Pode-se utilizar esse arquivo de log para correção de erros.

Para habilitar o Virtual Keyboard para Web Thin Client stations, independentemente da estação local, clique no check-box Virtual Keyboard. Quando esse box está habilitado, os campos Default e Scale tornam-se ativos.

* Default: Selecione o teclado padrão utilizado a ser utilizado na aplicação.

* Scale: Com essa opção, pode-se aumentar ou diminuir os teclados para que moldem-se de forma apropriada ao tamanho da tela do painel alvo. Scale: 100% representa o tamanho padrão de cada Virtual Keyboard. A escala de opções variam de 25% a 400%, embora você também possa inserir uma escala constumizada.

Após configurar os parâmetros no tab Web, clique em OK para fechar o diálogo Project Settings.

Feche as telas no editor de telas (Window → Close All).

Selecione Tools → Verify Aplicação a partir da barra de menu principal para atualizar as Web Settings para as páginas da Web.

IMPORTANTE! Deve-se verificar uma aplicação sempre que os parâmetros para Web da tela sejam alterados no diálogo Project Settings (tab Web).

Verificar que todas as alterações tenham sido aplicadas (ou reaplicadas) à página .html.


InduSoft Web Studio

Página 387

Testando a Aplicação Antes de começar, utilize essa breve lista de tarefas para certificar-se de que você está pronto para testar sua aplicação em um Browser da Web:

Verifique se o componente ActiveX ISSymbol.ocx está instalado e registrado.

Verifique se o IIS Web Server está rodando e apontando para a pasta do diretório Home ou que uma cópia do NTWebServer.exe do IWS esteja rodando na pasta do diretório Home.

Verifique se o TCP/IP Server está rodando.

Verifique se os tags da aplicação estão configurados para Server, caso você deseje visualizar os resultados desses tags no Browser. (Reveja “Compartilhando Tgas com umCompartilhando Tags com um Web Thin Client” no Capítulo 5: Trabalhando com Tags.)

Para testar sua aplicação baseada na Web, siga os passos a seguir:

Clique no botão Run Application (na barra de menu principal do IWS) para executar a aplicação localmente em sua Server station.

Verifique sua Task Bar do Windows, e certifique-se de que TCP/IP Server e Background Tasks estejam rodando corretamente. Verifique se um ou mais drivers estejam rodando.

Verifique se TCP/IP e Background Tasks estejam Rodando

Após abrir a tela da aplicação, abra seu Browser da Internet (como Internet Explorer ou Netscape) e digite o endereço URL (certificando-se de que o diretório Home seja incluído corretamente) para abrir a tela <screen name>.html na Server station (por exemplo, http://192.168.1.100/main.html).

Quando o diálogo Log On aparecer no Browser, digite seu nome de log-on no text box User Name, sua senha no text box Password e clique em OK para abrir a tela <screen name>.html.

Logando-se

Background Tasks Drivers


InduSoft Web Studio

Página 388

Notas:

Caso você não tenha definido usuário na pasta de Security da Aplicação, O User Name padrão do IWS está configurado como Guest sem a necessidade da inserção de senha.

Caso você tenha desabilitado qualquer requisito de segurança da sua aplicação, o diálogo Log On não sera exibido.

Quando o diálogo Log On aparecer, indicará que seu TCP/IP Server está rodando de forma satisfatória. Caso exista um problema com o TCP/IP Server, uma mensagem de erro sera exibida.

Após fechar o diálogo Log On, aparecerá a tela a seguir na janela do Browser, indicando o status do download.

Relatando Status do Download


InduSoft Web Studio

Página 389

Quando o download estiver completo, a tela de sua aplicação será exibida. Nesse ponto, o Web Thin Client deverá ler informações a partir dos tags da tela (por exemplo, o relógio deverá indicar a contagem dos segundos).

main.html no Browser


InduSoft Web Studio

Página 390

Capítulo 14: Gerenciando Aplicações Remotamente Esse Capítulo explica como fazer downloads de uma Aplicação do InduSoft Web Studio para sua estação de trabalho de runtime e então monitorar/gerenciar a aplicação remotamente, a partir de uma variedade de equipamentos distintos.

Fazendo o Download da Aplicação Após configurar e testar uma aplicação localmente (em sua estação de trabalho de desenvolvimento), pode-se fazer o download da Aplicação para uma estação de trabalho remota que esteja rodando o IWS em plataforma Windows NT/2000/XP ou o CEView em um equipamento Windows CE.

Configurando a Target station Antes de começar, verifique que o Remote Agent (CEServer.exe) esteja rodando na target

station (remota).

Em uma plataforma Windows, o arquivo CEServer.exe está localizado na pasta \InduSoft Web Studio\Redist\<CEVersion>\<Processor Type>\BIN (para NT, a localização é a pasta \BIN).

Em um equipamento Windows CE, o arquivo está localizado na pasta \<non-volatile>.

Rode CEServer.exe na estação de trabalho alvo e quando o diálogo Remote Agent aparecer, clique no botão Setup.

Diálogo Remote Agent

O diálogo Setup abre:

Diálogo Setup

Utilize os parâmetros desse diálogo para configurar a comunicação entre as estações de desenvolvimento e alvo:


InduSoft Web Studio

Página 391

Serial Port: Habilite esse botão para estabelecer uma conexão a estação de desenvolvimento, através de uma porta serial. Clique no botão de seta e selecione uma porta de comunicação a partir da lista do combo-box.

Caso você clicar no botão Advanced, o diálogo Serial Advanced Settings abrirá.

Diálogo Serial Advanced Settings

Pode-se utilizar os parâmetros desse diálogo para controlar o fluxo de dados entre as estações alvo e de desenvolvimento:

* Baud Rate: Clique no botão de seta para selecionar um baud rate pré-definido a partir da lista do combo-box

* Control RTS: Habilite ( ) esse box para utilizar um controle “Request to Send”, onde o IWS envia um sinal RS-232 da estação transmissora para a estação receptora, requisitando permissão para a transmissão de dados.

* Control CTS: Habilite ( ) esse box para utilizar um controle “Clear to Send”, onde o IWS envia um sinal RS-232 da estação receptora para a estação transmissora, indicando que a estação receptora está pronta para aceitar os dados.

Ao terminar a configuração desses parâmetros, clique em OK para fechar o diálogo Serial Advanced Settings.

TCP/IP: Habilite esse botão para estabelecer uma conexão TCP/IP com a estação de desenvolvimento.

Nota: Por razões de performance do programa, recomendamos a utilização de uma conexão TCP/IP no lugar de uma conexão Serial Link.

Ao terminar, clique em OK para fechar o diálogo Setup, mas deixe o programa Remote Agent rodando na estação de trabalho remota.

Configurando a Estação de Desenvolvimento Após configurar a target station para o recebimento de dados, utilize os passos a seguir para configurar a estação de desenvolvimento para enviar dados para a aplicação.

Selecione Project → Execution Environment da barra de menu principal (na estação de desenvolvimento).


InduSoft Web Studio

Página 392

Diálogo Execution Environment

Esse diálogo contém a seguinte tabela:

Target: Utilize esse tab para especificar a target station, incluindo:

* Local, Network IP address, Serial Port, ou Microsoft ActiveSync

* Connect/Disconnect a target station

* Rever Status da Estação

* platform Retorna à platafoma (sistema operacional + tipo de processo) da target station após conectá-la.

* Install system files (ou Only newer files)

Aplicação: Utilize esse tab para especificar a aplicação, incluindo:

* Caminhos dos diretórios Local e Target

* Especifcar para Send (a Aplicação) to target station (ou Only newer files)

* Send file

* Run/Stop a Aplicação

* Rever Status da Aplicação

Import: Utilize esse tab para importar uma Aplicação, incluindo:

* Epecificar o caminho da aplicação To e From

* Get From Target

* Get Log File

Rever Status da Aplicação

CE License: Utilize esse tab para especificar License Settings e License Codes para uma licença Windows CE, incluindo:

* Product Type

* Version

* Number of Web Thin Clients

* Site Code

* Site Key

Selecione o tab Target e utilize as opções a seguir para especificar a target station a qual você irá conectar-se.

Local: Selecione esse botão caso você irá rodar a aplicação na mesma estação na qual a aplicação foi desenvolvida.


InduSoft Web Studio

Página 393

Network IP: Selecione esse botão e digite o endereço IP da target station dentro do text box, caso você tenha especificado uma conexão TCP/IP quando configurou a target station.

Serial Port: Selecione esse botão e selecione uma porta da lista do combo-box caso você tenha especificado uma conexão Serial Port quando configurou a target station.

– Microsoft ActiveSync: Selecione esse botão para conectar-se aos equipamentos nos quais MS ActiveSync está habilitado.

Especifcando Tipo de Link e Endereço IP

Clique no botão Connect para conectar-se à estação remota.

Nota: Caso a estação remota seja um equipamento WinCE, pode-se clicar no botão Install System Files para fazer o download dos arquivos de runtime CEView para a estação remota.

Na janela Workspace, selecione o tab Application e clique no botão Send to Target para fazer o download da aplicação para a estação remota.

Especificando Tipo de Link e Endereço IP


InduSoft Web Studio

Página 394

Atenção: Ao enviar uma aplicação para a target station remota, as alterações causam efeitos online, ou seja, após fazer o download dos arquivos da Aplicação para a target station, a nova aplicação (s) substitui a antiga automaticamente – mesmo que a aplicação esteja rodando.

Além disso, caso você desabilite o check-box Only newer files no tab Aplication (no diálogo Execution Environment), o IWS removerá todos os arquivos do diretório da aplicação alvo antes de fazer o download de novos arquivos.

Nota: Caso o download da aplicação for interrompido, o IWS requisitará confirmação, além de aconselhá-lo que a aplicação poderá não rodar de forma apropriada.

Utilizar a opção de menu Send app to target é o mesmo que utilizar o botão Send app to target na barra de ferramentas Execution Control.

Send file: Clique para alcançar o diretório e selecionar um arquivo individual a ser enviado.

Stop button: Clique para parar a Aplicação.

Após fazer o download de todos os arquivos da aplicação, clique no botão Run para executar a aplicação em uma estação de trabalho alvo remota.


InduSoft Web Studio

Página 395

Monitorando/Gerenciando Aplicações a partir de uma Estação Remota Após configurar e testar uma aplicação localmente (em sua estação de desenvolvimento),pode-se fazer o download da Aplicação para uma estação remota em runtime que esteja rodando em Windows NT/2000/XP ou CEView sob Windows CE.

Antes de iniciar, verifique que Remote Agent (CEServer.exe) esteja rodando na target station remota.

Nota: O arquivo CEServer.exe está localizado no seguinte diretório em computadores com Windows 2000/XP (para NT, a localização é na pasta \BIN):

\InduSoft Web Studio\Redist\CEView\<Processor Type>\BIN

O arquivo deve estar localizado na pasta \<non-volatile> do equipamento WinCE.

Após efetuar o download de todos os arquivos da aplicação, clique no botão Run para executar

a aplicação na target station remota.


InduSoft Web Studio

Página 396

Capítulo 15: Linguagens de Script: IWS e VBScript

Trabalhando com com Linguagem de Script do IWS, Expressões e Funções

Essa seção explica como trabalhar com a linguagem de Script (Scripting Language), expressões e funções do InduSoft Web Studio (IWS).

Utilizando Tags Tags são variáveis que podem receber os resultados das expressões especificadas em telas e planilhas (como pontos de comunicação em equipamento de campo, resultados de cálculos, pontos de alarme, etc).

Nota: Recomendamos que você leia e compreenda os conceitos discutidos no Capítulo 5: Trabalhando com Tags antes de ler esse capítulo.

Especificando Tipos de Dados

Pode-se utilizar a Scripting Language do IWS em muitos locais, como:

– Propriedades de objeto dinâmicos

– Lógicas de Telas

– Planilhas Scheduler

– Planilhas Math

Uma planilha Math possui duas colunas:

Tag Name: Nomes dos tags para o recebimento de resultados das expressões especificadas na coluna Expression na mesma linha.

Expression: Expressões matemáticas definidas pelo InduSoft Web Studio.

Por exemplo, Tag Name a, receberá o resultado da Expressão (10*c)-5.

Exemple de Planilha Math

IMPORTANTE! Não são feitas atribuições na coluna Expression. Se você escrever A=2 nessa

coluna, o IWS irá comparar A com o número 2. O resultado inteiro dessa expressão (Valor Boolean 0 se falso, e 1 se veradeiro) será registrado ao tag na coluna Tag Name.

O sistema não diferencia letras minúsculas e maiúsculas.

Para adicionar comentários a uma linha de expressão, utilize os caracteres //.


InduSoft Web Studio

Página 397

São aceitos os seguintes tipos de dados:

– Integer numbers (32 bits): 1 23 45 -123

– Floating point (8 bytes): 1.234 -775.344

– Hexadecimal integer numbers (32 bits): 0x5 0xA0 0xBC4

– Strings (255 caracteres): “demo” “new demo”

Acessando Tag database

Para registrar um valor no banco de dados, utilize o nome do tag diretamente. Por exemplo:

– Na linha de script a seguir, o tag X receberá a soma de dois tags, level e temp:

Exemplo 1

– O IWS permite a leitura e registro de tags com a utilização de referenciais e apontadores. Pode-se declarar um tag que está sendo utilizado com um apontador para outro tag de duas formas:

Como um string (apontador para um tipo indefinido)

Como um apontador para um tipo específico (recomendado)

Exemplo 2

Na figura anterior Valve_Fill_State é uma variável de um tipo de string apontador. A variável @pointer_to_integer é uma apontadora para valores inteiros.

Notas: A sintaxe @tag permite o acesso de um tag a outro tag por referência.

Pode-se utilizar qualquer tag declarado como string como um tag indireto (apontador).

Operações Aritiméticas

O InduSoft Web Studio suporta todas as operações aritiméticas a seguir:

+ adição

- subtração

* multiplicação

/ divisão

> maior que

< menor que

= igual

>= maior ou igual a

<= menor ou igual a

<> diferente de (desigual a)


InduSoft Web Studio

Página 398

Notas: Funções Math são calculadas da esquerda para a direita, de acordo com a ordem especificada na formula por cada operador. Para alterar a ordem de avaliação, coloque em parênteses a parte da formula a ser calculada primeiro. Por exemplo, a formula a seguir é igual a 11, pois a multiplicação é calculada antes da adição. A formula multiplica 2 por 3 e adiciona 5 ao resultado:

5+2*3

Em contraste, caso você utilize parênteses para alterar a sintaxe, 5 e 2 são adicionados juntos e depois multiplicados por 3, dando o valor 21:

(5+2)*3

Operações Lógicas

O InduSoft Web Studio suporta todas as seguintes operações Lógicas:

– AND AND, logic

– NOT NOT, logic

– OR OR, logic

– XOR exclusive or, logic

– & AND, bit

– | OR, bit

– ~ NOT, bit

– ^ XOR, bit

– >>n rotate right – Rotaciona n bits para a direita.

– <<n rotate left– Rotaciona n bits para a esquerda.

Utilizando Funções A função tag names utilizada no IWS deve estar de acordo com a sintaxe que se segue:

– num<Name>: Valor ou tag numérico

– str<Name>: Tag String ou valor

– tag<Name>: Nome do Tag

– optNum<Name>: Tag Numérico opcional ou valor

– optStr<Name>: Tag string opcional ou valor

– optTag<Name>: Nome Opcional do Tag

Essa sintaxe identifica os tipos de argumento requeridos por cada parâmetro da função do IWS.

O InduSoft Web Studio possui centenas de Funções prontas para serem utilizadas. Para uma lista completa das funções disponíveis, veja “Apêndice A: Funções do Studio.”


InduSoft Web Studio

Página 399

Exemplo de Funções:

Funções Execução NT/2K/XP Win CE Web Client

False() Síncrona

If() Síncrona

True() Síncrona

Format() Síncrona

GetBit() Síncrona

Max() Síncrona

Min() Síncrona

SendEmail() Síncrona

Log() Síncrona

Play() Síncrona/Assíncrona

IMPORTANTE: Pode-se utilizar a janela Database Spy para executar qualquer expressão matemática escrevendo a expressão no campo Tag Name e clicando no botão Toggle.

O valor de retorno da expressão será exibido no campo Value.


InduSoft Web Studio

Página 400

Visão Geral do VBScript O Microsoft Visual Script Language (VBScript) é uma linguagem de script simples, flexível e padronizada que permite a implementação de lógicas e algorítimos junto a aplicação do IWS.

O IWS implementa Microsoft Visual Basic Scripting Edition 5.5 ou versões mais atualizadas. Já que o IWS hospeda o VBScript, o usuário pode tirar proveito de todos os recursos fornecidos por essa linguagem, como:

– Utilizar sintaxe, operadores e funções disponíveis na linguagem

– Criar novas variáveis e Procedimentos (Funções e/ou Sub-rotinas)

– Acessar propriedades, métodos e/ou eventos a partir de objetos COM, incluindo controles ActiveX

– Executar as lógicas em qualquer plataforma que suporte VBScript, incluindo Microsoft Windows NT/2K/XP (Server station do IWS), Microsoft Windows CE (CEView) e Microsoft Internet Explorer (Web Thin Client).

Atenção: Ao criar a imagem para o equipamento Microsoft Windows CE, o fabricante do hardware deverá habilitar o suporte para VBScript, de modo que o CEView possa executar os scripts configurados na linguagem VBScript no equipamento. Caso você não esteja certo de que a imagem carregada em seu equipamento seja capaz de suportar o VBScript, consulte o fabricente de seu hardware.

O objetivo dessa documentação é fornecer uma visão geral sobre a integração do VBScript com o IWS. Além disso, esse pode ser utilizado com uma referência rápida para a maioria dos recursos de linguagem mais utilizados. Para uma descrição completa da linguagem, bem como suas interfaces e funções, consulte a documentação da Microsoft. Na época em que essa documentação foi escrita, você poderia ler a documentação sobre o VBScript em http://msdn.microsoft.com/library/default.asp?url=/library/en-us/script56/html/vtorivbscript.asp.

VBScript no IWS A tabela a seguir fornece um resumo das interfaces VBScript suportadas pelo IWS:

Interface Scopo para

porcedimentos e Variáveis

Execução Funcionalidade

Global Procedures Gráficos e Tarefas - Declaração de Procedimentos

Graphics Script Somente Interface de script Gráficos

Server (Viewer) + Web Thin Clients

Declaração de variáveis

Declaração de Procedimentos

Execução Screen Script Tela onde o script está

configurado Server (Viewer) + Web Thin Clients

Declaração de Variáveis

Declaração de Procedimentos

Execução Command Dynamic Objeto onde o script

está configurado Server (Viewer) + Web Thin Clients



InduSoft Web Studio

Página 401

Execução ActiveX Events Objeto onde o script

está configurado Server (Viewer) + Web Thin Clients


Execução Startup Script Todas páginas de Script

de Tarefas Server (BGTask) Declaração de

Variáveis Declaração de

Porcedimentos Execução

Script Groups Somente Script de Grupo

Server (BGTask) Declaração de Variáveis

Execução

A figura a seguir ilustra o escopo de cada interface VBScript e a ordem que são escaneadas pelo IWS:

Graphic Module (Viewer task or Web Thin Client control)

Global Procedures

Global Procedures

Graphics Script

Graphics Script

Screen A

Screen ScriptScreen Script

Command dynamic

Command dynamic

ActiveX eventsActiveX events

Screen A


Command dynamic

Command dynamic


Screen B


Command dynamic

Command dynamic


Screen B


Command dynamic

Command dynamic


Screen N


Command dynamic

Command dynamic


Screen N


Command dynamic

Command dynamic


Background Task (BGTask task)

StartupScript

StartupScript

Script Groups

Script 001Script 001


Script NScript N

Script Groups



Script NScript N

A ilustração mostra que os Procedimentos Globais são compartilhados por Graphic Module e Background Task. Porém, as outras interfaces VBScript também são de Graphic Module ou Background Task, e não compartilham variáveis ou procedimentos entre elas, pois são independents umas das outras.

Nota: Embora Graphic Scripts sejam executados pelo IWS antes de Screen Scripts, os procedimentos e variáveis declarados na interface Graphics Script NÃO estão disponíveis para qualquer interface de script configurada em telas. Deve-se utilizar a interface Global Procedures para implementar procedimentos que devem estar disponíveis para todas as telas.


InduSoft Web Studio

Página 402

Ao escrever seu código em uma interface VBScript, pode-se acessar qualquer tag a partir do tag database do IWS ou qualquer função da linguagem de built-in do IWS aplicando-se o prefixo “$” ao nome da função/tag, como no exemplo abaixo:

$Time 'Retorna o valor do tag Time do tag database

$MyTag 'Retorna o valor do tag MyTag do tag database

$Open("main") 'Executa a função built-in Open() para abrir a tela "main"

Portanto, pode-se criar scripts utilizando as funções built-in do IWS, tags do tag database do IWS, Funções VBScript, variáveis VBScript, propriedades ActiveX, métodos ou eventos, e qualquer outra interface disponível. Os tags do IWS são compartilhados por todos os módulos do IWS, incluindo o Módulo Graphic e Background Task.

As interfaces VBScript a seguir estão disponíveis no IWS:

Global Procedures

A interface Global Procedures pode ser editada a partir de seu ícone, no tab Database do Workspace:

Essa interface é utilizada para declarar e implementar procedimentos que podem ser chamados por qualquer outra interface VBScript disponível no produto. Pode-se declarar variáveis locais junto a cada procedimento declarado nessa interface (o escopo local junto a cada procedimento); porém, não é possível declarar variáveis globais nessa interface.

Os procedimentos implementados nessa interface não são executados pelo IWS, a menos que sejam chamados a partir de alguma outra interface VBScript disponível no produto. Portanto, essa interface pode ser utilizada SOMENTE para declarar e implementar procedimentos a serem chamados por outras interfaces.

Exemplo:

Option Explicit

'Procedimentos com escopo global podem ser implementadas aqui

'Variáveis globais NÃO são suportadas nessa interface

Function MyAdd (number1, number2)

MyAdd = number1+number2

End Function

Sub MyMessage (message)


InduSoft Web Studio

Página 403

MsgBox (message)

End Sub

Graphic Module - Graphics Script

A interface Graphics Script pode ser editada pelo seu ícone no tab Graphics do Workspace:

Essa interface pode ser utilizada para executar lógicas nos eventos a seguir, baseados em sub-rotimas pré-configuradas:

• Graphics_OnStart(): O código configurado junto a essa sub-rotina e automaticamente executada uma vez quando o graphic module é iniciado. Essa interface é útil ao iniciar variáveis ou executar lógicas que devem ser implementadas ao iniciar a aplicação.

• Graphics_WhileRunning(): O código configurado junto a essa sub-rotina é automaticamente executada de forma contínua enquanto o graphic module está rodando. A taxa na qual essa sub-rotina é chamada depende da performance da plataforma onde está rodando .

• Graphics_OnEnd(): O código configurado junto a essa sub-rotina é executado uma vez logo que o graphic module é fechado.

Atenção: NÃO altere o nome das sub-rotimas pré-configuradas. Caso você o faça, o sistema estará incapacitado para chamá-las automaticamente.

No Server (onde o IWS ou CEView está rodando):

• O graphic module é a tarefa Viewer.

• A sub-rotina Graphics_OnStart() é executada no Server logo que a tarefa Viewer é iniciada.

• A sub-rotina Graphics_WhileRunning() mantém-se executando-se no Server enquanto a tarefa Viewer estiver rodando. A sub-rotina Graphics_OnEnd() é executada no Server logo que a tarefa Viewer é desligada.

No Web Thin Client (Web Browser):

• O graphic module é o controle ISSymbol.

• A sub-rotina Graphics_OnStart() é executada logo que a Web Thin Client station é logada com sucesso.

• A sub-rotina Graphics_WhileRunning() mantém-se executando-se na Web Thin Client station enquanto o controle ISSymbol está hospedado pelo Web Browser.

• A sub-rotina Graphics_OnEnd() é executada na Web Thin Client station logo que o Web Browser é desligado (ou quando o controle ISSymbol não é mais hospedado pelo Web Browser).


InduSoft Web Studio

Página 404

As variáveis e procedimentos declarados nessa interface NÃO estão disponíveis para qualquer interface VBScript – eles têm somente um escopo local.

Nota: A execução das sub-rotinas Graphic Script no server é totalmente

independente da execução de Web Thin Client stations.

Os procedimentos e/ou variáveis criadas nessa interface possuem um escopo local: podem ser acessados somente a partir da interface Graphic Script da estação local onde estão sendo executadas.

Exemplo:

'Variáveis com escopo local podem ser declaradas e inicializadas aqui

Dim MyDate

MyDate = Date()

Dim MyValue

MyValue = 100

Procedimentos com escopo local podem ser implementados aqui

Function AreaRec ( side1, side2)

AreaRec = side1 * side2

End Function

Sub CheckHiLimit (myValue, myHiLimit)

If myValue > myHiLimit Then

MsgBox ("Value out of range")

End If

End Sub

' Esse procedimento é executado logo que o graphic module é iniciado

Sub Graphics_OnStart()

MsgBox("Welcome to the system!")

End Sub

' Esse procedimento é executado de forma continua enquanto o graphic module estiver rodando

Sub Graphics_WhileRodando()

If $UserName="Guest" Then

$MyFlag=0

End If

End Sub

' Esse procedimento é executado logo que o graphic module é fechado

Sub Graphics_OnEnd()

$LogOff()

End Sub


InduSoft Web Studio

Página 405

Graphic Module - Screen Script

Para editar a interface Graphics Script, clique com o botão direito na tela, e selecione a opção Screen Script. Pode-se também selecionar View -> Screen Script do menu drop-down.

Essa interface pode ser utilizada para executar lógicas nos eventos a seguir, baseados em sub-rotinas pré-configuradas:

• Screen_OnOpen(): O código junto a essa sub-rotina é executado uma vez logo que sua tela seja aberta.

• Screen_WhileOpen():O código junto a essa sub-rotina é executado automaticamente de forma continua enquanto sua tela seja executada. A taxa na qual essa sub-rotina é chamada depende da performance da plataforma onde a aplicação estiver rodando.

• Screen_OnClose():O código configurado junto a essa sub-rotina é executado uma vez logo que a tela é fechada.

As variáveis e procedimentos declarados nessa interface estão disponíveis para as interfaces VBScript da tela onde o Screen Script está configurado.

Atenção: NÃO altere o nome das sub-rotinas pré-configuradas. Caso você o faça, o sistema sera desabilitado para chamá-las novamente.

Notas: A execução das sub-rotinas Screen Script no server é totalmente independente da

execução de Web Thin Client stations.

Os procedimentos e/ou variáveis criadas nessa interface possuem escopo local: podem ser acessados somente a partir de telas específicas onde estão sendo implementados.

Exemplo:

Variáveis disponíveis nessa tela podem ser declaradas e inicializadas aqui

Dim Counter

'Procedures available on this screen can be implemented here

Function AreaCircle (radius)


InduSoft Web Studio

Página 406

AreaCircle = Sqr(radius)*$Pi()

End Function

Sub CheckLoLimit (myValue, myLoLimit)

If myValue < myLoLimit Then


End If

End Sub

' Esse procedimento é executado logo que a tela é aberta

Sub Screen_OnOpen()

MsgBox("The screen was open!")

End Sub

' Esse procedimento é executado continuamente enquanto essa tela está aberta

Sub Screen_WhileOpen()

If Counter<100 Then

Counter=Counter+1

Else

Counter=0

End If

$SimulationTag = Counter

End Sub

' Esse procedimento é executado logo que a tela é fechada

Sub Screen_OnClose()

MsgBox("The screen will be closed!")

End Sub

Graphic Module – Dinâmica Command

Para editar a interface da dinâmica Command, siga os passos:

Selecione o objeto.

Clique no ícone Command na barra de menu Mode.

Clique com o botão direito no objeto.

O diálogo Object Properties para o dinâmico Command será aberto.


InduSoft Web Studio

Página 407

Clique no botão Config….

Seleione VBScript como Type.

Utilize essa interface para executar lógicas quando o usuário clica no objeto onde o dinâmico Command está aplicado (durante o runtime) ou aperte o atalho (Tecla) associado à dinâmica Command.

Variáveis declaradas nessa interface estão disponíveis somente para essa interface (escopo local), ou seja, não estão disponíveis para qualquer outro objeto na aplicação. Você não poderá implementar procedimentos nessa interface; porém, você poderá chamar procedimentos implementados em Global Procedures ou na interface Screen Script para a mesma tela onde a dinâmica Command está configurada.

Nota: Maiores informações sobre o dinâmico Command estão disponíveis no Capítulo 3, que descreve as dinâmicas do editor de telas.

Exemplo:

'O script abaixo será executado quando o usuário clicar no objeto

'onde a dinâmica está configurada

$MyValue = InputBox("Please enter the new set-point", "Set-point")

Graphic Module - ActiveX Events

Para editar a interface ActiveX Events, selecione a opção Script do tab Events do objeto ActiveX inserido na tela.


InduSoft Web Studio

Página 408

Clique no ícone ActiveX Control na barra de ferramentas Mode.

O diálogo Insert ActiveX Control abrirá.

Selecione o ActiveX Control que você deseja utilizar, e depois clique em OK.

O objeto que simboliza o ActiveX Control selecionado será exibido. Clique com o botão direito nesse objeto para abrir o diálogo Object Properties.

Clique no botão Configuration. O diálogo Configuration abrirá. Clique no tab Events.


InduSoft Web Studio

Página 409

Clique no botão … na coluna Script.

Utilize essa interface para executar lógicas quando um objeto ActiveX disparar um evento.

Variáveis declaradas nessa interface estão disponíveis somente para essa interface (escopo local), ou seja, não estão disponíveis para qualquer outro objeto na aplicação .

Não é possível implementar procedimentos nessa interface, porém, pode-se chamar procedimentos implementados em Global Procedures ou na interface Screen Script para a mesma tela onde o objeto ActiveX está configurado.

Nota: Maiores informações sobre os Eventos ActiveX Events estão disponíveis na seção Utilizando a Barra de Ferramentas Active Objects do Capítulo 7.


InduSoft Web Studio

Página 410

Exemplo:

'O script abaixo será executado quando Calendar Control ActiveX disparar seu evento "AfterUpdate"

$MyYear = CalendarControl1.Year

$MyMonth = CalendarControl1.Month

$MyDay = CalendarControl1.Day

Tarefa Background - Startup Script

Para editar a interface Startup Script, clique em seu ícone na pasta Script, no tab Tasks do Workspace:

O código configurado nessa interface é executado logo quando o módulode tarefa Background (BGTask) é iniciado. Essa interface é útil para inicialização de variáveis ou execução de lógicas que devem ser implementadas quando a aplicação for iniciada.

Pode-se declarar e iniciar variáveis, e ainda implementar procedimentos. Porém, variáveis ou procedimentos declarados nessa interface estarão disponívesi SOMENTE para grupos de script da tarefa Script – Não estão disponíveis para qualquer interface VBScript do Graphic Module.


InduSoft Web Studio

Página 411

Exemplo:

'Variáveis disponíveis para todos os grupos Script da tarefa Script podem ser declaradas e inicializadas aqui

Dim MyVar, Counter

MyVar = 100

'Procedimentos disponíveis para todos os grupos Script da tarefa Script podem ser implementadas aqui

Function AreaEquTriangle ( base, high)

AreaEquTriangle = (base * high) / 2

End Function

Sub CheckLimits (myValue, myHiLimit, myLoLimit)

If (myValue > myHiLimit Or myValue < myLoLimit) Then


End If

End Sub

' O Código configurado aqui é executado logo que a tarefa Background é inicializada

If $GetOS()=3 Then

MsgBox ("Welcome! This Aplicação is Rodando under Microsoft Windows CE operating system.")

Else

MsgBox ("Welcome! This Aplicação Is Rodando under Microsoft Windows NT/2K/XP operating system.")

End If

Tarefa Background – Grupos Script

Para criar um novo grupo Script, clique com o botão direito na subpasta Script no tab Tasks do Workspace. Selecione a opção Insert do menu pop-up:


InduSoft Web Studio

Página 412

Para editar uma interface Script Group já existente, clique em seu ícone na pasta Script no tab Tasks do Workspace:

O código configurado em cada Script Group é executado pela tarefa Background. O IWS escanea os Script Groups sequencialmente (baseado no número do grupo) e executa somente os grupos no qual a condição configurada no campo Execution do Script Group é TRUE (VERDADEIRA), isto é, qualquer valor diferente de 0 (zero).

Nota: Deve-se utilizar a sintaxe suportada pela linguagem built-in do IWS no campo Execution de cada grupo Script. Somente o corpo do grupo Script suporta a linguagem VBScript.

Atenção: Quando qualquer Script Group é salvo durante o runtime (configuração on-line), a interface Script de Startup será executada novamente, e o valor atual das variáveis locais de qualque Script Group serão reiniciadas.


InduSoft Web Studio

Página 413

Variáveis declaradas em um grupo têm escopo local somente para aquele grupo específico. Esses não estão disponíveis para qualquer outra interface VBScript. A partir do Script Group, pode-se chamar todos os procedimentos implementados na interface Global Procedures ou na interface Startup Script; porém, você não poderá implementar (declarar) procedimentos em Script Groups.

Exemplo:

'Variáveis disponíveis somente para esse grupo podem ser declaradas aqui

Dim myVar, myTest

myTest=1

'O código configurado aqui é executado enquanto a condição configurada no campo'Execution é TRUE

myVar = $FindFile("c:\*.txt")

If MyVar>0 Then

$TagNumOfFiles = myVar

End If

Referência de Linguagem

Constantes

Constantes de Cor

Constante Valor Descrição

vbBlack &h00 Black

vbRed &hFF Red

vbGreen &hFF00 Green

vbYellow &hFFFF Yellow

vbBlue &hFF0000 Blue

vbMagenta &hFF00FF Magenta

vbCyan &hFFFF00 Cyan

vbWhite &hFFFFFF White

Constantes Comparativas


vbBinaryCompare 0 Executa uma comparação binária

vbTextCompare 1 Executa uma comparação textual

Data e Hora das Constantes


vbSunday 1 Domingo

vbMonday 2 Segunda-feira

vbTuesday 3 Terça-feira


InduSoft Web Studio

Página 414

vbWednesday 4 Quarta-feira

vbThursday 5 Quinta-feira

vbFriday 6 Sexta-feira

vbSaturday 7 Sábado

vbUseSystemDayOfWeek 0 Utiliza o dia da semana especificado nas configurações de seu sistema para o primeiro dia da semana.

vbFirstJan1 1 Utiliza a semana na qual será o dia 1 de janeiro (padrão).

vbFirstFourDays 2 Utiliza a primeira semana que tenha ao menos quarto dias no ano seguinte.

vbFirstFullWeek 3 Utiliza primeira semana completa do ano.

Constantes de Formatos de Data


vbGeneralDate 0 Exibe data e/ou hora. Para número reais, exibe uma data e hora. Caso não haja parte fracional, exibe somente uma data. Caso não haja parte inteira, exibe somente hora. A exibição de Data e hora é determinada pelas configurações de seu sistema.

vbLongDate 1 Exibe uma data utilizando o formato de dato longo, especificado nas configurações regionais de seu computador.

vbShortDate 2 Exibe uma data utilizando o formato de data curto especifcado nas configurações de seu computador.

vbLongTime 3 Exibe uma data utilizando o formato longo especificado nas configurações regionais de seu computador.

vbShortTime 4 Exibe uma hora utilizando o formato curto especificado nas configurações regionais de seu computador.


InduSoft Web Studio

Página 415

Constantes


vbObjectError -2147221504 Números de erros definidos pelo usuário devem ser maiores que esse valor.

Constantes de Diálogos –Botões e Ícones


vbOKOnly 0 Exibe somente o botão OK.

vbOKCancel 1 Exibe os botões OK e Cancel.

vbAbortRetryIgnore 2 Exibe os botões Abort, Retry, e Ignore.

vbYesNoCancel 3 Exibe os botões Yes, No, e Cancel.

vbYesNo 4 Exibe os botões Yes e No.

vbRetryCancel 5 Exibe os botões Retry e Cancel.

vbCritical 16 Exibe o ícone Critical Message .

vbQuestion 32 Exibe o ícone Warning Query.

vbExclamation 48 Exibe o ícone Warning Message.

vbInformation 64 Exibe o ícone Information Message.

vbDefaultButton1 0 Primeiro botão é o padrão.

vbDefaultButton2 256 Segundo botão é o padrão.

vbDefaultButton3 512 Terceiro botão é o padrão.

vbDefaultButton4 768 Quarto botão é o padrão .

vbAplicaçãoModal 0 Aplicação modal. O usuário deverá responder o diálogo antes de continuar trabalhando na aplicação atual.

vbSystemModal 4096 Sistema modal. Nos sistemas Win32, essa constante fornece um diálogo de aplicação modal que permanence sempre acima de quaisquer outros programas que estejam rodando.

Constantes de Diálogos – Botão Selecionado


vbOK 1 Botão OK foi clicado.

vbCancel 2 Botão Cancel foi clicado.


InduSoft Web Studio

Página 416

vbAbort 3 Botão Abort foi clicado.

vbRetry 4 Botão Retry foi clicado.

vbIgnore 5 Botão Ignore foi clicado.

vbYes 6 Botão Yes foi clicado.

vbNo 7 Botão No foi clicado.

Constantes de String


vbCr Chr(13) Carriage Return (equivalente à tecla ENTER)

VbCrLf Chr(13) & Chr(10) Combinação Carriage return–linefeed

vbFormFeed Chr(12) Form feed; não usual em Microsoft Windows

vbLf Chr(10) Line feed

vbNewLine Chr(13) & Chr(10) or Chr(10) Caracter de nova linha; sempre que apropriado para a plataforma

vbNullChar Chr(0) Caractere com o valor 0

vbNullString String having value 0 Não o mesmo que o comprimento de string 0 (""); utilizado para chamar procedimentos externos

vbTab Chr(9) Tab Horizontal

vbVerticalTab Chr(11) Tab Vertical; Não usual em Microsoft Windows

Constantes Tri-state


vbUseDefault -2 Utiliza padrão de configurações regionais do computador.

vbTrue -1 TRUE (VERDADEIRO)

vbFalse 0 FALSE (FALSO)

Constantes de Tipos de Variáveis


vbEmpty 0 Não inicializada (padrão)

vbNull 1 Contém dados inválidos

vbInteger 2 Subtipo Integer

vbLong 3 Subtipo Long

vbSingle 4 Subtipo Single

vbDouble 5 Subtipo Double

vbCurrency 6 Subtipo Currency


InduSoft Web Studio

Página 417

vbDate 7 Subtipo Date

vbString 8 Subtipo String

vbObject 9 Object

vbError 10 Subtipo Error

vbBoolean 11 Subtipo Boolean

vbVariant 12 Variante (utilizada somente para arrays de variantes)

vbDataObject 13 Objeto para acesso de dados

vbDecimal 14 Subtipo Decimal

vbByte 17 Subtipo Byte

vbArray 8192 Array

Erros

Erros de runtime do VBScript

Número do Erro Descrição

429 Componente ActiveX não pode criar objeto

507 Ocorreu uma exceção

449 Argumento não opcional

17 Não é possível executar a tarefa requisitada

430 Classe não suporta automação

506 Classe não definida

11 Divisão por zero

48 Erro ao carregar DLL

5020 Esperado ')' em expressão regular

5019 Esperado ']' em expressão regular

432 Nome do Arquivo ou nome de classe não encontrados durante o processo de automação

92 Não iniciado para loop

5008 Preenchimento ilegal

51 Erro interno

505 Referência inválida ou não qualificada

481 Figura inválida

5 Procedimento de chamada ou argumento inválido

5021 Escala inválida em conjunto de caractere

94 Uso de Null inválido

448 Argumento nomeado não encontrado

447 Objeto não suporta localização atual de configuração

445 Objeto não suporta essa ação

438 Objeto não suporta essa propriedade ou método

451 Objeto não é coleção

504 Objeto não seguro para criação


InduSoft Web Studio

Página 418

503 Objeto não seguro para inicialização

502 Objeto não seguro para scripting

424 Objeto requisitado

91 Variável de objeto não configurada

7 Fora da memória

28 Fora do espaço permitido

14 Fora do espaço da string

6 Fluxo elevado

35 Sub ou função não definidos

9 Subscript for a de escala

5017 Erro de sintaxe em expressão regular

462 O servidor remoto não existe ou está indisponível

10 Esse array está fixo ou temporariamente travado

13 Tipo mismatch

5018 Quantificador inesperado

500 Variável indefinida

458 Variável utiliza um tipo Automation não suportado em VBScript

450 Número errado de argumentos ou preenchimento de propriedade inválido

Erros de sintaxe do VBScript

Número do Erro Descrição

1052 Não pode haver múltiplos propriedade/método em uma classe

1044 Não pode utilizar parênteses ao chamar uma Sub

1053 Class inicializadora ou finalizadora não possui argumentos

1058 Especificação 'Default' pode estar somente em Property Get

1057 Especificação 'Default' deve especificar também 'Public'

1005 '(' Esperado

1006 ')' Esperado

1011 '=' Esperado

1021 'Case' Esperado

1047 'Class' Esperado

1025 Final da Demostração Esperado

1014 'End' esperado

1023 Expressão Esperada


InduSoft Web Studio

Página 419

1015 'Function' esperada

1010 Identificado esperado

1012 'If’Esperado

1046 'In' Esperado

1026 Constante inteira esperada

1049 Decalração de propriedade Let or Set or Get in esperada

1045 Constante literal esperada

1019 'Loop' esperado

1020 'Next' esperado

1050 'Property' esperado

1022 'Select' esperado

1024 Demonstração esperada

1016 'Sub' Esperada

1017 'Then' ESperado

1013 'To' Esperado

1018 'Wend' Esperado

1027 'While' ou 'Until' Esperado

1028 Esperados 'While,' 'Until,'ou final da demonstração

1029 'With' Esperado

1030 Identificador muito comprido

1014 Caractere inválido

1039 Demonstração 'exit' inválida

1040 Variável de controle 'for' inválida

1013 Número inválido

1037 Uso inválido da tecla-chave 'Me'

1038 'loop' sem 'do'

1048 Deve ser definido dentro de um Class

1042 Deve ser a primeira demonstração da linha

1041 Nome redefinido

1051 Número de argumentos deve ser consistente a especificação de propriedades

1001 Fora da memória

1054 Propriedades Set ou Let devem ter ao menos um argumento

1002 Erro de sintaxe

1055 'Next' Inesperado

1015 Constante string indeterminada


InduSoft Web Studio

Página 420

Funções

Nomes da Função

Abs Array Asc Atn

CBool CByte CCur CDate

CDbl Chr CInt CLng

Conversions Cos CreateObject CSng

CStr Date DateAdd DateDiff

DatePart DateSerial DateValue Day

Derived Math Escape Eval Exp

Filter FormatCurrency

FormatDateTime FormatNumber

FormatPercent GetLocale GetObject GetRef

Hex Hour InputBox InStr

InStrRev Int, Fix IsArray IsDate

IsEmpty IsNull IsNumeric IsObject

Join LBound LCase Left

Len LoadPicture Log LTrim; RTrim; and Trim

Maths Mid Minute Month

MonthName MsgBox Now Oct

Replace RGB Right Rnd

Round ScriptEngine ScriptEngineBuildVersion

ScriptEngineMajorVersion

ScriptEngineMinorVersion

Second SetLocale Sgn

Sin Space Split Sqr

StrComp String StrReverse Tan

Time Timer TimeSerial TimeValue

TypeName UBound UCase Unescape

VarType Weekday WeekdayName Year


InduSoft Web Studio

Página 421

Palavras-Chave

Palavras-chave

Palavra-chave Descrição

Empty A keyword (palavra-chave) Empty é usada pra indicar valor não inicializado de uma variável. Não é a mesma indicação de valor nulo (Null).

False False indica o valor 0.

Nothing Nothing é usado no VBScript para desassociar uma variável object do object em si.

Null Null indica que a variável não contém nenhum dado. Não é a mesma indicação de valor vazio (Empty).

True True indica o valor -1.

Métodos

Métodos

Método Descrição

Clear Limpa todas as configurações de propriedade do objeto Err.

Execute Executa uma pesquisa de expressão regular contra um string especificado.

Raise Gera um erro de run-time.

Replace Substitui textos encontrados em uma pesquisa de expressão regular.

Test Executa uma pesquisa de expressão regular contra um string especificado e retorna um valor Boolean que indica se um modelo similar foi encontrado.

Write Envia strings para o string de correção de erros.

WriteLine Envia strings para o string de correção de erros, seguido por um caractere newline.

Objetos e Coleções

Objetos e Coleções

Nome Descrição

Class Object O objeto criado com a utilização da demonstração Class. Fornece acesso a eventos class.

Debug Object Um objeto intrínseco global que pode enviar saída para um string de correção de erro, como Microsoft Script Debugger.

Err Object Contém informações sobre erros de run-time. Aceita os métodos Raise e Clear para gerar e limpar erros de run-time.

Match Object Fornece acesso para propriedes read-only de uma expressão regular Match.


InduSoft Web Studio

Página 422

Matches Collection Coleção de objetos Match de expressão regular.

Regular Expression (RegExp) Object Fornece suporte simples para expressão regular.

SubMatches Collection Coleção de strings submatch de expressão regular.


InduSoft Web Studio

Página 423

Operadores

Aritimética

Símbolo Nome Descrição

^ Exponenciação Aumenta o número para um expoente.

- Negação

Encontra a diferença entre dois números ou indica o valor negativo de uma expressão numérica.

* Multiplicação Multiplica dois números.

/ Divisão Divide dois números e retorna um resultado floating-point.

\ Divisão por inteiro Divide dois números e retorna um resultado inteiro.

Mod Módulos aritiméticos Divide dois números e retorna somente o remanescente.

+ Adição Faz a soma de dois números.

- Subtração

Faz a diferença entre dois números ou indica o valor negativo de uma expressão numérica.

& Concatenação de strings Concatenação de duas expressões.

Comparação


= Igualdade Comparação é Verdadeira caso a primeira expressão seja igual a segunda.

<> Desigualdade Comparação é Verdadeira caso a primeira expressão seja dierente da segunda.

< Menor que Comparação é Verdadeira caso a primeira expressão seja menor que a segunda.

> Maior que Comparação é Verdadeira caso a primeira expressão seja maior que a segunda.

<= Menor ou igual a Comparação é Verdadeira caso a primeira expressão seja menor que a segunda.

>= Maior ou igual a Comparação é Verdadeira caso a primeira expressão seja maior ou igual a


InduSoft Web Studio

Página 424

segunda.

Is Equivalência de objeto Compara duas variáveis de referência do objeto. Comparação é Verdadeira caso ambos os nomes de objetos refriram-se ao mesmo objeto.

Lógica

Simbolo Nome Descrição

Not Negação lógica Executa negação lógica em uma expressão.

And Conjunção lógica Executa uma conjunção lógica em duas expressões.

Or Disjunção lógica Executa uma disjunção lógica em duas expressões.

Xor Exclusão lógica Executa uma exclusão lógica em duas expressões.

Eqv Equivalência lógica Executa uma equivalência lógica em duas expressões.

Imp Implicação lógica Executa uma implicação lógica em duas expressões.

Indicação


= Indicação Aplica um valor a uma variável ou propriedade.

Propriedades

Propriedades

Nome da Propriedade Descrição

Description Retorna ou configura uma string associada a um erro.

FirstIndex Retorna a posição em uma string onde o valor procurado ocorre.

Global Configura ou retorna valor Booleano que indica se um padrão deve combinar todas as ocorrências em uma string inteira de busca ou em apenas na primeira.

HelpContext Configura ou retorna uma ID de contexto para um Arquivo Help tópico.

HelpFile Configura ou retorna caminho completamente qualificado para o Aquivo Help.

IgnoreCase Configura ou retorna um valor Booleano que


InduSoft Web Studio

Página 425

indica se uma pesquisa padrão faz diferença entre letras maiúsculas ou minúsculas ou não.

Length Configura ou retorna um valor Booleano que indica se uma pesquisa padrão faz diferença entre letras maiúsculas ou minúsculas ou não.

Number Retorna ou configura um valor numérico especificando um erro. Number é a propriedade padrão Err do objeto.

Pattern Configura ou retorna a expressão regular padrão a ser pesquisada.

Source Retorna ou configura o nome do objeto ou Aplicação que gerou o erro originalmente.

Value Retorna o valor ou texto de uma semelhança encontrada em uma string de pesquisa.

Demonstrações

Demonstrações

Nome da demonstração Descrição

Call Transfere controle para procedimento Sub ou Function.

Class Declara o nome de uma classe, assim como uma definição de varíáveis, propriedades, métodos que comprometem a classe.

Const Declara constantes para uso em lugar de valores literais.

Dim Declara variáveis e aloca espaço de armazenamento.

Do…Loop Repete um bloco de Demonstrações enquanto uma condição é Verdadeira ou até a condição tornar-se Verdadeira.

Erase Reinicializa os elementos de arrays fixed-size e desloca espaço de armazenamento de dynamic-array.

Execute Executa uma ou mais Demonstrações especificadas.

ExecuteGlobal Executa uma ou mais Demonstrações especificadas em namespace global de um script.

Exit Promove a saída de um bloco de Do...Loop, For...Next, Função ou código Sub.

For Each…Next Repete um grupo de Demonstrações para cada elemento em uma array ou coleção.

For…Next Repete um grupo de Demonstrações em um número de vezes especificado.


InduSoft Web Studio

Página 426

Function Declara o nome, argumentos e código que formam o corpo de um procedimento Function.

If…Then…Else Condicionalmente executa um grupo de Demonstrações, dependendo do valor de uma expressão.

Option Explicit Força declaração explícita de todas as variáveis em um script.

Private Declara variáveis particulares e aloca espaço de armazenamento em um bloco Class, uma variável particular.

Property Get Declara, em um bloco Class, o nome, argumentos, e código que formam o corpo do procedimento Property que obtém (retorna) o valor de uma propriedade.

Property Let Declara, em um bloco Class, o nome, argumentos, e código que formam o corpo do procedimento Property que preenche (configura) o valor de uma propriedade.

Property Set Declara, em um bloco Class, o nome, argumentos, e código que formam o corpo do procedimento Property que configure uma referência a um objeto.

Public Declara variáveis públicas e aloca espaço de armazenamento. Declara, em um bolco Class, uma variável particular.

Ramdomize Inicializa o gerador random-number.

ReDim Declara variáveis dynamic-array, e aloca ou desaloca espaço de armazenamento ao nível do procedimento.

Rem Inclui marcas de explicação em um programa de Detalhamento Técnico.

Select Executa uma Demonstração de um grupo, dependendo do valor de uma expressão.

Set Preenche uma referência de objeto para uma variável ou propriedade, ou associa uma referência de procedimento a um evento.

Stop Suspende execução.

Sub Declara o nome, argumentos e códigos que formam o corpo de um procedimento Sub.

While Executa uma série de Demonstrações conquanto que a condição dada seja Verdadeira.


InduSoft Web Studio

Página 427

Dicas e Truques

VBScript Editor - IntelliSense

IntelliSense fornece uma variedade de opções que tornam as referências de linguagem simples e de fácil acesso. Ao codificar, você não precisará deixar o Code Editor ou a janela de comando Immediate Mode executar pesquisas em elementos de linguagem. Pode-se manter o contexto, encontrar a informação necessária, inserir elementos da linguagem diretamente ao código, e até mesmo fazer com que o IntelliSense complete a digitação para você.

IntelliSense confere as seguintes opções:

– List Members: Pode-se exibir uma lista de membros válidos de tags class, campos de qualquer tag, propriedades/métodos de um objeto ActiveX object, ou funções da linguagem built-in do IWS. Selecionar a partir da lista promove a inserção do membro em seu código.

Ao digitar o caractere $ em qualquer interface VBScript, uma list box abrirá automaticamente com a lista de todos os tags disponíveis para a aplicação atual, assim como todas as Funções da linguagem built-in do IWS.

Ao adotar o nome do tag classe seguido pelo caractere ponto (.) em qualquer interface VBScript, uma list box abrirá automaticamente com a lista de membros do tag class:

Ao digitar o nome de um tag seguido por caracteres hífem e maior que ( -> ) em qualquer interface VBScript, uma list box abrirá automaticamente com a lista de campos disponíveis para esse tag:


InduSoft Web Studio

Página 428

Os itens são exibidos em ordem alfabética, e cada um possui um ícone para identificar seu tipo principal, como se segue:

Ícone Tipo

Tag Boolean

Tag Integer

Tag Real

Tag String

Tag Class

Função built-in de linguagem do IWS

Ao digitar o nome de um controle ActiveX que esteja inserido na tela seguida pelo caractere ponto (.) em qualquer interface VBScript da tela onde o objeto ActiveX object está inserido, uma list box abrirá automaticamente com uma lista de todas as propriedades e métodos do objeto:

Os itens são exibidos em ordem alfabética, e cada um possui um ícone para identificar seu tipo principal, como se segue:

Ícone Tipo

Propriedade do objeto ActiveX

Método do objeto ActiveX

– Parâmetro Quick Info: A opção Quick Info exibe boxes pop-up com informações sobre as Funções de linguagem buit-in do IWS, as quais incluem todos os parâmetros suportados por essa função, com aquele atualmente configurado em texto em negrito.


InduSoft Web Studio

Página 429

– Complete Word: Complete word finaliza um tag, membro, campo, função ou nome de propriedade/método ActiveX uma vez que você tenha inseridos caracteres suficientes para que o termo não fique ambíguo. Após digitar as primeiras letras do nome, pode-se apertar CTRL+SPACEBAR para que o nome seja completado automaticamente.

VBScript comparado a VBA

Enquanto VBScript e Visual Basic For Aplicattion (VBA) são similares e baseados no padrão de linguagem Visual Basic, existem algumas vantagens na utilização do VBScript para usuários do IWS:

– VBScript é suportado em sistema operacional Microsoft Windows CE, enquanto o VBA não é.

– VBScript fornece scripting ativos para uma extensa variedade de ambientes, incluindo Web client scripting em Microsoft Internet Explorer, o que evita operações que possam representar riscos para o usuário Web Thin Client, como acesso direto a arquivos locais.

– VBScript foi projetado para um aprendizado simples e fácil, com alguns padrões do VBA modificados para o VBScript, tornando-o assim uma ferramenta mais direta. Por exemplo, em VBScript o usuário não precisa se preocupar com o tipo de cada variável ao declará-las, pois o VBScript assume o tipo apropriado para cada valor automaticamente.

A tabela a seguir lista os recursos do VBScript não existentes em VBA.

Categoria Recurso/Palavra-chave

Declarações Class

Eval Mecelâneas

Execute

Objetos RegExp

ScriptEngine

ScriptEngineBuildVersion Identificação do Script Engine

ScriptEngineMajorVersion

A tabela a seguir lista os recursos do VBA não existentes em VBScript.

Categoria Recurso omitido/Palavra-chave

Opção Base Array Handling

Declarar arrays com delimitadores <> 0

Add, Count, Item, Remove Collection

Acesso a coleções utilizando o caractere !

#Const Conditional Compilation

#If...Then...#Else

DoEvents

GoSub...Return, GoTo

On Error GoTo

Control Flow

On...GoSub, On...GoTo


InduSoft Web Studio

Página 430

Line numbers, Line labels

CVar, CVDate Conversion

Str, Val

Todos os tipos de dados intrinsic excetuam o Variant Data Types

Type...End Type

Date/Time Date statement, Time statement

DDE LinkExecute, LinkPoke, LinkRequest, LinkSend

Debug.Print Debugging

End, Stop

Declare (for declaring DLLs)

Optional

ParamArray Declaration

Static

Erl

Error Error Handling

Resume, Resume Next

File Input/Output All traditional Basic file I/O

Financial All financial Functions

Object Manipulation TypeOf

Clipboard Objects

Collection

Operators Like

Deftype

Opção Base

Opção Compare Options

Opção Private Module

Expressões contendo a keyword Is ou alguns operadores de comparação

Select Case Expressões contendo uma escala de valores utilizando a palavra-chave To

Strings de comprimento fixo

LSet, RSet

Demonstração Mid Strings

StrConv

Using Objects Acesso a coleção utilizando !

Eventos de Tela

Além de Screen Script, pode-se configurar lógicas com a utilização da linguagem built-in do IWS para os eventos On Open, While Open e On Close utilizados para a tela (veja Interface Screen Logic


InduSoft Web Studio

Página 431

no diálogo Screen Attributes). Caso você configure Screen Script (linguagem VBScript) e Screen Logic (Linguagem Built-in do IWS), o respeitará a seguinte ordem de execução:

Evento Ordem de execução

Ao abrir a tela Sub-rotina Screen_OnOpen() da interface Screen Script (Linguagem VBScript)

On Open da interface Screen Logic (linguagem built-in do IWS)

Ao fechar a tela On Close da interface Screen Logic (Linguagem Built-in do IWS)

Sub-rotina Screen_OnClose() da interface Screen Script (linguagem VBScript)

Funções MsgBox() e InputBox()

A funções MsgBox() e InputBox() da linguagem VBScript permite a exibição de mensagens pop-up durante o runtime. Tais Funções são sincrônicas. Quando uma delas é executada, as instruções remanescentes do código não serão executadas antes que as mensagens pop-up iniciadas pelas Funções sejam fechadas.

Nota: O texto exibido nessas mensagens pop-up não são afetadas pela ferramenta Translation do IWS, a menos que você configure o texto explicitamente com a utilização da função $Ext() da linguagem built-in do IWS.

Suporte para objetos ActiveX

Utilizando as interfaces VBScript para o Graphic module (Graphics Script, Screen Script, dinâmico Command e eventos ActiveX), pode-se utilizar a sintaxe abaixo para acesso a propriedades e métodos, diretamente, a partir de qualquer objeto ActiveX inserido na tela onde o objeto está configurado.

O IWS irá preencher um nome único para o objeto na tela, e você poderá utilizar a propriedade Name (janela de diálogo Object Properties) para modificar esse nome.

Após inserir um objeto ActiveX na tela, você poderá acessar propriedades e métodos a partir desse objeto em qualquer interface VBScript associada a esse tela. Utilize a sintaxe <Object_Name>.<Properties_or_Method_Name>.

Exemplos:

//Acesso ao valor property Day a partir do objeto CalendarControl1 ActiveX

CalendarControl1.Day

//Dispara o método AboutBox a partir do objeto CalendarControl1 ActiveX

CalendarControl1.AboutBox

Logical Operator NOT

O comportamento do Logical Operator NOT é diferente em VBScript da linguagem built-in do IWS. Em VBScript, o operador NÃO inverte os valores bits de qualquer váriável. Quando utilizado para tags Integer ou Real, o NOT operator resultará no complemento do valor do tag. A tabela abaixo ilustra o comportamento do NOT para a sintaxe: result = NOT expression, onde o resultado é o valor recebido por um tag numérico (Integer ou Real) do IWS:


InduSoft Web Studio

Página 432

Caso a expressão seja O resultado será

-3 2

-2 1

-1 0

0 -1

1 -2

2 -3

3 -4

Nota: Ao tentar registrar qualquer valor diferente de 0 em um tag Booleando IWS, esse assumirá o valor 1 (TRUE). Portanto, ao utilizar o NOT logical operator em VBScript para um tag Boolean com valor 1, o operator tentará registrar o valor -2 para o tag Boolean (veja a tabela anterior); o tag Boolean manterá o valor 1.

Recomendamos a utilização das sintaxes a seguir quando da utilização do VBScript para inverter tags a partir do IWS:

- Syntax 1: $Tag = Abs($Tag=0)

- Syntax 2: $Tag = $If($Tag=0,1,0)

Em contraste, o NOT operator inverte o valor de qualquer tag em linguagem built-in do IWS. Caso o tag tenha o valor 0, o NOT operator retornará o valor 1 ao tag. Caso o tag tenha um valor diferente de 0, o NOT operator retornará o valor 0 ao tag. A tabela abaixo ilustra o comportamento do NOT operator para a sintaxe result= NOT expression, onde result é o valor recebido por um tag numérico (Integer, Real ou Boolean) do IWS:

Caso a expressão seja O resultado será

0 1

<> 0 0

Verdadeiro e Falso

Em VBScript, True e False são palavras-chave que retornam os seguintes valores:

Palavra-chave Valor

False 0

True -1

Note que True retorna o valor -1 ao inves de 1.

Nota: O valor assumido pelos tags Booleanos do IWS dependem do valor do parâmetro BooleanTrueAboveZero da seção [Options] no arquivo <Aplicação>.APP. Utilizando a configuração que se segue, os tags Booleanos assumem o valor 1 (TRUE) ao receberem qualquer valor diferente de 0:

[Options] BooleanTrueAboveZero=0


InduSoft Web Studio

Página 433

Utilizando a configuração que se segue, os tags Boolean tags assumem o valor (TRUE) SOMENTE ao receberem um valor maior que 0:

[Options] BooleanTrueAboveZero=1

Suporte Windows CE

CEView também suporta VBScript. O fabricante do hardware do equipamento Microsoft Windows CE deverá habilitar o hardware para que esse suporte o VBScript, de forma que o CEView seja capaz de executar os scripts configurados na linguagem VBScript no equipamento.

A funções MsgBox() e InputBox() podem ser especificamente habilitadas/desabilitadas pelo fabricante do hardware logo que a imagem para o equipamento Microsoft WindowsCE é criada.

Caso você não esteja certo de que a imagem carregada em seu equipamento suporte VBScript, consulte o fabricante de seu hardware.

Escopo e Tempo de Vida de Variáveis

Um escopo de variáveis é determinado por onde esse está declarado. Ao declarar um variável junto a um procedimento, somente códigos com aquele procedimento específico poderá acessar ou alterar o valor da variável, pois possui escopo local e é uma variável procedimento-nível (procedure-level variable). Caso você declare uma variável for a de um procedimento, você o tornará reconhecível para todos os procedimentos de seu script, o que é uma variável script-level, e possui um escopo script-level.

O tempo de vida de uma variável depende de seu tempo de existência. O tempo de vida de uma variável script-level estende-se a partir do tempo que é declarada até o momento em que o script é finalizado em runtime. Ao nível de procedimento, uma variável existe somente quando o procedimento é rodado. Quando o procedimento termina, a variável é destruída. Variáveis locais são ideais para espaço de armazenamento temporário quando o procedimento está sendo executado. Pode-se possuir variáveis locais de um mesmo nome em vário procedimentos distintos, pois cada um é reconhecido somente pelo procedimento no qual está declarado.

Declarando Variáveis

Uma variável é um marcador conveniente que refere-se a um local de memória do computador onde você poderá armazenar informações do programa que possam ser alteradas durante o tempo em que sua script está rodando. Em VBScript, variáveis são sempre um dos tipos fundamentais de dados, Variant.

Declara-se variáveis explicitamente em sua script utilizando a demonstração Dim, Public e Private.

Por exemplo:

Dim DegreesFahrenheit

Declara-se múltiplas variáveis separando-se cada nome da variável com uma vírgula.

Por exemplo:

Dim Top, Bottom, Left, Right

Pode-se também declarer uma variável implicitamente utilizando seu nome em sua script. Tal atitude geralmente não é de todo boa, pois você poderá digitar incorretamente o nome da variável em um ou mais locais, utilzando resultados inesperados quando sua script é rodada. Por essa razão, a demonstração Option Explicit é configurada por padrão na interface Global Procedures para requisitar declaração explícita de todas as variáveis. A menos que você delete essa


InduSoft Web Studio

Página 434

demonstração, será necessário declarar todas as variáveis explicitamente; de outro modo, o VBScript gerará erros durante o runtime, indicando que a variável não existe.

Uma expressão deve ter a variável no lado esquerdo e o valor que você deseja assinar para a variável à direita.

Por exemplo:

MyVar = 100

Criando Constantes

Uma constante é um nome significativo que toma o lugar de um número ou string e nunca altera-se. O VBScript define um número de constantes intrínsecas.

Cria-se constantes pré-definidas pelo usuário em VBScript utilizando a demonstração Const. Utilizando a constante Const, pode-se criar constantes string ou numérica com nomes significantes, além de preenchê-las com valores literais.

Por exemplo:

Const MyString = "This is my string."

Const MyAge = 49

Note que a string literal está enclausurada entre aspas (" "). Aspas são o meio mais óbvio de diferenciar valores de string de valores numéricos. Representa-se Datas e Horas literais enclausurando-as em sinais numéricos (#).

Por exemplo:

Const CutoffDate = #6-1-97#

Caso você deseje adotar um esquema de nomeação para diferenciar constantes de variáveis, isso poderá evitar a tentativa de renomear valores constantes enquanto sua script estiver rodando. Por exemplo, você poderá utilizar um prefixo "vb" or "con" nos nomes de suas constantes, ou nomeá-las em letras maiúsculas. Diferenciar constantes de variáveis elimina dúvidas ao desenvolver scripts mais complexos.

Precedência de Operadores VBScript

VBScript possui uma alta escala de operadores, incluindo operadores aritiméticos, de comparação, concatenação e lógicas.

Quando vários operadores ocorrem em uma expressão, cada parte é validada e resolvida em uma ordem pre-determinada e resolvida chamada “operator precedence.” Pode-se utilizar parênteses para modificar a ordem de precedência e forçar algumas partes de uma expressão a ser validada antes de outras. Operações entre parênteses são sempre executadas antes daquelas que estão fora. Dentro de parênteses, porém, a precedência de operador padrão é mantida.

Quando expressões contêm operadores de mais de uma categoria, operadores aritiméticos são avaliados primeiro, operadores de comparação são validados a seguir e operadores lógicos por último. Operadores de comparação têm todos o mesmo precedente; eles são validados da esquerda para a direita na ordem em que aparecem. Operadores lógicos e aritiméticos são validados na seguinte ordem de precedência.

Aritimética Comparação Lógica

Negação (-) Igualdade (=) Not

Exponenciação (^) Desigualdade (<>) And

Multiplicação e divisão (*, /) Menor que (<) Or

Divisão por inteiro (\) Maior que (>) Xor

Módulo aritimético (Mod) Menor ou igual a (<=) Eqv


InduSoft Web Studio

Página 435

Adição e subtração (+, -) Maior ou igual a (>=) Imp

String de Concatenação (&) Is &

Quando multiplicação e divisão ocorrem conjuntamente em uma expressão, cada operador é avaliado como ocorre, a partir da esquerda para a direita. Da mesma forma, quando adição e subtração ocorrem conjuntamente em uma expressão, cada operador é validado na ordem que aparecem da esquerda para a direita.

O operador string de concatenação (&) não é um operador aritimético, mas em precedência, esse ocorre após todos os operadores aritiméticos e antes de operadores de comparação. O operador Is é um operador de comparação de referência a um objeto, que não compara objetos ou seus valores, e sim verifica somente para determinar se duas referências de objeto referem-se ao mesmo objeto.

Utilizando Demonstrações Condicionais

Pode-se controlar o fluxo de sua script com demonstrações condicionais e loping de Demonstrações. Utilizando Demonstrações condicionais, pode-se escrever código VBScript que tome decisões e repita ações. As seguintes Demonstrações condicionais estão disponíveis em VBScript:

If...Then...Else statement

Select Case statement

tomando decisões Utilizando If...Then...Else

A demonstração If...Then...Else é utilizada para avaliar se a condição é Verdadeira ou Falsa, dependendo do resultado, para a especificação de uma ou mais Demonstrações a serem rodadas. Geralmente, a condição é uma expressão que utiliza um operador de comparação para comparar ou valor ou variável com outro. Para informações sobre operadores de comparação, veja Operadores de Comparação.

Demonstrações If...Then...Else podem ser colocadas conjuntamente em quantos níveis forem necessários.

Rodando Demonstrações Se uma Condição é Verdadeira

Para rodar somente uma demonstração quando uma condição é Verdadeira, utilize a sintaxe linha-única para a demonstração If...Then...Else. O exemplo a seguir mostra uma sintaxe linha-única. Note que esse exemplo omite a palavra-chave Else.

Sub FixDate()

Dim myDate

myDate = #2/13/95#

If myDate < Now Then myDate = Now

End Sub

Para rodar mais de uma linha de um código, deve-se utilizar a sintaxe linha-múltipla (ou bloco). Essa sintaxe inclui a demonstração End If, como mostrado no exemplo a seguir:

Sub AlertUser(value)

If value = 0 Then

AlertLabel.ForeColor = vbRed

AlertLabel.Font.Bold = True

AlertLabel.Font.Italic = True

End If

End Sub


InduSoft Web Studio

Página 436

Rodando Algumas Demonstrações Para Condição Verdadeira e Rodando Outras Para Condição Falsa

Pode-se utilizar uma demonstração If...Then...Else para definir dois blocos de demonstrações executáveis: um bloco para rodar caso a condição seja Verdadeira, e outro bloco para rodar caso a condição seja Falsa.

Sub AlertUser(value)

If value = 0 Then

AlertLabel.ForeColor = vbRed

AlertLabel.Font.Bold = True

AlertLabel.Font.Italic = True

Else

AlertLabel.Forecolor = vbBlack

AlertLabel.Font.Bold = False

AlertLabel.Font.Italic = False

End If

End Sub

Decidindo Entre Várias Alternativas

Uma variação da demonstração If...Then...Else permite a escolha de várias alternativas. Adicionar cláusulas ElseIf amplia a funcionalidade da demonstração If...Then...Else, de forma que você possa controlar o fuxo do programa baseando-se em diferentes possibilidades. Por exemplo:

Sub ReportValue(value)

If value = 0 Then

MsgBox value

ElseIf value = 1 Then

MsgBox value

ElseIf value = 2 then

Msgbox value

Else

Msgbox "Value out of range!"

End If

Pode-se adicionar quantas cláusulas ElseIf sejam necessárias para a obtenção de escolhas alternatives, embora o uso extensivo de cláusulas ElseIf pode tronar-se exaustivo. A demonstração Select Case provê um método mais eficaz para a escolha entre diferentes alternativas.

Tomando decisões com Select Case

A estrutura Select Case fornece uma alternativa para o If...Then...ElseIf , selecionando a execução de um bloco de Demonstrações específico entre múltiplos blocos de Demonstrações. Uma demonstração Select Case fornece capacibilidade semelhante à demonstração If...Then...Else, além de deixar o código mais eficaz e com maior facilidade para leitura.

Uma estrutura Select Case trabalha com uma expressão única de teste, validada uma vez na parte superior da estrutura. O resultado da expressão é então comparado a valores para cada Case da estrutura. Caso correspondam, o bloco de Demonstrações associados àquele Case é executado, como no exemplo que se segue.

Select Case Document.Form1.CardType.Options(SelectedIndex).Text


InduSoft Web Studio

Página 437

Case "MasterCard"

DisplayMCLogo

ValidateMCAccount

Case "Visa"

DisplayVisaLogo

ValidateVisaAccount

Case "American Express"

DisplayAMEXCOLogo

ValidateAMEXCOAccount

Case Else

DisplayUnknownImage

PromptAgain

End Select

Note que a estrutura Select Case valida uma expressão uma vez que esteja na parte superior da estrutura. Em contraste, a estrutura If...Then...ElseIf pode validar uma expressão diferente para cada demonstração ElseIf. Pode-se substituir uma estrutura If...Then...ElseIf por Select Case somente se cada demonstração ElseIf validar a mesma expressão.

Executando em Loop Através do Código

Executar em Loop permite rodar um grupo de Demonstrações repetidamente. Algumas execuções em loop repetem Demonstrações até uma condição ser Falsa; outras repetem Demonstrações até um condição ser Verdadeira. Também existem execuções em loop que repetem Demonstrações em um número de vezes específico.

As seguintes demonstrações em loop estão disponíveis em VBScript:

Do...Loop: Executa em Loop enquanto ou até a condição ser Verdadeira

While...Wend: Executa em Loop enquanto a condição é Verdadeira

For...Next: Utiliza um contador para rodar Demonstrações em um número específico de vezes

Utilizando Execuções Em Loop

Pode-se utilizar Demonstrações Do...Loop para rodar um bloco de Demonstrações em um número infinito de vezes. As Demonstrações são repetidas enquanto uma condição é Verdadeira e também até que essa torne-se Verdadeira.

Repetindo Demonstrações Enquanto uma Condição é Verdadeira

Utilize a palavra-chave While para verificar uma condição em uma demonstração Do...Loop. Pode-se verificar a condição antes de inserir o modo loop (como mostrado no exemplo ChkFirstWhile), ou pode-se verificá-la após o modo loop ter sido rodado ao menos uma vez (como mostrado no exemplo ChkLastWhile). No procedimento ChkFirstWhile, caso myNum esteja configurado como 9 ao invés de 20, as Demonstrações do modo loop nunca serão rodadas. No procedimento ChkLastWhile, as Demonstrações dentro do modo loop rodarão apenas uma vez, posto que a condição já é Falsa.

Sub ChkFirstWhile()

Dim counter, myNum

counter = 0

myNum = 20

Do While myNum > 10

myNum = myNum - 1


InduSoft Web Studio

Página 438

counter = counter + 1

Loop

MsgBox "The loop made " & counter & " repetitions."

End Sub

Sub ChkLastWhile()

Dim counter, myNum

counter = 0

myNum = 9

Do

myNum = myNum - 1


Loop While myNum > 10


End Sub

Repetindo uma Demonstração até que a Condição Torne-se Verdadeira

Existem duas maneiras de utilizar a palavra-chave Until para verificar uma condição em uma demonstração Do...Loop. Pode-se verificar a condição antes de inserir o modo loop (como mostrado no exemplo ChkFirstUntil), ou verificá-la após o modo loop ter sido rodado ao menos uma vez (como mostrado no exemplo ChkLastUntil). O modo loop ocorrerá, contanto que a condição seja Falsa.

Sub ChkFirstUntil()

Dim counter, myNum

counter = 0

myNum = 20

Do Until myNum = 10

myNum = myNum - 1


Loop


End Sub

Sub ChkLastUntil()

Dim counter, myNum

counter = 0

myNum = 1

Do

myNum = myNum + 1


Loop Until myNum = 10


End Sub


InduSoft Web Studio

Página 439

Extraindo uma Demonstração Do...Loop da Execução Loop

Pode-se sair de Do...Loop utilizando a Demonstração Exit Do. Geralmente deseja-se sair dessa demonstração somente em determinadas situações, como quando deseja-se evitar um loop interminável. Por isso, deve-se utilizar a demonstração Exit Do no bloco de demonstrações True de uma demonstração If...Then...Else. Caso a condição seja Falsa, o loop rodará normalmente.

No exemplo que se segue, myNum é assinalado como um valor que cria um loop interminável. A Demonstração If...Then...Else verifica esa condição, prevenindo repetições intermináveis.

Sub ExitExemplo()

Dim counter, myNum

counter = 0

myNum = 9

Do Until myNum = 10

myNum = myNum - 1


If myNum < 10 Then Exit Do

Loop


End Sub

Utilizando While...Wend

A Demonstração While...Wend é fornecida em VBScript para usuários familiarizados com sua utilização. Entretanto, por causa da pouca flexibilidade While...Wend, é recomendada a utilização do modo Do...Loop.

Utilizando For...Next

Pode-se utilizar Demonstrações For...Next para rodar um bloco de Demonstrações por um número específico de vezes. Para loops, utilize uma variável de contagem, da qual o valor aumenta ou diminui a cada repetição do loop.

O exemplo a seguir causa um procedimento chamado MyProc para execução de 50 vezes. A Demonstração For especifica a variável de contagem x, iniciando e finalizando valores. A demonstração Next incrementa a variável de contagem por 1.

Sub DoMyProc50Times()

Dim x

For x = 1 To 50

MyProc

Next

End Sub

Utilizando a palavra-chave Step, pode-se aumentar ou diminuir a variável de contagem, através do valor especificado pelo usuário. No exemplo a seguir, a variável de contagem já é incrementada por 2 cada vez que o loop se repete. Quando o loop é finalizado, o total será a soma de 2, 4, 6, 8, e 10.

Sub TwosTotal()

Dim j, total

For j = 2 To 10 Step 2

total = total + j

Next


InduSoft Web Studio

Página 440

MsgBox "The total is " & total

End Sub

Para diminuir a variável de contagem, utilize um valor Step negativo. Deve-se especificar um valor final menor que o valor inicial. No exemplo a seguir, a variável de contagem myNum é diminuída por 2 a cada vez que o loop se repete. Quando o loop é finalizado, o total será a soma de 16, 14, 12, 10, 8, 6, 4 e 2.

Sub NewTotal()

Dim myNum, total

For myNum = 16 To 2 Step -2

total = total + myNum

Next

MsgBox "The total is " & total

End Sub

Utilizando-se da demonstração Exit For, pode-se sair de qualquer demonstração For...Next antes que a variável de contagem alcance seu valor final. Geralmente deseja-se sair do modo loop somente em algumas situações específicas, como quando na ocorrência de um erro. Por isso, deve-se utilizar a demonstração Exit For no bloco de demonstração True de uma demonstração If...Then...Else. Caso a demonstração seja Falsa, o loop rodará normalmente.

Procedimentos em VBScript

Em VBScript, existem dois tipos de procedimentos: procedimento Sub e Function.

procedimentos Sub

Procedimento Sub é uma série de Demonstrações em VBScript (enclausurados por Demonstrações Sub e End Sub) que executam ações, embora não retornem valores. Um procedimento Sub pode pegar argumentos (constantes, variáveis, ou expressões que passam quando o procedimento é solicitado). Caso um procedimento Sub não possuir argumentos, sua demonstração Sub deverá incluir parênteses vazios ().

O procedimento Sub que se segue utiliza duas funções intrínsecas (built-in) do VBScript: MsgBox e InputBox para prontificar um usuário sobre informações. Depois, os resultados de um cálculo são baseados nessas informações. O cálculo é executado em um procedimento Function criado com VBScript. O procedimento Function será exibido após a discussão a seguir.

Sub ConvertTemp()

temp = InputBox("Please enter the temperature in degrees F.", 1)

MsgBox "The temperature is " & Celsius(temp) & " degrees C."

End Sub

Procedimentos Function

Um procedimento Function consiste de uma série de demonstrações em VBScript enclausuradas pelas demonstrações Functione End Function. Um procedimento Function é semelhante a um procedimento Sub, embora também possa retornar um valor. Um procedimento Function pode pegar argumentos (constantes, variáveis ou expressões pasadas através de um procedimento de solicitação). Caso um procedimento Function não tenha argumentos, sua demonstração Function deverá incluir parênteses vazios. Function retorna um valor através do preechimento de um valor a seu nome, em uma ou mais demonstrações do procedimento. O tipo de retorno de Function será sempre uma Variante.


InduSoft Web Studio

Página 441

No exemplo que se segue, a função Celsius calcula graus Celsius a partir de graus Fahrenheit. Quando a função é solicitada a partir do procedimento Sub ConvertTemp, uma variável contendo o valor do argumento é passada para a função. O resultado do cálculo é retornado para o procedimento de solicitação e Exibido em uma caixa de texto.

Sub ConvertTemp()

temp = InputBox("Please enter the temperature in degrees F.", 1)

MsgBox "The temperature is " & Celsius(temp) & " degrees C."

End Sub

Function Celsius(fDegrees)

Celsius = (fDegrees - 32) * 5 / 9

End Function

Obtendo dados dentro e fora de procedimentos

Cada parte de um dado é passada para seus procedimento com a utilização de um argumento. Argumentos funcionam como substituidores para dados os quais você deseja mandar para seu procedimento. Pode-se nomear seus argumentos como qualquer nome de variável válido. Ao criar um procedimento com a utilização das demonstrações Sub ou Function, deverão ser incluídos parênteses após o nome do procedimento. Quaisquer argumentos são colocados entre parênteses, separados por vírgulas. Por exemplo, no exemplo que se segue, fDegrees é o substituidor para o valor a ser passado à função Celsius para conversão.

Function Celsius(fDegrees)

Celsius = (fDegrees - 32) * 5 / 9

End Function

Para extrair dados de um procedimento, deve-se utilizar Function. Lembre-se de que um procedimento Function pode retornar um valor, enquanto um procedimento Sub não pode.

Utilizando procedimentos Sub e Function em código

O procedimento Function em seu código deve ser sempre utilizado no lado direito de uma variável ou expressão assinalada. Por exemplo:

Temp = Celsius(fDegrees)

ou

MsgBox "The Celsius temperature is " & Celsius(fDegrees) & " degrees."

Para solicitar um procedimento Sub a partir de outro procedimento, digite o nome do procedimento com valores para quaisquer argumentos solicitados, separados por vírgulas. A demonstração Call não é requisitada, mas caso você queira utiliza-la, deve-se colocar os argumentos entre parênteses.

O exemplo a seguir mostra duas solicitações para o procedimento MyProc. Uma delas utiliza a demonstração Callno código; a outra não. Ambas executam exatamente a mesma função.

Call MyProc(firstarg, secondarg)

MyProc firstarg, secondarg

Note que os parênteses são omitidos na solicitação quando a demonstração Call não é utilizada.


InduSoft Web Studio

Página 442

Capítulo 16: Utilizando a Ferramenta/Editor de Tradução Utilizando a Ferramenta de Tradução, pode-se traduzir qualquer texto da aplicação que esteja visível durante o runtime para diferentes linguagens (idiomas). As principais vantagens desse recurso são:

Não é necessário recriar as telas, alarmes ou quaisquer outras interfaces de sua aplicação para traduzí-la para outro idioma. Todos os arquivos da aplicação permanecem em seu idioma original (e.x. English), e a tradução para diferentes idiomas fica centralizada em um (ou mais) arquivos(s) CSV, em formato de texto.

O InduSoft Web Studio é UNICODE-compliant (2 bytes para cada caractere). Portanto, pode-se traduzir sua aplicação para qualquer idioma que requisite caracteres UNICODE (Japonês, Chinês, Coreano, etc.) conquanto que você selecione a fonte UNICODE para seu projeto.

A tradução para outros idiomas pode ser configurada em um arquivo CSV padrão. Portanto, pode-se utilizar o Translation Editor do IWS (Tools > Translation Editor) para registrar (escrever) textos traduzidos, ou utilizar qualquer editor para arquivos CSV, como Microsoft Notepad ou Microsoft Excel, para criar o arquivo com o texto traduzido.

Translation Tool traduz frases e parágrafos inteiros, ao invés de traduzir palavra por palavra, permitindo o ajuste do texto traduzido de acordo com as regras gramaticais de cada idioma.

Pode-se configurar o idioma padrão para tradução ao rodar a aplicação utilizando uma inteface Automatic Translation, disponível no tab Options do diálogo Project Settings (Project > Settings). Além disso, pode-se alterar o idioma durante o runtime (on-the-fly) utilizando a função built-in SetTranslationFile()do IWS.

Ao executar SetTranslationFile() na Web Thin Client station, aplica-o somente ao exemplo Web Thin Client particular. Portanto, pode-se ter vários Web Thin Clients rodando simultaneamente, e cada um pode exibir as telas em um idioma diferente.


InduSoft Web Studio

Página 443

Configurações do Projeto para Tradução Automática Ao configurar uma aplicação para suportar mais de um idioma, pode-se configurar os parâmetros a seguir no tab Options do diálogo Project Settings (menu Project > Settings):

Diálogo Project Settings –Tab Options

Translation File Name: O arquivo de tradução configurado nesse campo será carregado por padrão logo ao iniciar a Aplicação. Essa opção é útil para configurar o nome do arquivo de tradução padrão ao iniciar a aplicação. O usuário pode configurar diferentes idiomas durante o runtime, executando a função SetTranslationFile().

Habilite Translation: Quando essa opção está desabilitada (clear), a Ferramenta de Tradução está desabilitada e o texto é exibido somente como configurado nos arquivos originais da aplicação.

Ao apertar o botão Advanced, pode-se configurar os seguintes parâmetros para a Ferramenta de Tradução:

Diálogo Advanced

* Startup Column Name: Pode- se criar um ar quivo CSV com tradução para mais de um idioma. O texto no idioma original utilizado quando a aplicação foi criada está na primeira coluna do arquivo CSV. Cada idioma é adicionado a novas colunas. A primeira linha do arquivo CSV indica o nome de cada coluna. Pode-se especificar nesse campo o nome de cada coluna que deverá ser utilizada, por padrão, para traduzir a aplicação


InduSoft Web Studio

Página 444

logo ao iniciá-la. Caso esse campo for deixado em branco, a aplicação será iniciada com seu idioma original. O usuário poderá configurar um idioma diferente durante o runtime executando a função SetTranslationFile().

* Ignore space chars at the end and beginning of the text: Quando essa opção está habilitada, o caractere espaço no final e no início de cada texto é ignorado para a tradução. Essa opção é útil para evitar entradas duplicadas na tabela de tradução devido aos caracetres de espaço configurados erroneamente ao criar os objetos ou somente ajustar o alinhamento.

* Keep original text when translation is blank: Quando essa opção está habilitada, o texto original será mantido quando não houver um texto configurado para ser traduzido na coluna atualmente destinada à tradução da Aplicação. Caso essa opção esteja desabilitada, o texto original será omitido durante o runtime quando não houver textos atualmente configurados para tradução da aplicação.

Configurando Object Properties para Objetos de Tela

Para habilitar a tradução de objetos de tela individuais, utilize o procedimento que se segue:

Crie os objetos de texto e tela para sua aplicação utilizando a barra de ferramentas descrita em “Utilizando Objetos e Dinâmicas” o início da página 185.

Ao abrir os diálogos Object Properties para especificar os parâmetros de cada objeto, verifique se o check-box Extern translation está habilitado ( ).

Por exemplo, nessa figura Extern translation está habilitado para o objeto botão OPC:

Tradução Habilitada para o Botão OPC


InduSoft Web Studio

Página 445

Translation Editor O Translation Editor pode ser iniciado pela opção do menu Tools > Translation Editor:

Translation Tool

O arquivo especificado no campo Translation File Name a partir do tab Options do diálogo Project Settings (Project > Settings) já estará aberto por padrão. Pode-se abrir um arquivo diferente de tradução a partir da opção File > Open no menu Translation Editor. Além disso, pode-se criar um novo arquivo de tradução com a opção File > New no menu do Translation Editor.

A primeira coluna é reservada para o texto em seu idioma original, utilizado quando a aplicação foi criada. Embora você possa adicionar texto a essa coluna manualmente, também é possível importar o texto de sua aplicação automaticamente para essa coluna executando-se o comando Import String Application, disponível no tab File do menu do Translation Editor.

Dica:

Pode-se executar o comando File > Import String Application para atualização da planilha atual no Translation Editor quantas vezes forem necessárias. Sempre que esse comando for executado, o texto disponível na aplicação que ainda não foi incluído na planilha será inserido prontamente. Porém, esse comando não remove textos de uma planilha, apesar do modo como foi inserido na planilha (manual ou automaticamente).

Pode-se escrever a tradução para cada idioma diferente em colunas adicionais (que não seja na primeira coluna). Também é possível utilizar as seguintes opções do menu Edit do Translation Editor para configurar as colunas do arquivo para tradução:

Insert Column (atalho F9): Insere uma nova coluna no arquivo de tradução.

Rename Column (atalho F10): Permite a renomeação da coluna selecionada atualmente.

Insert Column (atalho F11): Deleta a coluna selecionada atualmente.

Após editar o arquivo de tradução, pode-se utilizar as opções File > Save or File > Save As do menu do Translation Editor para salvar as configurações no arquivo de tradução (em formato CSV).


InduSoft Web Studio

Página 446

O InduSoft Web Studio suporta arquivos de tradução em formato CSV. Assim, pode-se utilizar tanto o Translation Editor como qualquer outro editor para arquivos CSV, como Microsoft Notepad ou Microsoft Excel para a criação do arquivo de tradução. A primeira linha do arquivo CSV indica o nome de cada coluna. As colunas são separadas pela utilização de vírgulas (“,”).

Embora seja possível criar mais de um arquivo de tradução, é recomendável que se mantenha a tradução para todos os idiomas em um único arquivo, pois dessa maneira torna-se mais fácil para mantê-los atualizados quando a aplicação é modificada– Pode-se atualizar o arquivo de tradução utilizando o File > Import String Application apenas uma vez.

Notas: Por diversas razões, o Translation Tool suporta arquivos de tradução com a extensão TRA. Tais arquivos salvos com essa extensão utilizar o caractere barra (“|”) ao inves de vírgulas (“,”) para a separação do texto entre as colunas.

Editando Planilhas Para abrir a planilha a ser editada:

Selecione File → Open.

Quando aparecer o diálogo Open, localize e selecione a planilha a qual você deseja editar.

Clique em OK para fechar o diálogo.

Salvando Tempo de Digitação: Após digitar os termos na planilha, pode-se selecionar File → Save As para salvar uma cópia da planilha com um novo nome ou selecionar Window → New Window para abrir uma nova janela contendo uma planilha duplicada, que poderá ser salva com um novo nome. Assim, na nova planilha, você poderá manter os termos em uma coluna e substituí-los em outra coluna.

Existem vário meios para a edição de uma planilha Translation:

Alterando ou deletando termos individuais

Inserindo linhas

Copiando de uma planilha para outra

Alterando ou deletando termos

O procedimento para alterar ou deletar termos em uma planilha está exibido a seguir:

Quando a planilha selecionada exibir-se no Translation Editor, clique duas vezes no termo a ser alterado, e digite o novo termo desejado. Aperte Enter.

Salve suas alterações na planilha selecionando File → Save or File → Save As.

Nota: Embora seja possível salvar arquivos da planilha de tradução em qualquer diretório, recomendamos que os arquivos sejam salvos na pasta Web de seu projeto, tornando-os disponíveis para a utilização de um Web Thin Client.


InduSoft Web Studio

Página 447

Inserindo linhas Caso você deseje inserir um ou mais termos entre os termos já existentes na planilha, posicione o cursor em uma célula, selecione Edit → Insert Line, e o IWS irá inserir uma linha em branco acima da célula já existente.

Por exemplo,

Inserindo um Linha

Copiando termos entre planilhas O Translation Editor permite recortar ou copiar termos de uma planilha Translation e colá-los em uma outra planilha. Também é possível copiar os termos de um arquivo em Excel e cola-los em uma planilha Translation.

Para copiar termos de uma planilha (ou arquivo) para outra, siga os passos a seguir:

Abra ambas as planilhas.

Localize o termo (s) que você deseja copiar e selecione-o com o cursor.

Pode-se selecionar múltiplos termos de uma coluna e copiá-los em outra coluna.

Copie o termo(s) selecionado Edit → Copy, apertando Ctrl+C, ou clicando em ).

Na segunda planilha, selecione a célula (s) onde você deseja colocar os novos termos, e cole-os

selecionando Edit → Paste, apertando Ctrl+V, ou clicando em ).

Repita os passos anteriores até que todos os termos desejados tenham sido compartilhados entre as planilhas.

Salve suas alterações.

Pesquisando a planilha

Caso sua planilha contenha vários termos (pode-se inserir até �� termos), você poderá utilizar as opções Edit → Find or View → View Line para efeturar a pesquisa dos termos desejados.

• Selecionar Edit → Find abre o diálogo Find:

Antes: Seleção de Temperature

Depois: Nova linha inserida acima de Temperture


InduSoft Web Studio

Página 448

Diálogo Find

Digite um termo no text box Find What e especifique um ou mais dos seguintes parâmetros opcionais de pesquisa:

* Match whole word only: Habilite ( ) esse box para evitar que o IWS busque termos inseridos em meio a outra palavra. Por exemplo, estando essa opção desabilitada, e tentar procurar por “e,” o IWS encontrará operando, expandir, etc.

* Match case: Habilite ( ) esse box para pesquisar um termo utilizando a mesma capitalização digitada no text box Find What. Por exemplo, estando essa opção desabilitada e tentar pesquisar por “TankLevel,” o IWS encontrará TANKLEVEL ou tanklevel.

* Up e Down: Habilite esse botão para controlar a direção na qual o progroma deverá buscar pelo seu termo. A pesquisa terá seu início a partir da linha atual. Por exemplo, caso existam 345 linhas na planilha inteira e você encontra-se na linha 325, o IWS pesquisará somente 325 de 345.

Clique em Find Next para iniciar (e continuar) a pesquisa por um termo.

• Utilize a opção View → View Line para alcançar uma linha particular da planilha. Quando o diálogo Line aparecer, digite o número da linha no campo Number e clique em OK.

Diálogo Line

Eestaurando padrões

Após redimensionar uma planilha Translation ou colunas de uma planilha, pode-se selecionar Window → Restore Defaults da barra de menu Translation Editor e a janela (ou coluna) será revertida para seu tamanho original de exibição.

Salvando suas planilhas Para salvar seu trabalho após a criação ou edição de uma planilha Translation, selecione File → Save ou File → Save As da barra de menu de Translation Editor.

Executando as Funções de Tradução Após habilitar a tradução para a aplicação e objetos de tela, e criar/editar planilhas Translation, você poderá executar as seguintes funções do IWS:


InduSoft Web Studio

Página 449

• SetTranslationFile(strFileName): Especifica o arquivo da planilha Translation e traduz todos os textos habilitados da aplicação durante o runtime.

• Ext(strText): Especifica um string do texto (não relacionado a um objeto de tela) a ser traduzido. Por exemplo, o resultado de uma expressão a ser visualizada por um usuário final.

Pode-se executar ambas as funções de forma simultânea, e essas irão pesquisar a aplicação e alterar o texto/objetos especificados para serem traduzidos para o novo idioma. Ambas as funções são suportadas pelo Windows NT/2000/XP/CE e plataformas Web Thin Clients.

Nota: Pode-se salvar arquivos de tradução em qualquer diretório; porém, recomendamos que os arquivos sejam salvos na pasta Web de seu projeto, de forma a poderem ser utilizados por um Web Thin Client.

Por exemplo, caso seu idioma de desenvolvimento padrão seja Inglês e você deseja tornar o arquivo disponível para Web Thin Clients, pode-se alterar o nome padrão da planilha para English.tra e salvar o arquivo na seguinte pasta:

C:\Program Files\InduSoft Web Studio\Projects\<Project Name>\Web

Utilizando SetTranslationFile(“strFileName”) Deve-se utilizar a função SetTranslationFile(“strFileName”) para traduzir todos os objetos de tela habilitados dentro da aplicação.

Para executar essa função,

Crie dois botões (ou outro objeto de tela).

Clique duas vezes em cada botão para abrir o diálogo Object Properties e especificar um nome significativo para cada um deles (Por exemplo, English e Spanish).

Criando Dois Botões

Clique no primeiro botão e aplique a propriedade Command ( ).

Clique duas vezes no botão para abrir o diálogo Object Properties.

Digite SetTranslationFile(“strFileName”) no campo Expression — para substituir o nome do arquivo de tradução entre a planilha dupla.

Por exemplo, SetTranslationFile(“English.tra”)

Configurando o Arquivo de Tradução


InduSoft Web Studio

Página 450

Nota: Caso você salve as planilhas Translation na pasta Web de seu projeto (para tornar os arquivos disponíveis para Web Thin Clients), deve-se também digitar o caminho do diretório para o determinado arquivo. Por exemplo,

C:\Program Files\InduSoft Web Studio\<Project Name>\Web\<filename.tra>

ou digite (“\web\<filename>.tra”).

Aplique a propriedade Command para o Segundo botão, e depois clique duas vezes no botão para abrir o diálogo Object Properties.

Digite SetTranslationFile(“strFileName”)no campo Expression — para substituir o nome do segundo arquivo de tradução entre a planilha dupla.

Por exemplo, SetTranslationFile(“Spanish.tra”)

A partir de agora, ao rodar a aplicação ( ) você poderá clicar nos botões para inverter entre os dois idiomas, como mostrado nas telas que se seguem:

Traduzindo entre Inglês e Espanhol

Caso você queira verificar que a tradução foi executada com sucesso, pode-se criar um tag (Por exemplo, STATUS) e adicioná-lo à tela de sua aplicação. Quando você rodar a aplicação, o novo tag irá retornar um dos valores listados na tabela abaixo.

Valor de Retorno

Descrição

0 Success

1 Invalid number of parameters

Clique no Botão Spanish e os Objetos de Tela serão Exibidos em Espanhol

Clique no Botão English e os Objetos de Tela serão Exibidos Display em Inglês


InduSoft Web Studio

Página 451

2 Wrong parameter type

3 Translation file could not be found or opened

Utilizando Ext(“strText”) Pode-se utilizar a função ext(“strText”) para traduzir strings de texto da aplicação, como os resultados de um operação que você deseja que seja exibida para um usuário final.

Para executar essa função,

Abra uma planilha no IWS (Por exemplo uma planilha Math), e digite um tag tipo string na coluna Tag Name.

Clique duas vezes em cada botão na tela para abrir o diálogo Object Properties e especificar um nome significativo para cada um deles (Por exemplo, English e Spanish).

A função ext(“strText”) retorna a tradução do texto utilizando a planilha ativa Translation.

Por exemplo,

Ext(“Start”) // Returned value in Spanish = “Comience” Ext(“Stop”) // Returned value in Spanish = “Pare” Ext(“StrTag”)

Fechando o Translation Editor Para fechar o Translation Editor, selecione File → Exit da barra de menu Translation Editor.

• Caso você já tenha salvo a planilha(s) aberta(s) Translation, o Translation Editor será fechado imediatamente.

• Caso exista alterações não salvas em planilha(s) Translation aberta(s), o IWS irá requisitar que tais alterações sejam salvas antes de finalizar a função.

– Clique em Yes para salvar as alterações e feche a janela.

– Clique em No para fechar a janela sem que as alterações sejam salvas.

– Clique em Cancel para manter a janela aberta e continuar o trabalho na planilha.


InduSoft Web Studio

Página 452

Capítulo 17: Interface Banco de Dados do IWS Configurar uma interface de banco de dados com o IWS significa basicamente estabelecer links entre tarefas do IWS (Alarms, Events ou Trends) para tabelas do banco de dados externo através de um Provedor Específico de Banco de Dados que suporte o banco de dados escolhido.

Cada histórico de tarefa (Alarm, Events ou Trend) pode ser configurado para salvar dados tanto para arquivos em formato de propriedade do Studio quanto para Banco de Dados Relacional SQL externos.

O IWS suporta ADO.NET, fornecendo uma interface intuitiva, ponderosa, simples e de fácil compreensão, com tecnologias padrão de MDAc (Microsoft Data Access Components), como OLE-DB (Object Linking Embedded – Database) e ODBC (Open Database Connectivity). Utilizando-se dessa capacidade, é possível conectar-se a qualquer banco de dados compatível a MDAC (veja Conformance Test Table para a lista de banco de dados já testados pela InduSoft).

As tarefas a seguir suportam a interface de banco de dados :

Alarms: A aplicação pode salvar e/ou entregar mensagens de históricos de alarmes em um banco de dados relacional.

Events: A aplicação pode salvar e/ou entregar mensagens de evento em um banco de dados relacional.

Trends: A aplicação pode salvar e/ou entregar valores históricos de Trend em um banco de dados relacional.

Viewer: Informações do banco de dados podem ser exibidas tanto em formato tabela (Alarm e objetos Grid) quanto em formato gráfico (objeto Trend).

Web: Os itens listados abaixo já Estão disponíveis na Interface do IWS da Web; assim, você poderá desfrutar de uma aplicação que armazena/salva dados em um banco de dados relacional, bem como tê-la trabalhando por toda a Web.

Com a utilização de sua própria interface de banco de dados, o IWS pode facilmente tanto fornecer dados do chão de fábrica para sistemas de terceiros (e.x. ERP) quanto obter dados a partir desses.

IWS é capaz de estabelecer interface com quaisquer bancos de dados relacionais suportados por fornecedores válidos ADO.NET Provider, OLE DB Provider ou ODBC Driver. Porém, os testes de compatibilidade foram executados junto aos seguintes bancos de dados:

Banco de Dados

Versão ADO.NET Provider Versão do Grupo

Microsoft SQL Server 2000

8.0 System.Data.SqlClient 1.0.5000.0

Microsoft Access 2000

9.0.3821 SR-1 System.Data.OleDbClient 1.0.5000.0

Microsoft Excel 2000

9.0.3821 SR-1 System.Data.OleDbClient 1.0.5000.0

Oracle 10g Release 1 for Windows

System.Data.OracleClient 1.0.5000.0

Sybase Anywhere 9.0.1.1751 iAnywhere.Data.AsaClient 9.0.1.1751

MySQL 4.0.20a ByteFX.MySqlClient 0.7.6.15073

Tabela de Teste de Compatibilidade


InduSoft Web Studio

Página 453

Nota: Para informações sobre como configurar um banco de dados específico, consulte os Apêndices desse manual.

Conceitos Gerais

Essa seção descreve banco de dados e fornecedores, além do modo como o IWS estabelece interface com diferentes bancos de dados.

Banco de Dados Relacionais SQL Um Banco de Dados SQL Relacional é um conjunto de informações armazenadas em tabelas com campos e registros que suportam comandos SQL.

Cada banco de dados pode possuir uma ou mais tabelas, sendo que cada tabela é composta por campos (colunas) e registros (linhas). Tipicamente, os campos são pré-definidos e a aplicação adiciona ou lê um ou mais desse registros, de acordo com a condição apresentada.

Database DB1

Table X

Register 1Register 2Register 3

Field A Field B Field C

Table Y


Field D Field E Field F

Database DB1

Table X


Field A Field B Field CRegister 1Register 2Register 3

Field A Field B Field C

Table Y


Field D Field E Field FRegister 1Register 2Register 3

Field D Field E Field F

O IWS utiliza Database Providers (ADO.NET) para estabelecer interface com Banco de Dados SQL Relacionais. Database Providers são bibliotecas desenvolvidas para acesso a dados a partir de diferentes bancos de dados através de comandos SQL. O ADO.NET Provider para um banco de dados específico pode ser suprimido por um sistema operacional ou por um fabricante de banco de dados.

A figura a seguir ilustra como o IWS estabelece interface com diferentes bancos de dados utilizando-se de Database Provider para cada banco de dados.


InduSoft Web Studio

Página 454

A figura acima mostra alguns dos ADO.NET Providers mais comuns. Note que Microsoft ADO.NET Provider para ODBC Drivers permite o acesso a banco de dados através de um driver ODBC . Veja Apêndice do Banco de Dados A: Utilizando Banco de Dados ODBC para informações sobre como utilizar esse fornecedor. Também é possível que você não possua um ADO.NET provider, embora um OLE DB provider já esteja disponível. Utilizando o Microsoft ADO.NET Provider for OLE DB pode-se obter acesso ao banco de dados; o fornecedor Jet OLE DB da Microsoft prove acesso a aplicações em um pacote Microsoft Office com a utilização desse.

Nota: É importante notar que o IWS fornece a interface para ADO.NET Providers. Porém, ADO.NET Providers e/ou ODBC Driver/OLE DB Provider também deverão ser supridos pelo sistema operacional ou pelo fabricante do banco de dados. Caso seu string de conexão não referir-se a um ADO.NET Provider válido, o OLE DB Provider será utilizado.

Embora a maioria das aplicações tipicamente estabeleçam um link para somente um tipo de banco de dados, o IWS permite a flexibilidade para estabelecer um link de cada tarefa a um banco de dados específico suportado por um Database Provider. Além disso, com a utilização dessa Arquitetura, você não precisará se preocupar com características específicas de cada banco de dados (em sua maioria é suportada pelo Database Provider para cada banco de dados ou pela interface IWS Database Gateway). Portanto, as configurações da aplicação em sua maioria são uniformes, apesar do banco de dados específico escolhido.


InduSoft Web Studio

Página 455

Formato Histórico

As tarefas do IWS que podem gerar dados históricos (Alarms, Events e Trend) podem ser configuradas para salvar dados tanto em arquivo histórico de formato de propriedade IWS quanto em um Banco de Dados SQL Relacional externo. Pode-se escolher o formato de arquivo histórico através do combo-box History Format disponível para cada tarefa. A tabela a seguir mostra as opções disponíveis para cada tarefa:

Tarefa Formato Histórico

Configurações

Proprietary

File Format: Texto (UNICODE). O IWS utilize o caractere barra vertical (|)para separar os campos.

Default Path: …\<Aplication Path>\Alarm\ALYYMMDD.ALH , onde: YY = dois últimos dígitos do ano

MM = Mês

DD = Dia.

Alarms

Database Database Type: Escolhido pelo usuário

Default Table Name: AlarmHistory

Proprietary

File Format: Texto (UNICODE). O IWS utilize o caractere barra vertical (|) para separar os campos.

Default Path: …\<Aplicatiuon Path>\Alarm\EVYYDDMM.EVT , onde: YY = Dois últimos dígitos do ano

MM = Mês

DD = Dia.

Events

Database Database Type: Escolhido pelo usuário

Default Table Name: EventHistory

Proprietary

File Format: Binário

Default Path: …\<Aplication Path>\Hst\GGYYDDMM.HST , onde:

GG = Número do grupoTrend r (em formato hexadecimal) YY = Dois último dígitos do ano

MM = Mês

DD = Dia.

Trend

Database

Database Type: Escolhido pelo usuário

Default Table Name: TRENDGGG (GGG = Número da Planilha Trend – e.x. TREND001 para a Planilha Trend 001)


InduSoft Web Studio

Página 456

Bancos de Dados Primários e Secundários

O IWS suporta sistemas redundantes. Portanto, ao configurar a interface de um banco de dados, pode-se configurar o Banco de Dados Primário e, opcionalmente, o Banco de Dados Secundário. Tais bancos de dados podem ser configurados nos seguintes modos:

Disabled: Nesse modo, o IWS salva dados somente no Banco de Dados Primário. Caso o Banco de Dados Primário esteja indisponível por qualquer razão, os dados não serão salvos em lugar algum. Essa opção pode causar perda de dados caso o Banco de Dados Primário não esteja disponível.

Redundant: Nesse modo, o IWS salva os dados tanto no Banco de Dados Primário quanto no Secundário. Caso um deles esteja indisponível, o IWS manterá os dados salvos naquele disponível no momento. Quando o banco de dados antes indisponível tornar-se disponível novamente, o IWS sincroniza ambos automaticamente.

Store and Forward: Nesse modo, o IWS salva dados somente no Banco de Dados Primário. Caso o Banco de Dados Primário tornar-se indisponível, o IWS salvará os dados no Banco de Dados Secundário. Quando o Banco de Dados Primário tornar-se ativo novamente, o IWS moverá os dados do Banco de Dados Secundário para o Banco de Dados Primário.

Nota: Os Bancos de Dados Prímário e Secundário podem ser de tipos diferentes. Porém, devem possuir os mesmos campos.

Utilizando o Banco de Dados Secundário, pode-se aumentar a realística do sistema, além de utilizá-lo como um backup quando o Banco de Dados Primário não estiver disponível. Essa Arquitetura é particularmente útil quando o Banco de Dados Primário está localizado em uma estação remota. Nesse caso, pode-se configurar um Banco de Dados Secundário na estação local para salvar dados temporariamente, caso o Banco de Dados Primário não esteja disponível (durante uma falha na rede de trabalho, por exemplo).


InduSoft Web Studio

Página 457

Banco de Dados Padrão

Embora o IWS permita a configuração de um banco de dados para cada tarefa, tipicamente o mesmo tipo de banco de dados (e.x. SQL Server, MS Access, Oracle, etc) é utilizado por todas as tarefas de um mesmo projeto. Portanto, de forma a economizer tempo ao configurar a aplicação, o IWS permite a configuração do Default Database. Ao configurar cada tarefa, você poderá escolher a opção de utilizar os parâmetros configurados para o Default Database. Caso escolha esse método, não será necessária a reconfiguração dos mesmos parâmetros para cada tarefa, já que essas compartilharão o mesmo banco de dados.

As configurações para o Default Database podem ser efetuadas apertando o botão Configure no box Default Database no tab Options do diálogo Project Settings.

Clicando nesse botão, aparecerá a seguinte janela:


InduSoft Web Studio

Página 458

Leia a seção Configurando Banco de Dados para informações sobre os campos dessa janela.

Estabelecendo Link do Banco de Dados através de um DB Provider Remoto

Dependendo da Arquitetura de seu projeto, o ADO.NET Provider para Banco de Dados SQL Relacional poderá não estar disponível nas mesmas estações onde o IWS está rodando. Esse cenário é especialemnte comum quando a aplicação está rodando em um sistema operacional Windows CE (atualemnte, a maioria dos provedores não são suportados para sistema operacional Windows CE). De maneira a resolver esse problema, a InduSoft projetou uma solução flexível, permitindo que você configure sistemas de distribuição, como ilustrado na figura a seguir:

A Aplicação está rodando na estação da aplicação do Studio Aplicação (onde o IWS e/ou CEView Estão instalados). A aplicação pode comunicar-se com o Database Gateway do IWS (rodando em um computador remoto) via TCP/IP. O Gateway implementa a interface com o Banco de Dados através de um provedor disponível no computador onde está rodando.

O Database Gateway do IWS não requer configurações complexas. Basta copier os arquivos STADOSvr.exe e StADOSrv.ini da subpasta \BIN sub-folder do IWS e cola-los em qualquer diretório do computador que esteja sendo utilizado como estação Gateway e executar o programa STADOSvr.exe. Existem configurações associadas ao Studio Database Gateway, mas essas não devem ser alteradas, a menos em circunstâncias especiais. Veja “Studio Database Gateway” para informações sobre como configurar paâmetros avançados do Studio Database Gateway.

Dica:

O IWS Database Gateway é um TCP/IP Server para a aplicação do IWS, e utiliza TCP Port 3997 por padrão. Pode-se especificar um número distinto para a porta ao executar o programa STADOSvr.exe de acordo com a sintaxe a seguir: STADOSvr.exe <Port Number> . Exemplo: STADOSvr 3998


InduSoft Web Studio

Página 459

Configurando Parâmetros dos Bancos de Dados

Para configurar uma interface do banco de dados com o IWS deve-se basicamente estabelecer links entre tarefas do IWS (Alarms, Events ou Trends) para tabelas de banco de dados externos via um Provedor específico de Banco de Dados que suporte o banco de dados escolhido.

Cada histórico de tarefa (Alarm, Events ou Trend) pode ser configurado para salvar dados tanto para arquivos de formato de propriedade do Studio ou para Banco de Dados SQL Relacionais externos. Ao selecionar o Banco de Dados como Formaro de Propriedade, as configurações da interface do banco de dados podem ser efetuadas através das seguintes interfaces:

Tarefa Interface

Alarms

Selecione o menu Project Settings menu.

Selecione o tab Options no diálogo Project Settings.

Escolha o Banco de Dados no combo-box History Format.

Clique no Botão Alarm Database.

Configure os parâmetros do banco de dados no diálogo Database.

Events

Selecione o menu Settings.

Selecione o tab Options no diálogo Project Settings.


Clique no botão Event Database.

Configure os parâmetros do banco de dados no diálogo Database Configuration.

Trend

Crie ou abra uma planilha Trend.


Clique no botão Database Configuration.

Configure os parâmetros do banco de dados no diálogo Database Configuration.

Nota:

Alarms e Events são salvos em formato de propriedade do IWS, e ambos são salvos em Bancos de Dados Relacionais externos; porém, também podem ser salvos em diferentes bancos de dados.

Cada planilha Trend pode ser configurada para salvar dados em formato de propriedade do IWS ou em Banco de Dados SQL Relacional externo.


InduSoft Web Studio

Página 460

Diálogo Database Configuration

O diálogo Database Configuration permite a configuração dos parâmetros necessários para estabelecer um link entre o IWS e um Banco de Dados SQL Relacional externo.

A figura a seguir mostra o diálogo Database Configuration:

Diálogo Database Configuration

combo-box Database: Permite a seleção Primary ou Secondary. Em Primary, todas as configurações exibidas na janela Database Configuration serão aplicadas a interface do Banco de Dados Primário. Também aplicam-se a interface do banco de dados Secundário. Pode-se configurar o Banco de Dados Secundário nos seguintes modos:

Disabled: Nesse modo, o IWS salva dados somente no Banco de Dados Primário. Caso o Banco de Dados Primário esteja indisponível por qualquer razão, os dados não serão salvos em nenhum outro local. Essa opção pode causar perda de dados, caso o Banco de Dados Primário esteja indisponível.

Redundant: Nesse modo, o IWS salva dados tanto no Banco de Dados Primário quanto no Secundário. Caso um deles esteja indisponível, o IWS mantém os dados salvos somente no banco de dados disponível no momento. Quando banco de dados indisponível voltar a estar disponível, o IWS sincroniza ambos automaticamente.

Store and Forward: Nesse modo, o IWS salva dados no Banco de Dados Primário somente. Caso o Banco de Dados Primário tornar-se indisponível, o IWS salva os dados no Banco de Dados Secundário. Quando o Banco de Dados Primário tornar-se disponível novamente, o IWS move os dados do Banco de Dados Secundário para o Banco de Dados Primário.

Utilizando o Banco de Dados Secundário, pode-se aumentar a realística do sistema e utilizar o Banco de Dados Secundário como um backup quando o Banco de Dados Primário não está disponível. Essa Arquitetura é particularmente útil quando o Banco de Dados Primário está localizado em uma estação remota. Nesse caso, pode-se configurar um Banco de Dados


InduSoft Web Studio

Página 461

Secundário na estação local para salvar dados temporariamente caso o Banco de Dados Primário não estiver disponível (durante uma falha na rede de trabalho, por exemplo).

check-box Use Aplication default: Quando esta opção está habilitada, o IWS utilize os parâmetros configurados no Default Database para a tarefa que está sendo configurada (Connection string, User name, Password, Retry Interval e Advanced Settings). Quando desabilitada, pode-se configurar esses parâmetros individualmente para a tarefa atual.

Campo Connection string: Esse campo define o banco de dados onde o IWS registrará e lerá valores, assim como os parâmetros principais utilizados ao conectar-se ao banco de dados. Ao invés de registrar o Connection string manualmente, pode-se apertar o botão do browse (…) e selecionar o tipo de banco de dados a partir da janela Data Link Properties.

Nota:

A lista de Provedores de Banco de Dados exibidos na janela Data Link Properties dependerá dos provedores instalados e disponíveis no computador onde você está rodando o IWS. Consulte a documentação do sistema operacional (na documentação do Banco de Dados) para maiores informações sobre as configurações do Provedor para o banco de dados a ser utilizado.

Campo User name: Nome do usuário utilizado para conectar-se ao banco de dados. O nome do

usuário configurado nesse campo deve ser igual àquele configurado no banco de dados.

Campo Password: Senha utilizada para conectar-se ao banco de dados. A senha configurada nesse campo deve ser a mesma configurada no banco de dados.

Campo Retry Interval: Caso o IWS esteja indisponível para conectar-se ao banco de dados por qualquer razão, ele tentará uma nova conexão ao banco de dados automaticamente após o número de segundos configurados nesse campo.


InduSoft Web Studio

Página 462

Botão Advanced: Após apertar esse botão, você obterá acesso a algumas configurações costumizáveis. Para a maioria das aplicações, o valor padrão não precisa ser modificado, e deve ser mantido.

– combo box Milliseconds: Pode-se configurar como os milissegundos serão salvos ao configurar e salvar a data no banco de dados. Cada banco de dados salva a data em formatos diferentes; Por exemplo, alguns bancos de dados não suportam milissegundos em um campo Date. Estão disponíveis as seguintes opções:

• Default: Utiliza o formato pré-definido para o banco de dados atual. O banco de dados previamente testado pela InduSoft já são configurados com a opção mais adequada. Ao selecionar Default, o IWS utiliza os parâmetros pré-configurados para o tipo de banco de dados atual. Caso você esteja utilizando um banco de dados que já tenha sido previamente testado e configurado pela InduSoft, a opção Default tentará salvar os milissegundos em um campo separado.

Dica:

A opção padrão para cada banco de dados está configurada no arquivo StudioADO.ini, armazenado na subpasta \BIN do IWS. Veja “Studio Database Gateway” para informações sobre como configurar o arquivo StudioADO.ini.

• Disable: Não salva os milissegundos ao salvar a data no banco de dados.

• Enable: Salva os milissegundos no mesmo campo onde a data foi salva.

• Separate Column: Salva os milissegundos em uma coluna separada. Nesse caso, a data é salva em um campo (sem a precisão de milissegundos) e o número de milissegundos é salvo em uma coluna diferente. Essa opção indica onde você deseja salvar timestamps com a precisão de milissegundos, embora o banco de dados que você está utilizando não suporte milissegundos para os campos Date.

– check-box Save time difference: Quando essa opção está habilitada (padrão), o IWS salva a Time Zone configurada no computador onde a aplicação está rodando para cada registro no banco de dados. Essa opção deve ser habilitada para evitar problemas horários a serem salvos.

– Database Gateway: Insira o Endereço Host Name/IP onde o Studio database gateway estiver rodando. O número da Porta TCP também pode ser especificado, mas caso o padrão não estiver sendo utilizado, você terá que configurar o Studio database gateway com a mesma Porta TCP. Veja “Studio Database Gateway” para informações sobre como configurar parâmetros avançados para o Studio ADO Gateway.

– Disable Primary Key: Para alguns módulos, o IWS tentará definir uma chave primária para a tabela de modo a aumentar a velocidade de suas tarefas. Caso você esteja utilizando um


InduSoft Web Studio

Página 463

banco de dados que não suporte chaves primárias (e.x. Microsoft Excel), você deverá habilitar esse campo.

painel Table: Essa área permite a configuração de parâmetros da Tabela onde os dados serão salvos. Todas as terefas podem compartilhar de um mesmo banco de dados. Porém, cada tarefa (planilhas Alarm, Events, Trend) devem estabelecer um link para a sua própria Tabela. O InduSoft Não habilita configurações inválidas nesse campo, portanto, você deverá certificar-se de que a configuração é adequada para o banco de dados que está sendo utilizado.

check-box Use default name: Quando essa opção está habilitada (padrão), o IWS salva e/ou entrega os dados em uma Tabela com o nome padrão escrito no campo Name.

check-box Automatically create: Quando essa opção está habilitada (padrão), o IWS cria uma tabela com o nome escrito no campo Name automaticamente. Caso essa opção não esteja habilitada, o IWS não criará a tabela automaticamente. Portanto, o programa não será capaz de salvar dados no banco de dados, a menos que você tenha configurado uma tabela com o nome configurado manualmente no campo Name do banco de dados.

Name: Especifica o nome da Tabela do banco de dados onde os dados históricos serão salvos.

botão Refresh: Caso o banco de dados configurado esteja atualmente disponível, pode-se apertar o botão Refresh para preencher o combo-box Name com o nome das tabelas atualmente diposníveis no banco de dados. Desse modo, pode-se selecionar a tabela onde os dados históricos serão salvos, ao invés de escrever manualmente o nome da Tabela no campo Name.

painel Run-Time: Essa área permite que você insira os tags do IWS. Os seguintes campos estão disponíveis:

– check-box Status (output): O tag nesse campo receberá um dos seguintes valores:

Valor Descrição

0 Desconectado do banco de dados. O banco de dados não está disponível ou sua configuração está incorreta.

1 O banco de dados foi desconectado com sucesso.

2 O banco de dados está sendo sincronizado.

– Reload (output): Caso você esteja utilizando colchetes em quaisquer campos de configuração, você deverá especificar o tag de reload. Quando desejar reconectar-se ao banco de dados utilizando os valores atualizados de seus tags, configure o tag nesse campo como 1. O IWS atualizará a configuração ao tentar executar uma ação no banco de dados, assim como configurará o tag de volta para zero quando tiver terminado.

Studio Database Gateway O Studio Database Gateway é um server TCP/IP que interage com banco de dados utilizando-se do Microsoft .NET Framework 1.1 e pode rodar no mesmo computador em que está rodando a aplicação do IWS ou em um computador distinto. O Database Gateway Host de Advanced Settings (veja “Diálogo Diálogo Database Configuration”) especifica se o gateway rodará no computador local ou não. Caso você esteja utilizando o computador local, deve-se inserir localhost ou 127.0.0.1 no nome Host. Não se preocupe com a inicialização ou paradas no funcionamento do gateway, pois ambas serão executadas automaticamente pelas tarefas do IWS. Por outro lado, ao rodar o gateway remotamente, você precisará iniciar o gateway de forma manual. Para isso, copie os arquivos StADOSvr.exe e StudioADO.ini da pasta BIN do IWS para o computador remoto, e depois execute StADOSvr.exe.

O gateway pode ser inicializado múltiplas vezes para diferentes números de Portas TCP/IP. O número de porta padrão é 3997, e esse é modificado especificando-se o número da porta desejado no prompt de comando (e.x. StADOSvr 1111). Rodar StADOSvr, adicionará o seguinte ícone à barra de ferramentas:


InduSoft Web Studio

Página 464

Clicando-se com o botão direito no ícone da barra fará com que apareçam as seguintes opções:

A opção hide define se a janela de correção será exibida ou não. Caso você retire a seleção dessa opção, a seguinte janela aparecerá:

Qualquer falha que ocorra durante operações com bancos de dados serão exibidas nessa janela e na janela IWS LogWin. As mensagens são reportadas por exceções geradas pelo Provedor ADO.NET. (Leia “Resolvendo Problemas do Banco de Dados” para maiores informações sobre mensagens de erros no módulo Gateway.)

O Studio Database Gateway possui Advanced Settings que são configuradas no arquivo StADOSvr.ini. Caso você tenha problemas para estabelecer interfaces com um banco de dados específico, provavelmente você necessitará de algumas dessas configurações ou adicionar novos provedores para o arquivo. Estão disponíveis os seguintes parâmetros:


InduSoft Web Studio

Página 465

Parâmetro Escala de Valores Descrição

SaveMSec 1 - Deasabilitar 2 - Habilitar 3 - Separar Coluna

Essa configuração especifica o comportamento padrão para o provedor ao salvar milissegundos. O padrão pode ser alterado em Advanced Settings nos diálogos Database Configuration Dialogs.

Assembly Qualquer string que contenha assembly .Net Framework

Opção Assembly para todos os provedores, a qual possui todas as classes requisitadas para estabelecer interface com o banco de dados. A maioria dos provedores estão dentro da assembly System.Data.

ConnectionClass Qualquer classe de conexão dentro de assembly

Connection Class é um dos implementos para a interface System.Data.IDbConnection.

DataAdapterClass Qualquer adaptador de dados dentro de assembly

Data Adapter class é utilizaa em operações onde são necessários atualizações para o banco de dados. Deve ser compatível com a classe de conexão especificada, e deve implementar o IDbDataAdapter.

CommandBuilderClass Qualquer classe de constructor de command dentreo de assembly

Command Builder class é responsável por atualizações em bancos de dados. Deve ser compatível com a classe de conexão.

Provider Nome do provedor

Um dos parâmetros na string de conexão é "Provider". O Studio ADO Gateway compara o valor do string de conexão com o valor para esse parâmetro em cada provedor, e define o masi apropriado para ser utilizado.

ColumnDelimiterPrefix Qualquer caracterer ou grupo de caracteres

Especifica um caractere que será substituído antes de nomes de colunas em demonstrações SQL

ColumnDelimiterSuffix Qualquer caracterer ou grupo de caracteres

Especifica um caractere que será substituído após nomes de colunas em demonstrações SQL

TableDelimiterPrefix Qualquer caracterer ou grupo de caracteres

Especifica um caractere que será substituído antes de nomes detabelas em demonstrações SQL

TableDelimiterSuffix Qualquer caracterer ou grupo de caracteres

Especifica um caractere que será substituído após nomes detabelas em demonstrações SQL

ValueString Qualquer String

Esse valor indica quais valores constants são identificados em demonstrações SQL. Para Microsoft SQL databases por exemplo, o valor deve ser @Value, para marca da pergunta ODBC (?)


InduSoft Web Studio

Página 466

ValueStringPrefix Qualquer String

Esse valor indica um prefixo para ser utilizado antes de valores. Valores Oracle por exemplo requisitam um prefixo. As demonstrações SQL utilizam identificadores de valores utilizando-se de seus prefixos, embora esses parâmetros em Connection class não utilizem o prefixo.

ValueAddNumber 0 ou 1

Indica se um número sequencial deve ser adicionado ao ValueString para identificar o parâmetro ou não. Para Microsoft SQL database, esse parâmetro deve ter o valor 1, pois os parâmetros são identificados utilizando-se @Value1, @Value2 …, @ValueN. Para ODBC, esse parâmetro deve ser 0.

BoolType

Qualquer string representando um tipo de dados válidos para o banco de dados

Ao tentar criar colunas para armazenar valores boolean, o tipo de dados especificados nesse parâmetro será utilizado. Deve-se certificar-se de que o tipo de dados especificado é capaz de salvar valores Boolean.

IntegerType


Ao tentar criar colunas para armazenar integer values, o tipo de valores especificado nesse parâmetro deverá ser utilizado. Deve-se certificar-se deque o tipo de valor especificado é capaz de armazenar valores de 32 bit.

RealType


Ao tentar criar colunas para armazenar real values, o tipo de valores especificado nesse parâmetro deverá ser utilizado. Deve-se certificar-se deque o tipo de valor especificado é capaz de armazenar 64 valores reais.

StringType

Qualquer string representando um tipo de valor válido para o banco de dados

Ao tentar criar colunas para armazenar valors de string, o tipo de valores especificados nesse parâmetro será utilizado. Deve-se certificar-se de que o tipo de dados especificado é capaz de salvar o número de caracteres que você deseja salvar em sua aplicação.

TimeStampType

Qualquer string representando um tipo de valor válido para o banco de dados

Ao tentar criar colunas para armazenar valores TimeStamp, o datatype especificado nesse parâmetro será utilizado.

EnableTop 0 ou 1

Quando esse campo está configurado como 1, ADO substituirá TOP na demonstração SQL para limitar a quantidade de registros requisitados.

SingleConnection 0 ou 1 Quando esse campo está configurado como 1, ADO tarefasou computadores que


InduSoft Web Studio

Página 467

estejam requisitando-o. A sincronização entre tarefas que serão executadas pelo gateway não serão efetuadas se essa opção estiver habiliutada, e não serão capazes de serem executadas simultaneamente.

Uma chamada única de seção [Providers] possui todos os parâmetros. Os valores padrões estão especificados no início do arquivo, com a utilização do prefixo “Default” em cada parâmetro como mostrado a seguir:

[Providers] DefaultSaveMSec=3 DefaultAssembly=System.Data DefaultConnectionClass=System.Data.OleDb.OleDbConnection DefaultDataAdapterClass=System.Data.OleDb.OleDbDataAdapter DefaultCommandBuilderClass=System.Data.OleDb.OleDbCommandBuilder DefaultValueString=@Value DefaultValueAddNumber=1 DefaultBoolType=INTEGER DefaultIntegerType=INTEGER DefaultRealType=REAL DefaultStringType=VARCHAR(255) DefaultTimeStampType=DATETIME DefaultSingleConnection=0

O item a seguir nesse arquivo lista a quantidade de provedores:

Count=5

Os provedores são identificados pelo parâmetro “Provider” seguido pelo número. Ao conectar-se a um banco de dados, o parâmetro Provider no string de conexão é comparado à identificação do provedor, de modo a determinar qual provedor será utilizado. Caso não haja provedor com o valor no string de conexão, todos os valores padrão serão assumidos. Além de sua identificação, cada provedor pode possuir seu próprio valor para cada parâmetro. Outra vez, caso nenhum valor esteja especificado, o valor padrão será utilizado. Segue abaixo um exemplo com sete provedores:

Count=7

Provider1=MICROSOFT.JET.OLEDB

SaveMSec1=3

ColumnDelimiterPrefix1=[

ColumnDelimiterSuffix1=]

SingleConnection1=1

Provider2=SQLOLEDB

ConnectionClass2=System.Data.SqlClient.SqlConnection

DataAdapterClass2=System.Data.SqlClient.SqlDataAdapter

CommandBuilderClass2=System.Data.SqlClient.SqlCommandBuilder



TableDelimiterPrefix2=[

TableDelimiterSuffix2=]

RealType2=FLOAT


InduSoft Web Studio

Página 468

Provider3=MSDASQL

ConnectionClass3=System.Data.Odbc.OdbcConnection

DataAdapterClass3=System.Data.Odbc.OdbcDataAdapter

CommandBuilderClass3=System.Data.Odbc.OdbcCommandBuilder

ValueString3=?

ValueAddNumber3=0

StringType3=VARCHAR(128)

EnableTop3=0

Provider4=ORAOLEDB

Assembly4=System.Data.OracleClient

ConnectionClass4=System.Data.OracleClient.OracleConnection

DataAdapterClass4=System.Data.OracleClient.OracleDataAdapter

CommandBuilderClass4=System.Data.OracleClient.OracleCommandBuilder

ValueString4=Value

ValueAddNumber4=1

ValueStringPrefix4=:

BoolType4=Number(1)

IntegerType4=Number(10)

RealType4=Number


TimeStampType4=TIMESTAMP(0)

EnableTop4=0

Provider5=ASAPROV

Assembly5=iAnywhere.Data.AsaClient

ConnectionClass5=iAnywhere.Data.AsaClient.AsaConnection

DataAdapterClass5=iAnywhere.Data.AsaClient.AsaDataAdapter

CommandBuilderClass5=iAnywhere.Data.AsaClient.AsaCommandBuilder

ValueString5=?

ValueAddNumber5=0



TableDelimiterPrefix5=[

TableDelimiterSuffix5=]

Provider6=MYSQLPROV

Assembly6=ByteFX.MySqlClient

ConnectionClass6=ByteFX.Data.MySqlClient.MySqlConnection

DataAdapterClass6=ByteFX.Data.MySqlClient.MySqlDataAdapter

CommandBuilderClass6=ByteFX.Data.MySqlClient.MySqlCommandBuilder


InduSoft Web Studio

Página 469

ValueString6=@Value

ValueAddNumber6=1


EnableTop6=0

Provider7=MSDAORA

Assembly7=System.Data.OracleClient

ConnectionClass7=System.Data.OracleClient.OracleConnection

DataAdapterClass7=System.Data.OracleClient.OracleDataAdapter

CommandBuilderClass7=System.Data.OracleClient.OracleCommandBuilder

ValueString7=Value

ValueAddNumber7=1

ValueStringPrefix7=:

BoolType7=Number(1)

IntegerType7=Number(10)

RealType7=Number


TimeStampType7=TIMESTAMP(0)

EnableTop7=0

IWS Development Environment The Workspace Tasks Tab Alarms Folder

Alarm summary: Ao habilitar um arquivo histórico de alarme para um grupo, o IWS salva os eventos de alarme ao banco de dados de históricos, de acordo com o Formato do Arquivo configurado em Alarm History e Events. As informações salvas no arquivo histórico estão descritas na tabela a seguir.

Nome do Campo Tipo de Dados

Marcações

Version Integer Esse campo é criado somente quando o Formato de Arquivo é Proprietary. Versão atual: 003

Al_Start_Time TimeStamp

Timestamp indicando quando o alarme foi iniciado.

Quando o Formato de Arquivo é Proprietary, o IWS salva a data (MM/DD/YYYY) em um campo e a Hora (HH:MM:SS.MSS) no próximo campo.

Al_Tag String Nome do Tag

Al_Message String Mensagem de alarme

Al_Ack Boolean

0: Indica que o alarme foi reconhecido ou não requer reconhecimento

1: Indica que o alarme não foi reconhecido

Al_Active Boolean 0: Indica que o alarme não está ativo

1: Indica que o alarme está ativo

Al_Value Real Valor do Tag quando o evento de alarme ocorreu

Al_Group Integer Número do Grupo de Alarme


InduSoft Web Studio

Página 470

Al_Priority Integer Número de Prioridade do alarme

Al_Selection String Valor de Saleção do Alarme

Al_Type Integer

1: HiHi

2: Hi(On)

4: Lo(Off)

8: LoLo

16: Rate(Change)

32: Deviation+

64: Deviation-

Al_Ack_Req Boolean 0: Requisita reconhecimento (Ack)

1: Não requisita reconhecimento

Al_Norm_Time TimeStamp

Timestamp indicano quando o alarme foi normalizado.

Quando o Formato de Arquivo é Propriedade, o IWS salva a Data (MM/DD/YYYY) em um campo e a Hora (HH:MM:SS.MSS) no próximo campo.

Al_Ack_Time TimeStamp

Timestamp indicando quando o alarme foi reconhecido.

Quando o Formato de Arquivo é Propriedade, o IWS salva a Data (MM/DD/YYYY) em um campo e a Hora (HH:MM:SS.MSS) no próximo campo.

Al_User String Usuáio logado quando o evento de alarme ocorreu. Esse campo existe somente para Versão >=1

Al_Comment String Comentário (opcional) digitado pelo operador quando o alarme foi reconhecido. Esse campo existe somente para Versão >=1

Al_User_Full String Nome complete do usuário logado quando o evento de alarme ocorreu. Esse campo existe somente para Versão >=2

Al_Station String Nome da estação (computador) onde o evento de alarme ocorreu. Esse campo existe somente para Versão >=2

Al_Previous_Tag_Value Real Valor do Tag ocorrido antes do evento de alarme. Esse campo existe somente para Versão >=3

Al_Deleted Boolean

0: Mensagem de alarme não foi deletada

1: Mensagem de alarme foi deletada

Esse campo é criado somente quando o Formato de Arquivo é Database.

Al_Bias Integer Diferença (em minutos) das colunas Time Stamp e tempo GMT. Esse campo existe somente para Versão >=3


InduSoft Web Studio

Página 471

Al_Last_Update TimeStamp

Time Stamp quando o registro foi criado/modificado. Esse campo é utilizado para sincronizar os bancos de dados ao utilizar o Banco de Dados Secundário além do Banco de Dados Primário. Esse campo é criado somente quando File Format é Database.

Dica:

Ao salvar Alarmes Históricos (History Alarms) em um Banco de Dados SQL Relacional (File Format = Database), pode-se costumizar o nome das colunas criadas em um banco de dados, editando o arquivo <AplicaçãoName>.APP como se segue:

[Alarm]


Por exemplo:

[Alarm]

Message=Alarm_Message

Ack=Acknowledgment

IWS Development Environment The Workspace Database Tab Event Settings

Arquivos de log de Evento são salvos ao banco de dados histórico, de acordo com o File Format configurado para Alarm History e Events. As informações salvas no arquivo histórico estão descritas na tabela a seguir.

Nome do Campo

Tipo de Dados

Marcas

Version Integer É criado somente quando o File Format é Proprietary. Versão atual: 002

Event_Type Integer

1: SECURITY SYSTEM

2: DISPLAY

3: RECIPE

4: REPORT

5: CUSTOM MESSAGES

6: SYSTEM WARNING

7: LOG TAGS

Event_Time TimeStamp

Timestamp indicando que o evento ocorreu.

Quando File Format é Proprietary, o IWS salva Event Time no seguinte formato: MM/DD/YYYY HH:MM:SS.MSS.

Event_Info String Nome do Tag

Value Real Valor do Tag quando o evento ocorreu

Source String Nome da tarefa que gerou o evento

User String Usuário logado quando o evento ocorreu.


InduSoft Web Studio

Página 472

User_Full String Nome complete do usuário logado quando o evento ocorreu.

Message String Mensagem do evento

Station String Nome da estação (computador) onde o evento ocorreu.

Comment String Comentário (opcional) digitado pelo operador quando ocorreu o evento. Esse campo existe somente para Versão >=2

Previous_Value Real Valor do Tag que ocorreu antes do evento. Esse campo existe somente para Versão >=2

Deleted Boolean

0: Mensagem de evento não foi deletada

1: Mensagem de evento foi deletada

Esse campo é criado somente quando File Format é Database.

Bias Integer Diferença (em minutos) das colunas Time Stamp e hora GMT. Esse campo existe somente para Versão >=2


Time Stamp quando o registro foi criado/modificado. Esse campo é utilizado para sincronizar os bancos de dados ao utilizar oe Banco de Dados Secundário além do Banco de Dados Primário. Esse campo é criado somente quando File Format é Database.

Dica:

Ao salvar Events em um Banco de Dados SQL Relacional (File Format = Database) pode-se costumizar o nome das colunas criadas no banco de dados, editando o arquivo <AplicaçãoName>.APP como se segue:

[EventLogger]


Por exemplo:

[EventLogger]

Event_Info=Information

Message=Event_Message


InduSoft Web Studio

Página 473

IWS Development Environment The Workspace Tasks Tab Trend Folder

painel Name of history files: Especifica os seguintes parâmetros para definir o nome do arquivo histórico . Pode-se gerar arquivos históricos de trend de duas formas: Por data ou batch (por eventos).

– check box Date (default): Clique (habilite) para gerar arquivos históricos baseados em data. Utilize essa opção caso você tenha um processo contínuo. Dependendo das opções selecionadas no combo-box History Format, o IWS salva os dados históricos Trend em arquivos binários de propriedade ou em um Banco de Dados SQL Relacional. Os campos salvos no Histórico Trend são descritos na tebela a seguir:

Field Name Data Type Remarks

Time_Stamp TimeStamp TimeStamp (Data e Hora) quando os dados foram salvos.

<Tag Name> Integer ou Real (dependendo do tipo de tag)

O IWS will criará um campo (coluna) no banco de dados para cada tag configurado na planilha Trend.


InduSoft Web Studio

Página 474

Resolvendo Problemas do Banco de Dados A interface Database do IWS fornece ferramentas ponderosa que auxiliará na identificação dos problemas de configuração com bancos de dados. Casso você esteja tendo problemas na interface com um banco de dados, deve-se primeiro habilitar as Mensagens do Banco de Dados na janela Log. Você também poderá seguir os passos a seguir:

1. No ambiente de desenvolvimento do IWS, certifique-se de que a janela Output (View-> Toolbars-> Output) esteja habilitada.

2. Clique com o botão direito na janela (localizada geralmente no canto direito do ambiente de desenvolvimento), e selecione Settings;

3. Na janela Settings Log Settings habilite a opção Database Messages;

Após habilitar Database Messages, aparecerá a janela Output relacionada a mensagens de erro do banco de dados. A seção Database FAQ que se segue lista alguns dos erros comuns que você verá na janela Output.

Database FAQ

questões gerais

Q: Eu configurei meu banco de dados, mas os módulos Run-Time (Alarm, Trend e Events) não Estão sendo salvos para o banco de dados. Eu vejo somente a seguinte mensagem de erro na janela Output:

Database: Error: Error to add new register[CMD_ADD].

O que devo fazer?

A: A maioria dos erros no banco de dados na janela Output serão seguidos por iformações adicionais, como o comando SQL sendo executado, a Connection String e o Nome da Tabela. Mensagens de erro como as descritas acima, geralmente acontecerão após uma mensagem mais detalhada. Por exemplo, caso sua tarefa Trend falhe para adicionar um registro no banco de


InduSoft Web Studio

Página 475

dados, por um cabo está desconectado, deve-se primeiramente esperar o recebimento de um erro na rede de trabalho; caso a tarefa tente adicionar mais registros antes do período especificado no campo Retry (veja “Diálogo Janela do Diálogo Database Configuration”), será exibido somente Database: Error: Error to add new register[CMD_ADD]. Caso você ache que sua configuração está correta e queira corrigir o problema, reduza Retry. Após ter efetuado tal tarefa, você poderá ver informações mais detalhadas.

Q: Eu configurei minha Connection String utilizando o browser e a janela Data Link Properties. Ao clicar no botão Test, aparecerá “Test succeeded”. Porém, ao rodar minha aplicação, a Database Interface exibe mensagens de erro, e eu não consigo salvar dados.

A: A janela Data Link Properties utiliza OLE DB para fazer interface com o Banco de Dados. O Banco de Dados do IWS utiliza ADO.NET; portanto, pode-se ter o provedor OLE DB em sua máquina e perder o provedor ADO.NET. Isso também é possível quando um provedor ADO.NET sendo utilizado e que não esteja listado no arquivo StADOSvr.ini. Leia “Studio Database Gateway” para maiores informações sobre como adicionar os provedores ADO.NET para o arquivo StADOSvr.ini.

Q: Por que, ao atualizar informações em uma linha no objeto Grid, mais de uma linha estarão sendo atualizadas em meu banco de dados?

A: O objeto grid promove um comando de atualização no banco de dados utilizando os valores de todas as colunas para a linha específica a qual você está tentando atualizar. Caso você tenha linhas com valores duplicados, você deverá checar esse problema. Caso sua tabela tenha uma chave primária ou qualquer outro campo único que você não queira exibir no objeto Grid, pode-se adicioná-lo a Columns, mas com Width especificado para 0. Tal procedimento corrigirá o problema.

Q: Por que eu preciso utilizar uma Column separada para armazenar os milissegundos em meu banco de dados?

A: Alguns bancos de dados não suportam milissegundos no campo Time Stamp. A interface Database do IWS, por padrão, requisite outra coluna para o smilissegundos. Caso seu banco de dados possa manusear milissegundos, ou caso você não deseje gravar os milissegundos, é possível alterar o comportamento padrão em Advanced settings. Note que alguns bancos de dados são capazes de armazenar milissegundos, embora possuam baixa precisão. Caso você misture bancos de dados diferentes, com diferentes precisões em um modo redundante, você poderá ter problemas de sincronização.

Q: Minha aplicação funciona bem quando eu rodo em um módulo emulation. Mas ao enviar para o equipamento Windows CE, não é possível estabelecer comunicação com meu banco de dados.

A: Pode ser o caso em que seu equipamento Windows CE não tenha o .Net Framework ou não tenha o provedor que você esteja utilizando. Tente utilizar o gateway remotamente seguindo as instruções de “Estabelecendo Link do Banco de Dados através de um Provedor Estabelecendo Link do Banco de Dados através de um DB ProviderRemoto.”

Q: Por que eu estou recebendo a mensagem Error para criar uma classe de conexão ao tentar criar classe de conexão quando tento conectar ao banco de dados?

A: O .Net Provider que você está tentando utilizar não está instalado em sua máquina. Essa mensagem de erro é geralmente seguida pelo nome do provedor; Caso você esteja utilizando o banco de dados Sybase, por exemplo, a mensagem é seguida por [iAnywhere.Data.AsaClient.AsaConnection]. O Provedor é iAnywhere.Data.AsaClient. Você pode verificar se o provedor está instalado em sua máquina. Vá para Control Panel->Administrative Tools->Microsoft .Net Framework x.x Configuration. O provedor deverá ser listado em Assembly Cache.


InduSoft Web Studio

Página 476

Q: E se eu tiver assembly do provedor (geralmente um arquivo .dll), mas não esteja listado no Assembly Cache?

A: Caso seu assembly tenha um nome satisfatório, pode-se registrá-lo em Assembly Cache utilizando o programa gcautil, e deverá funcionar caso você copie seu assembly para a mesma pasta de StADOSvr.exe (geralmente a pasta \Bin do IWS).

ORACLE

Q: Quando eu perco a conexão com um banco de dados ORACLE, esse não se recupera. Eu recebo a seguinte mensagem no logwin: Database: Error: ORA-03114: not connected to ORACLE. Existe algum problema com a Interface do Banco de Dados do IWS?

A: O Provedor Oracle .Net possui um problema no gerenciamento no pool de conexão. Você necessitará da instalação de um QFE 830173. Mais informações sobre esse problema podem ser encontradas em http://support.microsoft.com/default.aspx?scid=kb;en-us;830173.

Q: Ao tentar acessar o banco de dados, eu recebo a seguinte mensagem de erro: ORA-00162: external dbid length 19 is greater than maximum (16). O que eu devo fazer?

A: Na época em que essa documentação foi escrita, houve um problema em um Provedor Oracle .NET; o Server Name (SERVER/TNS) não deveria ultrapassar 16 caracteres. De modo a reparar esse problema, deve-se tentar reduzir seu campo Server Name. Uma maneira de faze-lo é editando o arquivo \WINDOWS\system32\drivers\etc\hosts para adicionar uma entrada com um server name menor. Por exemplo, o server name especificado por 192.168.89.98, possui 13 caracteres e deve ser reduzido para 3 adicionando-se a seguinte linha no arquivo:

192.168.89.98

Agora você poderá configurar os parâmetros do Server Name utilizando ORA/TNS ao invés de 192.168.89.98/TNS.

MySQL

Q: Tentar acessar o banco de dados a partir de minha máquina local funciona de forma correta. Mas quando eu movo minha aplicação para uma máquina remota, aparece: Access Denied.

A: Cada usuário em um banco de dados MySQL possui uma propriedade associada a ele que indica o computador a partir do qual você pode obter acesso ao banco de dados. Por padrão, essa propriedade é configurada para localhost. Assim, você será capaz de acessar somente o banco de dados a partir de um computador local. Você deverá ler o manual MySQL para maiores informações sobre alterações dessas configurações.

Sybase

Q: Eu configurei meu banco de dados Sybase utilizando o botão do Browse. Ao clicar no botão de teste, o teste é efetuado, mas quando eu tento rodar minha aplicação, eu recebo o seguinte erro: Database: Error: Parse error: DSN 'MyDatabase' does not exist. O que estou fazendo de errado?

A: Leia o Apêndice F – Utilizando Sybase para maiores informações sobre esse problema.

Q: Por que, ao tentar conectar-se ao banco de dados Sybase, eu recebo o erro Error to create connection class [iAnywhere.Data.AsaClient.AsaConnection]?

A: Você não possui o Provedor ADO.NET instalado em seu computador. O programa de configuração do banco de dados tem uma opção para instalação do Provedor. Rode novamente o programa de configuração e certifique-se de que você verificou que aquela opção esteja habilitada.


InduSoft Web Studio

Página 477

SQL Server CE

Q: Por que o gateway exibe TypeLoad failure (falha) ao tentar acessar meu banco de dados SQL Server CE?

A: Esse problema geralmente acontece quando você não possui o Provedor SQL Server CE .NET instalado em seu equipamento CE.

Q: Por que eu estou recebendo a mensagem de erro: There is a file sharing violation. A different process might be using the file?

A: Você possui um outro programa com o banco de dados SQL Server CE aberto. Por exemplo, isso acontecerá caso você esteja utilizando o software de configuração SQL Server CE.


InduSoft Web Studio

Página 478

Apêndice do Banco de Dados A: Utilizando Banco de Dados ODBC

Quase todos os fornecedores de banco de dados fornecem uma interface ODBC que pode ser utilizada para fazer interfaces. Os recursos do banco de dados fornecidos pelo IWS podem ser utilizados com drivers ODBC através da interface ADO.NET para ODBC. De modo a utilizar essa capacidade, deve-se utilizar Microsoft .NET Framework 1.1 ou versões mais recentes.

Nota: Microsoft .NET Framework 1.1 está instalado automaticamente, iniciando com o IWS v.6 Service Pack 3.

O Diálogo Database Configuration permite o fornecimento de strings de conexão que estabelecerão conexão com um ODBC DSN. O string de conexão pode ser construído automaticamente clicando-se no botão do Browse (…). Quando aparecer a janela Data Link, você deverá selecionar a opção Microsoft OLE DB Provider for ODBC Drivers como mostrado abaixo:

Clicar no botão Next fará aparecer a seguinte janela:


InduSoft Web Studio

Página 479

Selecione o DSN ao qual você deseja conectar-se e clique em OK. Caso você deseje especificar o nome do usuário e a senha nessa janela, ao invés de espcificar no diálogo Database Configuration, lembre-se de habilitar o checkbox Allow saving password.

Apêndice do Banco de Dados B: Utilizando Microsoft SQL Server A interface do Banco de Dados do IWS permite a entrega e armazenamento de informações em banco de dados Microsoft SQL Server relacionais. Você deverá seguir os passos abaixo para configurar o banco de dados SQL Server:

1. Clique no botão Browse na janela Database Configuration Dialog. A janela a seguir será exibida:


InduSoft Web Studio

Página 480

2. Selecione o Provedor Microsoft OLE para SQL Server, e clique em Next. A seguinte janela será exibida:


InduSoft Web Studio

Página 481

3. Preencha os campos nessa janela com as informações de seu banco de dados. Caso você não esteja utilizando Windows NT Integrated security, lembre-se de habilitar o checkbox Allow saving password para salvar a senha quando a janela Data Link Properties estiver fechada.

4. Clique em OK para finalizar a configuração Connection String.

Seu string de conexão deverá ser muito similar ao que se segue:

Provider=SQLOLEDB.1; Integrated Security=SSPI; Initial Catalog=MyDatabase; Data Source=192.168.23.200

Nota: Esses procedimentos foram testados utilizando o Microsoft SQL Server 2000.

Apêndice do Banco de Dados C: Utilizando Banco de Dados ORACLE

A Interface do Banco de Dados do IWS permite a entrega e armazenamento de informações em banco de dados relacionais ORACLE. Você deverá seguir os passos abaixo para configurar o banco de dados ORACLE:

1. Clique no botão Browse na janela Database Configuration Dialog. A seguinte janela aparecerá:

2. Selecione o Provedor Microsoft OLE para Oracle e clique em Next. A seguinte janela aparecerá:


InduSoft Web Studio

Página 482

3. Preencha os campos nessa janela com as informações de seu banco de dados. Lembre-se de habilitar o checkbox Allow saving password para que a senha seja salva quando a janela Data Link Properties for fechada. As informações do nome do servidor possui o formato a seguir:

<Server>/<TNS>

Onde: • Server: Computador onde o banco de dados Oracle está rodando • TNS: Nome TNS Oracle

Atenção: Na época em que essa documentação foi redigida, o campo Server Name não podia ser configurado com mais de 16 letras. Caso mais de 16 fossem especificadas, você receberia o seguinte erro: ORA-00162: external dbid length 19 is greater than maximum (16), onde 19 é o número de letras em Server Name. Leia “Resolvendo Problemas do Banco de Dados” para maiores soluções para contornar esse problema.

4. Clique em OK para finalizar a configuração Connection String.

Nota: Tais procedimentos foram testados utilizando-se ORACLE 10g Release 1.


InduSoft Web Studio

Página 483

Apêndice do Banco de Dados D: Utilizando Banco de Dados de Acesso da Microsoft

A interface do Banco de Dados do IWS permite a entrega e armazenamento de informações em arquivos Microsoft Access Database. Você deverá seguir os passos abaixo de modo a configurar um banco de dados de acesso:

1. Clique no botão Browse na janela Database Configuration Dialog. A janela a seguir aparecerá:

2. Selecione o Provedor Microsoft Jet 4.0 OLE DB e clique em Next. A seguinte janela aparecerá:


InduSoft Web Studio

Página 484

3. Digite o nome ou selecione o banco de dados que você deseja acessar.

Atenção: Bancos de dados como Microsoft Access não são capazes de manusear grandes quantidades de dados de forma eficiente. Portanto, caso você tente armazenar todos seus dados históricos nesse tipo de banco de dados, a tarefa poderá funcionar de forma muito lenta, e você poderá não obter os resultados esperados. Caso você necessite armazenar uma grande quantidade de dados, recomendamos a utilização de formato de prioridade ou um banco de dados relacional potente, como Microsoft SQL Server ou ORACLE. Microsoft Access é recomendado como sendo um Banco de Dados Secundário, utilizando-se da opção Store and Forward, ou para trocar informações com software de terceiros.

Nota: Tais procedimentos foram testados utilizando-se do Microsoft Access 2000 (9.0.3821).

Apêndice do Banco de Dados E: Utilizando SQL Server CE

O IWS pode estabelecer interface com bancos de dados SQL Server CE utilizando o provedor SQL Server CE, o qual está disponível somente para Windows CE, e deverá ser instalado em seu equipamento Windows CE. Por esse provedor estar disponível somente para Windows CE, você deverá inserir o Connection String manualmente. Connection String deverá possuir o seguinte formato:

Provider=SQLCE; Data Source = <Database Path>


InduSoft Web Studio

Página 485

Exemplos:

1. Acessar um arquivo de banco de dados estável localizado em \Harddisk\MyDatabase.sdf:

Provider=SQLCE; Data Source = \Harddisk\MyDatabase.sdf

2. Acessar um arquivo de banco de dados no local indicado pelo tag string DatabaseFile:

Provider=SQLCE; Data Source = {DatabaseFile}

Atenção: Bancos de Dados como SQL Server CE não são capazes de manusear grandes quantidades de dados de forma eficiente. Portanto, caso você tente armazenar todos seus dados históricos nesse tipo de banco de dados, a tarefa poderá funcionar de forma muito lenta, e você poderá não obter os resultados esperados. Caso você necessite armazenar grandes quantidades de dados, recomendamos a utilização de formato de propriedade ou um banco de dados relacional potente, como Microsoft SQL Server ou ORACLE. SQL Server CE é recomendado como um Banco de Dados Secundário e a utilização da opção Store and Forward é recomendada para trocar informações com softwares de terceiros.

Apêndice do Banco de Dados F: Utilizando Sybase

Será necessário instalar o provedor AsaClient em seu computador; os testes com o IWS foram executados com a utilização da Arquitetura explicada no tópico “ Estabelecendo Link de Banco de Dados através de um Remote DB Provider”.

Caso você esteja utilizando o botão do browse para gerar o string Connection automaticamente, o string a ser retornado terá o seguinte formato:

Provider=ASAProv.90; Data Source=Test

Esse formato exige a criação de um ODBC DSN com o mesmo nome de Data Source (Test, nesse caso) de modo a comunicar-se com o banco de dados. Caso DSN não seja criado, o seguinte erro será exibido em LogWin ao conectar-se ao banco de dados:

Database: Error: Parse error: DSN 'Test' does not exist

Para evitar ODBC DSN, pode-se inserir o string Connection manualmente, como mostrado no exemplo que se segue:

Provider=ASAProv.90; DBF=C:\ Test.db

Note: Tais procedimentos foram testados com a utilização de Sybase Server Anywhere 9.0.1.1751.

Apêndice do Banco de Dados G: Utilizando Microsoft Excel

A interface Database do IWS permite a entrega e armazenamento de informações em arquivos Excel. O principal objetivo do uso de banco de dados em Excel é em virtude do objeto Grid. Os passos abaixo mostram como configurar o objeto Grid para a entrega de dados a partir de um arquivo em Excel:

1. Insira um objeto Grid na tela;

2. Selecione Database no campo Data Source.


InduSoft Web Studio

Página 486

3. Clique no botão Data. A seguinte janela aparecerá:

4. Desabilite o check box Use Aplication default.

5. Clique o botão Browse para construir o String Connection. A seguinte janela aparecerá:

6. Selecione Microsoft Jet 5.0 OLE DB Provider, e clique em Next. A seguinte janela aparecerá:


InduSoft Web Studio

Página 487

7. Clique no botão Browse. A seguinte janela aparecerá:

8. Selecione seu arquivo em Excel e clique em Open.

9. Selecione o tab All na janela Data Link Properties.

10. Em Extended Properties, insira o valor Excel 8.0.


InduSoft Web Studio

Página 488

Nota: O valor nesse campo deverá ser alterado caso seja utilizada uma versão distinta do Excel.

11. Clique em OK, e você terá um string connection muito similar ao que se segue:

Provider=Microsoft.Jet.OLEDB.4.0; Data Source=C:\Book1.xls; Extended Properties="Excel 8.0"

Dica: Pode-se inserir um tag entre colchetes para especificar o arquivo em Excel que você deseja acessar. No exemplo abaixo, o tag TagExcelFile é utilizado para indicar o arquivo em Excel:

Provider=Microsoft.Jet.OLEDB.4.0; Data Source=C:\{TagExcelFile}.xls; Extended Properties="Excel 8.0"

12. Especifque a planilha que você deseja acessar no campo Table. O nome da planilha deverá possuir o sinal ($) em seu final, e deverá estar entre ([]). A figura abaixo mostra a configuração para acesso a planilhas chamadas Sheet1:


InduSoft Web Studio

Página 489

Dica: Pode-se inserir um tag entre colchetes para especificar o nome de uma planilha (e.x. [{TagExcelWorksheet}$])

Nota: Tais procedimentos foram desenvolvidos baseados em informações fornecidas por Microsoft Knowledge Base Article 278973, e foram testados com a utilização do Microsoft Excel 2000 (9.0.3821).

Apêndice do Banco de Dados H: Utilizando MySQL

A interface Database do IWS pode ser utilizada com banco de dados MySQL; porém, você deverá instalar o .Net provider para obter seu acesso. O provedor requisitado pelo IWS é ByteFX.MySqlClient. Na época em que esse documento foi redigido, este poderia ser adquirido a partir do site www.sourceforge.net.

O string connection deverá possuir o seguinte formato:

Provider=MySqlProv; Data Source=MyDatabaseName; Location=192.168.23.200

Nota: Caso você tenha o OLE DB Provider para MySQL instalado em seu computador, pode-se utilizar o botão do browse na janela Database Configuration Dialog para construção do string connection.


InduSoft Web Studio

Página 490

A conexão ByteFX.MySqlClient utiliza diferentes palavras-chave para Data Source e para os parâmetros Location no string de conexão. O exemplo acima é passado para a classe de conexão no seguinte formato:

Database=MyDatabaseName; Data Source=192.168.23.200

Nota: Tais procedimentos foram testados com a utilização de MySQL v4.0.20a e ByteFX.MySqlClient v0.76.


InduSoft Web Studio

Página 491

Capítulo 18: Web Solution O IWS permite a criação de telas que podem ser visualizadas em uma estação remota com a utilização de um browser regular web (ex. Internet Explorer). A estação onde o usuário poderá visualizar a interface gráfica (telas) no browser da web é chamada Web Thin Client.

Studio Runtime+

Application

Server Station

TCP/IP

(Ethernet, Internet, Dial-UP)

Web Thin Client

Web Browser

O IWS está instalado somente na estação servidor. Também, a aplicação (arquivos de telas, banco de dados de tags, planilhas de configuração, etc) é armazenada somente no servidor, ou seja, você não precisará instalar o IWS ou a aplicação em Web Thin Client station(s). Essa solução promove um alto nível de flexibilidade, pois quaisquer computadores com um link fisicamente estabecido a server station (link TCP/IP) pode obter acesso a telas gráficas e dados históricos/online a partir do server, sem a necessidade de instalação do IWS ou da aplicação em Web Thin Client station(s). Qualquer computador ou equipamento (ex. PDAs potencializados com Windows CE) rodando Internet Explorer web browser v6.0 (ou versões mais atuais) podem ser um Web Thin Client para uma aplicação do IWS. Além disso, o IWS fornece um Sistema de Segurança (Security System) sofisticado para a proibição do acesso de usuários não autorizados à aplicação.

Nota: O número máximo de Web Thin Client stations conectadas simultaneamente ao servidor depende das configurações da licença instalada no servidor. O usuário não precisa instalar qualquer licença em Web Thin Client stations.

A partir da Web Thin Client station, você poderá não somente visualizar dados do servidor como também alterar set points e/ou enviar comandos para o servidor. Ao configurar a aplicação, você poderá desabilitar (opcional) todos os comandos do Web Thin Client para a estação do servidor. Nesse caso, as Web Thin Client stations poderão ler os dados, mas não poderão enviá-los para o servidor.

• Todas as tarefas de fundo (Math, Scheduler, etc) e tarefas de comunicação (Driver, OPC, DDE, etc) são executadas somente na server station. O Web Thin Client é capaz de carregar interfaces gráficas configuradas no servidor (telas com objetos e dinâmicos) e exibir os valores online a partir dos tags configurados no servidor, assim como os dados históricos (Alarm, Events e dados históricos Trend).


InduSoft Web Studio

Página 492

Camada de Controle ISSymbol ISSymbol é um componente projetado pela InduSoft que capacita a exibição de telas criadas com o o IWS no browser da web, além de trocar dados (valores de tags e dados históricos) com o módulo TCP/IP server do IWS. Na Web Thin Client station, o browser da web (ex. Internet Explorer) é o local que acolhe o controle ISSymbol.

ISSymbol funciona como uma camada de controle entre a aplicação do IWS e o browser da web – equivalente ao Java Virtual Machine para aplicações baseadas em Java. Essa proximidade fornece um alto nível de segurança, pois o ISSymbol não permite a aplicação para acesso direto ao sistema operacional.

Quando o browser da web faz o download da página HTML especificada pelo usuário, esse verifica o registro do controle ISSymbol no computador atualmente utilizado. Caso ele não encontre, o browser tentará efetuar o download do registro a partir da URL especificada no diálogo Project Settings Web Advanced. O browser da web não é capaz de exibir telas a partir da aplicação do IWS, caso o controle ISSymbol não esteja registrado de forma apropriada na Web Thin Client station.

Atenção: Certifique-se de que seu browser da web esteja habilitado a efetuar download preenchidos nos controles ActiveX, de modo a efetuar o download do ISSymbol automaticamente. Caso contrário, você precisará registrar o ISSymbol manualmente na Web Thin Client station. Verifique a documentação de seu browser da web a respeito de perguntas sobre configurações de segurança para estabelecer parâmetros dessas configurações.

Instalando o controle issymbol manualmente

Também pode-se instalar o controle ISSymbol manualmente na Web Thin Client station. O para instalação do ISSymbol em cada sistema operacional está descrito abaixo:

• Windows NT/2K/XP:

Copie os arquivos ISSymbolReg.exe e ISSymbol.cab da subpasta \BIN do Indusoft Web Studio v6.1 e cole-os em qualquer diretório da Web Thin Client station. Certifique-se de que ambos os arquivos estejam armazenados em um mesmo diretório.

Rode ISSymbolReg.exe para registrar o controle ISSymbol na Web Thin Client station.

• Windows 9x/ME:

Copie os arquivos ISSymbolReg.exe e ISSymbolA.cab da subpasta \BIN do Indusoft Web Studio v6.1 e cole-os em qualquer diretório da Web Thin Client station. Certifique-se de que ambos os arquivos estejam armazenados em um mesmo diretório.

Rode ISSymbolReg.exe para registrar o controle ISSymbol na Web Thin Client station.

Atenção: Windows 9x/ME não suporta caracteres UNICODE. Portanto, as fontes UNICODE não serão exibidas de forma apropriada em Web Thin Clients Rodando sob Windows 9x/ME.

• Windows CE:

Copie os arquivos ISSymbolCE.ocx e IndHTTP.dll da subpasta \Redist\<OS Version>\<Processor Type>\ do Indusoft Web Studio v6.1, e cole-os em qualquer diretório da Web Thin Client station.

Execute o comando a seguir da janela Prompt: regsvrce.exe “\<ISSymbolPath>\ISSymbolCE.ocx” (ex. regsvrce.exe “\Storage Card\ISSymbolCE.ocx”)


InduSoft Web Studio

Página 493

Salve as configurações de registro para manter ISSymbolCE.ocx registrados ao reiniciar o equipamento Windows CE.

• Windows CE PocketPC:

Copie os arquivos RegSvrCE.exe, ISSymbolCE.ocx e ndHTTP.dll da subpasta \Redist\<OS Version>\<Processor Type>\ do Indusoft Web Studio v6.1 e cole-os em qualquer diretório da Web Thin Client station. Certifique-se de que ambos os arquivos estejam armazenados no mesmo diretório.

Execute o programa RegSvrCE.exe no equipamento Web Thin Client. Para registrar ISSymbolCE.ocx, faça o seguinte:

• Selecione o arquivo \<ISSymbolPath>\ISSymbolCE.ocx

• Selecione a opção Register

• Clique no botão OK

Nota: Internet Explorer não é capaz de fazer download de controles ActiveX automaticamente a partir do Windows CE e Windows CE PocketPC. Portanto, antes de utilizar os equipamentos como Web Thin Clients, deve-se registrar o controle ISSymbolCE.ocx manualmente.

Como Funciona Após abrir o browser da web, deve-se digitar a URL para uma página da web disponível na Web Server station (ex. http://127.0.0.1/main.html) no campo Address. Nesse ponto, a Web Thin Client executa o seguinte processo:

1. O browser da web faz downloads da página HTML da tela especificada.

2. O browser da web verifica o registro do controle ISSymbol no computador local. Caso ele não encontrá-lo, o browser tentará fazer o download do componente ISSymbol da URL configurada na aplicação (configurações alvas na página HTML). Desde que o controle ISSymbol esteja propriamente registrado na Web Thin Client station, o browser da web será capaz de carregá-lo.

A partir desse ponto, o ISSymbol inicia a comunicação com a server station, e o browser da web será utilizado somente como um hospedeiro para ISSymbol.

3. ISSymbol conecta-se ao servidor de dados. Configura-se o endereço IP do servidor de dados com a janela de diálogo Project Settings Web. Essa configuração é salva na página HTML.

4. ISSymbol induz uma janela na Web Thin Client, pedindo o User Name e Password. Os dados inseridos estão encriptados e enviados para o servidor. A server station verifica a validade dos dados e os direitos para abrir a tela de startup. Caso seja possível, o processo continuará. Caso contrário, você será questionado com uma mensagem de erro indicando que User Name e/ou Password são inválidos. Nesse caso, o processo não continuará.

Nota: Passo 4 poderá ser pasado caso o sistema de segurança esteja desabilitado durante a configuração da aplicação.

5. ISSYmbol faz o download de arquivos necessários para a exibição de telas especificadas pelo

usuário (arquivos de telas, banco de dados de tags, arquivos de tradução, etc).

6. ISSymbol conecta-se ao banco de dados e lê valores dos tags que são exibidos na tela especificada.

7. ISSymbol exibe a tela no browser da web e mantém a atualização de objetos de acordo com valores lidos a partir do servidor. Sempre que o valor de qualquer tag for exibido com alteração nas telas abertas no servidor, o novo valor é enviado para a Web Thin Client (e vice-versa).


InduSoft Web Studio

Página 494

Portanto, não há pooling entre Web Thin Client e server station. Esse método aumenta a performance da comunicação e otimiza o tráfico de dados na rede de trabalho.

Note que existem dois servidores nesse processo:

• Web server (HTTP Server): Fornece os arquivos do server para Web Thin Client via protocolo HTTP através de TCP/IP.

• Data server (Módulo Server TCP/IP do IWS): Fornece valores de tags e/ou dados históricos da aplicação rodando no server para computador(es) Web Thin Client.

Embora ambos os servidores estejam geralmente rodando em um mesmo computador, o IWS fornece a flexibilidade para rodar cada servidor em uma estação diferente quando necessário. Veja Arquiteturas Típicas na Aplicação Baseada em Web para maiores informações.

Configurando uma Aplicação Baseada na Web Os passos principais para configurar uma aplicação baseada na web com o IWS são descritos abaixo:

1. Configure the web server: O servidor da web é um driver HTTP server capaz de fornecer arquivos para estações remotas via protocolo HTTP por sobre TCP/IP. O IWS suporta qualquer web server; porém, caso sua arquitetura necessite do Web Gateway projetado pela Indusoft, o servidor da web deverá ser IIS (Internet Information Services) da Microsoft.

Está rodando e preenchendo um diretório próprio (web root). Geralmente, o diretório home deve ser configurado com o caminho para a subpasta \Web da aplicação. Consulte sua documentação do servidor da web para maiores informações sobre sua configuração.

Notas: A InduSoft fornece um servidor da web para Windows NT/2K/XP (NTWebServer.exe), armazenado na subpasta \BIN do IWS após a instalação. Mais do que isso, a InduSoft fornece um servidor da web para Windows CE (CEWebServer.exe) que está armazenado na subpasta \Redist\<WinCE version>\<Processor Type> do IWS após a instalação. O diretório home (web root) para os servidores da web fornecidos pela InduSoft é o mesmo de onde eles são executados. Portanto, a InduSoft recomenda a efetuação de cópias desses para a subpasta \Web de sua aplicação antes de rodá-los.

NTWebServer e CEWebServer foram projetados primariamente para estes simples e/ou demos. A InduSoft recomenda a utilização de Web Servers comerciais de terceiros, como IIS (Internet Information Services) da Microsoft ou Apache (para Linux) em aplicações de tempo real.

2. Configure os parâmetros da Wwe na aplicação do IWS: Os parâmetros da web para aplicação do

IWS são configurados na janela de diálogo Project Settings Web.

3. Salve as tela como HTML: As telas que devem estar disponíveis para Web Thin Client stations devem estar salvas como HTML. Para isso, abra a tela no ambiente de desenvolvimento e execute o comando File Save as HTML a partir do menu. Utilize a opção do menu File Save Screen Group as HTML para salvar grupos de tela (*.sg) como HTML e torná-las disponíveis para Web Thin Clients. Após salvar qualquer tela como HTML, os arquivos da web para essa tela são automaticamente atualizados sempre que salvos novamente (File Save).

Dica: Caso você deseje tornar todas as suas telas da aplicação disponíveis para Web Thin Client stations, execute File Save All como opção de menu HTML.


InduSoft Web Studio

Página 495

Atenção: Após alterar qualquer configuração na janela de diálogo Project Settings e/ou em Tags Database, deve-se executar o comando Tools Verify Application para atualizar arquivos da web com uma nova configuração.

4. Run the Application on the server: Certifique-se de que o módulo TCP/IP Server esteja rodando

no servidor de dados. O módulo TCP/IP Server está embutido no IWS, e é automaticamente executado sempre que você rodar qualquer aplicação em sistemas operacionais Windows CE. Para Windows NT/2K/XP, pode-se configurar o módulo TCP/IP Server para ser executado automaticamente quando a aplicação for iniciada, utilizando o diálogo Project Status Execution Tasks. O módulo TCP/IP Server é o servidor de dados para estações Web Thin Client remota(s).

5. Dependendo de sua Arquitetura, você precisará rodar o Web Gateway projetado pela Indusoft na estação web server.

Arquiteturas Típicas Essa seção descreve arquiteturas típicas aplicadas para soluções baseadas na web e fornece exemplos de como configurar a aplicação do IWS para cada arquitetura.

As definições de alguns dos termos utilizados nessa seção estão descritas abaixo:

• Web server: Software que implementa o protocolo (server) HTTP através de TCP/IP; ex. web server do IIS da Microsoft.

• Server station: Computador ou equipamento que está rodando o IWS e um web server. A aplicação do IWS deve estar armazenada nesse computador.

• Web server station: Computador ou equipamento que está rodando um web server. Os arquivos da subpasta \Web da aplicação devem estar armazenados nesse computador.

• Data server station: Computador ou equipamento que está rodando o IWS. A aplicação do IWS deve estar armazenada nesse computador.

Essa seção não descreve todas as arquiteturas possíveis, embora forneça os conceitos necessários para projetar e configurar diferentes cenários baseados nas arquiteturas básicas ilustradas abaixo.

Arquitetura 1: Web server e Web Thin Clients em uma mesma rede de trabalho

Server Station

TCP/IP


Web Thin Client

Studio Runtime + ApplicationData Server (TCP/IP Server)Web Server (HTTP Server)

Essa é a arquitetura mais comum, assim como a mais facilmente configurável. Nessa Arquitetura, tanto o web server (ex. IIS) quanto o módulo data server (TCP/IP server do IWS) estão rodando em um mesmo computador (server station). O Web Thin Client conecta-se ao web server na server station para efetuar o download do arquivo de tela HTML. A seguir, conecta-se ao data server para trocar dados com o IWS.

Desde que ambos (Web Thin Client e server station) estejam conectados a uma mesma rede de trabalho, o Web Thin Client poderá acessar a server station diretamente através de seu endereço IP (ou host name).

Exemplo de Configuração:

Esse exemplo é baseado nas seguintes premissas:

• Endereço IP da server station na rede de trabalho: 192.168.1.1

• Diretório Home do web server (server HTTP) na server station: subpasta \Web da aplicação


InduSoft Web Studio

Página 496

Deve-se digitar o endereço que se segue no browser da web remoto para acessar uma tela (ex. myscreen) a partir do server: http://192.168.1.1/myscreen.html

A interface Project Settings Web deve estar configurada como se segue:

Project Settings Web Interface

Nota: Essa Arquitetura é adotada quando server station e Web Thin Client(s) estão diretamente conectados a mesma rede de trabalho intranet ou via uma conexão dial-up. Caso o servidor esteja conectado a internet, deve-se estabelecer um endereço IP Fix ao servidor na internet, e a aplicação deverá estar rodando nesse computador. Consulte seu Provedor ISP para maiores informações sobre como obter um endereço Fix IP para seu computador servidor na internet.


InduSoft Web Studio

Página 497

Arquitetura 2: Web server e Web Thin Client sem uma mesma rede de trabalho; web server e data server em estações diferentes

Web Server Station

TCP/IP


Web Thin Client

Files from the \Web application sub-folder

Web Server (HTTP Server)

Data Server Station

Studio Runtime + ApplicationData Server (TCP/IP Server)

Essa Arquitetura é especialmente útil quando você deseja isolar o web server (HTTP server) a partir do data server (módulo TCP/IP server do IWS). As razões mais comuns para a adoção dessa arquitetura são:

• Permite a utilização de uma web server station padrão compartilhada por várias aplicações na companhia. Algumas companhias utilizam um computador como web server padrão para todas as aplicações baseadas na web. Por razões físicas ou de segurança, você poderá não querer rodar a aplicação verdadeira nesse computador (ex. Este encontra-se longe da sala de controle. Portanto, pode-se rodar o IWS e a aplicação em um outro computador (data server station) e apenas copiar os arquivos da web da aplicação (arquivos da subpasta \Web da Aplicação) para a web server station.

• Hospeda páginas da Web em sites da Web. Caso você deseje armazenar as páginas da web em um site da web (ex. www.mycompany.com), pode-se enviar apenas arquivos da web da aplicação (arquivos da subpasta \Web da Aplicação) para o site da web e utilizá-los como a web server station. A Aplicação (e o IWS) mantém-se rodando em outro computador fisicamente conectado a internet.

• Habilita a utilização de um web server baseado em Linux (ex. Apache). Não será necessário instalar o IWS na web server station; portanto, caso você deseje utilizar um web server para Linux, você poderá rodá-lo na web server station e rodar o IWS na data server station.

• Oculta o endereço IP (ou host name) da data server station de usuários na Web Thin Client station. Nessa Arquitetura, o usuário deverá digitar a URL da web server no browser da web (não o endereço IP da data server station). Tal tarefa pode ser adotada por questões de segurança.

Nota: Não é necessário que o IWS seja instalado na web server station. Os componentes a seguir devem estar disponíveis na web server station:

* Web server (ex. IIS da Microsoft)

* Arquivos da subpasta \Web da Aplicação


InduSoft Web Studio

Página 498

Dica: Quando você possui muitos data servers nas aplicações de seu projeto, essa arquitetura poderá ser utilizada para compartilhar o mesmo web server para todas as aplicações. Por exemplo, pode-se estabelecer um link entre web server e data servers através de um alternador, o que manterá o tráfego na rede de trabalho, o que manterá o tráfego em redes de trabalho em crescimento, enquanto Web Thin Clients estão efetuando download de arquivos da web server station.

Nessa Arquitetura, tanto web server (ex. IIS) quanto data server (módulo TCP/IP server do IWS) estão rodando em computadores diferentes. Web Thin Client conecta-se a web server station para efetuar download de arquivo de tela HTML. Em seguida, esse conecta-se a data server station para trocar dados com o IWS.

Desde que Web Thin Client, web server e data server stations estejam conectados a mesma rede de trabalho, o Web Thin Client poderá acessar as server stations diretamente, através de seus endereços IP (ou host names).



• Endereço IP da web server station na rede de trabalho: 192.168.1.1

• Endereço IP da data server station na rede de trabalho 192.168.1.2

• Diretório Home do web server (server HTTP) na server station: subpasta \Web da aplicação

Deve-se digitar o seguinte endereço no browser da web remoto para acessar uma tela (ex. myscreen) do server: http://192.168.1.1/myscreen.html

Deve-se configurar a interface Project Settings Web como se segue:

Interface Project Settings Web


InduSoft Web Studio

Página 499

Arquitetura 3: Servidores Redundantes e Web Thin Client stations na mesma rede de trabalho

Server Station #1

TCP/IP


Web Thin Client

Server Station #2



Essa Arquitetura é similar a Arquitetura 1, embora nessa arquitetura duas server stations com os mesmos arquivos rodem a mesma aplicação em redundância. O Web Thin Client conecta-se ao servidor especificado pelo usuário no campo address do browser da web. Caso esse servidor ficar indisponível por qualquer razão (ex. Queda de energia), o Web Thin Client alterna-se para outra estação servidora automaticamente.

Essa Arquitetura é recomendada quando há necessidade de alto nível de disponibilidade para estações Web Thin Client, ou seja, mesmo se a Server Station torne-se indisponível, as estações Web Thin Client serão capazes de obter dados a partir de outra Server Station.

Exemplo de Configuração: Esse exemplo é baseado nas seguintes premissas:

• Endereço IP da server station #1 na rede de trabalho: 192.168.1.1

• Endereço IP da server station #2 na rede de trabalho: 192.168.1.2

• Diretório Home do web server (HTTP server) na server station #1: subpasta \Web da aplicação, armazenada na server station #1.

• Diretório Home do web server (HTTP server) na server station #2: subpasta \Web da aplicação, armazenada na server station #2.

O usuário deverá digitar o endereço a seguir no browser da web remoto para acessar uma tela (ex. myscreen) da server station #1: http://192.168.1.1/myscreen.html

O usuário deverá digitar o endereço que se segue no browser da web remoto para acessar uma tela (ex. myscreen) da server station #2: http://192.168.1.2/myscreen.html

A interface Project Settings Web deve estar configurada como se segue:

Dica: É possível configurar dois servidores de dados que compartilhem o mesmo web server, aplicando os conceitos descritos nas Arquiteturas 2 e 3.


InduSoft Web Studio

Página 500


Diálogo Advanced


InduSoft Web Studio

Página 501

Arquitetura 4: Web server e Web Thin Clients em redes de trabalhos diferentes

Web Server Station Web Thin Client

TCP/IP

(Intranet)

Data Server Station

Files from the \Web application sub-folder

Web Server (HTTP Server)Web Tunneling Gateway

Studio Runtime + ApplicationData Server (TCP/IP Server)

Essa Arquitetura é usual quando Web Thin Clients estão conectados ao servidor via internet. Geralmente, o computador servidor de dados (computador onde o IWS está rodando) não está diretamente conectado à internet. Nesse caso, o computador servidor de dados não possui um endereço IP na internet, portanto não será conectado diretamente através da internet. O Web Tunneling Gateway (WTG), desenvolvido pela InduSoft, fornece as capacibilidades de roteamento para a solução desse problema.

O WTG deverá estar instalado no computador com o Endereço Fix IP na internet (consulte seu provedor ISP para maiores informações sobre como obter um Endereço Fix IP para seu computador na internet). Esse computador deverá possuir o web server Microsoft IIS instalado e rodando. O WTG é uma extensão ISAPI para IIS.

Siga o procedimento abaixo para a instalação do WTG no computador web server:

• Copie o arquivo WebGtw.exe da subpasta \BIN do IWS dentro de qualquer diretório do computador web server.

• Execute o arquivo WebGtw.exe no computador web server.

O WTG funciona como um roteador entre Web Thin Clients (conectados a internet) e o computador data server (conectado a intranet). O mesmo WTG pode rotear informações para mais de um data server de forma simultânea.

Nota: O computador conectado diretamente a internet (onde o WTG está rodando) é o web server para a aplicação; portanto, os arquivos da subpasta \Web da aplicação deverão ser armazenados nesse computador.



• Endereço IP da web server station (internet): 200.0.0.1

• Endereço IP da web server station (intranet): 192.168.1.1

• Endereço IP da data server station na intranet: 192.168.1.2


InduSoft Web Studio

Página 502

• Diretório Home do web server (HTTP server) na web server station: subpasta \Web da aplicação, armazenada na web server station.

O usuário deverá digitar o endereço que se segue no browser remoto da web para acessar uma tela (ex. myscreen) da Web Server Station: http://200.0.0.1/myscreen.html

A interface Project Settings Web deve ser configurada como se segue:



InduSoft Web Studio

Página 503

Janela de Diálogo Advanced

Nota: Caso seu web server seja capaz de fornecer arquivos via HTTPS (SSL – Secure Socket Layer), você poderá selecionar essa opção na janela de diálogo Advanced a partir da interface Project Settings Web.

Dica: O WTG encapsula o protocolo implementado pelo módulo TCP/IP do IWS para HTTP (ou HTTPS quando a opção SSL está selecionada). Dessa maneira, não é necessário abrir uma Porta TCP adicional no firewall entre o web server e Web Thin Clients. A mesma porta utilizada pelo web server (HTTP ou HTTPS) é utilizada pelo protocolo de dados do IWS.


InduSoft Web Studio

Página 504

Capítulo 19: Correção de Problemas Caso você não encontre uma solução para sua dúvida, e nessecite de assistência técnica, existem alguns fatores que você precisa saber antes de entrar em contato com o Suporte Técnico. Apesar de seu problema, você deverá saber a seqüência de eventos que levam a descoberta do problema em questão, o qual deverá ser explicado da forma mais detalhada possível, o que poderá afetar drasticamente o tempo e procedimento para a resolução de seu problema. É recomendado que você esteja em frente ao seu computador para melhores resultados sobre os problemas a serem resolvidos. Além disso, recomenda-se ter em mãos uma caneta e um pedaço de papel .

Antes de entrar em contato com o Suporte Técnico Existem algumas tentativas que você deverá executar antes de entrar em contato com o suporte técnico:

• Verificar a documentação

Verifique os arquivos Help de seu produto para maiores informações a respeito de sua dificuldade. Help pode ser encontrado na barra de menu da Aplicação. Para documentação online, incluindo Notas Publicdas e downloads, entre no web site do IWS (www.InduSoft.com). Você poderá encontrar sua dúvida particular como um problema já previamente documentado.

• Considerar alterações recentes em seu sistema

Caso exista algo normalmente utilizado, leve em consideração assuntos que podem ter sido alterados. A instalação de um novo software ou sistema gerais podem afetar a performance e funcionalidade generalizada de outro software em seu sistema.

• Tentar reproduzir o problema em um novo arquivo

Caso o problema não possa ser reproduzido em um novo arquivo, faça uma comparação entre o novo arquivo e seu original para encontrar e eliminar as diferenças entre eles. Tal attitude auxiliará na resolução do problema encontrado.

• Tentar reproduzir o problema em outra máquina

Caso o problema não ocorra em outra máquina, compare o que existe de diferente entre os dois sistemas. Nesse caso, podem existir algo como conflitos de sistemas.

Caso você não possa encontrar uma resposta para sua pergunta técnica na documentação do produto ou no sistema Help, nossos especialistas em Suporte Técnico estão disponíveis para assistência a qualquer cliente com a manutenção do produto atual.

Tente definir o problema antes de entrar em contato com o Suporte Técnico, de forma que você poderá repetir os passos que conduzem ao problema e identifica-lo de forma específica, sobre quando e como o problema ocorreu. O suporte representativo necessitará saber exatamente qual é o problema, de modo a promover auxílio. Esses passos nos ajudarão na descoberta rápida do problema, bem como resolve-lo o mais rápido possível.

Tenha as seguintes informações disponíveis:

• Ambiente do Hardware—memória disponível, tipo de processador, equipamento de saída

• Ambiente do Software—Sistema Operacional, versão do Windows®, plataforma de rede de trabalho

• Nome do Produto, número da tag databasee número de registro do produto

• Quantidade de memória instalada em seu sistema

• Quantidade de espaço em disco rígido em seu sistema

• Resolução da tela (tamanho da tela em pixels (por exemplo, 1024 por 768)

• Profundidade da cor na tela (número de cores ou bits, por exemplo, 256 cores ou 8-bit)


InduSoft Web Studio

Página 505

• Fabricante do placa gráfica, nome do modelo e número da tag databasedo driver

• Fabricante da placa de som e nome do modelo

• Uma lista de equipamentos externos conectados ao computador

• Breve descrição do problema ou erro, e um texto específico para cada mensagem de erro

• Descrição dos passos a serem tomados para resolução de problemas, por exemplo, em quantas máquinas foram testadas e se o erro persiste em um novo arquivo

• Passos para reproduzir o ocorrido, caso seja reproduzível. Caso não o seja, poderá ser mais um erro de desenvolvimento do que um problema com o produto.

Caso seu problema ou questão não seja urgente, você tem a opção de entrar em contato com o Suporte Técnico via email. Tais emails são verificados e respondidos diariamente ([email protected] ).

Caso você necessite de assistência adicional para a utilização do InduSoft Web Studio ou seu pacote de servicos, os recursos estão disponíveis por telefone:

IWS (011) 3849 2000

Publicações relacionadas ao IWS:

• InduSoft Web Studio Getting Started Guide: Projetado para usuários inexperientes com o produto, essa publicação contém informações sobre as funções básicas do InduSoft Web Studio. Tal publicação é fornecida na pasta Documentation no CD-ROM do IWS ou no menu Help localizado na barra de menu principal.

Utilizando o Menu Help

Technical Reference: Contém o arquivo Help.

User Guide: Abre o Manual do Usuário.

• InduSoft Web Studio Technical Reference Manual: Descreve todos os recursos e ferramentas que dizem respeito ao ambiente de desenvolvimento do IWS, além de fornecer instruções detalhadas para a utilização do produto. Tal publicação é fornecida na pasta Documentation no CD-ROM do IWS ou no menu Help da barra de menu principal.

• Drivers User Guides: Explica como configurar os drivers individuais do InduSoft, de acordo com as características de seus próprios protocolos. Um guia do usuário personalizado está incluído a cada driver do InduSoft. Essas publicações são fornecidas no subdiretório DRV da pasta do InduSoft Web Studio no CD-ROM do IWS ou no menu Help localizado na barra de menu principal.

Visite o site da InduSoft na Web: www.InduSoft.com.

Verificando sua Aplicação Da barra de menu, selecione Tools → Verify Application para recompilar planilhas Math, lógicas de tela e atualizar arquivos HTML atuais utilizando as configurações no tabWeb (diálogo Project Settings). Tags no banco de dados são remapeados para todas as planilhas e telas.


InduSoft Web Studio

Página 506

É necessártio verificar seu aplicação caso você delete/altere/reordeene quaisquer tags no tag database Tags ou campos do tab Web Project Settings. Verificar se sua aplicação realinha todas as planilhas do driver e telas ao estado atual de tag database.

Verificando a aplicação

Dica: Ao salvar uma tela ou planilha, o IWS inclui um apontador à tag databasedo banco de dados atual. Ao executar a aplicação, o IWS compara a tela ou planilha com o banco de dados da aplicação atual e caso não exista coincidência (mismatch), o IWS recompila as expressões.

Para evitar a efetuação dessas tarefas durante o runtime da aplicação, recomendamos rodar a função Verify Application antes de efetuar o download e/ou finalizar uma aplicação. Pode-se também utilizar essa função ao converter uma aplicação para uma nova tag databaseda aplicação.

Erros Comuns Listados abaixo estão as respostas a perguntas feqüentes sobre o InduSoft Web Studio.

Banco de Dados & Sistema de Segurança

• O que fazer com a pasta Shared Tags armazenada?

A pasta Shared Tags armazena os tag importadosdo PC Based Control com link a aplicação do IWS. O PC Based Control possui um link a aplicação do IWS a partir do wizard New Project.

• Como faço para contar quantos tags estão configurados no banco de dados da aplicação?

Na barra de menu, selecione Project → Status, e o tab Information para calcular a quantidade de tags configurados na aplicação. Cada posição de array e cada membro de classe dos tags configurados no tag database do IWS são contados.


InduSoft Web Studio

Página 507

• Como visualizar a lista de “Usuários” adcicionados durante o runtime em minha aplicação, criada com a função CreateUser()?

Execute o seguinte comando: “<Studio Path>\BIN\Studio Manager.exe” “<Studio Path>\BIN\ExtUser.dll” (Por Exemplo: “E:\Program Files\Studio\BIN\Studio Manager.exe” “E:\Program Files\Studio\BIN\ExtUser.dll”). Esse comando inicializará uma janela de diálogo. Pode-se visualizar os usuários criados pela função CreateUser() e criar ou deletar usuários.

Gráficos

• Como inserir e configurar um objeto ActiveX em uma aplicação do Studio?

Para inserir um objeto ActiveX na aplicação do IWS:

Selecione a opção de menu Insert → ActiveX object… ou aperte o botão ActiveX Control na barra de ferramentas Active Objects.

Selecione o objeto ActiveX a ser inserido na aplicação a partir do list box, e aperte o botão OK. O objeto ActiveX aparecerá na tela. (Objetos ActiveX não registrados não estarão disponíveis nesse list box.)

Clique duas vezes no objeto ActiveX e assinale seu nome (insira um valor no campo Name). O dinâmico properties e a lista methods podem ser visualizados seleiconando o botão Methods. As propriedaes estáticas podem ser configuradas pelo botão Properties (uma descrição detalhada das propriedades do objeto podem ser encontradas na documentação do componente, fornecida pelo desenvolvedor do componente).

Existem três funções para acesso ao componente ActiveX durante runtime:

XGet(strName,strProperties): Retorna o valor das propriedades <strProperties> do objeto <strName>. A lista de propriedades as quais podem ser lidas do objeto está no diálogo Methods do objeto, com a sintaxe <Properties Name>(PropGet) (por exemplo, Color(PropGet)).

XSet(strName,strProperties,Value): Registra o valor <Value> para propriedades <strProperties> do objeto <strName>. A lista de propriedades as quais podem ser configuradas ao objeto está no diálogo Methods do objeto, com a sintaxe <Properties Name>(PropPut) (por exemplo, Color(PropPut)).

XRun(strName, strMethod, Parameter1, Parameter2, …, ParameterN): Execute o método <strMethod> do objeto <strName>, de acordo com parâmetros <Parameter1>, <Parameter2>, …, <ParameterN>. A lista de métodos disponíveis no objeto está no diálogo Methods do objeto, com a sintaxe <Method Name>(Method) (por exemplo, OpenFile(Method)).

Dica: Antes de inserir um componente ActiveX (geralmente um arquivo OCX) na aplicação do IWS, certifique-se de que esse tenha sido registrado de maneira apropriada no computador. É possível registrar um objeto ActiveX através do IWS. Selecione a opção de menu Tools → Register Controls, aperte o botão Register… e selecione o arquivo ActiveX (geralmente um arquivo OCX) que deverá ser registrado.


InduSoft Web Studio

Página 508

Nota: A quantidade de parâmetros configurados na função XRun() podem variar de 0 até 255 e depende de cada componente ActiveX. É possível utilizar tags para configurar parâmetros; porém, o tipo de tag deve estar de acordo com o tipo de parâmetro do componente (Boolean, integer, string ou real).

• Como designar uma tela que abrirá a cada vez que a aplicação for iniciada?

Abra a janela de diálogo Project Settings do menu Project → Settings, selecione o tab Runtime Desktop, e digite o nome da tela startup no campo Startup screen.

• Como inserir uma figura de fundo na tela?

Clique com o botão direito na tela e selecione a opção Screen Attributes do menu pop-up. Habilite o check-box Enable Background e escolha o formato da figura no combo-box próximo a esse nome. Copie o arquivo da figura para a pasta \Screen da Aplicação e renomeie, com o mesmo nome da tela (arquivo <ScreenName>.scr). Utilizando a opção Shared image, é possível copiar um arquivo bitmap para a pasta \Screen e compartilhar essa figura com mais de uma tela. Nesse caso, é necessário digitar o nome bitmap no campo Share image.

Tarefas

• Como converter um Trend Histórico para um arquivo ASCII?

Para converter um arquivo History Trend para formato ASCII, copie o arquivo "<StudioPath>\bin\hst2txt.exe" para o caminho "\<AplicaçãoPath>\hst\". De forma alternativa, pode-se utilizar a função HST2TXT em uma planilha Math para converter arquivos binários para formato texto de forma automática, sem a necessidade de utilizar uma janela DOS.

• Como trocar dados com FOX Pro através de um protocolo ODBC?

Ao trocar dados com o banco de dados FOX Pro, é necessário configurar o parâmetro UseQuote=0 na seção [ODBC] no arquivo <AplicaçãoName>.app.

• Como configurar um campo DATE para uma interface ODBC com um Oracle package?

Configure as células “Column” na planilha ODBC do IWS com a sintaxe <ColumnName>.ts (por exemplo: MyDate.ts).

• Como executar uma planilha Math durante o startup e outra planilha Math durante o shutdown da aplicação?

Startup: Execute uma planilha Math durante o startup criando uma planilha Math e preenchendo-a em seu campo Execution coma expressão <TagName>=0 (por exemplo, StartTag=0). Na última linha da planilha Math, configure o valor 1 para o tag <TagName>. O tipo de tag <TagName> deverá ser Boolean.

Shutdown: Ao invés de executar a função ShutDown() diretamente, execute uma planilha Math e configure a função ShutDown() na última linha dessa planilha Math.


InduSoft Web Studio

Página 509

Comunicação

• Como configurar um alarme “communication Error”?

Configure um tag nos campos “Write Status” ou “Read Status” da planilha de driver e configure um alarme sempre que esse tag for diferente de 0 (zero).

• Como estabelecer comunicação com um PLC Siemens S7-200 sem utilizar um software Prodave?

PLC Siemens S7-200 possui uma Freeport que pode implementar qualquer protocolo via programação PLC. Existe um software gratis para PLC distribuído pela Siemens que implementa o protocolo Modbus na Freeport do PLC (para maiores informações, contate o suporte da Siemens). Utilizando esse software no PLC e no driver Modbus do Studio (MODBU) pode-se trocar informações entre eles.

• Como iniciar e parar drivers de comiunicação durante o runtime?

Existem três funções disponíveis para o manuseio da execução dos drivers de comunicação durente o runtime:

Iniciar todos os drivers configurados na aplicação:

Sintaxe: StartTask(“Driver”)

Por exemplo, StartTask(“Driver”)

Iniciar um driver específico configurado na aplicação:

Sintaxe: WinExec(“<StudioPath>\bin\StudioManager.exe”+ “+ “<StudioPath>\bin\Driver.dll”+ “+ “<DriverName>”)

Por exemplo, WinExec(Asc2Str(34)+“C:\Program Files\InduSoft Web Studio\BIN\Studio Manager.exe+Asc2Str(34)+” “+Asc2Str(34)+ “C:\Program Files\InduSoft Web Studio\BIN\Driver.dll”+ Asc2Str(34)+” “+Asc2Str(34)+ “MODBU”+Asc2Str(34))

Nota: A função Asc2Str(34) é utilizada para concatenar marcas de cotação para caminhos onde existam gráficos de espaço.

Parar um driver específico configurado na aplicação:

Sintaxe: EndTask(“Driver<DriverName>”)

Por exemplo, EndTask(“DriverMODBU”)

Dica: Pode-se iniciar ou parar outras tarefas utilizando as funções StartTask(<TaskName>) e EndTask(<TaskName>).

Por exemplo, StartTaks(“Viewer”), Endtask(“Viewer”).

Atenção: Os drivers e tarefas não podem ser iniciados ou parados durante o runtime quando o CEView estiver rodando (sob sistema operacional WinCE).


InduSoft Web Studio

Página 510

• O que são parâmetros DDE Server do Studio?

O DDE Server do Studio e Parâmetros NetDDE Server são exibidos na tabela abaixo:

Tipo de Comm.

Aplicação Tópico Item

Network DDE

//<Computer Name>\NDDE$

UNISOFT$ <TagName>

Local DDE UNIDDE DB <TagName>

• Como trocar dados com Excel utilizando NetDDE?

NetDDE pode ser utilizado para trocar dados via o protocolo DDE, entre estações de rede de trabalho.

Inicie o módulo DDEServer do Studio (Project → Status → DDE Server)

Rode o Excel na estação remota

Abra uma planilha Excel e preencha as células as quais deverão trocar dados com o Studio utilizando a seguinte sintaxe: = '\\<computer name>\NDDE$'| 'UNISOFT$'!<tagname>

Por exemplo, ='\\PC\NDDE$'|'UNISOFT$'!second

Notas: Ao rodar em Windows NT ou Windows2000, é necessário certificar-se de que os serviços Network DDE e Network DDE DSDM esteja iniciados. (Utilize o atalho Services do Control Panel para iniciar tais serviços).

Ao rodar em Windows 98, é necessário certificar-se de que o programa <WindowsPath>\netdde.exe rode em ambos os computadores (por exemplo, c:\Windows\netdde.exe).

• A interface OPC do Studio é compilante a especificação OPC v1.0a ou v2.0?

Studio OPC Client e módulos OPC Server são compilantes com ambas as especificações do OPC, v1.0a e v2.0.

Resolução de Erros Gerais

• Quais sistemas operacionais são compatíveis com Studio e CEView?

Veja a tabela abaixo. O símbolo “�” significa que o Sistema Operacional Não é suportado e o símbolo “�” significa que o Sistema Operacional é suportado.

Sistema Operacional Studio CEView

Nome Versão v2.x v3.x and v4.1

v4.2 or higher

v3.x V4.x V5.x

Windows XP Any

Windows 2000

Any

Windows NT V4.0+SP4 or higher

Windows ME Any

Windows 98 Any

Windows 95 Any


InduSoft Web Studio

Página 511

Sistema Operacional Studio CEView

Nome Versão v2.x v3.x and v4.1

v4.2 or higher

v3.x V4.x V5.x

V2.12 Windows CE

V3.x

V4.0

V4.1 Windows CE.net

V4.2

• Como iniciar o IWS automaticamente quando o computador está ligado?

Crie um atalho para …\<Studio Path>\bin\RunStartUp.exe na pasta Startup do grupo Programs (…\WINNT\Profiles\All Users\Start Menu\Programs\Startup\).

• Coimo desabilitar Dr. Watson?

O procedimento para desabilitar, passo a passo, o Dr. Watson em Windows NT está descrito abaixo:

Execute o programa <WindowsPath>\RegEdit.exe (por exemplo, C:\WinNT\Regedit.exe)

Selecione o caminho HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AeDebug

Configure o valor 0 (zero) para o parâmetro “Auto” a partir do caminho selecionado.

Feche a janela Registry Editor.

Atenção: Atenção especial deverá ser dada ao editar parâmetros no programa Registry Editor pois alguns deles podem modificar o comportamento geral do Sistema Operacional.

Existem dois meios de modificar o formato dos dados no IWS:

Off-Line: Configurar os Parâmetros Order=<DateFormat> (por exemplo, DMY) e Separator=<Separator> (por exemplo, / or .) da seção [International] do arquivo \<StudioPath>\Local Settings\Aplicação Data\InduSoft Web Studio v6.1\Program Settings.ini.

Nota: Você precisará verificar sua aplicação para aplicar configurações de data para páginas da Web previamente salvas.

On-Line: Utilizar a função SetDateFormat(<strSeparator>, <strDateFormat>). Por exemplo, SetDateFormat(“/”,”MDY”).

• Quais recursos Não são suportados pelo CEView?

Os principais recursos Não suportados pelo CEView são: DDE, NetDDE, ODBC, PasteLink, e um número de funções.


InduSoft Web Studio

Página 512

• Quais são os principais passos para criar uma aplicação baseada na Web?

Siga o procedimento abaixo:

Desenvolva a Aplicação localmente. Não utilize recursos Não suportados por Web Thin Clients para as telas que serão salvas em formato HTML.

Após salvar a telas no formato padrão (File → Save), salve as telas que deverão estar disponíveis para Web Thin Client em formato HTML pelo menu File → Save as HTML.

Abra o diálogo Project Settings (menu Project → Settings) e selecione o tab Web.

Configure o campo Data Server IP com o endereço IP da Server station (estação onde o IWS está rodando).

Abra o diálogo Project Status (menu Project → Status), selecione o tab Execution Tasks e configure o módulo TCP/IP Server como Startup=Automatic.

Abra o tag database da aplicação e configure a opção Server ao invés de Local na coluna Web Data para todos os tags que deverão trocar valores entre Server e Web Thin Client station.

Execute o programa Tools → Verify Aplication para atualizar Project Settings em arquivos HTML.

Caso não haja Web Server rodando no computador, copie o programa NTWebServer.exe da pasta \BIN do Studio para a raiz da web (por exemplo, \<AplicaçãoFolder>\Web) e execute-o. O caminho onde esse programa Web Server é executado será a raiz da web da estação. O Web Server é necessário para exporter dados (arquivos da web) em protocolo HTTP para Web Thin Clients.

Execute a Aplicação na Server station.

Utilizando um browser (por exemplo, Internet Explorer v4.1+SP1 ou tag databasemais atual) na Web Thin Client station, digite o endereço URL para efetuar download da tela salva em formato HTML (por exemplo, http://<ServerIPAddress>/ <ScreenName>.html).

Nota: Web Thin Client requer um componente ActiveX (ISSymbol.ocx) para manusear as telas na browser. Caso o Web Thin Client esteja conectado à Internet, esse componente é baixado e registrado automaticamente. Do contrário, é necessário copiá-lo para o diretório \<OSPath>\System32 do Web Thin Client e registrá-lo pelo comando regsvr32 ISSymbol.ocx. Esse arquivo pode ser encontrado na pasta \BIN do diretório de instalação do IWS.


InduSoft Web Studio

Página 513

• Como enviar um email da aplicação do IWS?


Execute a função CNFEMail(strSMTP,strFrom,strPOP3,strUser, strPassword,numTimeOut) para configurar parâmetros gerais utilizados para enviar emails. Após executar essa função uma vez, os parâmetros configurados são mantidos no sistema até que a aplicação seja fechada. Assim, a maioria das aplicações executam essa função apenas uma vez, após iniciarem a Aplicação;

Execute a função SendEMail(strSubject,strMessage,strTO) e/ou SendEMailExt(strSubject, strMessage,strTO,strCC,strBCC, strFile1,...,strFileN) a cada vez que uma mensagme de email deva ser enviada. A principal diferença entre ambas as funções estão listadas na tabela abaixo:

Característica SendEmail() function SendEmailExt() function

Execução Síncrona Assíncrona

Suporta texto do Assunto

Suporta texto da Mensagem

Suporta endereços TO

Suporta endereços CC

Suporta endereços BCC

Suporta arquivos anexados

• A tarefa de runtime (TCP/IP, OPC, DDE, ODBC, etc) não funciona.

Certifique-se de que a terefa de runtime está configurada para Automatic no tab Execution Tasks do diálogo Project Status (Menu Project → Status). Selecione as terefas de runtime que deverão ser executadas (por exemplo, TCP/IP Server), siga para o botão Startup… e configure para Automatic.

• O Browser do Web Thin Client não exibe a tela e inicializa uma mensagem de alerta ISSymbol.ocx.

Certifique-se de que a tarefa de runtime está configurada para Automatic no tab Execution Tasks do diálogo Project Status (menu Project → Status). Selecione as tarefas de runtime que deverão ser executadas (por exemplo, TCP/IP Server), alcance o botão Startup… e configure para Automatic.

• O Browse do Web Thin Client inicializa uma mensagem de erro faltando ISSymbol.ocx e não exibe a tela do Server.

Issymbol.ocx é o objeto ActiveX do IWS utilizado pelo browser do Web Thin Client para visualizar páginas da web. Caso o Web Thin Client esteja conectado à Internet, o controle ISSymbol.ocx é automaticamente baixado e registrado na Web Thin Client station. Do contrário, é necessário copiar para a pasta \WinNT\System32 na Web Thin Client station e registrar manualmente. Uma vez registrado, seu browser visualizará as páginas.

Nota: Utilize o comando regsvr32 ISSymbol32.ocx para registrar o componente ActiveX no Web Thin Client.

• As telas são exibidas no Web Thin Client (Browser); porém, os dados (valores de tag) não são lidos do Server.

Certifique-se de que o parâmetro na coluna Web Data do tag database da aplicação esteja configurado para Server ao invés de Local. Os tags configurados como Server mantêm o mesmo valor em Server e Web Thin Client (Browser). Os tags configurados como Local possuem valores independentes no Server e Web Thin Client (Browser).


InduSoft Web Studio

Página 514

Atenção: É necessário executar o programa Tools → Verify Application após modificar as configurações dos tags. Do contrário, as alterações não serão atualizadas em arquivos da web.

• As expressões “On Up” configuradas na dinâmica Command não são executadas.

As expressões “On Up” da dinâmica Command não são executadas caso o mouse seja arrastado para fora da área do objeto antes de soltá-lo. Caso o check-box Release em Command na janela Object Properties estiver habilitado, a expressão On Up é executada mesmo se o mouse seja arrastado para fora da área do objeto antes de soltá-lo.

• O Histórico Trend não funciona após adicionar ou remover tags na planilha Trend.

Quando um tag é inserido ou removido DE uma planilha Trend, o formato dos arquivos históricos (*.hst) é modificado. O mesmo arquivo .hst não pode possuir dois formatos diferentes; do contrário, os dados não serão entregues a partir dele da maneira adequada pelo objeto Trend. Caso você precise adicionar ou remover tags de arquivos históricos, existem dois procedimentos válidos: Criar uma nova planilha Trend ou deletar os arquivos *.hst antigos.

• O valor de tags indiretos (@<TagName> ) não está exibido na aplicação web thin client.

Quando a tela é salva como HTML, o Studio salva um arquivo <ScreenName>.tagl na subpasta \WEB. Esse arquivo possui uma lista de todos os tags configurados na tela (objetos e dinâmicos). Quando uma tela é aberta no browser Web Thin Client, os tags listados em <ScreenName>.tagl são “habilitados” para cominicação TCP/IP com a server station, o que promove uma cominicação optimizada entre a server station e Web Thin Client stations.

Ao utilizar tags indiretos nesse modo (@<IndirectTag>), os tags apontados não trocarão dados com o Server, a menos que tenham sido configurados na tela, ou seja, os tags que serão apontados na tela DEVEM ser configurados em qualquer objeto da tela para habilitar a comunicação TCP/IP entre esses tags e a server station.

Dica: Adicione um retângulo transparente (sem preenchimento e linha) no canto da tela. Aplique a dinâmica Command a esse retângulo e configure os tags (que podem ser apontados por tags indiretos durante o runtime em Web Thin Client station) nos campos Expression (mantenha os campos Tag Name em branco). Esses tags serão adicionados ao arquivo <ScreenName>.TAGL e estarão disponíveis para comunicação TCP/IP com a Server station.


InduSoft Web Studio

Página 515

• Quais funcionalidades não são suportadas por plataformas Pocket PC (por exemplo, IPaq, Cassiopeia, Jornada)?

Equipamentos WinCE Pocket PC não suportam algumas funcionalidades que são suportadas por equipamentos WinCE da tag databaseWindows CE “padrão”:

Funcionalidade Não suportada por Equipamentos Pocket PC

DCOM (Distributed Component Object Model): Significa que todos os recursos baseados em DCOM (por exemplo, Cominicação OPC remota) não são suportados por equipamentos PocketPC.

Função DialGetClienDica()não funciona para equipamentos Pocket PC

• Como habilitar as opções “Hibernate” do Sistema Operacional após instalar o IWS em um

Notebook?


Rode Registry Editor (<Start button>\Run\regedit).

Selecione o caminho a seguir para o Registry Editor: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\ Proteq\Parâmetros

O parâmetro IoPortAddress do caminho mencionado acima está configurado com valor hexadecimal: 0x00000111. Configure esse parâmetro com o endereço hexadecimal da porta paralela LPT1 de seu Notebook (por exemplo, 0x00000378).

Feche a janela Registry Editor e reinicie o computador.

Dica: O endereço Hexadecimal da porta paralela LPT1 do Notebook pode ser obtida do Control Panel (System\Hardware\Device Manager\Ports (COM & LPT)\Printer Port (LPT1)\Properties\Resources). Pegue o endereço inicial de I/O Range. Geralmente é o endereço hexadecimal 0x00000378.


InduSoft Web Studio

Página 516

Apêndice A. Funções do InduSoft Web Studio Esse Capítulo contém tabelas e informações descrevendo as diferentes funções disponíveis para o InduSoft Web Studio e CEView.

Funções Log Message Execução NT/2K/XP Win CE Web Client

Trace Síncrona

Funções Aritiméticas Execução NT/2K/XP Win CE Web Client

Abs() Síncrona

Div() Síncrona

Format() Síncrona

GetBit() Síncrona

Mod() Síncrona

Pow() Síncrona

ResetBit() Síncrona

Round() Síncrona

SetBit() Síncrona

SQRT() Síncrona

Swap16() Síncrona

Swap32() Síncrona

Trunc() Síncrona

Funções Estatísticas Execução NT/2K/XP Win CE Web Client

Ave() Síncrona

Max() Síncrona

Min() Síncrona

Rand() Síncrona


InduSoft Web Studio

Página 517

Funções Logarítimicas Execução NT/2K/XP Win CE Web Client

Exp() Síncrona

Log() Síncrona

Log10() Síncrona

Funções Lógicas Execução NT/2K/XP Win CE Web Client

FalIf() Síncrona

If() Síncrona

True() Síncrona

Funções String Execução NT/2K/XP Win CE Web Client

Asc2Str() Síncrona

CharToValue() Síncrona

CharToValueW() Síncrona

ClassMembersToStrVector() Síncrona

Ncopy Síncrona

Num() Síncrona

Str() Síncrona

Str2Asc() Síncrona

StrGetElement() Síncrona

StrLeft() Síncrona

StrLen() Síncrona

StrLower() Síncrona

StrRChr() Síncrona

StrRight() Síncrona

StrSetElement() Síncrona

StrStr() Síncrona

StrStrPos() Síncrona

StrTrim() Síncrona


InduSoft Web Studio

Página 518

Funções String Execução NT/2K/XP Win CE Web Client

StrTrimAll() Síncrona

StrUpper() Síncrona

ValueToChar() Síncrona

ValueWToChar() Síncrona

Funções Data & Hora Execução NT/2K/XP Win CE Web Client

ClockGetDate() Síncrona

ClockGetDayOfWeek() Síncrona

ClockGetTime() Síncrona

DateTime2Clock() Síncrona

GetClock() Síncrona

Hour2Clock() Síncrona

SetSystemDate() Síncrona

SetSystemTime() Síncrona

Funções Trigonométricas

Execução NT/2K/XP Win CE Web Client

Acos() Síncrona

Asin() Síncrona

Atan() Síncrona

Cos() Síncrona

Cot() Síncrona

Pi() Síncrona

Sin() Síncrona

Tan() Síncrona

Abrindo e Fechando Funções do Windows


CloIf() Assíncrona


InduSoft Web Studio

Página 519

Open() Assíncrona

OpenPrevious() Assíncrona


InduSoft Web Studio

Página 520

Funções de Segurança Execução NT/2K/XP Win CE Web Client

BlockUser() Síncrona

CreateUser() Síncrona

GetUserNames() Síncrona

GetUserState() Síncrona

RemoveUser() Síncrona

SetPassword() Síncrona

UnblockUser() Síncrona

Funções do Módulo Activity


AppActivate() Assíncrona

AppIsRodando() Síncrona

AppPostMessage() Síncrona

AppSendKeys() Síncrona

CleanReadQueue() Síncrona

CloseSplashWindow() Síncrona

EndTask() Assíncrona

ExitWindows() Assíncrona

IsScreenOpen() Síncrona

IsTaskRodando() Síncrona

IsViewerInFocus() Síncrona

KeyPad() Assíncrona

LogOff() Assíncrona

LogOn() Assíncrona

Math() Síncrona

PostKey() Síncrona

Recipe() Síncrona

Report() Síncrona


InduSoft Web Studio

Página 521

Funções do Módulo Activity


SendKeyObject() Síncrona

SetAppPath() Síncrona

SetKeyboardLanguage() Síncrona

SetViewerInFocus() Síncrona

SetViewerPos() Síncrona

ShutDown() Síncrona

StartTask() Assíncrona

ViewerPostMessage() Assíncrona

Wait() Síncrona

WinExec() Assíncrona

WinExecIsRunning() Síncrona

Funções de Arquivo Execução NT/2K/XP Win CE Web Client

DeleteOlderFiles() Síncrona

DirCreate() Síncrona

DirDelete() Síncrona

DirLength() Síncrona

DirRename() Síncrona

FileCopy() Síncrona

FileDelete() Síncrona

FileLength() Síncrona

FileRename() Síncrona

FileWrite() Síncrona

FindFile() Síncrona

FindPath() Síncrona

GetFileAttributes() Síncrona

GetFileTime() Síncrona


InduSoft Web Studio

Página 522

GetLine() Síncrona

Hst2Txt() Assíncrona

Hst2TxtIsRodando() Síncrona

Print() Assíncrona

RDFileN() Síncrona

Funções Gráficas Execução NT/2K/XP Win CE Web Client

PrintSetup() Assíncrona

PrintWindow() Assíncrona

RGBColor() Síncrona

RGBComponent() Síncrona

Funções de Tradução Execução NT/2K/XP Win CE Web Client

Ext() Síncrona

SetTranslationFile() Síncrona

Funções Multimídia Execução NT/2K/XP Win CE Web Client

Play() Síncrona/Assíncrona

Funções System Info. Execução NT/2K/XP Win CE Web Client

DbVersion() Síncrona

GetAppHorizontalResolution() Síncrona

GetAppPath() Síncrona

GetAppVerticalResolution() Síncrona

GetComputerIP() Síncrona

GetComputerName() Síncrona

GetFreeMemoryCE(optnumType) Síncrona

GetHardKeyModel() Síncrona

GetHardKeySN() Síncrona

GeDicaAll() Síncrona


InduSoft Web Studio

Página 523

Funções System Info. Execução NT/2K/XP Win CE Web Client

GetMemoryCE(optnumType) Síncrona

GetNetMACID() Síncrona

GetOS() Síncrona

GetPrivateProfileString() Síncrona

GetProductPath() Síncrona

GetScrInfo() Síncrona

GetServerHostName Síncrona

GetTickCount() Síncrona

InfoAppAlrDir() Síncrona

InfoAppHSTDir() Síncrona

InfoDiskFree() Síncrona

InfoResources() Síncrona

IsActiveXReg() Síncrona

KeyPad() Assíncrona

NoInputTime() Síncrona

ProductVersion() Síncrona

SaveAlarmFile() Síncrona

SetAppAlarmPath() Síncrona

SetAppHSTPath() Síncrona

SetDataFormat() Síncrona

SetWebConfig() Síncrona

Funções Loop Execução NT/2K/XP Win CE Web Client

For() & Next NA

Função Database Access


ForceTagChange NA

Funções ODBC Execução NT/2K/XP Win CE Web Client


InduSoft Web Studio

Página 524

Funções ODBC Execução NT/2K/XP Win CE Web Client

ODBCBeginTrans() Síncrona

ODBCBindCol() Síncrona

ODBCCanAppend() Síncrona

ODBCCanTransact() Síncrona

ODBCCanUpdate() Síncrona

ODBCCloIf() Síncrona

ODBCCommitTrans() Síncrona

ODBCDelete() Síncrona

ODBCExecuteSQL() Síncrona

ODBCInsert() Síncrona

ODBCIsBOF() Síncrona

ODBCIsDeleted() Síncrona

ODBCIsEOF() Síncrona

ODBCIsFieldNull() Síncrona

ODBCIsFieldNullable() Síncrona

ODBCMove() Síncrona

ODBCMoveFirst() Síncrona

ODBCMoveLast() Síncrona

ODBCMoveNext() Síncrona

ODBCMovePrev() Síncrona

ODBCOpen() Síncrona

ODBCQuery() Síncrona

ODBCRollback() Síncrona

ODBCSetFieldNull() Síncrona

ODBCSetFilter() Síncrona

ODBCSetSort() Síncrona

ODBCUnbindCol() Síncrona

ODBCUpdate() Síncrona


InduSoft Web Studio

Página 525

Funções Email Execução NT/2K/XP Win CE Web Client

CNFEmail() Síncrona

GetStatussendEmailExt() Síncrona

SendEmail() Síncrona

SendEmailExt() Assíncrona

Funções Dial-Up Execução NT/2K/XP Win CE Web Client

DialErro() Síncrona

DialGetClienDica() Síncrona

DialGetServerIP() Síncrona

DialStatus() Síncrona

DialUp() Assíncrona

DialUpToCE() Assíncrona

FindAllDevices() Síncrona

FindModem() Síncrona

HangUp() Síncrona

PhoneDialUp(strPhoneNumber, OptStrModemName)

Assíncrona

PhoneDisableListen(optStrModemName) Síncrona

PhoneEnableListen(OptStrModemName) Síncrona

PhoneHangUp(OptStrModemName) Assíncrona

PhoneStatus ("strStatus", optStrModemName)

Síncrona

Funções ActiveX Execução NT/2K/XP Win CE Web Client

XGet() Assíncrona

XRun() Assíncrona

XSet() Assíncrona


InduSoft Web Studio

Página 526

Funções Event Logger Execução NT/2K/XP Win CE Web Client

SendEvent() Síncrona

Funções FTP Execução NT/2K/XP Win CE Web Client

CNFFtp() Síncrona

ftpGet() Assíncrona

ftpPut() Assíncrona

ftpStatus() Síncrona

Funções Database Execução NT/2K/XP Win CE Web Client

ForceTagChange() Síncrona

SyncAlarm() Assíncrona

SyncEvent() Assíncrona

SyncTrend() Assíncrona

SyncAlarmStatus() Síncrona

SyncEventStatus() Síncrona

SyncTrendStatus() Síncrona


InduSoft Web Studio

Página 527

Protótipos e Descrições de Funções A função Tags Name utilizada no IWS deverá estar de acordo com a seguintes sintaxes:

• num[Name]: Tag numérico ou valor

• str[Name]: Tag string ou valor

• tag[Name]: Nome do Tag

• optNum[Name]: Tag numérico opcional ou valor

• optStr[Name]: Tag String opcional ou valor

• optTag[Name]: Nome do Tag opcional

Essa Sintaxe identifica os tipos de argumentos requisitados para cada parâmetro da função do IWS.

Nota: Esses protótipos dependem de tags dinâmicos utilizados para passer valores para Funções; porém, pode-se inserir valores estáticos nessas funções. Para substituir valores estáticos nessas funções. Para substituir tag string com strings de carater estático, insira o string entre aspas (por exemplo, insira “ABCDEFG” ao invés de strTag). Pode-se também substituir números estáticos por tags numéricos (por exemplo, insira 45.6543 ao invés de numTag).


InduSoft Web Studio

Página 528

Funções Log Message Essa seção descreve a função Log Message do IWS, Trace(strOutputMessage).

Trace(strOutputMessage)

Grupo Log Message

Execução Síncrona

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

• Descrição: Exibe os conteúdos de strOutputMessage na janela LogWin.

• Parameter: Essa função aceita o seguinte parâmetro:

StrOutputMessage Tag String contendo uma mensagem a ser exibida em LogWin

• Exemplos:

Nome do Tag Expressão

Trace( “Starting Step 5” ) // Iniciar passo 5 exibe-se na janela LogWin.

Trace(Date) // Os conteúdos do tag Date exibe-se na janela LogWin.

Nota: Essa função é útil para correção de erros. Por exemplo, Caso você deseje saber quando o IWS estará executando um script math específico.

Dica: Pode-se concatenar texto, expressões e valores de tag para compor o parâmetro strOutputMessage. Por exemplo,

Trace(“The tag second has the value”+second+” and the Internal Clock = “+GetTickCount( ))


InduSoft Web Studio

Página 529

Funções Aritiméticas Essa seção descreve as seguintes funções Aritiméticas do InduSoft Web Studio:

• ABS(numValue)

• Div(numNumerator, numDenominator)

• Format(strFlag, numValue)

• GetBit(tagName, numBitNumber)

• Mod(numNumerator, numDenominator)

• Pow(numBase, numExponent)

• ResetBit(“tagName”, numBitNumber)

• Round(numValue)

• SetBit(“tagName”, numBitNumber)

• SQRT(numValue)

• Swap32(numValue)

• Swap16(numValue)

• Trunc(numValue)

ABS(numValue)

Grupo Aritimética




Web Thin Client Suportado

• Descrição: Executa a função de valor Absoluto nos conteúdos do tag numValue.

• Parâmetros:

numValue Tag Integer ou Tag Real contendo o número do qual a função pega o valor absoluto.

• Valores de Retorno: Resultado numérico para a função de valor Absoluto.

• Exemplos:

Nome do Tag

Expressão

Tag ABS(“-54.9788”) // Valor de retorno = 54.9788

Tag ABS(numValue) // Valor de retorno = valor absoluto do número no tag numValue.


InduSoft Web Studio

Página 530

Div(numNumerator, numDenominator)

Grupo Aritimética





• Descrição: Divide o valor em numNumerator pelo valor de numDenominator e retorna somente o número inteiro total, omitindo o restante.

• Parâmetros:

numNumerator Tag Integer ou Real contendo o numerador de uma função.

numDenominator Tag Integer ou Real contendo o denominador de uma função.

• Valores de Retorno: Resultado numérico de uma função como um inteiro.

• Exemplos:


numValue Div(100, 8) // Retorna o valor 12.5

numValue Div(16, 4) // Retorna o valor 4

numValue Div(100,12.5) //Retorna o valor 8

Dica: Utilize a função MOD( ) para obter o restante da divisão.

Format (strFlag, numValue)

Grupo Aritimética





• Descrição: Modifica o formato de um valor numérico, de acordo com o flag.


InduSoft Web Studio

Página 531

• Parâmetros:

strFlag Configura o formato de acordo com a sintaxe %m.nF.

Onde:

• F: Determina como o valor é formatado • d: Decimal • x: Hexadecimal (caracteres em letra minuscula) • X: Hexadecimal (caracteres em letra maiúscula) • o: Octal • b: Binário • f: Float • e: Notação científica (e em letra minúscula) • E: Notação científica (E em letra maiúscula) • g: Arredonda o valor (e em letra minúscula, quando aplicável) • G: Arredonda o valor (E em letra minúscula, quando aplicável) • s: String • c: caractere ASCII • h: Hora (hh:mm:ss) • m (Aplicável para flags d, x, X, o, b, f, e, E, g, G, s, c, and h): Copnfigura o

número mínimo de caracteres de retorna pela função, adicionando espaços em branco à esquerda do valor de retorno ou 0 (zero) (veja Exemplos).

• n (Aplicável para flags f, e, E, g, e G): Configura o número mínimo de caracteres decimais para valores de retorno flutuantes retornados pela função.

numValue Valor numérico a ser formatado.

• Valores de Retorno: Valor String formatado de acordo com os parâmetros configurados em uma função.

• Exemplos:


Tag Format("%d",12.34) // valor de retorno = “12”

Tag Format("%04d",12.34) // valor de retorno = “0012”

Tag Format("%4d",12.34) // valor de retorno = “12”

Tag Format("%x",26) // valor de retorno = “1a”

Tag Format("%04x",26) // valor de retorno = “001a”

Tag Format("%4x",26) // valor de retorno = “1a”

Tag Format("%X",26) // valor de retorno = “1A”

Tag Format("%04X",26) // valor de retorno = “001A”

Tag Format("%4X",26) // valor de retorno = “1A”


InduSoft Web Studio

Página 532


Tag Format("%o",16) // valor de retorno = “20”

Tag Format("%04o",16) // valor de retorno = “0020”

Tag Format("%4o",16) // valor de retorno = “20”

Tag Format("%b",2) // valor de retorno = “10”

Tag Format("%4b",2) // valor de retorno = “0010”

Tag Format("%04b",2) // valor de retorno = “0010”

Tag Format("%0.1f",12.34) // valor de retorno = “12.3”



Tag Format("%e",12.34) // valor de retorno = “1.234000e+001”

Tag Format("%0.1e",12.34) // valor de retorno = “1.2e+001”

Tag Format("%09.1e",12.34) // valor de retorno = “01.2e+001”

Tag Format("%9.1e",12.34) // valor de retorno = “ 1.2e+001”

Tag Format("%E",12.34) // valor de retorno = “1.234000E+001”

Tag Format("%0.1E",12.34) // valor de retorno = “1.2E+001”

Tag Format("%09.1E",12.34) // valor de retorno = “01.2E+001”

Tag Format("%9.1E",12.34) // valor de retorno = “ 1.2E+001”

Tag Format("%0.1g",12.34) // valor de retorno = “1e+001”

Tag Format("%0.2g",12.34) // valor de retorno = “12”

Tag Format("%0.3g",12.34) // valor de retorno = “12.3”

Tag Format("%05.3g",12.34) // valor de retorno = “012.3”

Tag Format("%5.3g",12.34) // valor de retorno = “ 12.3”


InduSoft Web Studio

Página 533


Tag Format("%0.1G",12.34) // valor de retorno = “1E+001”

Tag Format("%0.2G",12.34) // valor de retorno = “12”

Tag Format("%0.3G",12.34) // valor de retorno = “12.3”

Tag Format("%05.3G",12.34) // valor de retorno = “012.3”

Tag Format("%5.3G",12.34) // valor de retorno = “ 12.3”

Tag Format("%s",12.34) // valor de retorno = “12”

Tag Format("%04s",12.34) // valor de retorno = “0012”

Tag Format("%4s",12.34) // valor de retorno = “12”

Tag Format("%c",97) // valor de retorno = “a”

Tag Format("%4c",97) // valor de retorno = “a”

Tag Format("%04c",97) // valor de retorno = “000a”

Tag Format("%h",30) // valor de retorno = “00:00:30”




Nota: A função (strFlag, numValue) permite que os mesmo flags sigma o símbolo % utilizado para a função C padrão printf( ); porém, pode-se formatar somente um valor em cada célula.

Dica: A função Format( ) será especialmente útil ao formatar o número de caracteres para valores a serem impressos em relatórios. Também, você deverá utilizar essa função para converter o número de segundos no seguinte formato:

hh:mm:ss(strFlag =%h)

Os parâmetros h e m são opcionais.


InduSoft Web Studio

Página 534

GetBit(tagName, numBitNumber)

Grupo Aritimética





• Descrição: Isola um único bit em um tag numérico

• Parâmetros:

tagName O nome de um Tag Integer onde o valor do bit é pego.

numBitNumber Um tag numérico que suporta o número do bit a ser isolado. (0…31)

• Valores de Retorno: Retorna o valor numérico (0 ou 1) que corresponde ao valor do bit isolado.

• Exemplos:


Tag GetBit(numSource, 4) //Caso o tag numSource contenha o valor 15, essa função deverá retornar o valor 0.

Tag GetBit(numSource,1) //Caso o tag numSource contenha o valor 19, essa função deverá retornar o valor 1.

Dica: Pode-se utilizar o campo Bit para ler/registrar valores de bits específicos em um tag integer.

Por exemplo, insira Second->b0 para acessar LSB (Least Significant Bit do Segundo Tag), e Second->b31 para acessar MSB (Most Significant Bit do Segundo tag).


InduSoft Web Studio

Página 535

Mod(numNumerator, numDenominator)

Grupo Aritimética





• Descrição: Divide o valor de numNumerator pelo valor de numDenominiator somente, e retorna o restante como um número real.

• Parâmetros:

numNumerator Tag Integer ou Real contendo o numerador de uma função.

numDenominator Tag Integer ou Real contendo o numerador de uma função.

• Valores de Retorno: Retorna o restante da divisão de numNumerator por numDenominator.

• Exemplos:


Tag Mod(50, 4) // Valor de retorno = 2

Tag Mod(16,4) // Valor de retorno = 0

Tag Mod(100, 8.2) // Valor de retorno = 1.600

Nota: Utilize a função DIV( ) para obter o valor inteiro da divisão.

Pow(numBase, numExponent)

Grupo Aritimética





• Descrição: Retorna o resultado de numBase para numExponent.


InduSoft Web Studio

Página 536

• Parâmetros:

numBase Tag Integer ou Real contendo a base de uma função.

numExponent Tag Integer ou Real contendo o Expoente de uma função.

• Valores de Retorno: Retorna o resultado de base para o expoente.

• Exemplos:


Tag Pow(2, 3) // Valor de retorno = 8

Tag Pow(10,4) // Valor de retorno = 10000

ResetBit(“tagName”, numBitNumber)

Grupo Aritimética





• Descrição: Configura um bit único em um tag numérico para 0.

• Parâmetros:

“tagName” Name de um Tag Integer onde o valor do bit será reiniciado.

numBitNumber Tag numérico que suporta o número do bit a ser reiniciado. (0…31)

• Valores de Retorno:

0 Sem Erro

1 Parâmetro inválido

2 Tag não existe

• Exemplos:


Tag ResetBit(“numSource”, 4) //Caso o tag numSource contenha o valor 16, essa função deverá retornar o valor 0 e numSource deverá suportar o valor 0.


InduSoft Web Studio

Página 537

Tag ResetBit(“numSource”,1) //Caso o tag numSource contenha o valor 19, essa função deverá retornar o valor 0 and numSource deverá suportar o valor 17.

Nota: Para inserir o nome do tag integer diretamente (ao invés da utilização do parâmetro tagName) deve-se inserir o nome entre aspas duplas. Por exemplo, SetBit(“Second”,1).

Dica: Pode-se utilizar o campo Bit para ler/registrar valores de bits específicos em um tag integer. Por exemplo, insira Second->b0 para acessar LSB (Least Significant Bit do Segundo tag), e Second->b31 para acessar MSB (Most Significant Bit do Segundo tag).

Round(numValue)

Grupo Aritimética





• Descrição: Arredonda numValue para o inteiro mais próximo.

• Parâmetros:

numValue Um tag Real que suporta o valor a ser arredondado.

• Valores de Retorno: Retorna o resultado inteiro da função de arredondamento.

• Exemplos:


Tag Round(“345.87”) // Valor de retorno = 346

Tag Round(“65.323”) // Valor de retorno = 65

SetBit(“tagName”, numBitNumber)

Grupo Aritimética



InduSoft Web Studio

Página 538




• Descrição: Configura um bit único em um tag numérico para 1.

• Parâmetros:

“tagName” Nome de um tag Integer onde o valor do bit está configurado.

numBitNumber Tag numérico suportando o número do bit a ser configurado. (0…31)


0 Sem Erro


2 Tag não existe

• Exemplos:


Tag GetBit(“numSource”, 4) //Caso o tag numSource contenha o valor 0, essa função deverá retornar o valor 0 and numSource deverá suportar o valor 16.

Tag GetBit(“numSource”,1) //Caso o tag numSource contenha o valor 17, essa função deverá retornar o valor 0 and numSource deverá suportar o valor 19.

Nota: Para inserir o nome do tag integer diretamente (ao invés de utilizar o parâmetro tagName) deve-se inserir o nome entre aspas duplas. Por exemplo, SetBit(“Second”,1).

Dica: Pode-se também utilizar o campo Bit para ler/registrar valores de bits específicos de um tag integer. Por exemplo, insira Second->b0 para acessar LSB (Least Significant Bit de um segundo tag), e Second->b31 para acessar MSB (Most Significant Bit do Segundo tag).

SQRT(numValue)

Grupo Aritimética


InduSoft Web Studio

Página 539





• Descrição: Obtém a raiz quadrada de numValue.

• Parâmetros:

NumValue Tag Integer ou Real a ser tirado a raiz quadrada.

• Valores de Retorno: Retorna a raiz quadrada do valor no tag numValue.

• Exemplos:


Tag SQRT(25) // Retorna o valor 5

Tag SQRT(67) // Retorna o valor 8.185353

Nota: Caso numValue tenha um valor negativo, quando essa função retorna o valor 0, configura a qualidade do tag de retorno para BAD.

Swap16(numValue)

Grupo Aritimética



Windows CE Não suportado


• Descrição: Inverte os dois bytes mais baixos de um tag.

• Parâmetros:

numValue Tag Integer que suporta o valor numérico de bytes a serem invertidos.

• Valores de Retorno: Retorna o valor numérico após inverter os bytes.

• Exemplos:


InduSoft Web Studio

Página 540


Tag Swap16(16) // 16 = 0000000000010000 em Binário. Valor de retorno = 4096 = 0001000000000000 em Binário.


Swap32(numValue)

Grupo Aritimética





• Descrição: Inverte duas palavras em um tag.

• Parâmetros:

numValue Tag Integer que suporta o valor numérico de palavras a serem invertidas.

• Valores de Retorno: Retorna o valor numérico após inverter as palavras.

• Exemplos:



Tag Swap32(246333120) // 286333120 = 1010101010101010101111111100000000 em Binário. Valor de retorno = -1094709586= 11111111000000001010101010101010 em Binário.

Trunc(numValue)

Grupo Aritimética




InduSoft Web Studio

Página 541



• Descrição: Trunca o valor de numValue.

• Parâmetros:

numValue Tag Real a ser truncada.

• Valores de Retorno: Retorna a porção inteira do valor do número real de numValue.

• Exemplos:


Tag Trunc(234.987) // Valor de retorno = 234

Tag Trunc(-3465.9) // Valor de retorno = -3465.9


InduSoft Web Studio

Página 542

Funções Estatísticas Essa seção descreve as seguintes funções Estatísticas do InduSoft Web Studio:

• Avg(numValue1, numValue2, …, numValueN)

• Avg(“tagArray”, numSample, optnumIgnore)

• Max(numValue1, numValue2, …, numValueN)

• Max(“tagArray”, numSample, optnumIgnore)

• Min(numValue1, numValue2, …, numValueN)

• Min(“tagArray”, numSample, optnumIgnore)

• Rand()

Avg(numValue1, numValue2, …, numValueN)

Avg(“tagArray”, numSample, optnumIgnore)

Grupo Estatística





• Descrição: Calcula o valor da média de um conjunto de números.

• Parâmetros:

numValue (1…N) Tag Integer ou Real contendo os números para tirar as médias.

“tagArray” Nome do tag array (Real ou Integer) contendo os valores dos quais tirar as médias.

numSample Tag Integer contendo o número de elementos array a serem tirados a média.

optnumIgnore Tag Integer ou Real opcional contendo o valor a ser ignorado no cálculo da média.

• Valores de Retorno: Retorna a média dos valores.

• Exemplos:


Tag Avg(1,2.34,5,7,4,8,9.4) // Valor de retorno = 5.248571

Tag Avg(1, 5, -9, 0, 5, 3) // Valor de retorno = 0.833333

Tag Avg(“tagArray[1]”,3) // Se tagArray[1]=10, tagArray[2]=20 and tagArray[3]=60, o Valor de retorno = 30


InduSoft Web Studio

Página 543


Tag Avg(“tagArray[1]”,3,10) // Se tagArray[1]=10, tagArray[2]=20 and tagArray[3]=60, o Valor de retorno = 40

Nota: Essa função possui dois formatos:

Caso o primeiro parâmetro seja um Tag numérico ou valor, você deverá utilizar os formatos Avg(numValue1, numValue2, …, numValueN).

Caso o primeiro parâmetro seja um tag array entre aspas duplas ou um tag string, você deverá utilizar os formatos Avg(“tagArray”, numSample, optnumIgnore).

Max(numValue1, numValue2, …, numValueN)

Max(“tagArray”, numSample, optnumIgnore)

Grupo Estatística





• Descrição: Retorna o máximo valor a ser configurado.

• Parâmetros:

numValue (1…N) Tag Integer ou Real contendo os números a serem analisados.

“tagArray” Name do tag array (Real ou Integer) contendo os valores a serem analisados.

numSample Tag Integer contendo o número de elementos array a serem analisados.

optnumIgnore Tag Integer ou Real contendo o valor a ser ignorado na análise.

• Valores de Retorno: Retorna o máximo valor a ser configurado.

• Exemplos:


Tag Max(1,2.34,5,7,4,8,9.4) // Valor de retorno = 9.4

Tag Max(1, 5, -9, 0, 5, 3) // Valor de retorno = 5


InduSoft Web Studio

Página 544

Tag Max(“tagArray[1]”,3) // Se tagArray[1]=10, tagArray[2]=20 and tagArray[3]=60, o Valor de retorno = 60

Tag Max(“tagArray[1]”,3,10) // Se tagArray[1]=10, tagArray[2]=20 and tagArray[3]=60, o Valor de retorno = 60


• Caso o primeiro parâmetro seja um Tag numérico ou valor, você deverá utilizar os formatos Max(numValue1, numValue2, …, numValueN).

• Caso o primeiro parâmetro seja um tag array entre aspas duplas ou um tag string, você deverá utilizar os formatos Max(“tagArray”, numSample, optnumIgnore).

Min(numValue1, numValue2, …, numValueN)

Min(“tagArray”, numSample, optnumIgnore)

Grupo Estatística





• Descrição: Retorna o valor mínimo de um conjunto de números.

• Parâmetros:

numValue (1…N) Tag Integer ou Real contendo os números a serem analisados.

“tagArray” Nome de um tag array (Real ou Integer) contendo os valores a serem analisados.

numSample Tag Integer contendo o número de elementos array a serem analisados.

optnumIgnore Tag Integer ou Real contendo um valor a ser ignorado na análise.

• Valores de Retorno: Retorna o valor mínimo de um conjunto.

• Exemplos:

Nome do Tag

Expressão

Tag Min(1,2.34,5,7,4,8,9.4) // Valor de retorno = 1


InduSoft Web Studio

Página 545

Tag Min(1, 5, -9, 0, 5, 3) // Valor de retorno = -9

Tag Min(“tagArray[1]”,3) // Se tagArray[1]=10, tagArray[2]=20 e tagArray[3]=60, o Valor de retorno = 10

Tag Min(“tagArray[1]”,3,10) // Se tagArray[1]=10, tagArray[2]=20 e tagArray[3]=60, o Valor de retorno = 20


Caso o primeiro parâmetro seja um Tag numérico ou valor, você deverá utilizar os formatos Min(numValue1, numValue2, …, numValueN).

Caso o primeiro parâmetro seja um tag array entre aspas duplas ou um tag string, você deverá utilizar os formatos Min(“tagArray”, numSample, optnumIgnore).

Rand()

Grupo Estatística





• Descrição: Gera um número randomizado entre 0 e 1.

• Valores de Retorno: Retorna um número real entre 0 e 1.

• Exemplos:


Tag Rand() // Valor de retorno = ?, Onde: 0<?<1


InduSoft Web Studio

Página 546

Funções Logarítimicas Essa seção descreve as seguintes funções Logarítimicas do InduSoft Web Studio:

• Exp(numValue)

• Log(numValue)

• Log10(numValue)

Exp(numValue)

Grupo Logarítimico





• Descrição: Calcula o valor de e (e = 2.718282) elevado a potência de numValue

• Parâmetros:

NumValue Tag Integer ou Real contendo o expoente de e.

• Valores de Retorno: Retorna o valor de e^(numValue).

• Exemplos:


Tag Exp(1)// Valor de retorno = 2.718282

Tag Exp(5.25896) // Valor de retorno = 192.281415

Log(numValue)

Grupo Logarítimico





• Descrição: Calcula o log natural de numValue

• Parâmetros:

NumValue Tag Integer ou Real do qual é retirado o log natural.

• Valores de Retorno: Retorna o valor de ln(numValue).


InduSoft Web Studio

Página 547

• Exemplos:


Tag Log(2.718282)// Valor de retorno = 1

Tag Log(100) // Valor de retorno = 4.605170

Nota: Caso numValue possui um valor negativo, essa função retorna o valor 0 e configura a qualidade do tag de retorno para BAD.

Log10(numValue)

Grupo Logarítimico





• Descrição: Calcula o log na base 10 de numValue.

• Parâmetros:

NumValue Tag Integer ou Real, do qual é retirado o log na base 10.

• Valores de Retorno: Retorna o valor de log10(numValue).

• Exemplos:


Tag Log10(1000)// Valor de retorno = 3

Tag Log10(43.05) // Valor de retorno = 1.633973

Nota: Caso numValue possua um valor negativo, essa função retornará o valor 0 e configurará a qualidade do tag de retorno para BAD.


InduSoft Web Studio

Página 548

Funções Lógicas Essa seção descreve as seguintes funções Lógicas do InduSoft Web Studio:

• FalIf(numExpression)

• If(numExpression, numThen, optnumElse)

• True(numExpression)

FalIf(numExpression)

Grupo Lógico





• Descrição: Determina se o conteúdo de numExpression é Logicamente falso.

• Parâmetros:

numExpression Tag ou Expressão a ser utilizado em uma função.


0 Caso tag ou Expressão não seja logicamente falsa.

1 Caso tag ou Expressão seja logicamente falsa.

• Exemplos:


Tag FalIf(1)// Valor de retorno = 0

Tag FalIf(5 < 2) // Valor de retorno = 1

Dica: Essa função será especialmente útil caso você necessite retornar o valor 0 quando a Expressão retorna qualquer valor diferente de 0.


InduSoft Web Studio

Página 549

If(numExpression, numThen, optnumElse)

Grupo Lógico





• Descrição: Determina se os conteúdos de numExpression são logicamente verdadeiros, e retorna o valor de numThen ou optnumElse em concordância.

• Parâmetros:

numExpression Tag ou Expressão utilizada como condição em uma função.

numThen Tag ou Expressão utilizado caso a condição seja logicamente verdadeira.

optnumElse Tag opcional ou Expressão utilizado caso a condição seja logicamente falsa.


numThen Caso numExpression seja logicamente verdadeira.

optnumElse Caso numExpression seja logicamente falsa.

No value returned Caso numExpression seja logicamente falsa e não há optnumElse em uma função.

• Exemplos:


Tag If(5>4,10, 6)// Valor de retorno = 10

Tag If(5<2, 0, 2) // Valor de retorno = 2

Tag If(3=9, 67) // No valor de retorno. (Tag retém valor anterior.)

Dicas: O argumento numThen pode ser uma outra função, incluindo a função If(). Portanto, pode-se utilizar funções If() em cascata. Por exemplo, if(TagA>TagB,If(TagA<TagC,1, 2),3).

O parâmetro numExpression pode ser uma combinação de demonstrações lógicas (AND, OR, e NOT). Por exemplo, If(TagA>TagB AND TagA=10,1,0).


InduSoft Web Studio

Página 550

True(numExpression)

Grupo Lógico





• Descrição: Determina se os conteúdos de numExpression são logicamente verdadeiros.

• Parâmetros:

numExpression Tag ou Expressão a ser utilizado em uma função.


0 Caso tag ou Expressão não seja logicamente verdadeira.

1 Caso tag ou Expressão seja logicamente verdadeira.

• Exemplos:


Tag True(1)// Valor de retorno = 1

Tag True(5 < 2) // Valor de retorno = 0

Dica: Essa função será especialmente útil caso você necessite retornar o valor 1 quando a expressão retorna um valor diferente de 0.


InduSoft Web Studio

Página 551

Funções String Essa seção descreve as seguintes funções String do InduSoft Web Studio:

• Asc2Str(numChar1, numChar2, …, numCharN)

• CharToValue(“tagName”, “tagArray”)

• CharToValueW(“tagName”, “tagArray”)

• ClassMembersToStrVector (“strClassTag”, numStartPos, numNumPos, “strArrayTag”, optBooStartPosTarget)

• NCopy(strSource, numStartChar, numQtdChar)

• Num(strValue)

• Str(numValue)

• Str2Asc(strChar)

• StrGetElement(strSource, strDelimiter, numElementNumber)

• StrLeft(strSource, numQtdChar)

• StrLen(strSource)

• StrLower(strSource)

• StrRChr(strSource, strCharSequence)

• StrRight(strSource, numQtdChar)

• StrSetElement(strSource, strDelimiter, numElementNumber, strValue)

• StrStr(strSource, strCharSequence)

• StrStrPos(strSource, strCharSequence)

• StrTrim(strReference, numOptFlag)

• StrTrimAll(strReference, strOptTrimChar)

• StrUpper(strSource)

• ValueToChar(“tagArray”, numChars)

• ValueWToChar(“tagArray”, numChars)


InduSoft Web Studio

Página 552

TABELAS ASCII

Caractere (0 - 127)

Código Char Código Char Código Char Código Char 0 32 [space] 64 @ 96 ` 1 33 ! 65 A 97 a 2 34 " 66 B 98 b 3 35 # 67 C 99 c 4 36 $ 68 D 100 d 5 37 % 69 E 101 e 6 38 & 70 F 102 f 7 39 ' 71 G 103 g 8 ** 40 ( 72 H 104 h 9 ** 41 ) 73 I 105 i

10 ** 42 * 74 J 106 j 11 43 + 75 K 107 k 12 44 , 76 L 108 l 13 ** 45 - 77 M 109 m 14 46 . 78 N 110 n 15 � 47 / 79 O 111 o 16 � 48 0 80 P 112 p 17 � 49 1 81 Q 113 q 18 � 50 2 82 R 114 r 19 51 3 83 S 115 s 20 52 4 84 T 116 t 21 53 5 85 U 117 u 22 � 54 6 86 V 118 v 23 � 55 7 87 W 119 w 24 � 56 8 88 X 120 x 25 � 57 9 89 Y 121 y 26 � 58 : 90 Z 122 z 27 59 ; 91 [ 123 { 28 � 60 < 92 \ 124 | 29 � 61 = 93 ] 125 } 30 - 62 > 94 ^ 126 ~ 31 63 ? 95 _ 127 �

Caractere (128 – 255)

Código Char Código Char Código Char Código Char 128 € 160 [space] 192 À 224 à 129 � 161 ¡ 193 Á 225 á 130 ‚ 162 ¢ 194 Â 226 â


InduSoft Web Studio

Página 553

131 ƒ 163 £ 195 Ã 227 ã 132 ‚‚ 164 ¤ 196 Ä 228 ä 133 … 165 ¥ 197 Å 229 å 134 † 166 ¦ 198 Æ 230 æ 135 ‡ 167 § 199 Ç 231 ç 136 ˆ 168 ¨ 200 È 232 è 137 ‰ 169 © 201 É 233 é 138 Š 170 ª 202 Ê 234 ê 139 ‹ 171 ‹‹ 203 É 235 É 140 Œ 172 ¬ 204 Ì 236 ì 141 � 173 205 Í 237 í 142 Ž 174 ® 206 Î 238 î 143 � 175 ¯ 207 Ï 239 ï 144 � 176 ° 208 Ð 240 ð 145 ' 177 ± 209 Ñ 241 ñ 146 ' 178 ² 210 Ò 242 ò 147 " 179 ³ 211 Ó 243 ó 148 " 180 ´ 212 Ô 244 ô 149 · 181 µ 213 Õ 245 õ 150 – 182 ¶ 214 Ö 246 ö 151 — 183 · 215 × 247 ÷ 152 ˜ 184 ¸ 216 Ø 248 ø 153 ™ 185 ¹ 217 Ù 249 ù 154 š 186 º 218 Ú 250 ú 155 › 187 ›› 219 Û 251 û 156 œ 188 ¼ 220 Ü 252 ü 157 � 189 ½ 221 Ý 253 ý 158 ž 190 ¾ 222 Þ 254 þ 159 Ÿ 191 ¿ 223 ß 255

Nota: ** Valores 8, 9, 10, e 13 convertem para backspace, tab, linefeed, e caracteres carriage return, respectivamente. Eles não possuem representação gráfica, embora dependendo da aplicação, possam afetar o efeito visual do texto.

� indica que Não é suportado na plataforma atual.

Asc2Str(numChar1, numChar2, …, numCharN)

Grupo String




InduSoft Web Studio

Página 554



• Descrição: Converte valores decimais para seus caracteres ASCII correspondentes.

• Parâmetros:

numChar (1-N) Tag ou Expressão contendo um valor decimal a ser convertido para um caractere ASCII.

• Valores de Retorno: Retorna uma string de caracteres ASCII correspondentes aos valores decimais inseridos.

• Exemplos:


Tag Asc2Str(67) // Valor de retorno = C

Tag Asc2Str(83, 116, 117, 100, 105, 111) // Valor de retorno = IWS

CharToValue(“tagName”, “tagArray”)

Grupo String





• Descrição: Converte uma string para um array de valores inteiros (utilizando bytes).

• Parâmetros:

“tagName” O nome do tag string, o qual o valor será convertido.

“tagArray” O nome do tag array que recebe os valores inteiros.

• Valores de Retorno: Não há valores de retorno dessa função.

• Exemplos:


CharToValue( “StrTag”, “Array[1]”) // Se StrTag = “ IWS” then Array[1] será configurado para 83 (“S” in ASCII), Array[2] to 116 (“t” in ASCII) e assim por diante.


InduSoft Web Studio

Página 555

Nota: Não é possível utilizar essa função para caracteres UNICODE, pois converte somente o menor byte de caracteres UNICODE.

CharToValueW(“tagName”, “tagArray”)

Grupo String





• Descrição: Converte uma string para uma array de valores inteiros (utilizando palavras ao invés de bytes).

• Parâmetros:

“tagName” O nome do tag string, do qual o valor será convertido.

“tagArray” O nome do tag array que recebe os valores inteiros.

• Valores de Retorno: Não há valores de retorno dessa função.

• Exemplos:

Nome do Tag

Expressão

CharToValue(“StrTag”, “Array[1]”) // Se StrTag = “ IWS” o Array[1] será configurado para 29779 (“St” in ASCII), Array[2] to 25717 (“ud” in ASCII) e assim por diante.

Nota: Essa função pode ser útil ao converter caracteres UNICODE para códigos.

ClassMembersToStrVector (“strClassTag”, numStartPos, numNumPos, “strArrayTag”,

optBooStartPosTarget)

Grupo String





InduSoft Web Studio

Página 556


• Descrição: Transfere valores de tags class para tags array.

• Parâmetros:

strClassTag O valor da string contendo o nome do tag class.

numStartPos Posição inicial (índice array) de strClassTag

numNumPos Número de posições (indices array) a serem transferidas de strClassTag.

strArrayTag Valor da string contendo o tag array que receberá os valores de strClassTag.

optBooStartPosTarget

Posição inicial (índice array) de strArrayTag. Se omitido, o valor padrão será 1.


-6 Tamanho da Array de strClassTag não é grande o suficiente para numStartPos

-5 strClassTag não é um Class Tag

-4 strClassTag não encontrado

-3 strArrayTag não encontrado

-2 Tipos de dados de parâmetros inválidos

-1 Número inválido de parâmetros

0 Transferido com sucesso

• Exemplos:

Nome do Tag

Expressão

Tag ClassMembersToStrVector ( "Classtag", 5, 3, “Arraytag” )

Tag ClassMembersToStrVector ( "Classtag", 5, 3, “Arraytag” , 0)

Tag ClassMembersToStrVector ( TagName, 0, 1, ArrayName)

Nota: Caso strClassTag tenha mais de um membro, o valor de cada membro será transferido para strArrayTag. Portanto, é importante certificar-se de que o tamanho


InduSoft Web Studio

Página 557

da array strArrayTag seja grande o suficiente para receber todos os valores de strClassTag.

NCopy(strSource, numStartChar, numQtdChar)

Grupo String





• Descrição: Copia uma seção definida de uma string maior.

• Parâmetros:

strSource Tag String contendo a string source.

numStartChar Tag Integer contendo um número correspondente ao primeiro caractere a ser copiado.

numQtdChar Tag Integer contendo o número de caracteres a serem copiados.

• Valores de Retorno: Retorna uma string que seja parte de uma string source (como definido por uma função).

• Exemplos:


Tag Ncopy(“IWS Tag database6.1”, 7, 7) // Valor de retorno = Version

Tag Ncopy(“Technical Reference Manual”, 0, 9) // Valor de retorno = Technical

Nota: O primeiro caractere na string será assinalado como 0.

Num(strValue)

Grupo String





InduSoft Web Studio

Página 558


• Descrição: Converte uma string para real.

• Parâmetros:

StrValue Tag String contendo o número de caracteres a serem convertidos para formato real.

• Valores de Retorno: Retorna o número (formalmente em um formato string) em formato real.

• Exemplos:


Tag Num(“321654.987”) // Valor de retorno = 321654.987

Tag Num(“5.6589626246”) // Valor de retorno = 5.6589626246

Nota: A string real não pode utilizar caracteres diferentes de números (0…9) e um ponto decimal (.) ou o programa retornará o valor 0.0.

Str(numValue)

Grupo String





• Descrição: Converte um número para uma string.

• Parâmetros:

numValue Integer ou tag real contendo um número a ser convertido para uma string.

• Valores de Retorno: Retorna a string, em um formato real.

• Exemplos:


Tag Str(321654.987) // Valor de retorno = “321654.987”

Tag Str(5.65896246) // Valor de retorno = “5.658962”


InduSoft Web Studio

Página 559

Str2Asc(strChar)

Grupo String





• Descrição: Converte um caractere ASCII para seu código ASCII correspondente.

• Parâmetros:

strChar Tag String contendo um caractere ASCII a ser convertido para código ASCII.

• Valores de Retorno: Retorna um valor decimal a ser convertido ao caractere ASCII correspondente inserido.

• Exemplos:


Tag Str2Asc(“C”) // Valor de retorno = 67

Tag Str2Asc(“o”) // Valor de retorno = 111

StrGetElement(strSource, strDelimiter, numElementNumber)

Grupo String





• Descrição: Obtém um elemento específico de uma string source.

• Parâmetros:

strSource Tag String contendo uma string source.

strDelimiter Caractere utilizado como delimitador entre os elementos.

numElementNumber Número do elemento a ser retornado por uma função. O primeiro elemento possui o número 1. O Segundo possui o número 2, e assim por diante.

• Valores de Retorno: Retorna o elemento (Valor da string) entregue a partir de strSource.


InduSoft Web Studio

Página 560

• Exemplos:


Tag StrGetElement(“a|b|c”, “|”, 2) // Valor de retorno = “b”

Tag StrGetElement(“a,b,c”, “,”, 3) // Valor de retorno = “c”

StrLeft(strSource, numQtdChar)

Grupo String





• Descrição: Copia o primeiro caractere de uma string maior.

• Parâmetros:

strSource Tag String contendo uma string source.

numQtdChar Tag Integer contendo o número de caracteres a serem copiados.

• Valores de Retorno: Retorna uma string contendo caracteres à esquerda em uma string source.

• Exemplos:


Tag StrLeft(“IWS Tag database6.1”, 8) // Valor de retorno = IWS v

Tag StrLeft (“Technical Reference Manual”, 9) // Valor de retorno = Technical

StrLen(strSource)

Grupo String





• Descrição: Determina o comprimento da string.


InduSoft Web Studio

Página 561

• Parâmetros:

strSource Tag String contendo a string.

• Valores de Retorno: Retorna um inteiro que é o número de caracteres na string.

• Exemplos:


Tag StrLen(“IWS Tag database6.1”) // Valor de retorno = 18

Tag StrLen(“Technical Reference Manual”) // Valor de retorno = 26

StrLower(strSource)

Grupo String





• Descrição: Converte uma string para caracteres em letra minúscula.

• Parâmetros:

strSource Tag String contendo a string a ser convertida.

• Valores de Retorno: Retorna a string, onde todos os caracteres estão em letra minúscula.

• Exemplos:


Tag StrLower(“IWS Tag database6.1”) // Valor de retorno = “IWS Tag database6.1”

Tag StrLower(“Technical Reference Manual”) // Valor de retorno = “technical reference manual”

StrRChr(strSource, strChrSequence)

Grupo String




InduSoft Web Studio

Página 562



• Descrição: Isola a ocorrência final de uma seqüência de caracteres junto a uma string.

• Parâmetros:

StrSource Tag String contendo a string source.

StrCharSequence Tag String contendo a string de referência.

• Valores de Retorno: Retorna uma string de caracetres seguindo a última ocorrência de um caractere junto a uma string source.

• Exemplos:


Tag StrRChr(“IWS Tag database6.1”, “i”) // Valor de retorno = “ion 5.1”

Tag StrRChr(“Technical Reference Manual”, “a”) // Valor de retorno =”al”

StrRight(strSource, numQtdChar)

Grupo String





• Descrição: Copia o ultimo caractere em uma string maior.

• Parâmetros:

StrSource Tag String contendo a string source.

NumQtdChar Tag Integer contendo o número de caracteres a serem copiados.

• Valores de Retorno: Retorna a string contendo o caractere à direita para a string source.

• Exemplos:


Tag StrRight(“IWS Tag database6.1”, 8) // Valor de retorno = “sion 5.1”

Tag StrRight(“Technical Reference Manual”, 9) // Valor de retorno = “ce Manual”


InduSoft Web Studio

Página 563

StrSetElement(strSource, strDelimiter, numElementNumber, strValue)

Grupo String





• Descrição: Obtém um elemento específico de uma string source.

• Parâmetros:


strDelimiter Caractere utilizado como delimitador entre os elementos.

numElementNumber Número do elemento onde o valor da string será registrado por uma função. O primeiro elemento possui o número 1. O Segundo possui o número 2, e assim por diante.

strValue Valor da string que será registrada a numElementNumber do tag string strSource.

• Valores de Retorno: Retorna o valor da string atualizada a partir de strValue.

• Exemplos:


Tag StrSetElement(StringTag,“|”, 2, “abcd”)

Tag StrSetElement(StringTag,“,”, 3, “defg”)

StrStr(strSource, strCharSequence)

Grupo String





• Descrição: Isola a primeira ocorrência de uma seqüência de caracteres junto a uma string.

• Parâmetros:


strCharSequence Tag String contendo a string de referência.


InduSoft Web Studio

Página 564

• Valores de Retorno: Retorna a string de caracteres seguidos da primeira ocorrência de um caractere junto a uma string source.

• Exemplos:


Tag StrStr(“IWS Tag database6.1”, “i”) // Valor de retorno = “io Version 5.1”

Tag StrStr(“Technical Reference Manual”, “a”) // Valor de retorno =”al Reference Manual”

StrStrPos(strSource, strCharSequence)

Grupo String





• Descrição: Encontra a primeira ocorrência de um caractere junto a uma string.

• Parâmetros:


strCharSequence Tag String contendo a string de referência.

• Valores de Retorno: Retorna um inteiro correspondente a primeira ocorrência de um caractere junto a uma string source.

• Exemplos:


Tag StrStrPos(“IWS Tag database6.1”, “i”) // Valor de retorno = 4

Tag StrStrPos(“Technical Reference Manual”, “a”) // Valor de retorno = 7

Nota: O primeiro caractere na string assinalado com o valor 0.

StrTrim(strReference, numOptFlag)

Grupo String


InduSoft Web Studio

Página 565





• Descrição: Elimina espaços do início e final de uma string

• Parâmetros:

strReference Um Tag String contendo a string source.

numOptFlag Um tag integer opcional.

• If numOptFlag = 0, o IWS remove espaços do início e fim da string.

• If numOptFlag = 1, o IWS remove espaços do início da string. • If numOptFlag = 2, o IWS remove espaços somente do final da

string.

• Valores de Retorno: Retorna uma string igual a strReferance menos os caracteres de espaço especificados.

• Exemplos:


Tag StrTrim(“IWS Tag database6.1 “) // Valor de retorno = “IWS Tag database6.1“

Tag StrTrim(“IWS Tag database6.1 “, 0) // Valor de retorno = “IWS Tag database6.1“

Tag StrTrim(“IWS Tag database6.1 “, 1) // Valor de retorno = “IWS Tag database6.1 “

Tag StrTrim(“IWS Tag database6.1 “, 2) // Valor de retorno = “IWS Tag database6.1“

StrTrimAll(strReference, strOptTrimChar)

Grupo String





• Descrição: Elimina um caractere específico de uma string inteira.


InduSoft Web Studio

Página 566

• Parâmetros:

strReference Um Tag String contendo a string source.

strOptTrimChar Caractere que será removido da string. Caso o parâmetro seja omitido, o caractere espaço será removido da string por padrão.

• Valores de Retorno: Retorna uma string igual a strReferance menos os caracteres removidos por uma função.

• Exemplos:


Tag StrTrimAll(“IWS Tag database6.1 “,””) // Valor de retorno = “IWS Tag database6.1“

Tag StrTrimAll(“IWS Tag database6.1 “,” “.””) // Valor de retorno = “IWS Tag database6.1“

StrUpper(strSource)

Grupo String





• Descrição: Converte uma string para caracteres em letras minúsculas.

• Parâmetros:

strSource Tag String contendo a string.

• Valores de Retorno: Retorna a string com todos os caracteres em letra maiúscula.

• Exemplos:


Tag StrUpper(“IWS Tag database6.1”) // Valor de retorno = “IWS Tag database6.1”

Tag StrUpper(“Technical Reference Manual”) // Valor de retorno = “TECHNICAL REFERENCE MANUAL”


InduSoft Web Studio

Página 567

ValueToChar(“tagArray”, numChars)

Grupo String





• Descrição: Converte uma string para um array de valores inteiros (utilizando bytes).

• Parâmetros:

“tagArray” Nome do tag array contendo os valores ineiros de caracteres a serem convertidos.

NumChars Tag Integer contendo o número de caracteres a serem convertidos.

• Valores de Retorno: Retorna uma string com caracteres definidos por valores nos tags array.

• Exemplos:


Tag ValueToChar(“Array”, 3) // If Array[0] = 65, Array[1] = 66, e Array[2] = 67 o valor de retorno será “ABC”

Tag ValueToChar(“Array[10]”, 3) // If Array[10] = 65, Array[11] = 66, and Array[12] = 67 o valor de retorno será “ABC”

Nota: Não é possível utilizar essa função para caracteres UNICODE, pois esse converte somente os bytes de caracteres UNICODE.

ValueWToChar(“tagArray”, numChars)

Grupo String





• Descrição: Converte uma string para um array de valores inteiros (utilizando palavras).


InduSoft Web Studio

Página 568

• Parâmetros:

“tagArray” Nome do tag array contendo valores interios de caracteres a serem convertidos.

numChars Tag Integer contendo o número de caracteres a serem convertidos.

• Valores de Retorno: Retorna uma string com caracteres definidos por valores em tag arrays.

• Exemplos:


Tag ValueWToChar(“Array”, 3) // If Array[0] = 29779, Array[1] = 25717, and Array[2] = 28521 o valor de retorno será “ IWS”

Nota: Essa função poderá ser especialmente útil ao converter caracteres UNICODE para códigos.


InduSoft Web Studio

Página 569

Funções Data e Hora Essa seção descreve as seguintes funções Data e Hora do InduSoft Web Studio:

• ClockGetDate(numSeconds)

• ClockGetDayOfTheWeek(numSeconds)

• ClockGetTime(numSeconds)

• DateTime2Clock(strDate, strTime)

• GetClock()

• Hour2Clock(strTime)

• SetsystemDate(strDate)

• SetSystemTime(strTime)

ClockGetDate(numSeconds)

Grupo Data e Hora





• Descrição: Calcula a data, baseando-se em quantos segundos se passaram desde as 19:00:00 EST 12/31/1969 (colocando na conta a zona de tempo atual do computador).

• Parâmetros:

numSeconds Tag Integer contendo o número de segundos passados desde 19:00:00 ETS 12/31/1969.

• Valores de Retorno: Retorna a data calculada em formato string.

• Exemplos:


Tag ClockGetDate(0)// Caso computador esteja em zona de hora central. Valor de retorno = 12/31/1969

Tag ClockGetDate(1018886359) // Caso computador esteja em zona de hora central. Valor de retorno = 04/15/2002

Nota: Essa função faz a contagem na Zona de Tempo especificada no Control Panel do computador local.


InduSoft Web Studio

Página 570

ClockGetDayOfTheWeek(numSeconds)

Grupo Data e Hora





• Descrição: Calcula o dia da semana, baseando-se em quantos segundos se passaram desde as 19:00:00 EST 12/31/1969 (contando a partir da Zona de Tempo atual do computador local).

• Parâmetros:

numSeconds Tag Integer contendo o número de segundos passados desde as 19:00:00 ETS 12/31/1969

• Valores de Retorno: Retorna o dia da semana (calculado em formato inteiro) como se segue:

0 = Sunday

1 = Monday

2 = Tuesday

3 = Wednesday

4 = Thursday

5 = Friday

6 = Saturday

• Exemplos:


Tag ClockGetDayOftheWeek(0)// Caso o computador esteja na zona de tempo Central. Valor de retorno = 3

Tag ClockGetDate(1018886359) // Caso o computador esteja na zona de tempo Central. Valor de retorno = 1



InduSoft Web Studio

Página 571

ClockGetTime(numSeconds)

Grupo Data e Hora





• Descrição: Calcula a hora, baseando-se em quantos segundos se passaram desde as 19:00:00 EST 12/31/1969 (colocando na conta a zona de tempo atual do computador).

• Parâmetros:

NumSeconds Tag Integer contendo o número de segundos passados desde as 19:00:00 ETS 12/31/1969.

• Valores de Retorno: Retorna a hora calculada em formato string.

• Exemplos:


Tag ClockGetTime(0) // Caso o computador esteja na zona de tempo Central. Valor de retorno = 18:00:00

Tag ClockGetTime(1018886359) // Caso o computador esteja na zona de tempo Central. Valor de retorno = 10:59:19


Dica: Para converter o número de segundos estritamente em formato HH:MM:SS, você deverá utilizar a função Format() ao invés da função ClockGetTime().

DateTime2Clock(strDate, strTime)

Grupo Data e Hora




InduSoft Web Studio

Página 572



• Descrição: Calcula quantos segundos se passaram desde as 19:00:00 EST 12/31/1969 (colocando na conta a zona de tempo atual do computador).

• Parâmetros:

StrDate Tag String contendo a data a ser utilizada no cálculo.

StrTime Tag String contendo a hora a ser utilizada no cálculo.

• Valores de Retorno: Calcula quantos segundos se passaram desde as 19:00:00 EST 12/31/1969 (colocando na conta a zona de tempo atual do computador).

• Exemplos:


Tag DateTime2Clock (“12/31/1969”, “18:00:00”) // Caso o computador esteja na zona de tempo Central. Valor de retorno = 0

Tag DateTime2Clock (“04/15/2002”, “10:59:19”) // Caso o computador esteja na zona de tempo Central. Valor de retorno = 01018886359


GetClock()

Grupo Data e Hora





• Descrição: Calcula quantos segundos se passaram desde as 19:00:00 EST 12/31/1969 no momento em que a função rodou (colocando na conta a zona de tempo atual do computador).

• Valores de Retorno: Retorna o número de segundos que se passaram desde 19:00:00 EST 12/31/1969 no momento em que a função rodou.


InduSoft Web Studio

Página 573

• Exemplos:

Nome do Tag

Expressão

Tag GetClock() // Se executado às 10:59:19 AM April 15th 2002 CST. Valor de retorno = 101886359

Tag GetClock() // Se executado às 00:00:00 January 1st 1970 GMT. Valor de retorno = 0


Hour2Clock(strTime)

Grupo Data e Hora





• Descrição: Converte a hora do formato HH:MM:SS em segundos.

• Parâmetros:

strTime Tag String contendo o número de horas, minutos e segundos em formato HH:MM:SS.

• Valores de Retorno: Retorna o número de segundos equivalentes ao total de horas, minutos e segundos especificados.

• Exemplos:


Tag Hour2Clock(“01:00:00”) // Valor de retorno = 3600

Tag Hour2Clock(“10:01:01”) // Valor de retorno = 36061

SetsystemDate(strDate)

Grupo Data e Hora



InduSoft Web Studio

Página 574




• Descrição: Configura a data no relógio do Sistema Operacional.

• Parâmetros:

strDate Tag String contendo a data em formato MM/DD/YYYY no qual será configurado o relógio.

• Valores de Retorno: Não retorna valores.

• Exemplos:


SetSystemDate(“04/15/2002”) // Configura o relógio do sistema para April 15th 2002.

SetSystemTime(strTime)

Grupo Data e Hora





• Descrição: Configura a hora no relógio do Sistema Operacional.

• Parâmetros:

strTime Tag String contendo a hora em formato HH:MM:SS no qual o relógio será configurado.

• Valores de Retorno: Sem valor de retorno.

• Exemplos:


SetSystemTime(“15:45:18”) // Configura o relógio do sistema 3:45:18 PM.


InduSoft Web Studio

Página 575

Funções Trigonométricas Essa seção descreve as seguintes funções trigonoméricas do InduSoft Web Studio:

• ACos(numValue)

• ASin(numValue)

• ATan(numValue)

• Cos(numAngle)

• Cot(numAngle)

• Pi()

• Sin(numAngle)

• Tan(numAngle)

ACos(numValue)

Grupo Trigonométrica





• Descrição: Calcula o Arco Cosseno de um valor.

• Parâmetros:

NumValue Tag numérico do qual Arco Cosseno será pego.

• Valores de Retorno: Retorna Arco Cosseno de numValue em radianos.

• Exemplos:


Tag ACos(1) // Valor de retorno = 0.000000

Tag ACos(0) // Valor de retorno = 1.570796

ASin(numValue)







InduSoft Web Studio

Página 576

• Descrição: Calcula Arco Seno de um valor.

• Parâmetros:

NumValue Tag numérico, do qual Arco Seno é retirado.

• Valores de Retorno: Retorna Arco Seno de numValue em radianos.

• Exemplos:


Tag ASin(1) // Valor de retorno = 1.570796

Tag ASin(0) // Valor de retorno = 0.000000

ATan(numValue)






• Descrição: Calcula o Arco Tangente de um valor.

• Parâmetros:

NumValue Tag numérico, do qual o Arco Tangente será retirado.

• Valores de Retorno: Retorna o Arco Tangente de numValue em radianos.

• Exemplos:


Tag ATan(1) // Valor de retorno = 0.785398

Tag ATan(0) // Valor de retorno = 1.570796

Cos(numAngle)





InduSoft Web Studio

Página 577



• Descrição: Calcula o Cosseno de um valor.

• Parâmetros:

NumAngle Tag numérico contendo o ângulo (em radianos) do qual calcular o Cosseno.

• Valores de Retorno: Retorna o Cosseno de numAngle.

• Exemplos:


Tag Cos(1.570796) // Valor de retorno = 0.000000

Tag Cos(0) // Valor de retorno = 1.000000

Cot(numAngle)






• Descrição: Calcula a Cotangente de um valor.

• Parâmetros:

NumAngle Tag numérico contendo o Ângulo (em radianos) do qual calcular a Cotangente.

• Valores de Retorno: Retorna a Cotangente de numAngle.

• Exemplos:


Tag Cot(0.785398) // Valor de retorno = 1.000000

Tag Cot(0) // Valor de retorno = 0.00000


InduSoft Web Studio

Página 578

Nota: Embora, matematicamente, a tangente de Pi seja infinita, o IWS retorna somente o maior número possível.

Pi()






• Descrição: Calcula Pi.

• Valores de Retorno: Retorna Pi.

• Exemplos:


Tag Pi() // Valor de retorno = 3.141593

Nota: Mesmo que a função Pi() não tenha argumentos, você deverá incluir os parênteses, ou o IWS procurará por um Nome do Tag Pi.

Sin(numAngle)






• Descrição: Calcula o Seno de um valor.

• Parâmetros:

NumAngle Tag numérico contendo o Ângulo (em radianos) do qual calcular o Seno.

• Valores de Retorno: Retorna o Seno de numAngle.


InduSoft Web Studio

Página 579

• Exemplos:


Tag Sin(0) // Valor de retorno = 0.000000

Tag Sin(1.570796) // Valor de retorno = 1.000000

Tan(numAngle)






• Descrição: Calcula a Tangente de um valor.

• Parâmetros:

NumAngle Tag numérico contendo o Ângulo (em radianos) do qual calcular a Tangente.

• Valores de Retorno: Retorna a Tangente de numAngle.

• Exemplos:


Tag Tan(0) // Valor de retorno = 0.00000

Tag Tan(0.785398) // Valor de retorno = 1.00000

Nota: Embora, matematicamente, a Tangente de ½ Pi seja infinita, o IWS retorna somente o maior número possível.


InduSoft Web Studio

Página 580

Abrindo e Fechando Janelas Essa seção descreve as seguintes funções de Tela do InduSoft Web Studio :

• Close(strScreen)

• Open(strScreen, optnumX1 , optnumY1 , optnumX2 , optnumY2)

• OpenPrevious(numOptionalX1 , numOptionalY1 , numOptionalX2 , numOptionalY2)

CloIf(strScreen)

Grupo Abrindo e Fechando Janelas

Execução Assíncrona




• Descrição: Fecha uma tela aberta.

• Parâmetros:

strScreen Tag String contendo o nome do tag screen a ser fechado.

• Valores de Retorno: Sem valores de retorno.

• Exemplos:


Close(“main”)

Close(“alarms”)

Atenção: Ao abrir uma tela utilizando Replace style, as telas fecham-se automaticamente com atributos Replace e/ou Popup que são sobrepostos pela nova tela. Nesse caso, não é necessário chamar a função CLOSE(strScreen).

Open(strScreen, optnumX1, optnumY1, optnumX2, optnumY2)






InduSoft Web Studio

Página 581


• Descrição: Abre a tela especificada.

• Parâmetros:

strScreen Tag String contendo o nome do tag screen a ser aberto.

optnumX1 Tag Integer opcional contém a coordenada X para o canto superior esquerdo da tela em pixels.

optnumY1 Tag Integer opcional contém a coordenada Y para o canto superior esquerdo da tela em pixels.


optnumY2 Tag Integer opcional contém a coordenada X para o canto inferior direito da tela em pixels.


0 Função executada com sucesso.

1 Função não foi executada com sucesso.

• Exemplos:


Tag Open(“main”)

Tag Open(“alarm”, 50, 50, 690, 530)

Atenção: Alguns Servers da Web são sensíveis a letras maiúsculas e minúsculas. Caso você planejar converter suas telas para formato HTML, você deverá utilizar somente letras minúsculas para o nome da tela.

OpenPrevious(numOptionalX1 , numOptionalY1 , numOptionalX2 , numOptionalY2 )






• Descrição: Reabre a última tela que foi fechada.


InduSoft Web Studio

Página 582

• Parâmetros:






0 Função não foi executada com sucesso

1 Função executada com sucesso

• Exemplos:


OpenPrevious()

OpenPrevious0,0,800,600()


InduSoft Web Studio

Página 583

Funções de Segurança Essa seção descreve as seguintes funções de Segurança do InduSoft Web Studio:

• BlockUser(strUserName)

• CreateUser(strUserName, strGrupoName, strPassword)

• GetUserNames (strUsers , nUserType , strGrupos)

• GetUserState(strUserName)

• RemoveUser(strUserName)

• SetPassword(strUserName, strOptionalNewPassword)

• UnblockUser(strUserName)

BlockUser(strUserName)

Grupo Segurança





• Descrição: Utilizado para bloquear um usuário existente do Sistema de Segurança.

• Parâmetros:

StrUserName Tag String contendo o nome do tag user a ser bloqueado.


0 Usuário bloqueado com sucesso

1 Número inválido de parâmetros

2 Tipo errado de parâmetro

3 Usuário não existe

4 Não é possível registrar os dados com sucesso

• Exemplos:


Tag BlockUser(“Bob”)

Tag BlockUser(“Albert”)


InduSoft Web Studio

Página 584

Nota: Não é possível utilizar essa função para criar um nome do usuário que já está sendo utilizado na Aplicação. Usuário criados com essa função não estão exibidos na pasta Security no ambiente de desenvolvimento, pois estão armazenados em um banco de dados secundário.

Dica: Pode-se utilizar o programa ExtUser.exe (localizado na pasta Bin) para gerenciar os usuários nesse banco de dados secundário.

CreateUser(strUserName, strGrupoName, strPassword, strOptUserFullName)

Grupo Segurança





• Descrição: Cria um novo usuário.

• Parâmetros:

StrUserName Tag String contendo o nome do tag do usuário a ser criado.

StrGrupoName Tag String contendo o nome do tag Grupo ao qual o usuário pertencerá.

StrPassword Tag String contendo uma senha a ser configurada.

StrOptUserFullName Tag String contendo o nome completo do usuário. Esse parâmetro é opcional.


0 Novo usuário criado com sucesso


2 Tipo errado de parâmetros

3 Usuário já existe

4 Grupo não existe

5 Não é possível registrar os dados com segurança

6 Não é possível utilizar a função CreateUser()


InduSoft Web Studio

Página 585

• Exemplos:


Tag CreateUser(“Bob”, “Admin”, “Chocolate”)

Tag CreateUser(“Albert”, “Engineering”, “EMC2”)

Nota: Não é possível utilizar essa função para criar um nome de usuário que já esteja sendo utilizado na Aplicação. Usuários criados com essa função não são exibidos na pasta Security do ambiente de desenvolvimento, pois estão armazenados em um banco de dados secundários.

Dica: Pode-se utilizar o programa ExtUser.exe (localizado na pasta Bin) para gerenciar os usuários nesse banco de dados secundário.

GetUserState(strUserName)

Grupo Segurança





• Descrição: Utilize para visuzalizar o status atual de um usuário selecionado.

• Parâmetros:

StrUserName Tag String contendo o nome do tag do usuário.


0 Usuário está desbloqueado

1 Usuário está bloqueado


4 Não é possível registrar dados com segurança


InduSoft Web Studio

Página 586

• Exemplos:


Tag GetUserState(“Bob”)

Tag GetUserState(“Albert”)

GetUserNames ( “tagUsers” , optnumUserType , “opttagGrupos” )

Grupo Segurança





• Descrição:

• Parâmetros:

“tagUsers” Nome do tag array que receberá usuários

optnumUserType 0- Retorna todos os usuários

1- Somente usuários criados durante o run-time

2- Somente usuários criados com a utilização do ambiente de desenvolvimento

“opttagGrupos” Nome do tag array que receberá o Grupo para cada usuário específico

• Valores de Retorno: Número de usuários ou um número negativo que pode ser um dos seguintes:


-2 “tagUsers” está inválido

-3 optnumUserType está inválido

-4 opttagGrupos está inválido

-5 Erro, função não pode ser chamada no web thin client

Natural number set: Número de usuários

• Exemplos:


NumberOfUsers GetUserNames("UsersArray") //Entrega usuários, armazena seus nomes no tag UsersArray tag e o Número de usuários no tag


InduSoft Web Studio

Página 587

NumberOfUsers.

NumberOfUsers GetUserNames("UsersArray", 1) //Entrega todos os usuários criados durante o run-time, armazena seus nomes no tag UsersArray tag e o Número de usuários no tag NumberOfUsers.

NumberOfUsers GetUserNames("UsersArray", 2) // Entrega todos os usuários criados durante o run-time, armazena seus nomes no tag UsersArray tag e o Número de usuários no tag NumberOfUsers.

NumberOfUsers GetUserNames("UsersArray", 2, “Grupos”) //Entrega todos os usuários criados no ambiente de desenvolvimento, armazena seus nomes no tag UsersArray e o Número de usuários no tag NumberOfUsers. O nome do grupo por usuário é armazenado no tag Groups.

RemoveUser(strUserName)

Grupo Segurança





• Descrição: Remove um usuário do sistema.

• Parâmetros:

StrUserName Tag String contendo o nome do tag user a ser removido.


0 Usuário removido com sucesso





• Exemplos:


Tag RemoveUser(“Bob”)

Tag RemoveUser(“Albert”)


InduSoft Web Studio

Página 588

Nota: Pode-se utilizar essa função para remover somente aqueles usuários criados com a utilização da função CreateUser().

SetPassword(strUserName, strOpcionalNewPassword)

Grupo Segurança





• Descrição: Utilize para especificar uma nova senha de usuário.

• Parâmetros:

StrUserName Tag String contendo o nome do tag user.

StrOpcionalNewPassword Tag opcional String contendo a nova senha.


0 A nova senha já está configurada

1 Usuário está bloqueado



5 Operação foi cancelada

• Exemplos:


Tag SetPassword(“Bob”)

Tag SetPassword(“Albert,” “anemarie”)

Nota: Caso você omitir o parâmetro strOpcionalNewPassword, a função SetPassword() iniciará um diálogo Insert a new password,de forma que o usuário possa configurar uma nova senha.


InduSoft Web Studio

Página 589

UnblockUser(strUserName)

Grupo Segurança





• Descrição: Utilize para desbloquear um usuário bloqueado no sistema.

• Parâmetros:

StrUserName Tag String contendo o nome do tag user a ser desbloqueado.


0 Usuário desbloqueado com sucesso





• Exemplos:


Tag UnblockUser(“Bob”)

Tag UnblockUser(“Albert”)


InduSoft Web Studio

Página 590

Funções do Módulo Atividade Essa seção descreve as seguintes funções Atividade do InduSoft Web Studio:

• AppActivate(strAppTitle, optnumActiv)

• AppIsRodando(strAppTitle)

• AppPostMessage(strAppTitle, numwParam, numlParam)

• AppSendKeys(strKeys1, strKeys2, ..., strKeysN)

• CleanReadQueue()

• CloseSplashWindow()

• EndTask(strTask)

• ExitWindows(numExitCódigo)

• IsScreenOpen(strScreen)

• IsTaskRodando(strTask)

• IsViewerInFocus()

• KeyPad(“TagName”)

• LogOff( )

• Logon(optstrUser, optstrPassword)

• Math(numWorksheet)

• PostKey(numKeydownOrKeyup, numwParam, numlParam)

• Recipe(strFunction)

• Report( “strFunction” , optnumOrientation)

• SendKeyObject(numEvent, strMainKey, optnumShift, optnumCtrl, optnumAlt, optstrTargetScreen)

• SetAppPath(strPath)

• SetKeyboardLanguage(strLanguage)

• SetViewerInFocus()

• SetViewerPos(numLeft, numTop, optnumWidth, optnumHeight)

• ShutDown()

• StartTask(strTask)

• ViewerPostMessage(strScrTitle, numwParam, numlParam)

• Wait(numMillisec)

• WinExec(strCommand, optnumState)

• WinExecIsRunning(numHandle, “stroptReturn”)

AppActivate(strAppTitle, optnumActiv)

Grupo Módulo Atividade






InduSoft Web Studio

Página 591

• Descrição: Ativa uma aplicação já aberta.

• Parâmetros:

StrAppTitle Tag String contendo o nome do tag da Aplicação a ser ativado.

OptnumActive Tag opcional Integer contendo o integer que corresponde a uma opção de ativação. Veja a documentação do Windows para mais detalhes sobre essas opções.

• 0 = SW_HIDE • 1 = SW_SHOWNORMAL • 2 = SW_SHOWMINIMIZED • 3 = SW_SHOWMAXIMIZED • 4 = SW_SHOWNOACTIVATE • 5 = SW_SHOW • 6 = SW_MINIMIZE • 7 = SW_SHOWMINNOACTIVATE • 8 = SW_SHOWNA • 9 = SW_RESTORE (Default)


• Exemplos:


AppActivate(“Microsoft Word – test.doc”, 5)

AppIsRodando(strAppTitle)






• Descrição: Verifica se uma aplicação está aberta e rodando.

• Parâmetros:

strAppTitle Tag String contendo o nome do tag Aplicação.


1 Aplicação está rodando.

0 Aplicação não está rodando.


InduSoft Web Studio

Página 592

• Exemplos:


Tag AppIsRunning(“Microsoft Word – test.doc”)

AppPostMessage(strAppTitle, numwParam, numlParam)






• Descrição: Manda uma mensagem para a aplicação ativa.

• Parâmetros:

strAppTitle Tag String contendo o nome do tag da aplicação.

numwParam Tag Integer contendo um integer correspondendo a mensagem do Windows wParam

numlParam Tag Integer contendo um integer correspondendo a mensagem do Windows lParam


• Exemplos:


Tag AppPostMessage(“Microsoft Word – test.doc”, 3, 1)

AppSendKeys(strKeys1, strKeys2, ..., strKeysN)






• Descrição: Envia comandos de teclado para a aplicação ativa.

• Parâmetros:


InduSoft Web Studio

Página 593

StrKeys (1-N) Tags String contendo os comandos de teclado a serem utilizados.


• Exemplos:


AppSendKeys(“S”, ”t”, ”u”, ”d”, ”i”, “o”, “<INSIRA>”)

AppSendKeys(“<Alt>F”)

Nota: Pode-se especificae <ALT>, <CTRL>, ou <SHIFT> no texto para enviar um código igual aos comandos de teclado Alt, Ctrl, ou Shift. Para enviar o caractere < especifique << no texto.

CleanReadQueue()






• Descrição: Remove todas as atividades de leitura do módulo de comunicação.


• Exemplos:


CleanReadQueue()

Nota: Você não poderá utilizar essa função em novas aplicações, embora esta função ainda seja válida para aplicações construídas em versões mais recentes do InduSoft Web Studio.


InduSoft Web Studio

Página 594

CloseSplashWindow()






• Descrição: Fecha a tela de som (splash) do IWS.


• Exemplos:


CloseSplashWindow()

EndTask(strTask)






• Descrição: Pára o módulo do IWS que esteja rodando atualmente.

• Parâmetros:

strTask Tag String contendo o nome do tag task para parar (deverá ser um dos seguintes):

• BGTASK: Background Tasks • VIEWER: Viewer • DBSPY: Database Spy • LOGWIN: LogWin • DRIVER <DriverName>: Driver • UNIDDECL: DDE client • UNINDDE: DDE server • UNIODBC: ODBC • TCPSERVER: TCP/IP Server • TCPCLIENT: TCP/IP Client • OPCCLIENT: OPC



InduSoft Web Studio

Página 595

• Exemplos:


EndTask(“Viewer”)

Nota: Para fechar um driver, você deverá utilizar os formatos de Sintaxe que se seguem: EndTask(“Driver<DriverName>”)

Onde <DriverName> é o nome do arquivo driver do tag .dll. Por exemplo,

EndTask(“DriverMODBU”)

ExitWindows(numExitCódigo)






• Descrição: Fecha a janela de um modo específico.

• Parâmetros:

numExitCódigo Tag Integer contendo um número (0–2) especificando como sair das Janelas.

• 0 = Reiniciar Windows • 1 = Efetuar Log Off Windows • 2 = Desligar Windows


• Exemplos:


ExitWindows(1)


InduSoft Web Studio

Página 596

IsScreenOpen(strScreen)






• Descrição: Verifica se uma tela está aberta.

• Parâmetros:

strScreen Tag String contendo o nome do tag screen a ser verificado.


0 Tela não está aberta.

1 Tela está aberta.

• Exemplos:


Tag IsScreenOpen(“main”)

IsTaskRodando(strTask)






• Descrição: Verifica se a tarefa está rodando.

• Parâmetros:

strTask Tag String contendo o nome do tag task a ser verificado.


0 Tarefa não está rodando.

1 Tarefa está rodando.


InduSoft Web Studio

Página 597

• Exemplos:


Tag IsTaskRunning(“viewer”)

IsViewerInFocus()






• Descrição: Verifica se o módulo Viewer está em foco na tela.


0 Viewer não está em foco.

1 Viewer está em foco.

• Exemplos:


Tag IsViewerInFocus()

KeyPad(“TagName”)






• Descrição: Abre um diálogo Keypad para registro ao tag especificado.

• Parâmetros:

“TagName” O nome do tag ao qual o Keypad será registrado.


InduSoft Web Studio

Página 598


0 Sucesso

1 Usuário pressionou ESC para fechar keypad


• Exemplos:


Tag KeyPad(“tagA”)

LogOff( )






• Descrição: Efetua log off do usuário atual e loga o usuário guest.


• Exemplos:


LogOff()

Logon(optstrUser, optstrPassword)






• Descrição: Loga um usuário especificado utilizando a senha especificada. Caso não seja fornecido o usuário, um diálogo logon abrirá.


InduSoft Web Studio

Página 599

• Parâmetros:

optstrUser Tag opcional String contendo o nome do tag User a ser logado.

optstrPassword Tag opcional String contendo a senha do usuário a efetuar log on.


• Exemplos:


Logon()

Logon(“Albert”, “EMC2”)

Math(numWorksheet)






• Descrição: Executa uma planilha math especificada.

• Parâmetros:

numWorksheet Tag numérico contendo o número de planilhas math a serem especificadas.


• Exemplos:


Math(6)

Atenção: Rodar uma planilha math de dentro de outro módulo causará uma pausa no módulo até que a planilha math seja finalizada. Conseqüentemente, essa função deverá ser utilizada somente quando absolutamente necessário, para evitar o decréscimo na execução de outros módulos.


InduSoft Web Studio

Página 600

PostKey(numKeydownOrKeyup, numwParam, numlParam)






• Descrição: Envia teclas para a visualização da tela.

• Parâmetros:

numKeydownOrKeyup Tag numérico contendo um 0 (para indicar um evento Key down) ou 1 (para indicar um evento Key up).

numwParam Tag numérico contendo key Code a ser enviado.

numlParam Tag numérico contendo mensagem lParam.


• Exemplos:


PostKey(0, 0x24, 0)

Recipe(strFunction)






• Descrição: Ativa uma função Recipe especificada.

• Parâmetros:


InduSoft Web Studio

Página 601

strFunction String tag especificando a operação a ser executada e a folha da receita a ser utilizada no formato [Operation]:[Recipe sheet].

Operações: • Save: Salva dados para um arquivo de dados. • Load: Grava dados de um arquivo de dados. • Delete: Deleta um arquivo de dados. • Init: Inicializa um arquivo de dados com um valor de 0 em todos

os tags.


0 Sem Erro

1 Caso tag seja numérico

2 Expressão não pode conter “:”

3 Comando anterior para “:” inválido

4 Tarefa não encontrada pelo sistema

5 Erro no disco

• Exemplos:


Tag Recipe(“Save:Recipe1”)

Tag Recipe(“Load:Recipe5”)

Atenção: Deve-se estar rodando Background Task (tab Execution Tasks na janela Project Status) para executar as Funções de receita.

Report( “strFunction” , optnumOrientation)






• Descrição: Salva um relatório em disco ou envia-o para a impressora.

• Parâmetros:


InduSoft Web Studio

Página 602

“strFunction” String especificando a operação a ser executada e a folha de relatório a ser utilizada na sintaxe de formato “[Operation]:[Report worksheet] onde:

[Operation]: • Disk: Salva dados para o arquivo de dados. • Prn: Imprime dados diretamente para a impressora. [Report worksheet]: Nome do relatório que deve ser salvo ao disco ou enviado para a impressora (o nome do arquivo de relatório deve incluir a extensão .REP).

optnumOrientation

Configura a orientação do papel, como se segue:

0 (padrão) = Porta-retrato

1 = Paisagem

Essa configuração é ignorada quando a Operação configurada no parâmetro “strFunction”é diferente de Prn.

Nota: O parâmetro optnumOrientation Não é suportado ao rodar a aplicação sob sistema operacional Windows CE.


0 Sucesso

1 “strFunction” é configurado com um valor numérico (inválido)

2 Expressão não pode conter “:” (inválido)

3 Comando anterior ao “:” inválido

4 Tarefa não encontrada pelo sistema (Tarefa BG não está rodando)

5 Erro no disco (disco cheio, arquivo read-only não pode ser sobrescrito ou caminho inválido)

• Exemplos:


Report(“Disk:Report1.rep”)

Report(“Prn:Report2.rep”)

Report(“Prn:Report3.rep”, 1)

Atenção: Relatórios em formato RTF não são suportados sob Sistema Operacional Windows CE.


InduSoft Web Studio

Página 603

Dica: Task (Tarefa Background) deverá estar rodando de modo a executar essa função. Do contrário, a operação não será executada e a função retornará o valor 4, indicando Erro.

SendKeyObject(numEvent, strMainKey, optnumShift, optnumCtrl, optnumAlt, optstrTargetScreen)






• Descrição: Envia key codes para objetos nas telas abertas. Pode-se disparar dinâmicas "Command" a partir desses objetos utilizando-se essa função.

• Parâmetros:

numEvent Tag numérico especificando o evento do código da tecla, como se segue:

• 0: On Down • 1: While Down • 2: On Up

Tag String contendo a tecla a ser enviada ao objeto. Os seguintes tags são aceitos:

strMainKey

• "F1" ... "F20" • "+ " • "-" • "/" • "*" • "HOME" • "END" • "INSERT" • "DELETE" • "DOWN"

• "UP" • "LEFT" • "RIGHT" • "PAGEUP" • "PAGEDOWN" • "SPACE" • "RETURN" • "BACKSPACE" • "ESCAPE" • "A" ... "Z"

optnumShift Tag numérico Opcional, indicando se deverá ser enviado para Shift.

optnumCtrl Tag numérico Opcional, indicando se deverá ser enviado para Ctrl.

optnumAlt Tag numérico Opcional, indicando se deverá ser enviado para Alt.

optstrTargetScreen Tag String Opcional contendo a tela a receber o key Code.



InduSoft Web Studio

Página 604

• Exemplos:


SendKeyObject(0, “R”, 1, 0, 0, “main”)

Notas: numEvent define como uma função executa Expressões especificadas para On Down, On While, ou On Up da dinâmica Command do objeto.

O evento On While requer atenção especial. Cada vez que a função SendKeyObject() é executada, o IWS executa as Expressões configuradas para a folha On While (a partir da dinâmica Command do objeto) apenas uma vez.

Os parâmetros numShift, numCtrl, numAlt, e strTargetScreen são opcionais; porém, caso você configurar um deles, os outros também deverão ser configurados.

SetAppPath(strPath)






• Descrição: Configura o novo caminho da Aplicação. Após ser executada, o IWS procura por todos os arquivos de configuração (screens, alarms, trends, database, events) nesse novo caminho.

• Parâmetros:

StrPath Tag String contendo o caminho do arquivo.


0 Falha na configuração do caminho.

1 Sucesso na configuração do caminho.

• Exemplos:


SetAppPath(“C:\ InduSoft Web Studio\”)


InduSoft Web Studio

Página 605

Nota: Caso o computador esteja em rede de trabalho, pode-se utilizar a sintaxe //<IP address ou host name>/<Path> para definir o local de um outro modo na rede de trabalho.

SetKeyboardLanguage(strLanguage)






• Descrição: Utilize essa função para configurar o idioma dos Virtual Keyboards.

• Parâmetros:

StrLanguage Tag String com o idioma utilizado para virtual keyboards. As opções disponíveis atualmente são: “EN” (English, default), and “GE” (German).


0 Sucesso

1 Erro

• Exemplos:


Tag SetKeyboardLanguage(“EN”)

Tag SetKeyboardLanguage(TagLanguage)

SetViewerInFocus()






• Descrição: Configura o foco para a tarefa Viewer.


InduSoft Web Studio

Página 606


• Exemplos:


SetViewerInFocus()

SetViewerPos(numLeft, numTop, optnumWidth, optnumHeight)






• Descrição: Configura altura, comprimento e posição do Viewer.

• Parâmetros:

NumLeft Tag numérico especificando a posição no lado esquerdo do Viewer em pixels.

NumTop Tag numérico especificando a posição do lado de cima do Viewer em pixels.

OptnumWidth Tag numérico Opcional especificando a largura do Viewer em pixels.

OptnumHeight Tag numérico Opcional contendo a altura do Viewer em pixels.


0 Erro

1 Sucesso

• Exemplos:


Tag SetViewerPos(50, 50, 640, 480)

Nota: Ao omitir os parâmetros opcionais (numWidth e numHeight), o IWS obtém o tamanho da janela do Viewer a partir da resolução da aplicação.


InduSoft Web Studio

Página 607

ShutDown()






• Descrição: Desliga todos os módulos ativos da aplicação.


• Exemplos:


ShutDown()

Atenção: Ess função não fecha o ambiente de desenvolvimento, Database Spy, ou LogWin.

StartTask(strTask)






• Descrição: Inicia um módulo do IWS que não está rodando atualmente.


InduSoft Web Studio

Página 608

• Parâmetros:

StrTask Tag String contendo o nome do tag task para iniciar (deve ser uma das seguintes tarefas):

• BGTASK: Background Tasks • VIEWER: Viewer • DBSPY: Database Spy • LOGWIN: LogWin • DRIVER: Driver • UNIDDECL: DDE Client • UNINDDE: DDE Server • UNIODBC: ODBC • TCPSERVER: TCP/IP Server • TCPCLIENT: TCP/IP Client • OPCCLIENT: OPC


• Exemplos:


EndTask(“Viewer”)

Nota: A função StartTask(“Driver”) inicia todos os drivers configurados na aplicação.

Para iniciar um driver específico, você deverá utilizar a função Winexec(). Por exemplo,

Winexec(“<IWS path>\BIN\Studio Manager.exe”+” “+”<IWS Path>

\Bin\Driver.dll”+” “+”<DriverName>”)


InduSoft Web Studio

Página 609

ViewerPostMessage(strScrTitle, numwParam, numlParam)






• Descrição: Envia uma mensagem interna para o Viewer.

• Parâmetros:

strScrTitle Tag String contendo o nome do tag screen para o qual a mensagem será enviada.

numwParam Tag numérico contendo wParam da mensagem do Windows.

numlParam Tag numérico contendo lParam da mensagem do Windows.


• Exemplos:


ViewerPostMessage(“main”, 3, 1)

Wait(numMillisec)






• Descrição: Interrompe a execução da planilha math por um número especificado de milissegundos.

• Parâmetros:

NumMillisec Tag Integer contendo o número de milissegundos a esperar.


• Exemplos:


InduSoft Web Studio

Página 610


Wait(1000)

Atenção: Pode-se utilizar a função Wait(numMillisec) somente em planilhas Math. Porém, é um risco utilizar essa função em qualquer lugar de sua aplicação. Wait(numMillisec) pausa a Aplicação, e qualquer informação de entrada para a Aplicação durante a espera será ignorada.

WinExec(strCommand, optnumState, optnumSync, “opttagReturnOrHandle”)


Execução Assíncrona / Assíncrona




• Descrição: Executa uma linha de comando do Windows.

• Parâmetros:

strCommand Tag String contendo a linha de comando a ser executada.

optnumState Tag numérico opcional ou constante contendo um inteiro que define o estado inicial de uma nova aplicação:

• 0: Oculta a Aplicação e promove controle a uma outra aplicação.

• 1: Ativa e exibe a aplicação (padrão). • 2: Ativa a Aplicação e a exibe como ícone. • 3: Ativa e maximiza uma aplicação. • 4: Exibe a aplicação com seu tamanho mais

recente. A aplicação ainda está ativa. • 7: Exibe a aplicação como um ícone. A Aplicação

ainda está ativa.


InduSoft Web Studio

Página 611

optnumSync Tag numérica opcional ou constante que especifica se a função executará sincronica ou assincronicamente. Ao executar sincronicamente, a função retornará quando o executável terminá-la; Ao executar assincronicamente, a função retornará imediatamente. Para verificar se um programa que iniciou-se automaticamente foi finalizada, será necessário utilizar o quarto parâmetro e a função WinExecIsRunning.

• 0: Modo Assíncrono. • 1: Modo sincrônico. Padrão é 0.

“opttagReturnOrHandle” Deve-se especificar uma string com o Nome do Tag que receberá o Código de retorno (ao executar sincronicamente) do arquivo executável ou o programa a ser manuseado pode ser utilizado na função WinExecIsRodunnig para determinar se a executável ainda está rodando.


0 Comando não foi executado com sucesso.

1 Comando foi executado com sucesso.

• Exemplos:


Tag WinExec( "C:\WinNT\System32\Notapad.exe", 4 ) // Inicia o Notapad e continua executando as próximas linhas no script

Tag WinExec( "C:\WinNT\System32\mspaint.exe" ) // Inicia MS Paint e continua executando as próximas linhas no script

Tag WinExec( "C:\MyTasks.bat", 0, 1, “result” ) // Inicia um arquivo batch, executa-o em modo oculto e continua a execução nas próximas linhas no script somente quando o batch finalize sua Execução. O resultado é armazenado no tag integer result.

Tag WinExec( "C:\MyTasks.bat", 0, 0, “handle” ) // Inicia um arquivo batch, executa-o em modo oculto e segue para a próxima linha do script. O tag handle recebe um número que pode ser passado para a função WinExecIsRunning para determinar se o batch ainda está em execução ou não [WinExecIsRunning(handle)].


InduSoft Web Studio

Página 612

WinExecIsRunning(numHandle, “opttagReturn”)






• Descrição: Indica se um programa que foi iniciado pela função WinExec() ainda está rodando.

• Parâmetros:

numHandle Número Handle armazenado no tag no parâmetro WinExec stroptReturnorHandle.

“opttagReturn” Tag que recebe o código de retorno pelo programa executado pela função WinExec().


0 Executado com sucesso

-1 Parâmetro inválido(s)

-2 Falha ao abrir o arquivo. O Disco está protegido ou o arquivo é inválido.

• Exemplos:


Tag WinExecIsRunning(numHandle)

Tag WinExecIsRunning(numHandle, “return”)


InduSoft Web Studio

Página 613

Funções de Arquivo Essa seção descreve as seguintes funções de Arquivo do InduSoft Web Studio:

• DeleteOlderFiles (strPath, strMask, strDate)

• DirCreate (strDirectory , optBooFullPath)

• DirDelete (strDirectory , optBooEmptyOnly)

• DirLength (strPath)

• DirRename (strPath , strDirectoryFrom , strDirectoryTo)

• FileCopy (strSourceFile, strTargetFile, optnumTimeOut)

• FileDelete(strFile)

• FileLength(strFile)

• FileRename(strOldName, strNewName)

• FileWrite(strFileName, strWriteText, numoptAppend)

• FindFile(strFile, "opttagFilesFound", optnumTimeOut)

• FindPath(strPathName)

• GetFileAttributes(strFile)

• GetFileTime(strFileName, numFormat)

• GetLine(strFileName, strSeqChar, "tagStore", optnumCase, "optOveflowTag")

• HST2TXT( strStartDate, strStartTime, numDuration, numGrupoNumber, optstrTargetFile, optstrSeparator, optnumMilliseconds, optstrFormat)

• HST2TXTIsRodando()

• Print()

• RDFileN("tagSelecioneedFile", strSearchPath, strMask, numChangeDir)

DeleteOlderFiles(strPath, strMask, strDate)

Grupo Arquivo





• Descrição: Apaga os arquivos no caminho (path) e com a máscara (mask) selecionada, que forem mais antigos do que a data especificada.

• Parâmetros:

StrPath Tag String contendo o caminho dos arquivos a serem deletados.

StrMask Tag String contendo a mask dos arquivos a serem deletados.

StrDate Tag String contendo a data cut-of (limite). Qualquer arquivo mais antigo que essa data será deletado.

• Valores de Retorno: Retorna o número de arquivos deletados.


InduSoft Web Studio

Página 614

• Exemplos:


Tag DeleteOlderFiles(“C:\ IWS\Aplication\HST\”, “*.hst”, “04/12/2002”)

Nota: Deve-se configurar o terceiro parâmetro (StrDate) utilizando o formato para a data especificado para a Aplicação (como MDY ou DMY) com o separador apropriado ( /,:, ., etc.)

DirCreate(strDirectory, optBooFullPath)

Grupo Arquivo





• Descrição: Cria o diretório especificado.

• Parâmetros:

strDirectory Tag string ou valor contendo o nome e o caminho do arquivo do diretório a ser criado.

optBooEmptyOnly flag opcional. Se omitido ou parâmetro com valor igual a 0, o diretório será criado somente se todos os diretórios anteriores existirem. Caso o parâmetro possua valor diferente de 0, o caminho completo especificado no parâmetro strDirectory será criado.


-1 Parâmetros inválidos

0 Falha ao criar o diretório (e.x. Drive não existe.)

1 Diretório criado com sucesso.

• Exemplos:


Tag DirCreate(“C:\Studio\Temp”) // A pasta Temp foi criada no caminho C:\Studio (somente se o caminho C:\Studio já exista).

Tag DirCreate(“C:\Studio\Temp”,1) // O caminho completo C:\Studio\Temp foi criado.


InduSoft Web Studio

Página 615

Nota: Quando essa função é executada a partir de Web Thin Client station, o diretório é verificado na server station (mas não em Web Thin Client).

DirDelete(strDirectory, optBooEmptyOnly)

Grupo Arquivo





• Descrição: Deleta o diretório especificado.

• Parâmetros:

strDirectory Tag string ou valor contendo o nome e o caminho do arquivo do diretório a ser deletado.

optBooEmptyOnly Flag opcional. Se omitido ou se o parâmetro possui o valor 0, o diretório será deletado somente se estiver vazio.


-2 Tentativa de deletar um diretório não vazio quando tal ação não é permitida (optBooEmptyOnly <> 0)


0 Falha ao deletar o diretório (e.x. Diretório não existe.)

1 Diretório deletado com sucesso.

• Exemplos:


Tag DirDelete(“C:\Studio\Temp”) // A pasta Temp de C:\Studio foi deletada.

Tag DirDelete (“C:\Studio\Temp”,1) // A pasta Temp de C:\Studio será deletada somente se estiver vazia.


InduSoft Web Studio

Página 616

Nota: Quando essa função é executada a partir de Web Thin Client station, o diretório é verificado na server station (mas não em Web Thin Client).

Dica: Essa função suporta wildcard (* and ?).

DirLength(strPath)

Grupo Arquivo





• Descrição: Retorna o tamanho de um diretório especificado.

• Parâmetros:

strPath Tag string ou valor contendo o caminho do diretório a ser verificado.


-2 Diretório não existe.


>=0 Tamanho (em bytes) dos arquivos e subpastas do diretório

• Exemplos:


Tag DirLength(“C:\Studio”) // Retorna o tamanho (em bytes) de todos os arquivos e subpastas de C:\Studio.

Atenção: Essa função é síncrona, e pode levar alguns segundos para retornar o valor correto; deve ser utilizada com atenção.


InduSoft Web Studio

Página 617

Nota: Quando essa função é executada a partir de uma Web Thin Client station, o diretório é verificado na server station (mas não em Web Thin Client).

DirRename(strPath, strDirectoryFrom, strDirectoryTo)

Grupo Arquivo





• Descrição: Renomeia diretórios.

• Parâmetros:

strPath Tag string ou valor contendo o caminho do diretório a ser renomeado.

strDirectoryFrom Tag string ou valor contendo o nome original do diretório a ser renomeado.

strDirectoryTo Tag string ou valor contendo o nome do alvo utilizado para renomear o diretório original.



0 Falha ao renomear o diretório (e.x. strDirectoryFrom não existe.)

1 Diretório renomeado com sucesso.

• Exemplos:


Tag DirRename(“C:\Studio\”,”Temp”, “New”) // A pasta Temp da pasta C:\Studio\ está renomeada como New.

Tag DirDelete (“C:\Studio\Temp”,1) // A pasta Temp da pasta C:\Studio será deletada somente se estiver vazia.

Nota: Quando essa função é executada a partir de uma Web Thin Client station, o diretório é renomeado na server station (mas não em Web Thin Client).


InduSoft Web Studio

Página 618

Dica: Essa função suporta wildcard (* and ?).

FileCopy (strSourceFile, strTargetFile, optnumTimeOut)

Grupo Arquivo





• Descrição: Copia o arquivo(s) configurado no parâmetro strSourceFile para o arquivo/caminho configurado no parâmetro strTargetFile.

• Parâmetros:

strSourceFile Tag String contendo caminho e mask do arquivo(s) a ser copiado.

strTargetFile Tag String contendo o caminho onde está o arquivo(s) a ser copiado.

optnumTimeOut Tag numérico contendo um inteiro para configurar o timeout para a operação.


-1 Timeout expirou.

0 Falha ao copiar o arquivo(s).

1 Arquivo(s) copiado com sucesso.

• Exemplos:


Tag FileCopy(“C:\ IWS\Aplication\HST\*.hst”, “C:\Temp\Hst\”, 1000)

Tag FileCopy(“C:\ IWS\Aplication\ropert.txt”, “C:\Temp\Tuesday_Report.txt”, 500)


InduSoft Web Studio

Página 619

Atenção: Essa função é originalmente síncrona (por exemplo, o scan não continua até que a função finalize o procedimento de cópia). Conseqüentemente, utilizar essa função para conexões de rede de trabalho lentas poderá causar problemas.

Caso você utilizar o parâmetro optnumTimeOut, a função retornará o valor –1 após o timeout especificado, e o scan continuará, e o procedimento de cópia não será cancelado. Um processo interno será criado para finalizar o procedimento de cópia.

FileDelete(strFile)

Grupo Arquivo





• Descrição: Deleta o arquivo especificado.

• Parâmetros:

strFile Tag String contendo o nome e o caminho do arquivo a ser deletado.


0 Falha ao deletar o arquivo

Real Retorna o tamanho do arquivo deletado

• Exemplos:


Tag FileDelete(“C:\ IWS\readme.txt”)

FileLength (strFile)

Grupo Arquivo





• Descrição: Retorna o tamanho de um arquivo


InduSoft Web Studio

Página 620

• Parâmetros:

strFile Tag String contendo o nome e o caminho do arquivo.

• Valores de Retorno: Retorna o tamanho em bytes do arquivo especificado.

• Exemplos:


Tag FileLength( "C:\readme.txt" )

FileRename(strOldName, strNewName)

Grupo Arquivo





• Descrição: Renomeia o arquivo especificado.

• Parâmetros:

strOldName Tag String contendo o caminho e nome do arquivo.

strNewName Tag String contendo o caminho e o novo nome do arquivo.


• Exemplos:


FileRename(“C:\readme.txt”, “C:\pleasereadme.txt”)

FileWrite(strFileName, strWriteText, numoptAppend)

Grupo Arquivo





• Descrição: Registra uma string ASCII para um arquivo especificado. Caso o arquivo não exista, a função criará o arquivo.


InduSoft Web Studio

Página 621

• Parâmetros:

strFileName Tag String contendo o nome do arquivo.

strWriteText Tag String contendo o texto a ser escrito no arquivo especificado.

numoptAppend Tag Number:

Caso omitir esse parâmetro ou especificar zero (0), a função substitui os conteúdos do arquivo existente com o texto especificado para strWriteText.

Caso você especifique um valor diferente de zero (1, 2, 3, …), a função adiciona o novo texto especificado utilizando strWriteText como uma nova linha para o arquivo.


0 Executado com sucesso

-1 Parâmetro inválido(s)

-2 Falha ao abrir o arquivo. O Disco está protegido ou o nome do arquivo está inválido.

• Exemplos:


Tag FileWrite(“c:\test.txt”, “This is a test”)

Tag FileWrite(TagFileName, TagText)

Tag FileWrite(TagFileName, TagText, 1)

FindFile(strFile, "opttagFilesFound", optnumTimeOut)

Grupo Arquivo





• Descrição: Procura por um arquivo

• Parâmetros:

strFile Tag string contém a coordenada mask do arquivo a ser pesquisado.

“opttagFilesFound” Tag string array Opcional recebe caminho e nome de cada arquivo encontrado.

optnumTimeOut Tag numérico Opcional contém um inteiro para configurar o timeout em milissegundos para essa função.


InduSoft Web Studio

Página 622


-1 Timeout

0 Arquivos não encontrados

N Número de arquivos encontrados

• Exemplos:


Tag FindFile(“*.txt”)

Tag FindFile(“*.doc”, “StringArray”, 1000)

Atenção: Essa função é originalmente síncrona (por exemplo, o scan não continua até que a função finalize o procedimento de cópia). Conseqüentemente, utilizar essa função para conexões de rede de trabalho lentas poderá causar problemas.

Caso você utilizar o parâmetro optnumTimeOut, a função retorna o valor –1 após o timeout especificado e o scan continuará.

FindPath(strPathName)

Grupo Arquivo





• Descrição: Verifica a existência do diretório.

• Parâmetros:

strPathName Tag String contendo o caminho do arquivo a ser pesquisado.


0 Caminho não encontrado

1 Caminho encontrado

• Exemplos:


InduSoft Web Studio

Página 623


Tag FindPath(“C:\WINNT\”)

GetFileAttributes(strFile)

Grupo Arquivo





• Descrição: Lê os atributos de um arquivo especificado.

• Parâmetros:

strFile Tag string, contendo o arquivo do qual os atributos serão lidos.


-1 Erro

1 Somente Leitura

2 Oculto

4 Sistema

16 Diretório

32 Arquivo

128 Normal

256 Temporário

• Exemplos:


Tag GetFileAttributes(“C:\readme.txt”)

GetFileTime(strFileName, numFormat)

Grupo Arquivo



InduSoft Web Studio

Página 624




• Descrição: Lê a data e hora da última modificação do arquivo.

• Parâmetros:

strFileName Tag String contendo o nome do arquivo a ser lido.

numFormat Tag numérico, que especifica o formato dos dados de retorno especificados.

• 0: Retorna a Data e Hora do arquivo. • 1: Retorna somente a data do arquivo. • 2: Retorna somente a hora do arquivo.

• Valores de Retorno: Retorna a data e hora da última modificação do arquivo.

• Exemplos:


Tag GetFileTime(“C:\readme.txt”)

GetLine(strFileName, strSeqChar, "tagStore", optnumCase, "optOveflowTag")

Grupo Arquivo





• Descrição: Pesquisa uma seqüência de caracteres (string) em um arquivo ASCII e armazena (em um Tag string) os conteúdos de toda uma linha na qual a seqüência de caracteres foi encontrada.

• Parâmetros:

StrFileName Tag String contendo o caminho e o nome do arquivo a ser pesquisado.

strSeqChar Tag String contendo a seqüência de caracteres a serem pesquisados.

“tagStore” Nome do Tag string que recebe a linha toda de caracteres dos quais a seqüência foi encontrada.


InduSoft Web Studio

Página 625

OptnumCase Tag numérico Opcional especificando se a pesquisa é sensível a letras maiúsculas e minúsculas.

• 0: Não é sensível a letras maiúsculas e minúsculas • 1: Sensível a letras maiúsculas e minúsculas

OptOverflowTag Nome de um Tag numérico opcional que recebe o resultado de uma verificação de sobrefluxo.

• 0: OK • 1: sobrefluxo


InduSoft Web Studio

Página 626


N Quantidade de linhas nas quais a seqüência foi encontrada no arquivo alvo ASCII.

0 String não encontrado no arquivo alvo ASCII

-1 Arquivo ASCII não encontrado

-2 Parâmetro strFileName Inválido

-3 Parâmetro strSeqChar inválido

-4 Parâmetro strStoreTag inválido

-5 Parâmetro numOptCase inválido

-6 Parâmetro optnumOverflowTag inválido


• Exemplos:


Tag GetLine(“C:\TechRef v51.doc”, “ IWS Tag database6.1”, "ReturnLine")

Tag GetLine(“C:\readme.txt”, “Antes de instalar o IWS”, "ReturnedLine", 0, "Overflow")

Nota: Essa função pesquisa somente a primeira ocorrência da string no arquivo ASCII.

HST2TXT(strStartDate, strStartTime, numDuration, numGrupoNumber, optstrTargetFile,

optstrSeparator, optnumMilliseconds, optstrFormat)

Grupo Arquivo





• Descrição: Exporta informações do arquivo(s) histórico trend binário de propriedade (*.hst) para um arquivo texto (*.txt).


InduSoft Web Studio

Página 627

• Parâmetros:

StrStartDate Tag String contendo a data de início dos dados.

StrStartTime Tag String contendo a hora de início dos dados.

NumDuration Tag numérico contendo a duração dos dados em horas.

NumGrupoNumber Tag numérico contendo Número do grupo Trend.

optstrTargetFile Tag String opcional contendo o caminho e nome do arquivo a ser registrado. Se omitido, a função cria um arquivo com o mesmo nome de propriedade do arquivo, mas utilizando a extensão TXT.

optstrSeparator Tag String opcional contendo os caracteres para separação de dados para o arquivo. Se omitido, a função utiliza o caractere TAB (\t) para separar os valores no arquivo texto.

optnumMilliseconds Tag numérica opcional. Caso esse parâmetro seja falso (0), o arquivo texto criado não exibirá milissegundos no timestamp de cada amostra de histórico.

optstrFormat Tag string, o qual especifica a ordem de Mês (M), Dia (D), e Ano (Y) para formato time-stamp exportado para o arquivo texto:

“DMY”: Day, Month, Year

“MDY”: Month, Day, Year

“YMD”: Year, Month, Day

Se omitido, a função utiliza o formato DMY para o timestamp no arquivo texto.



-2 Funções Dll não encontradas

-1 IndHst.dll não encontrado

0 Função foi executada com sucesso

1 Erro. Execução prévia de HST2TXT ainda não foi completada

• Exemplos:


Tag HST2TXT(“04/12/2002”, “13:45:50”, 5.5, 1)

Tag HST2TXT( "04/14/2002", "06:30:00", 0.1, 3, "C:\Studio\data.txt", "\" )

Tag HST2TXT( "04/14/2002", "06:30:00", 0.1, 3, "C:\Studio\data.csv", "," ,


InduSoft Web Studio

Página 628

“MDY” )

Dica: Ao utilizar o caractere vírgula (,) como optstrSeparator, a função cria um arquivo no formato CSV (Comma Separated Values), uma ferramenta útil para exportação de dados históricos Trend de formato binário de propriedade para um arquivo que pode ser aberto com o Microsoft Excel.

HST2TXTIsRodando()

Grupo Arquivo





• Descrição: Retorna o status da função HST2TXT().


0 HST2TXT ainda está rodando.

-1 Processo Last conVersion foi executado de maneira apropriada.

-2 Reservado.

-3 Arquivo não encontrado. Não existem arquivos históricos no intervalo de tempo configurado para o grupo especificado.

-4 Não é possível abrir o arquivo HST.

-5 Não é possível abrir/criar o arquivo ASCII.

-6 Não é possível ler informações do arquivo HST

-7 Tipo de arquivo inválido.

-8 Não é possível ler informações do cabeçalho (Header) do arquivo HST.

-9 Número do tag inválido nas informações do cabeçalho (Header) (0 > nTags > 250)

-10 Não é possível criar o arquivo Header (.hdr)

-20 IndHst.dll não encontrado.

-30 Não é possível acessar a função dll.


InduSoft Web Studio

Página 629

• Exemplos:


Tag HST2TXT()

Print( strFilePath , optnumOrientation)

Grupo Arquivo





• Descrição: Imprime um arquivo texto.

• Parâmetros:

strFilePath Caminho e nome do arquivo texto a ser impresso.

optnumOrientation Configura a orientação do papel, como se segue:

0 (padrão) = Porta- retrato

1 = Paisagem

Nota: O Parâmetro optnumOrientation Não é suportado quando a aplicação está rodando sob sistema operacional Windows CE.


• Exemplos:


Print(“C:\ReadMe.txt”)

Print(“C:\ReadMe.txt”, 1)

Print(TagFileName, 0)

Nota: Essa função pode ser utilizada para imprimir somente conteúdos de arquivos textos. Informações em quaisquer outros formatos (e.x. figuras, Arquivos Binários, etc.) não podem ser impressas com essa função.


InduSoft Web Studio

Página 630

RDFileN("tagSelecioneedFile", strSearchPath, strMask, numChangeDir)

Grupo Arquivo





• Descrição: Inicializa uma janela File Browser que permite a seleção de um arquivo.

• Parâmetros:

“tagSelecioneedFile” Nome do Tag string que recebe o nome e caminho de um arquivo selecionado(s).

StrSearchPath Tag String contendo o caminho do arquivo a ser pesquisado.

StrMask Tag String contendo o mask utilizado para filtrar os arquivos.

NumCahngeDir Tag numérico contendo 0 para desabilitar alteração de diretórios.


0 Sucesso

1 Um dos parâmetros não é uma string

2 Parâmetro 1 contém um Nome do Tag inválido

3 A operação foi cancelada pelo usuário

• Exemplos:


Tag RDFileN("FileName", “C:\ IWS\”, “*.doc”, 1)


InduSoft Web Studio

Página 631

Funções Gráficas Essa seção descreve as seguintes funções Gráficas do InduSoft Web Studio:

• PrintSetup()

• PrintWindow(strScreenName , optnumOrientation)

• RGBColor ( numRed, numGreen, numBlue )

• RGBComponent ( numColor , numComponent )

PrintSetup()

Grupo Telas Gráficas Printint





• Descrição: Abre o diálogo de configuração padrão do Sistema Operacional, onde a impressora pode ser selecionada e configurada.


• Exemplos:


Tag PrintSetup()

PrintWindow(strScreenName , optnumOrientation)

Grupo Gráfico





• Descrição: Imprime um screenshot da tela da aplicação.

• Parâmetros:

strScreenName Tag String contendo o nome do tag screen o qual deseja-se imprimir. Caso esse parâmetro esteja omitido, a tela aberta atualmente será impressa. Esse parâmetro deve ser omitido ao executar essa função sob sistema operacional WinCE.


InduSoft Web Studio

Página 632

optnumOrientation Configura a orientação do papel, como se segue:

0 (padrão) = Porta- retrato

1 = Paisagem

Nota: O parâmetro optnumOrientation Não é suportado quando a aplicação está rodando sob sistema operacional Windows CE.


• Exemplos:


PrintWindow()

PrintWindow(“Main”, 1)

Print(TagScreenName, 0)

Nota: Pode-se utilizar a função PrintWindow() para imprimir relatórios em formato gráfico, incluindo qualquer objeto, como Trends, bitmaps, etc.

RGBColor ( numRed, numGreen, numBlue )

Grupo Gráfico





• Descrição: Retorna o número da cor definida por códigos RGB (Red, Green e Blue).

• Parâmetros:

numRed Código Vermelho do código RGB

numGreen Código Verde do código RGB

numBlue Código Azul do código RGB

• Valores de Retorno: Essa funçãoi retorna o número da cor definida pelos códigos RGB (Red, Green and Blue).


InduSoft Web Studio

Página 633

• Exemplos:


TagColor RGBColor(51,153,102) // Essa função retorna o valor 13434828, o qual é a cor do código para Sea Green.

TagColor RGBColor(TagRed,TagGreen,TagBlue) // Essa função retorna o código da cor dos valores RGB configurados nos tags TagRed, TagGreen and TagBlue, respectivamente.

Dica: Veja a lista de valores de Códigos e Cores RGB para a maioria das cores utilizadas em IWS Development Environment -> Standard Interfaces -> Color Interface secton.

RGBComponent ( numColor , numComponent )

Grupo Gráfico





• Descrição: Retorna o código de um dos componentes RGB a partir do código de cores estabelecido.

• Parâmetros:

numColor Código de cores a partir do qual um valor do compoente será extraído.

numComponent Especifica qual componente RGB será extraído da cor (0=Red ; 1=Green; 2=Blue)

• Valores de Retorno: Essa função retorna o código de um dos componentes RGB a partir do código de cores apresentado.


InduSoft Web Studio

Página 634

• Exemplos:


TagRed RGBColor(13434828,0) // Essa função retorna o valor 51, o qual é o componente Red do código de cores 13434828 (Sea Green).

TagGreen RGBColor(13434828,1) // Essa função retorna o valor 153, o qual é componente Green do código de cores 13434828 (Sea Green).

TagBlue RGBColor(13434828,2) // Essa função retorna o valor 102, o qual é componente Blue do código de cores 13434828 (Sea Green).

TagComponent

RGBColor(TagCode, TagComponent) // Essa função retorna o valor do código de cores e components especificados pelos tags TagCode e TagComponent, respectivamente.

Dica: Veja a lista de códigos RGB e valores de cores para a maioria das cores utilizadas, no capítulo Inteface de cores.


InduSoft Web Studio

Página 635

Funções de Tradução Essa seção descreve as seguintes funções de Tradução do InduSoft Web Studio:

• Ext(strText)

• SetTranslationFile(strFileName)

Ext(strText)

Grupo Tradução





• Descrição: Traduz texto especificado.

• Parâmetros:

srtText Tag String contendo o texto a ser traduzido.

• Valores de Retorno: Retorna a tradução do texto, utilizando-se do arquivo de tradução ativo.

• Exemplos:


Tag Ext(“Start”) // Valor de retorno caso traduzindo para Português = “Iniciar”

Tag Ext(“Stop”) // Valor de retorno caso traduzindo para Alemão = “Anschlag”

SetTranslationFile(strFileName)

Grupo Tradução





• Descrição: Configura o arquivo de tradução ativo, e traduz todos os textos habilitados junto a aplicação.

• Parâmetros:

strFileName Tag String contendo o nome de um arquivo de tradução.


InduSoft Web Studio

Página 636

optStrColumnName Tag string ou valor contendo o nome do tag column do arquivo de tradução, o qual deverá ser utilizado para traduzir os textos na aplicação. Quando omitido, a segunda coluna do arquivo de tradução será utilizada por padrão.


0 Sucesso.

1 Número inválido de parâmetros.

2 Tipo errado de parâmetro.

3 Arquivo de tradução não pôde ser encontrado ou aberto.

• Exemplos:


Tag SetTranslationFile(“Portuguese.tra”)

Tag SetTranslationFile(“German.tra”)

Tag SetTranslationFile( "Mytranslation.csv" , “Portuguese” )

Tag SetTranslationFile( "Mytranslation.csv" , “German” )

Nota: Deve-se habilitar a opção Translation a partir do diálogo Project Settings para que essa função possa funcionar.

Atenção: Deve-se possuir um arquivo de tradução na utilidade Translation File.


InduSoft Web Studio

Página 637

Funções Multimídia Essa seção descreve a função Multimídia do InduSoft Web Studio Multimedia: Play(strFileName).

Play(strFileName, numOptSíncrona)

Grupo Multimídia

Execução Síncrona/Assíncrona




• Descrição: Roda um arquivo .WAV especificado.

• Parâmetros:

strFileName Tag String contendo .WAV a ser traduzido.

numOptSíncrona Tag numérico que controla se uma função será executada síncrona ou assincronicamente.

Onde: • Especificar 0 (padrão) ou não especificar parâmetros

habilita a função a executar de forma assíncrona. • Especificar 1 habilita a função para execução Síncrona.


• Exemplos:


Play(“C:\Sounds\Wav\alarm.wav”)

Nota: Para que essa função funcione em Web Thin Client, o arquivo alvo .WAV deverá estar localizado no mesmo caminho do arquivo na estação remota.


InduSoft Web Studio

Página 638

Funções Informações do Sistema Essa seção descreve as seguintes funções de Informações do Sistema do InduSoft Web Studio:

• DbVersion()

• GetAppHorizontalResolution( )

• GetAppPath()

• GetAppVerticalResolution( )

• GetComputerIP( )

• GetComputerName( )

• GetFreeMemoryCE(optnumType)

• GetHardKeyModel( )

• GetHardkeySN( )

• GeDicaAll(“tagArrayIP”, optRefresh)

• GetMemoryCE(optnumType)

• GetNetMACID( )

• GetProductPath( )

• GetOS( )

• GetPrivateProfileString(strSeção, strName, strDefault, strFileName)

• GetScrInfo()

• GetServerHostName

• GetTickCount( )

• InfoAppAlrDir( )

• InfoAppHstDir( )

• InfoDiskFree(strDisk)

• InfoResources(numSelecione)

• IsActiveXReg(numType, strProgIDorFileName)

• KeyPad(“TagName”, strOptKeyboardType, booOptIsPassword)

• NoInputTime(optUpdateTrigger)

• ProductVersion( )

• SaveAlarmFile(numType, optRemotePath)

• SetAppAlarmPath(strPath)

• SetAppHSTPath(strPath)

• SetDateFormat(strSeparator, strFomat)

• SetWebConfig(strServerIP, strOptURL, strOptPath, numOptPort)

DbVersion()

Grupo System Info.





InduSoft Web Studio

Página 639


• Descrição: Retorna o número da Tag databasedo banco de dados da aplicação atual.

• Valores de Retorno: Retorna a Tag databasedo banco de dados em formato numérico.

• Exemplos:


Tag DbVersion()

GetAppHorizontalResolution( )

Grupo System Info.





• Descrição: Obtém a resolução horizontal da tela, a partir do arquivo .APP, seção [Info].

• Valores de Retorno: Retorna o valor [Info, embora não teste a configuração do Windows.

• Exemplos:


Tag GetAppHorizontalResolution( ) // Valor de retorno = 640

Tag GetAppHorizontalResolution( ) // Valor de retorno = 800

GetAppVerticalResolution( )

Grupo System Info.





• Descrição: Obtém a resolução vertical da tela a partir do arquivo .APP, seção [Info].

• Valores de Retorno: Retorna [Info]value, embora não teste a configuração do Windows.


InduSoft Web Studio

Página 640

• Exemplos:


Tag GetAppVerticalResolution( ) // Valor de retorno = 480

Tag GetAppVerticalResolution( ) // Valor de retorno = 600

GetComputerIP( )

Grupo System Info.





• Descrição: Retorna o primeiro Endereço IP da estação local.

• Valores de Retorno: Retorna o primeiro Endereço IP da estação local como uma string.

• Exemplos:


Tag GetComputerIP() // Valor de retorno = 192.168.0.1

Tag GetComputerIP() // Valor de retorno = 248.12.2.78

GetComputerName( )

Grupo System Info.





• Descrição: Retorna o nome do computador local.

• Valores de Retorno: Retorna o nome do computador local como uma string.


InduSoft Web Studio

Página 641

• Exemplos:


Tag GetComputerName() // Valor de retorno = Terminal53

Tag GetComputerName() // Valor de retorno = BobsComputer

GetFreeMemoryCE(optnumType)

Grupo System Info.


Windows NT/2K/XP Não suportado



• Descrição: Retorna a quantidade de memória livre disponível em um equipamento Windows CE.

• Parâmetros:

optnumType Tag numérico Opcional que especifica qual o tipo de memória livre que o IWS deverá entregar a partir de um equipamento Windows CE, Onde:

0: Programa com memória total disponível


>0 Tamanho da memória livre (em bytes).

-1 Arquivo Coredll.dll não encontrado.

-2 Função GetFreeMemoryCE não encontrada.

-3 Parâmetro opcional inválido.

-4 Tipo de memória não disponível.

• Exemplos:


Tag GetFreeMemoryCE(opt2)

GetHardKeyModel()

Grupo System Info.



InduSoft Web Studio

Página 642




• Descrição: Retorna o modelo de seu hardkey.


Hardkey located: Retorna uma string com o modelo do hardkey.

Hardkey not installed or not found: Sem valores de retorno.

• Exemplos:


Tag GetHardKeyModel() // Valor de retorno = Interface Local

Tag GetHardKeyModel() // Valor de retorno = Server Advanced

Atenção: Deve-se instalar o hardkey antes de executar essa função ou a função não será executada de maneira apropriada.

GetHardkeySN( )

Grupo System Info.





• Descrição: Retorna o número serial do hardkey.


Hardkey located: Retorna uma string com o número serial do hardkey.

Hardkey not installed or not found: Retorna a 0.

• Exemplos:


Tag GetHardkeySN() // Valor de retorno = 120.745

Tag GetHardkeySN() // Valor de retorno = 224.941


InduSoft Web Studio

Página 643

Atenção: Deve-se instalar o hardkey antes de executar essa função ou a função não será executada de maneira apropriada.

GeDicaAll(“tagArrayIP”, optRefresh)

Grupo System Info.





• Descrição: Retorna o número dos endereços IP assinalados para a estação local e armazena os Endereços IP em um tag string array.

• Parâmetros:

“tagArrayIP” Nome do tag string array que recebe o endereço IP encontrado.

optRefresh Tag opcional que dispara uma função de atualização dessa função, caso você utilize-a em uma dinâmica de text I/O. Cada vez que esse tag altera seu valor, o IWS atualizará a função.


N Número do Endereço IP encontrado


-2 Tipo de parâmetro inválido

• Exemplos:


Tag GeDicaAll(“TagArrayIP”) // Valor de retorno = 1

Tag GeDicaAll(“TagArrayIP”, second) // Valor de retorno = 2

GetMemoryCE(optnumType)

Grupo System Info.




InduSoft Web Studio

Página 644



• Descrição: Retorna a memória total disponível em um equipamento Windows CE.

• Parâmetros:

optnumType Tag numérico Opcional que especifica qual tipo de mémoria o IWS poderá entregar a partir de um equipamento Windows CE, como se segue.

• 0: Memória total do programa • 1: Armazenamento total de memória • 2: Memória Total


>0 Tamanho da memória em bytes.

-1 Arquivo Coredll.dll não encontrado.

-2 Função GetMemoryCE não encontrada.

-3 Parâmetro opcional inválido.

• Exemplos:


Tag GetMemoryCE(opt1)

GetNetMACID(“strOptMACID”, “strOptAdapterName” )

Grupo System Info.





• Descrição: Obtém o único código MAC ID do adaptador(es) de rede de trabalho instalados atualmente.

• Parâmetros:

strOptMACID Nome de um Tag String, que recebe MAD ID do adaptador da rede de trabalho. Caso exista mais de um adaptador de rede de trabalho instalado atualmente na estação, o usuário poderá configurar um tag string array nesse parâmetro, de modo que cada posição de array recebe o MAC ID de um adaptador da rede de trabalho.


InduSoft Web Studio

Página 645

strOptAdapterName Nome de um Tag String, que recebe o nome do tag network adapter. Caso exista mais de um adaptador de rede de trabalho instalado atualmente na estação, o usuário poderá configurar um tag string de array nesse parâmetro, de modo que cada posição de array recebe o nome do adaptador de uma rede de trabalho. Esse parâmetro é opcional.


>0 Números de adaptadores de rede de trabalho encontrados.

0 Adaptadores de rede de trabalho não encontrados.

-1 Número inválido de parâmetros.

-2 Um dos parâmetros não é do tipo string.

-3 Tag configurado em strOptMACID não existe.

-4 Tag configurado em strOptAdapterName não existe.

• Exemplos:


NumNIC GetNetMACID(“MACIDTag”)

NumNIC GetNetMACID(“MACIDTag”, “AdapterName”)

NumNIC GetNetMACID(“MACIDTag[1]”, “AdapterName[1]”)

GetProductPath( )

Grupo System Info.





• Descrição: Retorna o caminho para o diretório do IWS.

• Valores de Retorno: Retorna o caminho do diretório do IWS como uma string.

• Exemplos:


Tag GetProductPath() // Valor de retorno = C:\Program Files\ IWS 51\


InduSoft Web Studio

Página 646

GetOS( )

Grupo System Info.





• Descrição: Relata o sistema operacional atual.


0 Windows 3.11

1 Windows 95/98/ME

2 Windows NT/2000/XP

3 Windows CE

• Exemplos:


Tag GetOS() //Valor de retorno = 2

GetPrivateProfileString(strSeção, strName, strDefault, strFileName)

Grupo System Info.





• Descrição: Lê um parâmetro especificado de um arquivo .INI utilizando o formato padrão .INI.


InduSoft Web Studio

Página 647

• Parâmetros:

strSeção Tag String contendo o nome da seção a ser lida.

strName Tag String contendo o nome do parâmetro a ser lido.

strDefault Tag String contendo a configuração padrão para esse parâmetro. Caso parâmetro não encontrado no arquivo .ini, a função retornará a configuração padrão.

StrFileName Tag String contendo o caminho e o nome do arquivo .ini a ser lido.

• Valores de Retorno: Retorna o valor do parâmetro especificado.

• Exemplos:


Tag GetPrivateProfileString( “boot loader”, “timeout”, “50”, “C:\boot.ini”) // Valor de retorno = 30

GetScrInfo()

Grupo System Info.





• Descrição: Fornece informações sobre a tela (*.scr) a partir da Aplicação.

• Parâmetros:

strScreenName: Nome da tela para a qual a informação é requisitada.

“strInfoData”: Nome do tag que receberá as informações entregues por uma função. O valor desses dados é especificado pelo parâmetro optstrInfoType.

optstrInfoType: Tipo de informações da tela fornecidas por uma função:

optstrInfoType value

Descrição

0 (padrão) Registra as seguintes coordenadas para cada posição consecutiva do tag array configurado no parâmetro “strInfoData”: TOP, LEFT, BOTTOM e RIGHT.

1 Registra a coordenada TOP para o tag configurado no parâmetro “strInfoData”..

2 Registra a coordenada LEFT para o tag configurado no parâmetro “strInfoData”..

3 Registra a coordenada BOTTOM para o tag configurado no parâmetro “strInfoData”..


InduSoft Web Studio

Página 648

4 Registra a coordenada RIGHT para o tag configurado no parâmetro “strInfoData”.


Value Descrição

0 Sucesso

-1 Primeiro e segundo parâmetros são diferentes do tipo STRING.

-2 Erro na alocação de memória

-3 optstrInfoType é zero, mas o tag “strInfoData” não é um tag array.

-4 Tag inválido configurado no parâmetro “strInfoData”.

• Exemplos:


TagErroCódigo Tag GetScrInfo( "main" , “TagXY[0]” ) // Retorna as coordenadas TOP, LEFT, BOTTOM e RIGHT das telas MAINS.SCR em quatro posições iniciais de Tag array XY.

TagErroCódigo Tag GetScrInfo( "main" , “TagXY” , 3 ) // Retorna a coordenada BOTTOM da tela MAINS.SCR spara o TagXY.

GetServerHostName()

Grupo System Info.





• Descrição:

• Parâmetros: Nenhum

• Valores de Retorno: Nome do Server host para ISSymbol e 127.0.0.1 para outros.

• Exemplos:

Nome do Tag

Expressão

GetServerHostName()


InduSoft Web Studio

Página 649

GetTickCount( )

Grupo System Info.





• Descrição: Retorna o valor atual da contagem do relógio.

• Valores de Retorno: Retorna um inteiro com os milissegundos contados pelo relógio para cada inicialização dos sistema operacional.

• Exemplos:


Tag GetTickCount // Valor de retorno = 9400907

InfoAppAlrDir( )

Grupo System Info.





• Descrição: Retorna o diretório Alarm para a Aplicação atual.

• Valores de Retorno: Retorna o diretório Alarm o diretório da Aplicação atual como uma string.

• Exemplos:


Tag InfoAppAlrDir() // Valor de retorno = C:\DemoApp\alarm\

Tag InfoAppAlrDir() // Valor de retorno = C:\ IWS\Projects\App\alarm\

GetAppPath()

Grupo System Info.




InduSoft Web Studio

Página 650



• Descrição: Retorna o diretório da Aplicação atual.

• Valores de Retorno: Retorna o diretório da Aplicação atual como uma string.

• Exemplos:


Tag GetAppPath() // Valor de retorno = C:\DemoApp\

Tag GetAppPath() // Valor de retorno = C:\Studio\Projects\App\

Nota: Essa função deverá retornar o caminho atual da aplicação, incluindo “\” no final do caminho.

InfoAppHstDir( )

Grupo System Info.





• Descrição: Retorna o diretório History para a aplicação atual.

• Valores de Retorno: Retorna o diretório History para a aplicação atual como uma string.

• Exemplos:


Tag InfoAppAlrDir() // Valor de retorno = C:\DemoApp\HST\

Tag InfoAppAlrDir() // Valor de retorno = C:\ IWS\Projects\App\HST\

InfoDiskFree(strDisk)

Grupo System Info.




InduSoft Web Studio

Página 651



• Descrição: Retorna espaço disponível em disco.

• Parâmetros:

strDisk Tag String contendo o nome do tag disk a ser verificado.

• Valores de Retorno: Retorna espaço livre (em bytes) no disco.

• Exemplos:


Tag InfoDiskFree( “C” ) // Valor de retorno = 2803804605.000000

InfoResources(numSelecione)

Grupo System Info.





• Descrição: Retorna as origens disponíveis do Windows.

• Parâmetros:

numSelecione Tag Integer contendo a origem a ser examinada.

• 0: Funções do sistema (%) • 1: Funções GDI (%) • 2: Funções USER (%) • 3: Memória (em bytes)

• Exemplos:


Tag InfoResources( 0 ) // Valor de retorno = 76.000000





InduSoft Web Studio

Página 652

Nota: A única seleção válida em uma estação Windows NT/2000/XP é 3. Selecionar 0–2 retorna somente 0.000000.

IsActiveXReg(numType, strProgIDorFileName)

Grupo System Info.





• Descrição: Determina se um controle ActiveX está registrado.

• Parâmetros:

NumType Tag numérico especificando um formato para o tag strProgIDorFileNAme.

• 0: Verificar pelo ID do Programa • 1: Veriicar pelo Nome do Arquivo

strProgIDorFileName Tag String contendo ID do Programa ou Nome do Arquivo do Controle ActiveX.


0 ActiveX está registrado.

1 ActiveX não está registrado.

• Exemplos:


Tag IsActiveXReg(0, “ISSYMBOL.ISSymbolCtrl.1”) // Valor de retorno = 0

Tag IsActiveXReg(1, “C:\winNT\system32\MediaPlayer.ocx”) // Valor de retorno = 1

KeyPad(“TagName”, strOptKeyboardType, booOptIsPassword)

Grupo System Info.




InduSoft Web Studio

Página 653



• Descrição: Abre o diálogo Virtual Keyboard para registro ao tag especificado.

• Parâmetros:

“TagName” O nome do tag ao qual o Virtual Keyboard será registrado.

strOptKeyboardType Nome do Virtual Keyboard que será inicializado. Caso esse parâmetro esteja omitido, o Virtual Keyboard padrão será inicializado.

booOptIsPassword Caso esse parâmetro esteja configurado com qualquer valor diferente de 0 (zero), os caracteres digitados no Virtual Keyboard aparecerão como“*”. Essa opção é útil quando usuário digita uma senha.

• Valores de Retorno: Retorna a hora (em segundos) desde a última ação do keyboard.

• Exemplos:


Tag NoInputTime()

Nota: Não pode-se implementar essa função diretamente de um objeto texto I/O.

NoInputTime(optUpdateTrigger)

Grupo System Info.





• Descrição: Retorna o tempo que se passou desde a última ação do teclado.

• Parâmetros:

optUpdateTrigger Tag opcional que dispara uma atualização quando essa função é utilizada em um propriedade de texto I/O. Cada vez que o valor desse tag altera-se, o IWS dispara a função.

• Valores de Retorno: Retorna a hora (em segundos) desde a última ação do Teclado.


InduSoft Web Studio

Página 654

• Exemplos:


Tag NoInputTime()

Nota: Não pode-se implementar essa função diretamente de um objeto de texto I/O.

ProductVersion( )

Grupo System Info.





• Descrição: Retorna o número da tag databasedo IWS.


0 Sucesso

1 Erro

• Exemplos:


Tag KeyPad(“tagA”)

Tag KeyPad(“tagA”, “EnhKeypad”)

Tag KeyPad(“tagA”, “EnhKeypad”, 1)

SaveAlarmFile(numType, optRemotePath)

Grupo System Info.





InduSoft Web Studio

Página 655


• Descrição: Utilize essa função para habilitar/desabilitar o recurso para salvamento de históricos de alarme e para configurar o caminho onde os arquivos históricos de alarme devem ser manuseados.

• Parâmetros:

NumType Tag contendo o número e a operação, como se segue:

0 – Desabilita o salvamento de arquivo de alarme para o disco local.

1 – Habilita o salvamento de arquivo de alarme para o disco local.

2 – Habilita o salvamento do arquivo de alarme para o disco local e para o caminho remoto especificado no parâmetro OptRemotePath.

OptRemotePath Tag contendo o nome do tag do computador remoto onde o arquivo de alarme será salvo simultaneamente ao caminho do computador local quando numType = 2.


0 Sucesso

1 Segundo parâmetro não é uma string.

2 Segundo parâmetro está faltando.

• Exemplos:


Tag SaveAlarmFile(0)

Tag SaveAlarmFile(1)

Tag SaveAlarmFile(2, “Z:\Apps\AppDemo”)

SetAppAlarmPath(strPath)

Grupo System Info.






InduSoft Web Studio

Página 656

• Descrição: Configura o caminho para Alarm para a Aplicação atual.

• Parâmetros:

strPath Tag String contendo o novo caminho para Alarm para a aplicação atual.


• Exemplos:


SetAppAlarmPath(“C:\ IWS\Alarm\”)

SetAppHSTPath(strPath)

Grupo System Info.





• Descrição: Configura o caminho para History para a aplicação atual.

• Parâmetros:

strPath Tag String contendo o novo caminho History para a aplicação atual.


• Exemplos:


SetAppHstPath(“C:\ IWS\History\”)

SetDateFormat(strSeparator, strFomat)

Grupo System Info.





• Descrição: Configura o formato e separador para a string date.


InduSoft Web Studio

Página 657

• Parâmetros:

strSeparator Tag String contendoo caractere separador para a string date.

strFormat Tag string, que especifica a ordem de Mês (M), Dia (D), e Ano (Y) na string date.

DMY: Day, Month, Year

MDY: Month, Day, Year

YMD: Year, Month, Day


0 Sem Erro


• Exemplos:


Tag SetDateFormat( “/”, “MDY”) // Date = 04/18/2002

Tag SetDateFormat( “:”, “MYD”) // Date = 04:2002:18

SetWebConfig( strServerIP, strOptBackupURL, strOptPath, numOptHostPort,

strOptSecondaryServerIP, numOptProtocolFlag, numOptGtwPort, strOptGtwIP,

strOptSecondaryGtwIP, strOptISSymbolURL )

Grupo System Info.





• Descrição: Configura os parâmetros da web para a aplicação atual. Configura o server secundário para dados e as configurações URL secundárias para a web solution. Os parâmetros configurados em uma função são atualizados em arquivos HTML da Aplicação.

• Parâmetros:

strServerIP Endereço IP do Data Server. Endereço IP (ou hostname) do computador onde o módulo TCP Server do IWS está rodando.

strOptBackupURL Alternativa URL Opcional para as web pages da aplicação. O Web Thin Client procurará por web pages nessa URL e se não encontrá-los no mesmo URL registrado no campo Address do browser da


InduSoft Web Studio

Página 658

web.

strOptPath Caminho Opcional onde as web pages que deverão ser atualizadas estão armazenadas.

numOptHostPort Número da Porta TCP Opcional que o Web Thin Client deverá utilizar para trocar dados com o módulo TCP Server do IWS.

strOptSecondaryServerIP Endereço IP do data server alternativo e Opcional. O Web Thin Client tentará conectar-se ao módulo Server TCP do IWS nesse Endereço IP e não será capaz de conectar-se ao módulo TCP Server module rodando no Endereço IP especificado no parâmetro strServerIP.

numOptProtocolFlag Opcional - Ao utilizar a opção Web Tunneling Gateway, esse parâmetro especifica se o Web Thin Client utilizará HTTP para troca de dados com o Web Server ou HTTPS (SSL – Secure Socket Layer). Caso esse flag possua o valor 0, o Web Thin Client utilizará HTTP. Caso esse flag possua valor 1, o Web Thin Client utilizará HTTPS (SSL).

numOptWebPort Número de Porta TCP Opcional que o Web Thin Client deverá utilizar para trocar dados com o Web Server ao utilizar o Web Tunneling Gateway.

strOptGtwIP Endereço IP Opcional (ou hostname) do computador onde o Web Tunneling Gateway está rodando.

strOptSecondaryGtwIP Endereço IP Opcional (ou hostname) do computador onde o Web Tunneling Gateway está rodando. O Web Thin Client tentará conectar-se ao Web Tunneling Gateway nesse Endereço IP se não for capaz de conectar-se ao Web Tunneling Gateway rodando no endereço IP especificado no parâmetro strOptGtwIP.

strOptISSymbolURL URL Opcional de onde a tag databaseatualizada de ISSymbol ((Controle ActiveX) deve ser baixada caso não seja propriamente registrada na Web Thin Client station.


0 Sem Erro


2 Endereço IP do Server inválido

3 URL inválida


InduSoft Web Studio

Página 659

4 Caminho opcional inválido

5 Web pages não encontradas

• Exemplos:


Tag SetWebConfig( "192.168.1.28" )

Tag SetWebConfig( "192.168.1.28", "http://192.168.1.28" )

Tag SetWebConfig(GetComputerIP(), "http://"+GetComputerIP() )

Tag SetWebConfig( "192.168.1.28", "http://192.168.1.28/", "c:\MyWebPages\" )

Tag SetWebConfig( "192.168.1.28", "http://192.168.1.28/", "c:\MyWebPages\", 1234 )

Tag SetWebConfig ( "192.168.1.28", "http://200.0.0.10/", "c:\MyWebPages\", 1234, “192.168.1.29”, 0, 80, “200.0.0.1”, “200.0.0.10”, “http://200.0.0.10/MyISSymbol/” )

Nota: Pode-se utilizar tags ou Expressões como argumentos dessa função. Portanto, pode-se utilizar essa função para configurar os parâmetros da WEB automaticamente durante o runtime, de acordo com as configurações da rede de trabalho de cada projeto (IP address, Web Server URL, etc).

Somente o primeiro parâmetro dessa função é mandatório (strServerIP). Os outros parâmetros são opcionais. Os Parâmetros que não são configurados em uma função assumem os valores padrão configurados na janela Project → Settings → Web do ambiente de desenvolvimento.

Os seguintes parâmetros devem ser omitidos, a menos que você utilize o Web Tunneling Gateway: numOptProtocolFlag, numOptGtwPort, strOptGtwIP, strOptSecondaryGtwIP, strOptISSymbolURL.


InduSoft Web Studio

Página 660

Função Loop Essa função descreve a função Loop do InduSoft Web Studio: For(numInitialValue, numFinalValue, numStep) & Next

For(numInitialValue, numFinalValue, numStep) & Next

Grupo. Loop

Execução N/A



Web Thin Client N/A

• Descrição: Implementa um loop For junto a um script. A seção do script afetada pelo Loop For começa com a função For() e termina com a notação Next. A notação Next direciona o script para a função For() anterior.

• Parâmetros:

numInitialValue Tag numérico contendo o passo inicial (incremento) do Loop For.

numFinalValue Tag numérico contendo o passo final (incremento) do Loop For.

NumStep Tag numérico contendo o passo (incremento) do Loop For.

• Valores de Retorno: Retorna o passo no qual o loop está rodando atualmente.

• Exemplos:


Tag For( 1, 5, 1)

Next

Nota: Deve-se compartilhar muitas funções For() com uma notação Next . Como mostrado no exemplo, deve-se colocar a notação Next no campo do tag do script math.


InduSoft Web Studio

Página 661

Função Database Access Essa seção descreve a Função Database Access do InduSoft Web Studio, ForceTagChange(strTagName, numValue).

ForceTagChange(strTagName, numValue)

Grupo Database





• Descrição: Força o banco de dados a registrar um valor para um tag e atuar como se fosse uma alteração do tag, mesmo se o novo valor seja igual ao valor antigo.

• Parâmetros:

strTagName Tag String contendo o nome do tag alvo que será forçado a aceitar o novo valor.

numValue Tag contendo o novo valor a ser registrado no tag alvo.


• Exemplos:


ForceTagChange( “TagA”, 5 )


InduSoft Web Studio

Página 662

Funções ODBC Essa seção descreve as seguintes Funções ODBC do InduSoft Web Studio:

• ODBCBeginTrans(numHandler)

• ODBCBindCol(numHandler, strColName, strColType, strTagName)

• ODBCCanAppend(numHandler)

• ODBCCanTransact(numHandler)

• ODBCCanUpdate(numHandler)

• ODBCClose(numHandler)

• ODBCCommitTrans(numHandler)

• ODBCDelete(numHandler)

• ODBCExecuteSQL(numHandler, strSqlCommand)

• ODBCInsert(numHandler)

• ODBCIsBOF(numHandler)

• ODBCIsDeleted(numHandler)

• ODBCIsEOF(numHandler)

• ODBCIsFieldNULL(numHandler, strColName)

• ODBCIsFieldNullable(numHandler, strColName)

• ODBCMove(numHandler, numOffset)

• ODBCMoveFirst(numHandler)

• ODBCMoveLast(numHandler)

• ODBCMoveNext(numHandler)

• ODBCMovePrev(numHandler)

• ODBCOpen(strDsn, strUser, strPassw, strTable, strFilter, strSort)

• ODBCQuery(numHandler)

• ODBCROllback(numHandler)

• ODBCSetFieldNull(numHandler, strColName, numValue)

• ODBCSetFilter(numHandler, strFilter)

• ODBCSetSort(numHandler, strSort)

• ODBCUnbindCol(numHandler, strColName)

• ODBCUpdate(numHandler)

ODBCBeginTrans(numHandler)

Grupo ODBC





• Descrição: Inicia uma transação com a origem de dados de conexão.


InduSoft Web Studio

Página 663

• Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela função ODBCOpen().


0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Erro ao começar transação

• Exemplos:


Tag ODBCBeginTrans( 5 )

ODBCBindCol(numHandler, strColName, strColType, strTagName)

Grupo ODBC





• Descrição: Retém uma coluna para um tag. Cada vez que você finalize a retenção de colunas, a função ODBCQuery será solicitada.

• Parâmetros:


strColName Tag String contendo o nome da coluna do banco de dados.

strColType Tag String contendo a cláusula SQL do tipo de dados (uma das que se seguem):

• SQL_BIT • SQL_TINYINT • SQL_LONGVARCHAR • SQL_CHAR • SQL_VARCHAR • SQL_DECIMAL • SQL_NUMERIC

• SQL_DATE • SQL_TIME • SQL_TIMESTAMP • SQL_DOUBLE • SQL_REAL • SQL_SMALLINT • SQL_INTEGER


InduSoft Web Studio

Página 664

strTagName Tag String contendoo nome do tag a ser retido na coluna.


0 Sucesso


2 Tipo de parâmetro inválido

3 Um dos parâmetros possui uma string vazia

4 ColType contém um tipo inválido

• Exemplos:


Tag ODBCBindCol( 5, “OrderDate”, “SQL_DATE”, “Order_Date” )

ODBCCanAppend(numHandler)

Grupo ODBC





• Descrição: Retorna se o banco de dados permitirá a adição de novos registros.

• Parâmetros:



0 Banco de Dados não permite novos registros

Non-Zero Banco de Dados permite novos registros

• Exemplos:


Tag ODBCCanAppend( 5 )


InduSoft Web Studio

Página 665

ODBCCanTransact(numHandler)

Grupo ODBC





• Descrição: Retorna se o banco de dados permite transações.

• Parâmetros:



0 Banco de dados não permite transações.

Non-Zero Banco de dados permite transações.

• Exemplos:


Tag ODBCCanTransact( 2 )

ODBCCanUpdate(numHandler)

Grupo ODBC





• Descrição: Retorna se o banco de dados pode ser atualizado.

• Parâmetros:



0 Banco de dados não permite atualizações.


InduSoft Web Studio

Página 666

Non-Zero Banco de dados permite atualizações.

• Exemplos:


Tag ODBCCanUpdate( 6 )

ODBCClose(numHandler)

Grupo ODBC





• Descrição: Fecha uma conexão ao banco de dados.

• Parâmetros:



0 Sucesso


• Exemplos:


Tag ODBCClose( 5 )

ODBCCommitTrans(numHandler)

Grupo ODBC





• Descrição: Encerra uma transação. Solicite essa função após completar transações.


InduSoft Web Studio

Página 667

• Parâmetros:



0 Sucesso



3 Erro ao cometer transação

• Exemplos:


Tag ODBCCommitTrans( 1)

ODBCDelete(numHandler)

Grupo ODBC





• Descrição: Deleta o registro atual. Após uma deleção com sucesso. Você deverá explicitar um das seguintes funções Move para mover os registros deletados.

• Parâmetros:



0 Sucesso



3 Deleta erro


InduSoft Web Studio

Página 668

• Exemplos:


Tag ODBCDelete( 5 )

ODBCExecuteSQL(numHandler, strSqlCommand)

Grupo ODBC





• Descrição: Executa um comando SQL diretamente. A função ODBCExecuteSQL não retorna registros de dados.

• Parâmetros:


strSqlCommand Tag String especificando um comando SQL válido.


0 Sucesso




4 Erro na execução do comando SQL

• Exemplos:


Tag ODBCExecuteSQL( 3, “ )

Tag ODBCExecuteSQL( 4, “ )

ODBCInsert(numHandler)

Grupo ODBC


InduSoft Web Studio

Página 669





• Descrição: Insere um novo registro ao banco de dados. O InduSoft utiliza os valores dos tags em negrito na função ODBCBindCol para criar o novo registro.

• Parâmetros:



0 Sucesso



3 Inserir erro

• Exemplos:


Tag ODBCInsert( 7 )

ODBCIsBOF(numHandler)

Grupo ODBC





• Descrição: Retorna se você esteve acima do primeiro registro do conjunto de registros. (Solicite essa função antes de rolar de registro para registro.)

Também pode-se utilizar a função ODBCIsBOF com ODBCIsEOF para determinar se o conjunto de registros contém quaisquer registros ou se está vazio. Imediatamente após solicitar ODBCQuery, e caso o conjunto de registros não contiver registros, ODBCIsBOF retorna um valor diferente de zero. Ao abrir um conjunto de registros com, ao menos um registro, o primeiro registro será o registro atual, e ODBCIsBOF retornará zero (0). Caso o primeiro registro seja o registro atual, e você solicitar ODBCMovePrev, a função ODBCIsBOF subseqüentemente retornará o valor zero.

• Parâmetros:


InduSoft Web Studio

Página 670



0 Registro encontrado

Non-Zero Conjunto de registros não contém registros ou você rolou acima do primeiro registro

• Exemplos:

ODBCIsDeleted(numHandler)

Grupo ODBC





• Descrição: Relata se o registro atual foi deletado. Caso você role para um registro e ODBCIsDeleted retorna um valor diferente de zero, você deverá rolar para outro registro antes de poder executar quaisquer operações.

• Parâmetros:



0 Conjunto de registros não está posicionado ou um registro foi deletado.

Non-Zero Conjunto de registros está posicionado em um registro deletado.

• Exemplos:


Tag ODBCIsDeleted( 8 )


Tag ODBCIsBOF( 1 )


InduSoft Web Studio

Página 671

ODBCIsEOF(numHandler)

Grupo ODBC





• Descrição: Relata se você esteve acima do primeiro registro do conjunto de registros. (Solicite essa função antes de rolar de registro para registro.)

Também pode-se utilizar a função ODBCIsEOF para determinar se conjunto de registros contém algum registro ou se está vazio. Imediatamente após solicitar ODBCQuery (e se o conjunto de registros não contiver registros), ODBCIsEOF retornará um valor diferente de zero. Ao abrir um conjunto de registros com ao menos um registro, o primeiro registro é o atual e ODBCIsEOF retornará zero (0). Caso o último registro seja o registro atual quando você solicitar ODBCMoveNext, ODBCIsEOF subseqüentemente retornará zero.

• Parâmetros:



0 Registro encontrado.

Non-Zero Conjunto de registros não contém registros ou você rolou opostamente, antes do último registro.

• Exemplos:


Tag ODBCIsEOF( 5 )

ODBCIsFieldNULL(numHandler, strColName)

Grupo ODBC





• Descrição: Relata se um campo especificado em um conjunto de registros foi transmitido como Null.


InduSoft Web Studio

Página 672

• Parâmetros:


strColName Tag String contendo o nome da coluna.


0 O campo especificado não é transmitido como Null.

Non-Zero O campo especificado é transmitido como Null.

• Exemplos:


Tag ODBCIsFieldNULL( 7, “CustomerName”)

Tag ODBCIsFieldNULL( 3, “CompanyName”)

ODBCIsFieldNullable(numHandler, strColName)

Grupo ODBC





• Descrição: Relata se um campo especificado é nullable (pode ser configurado para um valor Null).

• Parâmetros:

NumHandler Tag Integer contendo o manuseador retornado pela função ODBCOpen().



0 O campo especificado não é transmitido como Nullable.

Non-Zero O campo especificado é transmitido como Nullable.

• Exemplos:


Tag ODBCIsFieldNullable( 1, “Price”)


InduSoft Web Studio

Página 673

Tag ODBCIsFieldNullable( 1, “Model”)

ODBCMove(numHandler, numOffset)

Grupo ODBC





• Descrição: Move o apontador do registro atual junto a um conjunto de registros, para frente e para trás. Caso você passe um valor de 0 para Offset, ODBCMove atualizará o registro atual.

• Parâmetros:


numOffset Tag Integer contendo o número de linhas para mover para frente e para trás.

• Valores positivos movem para frente, em direção ao final do conjunto de registros.

• Valores negativos movem para trás, em direção ao começo do conjunto de registros.


0 Sucesso



3 Mover erro

• Exemplos:


Tag ODBCMove(2, 3)

Tag ODBCMove(8, 2)

ODBCMoveFirst(numHandler)

Grupo ODBC


InduSoft Web Studio

Página 674





• Descrição: Move o primeiro registro junto ao conjunto de registros.

• Parâmetros:

NumHandler Tag Integer contendo o manuseador retornado pela função ODBCOpen().


0 Sucesso



3 Mover erro

• Exemplos:


Tag ODBCMoveFirst(4)

ODBCMoveLast(numHandler)

Grupo ODBC





• Descrição: Move o último registro junto ao conjunto de registros.

• Parâmetros:



0 Sucesso



InduSoft Web Studio

Página 675


3 Mover erro

• Exemplos:


Tag ODBCMoveLast(7)

ODBCMoveNext(numHandler)

Grupo ODBC





• Descrição: Move o próximo registro junto ao conjunto de registros.

• Parâmetros:



0 Sucesso



3 Fim do conjunto de registros pesquisados

4 Mover erro

• Exemplos:


Tag ODBCMoveNext(9)

ODBCMovePrev(numHandler)

Grupo ODBC



InduSoft Web Studio

Página 676




• Descrição: Move para o próximo registro junto ao conjunto de registros.

• Parâmetros:



0 Sucesso



3 Começo do conjunto de registros alcançados

4 Mover erro

• Exemplos:


Tag ODBCMovePrev(2)

ODBCOpen(strDsn, strUser, strPassw, strTable, strFilter, strSort)

Grupo ODBC





• Descrição: Abre uma conexão para o banco de dados.

Essa função retorna um manuseador a ser utilizado em solicitações subseqüentes para Funções ODBC. Após solicitor essa função, ainda nenhum registro foi lido do banco de dados. Você deverá encerrar as colunas e chamar a função ODBCQuery para que ocorra a entrega do primeiro registro.

• Parâmetros:

strDsn Tag String contendo o Nome do Data Source.

strUser Tag String contendo o Nome do Usuário.

strPassw Tag String contendo a Senha.


InduSoft Web Studio

Página 677

strTable Tag String contendo o nome da tabela do Banco de Dados.

strFilter Tag String contendo a cláusula do SQL: WHERE.

strSort Tag String contendo a cláusula SQL: ORDER BY.


N Se sucesso, retorna o manuseador para identificação do banco de dados

-1 Parâmetro inválido

-2 DSN ou TableName contém uma string vazia

• Exemplos:


Tag ODBCOpen(“MyDSNFile”, “Alex”, “”, “Table1”, “Name='Mayer'”, “Name ASC”)

Tag ODBCOpen(“DSNFileName”, “Robert”, “Robot”, “Table1”, “”, “”)

Nota: Essa função não abre o banco de dados sozinha, simplesmente cria um manuseador para a manipulação do banco de dados. Para abrir o banco de dados, deve-se encerrar as colunas e chamar a função ODBCQuery.

ODBCQuery(numHandler)

Grupo ODBC





• Descrição: Entrega o primeiro registro após a abertura e encerramento da coluna. Caso você modificar o encerramento da coluna ou o filtro e sort, você deverá chamar essa função novamente.

• Parâmetros:



InduSoft Web Studio

Página 678


0 Sucesso


2 Sem colunas em negrito

3 Não é possível abrir o banco de dados

4 Não é possível reiniciar o banco de dados

5 Perguntar sobre Erro

• Exemplos:


Tag ODBCQuery(6)

ODBCROllback(numHandler)

Grupo ODBC





• Descrição: Reverte as alterações feitas durante a transação.

• Parâmetros:



0 Sucesso



3 Erro ao voltar para a transação

• Exemplos:


Tag ODBCROllback( 4)


InduSoft Web Studio

Página 679

ODBCSetFieldNull(numHandler, strColName, numValue)

Grupo ODBC





• Descrição: Direciona um membro de dados de campo no conjunto de registros como Null (especificamente não tendo valor ou como non-Null.

• Parâmetros:



numValue Tag integer, o qual especifica os dados do campo como Null if 0 e non-Null em non-zero.


0 Sucesso




4 Nome da coluna inválido

• Exemplos:


Tag ODBCSetFieldNull(2, “Price”, 1)

Tag ODBCSetFieldNull(4, “CompanyName”, 0)

ODBCSetFilter(numHandler, strFilter)

Grupo ODBC





InduSoft Web Studio

Página 680


• Descrição: Retém os registros selecionados pelo IWS.

Essa função poderá ser útil para a seleção de um subconjunto de registros, como "all salespersons based in California" ("state = ‘CA’"). Lembre-se de solicitar ODBCQuery após chamar essa função.

• Parâmetros:


strFilter Tag String contendo a cláusula SQL: WHERE.


0 Sucesso



• Exemplos:


Tag ODBCSetFilter(3, “Name='Morgan'”)

ODBCSetSort(numHandler, strSort)

Grupo ODBC





• Descrição: Registros especificados selecionados pelo IWS.

Pode-se utilizar esse recurso para especificar os registros em uma ou mais colunas. Lembre-se de solicitar ODBCQuery após chamar essa função.

• Parâmetros:


strSort Tag String contendo a cláusula SQL: ORDER BY.


0 Sucesso


InduSoft Web Studio

Página 681



• Exemplos:


Tag ODBCSetSort(5,"Name DESC")

ODBCUnbindCol(numHandler, strColName)

Grupo ODBC





• Descrição: Desmembra uma coluna de um tag.

• Parâmetros:




0 Sucesso



3 Coluna sem limites

• Exemplos:


Tag ODBCUnbindCol(7, “Name”)

ODBCUpdate(numHandler)

Grupo ODBC


InduSoft Web Studio

Página 682





• Descrição: Atualiza o registro atual. O IWS utiliza os valores de tags bound pela função ODBCBindCol para atualizar o registro atual.

• Parâmetros:



0 Sucesso



3 Erro na atualização

• Exemplos:


Tag ODBCUpdate(1)


InduSoft Web Studio

Página 683

Funções Mail Essa seção descreve as seguintes Funções de Email do InduSoft Web Studio:

• CNFEMail(strSMTP, strFrom, strPOP3, strUser, strPassword, optnumTimeOut)

• GetStatusSendEMailExt(optTagName)

• SendEMail(strSubject, strMessage, strTO)

• SendEMailExt(strSubject, strMessage, strTO, strCC, strBCC, strFile1, ..., strFileN)

• CnfEmail( )

CnfEmail( strSMTP, strFrom, strPOP3, strUser, strPassword, optnumTimeOut, optnumAuthType,

optstrSMTPUser, optstrSMTPPassword )

Grupo Mail





• Descrição: Configura Parâmetros Simple Mail Transfer Protocol (SMTP). Deve-se configurar esses Parâmetros e executar essa função antes de enviar email com o IWS (e.x. pela função SendEmail(),SendEmailExt(), Interface Alarm Email interface, etc.).

• Parâmetros:

strSMTP Tag String contendo o nome do Server SMTP ou Endereço IP. Para aplicações em CEView, deve-se especificarO Endereço IP para SMTP IP ao invés do nome do server.

strFrom Tag String contendo o endereço do remetente. Esse endereço deverá ser um endereço de email válido para o Server POP3.

strPOP3 Tag String contendoo nome do Server POP3.

strUser Tag String contendo o nome da conta do usuário remetente para o Server POP3.

strPassword Tag String contendo a senha da conta do usuário para o Server POP3.

optnumTimeOut Tag Numérico opcional contendo o limite de timeout limit (em segundos) utilizado ao enviar mensagens. Caso nenhuma resposta seja recebida do Server após esse período de tempo, a operação será abortada automaticamente.


InduSoft Web Studio

Página 684

optAuthType Tag Numérico opcional contendo o Tipo de Autenticação SMTP:

0 (padrão) = Server SMTP não requisita autenticação

1 = Server SMTP requisita auteticação

optstrSMTPUser Tag opcional String contendo o Nome do Usuário utilizado para logar no Server SMTP quando esse requer autenticação. Caso esse parâmetro seja omitido a o tipo optAuthType esteja configurado para 1, o valor configurado para strUser será automaticamente utilizado como optstrSMTPUser.

optstrSMTPPassword Tag opcional String contendo a Senha utilizada para logar no Server SMTP quando esse requer autenticação. Caso esse parâmetro seja omitido a o tipo optAuthType esteja configurado para 1, o valor configurado para strPassword também será automaticamente utilizado como optstrSMTPPassword.


0 Sucesso

1 Formato inválido para parâmetro 1 (strSMTP)

2 Formato inválido para parâmetro 2 (strFrom)

3 Formato inválido para parâmetro 3 (strPOP3)

4 Formato inválido para parâmetro 4 (strUser)

5 Formato inválido para parâmetro 5 (strPassword)

6 Formato inválido para parâmetro 6 (optnumTimeOut)

7 Quantidade errada de Parâmetros

8 Erro na obtenção de Endereço IP host (invalid POP3 server)

9 Erro na conexão POP3 server

10 Erro no envio de nome do usuário

11 Erro no envio de senha

12 Server SMTP não suporta modo de autenticação Login\Password

13 Nome do usuário SMTP inválido

14 Falha na autenticação (Usuário e/ou senha inválidos)


InduSoft Web Studio

Página 685

• Exemplos:


Tag CnfEmail ( "smtp.Studio.com", "[email protected]", "pop.Studio.com", "RobertH", "Shades556",100)

Tag CnfEmail( "smtp.Studio.com", "[email protected]", "pop.Studio.com", "RobertH", "Shades556", 5 ,1)

Tag CnfEmail( "smtp.Studio.com", "[email protected]", "pop.Studio.com", "RobertH", "Shades556", 5 , 1 , “JohnS” , “abcd1234” )

GetStatusSendEMailExt(optTagName)

Grupo Mail





• Descrição: Retorna o status do último email enviado na função SendEmailExt().

• Parâmetros:

OptTagName Tag opcional que faz com que a função a ser atualizada retorne seu valor. Esse parâmetro é opcional, mas você deverá utilize-lo quando configurar essa função para qualquer dinâmico de tela (como Text I/O, Position, etc).


-2 Versão incorreta da biblioteca INDMail.DLL.

-1 A biblioteca INDMail.DLL está corrompida.

0 Função SendEmailExt()não está sendo executada.

1 Ainda enviando o último email. Não pode-se executar uma função SendEmailExt().

2 Último email foi enviado com sucesso. Pode-se executar a função SendEmailExt() novamente.

3 Houve um Erro no envio do último email. Execute a função SendEmailExt()novamente.


InduSoft Web Studio

Página 686

• Exemplos:


Tag GetStatusSendEMailExt(second)

Tag GetStatusSendEMailExt()

SendEMail(strSubject, strMessage, strTO)

Grupo Mail





• Descrição: Manda mensagens de email. Antes de executar essa função, deve-se configurar alguns Parâmetros utilizando a função CnfEmail()

• Parâmetros:

strSubject Tag String contendo o assunto do email.

strMessage Tag String contendo a mensagem do email (até 255 caracteres).

strTo Tag String contendo o endereço do destinatário (target).


0 Sucesso

1 Formato inválido para parâmetro 1 (strSubject)

2 Formato inválido para parâmetro 1 (strMessage)

3 Formato inválido para parâmetro 3 (strTo)

4 Quantidade errada de Parâmetros

5 Erro ao iniciar Socket

6 Erro na obtenção do Endereço host IP (server SMTP inválido)

7 Erro na conexão ao server SMTP

8 Erro no envio do comando HELO (inicialização)

9 Erro no envio do comando MAIL (enviando endereço FROM)

10 Erro no envio do comando RCPT (enviando endereço TO)


InduSoft Web Studio

Página 687

11 Erro no envio de DATA (enviando mensagem)

• Exemplos:


Tag SendEMail( “Subject”, “Message”, “[email protected]”)

SendEMailExt(strSubject, strMessage, strTO, strCC, strBCC, strFile1, ..., strFileN)

Grupo Mail





• Descrição: Envia mensagens de email com arquivos anexados. Antes de iniciar essa função, você deverá configurar alguns parâmetros utilizando a função CnfEmail().

• Parâmetros:

strSubject Tag String contendo o assunto do email (até 255 caracteres).

strMessage Tag String contendo a mensagem do email (até 255 caracteres).

strTO Tag String contendo o endereço do destinatário.

strCC Tag String contendo os endereços dos destinatários a serem CCed.

strBCC Tag String contendo os endereços dos destinatários a serem BCCed.

strFile (1-N) Tags String, cada uma contendo o nome e caminho do arquivo para enviar um email.


-4 Alguns dos arquivos anexados não foram encontrados.

-3 Número errado de parâmetros (são requisitados ao menos três parâmetros).

-2 A versão da biblioteca INDMail.DLL está incorreta.

-1 A biblioteca INDMail.DLL está corrompida.

0 Sucesso

1 Não é possível executar a função porque o último email ainda não foi


InduSoft Web Studio

Página 688

enviado.

2 Erro interno

• Exemplos:


Tag SendEMailExt(“Subject”, “Message”, “[email protected]”, “”, “”, “C:\Projects\report.txt”)

Tag SendEMailExt(“Subject”, “Message”, “[email protected]”, “[email protected]”, “[email protected]”, “C:\TechRef51.doc”)

Notas: Deve-se configurar os parâmetros Subject, strMessage, e strTO.Todos os outros parâmetros são opcionais.

Pode-se utilizar um valor nulo para a string ("") para strTO, strCC, ou parâmetros strBCC caso você não esteja utilizando-os.

Pode-se assinar mais de um destinatário nos parâmetros strTO, strCC, ou strBCC utilizando ponto e vírgula (;) para compartilhar endereços.


InduSoft Web Studio

Página 689

Funções Dial-Up Essa seção descreve as seguintes funções Dial-Up do InduSoft Web Studio:

• DialError(numType, strPhonebookEntryOrModem, optErro, optRefresh)

• DialGetClienDica(numType, strPhoneBookOrDevice, “tagClienDica”, optRefresh)

• DialGetServerIP(numType, strPhoneBookOrDevice, "tagServerIP", optRefresh)

• DialStatus(numType, strPhonebookEntryOrModem, optStatus, optRefresh)

• DialUp(numType, strPhonebookEntryOrModem, strUserName, strPassword, optstrDomain, strPhoneNumber)

• DialUpToCE(numModem, strDialPhone, strMyNumber, strUser, strPassword, optstrDomain, optAutoDial, optAutoClose)

• FindAllDevices(“tagArray”)

• FindModem("tagArray")

• HangUp(numType, strPhonebookEntryOrModem)

• PhoneDialUp(strPhoneNumber, OptStrModemName)

• PhoneDisableListen(optStrModemName)

• PhoneEnableListen(OptStrModemName)

• PhoneHangUp(OptStrModemName)

• PhoneStatus ("strStatus", optStrModemName)

DialError(numType, strPhonebookEntryOrModem, optErro, optRefresh)

Grupo Dial-Up





• Descrição: Retorna os códigos do erro referentes a cada conexão.

• Parâmetros:

numType Tag numérico especificando o tag o conteúdo do tag strPhonebookEntryorModem.

• 0: Phonebook • 1: Modem Name • 2: Direct Connection Name

strPhonebookEntryOrModem Tag String contendo um Phonebook Name, Modem Name, ou Direct Connection Name utilizado para estabelecer a conexão O tag numType especifica quais desses métodos serão utilizados.

optErro Tag String opcional contendo o nome do tag string recebendo a Mensagem de Erro.


InduSoft Web Studio

Página 690

optRefresh Tag opcional, que faz com que a função de atualização retorne seu valor. Esse parâmetros é opcional, embora você deverá utilize-lo ao configurar essa função para qualquer dinâmico de tela (como Text I/O, Position, etc).


0 OK

-1 Erro: INDRas.DLL não encontrado.

-2 Erro: INDRas.DLL danificado.

-3 Erro: número inválido de parâmetros (mínimo=2).

-4 Valor inválido para o parâmetro numType (0 ou 1).

-5 PhoneBook ou Modem não existem.

600 Uma operação está pendente.

601 A porta manuseadora não existe.

602 A porta já está aberta.

603 Buffer do Caller pequeno demais.

604 Informações de especificação erradas.

605 Não é possível configurar as informações da porta.

606 A porta não está conectada

607 O evento é inválido

608 O equipamento não existe.

609 O tipo de equipamento não existe.

610 O buffer está inválido.

611 A rota não está disponível.

612 A rota não está alocada.

613 Compressão especificada inválida.

614 Sem buffers.

615 A porta não foi encontrada.

616 Uma requisição Assíncrona está pendente.

617 A porta ou equipamento já está desconectando.

618 A porta não está aberta.


InduSoft Web Studio

Página 691

619 A porta está desconectada.

620 Não existem endpoints.

621 Não é possível abrir o arquivo phone book.

622 Não é possível carregar o arquivo phone book.

623 Não é possível encontrar a entrada do phone book.

624 Não é possível registrar o arquivo phone book.

625 Informação inválida encontrada no arquivo phone book.

626 Não é possível carregar uma string.

627 Não é possível encontrar a chave.

628 A porta estava desconectada.

629 O link de dados foi finalizado pela máquina remota.

630 A porta foi desconectada devido a falha no hardware.

631 A porta foi desconectada pelo usuário.

632 O tamanho da estrutura está incorreto.

633 A porta já está em uso ou não está configurada para Remote Access dial out.

634 Não é possível registrar seu computador em uma rede de trabalho remota.

635 Erro desconhecido.

636 O equipamento errado está anexado à porta.

637 A string não pode ser convertida.

638 A requisição possui timed out.

639 Não há net Assíncrona disponível.

640 Ocorreu um erro NetBIOS.

641 O server não pode alocar NetBIOS necessárias para suportar o cliente.

642 Um de seus nomes NetBIOS já está registrado na rede de trabalho remota.

643 Falha em um adaptador na rede de trabalho do server.

644 Você não receberá mensagens pop-ups de redes de trabalho.

645 Erro interno na autenticação.


InduSoft Web Studio

Página 692

646 Não é permitido efetuar log on dessa conta a essa hora do dia.

647 A conta está desabilitada.

648 A senha expirou.

649 A conta não possui permissão Remote Access.

650 O server Remote Access não está respondendo.

651 Seu modem (ou outro equipamento de conexão) relatou um Erro.

652 Resposta não reconhecida do equipamento.

653 Um macro requisitado pelo equipamento não foi encontrado na seção do arquivo .INF do equipamento.

654 Um comando ou resposta na seção do arquivo .INF refere-se a um macro indefinido.

655 <message macro não encontrado seção do arquivo .INF do equipamento.

656 <defaultoff macro seção do arquivo .INF do equipamento contém um macro indefinido.

657 O arquivo .INF do equipamento não pôde ser aberto.

658 O nome do equipamento no arquivo .INF ou .INI media é muito extenso.

659 O arquivo media .INI refere-se a um nome do equipamento desconhecido.

660 O arquivo .INF do equipamento não contém respostas para o comando.

661 O arquivo .INF do equipamento falta um comando.

662 Tentativa de configurar um macro não listado na seção do arquivo .INF do equipamento.

663 O arquivo media .INI refere-se a um tipo de equipamento Desconhecido.

664 Não é possível alocar memória.

665 A porta não está configurada para Remote Access.

666 Seu modem (ou outro equipamento de conexão) não está funcionando.

667 Não é possível ler o arquivo media.INI.

668 A conexão caiu.

669 O parâmetro utilizado no arquivo media .INI está inválido.


InduSoft Web Studio

Página 693

670 Não é possível ler o nome da seção do arquivo media .INI.

671 Não é possível ler o tipo de equipamento no arquivo media.INI.

672 Não é possível ler o nome do equipamento no arquivo media.INI.

673 Não é possível ler o uso do arquivo media .INI.

674 Não é possível ler a taxa de conexão máxima BPS do arquivo media .INI.

675 Não é possível ler a taxa de carrier máxima BPSdo arquivo media .INI.

676 A linha está ocupada.

677 Uma pessoa respondeu ao invés de um modem.

678 Não há resposta.

679 Não é possível detectar carrier.

680 Não há discagem em tone.

681 Erro geral reportado pelo equipamento.

682 ERRO_WRITING_SECTIONNAME

683 ERRO_WRITING_DEVICETYPE

684 ERRO_WRITING_DEVICENAME

685 ERRO_WRITING_MAXCONNECTBPS

686 ERRO_WRITING_MAXCARRIERBPS

687 ERRO_WRITING_USAGE

688 ERRO_WRITING_DEFAULTOFF

689 ERRO_READING_DEFAULTOFF

690 ERRO_EMPTY_INI_FILE

691 Acesso negado, pois o nome do usuário e/ou senha está inválido no domínio.

692 Falha no Hardware na porta ou equipamento anexado.

693 ERRO_NOT_BINÁRIO_MACRO

694 ERRO_DCB_NOT_FOUND

695 ERRO_STATE_MACHINES_NOT_STARTED

696 ERRO_STATE_MACHINES_ALREADY_STARTED

697 ERRO_PARTIAL_RESPONSE_LOOPING


InduSoft Web Studio

Página 694

698 Uma keyname de resposta no arquivo .INF do equipamento não está no formato esperado.

699 A resposta do equipamento causou overfluxo em buffer.

700 O comando ampliado no arquivo .INF do equipamento está muito extenso.

701 O equipamento moveu para uma taxa BPS Não suportada pelo driver COM.

702 Resposta do equipamento recebida quando não esperado.

703 A Aplicação não permite interação do usuário com requisições de conexão para ser completada com sucesso

704 ERRO_BAD_CALLBACK_NUMBER

705 ERRO_INVALID_AUTH_STATE

706 ERRO_WRITING_INITBPS

707 Indicação de diagnóstico X.25 .

708 A conta expirou.

709 Erro ao carregar a senha no domínio. A senha pode ser muito curta ou confunde-se com a senha do usuário anterior.

710 Erros Serial overrun foram detectados ao estabelecer comunicação com seu modem.

711 Inicialização RasMan falhou ao verificar o log do evento.

712 Porta Biplex inicializando: Wait a few seconds and redial.

713 Linhas ativas ISDN não disponíveis.

714 Canais ISDN disponíveis para fazer uma ligação.

715 Ocorreram muitos erros por causa de da qualidade pobre da linha telefônica.

716 A configuração IP para Remote Access IP é inutilizável.

717 Não há endereços IP disponíveis em static pool de endereços IP para Remote Access.

718 Timed out esperando por uma resposta válida do remote PPP peer.

719 PPP terminalizado por uma máquina remota.

720 Protocolos de controle PPP não configurados.

721 Remote PPP peer não está respondendo.


InduSoft Web Studio

Página 695

722 PPP packet está inválido.

723 O número de telefone incluindo prefixo e sufixo está muito extenso.

724 O protocolo IPX não pode efetuar dial-out na porta, pois a máquina é um roteador IPX.

725 O proptocolo IPX não pode efetuar dial-in na porta, pois o roteador IPX não está instalado

726 O protocolo IPX não pode ser utilizado para efeturar dial-out em mais de uma porta ao mesmo tempo.

727 Não é possível acessar TCPCFG.DLL.

728 Não é possível encontrar um adaptador em negrito IP para Remote Access.

729 SLIP Não pode ser utilizado a menos que o protocolo IP esteja instalado.

730 Registro do computador não está completo.

731 O protocolo não está configurado.

732 A negociação PPP não está convergindo.

733 O protocolo de controle PPP para esse protocolo de rede de trabalho não está disponível no server.

734 O link do protocolo de controle PPP finalizou.

735 O endereço requisitado foi rejeitado pelo server.

736 O computador remoto finalizou o protocolo de controle.

737 Loopback detectado.

738 O server não assinalou nenhum endereço.

739 O protocolo de autenticação requisitado pelo server remoto não pode utilizar a senha Redial encriptada do Windows NT, inserindo a senha explicitamente.

740 ConfiguraçãoTAPI inválida.

741 O computador local não suporta o tipo de encriptação requisitada.

742 O computador remoto não suporta o tipo de encriptação requisitada.

743 O computador remoto requer encriptação.

744 Não é possível utilizar o número da rede de trabalho IPX assinalado pela verificação do log de evento.

745 ERRO_INVALID_SMM


InduSoft Web Studio

Página 696

746 ERRO_SMM_UNINITIALIZED

747 ERRO_NO_MAC_FOR_PORT

748 ERRO_SMM_TIMEOUT

749 ERRO_BAD_PHONE_NUMBER

750 ERRO_WRONG_MODULE

751 Número de callback inválido. Somente os caracteres 0 a 9, T, P, W, (,), -, @, e space são permitidos no número.

752 Um erro de sintaxe foi encontrado ao processar um script.

753 A conexão não pôde ser desconectada, pois foi criada pelo Router Multi-Protocol.

• Exemplos:


Tag DialError(0, “Office DialUp”)

Tag DialError(1, “USRobotics_SportsterFaxModem”, “StatusMessage”, second)

Tag DialError(2, “DirectDial”, “DialupErro”)

DialGetClienDica(numType, strPhoneBookOrDevice, “tagClienDica”, optRefresh)

Grupo Dial-Up





• Descrição: Obtém o endereço IP para a Client station RAS de uma conexão Dial-Up. Deve-se executar essa função na Client station RAS (não na Server station RAS) ou a função não funcionará de maneira adequada.

• Parâmetros:

numType Tag Numérico especificando o conteúdo do tag strPhonebookEntryorModem.

• 0: Phonebook Name • 1: Modem Name • 2: Direct Connection Name


InduSoft Web Studio

Página 697

strPhonebookEntryOrModem Tag String contendo Phonebook Name, Modem Name, ou Direct Connection Name utilizado para efetuar a conexão. O tag numType especifica qual desses métodos será utilizado.

“tagClienDica” Nome do tag string que receberá o endereço IP.

optRefresh Tag opcional que faz com que a função atualize seu valor de retorno. Esse parâmetro é opcional, mas você deverá utiliza-lo ao configurar essa função para qualquer dinâmico de tela (como Text I/O, Position, etc).


-5 Função GetClienTip não encontrada em IndRAS.DLL.

-4 Tipo inválido (0: Phonebook, 1: Modem, 2: Direct Connection)


-2 Função DialStatus não encontrada em IndRAS.DLL

-1 IndRAS.DLL não foi carregado

N N: Código do status retornado pela função DialStatus()

• Exemplos:


Tag DialGetClineTip(0, “Office DialUp”, “ClienTipTag”)

Tag DialError(1, “USRobotics_SportsterFaxModem”, “ClienTipAddress”, second )

Tag DialError(2, “DirectDial”, “IPAdd”)

DialGetServerIP(numType, strPhoneBookOrDevice, "tagServerIP", optRefresh)

Grupo Dial-Up





• Descrição: Obtém o endereço IP para a Client station RAS de uma conexão Dial-Up. Deve-se executar essa função na Client station RAS (não na Server station RAS) ou a função não funcionará de maneira adequada.


InduSoft Web Studio

Página 698

• Parâmetros:




“tagServerIP” Nome do Tag string que recebe o endereço IP.



-5 Função GetServerIP não encontrada em IndRAS.DLL.

-4 Tipo inválido (0: Phonebook, 1: Modem, 2: Direct Connection)


-2 Função DialStatus não encontrada em IndRAS.DLL

-1 IndRAS.DLL não foi carregada

N N: Código do Status retornado pela função DialStatus()

• Exemplos:


Tag DialGetClineTip( 0, “Office DialUp”, “ClienTipTag” )

Tag DialError( 1, “USRobotics_SportsterFaxModem”, “ClienTipAddress”, second )

Tag DialError( 2, “DirectDial”, “IPAdd”)


InduSoft Web Studio

Página 699

DialStatus(numType, strPhonebookEntryOrModem,

optStatus, optRefresh)

Grupo Dial-Up





• Descrição: Retorna o status de cada conexão

• Parâmetros:

NumType Tag Numérico especificando o conteúdo do tag strPhonebookEntryorModem.



optStatus Nome do Tag string que recebe o endereço IP.



-5 PhoneBook ou modem não existem

-4 Valor inválido para o parâmetro numType (0 ou 1)

-3 Erro: número inválido de parâmetros (mínimo = 2);

-2 Erro: INDRAS.DLL danificado

-1 Erro: INDRAS.DLL não encontrado

0 Abrindo a porta...

1 Porta foi aberta com sucesso.

2 Conectando ao equipamento…


InduSoft Web Studio

Página 700

3 O equipamento foi conectado com sucesso

4 Todos os equipamentos na cadeia de equipamentos foram conectados com sucesso.

5 Verificando o nome do usuário e senha…

6 Ocorreu um evento de autenticação.

7 Outra validação requisitada na tentativa com um novo usuário.

8 Server requisitou um número callback.

9 O cliente requisitou alteração de senha

10 Registrando seu computador na rede de trabalho...

11 A fase de cálculo link-speed está inciando...

12 Uma requisitação de autenticação está sendo reconhecida.

13 Reautenticação (após callback) está sendo iniciada.

14 O cliente completou a autenticação com sucesso.

15 A linha fala sobre como desconectar-se de callback.

16 Atraso no envio do tempo de modem para reinício de callback.

17 Esperando por chamadas do server.

18 Informações do resultado da projeção disponíveis.

19 Autenticação do usuário está sendo inicializada ou reenviada.

20 Cliente foi chamado novamente e está para resumir autenticação.

21 Efetuando Log on para rede de trabalho...

22 Subentrada foi conectada.

23 Subentrada foi desconectada

24 Terminal state suportado por RASPHONE.exe.

25 Retry authentication state suportado por RASPHONE.exe.

26 Callback state suportado por RASPHONE.exe.

27 Altera password state suportado por RASPHONE.exe.

8192 Conectado ao server remoto com sucesso!

8193 Desconectado.


InduSoft Web Studio

Página 701

• Exemplos:


Tag DialError(0, “Office DialUp”)

Tag DialError(1, “USRobotics_SportsterFaxModem”, “StatusMessage”, second)

Tag DialError(2, “DirectDial”, “DialupErro”)

DialUp(numType, strPhonebookEntryOrModem, strUserName, strPassword, optstrDomain,

strPhoneNumber)

Grupo Dial-Up





• Descrição: Dispara uma conexão dial-up

• Parâmetros:

numType Tag Numérico especificando o contéudo do tag strPhonebookEntryorModem.



strUserName Tag String contendo o Username a ser utilizado para log on.

strPassword Tag String contendo Password a ser utilizado para log on.

optstrDomain Tag opcional String contendo o nome do domínio para especificar quando efetuar log on.

strPhoneNumber Tag String contendo o número do telefone a ser discado (utilizado somente quando o parâmetro numType=1).


InduSoft Web Studio

Página 702

Nota para usuários do Windows NT/2000: Devido a limitações no API da Microsoft, a função DialUp() poderá não ser capaz de criar phonebooks temporarios em Windows NT/2000.

Para lidar com esse problema:

1. Configure DialUp() utilizando o parâmetro Modem Name ao invés de Phonebook Name.

2. Crie um phonebook manualmente no Control Panel e salve-o como IWS Temporary 1.

IWS utilizará o phonebook IWS Temporary 1 com os parâmetros configurados com a utilização da função DialUp() (user name, password, domain, e telephone). Pode-se, então, alterar esses parâmetros durante o runtime.


0 OK: discagem iniciada



-3 Erro: número inválido de parâmetros (mínimo=5)

-4 Valor inválido para o parâmetro numType (0 or 1)

-5 Valor inválido para o parâmetro strPhonebookEntryOrModem (string)

-6 PhoneBook ou Modem não existem

-7 PhoneBook ou Modem estão em uso;

-8 Depende do parâmetro numType:

• If numType = 0: Não pôde ler propriedades de PhoneBook. • If numType = 1: Mais de 1000 conexões estão habilitadas ao mesmo

tempo.

-9 Incapaz de criar um PhoneBook temporário.

• Exemplos:

Nome do Tag

Expressão

Tag DialUp(0, “OfficeDialup”, “Guest”, “Password”)

Tag DialUp(1, ‘USRobotics_SportsterFaxModem”, “HR12378”, “HRPass”, “15125554321”)

Tag DialUp(2, “DirectDial”, “Rberton”, “MyPassword”, “156.48.25.0”)


InduSoft Web Studio

Página 703

Nota: O Server RAS do sistema operacional executa a discagem para computadores em Windows NT/2000/XP de forma automática.

DialUpToCE(numModem, strDialPhone, strMyNumber, strUser, strPassword, optstrDomain,

optAutoDial, optAutoClose)

Grupo Dial-Up





• Descrição: Executa o programa DialUpToCE, o qual envia as informações necessárias para CERasSvr.exe retornar para o computador em Windows NT/2000/XP.

• Parâmetros:

numModem Tag Numérico contendo o número do modem utilizado para discagem para o computador WinCE.

strDialPhone Tag Numérico contendo o número do telefone da estação remota do WinCE.

strMyNumber Tag Numérico contendo o número do telefone da estação remota do WinCE. CERasSvr.exe ligará de volta para o número desse telefone.

strUser Tag String contendo o nome do usuário a ser enviado para a estação remota do WinCE. CERasSvr.exe utilizará esse nome para conectar-se ao computador Windows NT/2000/XP após retornar a ligação.

strPassword Tag String contendo a senha a ser utilizada pela estação remota WinCE. CERasSvr.exe utilizará essa senha para conectar-se ao computador Windows NT/2000/XP após retornar a ligação.

optstrDomain Tag opcional String contendo o nome do domínio a ser especificado ao efetuar log on.

optAutoDial Tag opcional, o qual pode ser configurado para:

• 1: Disparar a conexão DialupToCE automaticamente quando a função é executada

• 0: Requisitar confirmação antes de disparar a conexão DialupToCE automaticamente quando a função é executada


InduSoft Web Studio

Página 704

optAutoClose Tag opcional, o qual pode ser configurado para:

1: Fechar o diálogo DialUpToCE automaticamente após discar para a estação remota do WinCE

0: Deixar o diálogo DialUpToCE aberto


0 Falha, incapaz de discar DialUpToCE.

1 Sucesso, DialUpToCE executado.

• Exemplos:


Tag DialUpToCE(0,”12344321”,”98765432”, ”Administrator”,”MyPass”)

Tag DialUpToCE(0,”12344321”,”98765432”, ”Administrator”,”MyPass”,””,1,1)

Nota: O programa DialUpToCE foi desenvolvido para discagem para uma estação remota WinCE. O Windows CE v3.00 não fornece um Server RAS, de maneira que você deverá estar rodando o programa CERasSvr.exe no equipamento WinCE para responder a uma chamada, e ligar novamente para um computador com Windows NT/2000/XP com a utilização dos parâmetros enviados pela função DialUpToCE(). Deve-se configurar o serviço RAS Server no computador Windows NT/2000/XP para retorno de chamada de um equipamento WinCE e configurando também a conexão TCP/IP.

FindAllDevices(“tagArray”)

Grupo Dial-Up





• Descrição: Retorna a lista de todos os modems disponíveis e interfaces de conexão direta (COM ports) na estação local.

• Parâmetros:

“tagArray” Nome de um tag de array string recebendo a lista de modems disponíveis e interfaces de conexão direta.


InduSoft Web Studio

Página 705

• Valores de Retorno: Retorna o número de modems e/ou interfaces encontradas.

• Exemplos:


Tag FindAllDevices(“SerialConnections[1]”)

FindModem("tagArray")

Grupo Dial-Up





• Descrição: Retorna a lista de todos os modems disponíveis na local station.

• Parâmetros:

“tagArray” Nome de um tag de array string recebendo a lista de modems diponíveis.

• Valores de Retorno: Retorna o número de modems encontrados.

• Exemplos:


Tag FindModem(“Modems[1]”)

Dica: Pode-se utilizar a função FindModem() para obter o nome da interface serial para uma conexão dial-up via modem, e utilizar essa informação para preencher o parâmetro strPhonebookEntryOrModem para as funções DialError(), DialStatus(), DialUp(), e HangUp().

HangUp(numType, strPhonebookEntryOrModem)

Grupo Dial-Up





InduSoft Web Studio

Página 706


• Descrição: Finaliza uma conexão dial-up.

• Parâmetros:




• Valores de Retorno: Essa função retorna os seguintes valores:

0 OK.



-3 Valor inválido para o parâmetro numType (0 ou 1)

-4 PhoneBook ou modem não existem

-5 Modems configurados não existentes

• Exemplos:


Tag HangUp(0, “OfficeDialup”)

Tag HangUp(1, ‘USRobotics_SportsterFaxModem”)

Tag HangUp(2, “DirectDial”, “Rberton”, “MyPassword”)

PhoneDialUp(strPhoneNumber, OptStrModemName)

Grupo Dial-Up






InduSoft Web Studio

Página 707

• Descrição: Disca para um número de telefone utilizando TAPI (Telephony Aplication Program Interface).

• Parâmetros:

strPhoneNumber Número do telefone ao qual a função ligará.

OptStrModemName Nome do modem utilizado para discar. Caso você não especifique um modem, o IWS utilizará p primeiro modem encontrado no Sistema Operacional.


0 OK (disdcagem disparada)


-3 Biblioteca INDTAPI.DLL não encontrada

-4 Função PhoneDialUp() não suportada pela biblioteca atual INDTAPI.DLL

• Exemplos:


PhoneDialUp (“512-123-4567”)

PhoneDialUp (StringPhoneNumberTag)

PhoneDialUp (StringPhoneNumberTag, StringModemNameTag)

PhoneDisableListen(optStrModemName)

Grupo Dial-Up





• Descrição: Desabilita o IWS de responder ao modem para chamadas a receber.

• Parâmetros:

OptStrModemName Nome do modem utilizado para discar. Caso você não especifique um modem, o IWS utilizará p primeiro modem encontrado no Sistema Operacional.



InduSoft Web Studio

Página 708

1 OK (pára a resposta para chamadas a serem recebidas)


-2 Função PhoneDisableListen() Não suportada pela biblioteca atual INDTAPI.DLL

• Exemplos:


PhoneDisableListen ()

PhoneDisableListen (“Hayes Compatible Modem on COM1”)

PhoneDisableListen (StringModemNameTag)

PhoneEnableListen(OptStrModemName)

Grupo Dial-Up





• Descrição: Habilita o IWS de responder ao modem para chamadas a receber.

• Parâmetros:

OptStrModemName Nome do modem utilizado para discar. Caso você não especifique um modem, o IWS utilizará o primeiro modem encontrado no Sistema Operacional.


1 OK (respondendo chamadas a receber)

0 Erro na execução da função PhoneEnableListen()


-2 Função PhoneEnableListen() Não suportada pela biblioteca atual INDTAPI.DLL

• Exemplos:


PhoneEnableListen ()


InduSoft Web Studio

Página 709

PhoneEnableListen (“Hayes Compatible Modem on COM1”)

PhoneEnableListen (StringModemNameTag)

PhoneHangUp(OptStrModemName)

Grupo Dial-Up





• Descrição: Finaliza uma conexão dial-up disparada com a função PhoneDialUp().

• Parâmetros:

OptStrModemName Nome do modem utilizado para discar. Caso você não especifique um modem, o IWS utilizará o primeiro modem encontrado no Sistema Operacional.


1 OK (a conexão discada foi modificada)


-2 Função PhoneHangUp()Não suportada pela biblioteca atual INDTAPI.DLL

• Exemplos:


PhoneHangUp()

PhoneHangUp (“Hayes Compatible Modem on COM1”)

PhoneHangUp (StringModemNameTag)

PhoneStatus ("strStatus", optStrModemName)

Grupo Dial-Up




InduSoft Web Studio

Página 710



• Descrição: Verifica o status das conexões atuais.

• Parâmetros:

“strStatus” Nome do tag que receberá o texto de descrição do status

optStrModemName Nome do modem utilizado para discar. Caso você não especifique um modem, o IWS utilizará o primeiro modem encontrado no Sistema Operacional.


0 “Ready to make a call”

1 “Call was shut down“

2 “Line Ringing“

3 “Dial Tone“

4 “Dialing Call“

5 “Call is Proceeding“

6 “Ring Back“

7 “Line is Busy“

8 “Line is Idle“

9 “Disconnected“

• Exemplos:


Tag Status Code

PhoneStatus (“String Tag Status”)

Tag Status Code

PhoneStatus (“String Tag Status”, “Hayes Compatible Modem on COM1”)

Tag Status Code

PhoneStatus (“String Tag Status”, “StringModemNameTag”)


InduSoft Web Studio

Página 711

Funções ActiveX Essa seção descreve as seguintes funções ActiveX do InduSoft Web Studio:

• XGet(strName, strProperties) 123

• XRun(strName, strMethod, Parameter1, Parameter2, …, ParameterN) 123

• XSet(strName, strProperties, Value) 124

• XGet(strName, strProperties)

• XRun(strName, strMethod, Parameter1, Parameter2, …, ParameterN)

• XSet(strName, strProperties, Value)

XGet(strName, strProperties)

Grupo ActiveX





• Descrição: Executa (PropGet) no objeto ActiveX especificado.

• Parâmetros:

strName Tag String contendo o único nome de dados ao objeto ActiveX alvo.

strProperties Tag String contendo o método específico a ser utilizado.

• Valores de Retorno: Retorna o valor da propriedade como relatada pelo objeto ActiveX.

• Exemplos:


Tag XGet(“ActXRec”, “Color”)

XRun(strName, strMethod, Parameter1, Parameter2, …, ParameterN)

Grupo ActiveX





• Descrição: Executa (Method) no objeto ActiveX especificado.


InduSoft Web Studio

Página 712

• Parâmetros:

strName Tag String contendo o único nome de dados ao objeto ActiveX alvo.

strMethod Tag String contendo o método específico a ser utilizado.

Parameter (1-N) Tag de vários tipos contendo dados requisitados por (Method) para rodar.

• Valores de Retorno: Retorna o resultado (Method) como reportado pelo objeto ActiveX (nem todos os métodos retornam resultados).

• Exemplos:


Tag XRun(“ActXCir”, “XPos”, 12, 4.6, 0.2, 1)

Nota: O número de parâmetros pode ser configurado na função XRun(). Podem variar de 0 a 255 e depende de cada componente ActiveX. Pode-se utilizar tags para configurar os parâmetros, mas os tipos de tags deverão corresponder aos tipos dos parâmetros do componente (Boolean, Integer, String, ou Real).

XSet(strName, strProperties, Value)

Grupo ActiveX





• Descrição: Executa (PropPut) no objeto ActiveX especificado.

• Parâmetros:

strName Tag String contendo o único nome dados ao objeto ActiveX alvo.

strProperties Tag String contendo o método específico a ser utilizado.

Value Tag of any type contendo o valor a ser colocado no objeto ActiveX



InduSoft Web Studio

Página 713

• Exemplos:


Tag XSet(“ActXDisplay”, “Display”, “Status Normal”)


InduSoft Web Studio

Página 714

Event Logger Funções Essa seção descreve a Função Event Logger do InduSoft Web Studio: SendEvent(strEvent).

SendEvent(strEvent, optBooFlag, optStrComment)

Grupo Event Logger





• Descrição: Utilize para enviar um evento para o arquivo Event Log.

Essa função possui uma opção que permite a criação de um comentário. Quando essa opção está habilitada, o usuário é requisitado a inserir um comentário após a execução da função SendEvent(). Tal comentário será salvo no arquivo Event Logger.

• Parâmetros:

strEvent String value ou tag contendo o texto a ser salvo no arquivo Event Log.

optBooFlag Se omitido ou igual a 0 (zero), o evento não possui um comentário. Do contrário, existirá um comentário associado ao evento.

optStrComment String de valor do tag contendo o texto do comentário para o evento salvo no banco de dados. Se omitido, o usuário receberá um diálogo padrão onde o comentário poderá ser digitado.


0 Sucesso

1 Logger de Evento está desabilitado no diálogo Event Settings.

2 Logger de Evento está habilitado, mas Custom Messages está desabilitado no diálogo Event Settings.

• Exemplos:


Tag SendEvent(“Valve Open”) // Salva a mensagem de evento.

Tag SendEvent(“Valve Open Oven No.” + OvenID) // Salva a mensagem de evento concatenada ao valor do tag OvenID

Tag SendEvent(“Valve Open”, 1) // Exibe um diálogo onde o operador


InduSoft Web Studio

Página 715

poderá digitar seus comentários.

Tag SendEvent(“Valve Open”, 1, TagComment) // Salva a mensagem de evento com comentário configurado no tag TagComment.

Atenção: Essa função é Síncrona. Portanto, a execução dessa função finaliza-se somente após os dados do evento (incluindo o comentário, caso exista) estarem salvos no arquivo do banco de dados. É recomendado que você não configure essa função em tarefas background (e.x. Math e Scheduler), a menos que você não planeje utilizar o comentário ou configurá-lo diretamente (digitando a partir do diálogo) na função.


InduSoft Web Studio

Página 716

Funções FTP Essa seção descreve as seguintes funções FTP:

• CNFFtp (strServer , strUser , strPwd , numPassiveMode , numPort)

• ftpGet (strRemoteFile , strLocalFile , numOverWrite , numTransferType)

• ftpPut (strLocalFile , strRemoteFile, numTransferType)

• ftpStatus (“strStatusTag”)

CNFFtp (strServer , strUser , strPwn , numPassiveMode , numPort)

Grupo FTP





• Descrição: Configura parâmetros FTP (File Transfer Protocol). Deve-se configurar esses

parâmetros e executar essa função antes de transferor arquivos com funções FtpGet ou FtpPut.

• Parâmetros:

strServer Nome do server FTP

strUser Nome do usuário

Padrão é Anonymous.

strPwn Senha do usuário

Padrão é blank.

numPassiveMode

0 – Modo passivo desabilitado

1 – Modo passivo habilitado

Padrão é 0.

numPort Número da Porta TCP/IP

Padrão é 21.


0 Sucesso


-2 Nome do server inválido

-3 Nome do usuário inválido


InduSoft Web Studio

Página 717

Nota: Essa função não tenta estabelecer uma conexão com o Server FTP, mas deve ser chamada antes de utilizar outra função FTP.

• Exemplos:


Tag CNFFtp(“ftp.mycompany.com”, “admin”, “12345”, 1) // Configura o server ftp utilizando o modo passive

ftpGet (strRemoteFile , strLocalFile , numOverWrite , numTransferType)

Grupo FTP





• Descrição: Essa função entrega um arquivo a partir do server FTP e armazena-o sob o nome do arquivo especificado, criando um novo arquivo local. Antes de executar essa função, deve-se configurar alguns parâmetros utilizando CNFFtp. Essa função é executada assincronicamente; Portanto, você precisará chamar FtpStatus de modo a determinar se a transferência foi completada com sucesso.

• Parâmetros:

strRemoteFile

Nome qualificado completo do arquivo remoto (e.x. “/Folder/File.extension”)

Note que alguns servers FTP são sensíveis a letras maiúsculas e minúsculas, de maneira que você terá que inserir a capitalização correta.

strLocalFile Nome qualificado completo do arquivo local (e.x. “C:\file.extension”)

numOverWrite

0 – Erro se o Arquivo Local já existe

1 – Sobreposto

Padrão é 0.

numTransferType

0 – Desconhecido

1 – ASCII

2 – Binário

Padrão é 0.


InduSoft Web Studio

Página 718


1 Falha ao criar fileira FTP

0 Sucesso


-2 Erro no sistema desconhecido

-3 Arquivo remoto inválido

-4 Arquivo local inválido

-5 Tipoo de transferência inválida

• Exemplos:


Tag FtpGet(“\Reports\040303.txt”, “C:\Report.txt”) // Entrega o arquivo 040303 da pasta Reports no Server FTP e armazena-o no arquivo C:\Report.txt

ftpPut (strLocalFile , strRemoteFile, numTransferType)

Grupo FTP





• Descrição: Essa função armazena um arquivo no server FTP. Antes de executar essa função, você deverá configurar alguns parâmetros utilizando CNFFtp. Essa função é executada assincronicamente, portanto, você precisará solicitar FtpStatus de modo a determinar se a transferência foi executada com sucesso.

• Parâmetros:

strLocalFile Nome qualificado completo do arquivo local (e.x. “C:\file.extension”)

strRemoteFile

Nome qualificado completo do arquivo remoto (e.x. “/Folder/File.extension”)

Note que alguns servers FTP são sensíveis a letras maiúsculas e minúsculas, de maneira que você terá que inserir a capitalização correta

optnumTransferType

0 – Desconhecido

1 – ASCII

2 – Binário

Padrão é 0.


InduSoft Web Studio

Página 719


1 Falha ao criar fileira FTP

0 Sucesso

-1 Número inválido de Parâmetros

-2 Erro no sistema desconhecido

-3 Arquivo remoto inválido

-4 Arquivo local inválido

-5 Tipo de transferência inválida

• Exemplos:


Tag FtpPut(“C:\Report.txt”, “\Reports\040303.txt”) // Entrega o arquivo “C:\Report.txt” com o nome 040303.txt na pasta Reports no Server FTP.

ftpStatus ( “strStatusTag” )

Grupo FTP





• Descrição: Essa função retorna o status atual de uma transação iniciada com FtpGet or FtpPut. O valor de retorno indica o status como descrito abaixo.

• Parâmetros:

“strStatusTag” String com descrição de satus.


1 Transação executada com sucesso

2 Resolvendo nome

3 Nome resolvido

4 Conectando ao server

5 Conectado ao server

6 Fechando conexão

7 Conexão fechada

8 Enviando requisição

9 Requisição enviada

10 Recebendo resposta


InduSoft Web Studio

Página 720

11 Resposta recebida intermediária

12 Resposta recebida

13 Requisição completada

0 Nenhuma transação está sendo executada.

-2 Descrição opttagErro inválida

-6 Erro na abertura da conexão (veja string status para detalhes)

-7 Erro no estabelecimento da conexão (veja string status para detalhes)

-8 Erro no recebimento do arquivo (veja string status para detalhes)

-9 Transferência em pendência

• Exemplos:


Tag FtpStatus( “StatusDescrição” ) // Entrega o status da transfrência atual. O código de retorno é armazenado no tag StatusCode e a Descrição no tag StatusDescrption.


InduSoft Web Studio

Página 721

Funções do Banco de Dados Essa seção descreve as funções do Banco de Dados do InduSoft Web Studio:

SyncAlarm(strOptionalStartDate, strOptionalEndDate)

SyncEvent(strOptionalStartDate, strOptionalEndDate)

SyncTrend(numGrupo, strOptionalStartDate, strOptionalEndDate)

SyncAlarmStatus

SyncEventStatus

SyncTrendStatus(numGrupo)

SyncAlarm( strOptionalStartDate, strOptionalEndDate)

Grupo Database





• Descrição: Sincroniza o banco de dados alarm [Event, Trend].

• Parâmetros:

strStartDate String com a data de início. Caso esse parâmetro não esteja especificado, a data atual é utilizada.

strOptionalEndDate String com a data final. Caso esse parâmetro não esteja especificado as funções utilizam a mesma data de início.


1 Falha ao iniciar sincronização; o banco de dados provavelmente está sendo sincronizado.

0 Sucesso

-1 Número do grupo inválido

-2 O formato não está configurado para “Database.”

-4 Data de início especificada inválida.

-5 Data final especificada inválida.

-6 Data de início é maior que data final.


InduSoft Web Studio

Página 722

• Exemplos:


Tag SyncAlarm() //Sincroniza o banco de dados utilizando a data atual

Tag SyncAlarm(“10/20/2004”) //Sincroniza o banco de dados somente para o dia 10/20/2004

Tag SyncAlarm(“10/20/2004”, “10/28/2004”) //Sincroniza o banco de dados de 10/20/2004 até 10/28/2004

SyncEvent( strOptionalStartDate, strOptionalEndDate)

Grupo Database






• Parâmetros:

strOptionalStartDate String com a data de início. Caso esse parâmetro não esteja especificado, a data atual é utilizada.




0 Sucesso







InduSoft Web Studio

Página 723

• Exemplos:


Tag SyncEvent() //Sincroniza o banco de dados utilizando a data atual

Tag SyncEvent(“10/20/2004”) //Sincroniza o banco de dados somente para o dia 10/20/2004

Tag SyncEvent(“10/20/2004”, “10/28/2004”) //Sincroniza o banco de dados de 10/20/2004 para 10/28/2004

SyncTrend(numGrupo, strOptionalStartDate, strOptionalEndDate)

Grupo Database






• Parâmetros:

numGrupo Número do grupo Trend

strOptionalStartDate String com a data de início. Caso esse parâmetro não esteja especificado, a data atual é utilizada.




0 Sucesso







InduSoft Web Studio

Página 724

• Exemplos:


Tag SyncTrend(1) //Sincroniza o grupo 1 do banco de dados utilizando a data atual

Tag SyncTrend(1, “10/20/2004”) //Sincroniza o grupo 1 do banco de dado somente para o dia 10/20/2004

Tag SyncTrend(“10/20/2004”, “10/28/2004”) //Sincroniza o grupo 1 do banco de dados de 10/20/2004 a 10/28/2004

SyncAlarmStatus( )

Grupo Database





• Descrição: Retorna o status de sincronização.


3 Sincronização finalizada.

2 Falha na sincronização

1 Ainda sincronizando

0 Sincronização não está sendo executada.


• Exemplos:


Tag SyncAlarmStatus()


InduSoft Web Studio

Página 725

SyncEventStatus( )

Grupo Database







3 Sincronização finalizada.





• Exemplos:


Tag SyncEventStatus()

SyncTrendStatus(numGrupo)

Grupo Database






• Parâmetros:

numGrupo Número do grupo Trend


3 Sincronização finalizada.. volume


InduSoft Web Studio

Página 726





• Exemplos:


Tag SyncTrendStatus(1)

Histórico de Revisões Revisão Autor Data Comentários

A Bruno Cervantes 14 de março de 2007 Revisão português

B Bruno Cervantes 20 de junho de 2007 Formato IWS