727
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  

Manual Portugues ISW v6.1sp2-727pag

Embed Size (px)

Citation preview

Page 1: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 1/725

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 

Page 2: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 2/725

InduSoft Web Studio 6.1 sp2IWS 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 nosEstados Unidos da América e outros países.

 Todas as outras marcas ou nomes de produtos são registros ou marcas registradas de seus respectivosfabricantes.

Page 3: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 3/725

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

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  

Page 4: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 4/725

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

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  

Page 5: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 5/725

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

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  

Page 6: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 6/725

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

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  

Page 7: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 7/725

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

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 

Page 8: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 8/725

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

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  

Page 9: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 9/725

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

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 

Page 10: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 10/725

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

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; webserver e data server em estações diferentes ................................................................497  

 Arquitetura 3: Servidores Redundantes e Web Thin Client stations na mesma rede detrabalho .............................................................................................................................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  

Page 11: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 11/725

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

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  

Page 12: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 12/725

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

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çõesté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 habilidadesté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 deprover 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 doproduto, os tipos de tags (arrays, classes e pointers), valores e parâmetros de tags. Seguindo osconceitos 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 econfigurar um novo projeto na Aplicação.

•  Capítulo 7. Configurando Telas e Gráficos: Explica como utilizar as diferentes ferramentas dedesenvolvimento 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 diferentesplanilhas 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 eescrever as variáveis de tags de sua aplicação, para ou a partir da memória do equipamento. Asinformações incluem instruções para configuração de drivers de comunicação OPC, TCP/IP, eDDE (troca de dados dinâmicos).

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

•  Capítulo 12. Testando e Corrigindo Erros de sua Aplicação: Discute como testar e corrigir errosde 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 ecorrigir erros das Aplicações, a partir de estação de trabalho de runtime remota.

Page 13: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 13/725

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

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 de200 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 WebStudio 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, descrevealguns erros de desenvolvimento comuns e explica o que fazer caso seja necessário entrar emcontato com um representante da equipe de suporte.

•  Apêndice As. Funções do Studio: Contém tabelas e informações, as quais descrevem asdiferentes 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ácilcompreensão, fornecendo informações úteis tanto para novatos quanto para usuários experientes doInduSoft Web Studio.

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

•  Usuários Experientes: Essa publicação oferece instruções avançadas , dicas e informaçõessobre correção de erros para ajudar na obtenção de resultados satisfatórios nas Aplicaçõesconstruí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).

Page 14: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 14/725

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

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 typefacenarrow 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 queprecede a nota) para auxiliar na obtenção de maiores informações para a compreensão deum 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ãodo Windows que requer a utilização de um mouse, essa publicação partirá do princípio de que ousuário esteja utilizando um mouse. Geralmente, o mouse do PC é configurado de forma tal que obotã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 é iguala 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 pelasopçõ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, utilizeas 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çãoInduSoft 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.

Page 15: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 15/725

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

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). Ocí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 oudesaperece 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 emCancel 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 SymbolLibrary.

 Alguns botões estão duplicados, o que significa que clicar o botão é umrecurso, 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çõesselecioná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.

Page 16: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 16/725

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

InduSoft Web Studio Página 15

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

Recurso Descrição

PublicaçõesRelacionadas

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

•  Guias do Usuário de Drivers Individuais: Explica comoconfigurar drivers individuais InduSoft, de acordo com suascaracterísticas únicas de protocolo. Um guia do usuáriocostumizado está incluído em cada driver InduSoft. Essaspublicações são fornecidas no subdiretório DRV da pasta doInduSoft 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, comrespostas sobre o InduSoft Web Studio. 

Site da InduSoft Visite o site www.InduSoft.com para mais informações sobre osprodutos InduSoft, downloads e demos disponíveis, FAQ doproduto, 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écnicoOs engenheiros especializados em suporte da InduSoft estão empenhados em resolver quaisquer dúvidas equestões a respeito dos produtos rápida e acuradamente. Nossos centros de suporte técnico localizam-seem 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. 26Email: [email protected]  

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

•  Suporte Eletrônico

•  Suporte via telefone

•   Atualização das versões do Produto

Page 17: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 17/725

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

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 depreferência

E-mail  Telefone  Celular   Outro 

Setor Industrial (Por exemploAutomotivo, Farmacêutico,Fabricante):

Número de estaçõessupervisionadas:

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 doModelo

Procesador 

Relógio

Memória RAM

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

Page 18: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 18/725

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

InduSoft Web Studio Página 17

Ambiente do Computador (cont.):

Tópico  Sub-Item  Características 

Software Hardware doSistema Operacional

 Tipo

 Versão

Pacote deServiços

Linguagem

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

Tópico  Sub-Item  Características 

Software Microsoft Internet Explorer Hardware

Software

 Versão

Pacote deServiços

LinguagemOutras informações com as quais nossos engenheiros podemcolaborar sobre a instalação do Microsoft Internet Explorer:

Tópico  Sub-Item  Características 

Software InduSoft Hardware

Software

 Versão

Pacote deServiços

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

Page 19: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 19/725

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

InduSoft Web Studio Página 18

Ambiente do Computador (cont.):

Tópico  Sub-Item  Características 

Software CEView Hardware

Software

 Versão

Pacote deServiços

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

Descrição do Problema:

Formulário de Informações sobre o Cliente

Page 20: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 20/725

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

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 odesenvolvimento 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 ouprocessadores através de controladores programáveis, equipamentos remotos de I/O e outros equipamentospara aquisição de dados.

Essas aplicações consistem em telas de interface operadoras, drivers de PLC configurável (controlador lógicoprogramá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 umsistema de segurança. A interface da Aplicação do IWS com sistemas I/O industriais e outras aplicações emmodo 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âmetrosdefinidos 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 PCindustrial 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ê podeatualizar a versão do CEView do software do sistema de desenvolvimento, fazendoo download da versão atual para a IHM.

Page 21: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 21/725

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

InduSoft Web Studio Página 20

Recursos do ProdutoO 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 como 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çãoo  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, tagsde 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

Page 22: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 22/725

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

InduSoft Web Studio Página 21

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

•  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-sefacilmente 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 doInduSoft Web Studio para informações mais detalhadas sobre as limitações de cada umdos produtos.

Page 23: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 23/725

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

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 oCEView™.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 umdownload 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 seudrive 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, oIWS 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 doCEView 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 umdiretório diferente). Além disso, não pode-se instalar a mesma versão do IWS em dois caminhosdiferentes 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 maisatualizado

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ãorecomendadas

o  MS Internet Explorer 6.0 ou mais atualizado

Page 24: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 24/725

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

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 RAMde Video (VRAM) ou maiores

o  Equipamento de apontamento (mouse, trackball ou touch-screen) Microsoft-compatívelo   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 emdispositivos melhorados pelo sistema operacional do Windows CE (WindowsCE v3.0 ou Windows CE .NET) como IHMs industriais ou PDAs (PocketPC).Consulte o vendedor de hardware para obter seus requisitos ao rodar suasaplicações sob sistema operacional Windows CE.

•  Além do sistema operacional descrito acima, a estação Web Thin Client podemrodar 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.

Page 25: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 25/725

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

InduSoft Web Studio Página 24

Instalando o IWSUtilize 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 arquivoSetup.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ópriasaplicaçõ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çõesfornecidas 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).

Page 26: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 26/725

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

InduSoft Web Studio Página 25

  Na janela Welcome to Indusoft , clique no link  Installation , e depois no link do InduSoft WebStudio 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 torestart 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 detrabalho ou selecione Start → All Programs → InduSoft Web Studio InduSoft Web Studio para 

iniciar o programa do IWS.

Page 27: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 27/725

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

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 maisconvidativo. 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 oPacote 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 doCEView 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 doCEView 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 arquivospara 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 

Page 28: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 28/725

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

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 WebStudio\Redist\CEView\<Processou Type>\BIN no computador com WinNT/2000/XP onde oIWS 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 contatocom 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 ouPorta 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.

Page 29: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 29/725

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

InduSoft Web Studio Página 28

Desisntalando o InduSoft Web Studio e CEViewCaso 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 osarquivos 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 reinstaladosmais tarde caso seja necessário.

   A partir da barra de tarefas do Windows, selecione Start Settings Control Panel para abrir oControl 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.

Page 30: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 30/725

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

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 W indows 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.)

Page 31: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 31/725

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

InduSoft Web Studio Página 30

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

Licenciando seu ProdutoEssa 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 asferramentas de gerenciamento remoto do IWS para fazer o download de arquivos deruntime 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 v 5.0+SP1 e CEView v 5.0+SP1)

Onde:

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

•  Y: Representa a  Sub-version: A Sub-Versão altera-se que melhorias menores e/ou novosrecursos 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 incluitodo o Conteúdo do SP1 e todos os arquivos recentemente atualizados, correção de erros emelhorias. SP3 inclui todos os conteúdos de SP2 e todos os arquivos atualizados, correçãode erros, melhorias, e assim por diante.

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

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

Page 32: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 32/725

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

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  doProduto. 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á sendoinstalada. 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çãoO 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 

Page 33: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 33/725

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

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ê rodeum modulo de produto (engenheiro ou runtime). Pode-se utilizar esse peróido de validação deforma 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 IWSautomaticamente 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 decada 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 mesmocomputador, 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çõesremotas, 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 estasdesliguem automaticamente após rodarem por duas horas ininterruptas. Você pode reiniciar oDemo 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 DemoMode.

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

Arquivo Vizualização Projeto Ferramentas Ajuda

 Abrir ProjetoFechar 

Barra FerramentasZoom

Biblioteca 

ConfiguraçõesStatusRodar 

 AplicaçãoParar  Aplicação

Enviar Projetopara  Alvo

Execução AmbienteLogon

Controles deRegistroConverter 

Resolução Verificar  AplicaçãoInformações doSistema 

 Todas asopçõ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 deerros (Database Spy , output window, e módulo LogWin ) por 24 horas, continuamente. Após

Page 34: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 34/725

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

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 deruntime 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 suportadospara aquela licença. Consulte seu vendedor de software sobre quais tipos de produtoestã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 Modode Execução que está em andamento. A tela About InduSoft Web Studio contém informações sobreo Modo de Execução atual. Caso esteja rodando o modo Evaluation , o tempo remanescente deexecução aparecerá no campo Modo de Execução.

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

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

Tipo de Proteção InduSoft Web Studio CEView

Hardkey 

Softkey 

Page 35: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 35/725

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

InduSoft Web Studio Página 34

= Aplica ; = Não aplica 

•  Hardkey: Um chip encapsulado que deve ser fisicamente conectado a uma porta paralela docomputador (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 aocomputador, e então conecta o cabo da impressora no hardkey. Porém, podem ser encontradosproblemas 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 antesde 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 umcó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 seucomputador (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 (comoum 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ãodisponí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 seudesenvolvimento. 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 suportadossimultaneamente 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 devesuportar esses Web Thin Clients adicionais.

Page 36: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 36/725

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

InduSoft Web Studio Página 35

•  Number of Thin Clients (Secure Viewer): Especifica quantos Thin Clients são suportadossimultaneamente 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 devesuportar 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, ou256 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 aoservidor 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 StudioEssa 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 foiinstalado.

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

  Rode o InduSoft Web Studio.

Atualizando a Licença de Hardkey AtualPara 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 nocomputador onde o IWS está instalado.

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

  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

Page 37: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 37/725

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

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) ouinterface USB, o diálogo Hardkey Settings aparecerá, contendo as configurações da licença atual gravadasno 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 nobotã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

Page 38: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 38/725

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

InduSoft Web Studio Página 37

  Nota:Caso seu novo Site Key não esteja válido, uma mensagem de erro aparecerá. Casoisto aconteça, verifique se você digitou o Site Key  corretamente. Caso tenha sidodigitado 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 , ouNúmero de Web Thin Clients ) simultaneamente suportados pelo servidor, ou atualizar a versão dosoftware que esteja sendo suportada atualmente. O custom da atualização dependerá dasconfiguraçõ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 StudioEssa 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 desoftkey.

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 fornecidasanteriormente 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, odiálogo Register  aparecerá com a mensagem “Warning: this will change theprotection method of the software. Continue anyway?”.

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

O diólogo Softkey Settings aparecerá.

Page 39: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 39/725

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

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  nocampo 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 seguintemensagem 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 softwarepara maior assistência.

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

Page 40: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 40/725

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

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 nomesmo 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 rodeo 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. Asinformações do caminho especifíco aparecerá automaticamente na caixa de texto Path na seçãoOld Version.

Encontrando o Softkey Instalado Anteriormente

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

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

Page 41: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 41/725

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

InduSoft Web Studio Página 40

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

  Execute o módulo Register ( Register) para a versão mais recente instalada do InduSoft WebStudio (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 qualestá sendo suportado. O custom de atualização dependerá das configurações de sua licança atual, assimcomo das configurações de sua licança a ser atualizada.

Page 42: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 42/725

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

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álogoChange 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á. Casoacontecer, verifique se você digitou o código local corretamente. Se a mensagemainda permanecer, entre m contato com o vendedor do software para maior assistência.

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

Page 43: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 43/725

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

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 ehabilitada. 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 doequipamento WinCE.

  Após instalar o IWS no computador com WinNT/2000/XP, o arquivo do programa  RemoteAgent (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\InduSoftWeb 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émdisso, 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>).

Page 44: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 44/725

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

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 umequipamento WinCE. Você também pode fazer o download do ActiveSync  no site da Microsoft.

Pode-se utilizar a sintaxe a seguir para mapear uma pastacompartilhada 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 ocomando COPY para copiar os arquivos para o WinCE.

Recomendamos que você configure o equipamento WinCE para que seja executadoo 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 oequipamento 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

Page 45: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 45/725

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

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 nocampo 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 digitadocorretamente. Se a mensagem de erro ainda assim persistir, entre em contatocom o vendedor do software para maior assistência.

Page 46: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 46/725

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

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 seguinteprocedimento:

  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 aoequipamento 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, quandocomparados a links seriais.

Page 47: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 47/725

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

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 instaladasatualmente em seu equipamento WinCE.

CEView License Settings

  Na seção License Codes do diálogo Execution Environment , copie as informações exibidas nocampo 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 SiteKey.

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 enviadopelo InduSoft Web Studio. Caso o código local seja aceito (validado), a seguinte mensagem aparecerá:

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

Page 48: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 48/725

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

InduSoft Web Studio Página 47

  Nota:Caso o novo código local não seja válido, uma mensagem de erro aparecerá. Casoaconteç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 asconfigurações de registro foram salvas. Caso essas configurações não sejamsalvas, você perderá a licença quando reiniciar o equipamento.

Page 49: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 49/725

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

InduSoft Web Studio Página 48

Capítulo 3: Trabalhando com o Ambiente deDesenvolvimento 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: 

Page 50: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 50/725

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

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êmalguns 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 íconeda 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 dedesenvolvimento 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 trabalhoefetuado. 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.

Page 51: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 51/725

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

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 atalhospara 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 defornecer 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çãosempre 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 ouselecionar File → Print para abrir o diálogo Print .

Page 52: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 52/725

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

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 itemno 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 seguintemenu 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 menuFile.

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 noBotã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.

Page 53: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 53/725

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

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 outrolocal 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 diferentestarefas junto ao programa. Essa seção descreve a função e o local padrão de cada barra deferramentas.

•   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 aolongo 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çõessã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 doIWS) fornecerá uma breve descrição daquele Botão.

Page 54: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 54/725

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

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 dedesenvolvimento.

 Workspace contém quatro tabs:

•  Database: Provê acesso a todos os tags do banco de dados e components do sistema deseguranç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 outroequipamento 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ãoorganizados 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 cliqueno 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 dotags database da   Aplicação :

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

Page 55: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 55/725

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

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 Developmentpara abrir o diálogo Group Account  

Duplo-clique Datasheet Viewpara abrir a Application Tags  Worksheet

Duplo-clique Main.scr paraabrir a tela de exposiçãoMain.scr  

Page 56: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 56/725

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

InduSoft Web Studio Página 55

Tab Database

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

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

 Dica: Pode-se escolher os dados nas planilhas de Tags da   Aplicação e/ou inserir/remover colunas adicionaisclicando-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 queum único valor) ao objeto.

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

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

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

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

•  Security: Contém contas de segurança de todos de um grupo ou deusuá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 osprocedimentos 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 tagsexistents para abrir um diálogo Properties . Pode-se também utilizar os parâmetros nessediá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 emum grupo ou nome de usuário. Quando aparecer o diálogo Group Account /User Account , utilize osparâmetros do diálogo para alterar as propriedades da conta existente.

Page 57: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 57/725

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

InduSoft Web Studio Página 56

  Notas:Capítulo 5: Trabalhando com Tags fornece instruções para criar e editar tags no bancode 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, esí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 (individuaiscombinadas a grupos gerenciáveis) criadas para a aplicaçãoatual (Note: Grupos de tela não estão disponíveis para  Windows CE.)

•  Web Pages: Contém todas as web pages (telas salvas emformato 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-secriar símbolos customizados para a aplicação e salvá-losnessa 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 noseventos

•  Library: Contém uma biblioteca de símbolos comuns e gráficos fornecidos juntamente aoInduSoft 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 maisadiante nesse capítulo (“Utilizando o Editor de Tela/Planilha ” na página 59) e no Capítulo 7: “Configurando Telas e Gráficos” .

Page 58: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 58/725

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

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 alarmeda 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 quaistags devem ter seus valores armazenados em disco, e tambémpara a criação de arquivos históricos para gráficos detendência. O IWS armazena as amostras em um arquivohistórico binário (*.hst), e exibe ambos em amostrashistó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 comoos 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ãoenviados para uma impressora ou disco. Tarefas de relatório permitem a configuração derelató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 dadossuportem a interface ODBC.

•  Math: Contém planilhas Math  utilizadas para configurar e implementar métodos de trabalhoadicionais 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 adicionaispara 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 quedevem ser executadas quando a aplicação estiver iniciandoContém planilhas

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

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 .

Page 59: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 59/725

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

InduSoft Web Studio Página 58

Tab Communications

Selecione o tab Communications  para acessar todos osdrivers configurados para a sua Aplicação. Drivers sãoutilizados para estabelecer comunicação com outros

equipamentos ou programas de software utilizandoprotocolos disponíveis.

Esse tab contém as seguintes pastas:

•  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 (comoum PLC ou transmissores).

Communication driver é um arquivo .dll que contéminformações específicas a respeito de equipamentosremotos, além de implementar o protocolo decomunicação.

•  OPC: Contém planilhas OPC utilizadas para configurar interfaces OPC entre a Aplicação e umOPC. 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 OPCpadrã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 seusbancos 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çãoDDE 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 entreaplicaçõ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 dadosde string em formato UNICODE. Caso o DDE Server acomode dados de string emformato ASCII ANSI, os seguintes parâmetros devem ser configurados manualmente noarquivo <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 .

Page 60: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 60/725

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

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 planilhaspara suas aplicações. Você poderá inserir informações utilizando seu mouse e teclado, retirar dadosde 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çãode 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 partede sua aplicação.

Page 61: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 61/725

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

InduSoft Web Studio Página 60

  Nota:Utilizar o Botão New é o mesmo que selecionar File → New da barra de menu oudigitar 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  eclicar 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 demenu.

 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 detransferência, substituindo quaisquer seleções anteriores que estejam na área de transferência. Ustilize-oem combinação com o Botão Paste.

  Nota:Utilizar o ícone Cut é o mesmo que selecionar Edit → Cut da barra de menu oudigitar 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 eacima 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 menuou 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 diferentestelas.

Page 62: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 62/725

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

InduSoft Web Studio Página 61

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

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

  Note:Utilizar o ícone Delete é o mesmo que selecionar  Edit  →  Delete da barra demenu 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-secancelar 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 menuou 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 menuou 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 .

Page 63: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 63/725

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

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 teclasAlt+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 demenu 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 utilizeas opções de alinhamento ou o link Screen Attributes para modificar a posição da tela. Pode-setambé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ãoabertas no ambiente de desenvolvimento. Ao alterar a posição de tabs das telasno 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 telasserão automaticamente auto-escalonadas para acomadarem-se no tabLayout .

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 asinformações de ajuda.

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

Barra de Ferramentas Tag Properties

Page 64: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 64/725

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

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 taganotado no text box Tagname. Essa função escreve um log, detalhando todas as ocorrências do tag para otab 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 eplanilhas) 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 aomesmo tempo que visualize-se dinâmicos gráficos online no ambiente de desenvolvimento. O modo deexibição teste não habilita a utilização de Command, dinâmicos de entrada  Text I/O, ou execução deplanilhas.

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álogoProject 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

Page 65: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 65/725

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

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-seredimensionar, 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 exemplosdesses 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.

Page 66: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 66/725

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

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 objetoselecionado utilizando a largura e altura.

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

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

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 últimoobjeto 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 ehorizontalmente ao último objeto selecionado.

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

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

Botão Flip horizontally ( ): Clique para inverter o objeto selecionado horizontalmente. O objeto move-seatravé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ésde 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 IWSassina 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 outrosobjetos na tela. O IWS assina o maior ID# para o objeto, de modo que Esse move-se para trás de todos osobjetos 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 ferramentasestão localizadas ao longo do lado direito da janela da interface por padrão, e são habilitadassomente ao editar telas gráficas:

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

Page 67: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 67/725

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

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 eBackground 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, eoutros objetos para sua tela.

Barra de Ferramentas Static Objects

  Nota:  Veja “Utilizando a barra de ferramentas Static Objects” na página 198 noCapí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 defundo especificada.

Botão Closed Polygon ( ): Clique para desenhar um polígono fechado, utilizando uma coloração demoldura 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.

Page 68: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 68/725

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

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 tipicamenterequisitam 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 deexemplos.

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 dadosem um formato gráfico.

Botão Trend ( ): Clique para selecionar uma área na tela na qual serão exibidas as curvas de tendenciasdos 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 oscomponentes 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 ougrupos 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.

Page 69: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 69/725

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

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 deobjetos 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 deobjetos selecionados. Aplicar essa propriedade permite clicar nesse objeto(s) durante a execução do runtimepara iniciar o browser padrão e carregar a URL especificada.

Botão Bargraph ( ): Clique para adicionar propriedades gráficas para um objeto selecionado, e depoisclique 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 detexto selecionado. Aplicar a propriedade Text I/O permite a inserção e exibição de valores de tag em temporeal 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. Odinâ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 tagespecificados 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.

Page 70: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 70/725

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

InduSoft Web Studio Página 69

Botão Pixel Editing ( ): Clique para abrir um diálogo Edit Image , onde é possível desenhar bitmapsdetalhados, 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 TransparentColor), e definido a área de preenchimento (Botão Select Área).

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

Botão Inverter Transparent Color ( ): Clique para aplicar a cor selecionada utilizando o Botão SelectTransparent 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çãode 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.

Page 71: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 71/725

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

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 outrolocal no ambiente de desenvolvimento. Clique na barra de título e arraste-o para o novolocal. 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 Sp   y são fornecidas noCapí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 deerros 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 omonitoramento dos componentes de sua aplicação diretamente a partir do ambiente dedesenvolvimento. (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

Page 72: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 72/725

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

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 elinha) 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 oupressionar 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 outrolocal 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 noCapí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 (ouqualquer 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 exibeobjetos 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 

Page 73: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 73/725

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

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 aoalterar suas propriedades.

Customizando o WorkspaceO 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 utilizadasfrequentemente à 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) duranteo 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->RuntimeDesktop). 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 doobjeto 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 é utilizadopara inserir valoresalfanuméricos(caracteres e/ounúmeros).

Page 74: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 74/725

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

InduSoft Web Studio Página 73

EnhKeypad

Esse VK é utilzado para inserir valoresalfanuméricos(caracteres e/ounúmeros) em

equipamentos queforneçam uma pequena tela (e.x. PDAs). OBotão -> permite que osusuários naveguematravés de diferentespainéis até encontrar ocaractere desejado.

Keypad

Esse VK é utilizadopara inserir valoresnuméricos (somentenú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 textoI/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-inSetKeyboardLanguage().

  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 quenã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ãoinstalada 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.

Page 75: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 75/725

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

InduSoft Web Studio Página 74

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

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 deferramentas 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 executadaspor comandos line e curve. OpenType é uma extensão deType. Ambas podem ser escalonadas e roteadas, têm boa aparência emtodos 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 programassão dependentes dela. São executadas a partir de um modelo

Page 76: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 76/725

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

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 programassão dependentes dela.

Fontes Raster são armazenadas em arquivos como imagens

bitmaps e compostas de uma série de pontos, exibidos em tela oupapel.

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

 Atenção:  Ao projetar telas, as fontes que podem ser utilizadas são aquelas disponíveis nosistema operacional de sua estação de desenvolvimento. As fontes na estação deruntime, 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çãoocorre com maior frequencia quando as aplicações estão rodando em sistema operacional Windows CE, onde as fontes nem sempre se equivalem às proprorçõesdas 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ãodeve-se esperar até que toda a aplicação tenha sido desenvolvida, ou sera necessárioreprojetar 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.

Page 77: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 77/725

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

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) dequalquer 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çõesgraduais com diferentes estilos e variações. O diálogo Fill Effects abrirá.

Page 78: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 78/725

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

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ívelsomente para o objeto Rectangle.

 Atenção:Embora Fill Effect seja uma ferramenta útil para melhorar a aparência e sensibilidadedas telas, o sistema operacional leva um tempo maior para preencher um objeto comefeitos de preenchimento do que com cores padrão. Deve-se estabelecer um critériopara 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 oruntime. 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 RGBCor Nome

R (Red) G (Green) B (Blue)Valor doCódigo

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

Page 79: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 79/725

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

InduSoft Web Studio Página 78

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

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

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

  Nota:O número de cores disponíveis ao desenvolver uma aplicação depende dos parâmetrosde cores configurados no sistema operacional, na estação de desenvolvimento. Onúmero de cores disponíveis ao rodar a aplicação (runtime) depende dos parâmetrosconfigurados 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. Taistarefas incluem:

•   Accessar Projetos e Arquivos

•  Utilizar botões de comando

•  Gerenciar Janelas do Ambiente de Desenvolvimento

Page 80: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 80/725

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

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 seguintesmétodos:

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

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

Page 81: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 81/725

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

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álogoOpen  (como mostrado na seção anterior), o qual lista todas as pastas existentes. Para localizar eabrir 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 planilhasativas. 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  oudigitar 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 planilhasabertas. 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 deferramentas Standard .

Selecione a opção File → Save All As HTML para salvar todas as exibições da aplicação em formatoHTML. 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 detí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:

Page 82: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 82/725

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

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 odiálogo ou janela.

Apply Clique nesse Botão para executar e salvar todas as alterações, embora deixe odiálogo ou janela abertos.Esse Botão habilita a vizualização dos efeitos dassuas alterações antes de fechar a janela/diálogo.

Cancel Clique nesse Botão para fechar o diálogo/janela imdiatamente (descartandoquaisquer 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 oarquivo.

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 umarquivo 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 stringsassociadas 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álogoConvert Resolution , o qual permite a alteração da resolução de sua aplicação.

Diálogo Convert Resolution

Page 83: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 83/725

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

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 emseus 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:  Aoselecionar uma nova resolução, todas as telas serão escalonadas a partir da nova base deresolução)

Utilizando Menus Pop-Up Clicando com o Botão direito em qualquer componente do Workspace , aparecerá um menu exibindocom opções relacionadas àquele componente. Por exemplo, o menu pop-up a seguir habilita Abrir otags database da Aplicação , Insert (criar) um novo tag ou Refresh para a visualização do banco dedados 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á-lono 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 objetopara 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 noclipboard do Windows. Utilize Copy juntamente à opção Paste para substituir um objeto copiadopara 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 .

Page 84: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 84/725

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

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 IWSirá colar esse objeto no canto superior esquerdo da tela. Pode-se colar um objeto recortado oucopiado 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 localizadona barra de ferramentas Standard .

Pode-se selecionar Edit → Undo para desfazer a última ação executada (e até 20 ações executadasantes desta última) ao trabalhar na tela. (ações Object Properties  não aumentam o número detarefas Undo).

  Nota:

Utilizar a opção de menu Undo é o mesmo que utilizar o Botão Undo localizadona 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

Page 85: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 85/725

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

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 emuma ou mais das seguintes opções:

•  Match whole word only: O IWS pesquisa somente o item especificado, não incluindo amostrasonde 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 foiescrito. 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 deidentificaçã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- secom 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 onúmero da linha ou número ID do objeto no text box Number e clique no Botão OK.

Page 86: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 86/725

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

InduSoft Web Studio Página 85

 Dica:Caso você possua muitos objetos superpostos, e não é possível selecionar um objetoutilizando o equipamento de apontamento, Pode-se utilizar a opção Go to para editar aspropriedades 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) quepermitem 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 eFunçõ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 cliqueem 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 nomedo 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)

Page 87: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 87/725

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

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çãoanotadas no text box Tagname. Essa função escreve um log, detalhando todas as ocorrências dotag, para o tab  XRef  na janela  Output . Por exemplo, os resultados da pesquisa para um tagBlinkFast 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á odiálogo Global Replace :

Diálogo Global Replace

No diálogo Global Replace , Pode-se substituir qualquer tag(s) de todos os documentos (telas eplanilhas) 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çãoespecífica de array (por exemplo, TagA[1]) ou um mebro de classe (por exemplo, TagB.MemberX) ouambos (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 tagconfigurado na coluna To.

Page 88: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 88/725

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

InduSoft Web Studio Página 87

Caso uma substituição inválida seja configurada (por exemplo, substituir o tag Main Tag de um tipode classe por um tag simples que não seja um tag de classe), o Botão OK sera disabled. Quando oBotão OK for pressionado, os tags configurados no diálogo Global Replace serão substituídos pelomodo 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álogoGlobal Replace , porém as alterações serão aplicadas somente à tela ou planilha que estão abertasno momento.

Substituindo Tags

Clique duas vezes no objeto para abrir o diálogo Object Properties . Para substituir tags, selecione oBotão Replace localizado no diálogo Object Properties .

Diálogo Object Properties

Page 89: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 89/725

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

InduSoft Web Studio Página 88

Pode-se selecionar um ou mais tags para serem substituídos através do tab Replace Strings. Ostags utilizados atualmente serão exibidos. Você pode digitar em New Tag a direita de cada CurrentTag.

Tab Replace Tags

Pode-se também selecionar uma ou mais strings para substituição selecionando o tab ReplaceStrings. Strings atuais utilizadas serão exibidas. Você poderá digitar em New String à direita decada Current String.

 Ao terminar clique no Botão OK.

Tab Replace Strings

Page 90: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 90/725

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

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, quepermite a configuração da aplicação ao mesmo tempo que se visualize dinâmicos gráficos online noambiente de desenvolvimento. O modo de exibição do tipo teste não habilita a utilização deComandos 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 deferramentas 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 etelas de lógica, além atualizar os arquivos HTML atuais, utilizando os parâmetros configurados notab Web (diálogo Project Settings ). Os Tags no banco de dados são remapeados para todas as telas eplanilhas.

Verificando uma Aplicação

 Dica:

 Ao salvar uma tela ou planilha, o IWS inclui um apontador para a versão do banco dedados atual. Ao executar a aplicação, o IWS compara a tela ou planilha ao banco dedados da aplicação atual, e caso exista alguma discordância, o IWS recompile asexpressõ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 deruntime.

Page 91: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 91/725

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

InduSoft Web Studio Página 90

Rodando Aplicações

Na barra de menu, selecione Project → Run Application para iniciar os módulos de runtimeespecificados 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 eBGTask automaticamente ao executar Run Aplication.

•  Caso você não esteja editando telas atualmente no ambiente de desenvolvimento, o móduloViewer  abre a tela especificada no campo Startup screen no tab Runtime Desktop  (diálogoProject Settings ).

  Nota:

Utilizar a opção Run Application é o mesmo que utilizar o Botão na barra deferramentas 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 ouremota) 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álogoExecution Environment ). Certifique-se de qual target station está configurada (local ouremota) antes de executar o comando Stop Application.

  Nota:

Utilizar o ícone Stop Application é o mesmo que utilizar o Botão na barra deferramentas 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 IWSpara 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 oudigitar 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.

Page 92: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 92/725

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

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 dessediálogo, você poderá especificar qual impressora utilizar, e como configurar diferentes opções deimpressã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.

Page 93: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 93/725

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

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 ocomando 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 aodiálogo Print Setup  discutido previamente). Pode-se utilizar o diálogo Print para imprimir telas ouplanilhas ativas.

  Nota:

Selecionar o menu Print é o mesmo que utilizar o Botão Print na barra deferramentas Standard .

Page 94: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 94/725

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

InduSoft Web Studio Página 93

Dicas e TruquesEssa seção fornece dicas e truques úties para ajudá-lo a obter vantagem maxima das ferramentasfornecidas 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. Oconteúdo dessa janela de diálogo varia de acordo com o objeto/dinâmico específico que está sendoeditado. 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-semanipular (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 diretamenteaos 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 depropriedade diretamente na janela Object Properties (não é necessário clicar na janela para que ofoco volte-se para ela).Além disso, quando o Botão pin está habilitado, a janela Object PropertiesNã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 odesenvolvimento da aplicação. Utilizando o ícone Import Wizard, você pode importar tags dediferentes 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 decomunicaçã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á-loatravé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:

Page 95: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 95/725

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

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.

Page 96: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 96/725

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

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 selecionadono 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 aonome de tags importados. É vantajoso utilizar um prefixo a fim de diferenciar os tagsimportados daqueles criados manualmente.

  Nota:Para utilizar a opção Remote, o InduSoft Web Studio deverá estar rodando emum computador remoto.

 Após configurar os parâmetros nessa janela de diálogo, clique no Botão Next.

Page 97: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 97/725

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

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). Oscampos e configurações que são comuns para todos os Tipos de Origem de Dados incluem os quese seguem:

•  Grid: Displays the list of tags found on the data source. 

Nome doCampo

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 usadospara 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 queestejam 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.

Page 98: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 98/725

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

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ãoFinish.

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çãoatual.

Importing Indica o número de tags selecionados para serem importados.

ReplacingIndica 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 mesmonome.

  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, esã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 Databaseso  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 doIWS. 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.

Page 99: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 99/725

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

InduSoft Web Studio Página 98

Importando a partir do InduSoft Web Studio Database Wizard

Campo DescriçãoImport 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

Page 100: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 100/725

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

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 deimportação (s).

Nota:

  Ao selecionar a opção para importar toda a aplicação, asplanilhas 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 planilhasadicionais na Aplicação atual (o número de cada planilha éautomaticamente aumentado para evitar substituição dearquivos da aplicação atual.

Do not import duplicated

Quando essa opção está selecionada, as interfaces a seguir nãosã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ãoimportados)

Page 101: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 101/725

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

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ãoimportados)

 Trends (trend logs assinados a tags com mesmo nome não serãoimportados)

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)Replaceduplicated withimported

Quando essa opção está selecionada, as interfaces de outra aplicação serão importadas, e as interfaces da Aplicação atual commesmo 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 quepossua os tags que você deseja importar. 

Remote Selecione essa opção para importar tags de uma Aplicação queesteja rodando em uma estação remota. Digite um endereço IP (ou ohost 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/IPClient worksheet 

 Ao selecionar Remote (ao inves de Local) e checar essa opção, o IWSconfigurará a planilha TCP/IP Client automaticamente a fim detrocar 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 daquelescriados manualmente.

Page 102: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 102/725

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

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 entretags, eliminando a necessidade de configurar uma interface de comunicação entre o OPC Client doIWS 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 thehost name) do computador remoto no campo Remote de onde o IWSestá rodando.

•  combo-box Merge Local e Remote OPC Servers: Caso voê selecione um Remote server, habiliteessa opção para exibir a lista de OPC Servers instalados no computador local e também nocomputador remoto. Desabilite esse check-box para exibir somente a lista de OPC Serversinstalados 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 osbranches configurados no OPC Server.

•  check-box Use the item path for the tagname: Habilite essa opção para concatenar o caminhopara 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 coma marca OPC, que exibe o nome dos itens existentes no OPC Server.

Page 103: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 103/725

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

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 DatabasesEsse 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ãoimportados.

•  Data Column box: Selecione um número para cada propriedade de tag que corresponda aonúmero da coluna no arquivo de importação. Por exemplo, caso Tag, Array Size e Type estejamlistados 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. OIWS 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.

Page 104: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 104/725

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

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ãocomuns para todos os Source Types.

Importando a partir de ODBC DatabasesEsse wizard permite importar tags a partir de um Banco de Dados SQL Relational externo, comoMicrosoft Access, SQL Server, Oracle, My SQL, Sybase e outros, através da interface ODBC (OpenDataBase Connectivity).

Wizard Import ODBC Database

•  Botão Select Data Source: Clique para selecionar o ODBC Data Source Name (DSN) vinculadoao banco de dados do qual os tags serão importados. O DSN deve ter sido previamente criadona 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 deimportação.

•  combo-box Array Size: Selecione o nome da coluna que mantenha o tamanho do array para ostags no banco de dados de importação.

• Type combo-box

:Selecione o nome da coluna que mantenha o tipo de tag type no banco dedados de importação.

•  Description combo-box: Selecione o nome da coluna que mantenha a descrição do tag no bancode dados de importação.

•  Web Data combo-box: Selecione o nome da coluna que mantenha os Dados da Web para os tagsno banco de dados de importação.

Page 105: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 105/725

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

InduSoft Web Studio Página 104

  Nota: Veja Passos 1, 2 e 3 na seção acima, para as configurações e campos comunspara todos os Source Types.

Importando a partir de RSLogix™ 5000 CSV DatabasesEsse wizard permite importar tags a partir de um programa para ControlLogix/FlexiLogix PLCdesenvolvido com RSLogix™ 5000 e expostado para um arquivo CSV. Ao importar tags da arquivoCVS RSLogix™ 5000, a planilha do driver ABCIP é automaticamente criada para fazer um link entreos tags importados com o PLC, eliminando a necessidade de configurar a interface de comunicaçãoentre 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 íconefull scope configurado no programa PLC.

Selecione Do Not Use Scope para ignorar o escopo dos tagsconfigurados no programa PLC.

Selecione Use Limited Scope para configurar o número decaracteres do escopo que devem ser utilizados ao importar os tagsdo programa PLC. 

PLC IP AddressDigite o Endereço IP do PLC. Essa informação sera utilizada para configurar as planilhas do driver de comunicaçãoautomaticamente.

Page 106: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 106/725

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

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 coma lista de tags UDT (User Defined Type) configurados no porgrama PLC. Esse arquivo é opcionalpara 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, existeum 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 comunspara 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 decomunicaçã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 PanelMatePlus™) para o formato do IWS e rodá-lo sob qualquer plataforma suportada pelo IWS.

Wizard Import PanelBuilder Database

Page 107: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 107/725

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

InduSoft Web Studio Página 106

•  Import Screens: Habilite essa opção para importar as telas gráficas (incluindo objetos edinâmicos) para o IWS.

•  PanelMate Model: Pressione o botão Browse para selecionar o diretório onde os arquivos dobanco 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 detalhadassobre 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 camposcomuns 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 doque isso, o driver de comunicação OMRON comunica-se com PLCs através doFINS 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 tagsimportados e o PLC, eliminando a necessidade de configurar a interface de comunicação entre oIWS e o PLC manualmente.

Page 108: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 108/725

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

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 tagsimportados do programa CX Programmer:

Prefixo Descrição

CustomHabilite essa opção para concatenar um prefixo customizado com até 8caracteres para o nome dos tags importados.

PLCHabilite essa opção para concatenar o nome ou número do PLC ao nomedos tags importados.

ProgramHabilite essa opção para concatenar o nome ou o número do Programa aonome dos tags importados.

•  Serial Auto Address: Esse box permite configurar o Network Address e o Initial Node Addresspara os PLCs configurados no produto com comunicação Serial (caso haja):

Configuração DescriçãoNetwork  Address

Essa configuração sera aplicada para todos os PLCs configurados no projetocom comunicação Serial.

Node Address

Essa configuração sera aplicada para o primeiro PLC configurado no projetocom comunicação Serial. Tal configuração sera incrementada e aplicada aosPLCs 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 camposcomuns para todos os Source Types.

Page 109: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 109/725

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

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 controlebaseado em PC (TwinCAT PC-Based Control software) pela Beckhoff e exportado para um arquivoReport (*.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 eo 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 como software TwinCAT PC-Based Control durante o runtime. Pode-seselecionar uma das portas TCP padrão (801, 811, 821 or 831), oudigitar o número de uma porta TCP customizada para ser usada na comunicação.

Report FileClique no botão Browse para selecionar o arquivo .SYM do qual tagsdevem 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 dentrodo porcesso. A habilidade para exibir o status do processo pela interação com instrumentação (oucomputadores), é 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.

Page 110: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 110/725

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

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 ouimportar 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 eestá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 eobjetos 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 umapontador 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 deum Cabeçalho (onde você define informações globais da planilha) e um Corpo (onde você configureos 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 suasmensagens, que serão reportadas em condições de alarme. O propósito principal dessesalarmes é 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 docomportamento das variáveis do processo. Pode-se armazenar amostras em um arquivohistó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

Page 111: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 111/725

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

InduSoft Web Studio Página 110

processos, embora tais arquivos possam armazenar qualquer tipo de informação, comooperações de log, senhas, etc. Pode-se também utilizar Esse modulo para armazenar dados emformato XML.

•  Reports : Utilize para configurar seus próprios relatórios dos dados do sistema, nosformatos 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 linhasprogramacionais 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 aoprojeto. 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 GeraisPode-se habilitar as aplicações do InduSoft Web Studio Aplicaçãos para comunicar (trocar valoresde dados) com outras aplicações, equipamentos remotos (como um PLC ou transmissores), equaisquer 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 umprotocolo de comunicação (OPC, TCP/IP, ou DDE).

•  Configurando OPC: Explica como configurar uma planilha de OPC para gerenciamento decomunicação entre OPC Clients e Servers locais ou remotos.

•  Configurando TCP/IP: Explica como configurar uma planilha TCP/IP para gerenciamento decomunicação entre duas aplicações do IWS.

•  Configurando DDE: Explica como configurar uma planilha de DDE para gerenciamento decomunicação entre DDE Clients e Servers locais ou remotos.

Utilize o tab Comm para acessar todas as planilhas configuradas para estabelecer comunicaçãocom outro equipamento ou software utilizando protocolos disponíveis.

Page 112: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 112/725

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

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ésdo 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 quandoexecutar as Aplicações, recomendamos que as informações desse capítulo sejamcuidadosamente lidas e compreendidas antes de iniciar o desenvolvimento de Aplicações complexas.

Compreendendo a Estrutura Interna e o Fluxo de DadosO ambiente de runtime do IWS roda uma estação de trabalho operadora (Rodando em WindowsNT/2000/XP/CE). Esta consiste dos seguintes módulos ou threads  (elementos do programa quepodem ser executados independentemente de outros elementos do programa):

•  Background Task (uma tarefa de supervisão): Executa outras tarefas internas (planilhas doIWS). Por exemplo, a tarefa  Background  executa scripts configurados nas planilhas Math  eScheduler , além de gerenciar parâmetros configurados nas planilhas  Alarm , Recipe , Report , eTrend .

•  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 acordocom 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 outrosmó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 comparâ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 dadosrelacionado 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 outarefa. Além disso, módulos de runtime enviam e recebem dados do banco de Tags , o “coração” doIWS.

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 dealarme, timestamp, qualidade, etc).

Page 113: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 113/725

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

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 determinadomodulo naquele exato período de tempo. O tags database utiliza essa tabela para determinar quaisinformaçõ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 emtodos os objetos onde o tag estiver configurado.

Page 114: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 114/725

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

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), odriver 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 tagpara 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ãoexistem 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 detag 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, poisnão existem tags associadas àquele objeto.

 A Arquitetura do IWS melhora significantemente a performance do fluxo interno de dados, além detorná-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 IWSO 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 umprograma PLC. Um programa de PLC contém um loop simples:

Page 115: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 115/725

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

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) continuamentedurante 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, oprocesso 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 deacordo 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, enão existem outras threads com valores de alta prioridade, o sistema operacional alterna-se entrethreads com mesma prioridade.

Page 116: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 116/725

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

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ãodesignados com um valor de alta prioridade (THREAD_PRIORITY_HIGHEST); porém,esses programas devem fornecer um mecanismo que deixe-os inativos por algumperíodo de tempo ou de threads com prioridade normal as quais nunca sejamexecutadas.

O IWS utiliza a biblioteca UNICOMM.DLL para drivers seriais. Essa biblioteca cria uma thread THREAD_PRIORITY_HIGHEST que “descansa” (permanence inativada) até queos dados cheguem ao canal serial. Quando o IWS detecta novos dados em um canalserial, a thread THREAD_PRIORITY_HIGHEST “acorda” (torna-se ativada) e transfereos dados do sistema operacional buffer para o buffer de thread, onde pode ser lido peloDriver. 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 ativascom 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 prioridadeesperando 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-sepor quanto tempo cada thread permanecerá continuamente ativa. Contanto que uma thread esteja ativa, osistema operacional será capaz de alternar para esta determinada thread.

•  Period (do IWS): Especifica a quantidade maxima de tempo que cada thread do IWS (excetoBackground Task) é capaz de permanecer inativa.

 Atenção:Recomendamos que você não modifique esses valores padrão, a menos queabsolutamente necessário. Configurar esses parâmetros de forma incorreta podecausar o mal funcionamento de todo o sistema (por exemplo: A uso da CPU rodará com100% 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 asalterações; assim, caso ocorra algum problema de funcionamento, você poderá retornar às configurações originais.

Page 117: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 117/725

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

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 valorespadrã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 seuarquivo Program Settings.INI. Porém mesmo que um parâmetros não esteja visívelna 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âmetroexatamente 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).

Page 118: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 118/725

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

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 especificadoexpirar. 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í emdiante o thread é executado por 20ms (TimeSlice a partir do sistema operacional). Após o período de20ms, 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 osistema operacional seja capaz de executar o mesmo thread mais de uma vez em um mesmoperíodo de tempo TimeSlice.

No exemplo a seguir, os valores de Period e TimeSlice foram alterados como se segue, mas o períodoTimeSlice 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.

Page 119: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 119/725

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

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 80msrespectivamente, o sistema operacional não executará esse thread continuamente por mais de20ms, 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 seremexecutados). 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 de100% 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 operacionalainda 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 umparâmetro TimeSlice do IWS. Consequentemente, após cada thread manusear todas assuas mensagens pendentes, os threads tornam-se inativos até a próxima mensagemPeriod de cada um dos threads.

Background Task é uma exceção para processos de execução/alternamento já discutidos. Omecanismo para execução/alternamento do Background Task sera descrito na próxima seção.

Executando/Alternando o Background TaskO 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 todosos comandos Recipe e Report quando as Funções Recipe() ou Report() são executadas durante oruntime.

Emboras as tarefas  Alarm , Math , Scheduler , e Trend  não sejam threads, pode-se especificar outrocar seus tempos no Period no arquivo Program Settings.INI localizado na pasta C:\Documentsand Settings\\Local Settings\Aplicação Data\InduSoft Web Studio v6.1 (veja “Executando/Mudando Módulos do” na página 113).

Page 120: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 120/725

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

InduSoft Web Studio Página 119

Os valores padrão de Period (em milissegundos) são:

[Period]

Math=100

Sched=50

Alarm=100Trend=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âmetrosde 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 funcioneminadequadamente.

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 àsconfigurações originais.

Mantenha em mente que o thread Background Task possui a mesma prioridade de qualquer outrothread 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 oBackground 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 oBackground 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 detodas as planilhas Scheduler , o Background Task não executará o Scheduler novamente, até queesse 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 mensagemPeriod para cada uma dessas tarefas.

Page 121: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 121/725

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

InduSoft Web Studio Página 120

O Backgound Task executa tipicamente as tarefas  Alarm , Scheduler , e Trend  em algunsmilissegundos. 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  novamentepelos 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 planilhasMath  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 oupara 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áriosmilissegundos 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 detela, recomendamos a utilização do seguinte procedimento, prevenindo assim possíveisatrasos 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 tagauxiliar).

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.

Page 122: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 122/725

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

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ávelpelo 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 todosos 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 tagutilizadas 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 eplanilhas (como pontos de comunicação em equipamento de campo, resultado de cálculos, pontosde alarme, etc).

 Todos os tags são organizados através das seguintes categorias (representadas por pastas no tabDatabase 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 declasses permitem um alto grau de encapsulamento junto ao tagsdatabase.

•  Shared Database os tags são criados em um programa de software decontrole baseado em PC e depois importados para o tags database doIWS.

Por exemplo, pode-se criar tags em SteepleChase e importá-los para o IWS, assimo IWS poderá ler/escrever dados de SteepleChase  ,um produto de controlebaseado 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 deControle Baseados em PC” na página 147.

Não é possível modificar tags compartilhados com o IWS—deve-se modificar os tags no programa decontrole baseado em PC original, para depois reimportá-los para o tags database.

Page 123: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 123/725

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

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 omesmo 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 tagspodem 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 deforma 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 classesde 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)

Page 124: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 124/725

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

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 utilizemindices ú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 tage 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 campoArray 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 oprimeiro espaço ou caractere nulo. Consequentemente, o sistema não reconhecequaisquer 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 oconsidera 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 tagsarray simplificarem de forma significativa as tarefas de configuração e economizarem tempo nodesenvolvimento, sugerimos que estes sejam utilizados sempre que possível.

Por exemplo, suponha que você deseje monitorar a temperatura de quatro tanques. O método deconfiguração convencional é:

temperature1 high temperature on tank 1

temperature2 high temperature on tank 2

temperature3 high temperature on tank 3

temperature4 high temperature on tank 4

Page 125: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 125/725

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

InduSoft Web Studio Página 124

Pode-se utilizar tags array para simplificar essa tarefa, como se segue (onde [n] representa onú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 e500) são constantes numéricas. Por exemplo,número de tanques.

Tank[tk]   Arrays simples, onde o índice de array (tk) é umtag.Por exemplo, a tag representando o número detanques.

Tank[tk+1]    Array complexo, onde o índice de array (tk+1) éuma expressão. Por exemplo, o valor de tk (númerode 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 ) emum 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 é utilizadocomo 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.

Page 126: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 126/725

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

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 outrotag, 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 queaponte 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 forneceacesso 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 fromor 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 umclass-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. OIWS 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 quantoUNICODE.

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 tagsrelacionados ao gerenciamento de alarme.

Page 127: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 127/725

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

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ãoutilizadas 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 CampoNome doCampo dotag

Descrição do Valor Associado a CadaCampo

Boolean Integer Real String

R=ReadOnlyRW=Read+Write

Description Descrição do Tag (no Banco deDados deTag)

        RW 

Max  Valor máximo que pode ser escritopara o tag durante runtime.

        RW 

Min  Valor mínimo que pode ser escritopara o tag durante runtime

        RW 

Quality Qualidade do Tag (192=GOOD;0=BAD).

O Campo atualiza-se cada vez queresultados de expressões sãorecebidos ou um valor de tarefa decomunicação (Driver ou OPC).

Expressões inválidas (como divisãopor zero) ou erros na comunicaçãode leitura associados ao tag que

configurará a qualidade do tag comoBAD de forma automática.

        R 

Size  Tamanho do Array. Caso o tag nãoseja 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 32bits (b0, b1, b2, … b31) de um taginteger. (B0: LSB B31: MSB).

        RW 

Page 128: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 128/725

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

InduSoft Web Studio Página 127

Tipo de tag Associado ao CampoNome doCampo dotag

Descrição do Valor Associado a CadaCampo

Boolean Integer Real String

R=ReadOnlyRW=Read+Write

 Valor Integer contendo o status detodos os alarmes atualmente ativosassociados ao tag. Cada bit desse valor de integer indica um statusespecí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 lrStatus

Por exemplo:If Tag-> AlrStatus retorna para valor 2, “Hi” alarm is active.If Tag-> AlrStatus retorna para valor 3, “HiHi” and “Hi” alarme ativossimultaneamente.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ãoretornados.

Ack Esse campo pode ter dois valores :

•  0: Sem alarmes associados com essetag.

•  1: Pelo menos um alarme associado comesse tag.

        RW 

AlrDisable Esse campo pode ter dois valores:

•  0: Habilita alarmes associados com tag.Quando ocorre condição de alarme, oalarme torna-se ativo.

•  1: Desabilita alarme associado com tag.Caso ocorra condição de alarme, oalarme 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 

Page 129: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 129/725

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

InduSoft Web Studio Página 128

Tipo de tag Associado ao CampoNome doCampo dotag

Descrição do Valor Associado a CadaCampo

Boolean Integer Real String

R=ReadOnlyRW=Read+Write

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 alarmesDeviation .

        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 propriedadesnão persistirão se for feito um download de sua aplicação em um equipamento CE.

Page 130: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 130/725

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

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 eescreverá 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çãoEssa seção explica o processo para criação de tags básicos, array e pointero para a aplicação de seuprojeto.

  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 IWSreconhece 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 demembro de classe.

Pode-se utilizar caracteres em letra maiúscula ou minuscula, pois o IWS nãoestabelece diferença entre caracteres em letra maiúscula ou minúscula. Ambospodem 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 delocalizaçõ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 ouExpression (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.

Page 131: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 131/725

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

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 guidelinesdescritos 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 ThinClient. Por exemplo, quando você deseja visualizar um valor de tag em sua estação detrabalho, não interferindo no valor de tag exibido em outras estações de trabalho Web ThinClient.

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 dedados de Tags (File → Save) e feche o datasheet  Aplication Tags .

Page 132: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 132/725

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

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

Page 133: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 133/725

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

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çõesfornecidas 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. Essecommando 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ãosão reiniciados quando a aplicação é novamente iniciada. Portanto, Pode-se executar esse comandopara 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 tagnumé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çãolocal. 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ãoafetados 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 ClassesPara criar um tag class:

No tab Database, clique com o botão direito na pasta Classes , e selecione Insert Class do menu pop-up queaparecer.

Page 134: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 134/725

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

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 sintaxeda 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 dedocumentaçã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 classeque você deseja incluir nessa classe. Ou, caso você tenha terminado de adicionar todos osmembros, feche a planilha Class .

Pode-se expandirr a pasta Classes e as subpastas para vizualizar a estrutura dos dados:

Page 135: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 135/725

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

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 TagEssa seção explica como configurar propriedades de tag.

  No tab Database, abra o datasheet  Aplication Tags (ou exiba a lista de tags no Workspace ) ecoloque 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:

Page 136: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 136/725

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

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 tagselecionado 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 tagselecionado. 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 osdiferentes tipos de tags.

Instruções sobre como configurar os parâmetros em cada tab estão disponíveis a seguir.

Page 137: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 137/725

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

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, casoo 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 podecausar o acesso frequente ao disco rígido, o que diminui a perfdormance doprograma.

•  check-box Retentive Parameters: Habilite ( ) esse box para salvar todas as alterações feitas noscampos 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 deengenharia.

•  Campo Max (acessível durante o runtime ): Digite um valor máximo para o tag nas unidades deengenharia.

 Caution:

O IWS não pode aceitar valores de tags que saiam das escalas especificadasMin/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õesdefinidos.

•  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.

Page 138: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 138/725

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

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á umalarme.

•  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, oIWS 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 tagselecionado.

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 alarmeremotamente, 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. OIWS 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 IWSgerará 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 mensagensde 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 TranslationEnabled   já habilitado por padrão. Essas mensagens são salvas em um arquivo

Page 139: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 139/725

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

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 seguintestipos 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.5o 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émfornece uma lista, a qual permite a especificação de uma taxa para esse limite 1/s(econd), 1/min(ute), e1/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 IWSutilize 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).

Page 140: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 140/725

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

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 sealtere.

•  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 oruntime, o Objeto  Alarm/Event Control exibe esses mneumônicos na coluna  Value para tagsBoolean 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 menosque você altere esse padrão local explicitamente.

Page 141: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 141/725

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

InduSoft Web Studio Página 140

No diálogo T ag 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 oarquivo 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ãopersistirão através do download. Você perderá tais propriedades.

Utilizando Tags em Sua AplicaçãoUma 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álogoObject 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 longodesse manual no momento apropriado.

Editando TagsPode-se alterar as propriedades de um tag em qualquer momento durante o desenvolvimenhto ouruntime. Essa seção descreve dois métodos que podem ser utilizados para edição de tags.

Page 142: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 142/725

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

InduSoft Web Studio Página 141

  Nota:Pode-se clicar com o botão direito em uma propriedade de tag e utilizar os comandospadrão do Windows para cortar (Ctrl+X), copiar (Ctrl+C), ou colar (Ctrl+V) qualquer tage suas propriedades. Pode-se também desfazer (Ctrl+Z) a última modificação feita emum 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 A  plication Tags abrir, localize seu tag.

  Clique duas vezes na coluna que contenha as informações a serem alteradas, e digite as novasinformaçõ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 menupop-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 detodos 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 menupop-up.

Diálogo Properties

O diálogo Properties contém campos e combo-boxes que correspondem em nome e função a colunas nodatasheet  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 eselecione a nova informação da lista.

Page 143: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 143/725

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

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 colunasadicionais do sheet clicando com o botão direito e escolhendo a opção aplicáveldo 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 esua 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).

Page 144: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 144/725

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

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 nessecapí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 ProjetoUtilize 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 armazenadotanto 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ãoreconhecem espaços.)

Nomeando o Projeto

Page 145: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 145/725

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

InduSoft Web Studio Página 144

  Notas:O IWS armazena todos os projetos, por padrão, no diretório C:\Documents andSettings\My Documents\InduSoft Web Studio v6.1 Projects\, assim esse caminhoestará 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 ondeestá 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álogoHardkey Settings ou Softkey Settings  (dependendo do seu tipo de proteção da licença), o qualdeverá conter as informações de sua licença atual.

  Feche ambos os diálogos quando estiver terminado.

Page 146: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 146/725

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

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 originalemntedesenvolvida com a utilização de uma licença mais avançada do que a existente, oIWS 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 nobotão de seta  Target Station. O IWS exibe somente aquelas plataformas alvo asquais 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, evitandoassim 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 deruntime. 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 comdiferentes 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:

Page 147: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 147/725

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

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 plataformasremotas (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 softwaresdo 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  →  ConvertResolution. 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.

Page 148: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 148/725

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

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 emum programa de controle baseado em PC, como SteepleChase ou SixNet . Ao definer uma relação decompartilhamento e selecionar um banco de dados, o IWS entregará os tags e irá adicioná-los aobanco de dados de sua aplicação. O IWS também configura as planilhas do Driver da Aplicação etags para utilize-las no outro programa.

  Nota:Não é possível modificar tags compartilhadas com o IWS—deve-se modificar os tags noprograma 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 emPC, 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álogoConfigure:<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.

Page 149: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 149/725

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

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 decontrole baseado em PC possui sua própria e costumizada interface. Antes decompartilhar 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, econfigure 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 apropriadasna caixa de texto.

check-box Automatic exchange data Habilitar ( ) esse box permite que os dois programastroquem dados automaticamente.

check-box Communication withSimulation Mode 

Habilitar ( ) esse box permite que os dois programascomuniquem-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 eSixNet somente)

Digite o nome da Aplicação de controle baseada emPC compartilhado.

Campo de texto Status (Steeplechasesomente)

Digite o status atual da Aplicação de controlebaseada em PC.

Campo de texto Version (Steeplechasesomente)

Digite a versão atual da Aplicação de controlebaseada em PC compartilhada.

Campo de texto Last Modification (SixNet somente)

Digite a data quando a Aplicação de controlebaseada em PC foi atualizada pela última vez.

Botão Update (Steeplechase e SixNet somente)

Clique nesse botão para atualizar sua Aplicação doIWS com os dados da Aplicação de controle baseada em PC compartilhada.

Configure: Tabelas de Parâmetro <Program Name>

Page 150: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 150/725

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

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âmetrosadicionais para tal projeto:

   A partir da barra de menu, selecione Project → Settings tpara abrir o diálogo Project Settings , oqual 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 tabsestã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 momentodurante o desenvolvimento da Aplicação, recomendamos a configuração dessesparâ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

Page 151: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 151/725

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

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 úteiscaso 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 feitaspara 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

Page 152: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 152/725

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

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 systemconfigura 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 detradução. Digite o caminho do diretório e o nome do arquivo a ser traduzido no campo de nome emTranslation File . O IWS utilize esse arquivo de tradução como uma linguagem padrão ao iniciar a aplicação.

Page 153: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 153/725

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

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 deespaços no final e no começo do texto.

  Keep original text when translation is blank: Manter texto original quando nãohouver tradução (campo vazio).

Alarm History and Events: Digite um valor no campo History Life Time (em dias) para especificar por quantotempo deve-se manter os arquivos históricos de evento e alarme. Após a especificação do número de dias, oIWS 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 depropriedade (texto) a partes do IWS ou Banco de Dados para salvar os dados históricos de alarme/Eventoem um Banco de Dados Relacional, como um SQL Server, MS Access, Oracle, etc. Caso você selecioneDatabase ao invés de Proprietary, clique em Event Database e Alarm Database para configurar o link combanco 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 decomunicaçã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 decomunicação com o driver ISAGR automaticamente.

 Think & DoImporta tags de um projeto Think & Do para a pasta Shared Tags da aplicação atual e, quando habilitado, configure a interface decomunicação com o driver TND automaticamente.

SteepleChaseImporta 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.

Page 154: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 154/725

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

InduSoft Web Studio Página 153

Open ControlImporta tags de um projeto OpenControl para a pasta Shared Tags da aplicação atual e configure a interface de comunicação com o driver OCautomaticamente.

StratonImporta 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.

  NotaCada 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 eespecificar 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 seuambiente 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 ambientede 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 nomedo arquivo e localização na caixa de texto.

  Nota:Pode-se salvar arquivos de tradução em qualquer diretório, embora recomendamosque 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 nomepadrã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.

Page 155: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 155/725

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

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 (comosuportar muitos dos tags). Conseqüentemente, o nível da licença do target system, assim como oní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ãoespecificado ao criar o projeto.

  Nota:Para alterar essa resolução “on-the-fly,” feche todas as telas e selecioneTools  →  Convert Resolution a partir da barra de menu. Quando aparecer o diálogoConvert Resolution , defina o tamanho que você deseja utilizar, e a seguir clique nobotão Convert. 

Page 156: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 156/725

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

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 alarmeficarão armazenados em seu sistema.

Digite um valor no campo File Life Time (days) para especificar quantos dias os arquivos de alarmedevem 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 emPC” 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 quesomente um módulo pode rodar por vez, é possível que um valor de tag possa trocar várias vezesantes 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 OPCServer—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 OPCServer.

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:

Page 157: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 157/725

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

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 deBanco 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 oformato 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 detarefas 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 Bancode Dados Relacionados externo, embora possam ser salvos em diferentesbancos de dados.

Cada planilha  Trend pode ser configurada para salvar dados em formato depropriedade 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.

Page 158: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 158/725

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

InduSoft Web Studio Página 157

Janela Database Configuration

  combo-box  Database: Permite selecionar  Primary  ou Secondary . Com Primary , todas asconfigurações exibidas em uma janela Database Configuration aplicarão para a interface doBanco de Dados Primário. Caso não for selecionado, serão aplicados para a interface do Bancode 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 esseesteja 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 delesesteja indisponível, o IWS mantém os dados salvos somente naquele banco de dadosdisponível no momento. Quando o banco de dados tornar-se disponível novamente, o IWSsincroniza 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 DadosSecundário para o Primário.

Utilizando o Banco de Dados Secundário, você pode ampliar a realística do sistema, além depoder 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 emuma 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á asconfiguraçõ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-seconfigure-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

Page 159: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 159/725

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

InduSoft Web Studio Página 158

escrever a string de Conexão manualmente, pode-se pressionar o botão do browse (…) eselecionar 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 nocomputador onde o IWS está rodando. Consulte a documentação do sistema operacional (ou a documentação do banco de dados) para maioresinformações a respeito das configurações do Fornecedor para o banco dedados utilizado.

•  Campo User name: Nome do usuário utilizado para conectar-se ao banco de dados. Esse nomedo usuário configurado nesse campo deve ser compatível áquele configurado no banco dedados.

•  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 segundosconfigurados nesse campo. 

•  Botão Advanced: Após pressionar esse botão, você terá acesso a personalização de algumasconfigurações. Para a maioria das aplicações, o valor padrão dessas configurações nãonecessitam ser modificados, e por isso devem continuar os mesmos. 

Page 160: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 160/725

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

InduSoft Web Studio Página 159

Janela Database Configuration Advanced

 –   combo box  Milissegundos: Você pode configurar como os milissegundos serão salvos aosalvar a data no banco de dados. Cada banco de dados salva a data em um formatodiferente; 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 dadospreviamente testados pela InduSoft já estão configurados para a opção mais segura. Aoselecionar o Padrão, o IWS utiliza o parâmetro pré-configurado para o tipo de banco dedados atual. Caso você esteja utilizando um banco de dados que não tenha sidopreviamente testado pela InduSoft, a opção Default tentará salvar os milissegundos em umcampo 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á utilizandonão suporte milissegundos para os campos Date. 

  Dica:

  A opção padrão para cada banco de dados está configurada no arquivoStudioADO.ini, armazenado na sub-pasta \BIN do IWS. Veja “Studio DatabaseGateway,” no Capítulo 17:Interface do Banco de Dados do IWS , para informaçõessobre 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 comhorários salvos (daylight). 

  Database Gateway: Insira o Endereço Host Name/IP onde o gateway do banco de dados doStudio 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,” noCapí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. 

Page 161: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 161/725

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

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 umbanco 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ãofaz verificações em configurações inválidas nesse campo, portanto você deverá certificar-se deque 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/ouentrega 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 dedados, 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 bancode 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 osseguintes campos:

•  check-box  Status (output): O tag nesse campo receberá um dos seguintes valores:

Valor Descrição

0Desconectado 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 dedados 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 tipode banco de dados, tipicamente, (ex. SQL Server, MS Access, Oracle, etc) é utilizado por todas astarefas do mesmo projeto. Portanto, de modo a economizar tempo ao configurar a aplicação, o IWSpermite a configuração do Default Database . Ao configurar cada tarefa, você poderá escolher o queserá configurado em cada banco de dados padrão. Escolhendo esse método, não sera necessárioreconfigurar os mesmos parâmetros para cada tarefa, desde que essas compartilhem o mesmobanco de dados.

  As configurações padrão para o Default Database podem ser ajustadas pressionando o botãoConfigure no box Default Database, no tab Options do diálogo Project Settings.

Page 162: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 162/725

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

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 preenchimentodos 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 emuma janela Viewer . Pode-se configurar a aparência dessa janela Viewer como se segue:

  Selecione a aba Runtime Desktop no diálogo Project Settings :

Page 163: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 163/725

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

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 (oudesabilite  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 otexto 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 nobotão Options.

Page 164: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 164/725

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

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 qualidadedo 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 objetopara 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 ThinClients). 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âmicoCommand 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 VirtualKeyboard, 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:

Page 165: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 165/725

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

InduSoft Web Studio Página 164

Nome Figura Descrição

 AlphaNumeric

Esse VK é utilizadopara inserir valores

alfanuméricos

(símbolos ounúmeros).

EnhKeypad

Esse VK é utilizadopara inserir valores

alfanuméricos(caracteres ounúmeros) em

equipamentos quepossuam uma tela 

pequena (e.x. PDAs).O botão -> permite

aos usuários navegar por diferentes painéisaté encontrar o

caractere desejado.

Keypad

Esse VK é utilizadopara inserir valoresnumé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 oarquivo VK<Language>.INI na sub-pasta \BIN do IWS, onde <Language> é a marcação da linguagem para os VKs (ex. VKEN.INI = Virtual Keyboards emInglês; VKGE= Virtual Keyboards em Alemão, etc). Consulte seu fornecedor dosoftware para maiores informações a respeito de como editar e configurar essearquivo.

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.

Page 166: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 166/725

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

InduSoft Web Studio Página 165

 –  Scale: Usando esta opção o usuário pode aumentar ou diminuir os teclados para ficarem deacordo com o melhor tamanho para o target panel. A escala de 100% representa o tamanhodefault 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 OPCconfiguradas 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 valorespara um troca de valores de tag, todas as trocas nos valores de tag serão manipuladas eenviadas 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 enviadopara 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 vezenquanto tarefa de comunicação não estiver sendo executada, os valores transitórios do tagnã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:

Page 167: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 167/725

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

InduSoft Web Studio Página 166

•  Port: Porta TCP utilizada pelos módulos TCP/IP Client e TCP/IP Server que estejamrodando no computador atual. Ao alterar esse valor na aplicação local, certifique-se de queseja 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, oudesabilitada 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çãoa 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 ThinClient podem trocar (enviar) dados.

Page 168: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 168/725

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

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 ThinClients. 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 nobotã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 delimitar 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 arquivono 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ãoAlphaNumeric , EnhKeypad e Keypad .

Page 169: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 169/725

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

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 emínimos permitidos pelo tag.

   Ao terminar, clique em outra tab para continuar ou feche o diálogo.

Page 170: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 170/725

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

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 nocomputador 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 computadoresremotos utilizando essa configuração.

campo Send Period (ms): Digite um valor para especificar o período de envio em milissegundos) utilizadopara 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 nessecampo 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 (arede de trabalho sera acessada com maior frequencia) caso os tags estejam sendotrocados continuamente (com mais de 1 segundo).

Page 171: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 171/725

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

InduSoft Web Studio Página 170

check-box  Disable Remote Client Commands: Clique para habilitar esse box para a prevenção decomandos 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 umestaçã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, deacordo com sua resolução.

  Nota: A opção Auto Screen Scaling não é válida para browsers que estejam rodando sobsistemas 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 arquivono campo de texto para gerar um arquivo de log na estação Web Thin Client. Também pode-se utilizar essearquivo 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 touchscreen 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 ThinClient.

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 decada teclado virtual.

botão IP Security: Clique nesse botão para abrir o diálogo IP Security.

Diálogo IP Security

Utilize os parâmetros desse diálogo para especificar a escala de endereços IP para os computadores que sãohabilitados a acessar a aplicação como Web Thin Clients. Essa opção é útil para controlar os endereços IPde computadores Web Thin Client os quais são permitidos a conectar-se com o Server.

Page 172: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 172/725

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

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çosIP 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 aoservidor, este será verificado pela estação, e esse recurso permitirá o acesso somente para aquelesendereç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çõesavançadas.

•  Campo Secondary Data Server IP Address: Digite o endereço IP (ou host name) da estaçãoservidora de dados secundária, o computador ou equipamento onde o módulo TCP/IPserver 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áriofalhar, 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 (arquivosda 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, estetenta 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 nessecampo. 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 umlocal 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ãoestar 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 estejamdisponí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 CEnã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 essepoder ser usado como um Web Thin Client.

Page 173: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 173/725

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

InduSoft Web Studio Página 172

  check box  Web Tunneling Gateway: Habilite essa opção para capacitar o Web TunnelingGateway. 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 dedados.

  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 webIIS 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 TunnelingGateway está rodando. Esse deverá ser o endereço IP do web server secundário acessívela partir da(s) estações Web Thin Client. Esse campo deverá ser configurado quando webservers redundantes estiverem sendo utilizados.

  Dica:  A maioria das configurações da Web podem ser modificadas dinamicamenteatravés da função SetWebConfig(). Essa função é especialmente útil quandodeseja-se criar uma aplicação única, e certificar-se de que as configuraçõesda web serão automaticamente configuradas ao rodar a aplicação emdiferentes 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çãosejam 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 emtodos 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 IWSexecutará 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ósa 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 garantemque o symbol inserido numa screen também seja atualizado.

Page 174: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 174/725

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

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, osmó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, asexceçõ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ódulosruntime geram um novo arquivo de Dump (binário) com informação útil sobre as condições deerro. A informação disponível neste arquivo pode ser decodificada somente pelos desnvolvedoresdo 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 formatohexadecimal) gerado automaticamente pelo sistema. Conseqüentemente, se mais de um erroocorrer, 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 adicionaminformações sobre o alocamento de memória atual na plataforma runtime ao arquivo deDump.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 dememó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ãocriados na sub pasta \Web\Dump da aplicação.

Mesmo se nenhum dos check-boxes disponíveis nesta relação forem checados, um arquivo deDump nomeado WinDump.dmp estará gerado caso o IWS ou CEView são terminados por umerro 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 deDump 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ãoreiniciados 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.

Page 175: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 175/725

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

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 permitea especificação de quais módulos de runtime de seu projeto deverão ser iniciados automaticamenteno 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çãofor 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 (tabInformation)

O tab Execution Tasks exibe a lista de tarefas disponíveis para a aplicação atual. Status e modos destartup (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 .

Page 176: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 176/725

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

InduSoft Web Studio Página 175

  Selecione o tab Execution Tasks, no qual estão as listas de todos os módulos de runtimeassociados 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álogoExecution Environment 

(Project→

Execution Environment) estiver configurado como Local. 

Essa lista contém três colunas, incluindo Task Name , Status  de runtime configuração deStartup 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 OSBackground Task  SimDatabase Spy  NãoDDE Client Runtime NãoDDE Server  NãoHAD OPC Server  Não

Driver Runtime SimLogWin NãoODBC Runtime NãoOPC Client Runtime SimStudio Scada OPC Server  Sim TCP/IP Client Runtime Sim TCP/IP Server  Sim Viewer  Sim

Page 177: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 177/725

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

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 detarefas 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 automaticamentequando 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ãopressionando 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ívelsomente quando o Target Station for local.

  Dica:

Pode-se também iniciar/parar cada tarefa durante o runtime utlizando-se dasfunções built-in StartTask() e EndTask(). É possível também utilizar a função

Page 178: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 178/725

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

InduSoft Web Studio Página 177

IsTaskRunning() para verificar cada tarefa que esteja rodando durante oruntime.

 Atenção:

Os comandos disparados pelo diálogo serão executados na estação remota (e nãono 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çãoatual, 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 dadosda aplicação (inicial), fornecendo o número de tags da aplicação configurados na aplicaçãoatual. 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 .

Page 179: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 179/725

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

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 comcabeç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 quetelas diferentes sejam criadas. Tipicamente, uma tela da aplicação do InduSoft Web Studio consiste de três áreas básicas (ou tipos detelas):

•  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 exibindoo último alarme).

•  Regular: Área entre o cabeçalho e o rodapé, fornecendo informações sobre processos, telas dealarme, 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 ObjetoSelecione o tab Graphics para acessar todas as telas, páginas da web, objetos de biblioteca e símbolos na aplicação.

Tab Graphics

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 os grupos de telas completos (telas individuais combinadas em gruposgerenciáveis) criados para a aplicação atual.

  Nota:Group Screen não está disponível para Windows CE.

Page 180: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 180/725

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

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. Cliqueduas 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 vezesna 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 emDisplay, e depois em OK.

Page 181: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 181/725

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

InduSoft Web Studio Página 180

  Selecione Insert → Screen da barra de menu. Quando o diálogo New Document abrir, clique emDisplay, 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 parteinferior 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 bitmapsde background.

combo-box  Enable Background: Clique para selecionar uma das seguintes opções debackground do Windows NT/2000/XP:

BMPTIFDXFEPS

WMFIMGJPG

WPGPCDPNGFMF

FPXFAXTGA

  Nota:O Windows CE suporta somente .BMPs.

Page 182: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 182/725

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

InduSoft Web Studio Página 181

check-box  Shared Image: Clique (habilite ) para salvar um arquivo .BMP em formatocomprimido. 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 ambientecom a utilização de diferentes números de cores. Recomendamos que as telassejam salvas em formato não comprimido, caso você deseje alternar entrediferentes 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 demenu, 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 ) definidopara 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 monitoramentodessas 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 como 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 é configuradoserá 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 outrastambém habilitadas.

Page 183: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 183/725

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

InduSoft Web Studio Página 182

•  Dialog abre uma janela que permanecerá à frente das outras janelas, embora desabilite asoutras 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ãoatualizados. 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 oumais 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 embranco, 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 umgrupo 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 Tabenquanto 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 existemmais 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 TabOrder, 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 quandodeterminado grupo de telas é solicitado, clique com o botão direito no nome dogrupo da tela no tab Graphics do workspace.

Page 184: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 184/725

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

InduSoft Web Studio Página 183

•  Clique no botão Save ( ) na barra de ferramentas Standard  ou selecione File → Save (ouFile → 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

Page 185: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 185/725

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

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 deferramentas Tools  toolbar e clique com o botão direito na tela em branco. Escolha  Background Color domenu 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áficosimportadas para o ambiente poderão ter distorções da cor. Caso isso aconteça, altare a paleta configurada para seu sistema.

Page 186: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 186/725

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

InduSoft Web Studio Página 185

Utilizando Objetos e DinâmicasO 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 telasflutuantes 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 objetosna 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 ocheck-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 osseguintes 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 umpreenchimento 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 eutilize o botão Fonts para especificar configurações de fonte e cor para todos osobjetos de uma vez só. (Não é possível utilizar essa função para objetos de textoagrupados.)

Page 187: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 187/725

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

InduSoft Web Studio Página 186

•  Botão Line Color ( ): Clique para especificar um cor para linha para objetos selecionados oupara configurar uma cor padrão para novos objetos, incluindo os que se seguem:

Pólígonos abertos

Polígonos fechados

LinhasElipses

Retângulo arredondado

Retângulos

 Ao clicar no botão Line Color, o diálogo Line Selection  aparecerá. Utilize esse diálogo para especifcar osestilos de linha e cor para objetos selecionados:

Diálogo Line Selection

 Dica:Para economizar tempo no desenvolvimento, pode-se selecionar vários dos objetosanteriores 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.

Page 188: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 188/725

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

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, queseja 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 selecionadospara 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 elipseou 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 empreto) aparecem em cada canto e no ponto medial de cada lado. Pode-se utilizar esses handles comose 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 objetointeiro (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 obotão esquerdo do mouse. Clique nas setas do teclado para redimensionar o objeto (na direçãoindicada pelas setas de redimensionamento) um pixel por vez. Solte o botão do mouse quando oredimensionamento do objeto desejado estiver concluído.

•  Para selecionar e redimensionar um polígono aberto ou fechado , desenhe uma caixa de seleçãoao 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últiplosdiálogos Object Properties  e propriedades. Utilize uma lista drop-down no diálogoObject Properties  (View  →  Object Properties) para acessar esses diálogos epropriedades.

Page 189: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 189/725

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

InduSoft Web Studio Página 188

Caso você queira redimensionar um símbolo ou grupos de objetos, o IWSredimensiona 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 últimoobjeto 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 esquerdodo último objeto selecionado. Por exemplo :

Alinhando objetos à esquerda

•  Botão Align right ( ): Clique para alinhar todos os objetos selecionados para o limite direitodo ú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:

Page 190: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 190/725

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

InduSoft Web Studio Página 189

Alinhando objetos na parte superior

•  Botão Align bottom ( ):  Clique para alinhar todos os objetos selecionados para o limiteinferior 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 ehorizontalmente ao último objeto selecionado. Por exemplo:

Centrando objetos horizontalmente

Page 191: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 191/725

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

InduSoft Web Studio Página 190

•  Botão Evenly space horizontally ( ): Clique para colocar uma quantidade igual de espaçoshorizontais 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 handlessó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 deobjetos. Não é possível utilizar essas botões com múltiplos objetos selecionados.)

•  Botão Flip horizontally ( ): Clique para inverter o objeto selecionado horizontalmente. Oobjeto 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

Page 192: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 192/725

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

InduSoft Web Studio Página 191

•  Botão Flip Vertically ( ): Clique para inverter o objeto selecionado verticalmente. O objetorota-se em torno de uma linha imaginária através de seu centro vertical até ser uma imagemespelho 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 oupara 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. EssesID#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 deoutro objeto na tela. Objetos com ID#s mais baixos exibem-se atrás de objetos comID#s mais altos.

Caso você selecionar um grupo de objetos e movê-los para trás ou para frente de umoutro objeto, o grupo selecionado de objetos mantém sua ordem de exibição original.

Page 193: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 193/725

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

InduSoft Web Studio Página 192

•  Botão Move to back ( ): Clique para mover um objeto ou objetos selecionados para trás detodos os objetos na tela. O IWS assinala o objeto de menor ID# e move esse objeto para trás detodos 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 toback 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ásde 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 tofront do menu pop-up do objeto.

Botões Object Grouping e UngroupingUtilize 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 epropriedades Object Properties . Pode-se utilizar a lista drop-down no diálogo Object Properties  (View  →  Object Properties) para acessar esses diferentes diálogos epropriedades.

•  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 .)

Page 194: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 194/725

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

InduSoft Web Studio Página 193

  Nota:

De forma alternativa, clique com o botão direito em um objeto e selecione Group domenu pop-up do objeto.

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

  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 objetosagrupados (conhecidos como subgrupos ). Conseqüentemente, pode haver a necessidade de deseagrupar todos os subgrupos para desagrupar completamenteum objeto complexo.

Utilizando Grupos de Telas

O IWS fornece um recurso para agrupar telas (screen-grouping) que permite a abertura de um link de telasao mesmo tempo.

Da barra de menu, selecione Insert Screen Group para abrir o diálogo Insert Screen Group , onde pode-secriar 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çãoindividuais da pasta Screens para grupos mais gerenciáveis.

Selecione File → Save Screen Group As HTML para salvar Screen Group em formatoHTML, 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.

Page 195: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 195/725

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

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 dedesenvolvimento.

•  Botão Forward ( ): Clique para retornar a um endereço URL aberto anteriormente, clicandono botão Back do ambiente de desenvolvimento.

•  Botão Stop ( ): Clique para cancelar o processo de download de arquivos a partir de umendereç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 dentrodo 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 HTMLO 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çõessobre como configurar e rodar uma aplicação Web Thin Client, veja  Capítulo 13: Configurando uma Web Solution .

Page 196: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 196/725

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

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 AsHTML.

 Atenção:  As páginas da web que são geradas ao selecionar File  →  Save As HTML sãoindependentes 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-osdisponí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 DataServer 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.

Page 197: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 197/725

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

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 remototenha 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 oIWS 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álogopara especificar a escala de endereços IP para os computadores que são permitidos a ter acessoa Aplicação como Web Thin Clients.

Diálogo IP Security

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 logna 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çãolocal, clique no check-box  Virtual Keyboard. Quando esse box está habilitado, os camposabaixo 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 deforma apropriada com o tamanho da tela do painel alvo. Escala: 100%  representa otamanho 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 emínimos permitidos pelo tag.

Page 198: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 198/725

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

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 dessasantes 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 fimde 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

Page 199: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 199/725

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

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ãoSelect 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 debitmap 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:

Page 200: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 200/725

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

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, ouDashed Line.

Color: Especifica uma cor para linha fronteiriça, clicando-se no botão Color. Quando o diálogoColor 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úmerorepresentando 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, ouDashed Line.

Color: Especifica a cor para linha das bordas, clicando-se no botão Color. Quando o diálogoColor 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 nobotão Color. Quando o diálogo Color  aparecer, clique em uma cor para selecioná-la e depoisfeche o diálogo.

•  Botão Line ( ): Clique para desenhar uma linha ortoginal na área de desenho, como se segue:

Page 201: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 201/725

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

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

Page 202: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 202/725

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

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 umcano 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, clicandono retângulo Color. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la edepois 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álogoColor . 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 oupreenchidos), 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.

Clique duas vezes no objeto para visualizar o diálogo Object Properties :

Object Properties: Rounded Rectangle

  Notas:Não é possível utilizar o botão retângulos arredondados para criar um bar graphpara aplicações em Windows CE.

Um retângulo arredondado possui uma marca extra no canto inferior esquerdo, oque permite a modificação do ângulo do arco.

Utilize o diálogo Object Properties para especificar os seguintes parâmetros para a linha ortogonal:

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álogoColor . 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 nobotão Color. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depoisfeche o diálogo.

Page 203: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 203/725

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

InduSoft Web Studio Página 202

Color: Especifica uma cor de preenchimento, clicando-se no botão Color para abrir o diálogoColor . 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.

Clique duas vezes no objeto para visualizar o diálogo Object Properties :

Object Properties: Rectangle

Utilize o diálogo Object Properties para especificar os seguintes parâmetros para a linha ortogonal:

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álogoColor . 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 depoisfeche o diálogo.

Color: Especifica uma cor de preenchimento, clicando-se no botão Color para abrir o diálogoColor . 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 captionretângulo, clicando-se no box.

Page 204: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 204/725

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

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, quandohabilitado.

*  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 aoretâ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.

Clique duas vezes no objeto para visualizar o diálogo Object Properties :

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 aobotã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 odiálogo Object Properties .

Page 205: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 205/725

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

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álogoFonts 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 grupode objetos. Dinâmicas habilitam a modificação de propriedades do objeto durante execução (emruntime) em concordância com valores de tags. Algumas dinâmicas habilitam também a execuçãode 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 objetoselecionado ou grupos de objetos. A dinâmica Command habilita você a clicar no objeto oupressionar uma tecla pré-definida para executar o comando em runtime.

  Clique duas vezes no objeto para visualizar as propriedades do objeto.

Page 206: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 206/725

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

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 umevento pode ser configurado simultaneamente para a mesma dinâmica Command:

Evento Descrição

On DownExecuta 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 omouse é pressionado sob o objeto. O período (em milissegundos) deexecuçã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 UpExecuta command/script uma vez que o usuário libera o botãoesquerdo do mouse no objeto.

On Right DownExecuta command/script uma vez que o usuário clica no objeto como botão direito do mouse.

On Right UpExecuta command/script uma vez que o usuário libera o botãodireito do mouse no objeto.

On DoubleClick 

Executa command/script uma vez que o usuário clica duas vezes noobjeto 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 disparadopor 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 suportadospor aplicações do CEView (Rodando em sistema operacional Windows CE).

 Ao criar uma aplicação para um equipamento touch-screen, é importante que semantenha em mente que eventos On Right Down e On Right Up não poderão ser disparados em tais equipamentos.

Page 207: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 207/725

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

InduSoft Web Studio Página 206

Key: Atalho utilizado para disparar eventos On Down, While Down e On Up com a utilização de umteclado. Essa opção é especialmente útil ao criar aplicações para equipamentos em runtime quenão forneçam um mouse ou interface touch-screen – o teclado é a única interface física disponívelpara 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 diferenteseventos. Os seguintes tipos são suportados:

Tipo Descrição

Built-inLanguage

Permite que você configure um script utilizando a linguagem built-in doIWS. Quando esse tipo é selecionado, o usuário pode configurar até 12expressões para cada evento no coluna Expression. Essas expressões sãoexecutadas 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ítuloLinguagem 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 umscript no editor VBScript para a dinâmica Command. Consulte o CapítuloVBScript 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 onome da tela no campo Open Screen ou navegá-lo. Mais do que isso, você

Page 208: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 208/725

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

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 onome da tela no campo Close Screen ou navegá-la. Você também podedigitar um tag string entre colchetes {TagName} nesse campo. Quando oevento é executado, o IWS tentará fechar a tela nomeada. 

Set Tag

Permite que você configure a dinâmica Command para configurar um tagquando 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 tagquando 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 TagPermite que você configure a dinâmica  Command para inverter um tagquando 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 aoqual 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 é útilquando você deseja certificar-se de que ações dirigidas por alterações de tag (e.x. Writeon 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 domouse 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).

Page 209: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 209/725

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

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 ougrupo 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 umtipo de protocolo da lista  Hyperlink Type, o IWS adiciona automaticamente oprefixo do protocolo para o endereço da URL.

Disable: Digite um valor maior que zero nesse campo para desabilitar a propriedade decomando hyperlink para o objeto(s) selecionado.

Campo Security: Digite um valor nesse campo para especificar um nível de segurança para oobjeto (s). Caso um usuário efetuar logs on, e não possuir o nível de segurança requisitado, o IWSdesabilitará o comando hyperlink para o objeto(s).

•  Botão Bargraph ( ): Clique para adicionar propriedades bar graph para um objetoselecionado, e depois clique duas vezes no objeto para abrir o diálogo Object Properties .

Object Properties: BarGraph

Page 210: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 210/725

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

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 docombo-box. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la e depois feche odiá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.

Page 211: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 211/725

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

InduSoft Web Studio Página 210

•  Botão Text I/O ( ): Clique para adiccionar o dinâmico de propiedade de texto input ououtput para um objeto de texto selecionado. Aplicar a propriedade Text I/O permite a inserçãoe 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 quecontenham 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çãoe esse dinâmico executa somente os dados de saída.

check-box Confirm: Habilite essa opção para requisitar usuários a confirmar quaisquer valoresconfigurados durante o runtime.

Campo Minimum Value: Habilite essa opção para definir um valor mínimo para o tag associadoa 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 tagassociado 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, substituindoo texto por asteriscos (*).

combo-box Fmt (format): Clique no botão do combo-box para selecionar um formato para ocampo 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çãoVirtual Keyboard na interface Project Settings Runtime Desktop antes de configurar o VirtualKeyboard para essa interface.

Page 212: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 212/725

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

InduSoft Web Studio Página 211

Campo Disable: Digite um valor maior que zero nesse campo para desabilitar as propriedadesde entrada de dados do tag.

Campo Security: Digite um valor nesse campo para especifcar o nível de segurança para umobjeto 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. Odinâmico Colors permite a modificação da cor de um objeto estático durante o runtime baseado no valor deum tag ou expressão.

Clique duas vezes no objeto para abrir a caixa de diálogo Object Properties.

Object Properties: Colors

Pode-se utilizar esse diálogo para especificar os seguintes parâmetros:

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ãoconfigurado no campo Tag/Expr alcança os limites, a cor associada com o respectivolimite é aplicada ao objeto.

*  By Color: Ao selecionar esse tipo, pode-se especificar o código que deve ser aplicado aoobjeto 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çãoespecificados 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 seguinteseqüê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é 16limites diferentes para o dinâmico color.

Page 213: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 213/725

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

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.

Clique duas vezes no objeto para abrir o diálogo Object Properties :

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çãode Horz: ou Vert: linhas da propriedade. (Nota: Quando um objeto está invisível, utilizar a condiçãoshow 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.

Page 214: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 214/725

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

InduSoft Web Studio Página 213

Campo Tag: Digite um tag associado ao objeto, permitindo que o objeto mova-sehorizontalmente e verticalmente através da tela.

Campo Range: Digite valores nesses campos para especificar os limites mais altos e mais baixospara 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 (empixels) 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çãosomente 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ímboloselecionado. 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 quaisserã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 IWSutilizará para aumentar e diminuir o tamanho do objeto.

combo-boxes Reference: Selecione um dos seguintes pontos de referência para determinar comoo 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 :

Page 215: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 215/725

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

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ésda 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 objetoatravé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.

Page 216: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 216/725

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

InduSoft Web Studio Página 215

Clique duas vezes no objeto para abrir o diálogo Object Properties :

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 bancode 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

Page 217: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 217/725

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

InduSoft Web Studio Página 216

Clique no botão Font para abrir o diálogo Font onde você poderá especificar propriedades deexibição para texto de alarme.

Diálogo Font

Utilize Font, Font Style, e listas Size para especificar um typeface, estilos de fonte etamanho.

*  Clique (habilite) os check-boxes no painel Effects  para  Strikeout (strikeout text) ouUnderline (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á noobjeto.)

*  Por padrão, o IWS utiliza fontes Western-style. Caso você deseje alterar o padrão, cliqueno botão Script do combo-box e selecione-o a partir da lista. (Nota: Os conteúdos daslistas desse combo-box dependerão de seu sistema operacional.)

*   Ao terminar, clique em OK para fechar o diálogo Font .

Page 218: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 218/725

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

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, utilizandoteclas 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 pelonovo 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 elarguras em runtime.

*  Utilize o combo-box Align para especificar o alinhamento (Left, Center, ou Right) para otexto da mensagem de alarme junto a uma coluna especificada.

*  Clique (habilite) o check-box  Available during runtime para permitir ao usuárioadicionar colunas selecionadas para a lista visível durante o runtime.

*   Ao terminar, clique em OK para fechar o diálogo Columns .

Page 219: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 219/725

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

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 deusuários. Digite o número Group no campo de texto (Por exemplo, 1). Também pode-seutilizar 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 alarmesbaseadas em prioridade. Digite valores nos campos de texto para delimitar a escala deprioridade.

Page 220: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 220/725

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

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 umtagname, 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 noradio button Asc ou Desc para pesquisa em ordem ascendente ou descendente. Cliqueno check-box  Allow sort in runtime caso você deseje habilitar a pesquisa para queocorra durante o runtime.

  Notas:Pode-se configurar nomes de tags (tags string) entre colchetes { } nos camposGroup, Selection, Tagname, Message, e Username para modificar as opções defiltragem 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 painelInterval 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

Page 221: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 221/725

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

InduSoft Web Studio Página 220

Utilize os parâmetros no painel Date and Time Format  para controlar quais informaçõessobre 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 sealtera, 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çãoquando 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 oIWS filtrar o objeto de alarme com a utilização de parâmetros especificados no diálogoFilters .

*  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 dealarme.

*  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 dealarme.

 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.

Page 222: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 222/725

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

InduSoft Web Studio Página 221

Clique (habilite) o check-box Ext translation para habilitar a tradução externa de mensagens dealarme, utilizando a Ferramenta Translation. (Veja Capí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 dedados 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 deferramentas Legacy. Porém, o objeto Trend Control fornece todas asfuncionalidades 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 facilmenteexecutados 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:

Page 223: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 223/725

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

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 TrendControl, 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 doobjeto 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-seadicionar mais Data Sources utilizando o botão New. O nome inserido será utilizadocomo 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 

Page 224: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 224/725

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

InduSoft Web Studio Página 223

estiver enchido. Quando desabilitado (deschecado), os dados não são classificados eo valor da coluna do cursor não é mostrado.

 –  Data Source Settings: Clique para definir as configurações dos tipos de Source Typeselecionados.

 A tabela a seguir resume as configurações para cada Tipo Data Source:

Tipo deDataSource

Descrição CampoX-Axis Configurações de Data Source

BatchBatch geradopela tarefa  Trend do IWS

Desabilitado. Osdados X-Axisserão entreguesautomaticamentena posição correta da propriedade doarquivo Batch

gerado pelo IWS.

Insira o Nome Batch dos valores data point para entrega. Pode-se configurar um tag entrecolchetes nesse campo para alterar essa configuração de forma dinâmica durante o

runtime.

DatabaseBanco deDados SQL 

Relacional

Nome do Campoque contém os

dados X-Axis

Configure os parâmetros para estabelecer link entre esse Data Source a Banco de DadosSQL Relacional, o qual suporta os valoresdata point. Veja   Janela   Database Configuration Dialog no Capítulo 17 para maisinformações sobre essa janela de diálogo. Leia Objeto   Trend Control - Apêndice B  para umexemplo de configuração para banco dedados.

Text File

 Arquivo de

 Texto (e.x.CSV file) com valores data point separados por umdelimitador específico

Número de

colunas quesuportam osdados X-Axis. Onúmero 0 refere-sea primeira coluna,1 refere-se a segunda coluna,etc.

Insira o Nome do Arquivo de Texto quesuporta os data points. O caminho padrão é ocaminho da aplicação atual. Pode-seconfigurar um tag entre colchetes para aletrar 

Page 225: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 225/725

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

InduSoft Web Studio Página 224

essa configuração de forma dinâmica duranteo runtime.

Pode-se também escolher um ou maisdelimitadores para dados armazenados nessearquivo de texto. O valor de cada linha estä 

escrito entre dois delimitadores. Ao utilizar uma vírgula como delimitador, o objeto gridestará disponível para leitura de dados dearquivos CSV. Pode-se também escolher umdelimitador personalizado, verificando a opçãoOther. Leia Objeto  Trend Control - Apêndice A ,para um exemplo de como configurar arquivosde 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íveisdurante 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

PointID de Data Point. Cada data Point possui um único ID, que é assinaladoautomaticamente 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 SourceData 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çõessobre como tornar Data Sources adicionais disponíveis para o objeto. 

Tag/FieldO significado desse parâmertro depende do Tipo de Data Source associado ao data Point:

Page 226: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 226/725

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

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óricoBatch 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 

StyleConfigure o estilo da pena (cor, tipo, estado, etc.).Veja o diálogo Pen Style abaixopara 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 maioresinformaçõ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 dessasconfigurações on-the-fly.

 Você terá a opção para definir um Hi Limit e um Lo Limit para cada data Point com odiálogo Options. O diálogo Pena Style permite a configuração de diferentes parâmetrospara 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:

Page 227: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 227/725

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

InduSoft Web Studio Página 226

Propriedade Descrição

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.

WeightSelecione 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 interpoladosdiretamente de um a outro, com a utilização de umalinha. 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) quedeverá ser exibido em cada amostra específica entregue a partir do Data Source e exibido noobjeto.

ColorSelecione 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 aousuá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:

Page 228: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 228/725

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

InduSoft Web Studio Página 227

Diálogo Options

Propriedade Descrição

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 otag.

Eng. Unit

O texto pode ser exibido em legenda,promovendo a associação entre EngineeringUnit 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 desselimite, sua pena pode ser exibida com um estilodiferente (e.x. cor) durante o runtime. Veja odiálogo Pena Style acima para maioresinformações. Ao utilizar tags, o padrão Low Limit é o valor Low Alarm configurado para otag.

Hi Limit

Quando o valor do data point está acima desselimite, sua pena pode ser exibida em um estilodiferente (e.x. cor) durante o runtime. Veja odiálogo Pena Style acima para maioresinformações. Ao utilizar tags, o padrão HighLimit é o valor High Alarm configurado para otag.

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 pontosconsecutivos. Caso o tempo entre duas

Page 229: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 229/725

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

InduSoft Web Studio Página 228

amostras consecutivas seja maior que essenúmero (em segundos), o Trend Controlassume que não há coleção de dados para esseperí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 deescala numérica. Caso o Eixo X esteja configurado como data/hora, o valor nessecampo 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 oumais 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 comonumérico, o valor nesse campo representa um valor de escala númerica. Caso o Eixo X esteja configurado como data/hora, o valor nessecampo 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 ocursor Vertical (caso exista).

*  Botão Axes: O Botão Axes no diálogo Object Properties de Trend Control inicializa oseguinte diálogo:

Diálogo Axes

Esse diálogo permite a configuração de parâmetros para os eixos X e Y.

Page 230: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 230/725

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

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 deDados 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 dotag configurado no campo Time define Data/Hora iniciais para osdados exibidos no objeto.

  Hours Before Now: Quando essa opção está selecionada, o valor dotag configurado no campo Time define a quantidade de tempoantes da Data/Hora atual, a qual será utilizada como inícioData/Hora para os dados exibidos no objeto. 

Duration

Define o Período de dados exibidos no objeto. Pode-se configurar umtag string nesse campo, de forma que você poderá alterar a duraçãodinamicamente durante o runtime, alterando o valor desse tag> Oformato 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 camporepresenta um período de tempo, data ou hora melhor especificadas. Osignificado 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

Page 231: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 231/725

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

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 tagconfigurado 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 automaticamenteatualizados quando o usuário altera a escala X dinamicamente durante oruntime, com a utilização da barra Time do objeto.

Caso o campo Time seja deixado em branco (ou o tag configurado nesse campotenha 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 ouhorizontais) desenhadas no objeto para os eixos X e/ou Y respectivamente, assimcomo a cor dessas linhas.

 –  Time bar: Quando habilitada, essa barra é exibida abaixo do Eixo X durante oruntime; do contrário, ela está oculta. A barra time é uma interface padrão que podeser 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 oruntime; do contrário, ela está oculta. A barra time bar é uma interface padrão quepode ser utilizada pelo operador para navegar através da escala do Eixo X durante oruntime. De forma opcional, pode-se configurar um tag no campo Scroll bar, o qualdefine o período para a barra scroll. Caso esse campo seja deixado vazio, o períodoserá 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 pontoespecífico (intersecção da pena com o cursor). Ao clicar nesse botão, O diálogoCursor inicializa, e é o local onde você poderá configurar os parâmetros para ocursor vertical opcional, como se segue:

Diálogo Cursor

Propriedade Descrição

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 é

Page 232: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 232/725

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

InduSoft Web Studio Página 231

alterado, a posição do cursor é modificada automaticamente.

Value OutputPode-se configurar um tag string nesse campo, que retorna o valor doEixo 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

Propriedade Descrição

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:

Propriedade Descrição

Min / Max

Padrão mínimo e máximo dos valores exibidos no Eixo Y. Utilizadoquando mais de uma pena compartilha de uma mesma escala (Múltiplas Seções desabilitadas), e/ou para os pontos onde os camposMin e Max não estão configurados (deixados em branco).

Multiple SectionsQuando habilitada, a escala Y é dividida automaticamente em uma seção para cada pena; do contrário, todas as penas compartilham deuma mesma escala Y.

FormatInicializa um diálogo para Configuração do formato dos nomesexibidos pelo Eixo Y.

Page 233: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 233/725

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

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 interfacefornece informações úteis associadas a penas atualmente com links estabelecidocom o objeto.

 –  Available / Visible: Os campos no box Visible são exibidos em legenda durante oruntime. 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 Downpara 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 marcadosnos boxes Available ou Visible:

Propriedade Descrição

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 runtimeQuando essa opção está habilitada, o usuário pode exibir ou ocultar ocampo 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 otamanho máximo esteja configurado para dois, legenda terá uma barra de rolagempara permitir ao usuário rolar para os outros pontos.

Page 234: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 234/725

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

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 estipuladonesse 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 essediálogo:

Diálogo Toolbar

 –  Show: Quando esse box está habilitado, a barra de ferramentas é exibida durante oruntime. 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:

Propriedade Descrição

ShowQuando esse box está habilitado, o Botão é exibido na barra de ferramentas doobjeto 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 interfacespersonalizadas 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:

Page 235: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 235/725

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

InduSoft Web Studio Página 234

Diálogo Advanced

Opções Run Mode: As configurações nessa área definem o comportamento do trendquando em modo de execução:

Propriedade DescriçãoUpdate 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 tiponumérico, o valor nesse campo será adicionado aos valores mínimo emáximo do Eixo X.

Move to current time onrun

Quando o Eixo X é tipo Data/Hora e esse campo está habilitado, ocomando Run sempre moverá o Eixo X para a hora atual.

Retrieve boundingsamples

Quando estiver habilitada, o objeto recupera os dados limitados doobjeto (somente os primeiros pontos). Deasbilitar esta opção podemelhorar o desempenho, desde que os pontos limitados do objeto nãosejam recuperados do histórico. Por outro lado, o objeto nãodesenhará as linhas que ligam o primeiro e últimas amostras àsextremidades 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, oureiniciar 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.

Page 236: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 236/725

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

InduSoft Web Studio Página 235

As propriedades dessa moldura são descritas na tebela abaixo:

Propriedade Descrição

Save trigger

Quando o tag configurado nesse campo altera seu valor (e.x.inverte), as configurações atuais do objeto Trend são salvasno arquivo temporário. Esse comando não está disponívelpara Web Thin Client. 

Load triggerQuando o tag configurado nesse campo altera seu valor (e.x.inverte), as configurações do arquivo temporário sãocarregadas e aplicadas ao objeto Trend durante o runtime. 

File Name

Caso esse campo seja deixado em branco, o arquivotemporá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 stationsalva/carrega o arquivo temporário no diretório Temp padrãodo sistema operacional (e.x. \Documents andSettings\<CurrentUser>\Local Settings\Temp).

Pode-se configurar um nome de arquivo personalizado para o

arquivo temporário nesse campo ou até configurar um tagstring entre colchetes, de forma que o usuário poserá aletar onome do arquivo de configuração dinamicamente durante oruntime 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árioquando a tela onde o Trend está configurado é fechada durante o runtime. Caso o box não esteja habilitado, asconfigurações são salvas somente quando o comando Savetrigger é executado. 

 Atenção:  Após a tela onde o Objeto Trend está configurado ter sido salva, asconfigurações não são carregadas automaticamente a partir do arquivotemporário quando a tela é aberta novamente, a menos que o comandoLoad 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çõesestão disponíveis:

Propriedade Descrição

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 pontoAdd 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 deconfigurar o Virtual Keyboard para essa interface.

Page 237: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 237/725

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

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 TrendControl durante o runtime. Essa seção descreve essas interfaces:

*  Toolbar: Os comandos diposníveis na Barra de Ferramentas são descritos na tabela quesegue:

Comando Ícone Descrição Tag de Ativação

Run

Configura o Trend para Modo Play.Nesse modo, o Eixo X é continualmenteatualizado (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 é atualizadocontinuamente (Modo Histórico), de

modo que o usuário poderá visualizar dados históricos em um períodocongelado de tempo. Essa opção édesabilitada (em cinza) quando o trend já está em Modo Stop.

0 = Modo Stop ligado

1 = Modo Stop desligado

PeriodInicia um diálogo, onde o usuário podemodificar as configurações principaisna 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.

HorizontalZoom

Permite ao usuário clicar em doispontos na área Trend, definindo a escala Horizontal que deverá estar disponível

Vertical Zoom

Permite ao usuário clicar em doispontos na área Trend, definindo a escala Vertical que deverá estar diposnível. Essa opção é desabilitada (grayed out) quando a opção MultipleSection (para a escala Y) está ativa.

Quando o tag de ativação altera seu valor (e.x. toggles), essecomando é executado.

Zoom In

Permite ao usuário efetuar zoom para 

aproximação (exibição de metade dasescalas X e Y atuais) a cada vez queclicarem na área Trend.

0 = Zoom In ligado

1 = Zoom In desligado

Zoom OutPermite ao usuário efetuar zoom para afastamento cada vez que clicarem na área Trend.

0 = Zoom Out ligado

1 = Zoom Out desligado

Page 238: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 238/725

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

InduSoft Web Studio Página 237

Cancel Zoom Cancela o Zoom selecionado

LegendaProperties

Inicializa um diálogo, onde o usuáriopoderá modificar as configiuraçõesprincipais da legenda 

Pena StyleInicializa um diálogo, onde o usuáriopoderá modificar o estilo da pena selecionada.

Add PenaInicializa um diálogo, onde o usuáriopoderá adicionar uma nova pena para oObjeto Trend

Remove PenaRemove a pena selecionada do Objeto Trend

 –  Quando

o tag de ativação altera seu valor (e.x. toggles), essecomando é executado.

MultipleSections

 Alterna a escala Y para MultipleSections (uma seção para cada pena)ou Single Section (todas as penascompartilham a mesma seção da escala  Y).

0 = Multiple Sections ligado

1 = Multiple Sections desligado

Cursor Alterna o cursor (régua) para visível ouoculto

0 = Cursor ligado

1 = Cursor desligado

Auto Scale

 Altera a escala do Eixo Y para adaptar-se a todos os valores das penas queestão sendo monitoradas atualmente.

Quando o tag de ativação altera seu valor (e.x. toggles), essecomando é 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 pointsassociados a pena selecionada na legenda 

Remove Remove a pena selecionada do Objeto Trend

HideQuando habilitada, a pena selecionada estará visível; do contrário,estará oculta.

Pena StyleInicializa um diálogo, onde o usuário poderá modificar o estilo da pena selecionada.

ScaleQuando esse box está habilitado, a escala do Eixo Y estará visível; docontrá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 doEixo 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 valoresorganizados em colunas e linhas. As colunas deverão ser separadas umas das outras por caracteres

Page 239: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 239/725

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

InduSoft Web Studio Página 238

especiais (geralmente vírgulas). Cada amostra (um par de valores representando um ponto nográ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 Y20 0 10

1 1 202 2 303 3 40

 Temos uma variável que representa o Eixo X e duas variáveis (Y1 e Y2) que representam linhasdiferentes do gráfico. O primeiro passo será converter os dados para um arquivo texto. Casoadotemos 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ãoteremos 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, edepois 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:

Page 240: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 240/725

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

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. Nesseexemplo, 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á:

Page 241: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 241/725

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

InduSoft Web Studio Página 240

Caso você tenha copiado o arquivo de texto para a pasta da aplicação, você terá somente queespecificar 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 novamentepara 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 depoisclique 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:

Page 242: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 242/725

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

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 quepossam ser acessados através da tecnologia ADO.Net. Esse Apêndice ilustra como acessar umBanco 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êndicesna 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 novobotão, Especifique o Nome para Data Source “MyDB” e clique em Create. Agora, você deverá  visualizar essas informações:

Page 243: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 243/725

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

InduSoft Web Studio Página 242

 Altere o Source Type para Database e especifique Time_Stamp no campo X Axis. Clique no botãoData 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á:

Page 244: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 244/725

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

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:

Page 245: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 245/725

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

InduSoft Web Studio Página 244

Clique em Ok para finalizar a configuração da string de conexão. Agora, desabilite a opção Usedefault 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. Fechea janela Data Source Configuration.

 Agora, precisaremos definir Temperature e Pressure, as quais serão representadas por pontos emnosso 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 nográfico, você terá que configurar, de maneira apropriada, data/hora iniciais, como mostrado abaixo:

Page 246: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 246/725

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

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 oscampos 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 detendência serão redesenhadas. Quando o valor desse tag alterar-se, o IWS redesenhará ascurvas 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. Utilizeesse campo somente em conjunção a trends Crisp.

combo-box Curve Type: Selecione um tipo de curva a partir das seguintes opções:

Page 247: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 247/725

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

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 aspenas 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 ouSave on Trigger na planilha  Trend Group . Tais tags terão suas amostrasarmazenadas 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 textoTrigger 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 detrend. 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áficode trend. Quando o diálogo Color aparecer, clique em uma cor para selecioná-la, e depois fecheo diálogo.

Botão Horizontal Scale: Clique para abrir o diálogo Horizontal Scale , o qual permite a definiçãode propriedades de escala horizontais para as curvas de trend.

  Nota:O conteúdo desse diálogo altera-se dependendo dos parâmetros especificadosno diálogo Object Properties Trend .

Page 248: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 248/725

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

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 obox 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 formatopara 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 deum 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 boxespara 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 boxespara 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 ocursor vertical.

check-box Enable: Clique (habilite ) para exibir um cursor vertical.

combo-box  Color: Clique para selecionar uma cor para o cursor vertical. Quando odiá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 tagname para receber uma string, que será constantemente atualizada com a hora atual docursor 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.

Page 249: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 249/725

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

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çãodo 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 dadoshistóricos. Conseqüentemente, deve-se configurar as penas do trend em umgrupo 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âmetrospara especificar em qual formato os arquivos históricos foram criados.

*  Date ( padrão ): Clique para manipular arquivos criados em formato de data pelo grupo detrend (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 tagtipa 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 (tipicamenteum 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) nodiá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 depropriedade de escala vertical para as curvas de trend.

Page 250: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 250/725

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

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 detrend .

*  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 odiá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 horizontalpoderá 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ãodefinidas 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 :

Page 251: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 251/725

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

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 odiálogo Color aparecer, clique em uma cor para selecioná-la e depois feche o diálogo. Pode-seutilizar 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 oqual 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 queestejam 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 mensagemde precaução é iniciada localmente. 

Page 252: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 252/725

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

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íodoselecionado 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 IWSdesabilitará 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 digiteum 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 emum 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, aoexecutar 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á ativadoautomaticamente.

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 umobjeto 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:

Page 253: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 253/725

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

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 eregistrar 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.

Clique duas vezes no objeto para abrir o diálogo Object Properties :

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 teclasAlt+Enter e selecionando Properties a partir do menu pop-up resultante.

Pode-se utilizar esse diálogo para especificar os seguintes parâmetros:

Lista drop-down Value (localizada abaixo do botão Replace): Clique para selecionar um dosseguintes 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álogoMessages Configuration .

Page 254: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 254/725

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

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 mensagensindividuais indexadas. O IWS numera esse campo baseando ser no tipo Read/SearchTag 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 nocampo 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 disparadaspelo processo afetem as mensagens que você poderá selecionar.

text box Read/Search Tag: Digite um tag integer ou Boolean para apontar a uma mensagemselecionada no campo Value da mensagem (diálogo Messages Configuration ). Pode-se utilizar oscampos Control Enable e User Enable para controlar se o operador ou um processo podemalterar esse tag.

Page 255: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 255/725

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

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 eset 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 upe 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 mensagensutilizanso somente a tecla  Enter, o que evita a utilização da tecla  Tab para seleção dasmensagens.

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 emuma 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, oqual poderão ser utilizados para exibir mensagens e gráficos baseados em valores de tags aoexecutar 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 comum único obejto de tela, além de possuir a habilidade de exibir imagens de bitmap junto asmensagens.

Multistate PushBotão: Habilita a exibição de mensagens e imagens bitmap. Esse objeto tambémassemelha-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 deobjeto 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 bitmapque serão exibidos na tela. Mais tarde, você poderá alterar o tamanho da fonte e ascaracterísticas da fonte para permitir que mensagens maiores sejam exibidas em um espaçoestipulado.

Clique duas vezes no objeto para abrir o diálogo Object Properties .

Page 256: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 256/725

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

InduSoft Web Studio Página 255

Object Properties: Smart Message

Pode-se utilizar esse diálogo para especificar os seguintes parâmetros:

combo-box Type: Clique para selecionar o tipo de objeto smart message. O tipo do objeto dizrespeito 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 emqual bit de tag integer está selecionado. Caso mais de um bit do tag Integer esteja configurado simultaneamente, a mensagem associada ao bit menos significativoconfigurado (valor 1) será exibida.

  Nota:Caso o PushBoutton Multistate seja o tipo Smart Message, somente 16 mensagensdiferentes 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 tagdeterminará qual mensagem será exibida pelo objeto durante o runtime.

text box Write Tag (opcional e disponível somente para PushButton Multistate ): Insira o nome deum 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 runtimeque 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.

Page 257: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 257/725

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

InduSoft Web Studio Página 256

Lista drop-down Event (disponível somente para PushButton Multistate ): Selecione uma dasseguintes 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 debaixo 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, ousuá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 textoexibido 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 configuradasdiretamente no objeto (Data Source = Static) ou podem ser lidas a partir de arquivo de textoexterno (Data Source = Text File). Quando Data Source = Static, o diálogo Configurationserá exibido como mostrado na figura acima, e você poderá configurar todos os parâmetrosna própria grade. Quando Data Source = Text File, o diálogo Configuration exibirá umcampo para inserção do caminho e nome do arquivo a partir do qual as mensagens serãolidas (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

Page 258: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 258/725

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

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 oruntime, o objeto exibirá a mensagem associada com o valor que ai deencontro 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 deobjeto está configurado para Multistate PushBotão, o valor associadoa mensagem atual também é registrado ao tag configurado no campoWrite Tag (caso exista). 

 Text (FG)Cor de primeiro plano para as mensagens exibidas durante oruntime.

  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á duranteo runtime.

Graphic File

Caminho e nome do arquivo bitmap (*.BMP) (caso exista) que será 

exibido quando a mensagem associada a ele é selecionada durante oruntime. Caso o caminho não seja especificado, o arquivo bitmapdeverá ser armazenado no diretório da aplicação.

 Transparent  Selecione a cor que será transparente no arquivo do gráfico, caso ocheck-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:s 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  quandoData Source = Text File. A principal vantagem da utilização de um Arquivo de Texto externo emlugar de Valores Estáticos, é que o primeiro promove a flexibilidade para alteração de mensagensdurante o runtime, apontando-se para um Arquivo de Texto distinto ou mesmo alterando-odinamicamente.

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-seutilizar 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ão1 Text/Message -2 Value -

Page 259: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 259/725

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

InduSoft Web Studio Página 258

3 Text (FG) 04 Text (BG) 167772155 Text Blink 06 Rec (FG) 84213767 Rec (BG) 167772158 Rec Blink 09 Graphic File -10 Transparent 011 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 mensagemconfigurada na primeira linha (State = Error) será exibida durante o runtime.

Os dados configurados na coluna Value column da primeira linha desse arquivo é irrelevante. Tallinha 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ódigoda cor a ele associada. O código pode ser inserido diretamente em formato decimal (e.x. 255) ouhexadecimal, utilizando a sintaxe #value (e.x. #0000FF).

Os campos Text Blink, Rec Blink e En. Transparent podem ser configurados com valores Booleanos0 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 demensagens, 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 procedimentopromove uma utilização amigável da interface para o usuário na configuração decó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 depainel padrão de um mesmo nome:

Momentary ( padrão ): Altera estado (Open ou Closed) ao pressionar o botão, e reverte para o estadoinicial quando solta-se o botão. Esse tipo de botão é sempre exibido em sua posição normal quandouma tela está sendo criada.

Page 260: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 260/725

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

InduSoft Web Studio Página 259

Maintained: Altera estado (Open or Closed) ao pressionar o botão, embora não reverta seu estadoinicial ao soltar o botão. Deve-se pressionar o botão novamente para alterar o estado atual. Essetipo 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 touchscreen. 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.

Clique duas vezes no objeto para abrir o diálogo Object Properties :

Object Properties: Pushbuttons

 Dica:De forma alternativa, clique com o botão direito ou selecione o objeto, pressione asteclas Alt+Enter e selecione Properties a partir do menu pop-up resultante para abrir o diálogo Object Properties .

Pode-se utilizar esse diálogo para especificar os seguintes parâmetros:

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 (NormallyOpena ( padrão ) ou Normally Closed).

Clique no botão para inverter entre os estados padrão e não padrão (de acordo com seuTipo especificado). Por exemplo, no estado inicial do botão, poderá estar de acordo com ascaracterísticas Especificadas na área Open do diálogo Configuration (veja abaixo ). Clique nobotão novamente para inverter para seu estado oposto, que nesse exemplo mostra-se comoClosed, 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:

Page 261: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 261/725

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

InduSoft Web Studio Página 260

*  Digite um tag para receber Write Value a partir do estado na área apropriada (Open ouClosed) 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-sedefinir cores e valores de tag no diálogo Configuration . Caso você deixe esse campo em branco, oindicador 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 oestado 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 umpushbutton 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 queas 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 suascombinações de teclas. Pode-se escolher Left, Right ou Left or Right para especificar a posiçãono teclado das teclas Shift, Ctrl ou Alt na combinação de teclas. Caso você escolha  Left orRight, o comando será executado a qualquer momento que essas teclas forem pressionadas emcombinação com a tecla especificada na lista drop-down.

Diálogo Key Modifier 

Page 262: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 262/725

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

InduSoft Web Studio Página 261

text box  Disable: Digite um tag utilizando um valor defirente de zero para desabilitar essepushbutton. 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 dasplanilhas de tradução pré-configuradas.

text box Security: Digite um valor para especificar um nível de segurança (0 a 255) para essebotã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ãopermanecerá ativo.

Botão Config: Clique para abrir o diálogo Configuration , o qual permite a especificação dosparâ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 quandopressionados.

Pode-se utilizar os parâmetros Style e Effect em combinação para criar quatro botõesdiferentes, como mostrado nas figuras abaixo:

Estilos de Pushbutton

Align: Especifica o alinhamento para a captação do pushbutton.

Page 263: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 263/725

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

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 objetopushbutton que inclui um indicador e uma “faceplate”. Quando o diálogo Color aparecer, cliqueem 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 delegenda 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 deum 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. Quandoo 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-seutilizar 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 equal 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 oualterar 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 nocampo 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 oscomponentes selecionados em sua tela.

Page 264: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 264/725

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

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 umdiá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 oscontoles ActiveX; entretanto, a instalação desses controles na target stationdeverão ser executadas manualmente. Além disso, quando controles ActiveX são utilizados em telas abertas em Web Thin Clients remotos, oscontroles ActiveX deverão também ser instalados manualmente nas Web Thin Client stations. Consulte o fornecedor de seu ActiveX para maioresinformações sobre instalação.

   Ao Configurar Aplicações com ActiveX para CEView, certifique-se de que ocontrole 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çõessobre 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 umarquivo *.dll ou *.ocx registrado em seu computador local. Deve-se assinalar um nome (alias) para ocontrole ActiveX da aplicação no campo Name (e.x. MyControl). Esse nome será utilizado como referência aoobjeto ao configurar as funções ActiveX a partir da linguagem do IWS.

Page 265: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 265/725

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

InduSoft Web Studio Página 264

  Nota:Não deve-se configurar dois controles ActiveX em uma mesma tela e com ummesmo nome. Por exemplo, caso você insira dois controles ActiveX “WindowsMedia Player” em uma mesma tela e nomear um objeto como MyMP1 (Namefield), 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). Olayout e as opções nessa janela de diálogo dependem da implementação de cada controle ActiveX. Utilizeessa interface para configurar propriedades que não deverão ser alteradas durante o runtime (propriedadesfixas).

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ãoser 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 eeventos variem dependendo de cada controle ActiveX, a interface deconfiguração é a mesma para qualquer controle ActiveX. Os conceitosdescritos aqui são aplicados a todos eles.

Configurando Propriedades

O tab Properties fornece uma grade com os seguintes campos:

Page 266: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 266/725

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

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:

 –  ÍconedaPropriedade

 –  Tipo depropriedade

 –   –  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 oresultado 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 utilizeda função XGet()). Portanto, quando uma expressão é configurada nesse campo, ocampo 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

Page 267: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 267/725

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

InduSoft Web Studio Página 266

  ActiveX e registra-os aotag configurado no campo Tag/Expression.

 –  Set 

 –  Registra o valor do tag ouexpressão configurada no

campo Tag/Expressionpara 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 ocomando Get antes deexecutar qualquer comando Set. O tagconfigurado 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 ocomando Set antes deexecutar qualquer comando Get. A propriedade ActiveX será 

atualizada com o valor dotag configurado no campo  Tag/Expression quando oIWS 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 registradoao tag configurado nocampo Tag/Expression,onde somente a tela com oobjeto ActiveX está aberta,e quando o objeto ActiveX 

Page 268: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 268/725

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

InduSoft Web Studio Página 267

envia uma mensagem para que o IWS atualize esse tag.

 –   Always

 –  O IWS mantém a efetuaçãode polling do valor da propriedade do ActiveX eatualiza 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 essealgorítmo. Nesse caso, o único meio para obtenção dos valores atualizados daspropriedades 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étodocorrespondente 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 dométodo, o ActiveX registrará o valor dos parâmetros para o tag (parâmetros).

Page 269: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 269/725

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

InduSoft Web Studio Página 268

  Dica:

 Ao clicar no botão Browse ( ), aparecerá uma lista de parâmetros suportados pelomé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 aoobjeto ActiveX. Caso o evento não suporte qualquer parâmetro, o texto fixo <None> é exibido no campoParameters. Do contrário, pode-se digitar os tags associados aos parâmetros do objeto ActiveX. Quando eevento 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 aosparâ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. 

Page 270: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 270/725

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

InduSoft Web Studio Página 269

  Dica:

  Ao clicar no botão Browse ( ), aparecerá um diálogo com o script completoassociado ao evento. A janela de diálogo principal exibe somente a expressãoconfigurada na primeira linha do script.

•  Botão Combo-Box ( ): Clique para selecionar um nome único a partir da lista de nomes docombo-box.

Caso a lista seja maior que o espaço delimitado, o IWS habilita uma barra de rolagem para a lista. Duranteo runtime, selecionando um nome da lista do combo-box se ocultará, e o nome selecionado será exibido nocombo-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 ) queafeta o alinhamento tanto na lista quanto em seu combo-box.

text box Position/Index: Digite um tag integer, o qual corresponde ao nome atualmente exibidono 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 umnome 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 comandodurante 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çãoVirtual 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.

Page 271: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 271/725

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

InduSoft Web Studio Página 270

Caso um operador efetue log on, não possua o nível de segurança especificado oudeixe esseespaç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ísticasda 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 nocombo-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  comoprimeiro item. Caso você especifique quatro nomes array, o combo-box exibira array index 0 earray index 3 – somando um total de quarto nomes.

Drop list size (Items): Digite em um integer ou um tag para especificar quantos nomes poderãoser 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 1eassim por diante. 

•  Botão Alarm ( ): Clique para especificar uma área da tela na qual exibir mensagens dealarme.

 A seguir, clique na tela e arraste o mouse para designar uma área para mensagens. Ao terminar, cliqueduas vezes no objeto para abrir o diálogo Object Properties :

Page 272: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 272/725

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

InduSoft Web Studio Página 271

Object Properties: Alarm

Pode-se utilizar esse diálogo para especificar os seguintes parâmetros:

Botão On Line: Clique (habilite ) nesse Botão para exibir mensagens de alarme online para oobjeto.

Botão History: Clique (habilite ) nesse Botão para exibir mensagens de alarme de arquivoshistó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 arquivoshistó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 odiá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 mensagensde alarme. Pode-se formatar alarmes para que incluam datas, horários (horas), nomes, tags emensagens.

Botão Font: Clique para abrir o diálogo Fonts  e Especificar um estilo, tamanho, cor e tipo defonte 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 caractereasterisco (*) 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 dealarme.

check-box  End:  Clique (habilite ) para adicionar o horário de normalização à mensagem dealarme.

Page 273: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 273/725

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

InduSoft Web Studio Página 272

Botão Selection: Clique para abrir o diálogo  Alarm Filters , o qual permite a especificação defiltros 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 alarmsummary.

*  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 dealarme.

Por exemplo, caso você assinale prioridades de alarme de 1 A 5 na planilha  Alarm , e depoisassinalar 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 sesegue:

Time: Clique (habilite ) nesse botão para especificar alarmes de acordo com o horário noqual o alarme foi recebido.

Priority: Clique (habilite ) nesse botão para especificar e exibir alarmes de acordo com aspropriedades assinaladas nos campos Priority Range.

Page 274: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 274/725

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

InduSoft Web Studio Página 273

Print Tag: Digite um tag name para filtrar e imprimir todos os alarmes, quando alteraçõessão efetuadas ao tag.

Campo Ack Tag: Digite um tag name para filtrar e reconhecer o alarme ativo (na partesuperior 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 filtradosao 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 oruntime.

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

Page 275: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 275/725

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

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:

DataSource

Descrição

 Text File Exibe dados de um arquivo texto em formatos ASCII ou Unicode (e.x.arquivos CSV).

Class TagExibe 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 noobjeto grid.

DatabaseExibe dados de um Banco de Dados Relacional SQL RelationalDatabase, 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 ouaçõ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 fontepara 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 sesegue:

Page 276: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 276/725

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

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) noobjeto Grid.

*  Field: Insira o nome do campo (coluna) no Banco de Dados SQL Relacional ao qual oobjeto Grid é vinculado. Caso esse campo seja deixado em branco, o texto configuradono campo Label será utilizado como Field. (Tal configuração está disponível somentequanto 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éricosNumeric 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 arquivoMyFile.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 formatobitmap (*.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 e1 para habilitado.

  Time Exibe o valor em formato Time (e.x. HH:MM:SS). Essa configuração está disponível somente quando o tipo deData Source está configurado para Banco de Dados.

Page 277: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 277/725

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

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 Bancode Dados.

  Notas:  Quando o tipo Data Source está configurado para Database, é

importante certificar-se de que o Tipo para cada coluna configurada noobjeto adapte-se ao Tipo do campo respectivo no banco de dados.

  Quando o tipo Data Source está configurado para Database, pode-seconfigurar demonstrações SQL válidas diretamente no Campo (e.x.List(DISTINCT [Cell_Name]) AS [Cell Name]). Também Pode-seconfigurar 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-seconfigurar 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, comose 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 deruntime que não fornecem um mouse ou interface touch-screen, possuindo somente oteclado para interação durante o runtime.

  Nota:Quando o tipo Data Source está configurado para Class Tag, e o diálogoColumns é deixado em branco, o objeto exibe os valores de todos osmembros 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 

Page 278: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 278/725

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

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 nascolunas 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 dascolunas.

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 seguitesparâmetros:

File: Insira o nome da origem do arquivo de texto. Pode-se digitar o nome doarquivo e seu caminho ou clicar no botão … para a pesquisa. (Caso o arquivoseja 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 (valoresseparados por vírgulas), você deverá selecionar a opção Comma. Também Pode-seescolher um delimitador personalizado, habilitando a opção Other e digitando odelimitador personalizado no campo logo acima.

 Dica:Pode-se configurar tag names entre colchetes {TagName} no campo File.

Page 279: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 279/725

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

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 ummembro 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 quedeverá 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áriomostre/oculte ou modifique posições.

*  Data  Source – Database 

Quando o tipo de Data Source type é configurado para Database, pode-se configurar osseguintes parâmetros:

Page 280: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 280/725

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

InduSoft Web Studio Página 279

Leia: Janela de Diálogo Database Configuration para maiores informações sobre essediálogo.

Advanced: Clique para iniciar o diálogo Advanced, onde você poderá configurar váriosparâmetros para o objeto Grid.

Esse diálogo permite a configuração dos parâmetros em Advanced, como se segue:

Page 281: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 281/725

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

InduSoft Web Studio Página 280

Diálogo Advanced

*  User Enable: Caso o valor desse tag seja TRUE (diferente de 0), o usuário podeselecionar linhas diferentes do objeto, clicando nessas linhas durante o runtime. Essecampo 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 tagarray 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 selecionadasdurante 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 osdados 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 Dadospara Data Source, a coluna será o valor especificado em Field. (Caso Field seja deixadoem 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,

Page 282: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 282/725

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

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 noobjeto grid ao tag configurado nesse campo.

*  Print: Quando o tag configurado nesse campo é invertido, os dados atualmente filtradosno objeto são enviados para impressão.

*  Save Trigger: Quando o tag configurado nesse campo é invertido, o data source (Text Fileou 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ãoatualizados 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 basede 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 introduzidosautomaticamente.

*  Inserted Values : Se o Insert Trigger estiver sendo usado, então o Tag array configuradoneste campo fornece os valores que serão introduzidos. Este campo deve conter somenteum Tag array, embora possa ser de qualquer tamanho.

*  Save on data change: Quando essa opção está habilitada, os valores são atualizados emdata source (Text File ou Database) assim que o usuário insira um novo valor na gradedurante 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 derolar através da lista arrastando o botão slider ou alterar o tamanho das células duranteo 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 oscheck-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 Gridestão visíveis durante o runtime.

*  Ext. translation: Quando essa opção está habilitada, o texto exibido pelo objeto Gridestará susceptível ao Ferramenta Translation durante o runtime.

*  Disable TAB to navigate through cells: Quando essa opção está habilitada, o usuáriopoderá 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 

Page 283: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 283/725

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

InduSoft Web Studio Página 282

imagem a ser exibida em cada linha do grid. O nome fica na seguinteforma: <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. Osseguintes campos deverão ser configurados para suporte a esse recurso: 

Campo DescriçãoClass tag Digite o nome do tag principal do tag class-array o qual

receberá os valores exportados. Cada linha do objeto gridserá exportada para uma posição array do tag array atravésda 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 tagclass-array configurado no campo Class tag.

 Dicas:

O recurso de Exportação (Export) é uma ferramenta poderosa e de fácilutilização para a transferência de dados a partir de diferentes data sourcespara tags. Após exportar os dados para os tags, pode-se utilizar diferentestarefas para a manipulação de dados, como a função FileWrite() ou tarefasRecipe ou Report para salvar os dados em arquivos de texto (e.x. arquivosCSV).

•  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.

Clique duas vezes no objeto para visualizar o diálogo Object Properties :

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.

Page 284: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 284/725

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

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 objetoou 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 Leftor Right, o comando será executado a qualquer momento que essas teclas forem pressionadasem combinação com o item especificado na lista drop-down.

Diálogo Key Modifier

Campo Disable: Digite um tag ou expressão nesse campo para habilitar e desabilitar o objeto. Oobjeto 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 oobjeto, 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 ocontrole 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 tagconfigurado no campo Feedback assume o valor especificado no campo Tri-State. Caso ocampo Feedback seja deixado em branco, o third state será exibido quando o tagconfigurado 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 ocampo 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ãonã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.

Page 285: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 285/725

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

InduSoft Web Studio Página 284

*  Enable Focus: Quando essa opção está habilitada, o objeto pode receber o foco duranteo runtime através das teclas de navegação.

*  Push Like: Quando essa opção está habilitada o controle é exibido como um Botão, aoinvé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 descritosabaixo:

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 seguintetabela:

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 Valueseja deixado em branco, o tag configurado no campo Tag será invertido entre“UNSELECTED” e uma string vazia.

Page 286: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 286/725

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

InduSoft Web Studio Página 285

TRI-STATE MODEQuando 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 TipoEmpurrar)

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 tagconfigurado em Tri-State, o estado é configurado para TRI-STATE. Quando nenhuma dessas condições sãosatisfeitas, o estado é configurado para FALSE. Caso o campo Feedback seja deixado em branco, o tagconfigurado 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 TrueValue ou com uma string vazio.

Status AtualValor registrado para o tag configurado

no campo

“Tag” quando o usuário clica no objeto

FALSE Valor configurado no campo True Value 

TRUE NOT (Valor configurado no campo Tri-State)

TRI-STATENOT (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 inteiroassinalado, 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”.

Page 287: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 287/725

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

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.

Clique duas vezes no objeto para visualizar o diálogo Object Properties :

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 ougrupo 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 asteclas 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 teclascombinadas. Pode-se escolher  Left, Right ou Left or Right para especificar a posição das teclasShift, Ctrl ou Alt no teclado na combinação de teclas. Caso você escolha Left or Right, o comandoserá executado sempre que essas teclas forem pressionadas em combinação com o itemespecificado na lista drop-down.

Diálogo Key Modifier 

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.

Page 288: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 288/725

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

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 eindicar 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 nocampo 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á utilizadocomo 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 emquestã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 duranteo runtime através das teclas de navegação.

*  Push Like: Quando essa opção está habilitada o controle é exibido como um botão, aoinvé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.

Page 289: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 289/725

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

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ãodescritos abaixo:

NORMAL MODE 

Quando a opção Tri-State está desabilitada, o objeto opera em Normal Mode. Portanto, poderá assumir somente dois estados:

Estado FormaForma

(Botão TipoEmpurrar)

FALSE 

TRUE 

Estados em Normal Mode

Quando o valor do tag configurado em Feedback é igual ao valor do tag configurado em True Value, oestado é 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 TrueValue.

TRI-STATE MODEQuando a opção Tri-State está habilitada, o objeto opera em Tri-State Mode. Portanto, pode assumir trêsestados:

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 tagconfigurado em Tri-State, o estado é configurado para TRI-STATE. Quando nenhuma dessas condições sãosatisfeitas, 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 campoTrue Value ou com um valor vazio para string.

Page 290: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 290/725

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

InduSoft Web Studio Página 289

Status atualValor escrito ao tag configurado no

campo“Tag” quando o usuário clica no objeto

FALSE Valor configurado no campo True Value 

TRUE NOT (Valor configurado no campo Tri-State)

TRI-STATENOT (Valor configurado no campo True

Value)

Utilizando a BibliotecaSymbols  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 ereutilização de símbolos de forma rápida e fácil. Pode-se também modificar símbolos existentes em apenasalguns segundos.

Da barra de menu, selecione View → Library para abrir a biblioteca a seguir de objetos e símbolospreviamente 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 tempodurante o desenvolvimento.

  Nota:

Utilizar a opção de menu Library é o mesmo que utilizar o botão Library na barra de ferramentas padrão.

Page 291: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 291/725

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

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 taispropriedades, utilize o tab Replace localizado no diálogo Object Properties . Pode-seadicionar 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). PasteLink atualiza automaticamente um objeto de tela com link, sempre que você atualizar o arquivo deorigem, 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 deimagens 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.

Page 292: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 292/725

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

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 quantostags 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çãoem um planilha  Math . Em uma aplicação de mundo real, essas variáveis poderiam ser provenientes deequipamentos 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 tagsrelacionados à 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 devempossuir seus valores armazenados em disco, e para criar arquivos históricos para gráficos detendências. O IWS armazena as amostras em um arquivo histórico binário (*.hst), e exibeambos 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 trocadosentre o banco de dados da aplicação e arquivos de disco em formato ASCII ou DBF, além decomo 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ãoenviados para impressora ou disco. Tarefas Report permitem a configuração de relatórios detexto 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-seconfigurar tarefas ODBC para trocar dados entre o IWS e quaisquer bancos de dados quesuportem uma interface ODBC.

•  Math: Contém as planilhas Math  utilizadas para configurar e implementar rotinas adicionaispara trabalhar com diferentes tarefas do IWS. O IWS executa planilhas Math como Background

Page 293: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 293/725

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

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 adicionaispara trabalhar com diferentes tarefas do IWS. O IWS executa planilhas Scipt como BackgroundTasks 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 outroseventos 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 atitudesa 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çãodial-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ínioantes 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 ferramentasStandard para abrir o diálogo New Document . Selecione Alarm Worksheet, e clique em OK.

Page 294: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 294/725

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

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 emensagens.

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 asconfiguraçõ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 emailautomaticamente para pessoa(s) designada(s) quando um evento de alarme ocorre.

  IMPORTANTE!Para utilizar esse recurso, deve-se estar conectado a Internet (manualmente ouutilizando uma função dial-up automática) e você deverá ter executado a funçãoCNFEmail (descrita no “Apêndice A: Funções do Studio ”) do IWS para configurar oSMTP server, nome do usuário, senha e domínio antes de tentar enviar um email.

O diálogo Email Settings aparecerá:

Page 295: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 295/725

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

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 deemail 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 dealarme na linha “assunto” do email.

radio button e Campo Custom: Clique (habilite) nesse Botão para inserir e utilizar a linha deassunto como você desejar no email de alarme. Digite o texto na linha de assunto no Campofornecido.

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 emailseparado. (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  asmensagens 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émtoma 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 doStudio” para uma descrição dos valores retornados para os Campos CurrentStatus 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.

Page 296: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 296/725

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

InduSoft Web Studio Página 295

*  Clique em um ou mais desses itens na lista  Items para incluir a informação de alarmena 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 qualuma 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 mensagensde alarme para armazenar no buffer. Caso o número de mensagens exceda esse valor, oIWS 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 dobuffer é 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ãoatualmente 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 mensagensexistentes 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ãopodem ser convenientemente baixados para estações remotas através de umfirewall..

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.

Page 297: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 297/725

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

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 dealarmes 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ãoincluirão aquele tag na contagem total.

•  Campo Total UnAck: Insira um tag inteiro para receber um valor denotando o número total dealarmes 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 demensagens de evento de alarmes para os Campos Total Alarms e Total UnAck:

Estado doAlarme

Estado deReconhecimento

Contagem paraTotal de tagsAlarm?

Contagem para Totalde UnAck Tag?

InrreeconhecidoSim SimAtivo

Reconhecido Sim Não

Inrreeconhecido Sim SimNormalizado

Reconhecido Não Não

  Nota:Recomendamos a utilização de nomes de tags únicos para os Campos Total Alarmse Total UnAck para cada planilha  Alarms .

  Campo Remote Ack Trigger: Quando o valor do tag nesse Campo se altera, todo o grupoterá 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 otag 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 otime 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 deadband. 

  Start Condition: O tempo em que a dead band começou.

  área On Line: Especifica os seguintes parâmetros.

Page 298: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 298/725

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

InduSoft Web Studio Página 297

check -box Display in Alarm Controls: Quando selecionado, envia mensagens de alarme para umobjeto de alarme na tela.

 Atenção:Caso você não tenha selecionado a opção Display in Alarm Controls, os alarmespara esse grupo não aparecerão nos objetos de alarme nas telas e impressãodurante a execução.

check-box Ack Required: Requer o reconhecimento de mensagens de alarme. Disponíveis somentese 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 osCampos 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 (ouqualquer 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 apenasuma linha e esperar pelo próximo comando de impressão.

 –  check-box  Save to Disk: Envia mensagens de alarme desse grupo para um arquivo dodisco 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ãoreconhecidos. Disponível somente se os Campos Save to Disk ou Send to Printer estiveremhabilitados.

 –  check-box  Generate Norm Message: Gera mensagens sempre que alarmes desse gruporetornam 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 alarmespara um objeto de alarme. O IWS exibe cada objeto de alarme em uma mensagem de alarmeutilizando 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 dealarme 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 dasmensagens 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 mensagensde 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 odiálogo.

Page 299: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 299/725

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

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-sealterar 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á igualou 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 HiLimit.

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 igualao 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 dotag é 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 (outroscaracteres não serão considerados).

•  Alarm summary: Ao habilitar o arquivo de históricos do alarme para um grupo, o IWS salva oarquivo 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 SummaryP1|P2|P3|P4|P5|P6|P7|P8|P9|P10|P11|P12|P13|P14|P15|P16|P17|P18|P19|P20|P21|P22|P23P1|P2|P3|P4|P5|P6|P7|P8|P9|P10|P11|P12|P13|P14|P15|P16|P17|P18|P19|P20|P21|P22|P23

Page 300: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 300/725

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

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 Proprietaryhistory do IWS ou de um banco de dados SQL relacional. As opções para ambos são as seguintes:

Page 301: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 301/725

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

InduSoft Web Studio Página 300

•  Proprietary

 –   File Format: Texto (UNICODE). O IWS utiliza o caractere barra vertical (|) para separar osCampos.

 –   Default Path: …\<Aplication Path>\Alarm\ALYYMMDD.ALH , onde:

YY = Dois últimos dígitos do anoMM = MêsDD = 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 doCampo

Tipo deDados

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 Boolean0: 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 Boolean0: 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.

Page 302: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 302/725

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

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 StringComentário (opcional) digitado pelo operador quando oalarme é reconhecido. Esse Campo existe somente para  Versão >=1

User_Full StringNome complete do usuário logado quando um evento dealarme ocorreu. Esse Campo existe somente para Versão>=2

Station StringNome 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. EsseCampo 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íodoGMT. Esse Campo existe somente para Versão >=3

Last_Update  TimeStamp

 Time Stamp quando o registro foi criado/modificado. EsseCampo é utilizado para sincronizar os bancos de dados aoutilizar o Banco de Dados Secundário adicionado ao Bancode Dados Primário. Esse Campo é criado somente quandoFile 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 bancode 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çõespara parâmetros de configuração do banco de dados, veja Capítulo 17: Interface de Banco de Dados do IWS .

Page 303: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 303/725

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

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émde criar arquivos históricos para gráficos de tendências. O IWS armazena as amostras em arquivo históricobiná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 ferramentasStandard 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:

YY = Dois últimos dígitos do anoMM = MêsDD = Dia 

Page 304: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 304/725

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

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 detexto (.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 IWSutiliza 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çõesrequisitadas 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 , todasas configurações exibidas na janela Database Configuration aplicam-se a interface do Banco deDados 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 podecausar 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 quantoSecundários. Caso um destes esteja indisponível por qualquer razão, o IWS mantém os dadossalvos naquele que está disponível. Quando o banco de dados, antes indisponível tornar-se aptonovamente, o IWS sincroniza ambos os bancos de dados automaticamente.

Page 305: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 305/725

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

InduSoft Web Studio Página 304

Store and Forward: Nesse módulo, O IWS salva dados somente em Banco de Dados Primários. Casoesse tornar-se indisponível, o IWS salva os dados no Banco de Dados Secundário. Quando o Bancode Dados Primário tornar-se apto novamente, o IWS move os dados do Banco de Dados Secundáriopara 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 osparâmetros configurados no Banco de Dados Padrão para a tarefa que está sendoconfigurada (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á elerá 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ãobrowse (…) 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

Page 306: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 306/725

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

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 nameconfigurado nesse Campo deve estar de acordo com aquele já configurado no banco dedados.

 –   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 dedados.

 –   Campo Retry Interval: Caso o IWS estiver indisponível para conectar-se ao banco de dadospor qualquer razão, automaticamente será reiniciada a conexão após o número desegundos configurado nesse Campo. 

 –   Botão Advanced: Após pressionar esse Botão, você terá acesso a algumas configuraçõescostumizáveis. Para a maioria das aplicações, o valor padrão dessas configurações nãonecessitam ser modificados, e devem continuar os mesmos. 

*  combo box Milliseconds: Pode-se configurar como os milissegundos serão salvos quandoos dados estão sendo salvos no banco de dados. Cada banco de dados salva a data emum formato diferente; Por exemplo, alguns bancos de dados não suportammilissegundos 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 dadospreviamente testados pela InduSoft são configurados para a opção mais cabível. Aoselecionar Default, o IWS utiliza os parâmetros pré-configurados para o tipo de bancode dados atual. Caso você esteja utilizando um banco de dados que não tenha sidopreviamente configurado pela InduSoft, a opção Default tentará salvar osmilssegundos em um Campo separado. 

  Dica:

  A opção padrão para cada banco de dados é configurada no arquivoStudioADO.ini, armazrnado na subpasta \BIN do IWS. Veja a seção Studio Database Gateway  para informações sobre como configurar o arquivoStudioADO.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. 

Page 307: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 307/725

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

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 timestampscom a precisão de milissegundos, apesar de o banco de dados que você está utilizando nãosuportar milissegundos nos Campos Date. 

*  check-box  Save time difference: Quando essa opção está habilitada, (padrão), o IWSsalva 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 comsalvamento 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ãoesteja utilizando o padrão, você terá que configurar o Studio database gateway com omesmo TCP Port. Veja “Studio Database Gateway ”  para informações sobre comoconfigurar 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 dadosserã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. OInduSoft 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/ouentrega 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 nomeconfigurado no Campo Name manualmente no banco de dados. 

 –   Name:  Especifica o nome da Tabela do banco de dados onde os dados históricos serãosalvos. 

 –   Botão Refresh: Caso o banco de dados configurado esteja disponível atualmente, pode-sepressionar o Botão Refresh para preencher o combo-box  Name com o nome das tabelasatualmente disponíveis no banco de dados. Dessa forma, pode-se selecionar a tabela ondeos 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ãodisponíveis:

 –   check-box Status (output): O tag nesse Campo receberá um dos seguintes valores:

Valor Descrição0 Desconectado do banco de dados. O banco de

dados não está disponível ou sua configuraçãoestá incorreta.

1 O banco de dados foi conectado com sucesso.

2 O banco de dados está sendo sincronizado.

Page 308: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 308/725

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

InduSoft Web Studio Página 307

 –   Reload (output): Caso você esteja utilizando colchetes em quaisquer dos Campos deconfiguraçã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 otag nesse Campo como 1. O IWS atualizará a configuração ao tentar executar um ação nobanco 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óricosde Tarefas 160.

Para maiores informações sobre como salvar históricos Trend history, incluindo uma explicação dosarquivos 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 arquivoshistó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 Tagpode 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 nesseCampo está configurado para TRUE (diferente de 0), o IWS iniciará o salvamento dedados para seu arquivo batch (caso você esteja utilizando o formato de propriedade), ouadicionará 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 acordocom 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 dependedo formato selecionado na Planilha Trend:

Caso você tenha selecionado Proprietary no Campo Type, Name deverá ser compiladocom formato [Path]<FileName>, onde:

Path: Um Campo opcional. Caso caminho não esteja especificado, o arquivo históricode batch será armazenado no mesmo caminho do arquivo <Aplicação>.app.

FileName: Nome do arquivo histórico de batch.

Page 309: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 309/725

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

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 oformato 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 batchespecificado no Campo Name já exista, de outra forma, tag receberá o valor 0.

*  Description (output): Esse Campo está disponível somente ao utilizar o formatoDatabase. Quando o tag no Campo Start/Stop altera-se para TRUE, o registro adicionadopara 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, osdados históricos serão salvos somente quando o tag no Campo Start/Stop estiver comoTRUE.

  Dica:

Os dados Históricos de Batch podem ser exibidos para o usuário em formatoGrá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çãosomente para arquivos baseados em datas. 

*  Campo Compress After (days): Especifica quantos dias manter o arquivo histórico detrend em disco (*.hst) antes de comprimir o arquivo. Após o período especificado, o IWScomprime o arquivo automaticamente. Utilize essa opção somente para arquivosbaseados 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 arquivoshistó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ãoexibidos pelo objeto trend.

Page 310: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 310/725

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

InduSoft Web Studio Página 309

•  Campo Dead Band: Digite um valor para filtrar alterações aceitáveis quando Save on TagChange for utilizado. Por exemplo, Dead Band possui valor = 5. Caso o valor do tag for 50 ealtera-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 arquivohistó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 Classesterã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

Page 311: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 311/725

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

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ê desejepossuir 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 milissegundosem 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 visualizadocom 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 necessidadede utilizar uma janela DOS.

Page 312: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 312/725

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

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 arquivosbinários.

Criando Históricos Batch

O IWS fornece ferramentas poderosas que capacitam a criação e gerenciamento de informaçõessobre batches históricos. O usuário é capaz de criar batches com a utilização dos seguintesformatos:

  Proprietary: Ao utilizar o formato de propriedade, cada batch sera armazenado em um arquivohistórico diferente. O usuário pode salvar dados históricos tanto em arquivos históricos quantoem 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 aquelessalvos em dados históricos; uma tabela adicional, chamada BatchHistory mantém registros comas informações sobre os batches. A lista abaixo descreve os Campos na tabela BatchHistory:

Nome doCampo

Tipo deDados

Descrição

Group_Number Integer Número do grupo Trend. Esse é o número da planilha criada para especificar os tags que serão armazenadosem 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

Page 313: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 313/725

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

InduSoft Web Studio Página 312

Sec_Table String Reservado

Description String Descrição do Batch

Deleted Boolean 0: Batch não foi deletado1: Batch foi deletado

  Dica:

Pode-se costumizar o nome da tabela e o nome das colunas criadas em umbanco 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 dedados da aplicação e arquivos de disco nos formatos ASCII, XML, ou DBF; transferindo valores entrearquivos e memória em tempo real.

  Tipicamente, utiliza-se uma planilha Recipe  para armazenar receitas de processos, embora possa-searmazenar 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.

Page 314: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 314/725

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

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 ferramentasStandard 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:

•  Campo Description: Digite uma descrição da planilha para fins de documentação.

•  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 utilizandouma segunda planilha  Recipe , embora deva-se carregar informações em umarquivo .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 Webpara visualizar dados em formato XML a partir da Web, embora as páginas XML nosistema 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 oumais recentes para visualizar dados em formato XML.)

•  Campo File Name: Digite um nome de arquivo relacionado ao grupo de receitas, utilizando umtexto 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 registradoem um arquivo DBF. O IWS habilita esse Campo para aplicações mais antigas, criadas para a 

Page 315: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 315/725

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

InduSoft Web Studio Página 314

utilização de arquivos DBF. Porém, o software desabilita esse Campo para projetos maisrecentes.

•  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 nomepré-definido não é requisitado).Um arquivo de configfuração que utilize a extensãopadrão .RCP (ou .XSL caso você especifique Save As XML) contém configurações dereceitas e o Campo File Name contém o nome do arquivo dos dados a serem lidos eregistrados.

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 oucom 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 Elementosconfigurados 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 tagem 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 ReportsO arquivo Reports contém uma definição de relatórios (tipo texto) a serem enviados para uma impressora oudisco. A tarefa Reports permite a configuração de seu próprio relatório (tipo texto) com dados provenientesdo 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á:

Page 316: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 316/725

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

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:

•  Campo Description: Digite uma descrição da planilha para fins de documentação.

•  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 bytespor 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 acordocom o número de caracteres. Caso você não habilite esse box, o relátorio utilizará somente onú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 donome 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.

Page 317: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 317/725

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

InduSoft Web Studio Página 316

  Nota:Um arquivo de configuração de relatórios utiliza .RCP como a extensão padrão. OCampo 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órioutilizando dados do sistema e indicando onde adicionar valores de tag. Cada nome do tagsubstituirá o nome do tag {tag_name}. Para tags do tipo real, utilize a seguinte sintaxe: {tag_namen}, 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 ouUNICODE), o número de caracteres reservados para o valor do tag será igual aonú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 caracterespara 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 WindowsODBC. A tarefa ODBC é capacitada para troca de dados entre o IWS e qualquer banco de dados que suporteessa interface.

 Além de configurar a planilha ODBC, deve-se configurar o driver Windows ODBC padrão. O IWS refere-seao 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.

Uma nova planilha aparecerá:

Page 318: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 318/725

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

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 Description: Digite uma descrição da planilha para fins de documentação.

•  Campo Data Source Name: Digite o mesmo Data Source Name (DSN) especificado no Painel deControle do Windows, contendo informações sobre acesso a banco de dados específico. Pode-sealterar o nome em Data Source Name durante o runtime configurando um tag entre colchetesnesse Campo. Por exemplo:

{DSNNameTag}

•  Campo User: Digite um nome de usuário para acessar o banco de dados> Pode-se alterar onome 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 runtimeconfigurando 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.

Page 319: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 319/725

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

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 umCampo “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 arquivoou 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 arquivosem 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álogoODBC Data Source Administrator .

  No diálogo ODBC Data Source Administrator , clique Excel Files na lista  User Data Sources , eclique 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 apareceuna 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 tabExecution Tasks (Project → Project Status).

Para iniciar essa configuração, só é necessário rodar o projeto. Sua aplicação aplicará osdisparadores Select, Next, Insert, Delete e Update, permitindo assim a troca de dados através daslinhas 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

6 - Error in the ODBCPREPARE function.

7 - Error in the ODBCEXECUTE function.8 - Error in the ODBCCOMMITE function.

Update command

9 - Error in the ODBCPREPARE function.

10 - Error in the ODBCEXECUTE function.

11 - Error in the ODBCCOMMITE function.

Delete command

Page 320: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 320/725

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

InduSoft Web Studio Página 319

12 - Error in the ODBCPREPARE function.

13 - Error in the ODBCEXECUTE function.

14 - Error in the ODBCCOMMITE function.

Configurando uma Tarefa Math  A pasta Math  permite a implementação de rotinas adicionais para trabalhar com funções básicas dediferentes tarefas do IWS. Uma planilha  Math  contém um grupo de linhas de programação que o IWSexecuta 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 taispropó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.

Uma nova planilha aparecerá:

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).

Utilize os parâmetros Header nessa planilha como se segue:

•  Campo Description: Digite uma descrição da planilha para fins de documentação.

Page 321: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 321/725

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

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 especificadona coluna the Expression.

•  Campo Expression: Digite uma expressão para enviar o valor de retorno para o tag especificadona coluna Tag Name.

Configurando uma Tarefa Scheduler A pasta Scheduler gera eventos com expressões matemáticas definidas para serem executadas de acordocom 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.

Uma nova planilha aparecerá:

Planilha Scheduler

Page 322: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 322/725

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

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.

Utilize os parâmetros Header nessa planilha como se segue:

•  Campo Description: Digite uma descrição da planilha para fins de documentação.•  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 queimprima 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 tagque 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, quandoutilizado 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. EsseCampo é utilizado para todos os eventos.

•  Campo Disable: Contém uma condição para desabilitação para a função especificada. Deixeesse 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).

Page 323: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 323/725

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

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. Umevento 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 emum 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 formatoevYYMMDD.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árioP9 = Mensagem de Evento

P10 = Estação

P11 = Comentário

P12 = Valor anterior 

P13 = Diferença de Tempo (Bias)

Page 324: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 324/725

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

InduSoft Web Studio Página 323

Configurando Parâmetros de EventosUtilize 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

Page 325: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 325/725

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

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 WebStudio desabilita o Event Logger automaticamente. 

check-box Security System: Habilite esse box para incluir eventos de sistema de segurança em arquivohistó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 comuma 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 noarquivo 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çãoSendEvent(strEvent) no arquivo histórico de evento.

check-box  System Warning: Habilite esse box para incluir eventos de avisos gerais do sistema (comoDivision by zero, Attempted to access invalid array index, etc) no arquivo histórico de evento. O IWS loga osseguintes 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 eo valor do tag altera-se para 52, o sistema não registrará essa variação no arquivohistórico de evento, pois a variação foi menor que 5. Porém, caso a alteração do valor dotag 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 sejamnecessariamente 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 dePropriedade do IWS ou para um banco de dados SQL externo relacional. As opções são asseguintes:

•  Proprietary

Page 326: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 326/725

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

InduSoft Web Studio Página 325

 –   File Format: Texto (UNICODE). O IWS utiliza o caractere barra vertical (|) para separar oscampos.

 –   Default Path: …\<Aplication Path>\Alarm\EVYYDDMM.EVT , onde:

YY = Dois últimos dígitos do anoMM = Mês

DD = Dia 

  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 doArquivo

Tipo deDados

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 StringComentário (opcional) digitado pelo operador quando oevento ocorreu. Esse campo existe somente para Versão >=2

Previous_Value Real Valor do tag ocorrido antes do evento. Esse campo existesomente 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árioGMT. Esse campo existe somente para Versão >=2

Page 327: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 327/725

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

InduSoft Web Studio Página 326

Last_Update  TimeStamp

 Time Stamp quando o registro foi criado/modificado. Essecampo é utilizado para sincronizar os banco de dados aoutilizar o Banco de Dados Secundário além do Banco deDados Primário. Esse campo é criado somente quando oFormato 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 bancode dados, editando o arquivo <AplicaçãoName>.APP como se segue:

[EventLogger]

<DefaultName>=<NewName>

POr exemplo:

[EventLogger]

Event_Info=Information

Message=Event_MessagePara informações detalhadas sobre como salvar arquivos históricos de eventos, incluindo instruçõespara parâmetros de configuração do banco de dados, veja Capítulo 17: Interface do Banco de Dados do IWS .

Page 328: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 328/725

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

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çãoentre 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çãoentre DDE Clients e Servers locais ou remotos.

Utilize o tab Comm para acessar todas as planilhas configuradas para estabelecer comununicação comoutro 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 DriverUm driver de comunicação é uma DLL  que contém informações específicas sobre o equipamento remoto, eimplementa o protocolo de comunicação. Para desenvolver um driver de comunicação, a InduSoft forneceum 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 eequipamento 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õespara 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.

Page 329: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 329/725

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

InduSoft Web Studio Página 328

Para configurar um driver de comunicação, deve-se especifdicar os parâmetros da interface (por exemplo, oendereço da estação e o baud rate), especificar endereços do equipamento, e depois estabelecer um link comtags 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 umdeles.

•  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 AvailableDrivers.

•  Campo Selected Drivers: Lista todos os drivers selecionados e suas descrições (casodisponíveis).

•  Botão Remove: Clique para remover um driver atualmente evidenciado no campo SelectedDrivers.

 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 odiálogo Communications Parameters .

Page 330: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 330/725

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

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 coma 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 outrostipos de conexão. “Conection Types Test” lista os drivers que têm sido testados commodem 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çãode drivers. No exemplo acima, o driver utiliza Long1 para configurar o método de detecção doerro, 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.

Page 331: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 331/725

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

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ãoconfigurará o sinal DTR antes de iniciar a comunicação).

•  check box Enable IR (disponível somente para plataforma Windows CE ): Clique (habilite ) essebox para habilitar driver serial para a utilização de uma Interface Infra-vermelha (Infraredinterface) (COM2 port) ao inves de uma porta serial padrão para comunicação com oequipamento (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çãopara esse comando.

 –   Campo Station: Alguns drivers slave, como o Modbus Slave (MODSL) requisitam umendereç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).

Page 332: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 332/725

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

InduSoft Web Studio Página 331

O IWS fornece duas interfaces, as quais podem ser utilizadas para configurar o driver (associandotags 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 entretags da Aplicação InduSoft e endereços de equipamento. Essa interface permite agrupar tagsautomaticamente, 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 tagsindividualmente.

•  STANDARD DRIVER SHEETS: Permite o controle do tempo necessário para escanear um grupode 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 ouUDP/IP .O modo de encapsulação foi projetado para fornecer comunicação com equipamentosseriais 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 ouUDP/IP em sua Ethernet rede de trabalho sem fio para dados seriais. Uma vez que a mensagem foiconvertida 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çãodessa 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, oque proverá acesso aos parâmetros de comunicação:

Page 333: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 333/725

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

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 tagsentre 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 camporecebe 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 remotosconectados através de uma linha telefônica. O diagrama a seguir fornece uma exemplo sobre comoaplicar essa solução:

Conexão do Modem

Pode-se habilitar a conexão do modem seguindo-se os passos abaixo:

Page 334: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 334/725

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

InduSoft Web Studio Página 333

  Clique com o Botão direito na pasta do driver, e selecione Settings do menu que será exibido, oque 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á oprimeiro modem disponível, Auto Detect 2 o segundo, Auto Detect 3 o terceiro, e Auto Detect 4o quarto, etc.

•  Campo Phone: Insira um número de telefone que o driver possa utilizar para conectar-se aoequipamento remoto. Esse campo aceita tags entre colchetes.

•  Botão Settings: Clique nesse Botão para configurar os parâmetros do modem. A janela queaparece ao clicar nesse Botão dependerá do sistema operacional que está sendo utilizado, alémdo 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

Page 335: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 335/725

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

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, ocomando ignorado. Não é necessário utilizar esse campo caso esteja utilizando AutoConnect.

 –   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, ocomando 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 tantochamadas 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ção0 Disconnected1 Connected2 Dialing3 Dropping4 Closing line

Page 336: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 336/725

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

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 ostatus atual.

Connection Type Tests

 A maioria dos drivers seriais devem trabalhar com cada tipo de conexão. Porém, a maioria deles sãodesenvolvidos antes que o tipo de conexão tenha sido criado. A tabela a seguir lista tipos deconexõ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 emcontato com seu distribuidor.

Driver Modem TCP/IP UDP/IPMODSL  ⌧  ⌧  ⌧  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 decomunicação) para associar tags da aplicação com os endereços do equipamento. Pode-seconfigurar múltiplas planilhas de Driver  —cada uma delas dividida nas seções Header e Body . Odriver MODBU será utilizado para fins de demonstração.

  Nota:Nem todos os drivers requerem MAIN DRIVER SHEET. Alguns drivers necessitamsomente de uma Planilha Padrão . Consulte a documentação do driver para instruçõesespecíficas.

Page 337: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 337/725

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

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 dopainel 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 dodriver. 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 bemore 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”.

Page 338: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 338/725

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

InduSoft Web Studio Página 337

•  Read Trigger: Contém um tag que sempre gera um evento de leitura quando o valor do tag nocampo 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 completadocom 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 arquivoMODBU.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 queo 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çoesteja 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 problemaspara 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 registrotermina.

•  Write Status: Contém um tag que sempre preenchido com um valor inteiro ao terminar umevento 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, ouEndereço PLC relacionados a essa planilha específica. Cada driver possui uma sintaxe diferentepara 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 emuma forma diferente dos tags de outros campos), pois esses ainda não foramcriados no tag database. Em outras palavras, o sistema não poderá trabalhar deforma 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.

Page 339: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 339/725

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

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’stype, 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 osHolding Registers, a partir do endereço 100 on. No casode AEG 984, a partir do endereço 400100 on.

OMPLC (Host Link)

IR:0 IR indica que essa planilha comunicará com I/O andInternal Relays, a parir do endereço 0 on. No caso deC200H, a partir do endereço IR00000 on.

FANUC (SNP) %M %M indica que essa planilha comunicará com o %Mdiscrete internal operator.Não há endereço inicial para esse driver.

  ABKE (DF1) N7:0 N7 indica que essa planilha comunicará com o arquivoN7, a partir do endereço 0 on. No caso de PLC-5/40, a partir do endereço N7:0.

 AS511(Siemens PGPort)

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 emuma 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 deendereç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 é seguroespecificar 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}).

Page 340: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 340/725

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

InduSoft Web Studio Página 339

  Nota:Como acontece no campo Station, não pode-se testar a existência de tags inseridosentre 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 automaticamenteinsere 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, esseparâmetro capacita uma escala de valores que podem ser convertidos para um formato deengenharia. 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 eMax 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émde 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 ooffset para cada endereço inicial configurado no campo Header. Em alguns casos, pode-seindicar o espaço Address específico.

Para o driver de nosso exemplo, digite o offset do endereço inicial configurado no campoHeader. 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 deValores

Significado

Div  Any Integer or Real

In read commands: Tag = (Host value) / DIV 

In write commands: Host value = Tag * DIV 

Page 341: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 341/725

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

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 nocampo 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 nocampo 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ãoserão configuradas e os tags da planilha Driver receberão o mesmo valor do endereçoconfigurado.

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.

Nomedo 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 "EnableRead when Idle" fields

RdCpl 0 Boolean Tag Boolean que estará nos campos "ReadComplete"

RdSt 0 Integer Tag Integer que estará nos campos "ReadStatus"

WrTr 0 Boolean Tag Boolean que estará nos campos "Write Trigger"

WrEn 0 Boolean Tag Boolean que estará nos campos "Enable Write when Idle"

Page 342: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 342/725

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

InduSoft Web Studio Página 341

Nomedo Tag

Tamanho Tipo Descrição

WrCpl 0 Boolean Tag Boolean que estará nos campos "WriteComplete"

WrSt 0 Integer Tag Integer que estará nos campos "WriteStatus"

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

Page 343: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 343/725

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

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

Page 344: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 344/725

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

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âmetrosMDS são padrões para qualquer driver. Utilize as instruções a seguir para configurar parâmetrosespecí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 epode 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.

Page 345: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 345/725

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

InduSoft Web Studio Página 344

Executando o Driver

  Após adicionar o driver ao projeto, o Studio configura o projeto para que seja executadoautomaticamente 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 DriverRuntime. 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 queimplemente 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 doserver, 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". 

Page 346: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 346/725

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

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 cliqueem OPC Browser para agrupar todos os itens OPC Server configurados. Selecione o item N7_0.

Selecione N7_0

Page 347: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 347/725

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

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 OPCClient 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 essegrupo (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 dealteraçã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 doPLC 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 eselecione a opção OPC Browser. 

Page 348: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 348/725

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

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 oruntime.

•  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 ourodá-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 nosistema 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 quandoqualquer 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 interfaceOPC.

  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 noBotã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-seexecutar 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 mensagensexibidas 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, deimediato, 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

Page 349: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 349/725

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

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 DCOMgeralmente 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 deprivilé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 tenteestabelecer a conexão.

Caso você não possa utilizar o mesmo usuário em ambos os computadores por algunsrequisitos 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 osassuntos 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 invesdo 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 deveestar 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 seudistribuidor 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çõesde 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últiplasaplicações. Somente os tags da aplicação atual estarão disponíveis.

Configurando TCP/IPOs módulos TCP/IP Client/Server do IWS permitem que duas ou mais aplicações InduSoft mantenham seusbancos de dados sincronizados. Tais módulos utilizam o protocolo TCP/IP da InduSoft para estabelecer comunicação entre as aplicações.

Page 350: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 350/725

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

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 nasmá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 acordocom 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 entreparê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 ouclass (ou ambos), cada elemento e membro será compartilhado. Deve-se digitar o nome do tagsomente 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 TagName. 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 omesmo número de elementos de um tag em client. Caso seja um classe tag, a definiçãode classe deverá ser a mesma em aplicações server e client. Caso você não siga taisregras, 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 dotag de outra máquina. O padrão é 250.

•  ConnectRetryTimeout: Período em segundos antes que o cliente possa tentar reconectar-se aoservidor. 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 menuprincipal, selecione Project → Status. No tab Execution Tasks, configure TCP/IP Client Runtimepara Manual ou Automatic. 

Page 351: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 351/725

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

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 IWSTCP/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, selecioneProject → Status. No tab Execution Tasks, configure o TCP/IP Server para Automatic. Ao rodar esseprograma, 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 eselecione Exit.

Configurando DDE A pasta DDE permite a configuração de um DDE Client para uma aplicação DDE Server, como em Excel (ouqualquer 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 interfacesqe 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 decomputadores de uma rede de trabalho.

•  Para rodar o IWS como server para uma conexão NetDDE, deve-se iniciar a aplicação DDEServer.

•  Para rodar o IWS como client para uma conexão NetDDE, utilize as mesmas planilhas deinterface 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 destring 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á:

Page 352: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 352/725

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

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çãoDDE 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çãoDDE 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 somentecom 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.

Page 353: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 353/725

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

InduSoft Web Studio Página 352

•  Campo Enable Write on Tag Change: Digite uma valor de tag maior que zero para habilitar odriver 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 noequipamento, 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 deseu 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 etó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 doservidor 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 iniciama 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 onome 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 doendereç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.

Page 354: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 354/725

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

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 àsferramentas 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 deSeguranç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.

Page 355: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 355/725

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

InduSoft Web Studio Página 354

  IMPORTANTE! 

  Após definir sua senha, você deverá utilizá-la cada vez que acessar o Sistema deSegurança, portanto, é imprescindível que você recorde essa senha.

Definindo GruposO 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 deseguranç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 oobjeto está sempre habilitado.

Page 356: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 356/725

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

InduSoft Web Studio Página 355

•  check-boxes Engineering Access: Controla quais tarefas de engenharia (desenvolvimento) osusuários desse grupo poderão acessar ao efetuarem log on.

  IMPORTANTE!É possível configurar o nível de segurança para documentos (como planilhas etelas) para assim protegê-los no ambiente de desenvolvimento.

•  check-boxes Runtime Access: Controla quais módulos de runtime os usuários desse grupopoderã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 eusuários você deseja que sejam configurados. Deve-se definir os direitos de cada grupo em seuambiente.

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

Page 357: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 357/725

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

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 novogrupo, como se segue.

  Clique no botão New e quando aparecer o diálogo New Group Account, digite um nome do grupono 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, selecioneOperation 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 odiálogo New Group Account .

Page 358: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 358/725

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

InduSoft Web Studio Página 357

  Selecione Maintenance no combo-box Group Account e configure os direitos de acesso para ogrupo, 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 deacesso:

Page 359: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 359/725

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

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 algumasplanilhas (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áriosautorizados 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.

Page 360: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 360/725

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

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 dousuá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 seOperator_1 ainda aparece no combo-box User.

  Selecione Operation no combo-box Security Group.

Page 361: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 361/725

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

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 UserName. 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 osgrupos e usuários recém criados.

Page 362: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 362/725

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

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 :

Page 363: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 363/725

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

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 .

Page 364: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 364/725

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

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 dodiá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 degrupo.

  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

Page 365: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 365/725

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

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úmeromí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 menoscaracteres do que o número requisitado, o InduSoft Web Studio rejeitará a senha e exibirá a seguintemensagem 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á osusuários assinalados nesse grupo a alterar suas senhas. Ao tentar logar-se com a senha antiga, o diálogoChange Password aparecerá automaticamente para o usuário, e esse não poderá completar o processo delog-in até que a nova senha seja fornecida.

Page 366: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 366/725

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

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 operí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. Osistema 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ê podepermitir/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 desconectadoautomaticamente. 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 é desconectadoautomaticamente após o período de tempo configurado no campo Log Off after desde quando o usuárioatual conectar ao sistema  

radio button Count time after last action: Quando esta opção é selecionada, o usuário atual é desconectadoautomaticamente 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 onúmero máximo de tentativas (fornecendo senhas inválidas), o InduSoft Web Studiobloqueará a conta do usuário.

*  text-box  Reset counter after: Digite um valor nesse campo para definir por quantotempo, 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 Resetcounter after expirar. O Administrador do Sistema deverá reiniciar a conta dousuário desabilitando o check-box  User is blocked no diálogo User Account  ouexecutando 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, obox User is blocked estará habilitado. As figuras a seguir são exemplos que indicam que o usuário Eng está bloqueado:

Page 367: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 367/725

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

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 suasestaçõ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

Page 368: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 368/725

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

InduSoft Web Studio Página 367

  Habilite o novo check-box  Use preferentially the Remote Security System para designar umsistema 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ãoatualizadas 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 podemcompatilhar 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 apenasquando houver um evento associado ao sistema de segurança (como um logging on de usuário), ouseja, 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çaPode-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 , eaquelas 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 demenu 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 deacesso 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 deGroupB 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

•  Planilha Math 002 tem Nível de Acesso = 7 

•  Planilha Math 003 tem Nível de Acesso = 12 

•  Planilha Math 004 tem Nível de Acesso = 20 

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

Page 369: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 369/725

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

InduSoft Web Studio Página 368

•  Nenhum usuário pode acessar a Planilha Math  004 

Definindo UsuáriosClique no botão User Account para abrir o diálogo User Account . Pode-se utilizar esse diálogo para criar emanter 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 menuprincipal.

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 permitemque todas as tarefas sejam habilitadas por padrão. Devido a isso, você deverá alterar essesparâmetros e configurar alguns poucos privilégios à medida que sejam necessárias para oprocedimento de start-up.

Page 370: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 370/725

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

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 WebStudio 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.

Page 371: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 371/725

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

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 nasaplicações de seu projeto.

Testando sua AplicaçãoUtilize 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 aomesmo tempo que visualiza dinâmicos gráficos online no ambiente de desenvolvimento. O modode exibição teste não habilita a utilização Command, dinâmicos  Text I/O de entrada ouexecução de planilhas.

  Nota:

Utilizando a opção do menu Test Display é o mesmo que utilizar o botão nabarra 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 nabarra de ferramentas Execution Control .

•  Project →  Run Application: Inicia os módulos de runtime especificados como Automatic nodiá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álogoExecution 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álogoExecution Environment ). Certifique-se de que a target station desejada esteja 

Page 372: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 372/725

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

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 nabarra 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 doambiente de desenvolvimento. Clique uma vez na barra de título e arraste-a para onovo 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/ouexpressõ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 deerros. Por exemplo, pode-se criar um conjunto de tags em DB1 para testar uma função de receita, ecriar um outro grupo de tags em DB2 para testar a função de tendência.

Page 373: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 373/725

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

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 dadosdo 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 comoBackground Tasks durante o runtime para funcionarem de maneira apropriada.

Corrigindo Erros da Aplicação a partir da Janela OutputUtilize a output window(LogWin ) (localizada próxima ao Database Spy ) para visualizar mensagens decorreçã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 doambiente 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 .

Page 374: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 374/725

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

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 tabutilizao 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 quesejam 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 queo 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

Page 375: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 375/725

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

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 osbotõ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 resultadosno 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 dedesenvolvimento, 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 desua 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 onome 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çãode 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íodosde tempo. Ele cria um arquivo no qual você pode dump os resultados da coleção de dados, e esse arquivocontinua a crescer em tamanho até que você pare o processo de logging (coleção de dados). Utilize o móduloLogWin (local e remoto) para gravar transações DDE, OPC, e TCP/IP, ativar módulos, traçar tags, etc.

Page 376: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 376/725

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

InduSoft Web Studio Página 375

Para iniciar LogWin , vá para Project → Status localmente ou selecione LogWin do menu Tools nobox CE.

Iniciando LogWin

Para corrigir erros em Web client, habilite Log selecionando Project → Settings da barra de menu, edepois selecionando o aba  Web. Habilite o check-box  Enable e digite  path+filename na opção FileName. Ao terminar, selecione OK.

Page 377: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 377/725

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

InduSoft Web Studio Página 376

Corrigindo erros em Web Client

Utilizando Ferramentas RemotasO 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 ecorrigir 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çãolocalmente 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 dedesenvolvimento.

•  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 comoAutomatic.

•  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álogoExecution Environment ). Certifique-se de que a target station está configurada (local ouremotamente) antes de executar Stop Application.

Page 378: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 378/725

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

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 remotoque 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 queesteja 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. 

Page 379: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 379/725

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

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 ouequipamento 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 doPLC.

  Fornecer interfaces IHM (como button e text input) para enviar comandos ou setpoints para oPLC ou equipamento.

 A figura a seguir ilustra o processo de transferir uma aplicação do ambiente de desenvolvimento doIWS 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.

Page 380: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 380/725

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

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çãodessa porta (por exemplo, para previnir um conflito ou assuntos relacionados à segurança, como um firewall), veja “Configurando os Parâmetros do Tab Options” noCapí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 econfigurar 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 umcomponente 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 dosite 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óduloTCP/IP Client virtual para troca de dados com modulo TCP/IP Server do Servidor de Dados. Esse máduloTCP/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 eautomaticamente 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 tagspara os quais os tags indiretos estão apontando devem ser configurados na mesma tela, ou o Web ThinClient 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-seconfigurar 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.

Page 381: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 381/725

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

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 econfigurar 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 resultadosdesses 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 pastada 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 arquivosde 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 IWSconecta-se automaticamente ao site da InduSoft na Web, efetuando o download e registrando ocomponente.

•  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 eregistrar 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 deinstalaçã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.

Page 382: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 382/725

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

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 aoIIS, 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 WindowsNT/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, eaparecerá o diálogo Default Web Site Properties .

Page 383: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 383/725

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

InduSoft Web Studio Página 382

  Seleione o tab Home Directory e especifique o caminho do diretório Home no campo de textoLocal 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ávelNTWebServer.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

Page 384: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 384/725

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

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 odiá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. 

Page 385: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 385/725

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

InduSoft Web Studio Página 384

Configurando a AplicaçãoSalve 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últiplastelas 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

Page 386: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 386/725

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

InduSoft Web Studio Página 385

   A seguir, selecione Project → Settings da barra de menu principal e, quando aparecer o diálogoProject 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 oruntime.

Campo Send Period: Digite um valor para especificar a frequencia (em milissegundos) com queServer e Web Thin Client stations trocarão os dados.

check-box Disable Remote Client Commands: Habilite esse box para prevenir um cliente remoto deobter 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 noBrowser 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.

Page 387: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 387/725

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

InduSoft Web Studio Página 386

Botão IP Security: Clicar nesse botão abre o diálogo IP Security .

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. Utilizeos botões Add e Remove para mover os endereços IP para a lista IP Address Range. O IWSpermite 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 doarquivo 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, oscampos 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-sede forma apropriada ao tamanho da tela do painel alvo. Scale: 100% representa otamanho 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 WebSettings para as páginas da Web.

  IMPORTANTE!Deve-se verificar uma aplicação sempre que os parâmetros para Web da tela sejamalterados no diálogo Project Settings (tab Web).

 Verificar que todas as alterações tenham sido aplicadas (ou reaplicadas) à página .html.

Page 388: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 388/725

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

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 queuma 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 osresultados desses tags no Browser. (Reveja “Compartilhando Tgas com umCompartilhando Tagscom 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  estejamrodando 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 ouNetscape) e digite o endereço URL (certificando-se de que o diretório Home  seja incluídocorretamente) 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  UserName, sua senha no text box Password e clique em OK para abrir a tela <screen name >.html.

Logando-se

Background TasksDrivers

Page 389: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 389/725

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

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çãode 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 deforma satisfatória. Caso exista um problema com o TCP/IP Server, uma mensagemde erro sera exibida.

  Após fechar o diálogo Log On , aparecerá a tela a seguir na janela do Browser, indicando o status dodownload.

Relatando Status do Download

Page 390: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 390/725

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

InduSoft Web Studio Página 389

Quando o download estiver completo, a tela de sua aplicação será exibida. Nesse ponto, o Web ThinClient 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

Page 391: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 391/725

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

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 detrabalho de runtime e então monitorar/gerenciar a aplicação remotamente, a partir de uma variedade deequipamentos 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 emplataforma 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 WebStudio\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 dedesenvolvimento e alvo:

Page 392: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 392/725

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

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 oIWS 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 IWSenvia um sinal RS-232 da estação receptora para a estação transmissora, indicando quea 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 dedesenvolvimento).

Page 393: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 393/725

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

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.

Page 394: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 394/725

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

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ãoInstall 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 odownload da aplicação para a estação remota.

Especificando Tipo de Link e Endereço IP

Page 395: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 395/725

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

InduSoft Web Studio Página 394

 Atenção:

  Ao enviar uma aplicação para a target station remota, as alterações causam efeitosonline, 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  (nodiá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 deaconselhá-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 appto 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.

Page 396: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 396/725

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

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 odownload da Aplicação para uma estação remota em runtime que esteja rodando em Windows NT/2000/XPou CEView sob Windows CE.

   Antes de iniciar, verifique que Remote Agent  (CEServer.exe) esteja rodando na target stationremota.

  Nota:O arquivo CEServer.exe está localizado no seguinte diretório em computadorescom Windows2000/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.

Page 397: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 397/725

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

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 doInduSoft Web Studio (IWS).

Utilizando TagsTags  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 noCapítulo 5: Trabalhando com Tags antes de ler esse capítulo.

Especificando Tipos de DadosPode-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 //.

Page 398: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 398/725

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

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 deduas 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)

Page 399: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 399/725

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

InduSoft Web Studio Página 398

  Notas:Funções Math são calculadas da esquerda para a direita, de acordo com a ordemespecificada na formula por cada operador. Para alterar a ordem de avaliação, coloqueem 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.”

Page 400: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 400/725

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

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ãomatemá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 .

Page 401: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 401/725

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

InduSoft Web Studio Página 400

Visão Geral do VBScriptO 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 IWShospeda 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 hardwaredeverá habilitar o suporte para VBScript, de modo que o CEView possa executar osscripts 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émdisso, esse pode ser utilizado com uma referência rápida para a maioria dos recursos de linguagem maisutilizados. 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:

InterfaceScopo para

porcedimentos eVariáveis

Execução Funcionalidade

Global Procedures Gráficos e Tarefas - Declaração deProcedimentos

Graphics Script Somente Interface descript 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

  Declaração de Variáveis

Page 402: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 402/725

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

InduSoft Web Studio Página 401

  Execução  ActiveX Events Objeto onde o script 

está configuradoServer (Viewer) + Web Thin Clients

  Declaração de Variáveis  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 deGrupo

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)

GlobalProcedures

GlobalProcedures

GraphicsScript

GraphicsScript

Screen A

Screen ScriptScreen Script

Commanddynamic

Commanddynamic

ActiveX eventsActiveX events

Screen A

Screen ScriptScreen Script

Commanddynamic

Commanddynamic

ActiveX eventsActiveX events

Screen B

Screen ScriptScreen Script

Commanddynamic

Commanddynamic

ActiveX eventsActiveX events

Screen B

Screen ScriptScreen Script

Commanddynamic

Commanddynamic

ActiveX eventsActiveX events

Screen N

Screen ScriptScreen Script

Commanddynamic

Commanddynamic

ActiveX eventsActiveX events

Screen N

Screen ScriptScreen Script

Commanddynamic

Commanddynamic

ActiveX eventsActiveX events

Background Task(BGTask task)

StartupScript

StartupScript

Script Groups

Script 001Script 001

Script 002Script 002

Script NScript N

Script Groups

Script 001Script 001

Script 002Script 002

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ãocompartilham 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, osprocedimentos e variáveis declarados na interface Graphics Script NÃO estãodisponí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.

Page 403: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 403/725

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

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 doIWS 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 interfacedisponível. Os tags do IWS são compartilhados por todos os módulos do IWS, incluindo o Módulo Graphic eBackground 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 sejamchamados a partir de alguma outra interface VBScript disponível no produto. Portanto, essa interface pode ser utilizada SOMENTE para declarar e implementar procedimentos a seremchamados 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)

Page 404: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 404/725

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

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 automaticamenteexecutada uma vez quando o graphic module é iniciado. Essa interface é útil ao iniciar variáveisou executar lógicas que devem ser implementadas ao iniciar a aplicação.

•  Graphics_WhileRunning(): O código configurado junto a essa sub-rotina é automaticamenteexecutada 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 queo 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 comsucesso.

•   A sub-rotina Graphics_WhileRunning() mantém-se executando-se na Web Thin Client stationenquanto o controle ISSymbol está hospedado pelo Web Browser.

•    A sub-rotina Graphics_OnEnd() é executada na Web Thin Client station logo que o WebBrowser é desligado (ou quando o controle ISSymbol não é mais hospedado pelo Web Browser).

Page 405: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 405/725

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

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

Page 406: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 406/725

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

InduSoft Web Studio Página 405

Graphic Module - Screen ScriptPara editar a interface Graphics Script, clique com o botão direito na tela, e selecione a opçãoScreen 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 dependeda 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 sendoimplementados.

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)

Page 407: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 407/725

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

InduSoft Web Studio Página 406

AreaCircle = Sqr(radius)*$Pi()

End Function

Sub CheckLoLimit (myValue, myLoLimit)

If myValue < myLoLimit ThenMsgBox ("Value out of range")

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 CommandPara 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.

Page 408: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 408/725

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

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 GlobalProcedures 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 EventsPara editar a interface ActiveX Events, selecione a opção Script do tab Events do objeto ActiveX inserido na tela.

Page 409: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 409/725

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

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 direitonesse objeto para abrir o diálogo Object Properties.

  Clique no botão Configuration. O diálogo Configuration abrirá. Clique no tab Events.

Page 410: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 410/725

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

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 procedimentosimplementados 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çãoUtilizando a Barra de Ferramentas Active Objects do Capítulo 7.

Page 411: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 411/725

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

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 ScriptPara 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 quedevem 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.

Page 412: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 412/725

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

InduSoft Web Studio Página 411

Exemplo:

'Variáveis disponíveis para todos os grupos Script da tarefa Script podem ser declaradas einicializadas aqui

Dim MyVar, Counter

MyVar = 100

'Procedimentos disponíveis para todos os grupos Script da tarefa Script podem ser implementadasaqui

Function AreaEquTriangle ( base, high)

AreaEquTriangle = (base * high) / 2

End Function

Sub CheckLimits (myValue, myHiLimit, myLoLimit)

If (myValue > myHiLimit Or myValue < myLoLimit) ThenMsgBox ("Value out of range")

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/XPoperating system.")

End If 

Tarefa Background – Grupos ScriptPara 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:

Page 413: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 413/725

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

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 osScript Groups sequencialmente (baseado no número do grupo) e executa somente os grupos noqual 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 campoExecution 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áveislocais de qualque Script Group serão reiniciadas.

Page 414: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 414/725

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

InduSoft Web Studio Página 413

 Variáveis declaradas em um grupo têm escopo local somente para aquele grupo específico. Essesnão estão disponíveis para qualquer outra interface VBScript. A partir do Script Group, pode-sechamar todos os procedimentos implementados na interface Global Procedures ou na interfaceStartup 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 = myVarEnd If

Referência de Linguagem

ConstantesConstantes 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

Constante Valor Descrição

  vbBinaryCompare 0 Executa uma comparaçãobinária 

  vbTextCompare 1 Executa uma comparaçãotextual

Data e Hora das Constantes

Constante Valor Descrição

  vbSunday 1 Domingo

  vbMonday 2 Segunda-fe

  vbTuesday 3 Terça-feira

Page 415: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 415/725

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

InduSoft Web Studio Página 414

  vbWednesday 4 Quarta-feira

  vbThursday 5 Quinta-feira

  vbFriday 6 Sexta-feir

  vbSaturday 7 Sábado

  vbUseSystemDayOfWeek 0 Utiliza o dia da semana especificado nasconfigurações de seu sistema para o primeiro dia da semana.

  vbFirstJan1 1 Utiliza a semana na qualserá o dia 1 de janeiro(padrão).

  vbFirstFourDays 2 Utiliza a primeira semana que tenha ao menos quartodias no ano seguinte.

  vbFirstFullWeek 3 Utiliza primeira semana 

completa do ano.

Constantes de Formatos de Data

Constante Valor Descrição

  vbGeneralDate 0 Exibe data e/ou hora. Para número reais, exibe uma data e hora. Caso não haja partefracional, exibe somente uma data. Caso não haja parteinteira, 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 nasconfigurações regionais deseu computador.

  vbShortDate 2 Exibe uma data utilizando oformato de data curtoespecifcado nasconfigurações de seucomputador.

  vbLongTime 3 Exibe uma data utilizando o

formato longo especificadonas configurações regionaisde seu computador.

  vbShortTime 4 Exibe uma hora utilizando oformato curto especificadonas configurações regionaisde seu computador.

Page 416: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 416/725

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

InduSoft Web Studio Página 415

Constantes

Constante Valor Descrição

  vbObjectError -2147221504 Números de erros definidospelo usuário devem ser maiores que esse valor.

Constantes de Diálogos –Botões e Ícones

Constante Valor Descrição

  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, eCancel.

  vbYesNo 4 Exibe os botões Yes e No.

  vbRetryCancel 5 Exibe os botões Retry eCancel.

  vbCritical 16 Exibe o ícone CriticalMessage .

  vbQuestion 32 Exibe o ícone WarningQuery.

  vbExclamation 48 Exibe o ícone WarningMessage.

  vbInformation 64 Exibe o ícone InformationMessage.

  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áriodeverá responder o diálogoantes de continuar trabalhando na aplicaçãoatual.

  vbSystemModal 4096 Sistema modal. Nos sistemas Win32, essa constantefornece um diálogo deaplicação modal que

permanence sempre acima dequaisquer outros programasque estejam rodando.

Constantes de Diálogos – Botão Selecionado

Constante Valor Descrição

  vbOK 1 Botão OK foi clicado.

  vbCancel 2 Botão Cancel foi clicado.

Page 417: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 417/725

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

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

Constante Valor Descrição

  vbCr Chr(13) Carriage Return (equivalà tecla ENTER)

  VbCrLf Chr(13) & Chr(10) Combinação Carriage return– linefeed

  vbFormFeed Chr(12) Form feed; não usual emMicrosoft 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 ocomprimento de string 0 ("");utilizado para chamar procedimentos externos

  vbTab Chr(9) Tab Horizontal

  vbVerticalTab Chr(11) Tab Vertical; Não usual emMicrosoft Windows

Constantes Tri-stateConstante Valor Descrição

  vbUseDefault -2 Utiliza padrão deconfigurações regionais docomputador.

  vbTrue -1 TRUE (VERDADEIR

  vbFalse 0 FALSE (FALSO)

Constantes de Tipos de Variáveis

Constante Valor Descrição

  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 

Page 418: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 418/725

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

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 somen

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

Page 419: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 419/725

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

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 inesperado500 Variável indefinida 

458 Variável utiliza um tipo Automation não suportadoem VBScript 

450 Número errado de argumentos ou preenchimento depropriedade inválido

Erros de sintaxe do VBScript

Número do Erro Descrição

1052 Não pode haver múltiplospropriedade/método em uma classe

1044 Não pode utilizar parênteses ao chamar uma Sub

1053 Class inicializadora ou finalizadora não possuiargumentos

1058 Especificação 'Default' pode estar somente emProperty Get 

1057 Especificação 'Default' deve especificar também 'Public'

1005 '(' Esperado

1006 ')' Esperado1011 '=' Esperado

1021 'Case' Esperado

1047 'Class' Esperado

1025 Final da Demostração Esperado

1014 'End' esperado

1023 Expressão Esperada 

Page 420: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 420/725

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

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' ESperado1013 '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 menosum argumento

1002 Erro de sintaxe

1055 'Next' Inesperado

1015 Constante string indeterminada 

Page 421: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 421/725

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

InduSoft Web Studio Página 420

FunçõesNomes da Função

Abs Array Asc Atn

CBool CByte CCur CDate

CDbl Chr CInt CLngConversions Cos CreateObject CSng

CStr Date DateAdd DateDiff 

DatePart DateSerial DateValue Day 

Derived Math Escape Eval Exp

Filter FormatCurrenc y 

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 

Page 422: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 422/725

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

InduSoft Web Studio Página 421

Palavras-ChavePalavras-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 nenhumdado. Não é a mesma indicação de valor vazio(Empty).

  True True indica o valor -1.

MétodosMétodos

Método Descrição

Clear Limpa todas as configurações de propriedade doobjeto 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 deexpressã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çõesObjetos e Coleções

Nome Descrição

Class Object O objeto criado com a utilização da demonstraçãoClass. 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 errosde run-time.

Match Object Fornece acesso para propriedes read-only de uma expressão regular Match.

Page 423: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 423/725

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

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.

Page 424: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 424/725

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

InduSoft Web Studio Página 423

OperadoresAritimética

Símbolo Nome Descrição

^ Exponenciação

 Aumenta o número para um

expoente.

- Negação

Encontra a diferença entredois números ou indica o valor negativo de uma expressão numérica.

* Multiplicação Multiplica dois números.

/ DivisãoDivide dois números eretorna um resultadofloating-point.

\ Divisão por inteiroDivide dois números eretorna um resultado inteiro.

Mod Módulos aritiméticosDivide dois números eretorna somente oremanescente.

+ Adição Faz a soma de dois números.

- Subtração

Faz a diferença entre doisnúmeros ou indica o valor negativo de uma expressãonumérica.

& Concatenação de stringsConcatenação de duasexpressões.

Comparação

Símbolo Nome Descrição

= Igualdade Comparação é Verdadeira caso a primeira expressãoseja igual a segunda.

<> Desigualdade Comparação é Verdadeira caso a primeira expressãoseja dierente da segunda.

< Menor que Comparação é Verdadeira caso a primeira expressãoseja menor que a segunda.

> Maior que Comparação é Verdadeira 

caso a primeira expressãoseja maior que a segunda.

<= Menor ou igual a Comparação é Verdadeira caso a primeira expressãoseja menor que a segunda.

>= Maior ou igual a Comparação é Verdadeira caso a primeira expressãoseja maior ou igual a 

Page 425: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 425/725

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

InduSoft Web Studio Página 424

segunda.

Is Equivalência de objeto Compara duas variáveis dereferência do objeto.Comparação é Verdadeira caso ambos os nomes de

objetos refriram-se ao mesmoobjeto.

Lógica

Simbolo Nome Descrição

Not Negação lógica Executa negação lógica emuma expressão.

  And Conjunção lógica Executa uma conjunçãoló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çãológica em duas expressões.

Indicação

Símbolo Nome Descriçã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 queindica 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 contextopara um Arquivo Help tópico.

HelpFile Configura ou retorna caminhocompletamente qualificado para o AquivoHelp.

IgnoreCase Configura ou retorna um valor Booleano que

Page 426: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 426/725

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

InduSoft Web Studio Página 425

indica se uma pesquisa padrão faz diferença entre letras maiúsculas ou minúsculas ounão.

Length Configura ou retorna um valor Booleano queindica se uma pesquisa padrão faz diferença 

entre letras maiúsculas ou minúsculas ounão.

Number Retorna ou configura um valor numéricoespecificando 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çõesDemonstrações

Nome da demonstração Descrição

Call Transfere controle para procedimento Sub ouFunction.

Class Declara o nome de uma classe, assim comouma 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 dearmazenamento.

Do…Loop Repete um bloco de Demonstrações enquantouma condição é Verdadeira ou até a condiçãotornar-se Verdadeira.

Erase Reinicializa os elementos de arrays fixed-sizee desloca espaço de armazenamento dedynamic-array.

Execute Executa uma ou mais Demonstraçõesespecificadas.

ExecuteGlobal Executa uma ou mais Demonstraçõesespecificadas 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 umnúmero de vezes especificado.

Page 427: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 427/725

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

InduSoft Web Studio Página 426

Function Declara o nome, argumentos e código queformam o corpo de um procedimentoFunction.

If…Then…Else Condicionalmente executa um grupo deDemonstraçõ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çode 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 doprocedimento 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 doprocedimento 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 doprocedimento Property que configure uma referência a um objeto.

Public Declara variáveis públicas e aloca espaço dearmazenamento. Declara, em um bolcoClass, 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íveldo 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.

Page 428: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 428/725

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

InduSoft Web Studio Página 427

Dicas e Truques

VBScript Editor - IntelliSenseIntelliSense fornece uma variedade de opções que tornam as referências de linguagem simples e defá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 dequalquer tag, propriedades/métodos de um objeto ActiveX object, ou funções da linguagembuilt-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 detodos os tags disponíveis para a aplicação atual, assim como todas as Funções da linguagem built-in doIWS.

 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:

Page 429: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 429/725

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

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 (.) emqualquer 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 asFunções de linguagem buit-in do IWS, as quais incluem todos os parâmetros suportadospor essa função, com aquele atualmente configurado em texto em negrito.

Page 430: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 430/725

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

InduSoft Web Studio Página 429

 –   Complete Word: Complete word finaliza um tag, membro, campo, função ou nome depropriedade/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 VBAEnquanto VBScript e Visual Basic For Aplicattion (VBA) são similares e baseados no padrão delinguagem Visual Basic, existem algumas vantagens na utilização do VBScript para usuários doIWS:

 –    VBScript é suportado em sistema operacional Microsoft Windows CE, enquanto o VBA nãoé.

 –    VBScript fornece scripting ativos para uma extensa variedade de ambientes, incluindo Webclient scripting em Microsoft Internet Explorer, o que evita operações que possamrepresentar 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

EvalMecelâneas

Execute

Objetos RegExp

ScriptEngineScriptEngineBuildVersion 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, RemoveCollection

 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

Page 431: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 431/725

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

InduSoft Web Studio Página 430

Line numbers, Line labels

CVar, CVDateConversion

Str, Val

 Todos os tipos de dados intrinsic excetuam o

 Variant Data Types Type...End Type

Date/Time Date statement, Time statement 

DDELinkExecute, 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 

ClipboardObjects

Collection

Operators Like

DeftypeOpção Base

Opção CompareOptions

Opção Private Module

Expressões contendo a keyword Is ou algunsoperadores de comparação

Select CaseExpressões contendo uma escala de valoresutilizando a palavra-chave To

Strings de comprimento fixo

LSet, RSet 

Demonstração MidStrings

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 IWSpara os eventos On Open, While Open e On Close utilizados para a tela (veja Interface Screen Logic

Page 432: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 432/725

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

InduSoft Web Studio Página 431

no diálogo Screen Attributes). Caso você configure Screen Script (linguagem VBScript) e ScreenLogic (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 interfaceScreen Script (linguagem VBScript)

Funções MsgBox() e InputBox()

 A funções MsgBox() e InputBox() da linguagem VBScript permite a exibição de mensagens pop-updurante o runtime. Tais Funções são sincrônicas. Quando uma delas é executada, as instruçõesremanescentes do código não serão executadas antes que as mensagens pop-up iniciadas pelasFunçõ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 ActiveXUtilizando as interfaces VBScript para o Graphic module (Graphics Script, Screen Script, dinâmicoCommand e eventos ActiveX), pode-se utilizar a sintaxe abaixo para acesso a propriedades emé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 propriedadeName (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 desseobjeto 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 NOTO 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 abaixoilustra 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:

Page 433: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 433/725

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

InduSoft Web Studio Página 432

Caso a expressão seja O resultado será

-3 2

-2 1

-1 0

0 -11 -2

2 -3

3 -4

  Nota: Ao tentar registrar qualquer valor diferente de 0 em um tag Booleando IWS, esseassumirá 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 tagBoolean (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 otag tenha o valor 0, o NOT operator retornará o valor 1 ao tag. Caso o tag tenha um valor diferentede 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 FalsoEm 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âmetroBooleanTrueAboveZero 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

Page 434: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 434/725

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

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 WindowsCE 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 pelofabricante 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áveisUm escopo de variáveis é determinado por onde esse está declarado. Ao declarar um variável juntoa 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ívelpara todos os procedimentos de seu script, o que é uma variável script-level, e possui um escoposcript-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 oprocedimento é rodado. Quando o procedimento termina, a variável é destruída. Variáveis locaissã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áveisUma 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 emque sua script está rodando. Em VBScript, variáveis são sempre um dos tipos fundamentais dedados, 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. Talatitude geralmente não é de todo boa, pois você poderá digitar incorretamente o nome da variávelem 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 Procedurespara requisitar declaração explícita de todas as variáveis. A menos que você delete essa 

Page 435: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 435/725

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

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 ConstantesUma 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 nomessignificantes, 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 dediferenciar valores de string de valores numéricos. Representa-se Datas e Horas literaisenclausurando-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, issopoderá 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á-lasem letras maiúsculas. Diferenciar constantes de variáveis elimina dúvidas ao desenvolver scriptsmais 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êntesespara 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ãoavaliados 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 

Page 436: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 436/725

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

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 queaparecem da esquerda para a direita.

O operador string de concatenação (&) não é um operador aritimético, mas em precedência, esseocorre 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, esim 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 erepita 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 deComparação.

Demonstrações If...Then...Else podem ser colocadas conjuntamente em quantos níveis foremnecessá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 

Page 437: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 437/725

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

InduSoft Web Studio Página 436

Rodando Algumas Demonstrações Para Condição Verdadeira e Rodando Outras ParaCondição Falsa

Pode-se utilizar uma demonstração If...Then...Else para definir dois blocos de demonstraçõesexecutá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 thenMsgbox value

Else

Msgbox "Value out of range!" 

End If

Pode-se adicionar quantas cláusulas ElseIf sejam necessárias para a obtenção de escolhasalternatives, embora o uso extensivo de cláusulas ElseIf pode tronar-se exaustivo. A demonstraçãoSelect 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émde 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 partesuperior 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

Page 438: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 438/725

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

InduSoft Web Studio Página 437

Case "MasterCard"

DisplayMCLogo

ValidateMCAccount

Case "Visa"

DisplayVisaLogoValidateVisaAccount

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 Casesomente se cada demonstração ElseIf validar a mesma expressão.

Executando em Loop Através do CódigoExecutar em Loop permite rodar um grupo de Demonstrações repetidamente. Algumas execuçõesem 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 emum 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úmeroinfinito de vezes. As Demonstrações são repetidas enquanto uma condição é Verdadeira e tambématé 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), oupode-se verificá-la após o modo loop ter sido rodado ao menos uma vez (como mostrado no exemploChkLastWhile). No procedimento ChkFirstWhile, caso myNum esteja configurado como 9 ao invésde 20, as Demonstrações do modo loop nunca serão rodadas. No procedimento ChkLastWhile, asDemonstraçõ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

Page 439: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 439/725

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

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

counter = counter + 1

Loop While myNum > 10

MsgBox "The loop made " & counter & " repetitions."

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 mostradono exemplo ChkFirstUntil), ou verificá-la após o modo loop ter sido rodado ao menos uma vez (comomostrado 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

counter = counter + 1

Loop

MsgBox "The loop made " & counter & " repetitions."

End Sub

Sub ChkLastUntil()

Dim counter, myNum

counter = 0

myNum = 1

Do

myNum = myNum + 1

counter = counter + 1

Loop Until myNum = 10

MsgBox "The loop made " & counter & " repetitions."

End Sub

Page 440: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 440/725

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

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 loopinterminável. Por isso, deve-se utilizar a demonstração Exit Do no bloco de demonstrações True deuma 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

counter = counter + 1

If myNum < 10 Then Exit Do

LoopMsgBox "The loop made " & counter & " repetitions."

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çãodo modo Do...Loop.

Utilizando For...Next

Pode-se utilizar Demonstrações For...Next para rodar um bloco de Demonstrações por um númeroespecí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

Page 441: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 441/725

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

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 antesque a variável de contagem alcance seu valor final. Geralmente deseja-se sair do modo loopsomente 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çãoIf...Then...Else. Caso a demonstração seja Falsa, o loop rodará normalmente.

Procedimentos em VBScriptEm 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çõesSub e End Sub) que executam ações, embora não retornem valores. Um procedimento Sub podepegar 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 eInputBox para prontificar um usuário sobre informações. Depois, os resultados de um cálculo sãobaseados 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 umprocedimento Sub, embora também possa retornar um valor. Um procedimento Function podepegar argumentos (constantes, variáveis ou expressões pasadas através de um procedimento desolicitação). Caso um procedimento Function não tenha argumentos, sua demonstração Functiondeverá 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.

Page 442: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 442/725

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

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 oprocedimento 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ídosparê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 umprocedimento 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ávelou 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 procedimentocom valores para quaisquer argumentos solicitados, separados por vírgulas. A demonstração Callnã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.

Page 443: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 443/725

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

InduSoft Web Studio Página 442

Capítulo 16: Utilizando a Ferramenta/Editor de TraduçãoUtilizando a Ferramenta de Tradução, pode-se traduzir qualquer texto da aplicação que esteja visíveldurante 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, ouutilizar qualquer editor para arquivos CSV, como Microsoft Notepad ou Microsoft Excel, para criar o arquivocom o texto traduzido.

Translation Tool traduz frases e parágrafos inteiros, ao invés de traduzir palavra por palavra, permitindo oajuste 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-sealterar 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.

Page 444: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 444/725

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

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 aoiniciar 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 umidioma. 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 onome de cada coluna que deverá ser utilizada, por padrão, para traduzir a aplicação

Page 445: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 445/725

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

InduSoft Web Studio Página 444

logo ao iniciá-la. Caso esse campo for deixado em branco, a aplicação será iniciada comseu idioma original. O usuário poderá configurar um idioma diferente durante o runtimeexecutando 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çãodevido aos caracetres de espaço configurados erroneamente ao criar os objetos ousomente ajustar o alinhamento.

*  Keep original text when translation is blank: Quando essa opção está habilitada, o textooriginal 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 textosatualmente 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

Page 446: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 446/725

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

InduSoft Web Studio Página 445

Translation EditorO 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 detradução a partir da opção File > Open no menu Translation Editor . Além disso, pode-se criar umnovo 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 foicriada. 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 essecomando 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 TranslationEditor 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 menudo Translation Editor para salvar as configurações no arquivo de tradução (em formato CSV).

Page 447: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 447/725

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

InduSoft Web Studio Página 446

O InduSoft Web Studio suporta arquivos de tradução em formato CSV. Assim, pode-se utilizar tantoo Translation Editor  como qualquer outro editor para arquivos CSV, como Microsoft Notepad ouMicrosoft Excel para a criação do arquivo de tradução. A primeira linha do arquivo CSV indica onome 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çãoutilizando 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 novonome. Assim, na nova planilha, você poderá manter os termos em uma coluna esubstituí-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-osdisponíveis para a utilização de um Web Thin Client.

Page 448: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 448/725

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

InduSoft Web Studio Página 447

Inserindo linhas

Caso você deseje inserir um ou mais termos entre os termos já existentes na planilha, posicione ocursor 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 emuma outra planilha. Também é possível copiar os termos de um arquivo em Excel e cola-los emuma 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 compartilhadosentre as planilhas.

  Salve suas alterações.

Pesquisando a planilha

Caso sua planilha contenha vários termos (pode-se inserir até   termos), você poderá utilizar asopçõ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

Page 449: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 449/725

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

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âmetrosopcionais de pesquisa:

*  Match whole word only: Habilite ( ) esse box para evitar que o IWS busque termosinseridos em meio a outra palavra. Por exemplo, estando essa opção desabilitada, etentar 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çãodesabilitada e tentar pesquisar por “TankLevel,” o IWS encontrará  TANKLEVEL  outanklevel .

*  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 IWSpesquisará 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 odiá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 planilhasPara salvar seu trabalho após a criação ou edição de uma planilha Translation , selecione File → Save ouFile → 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:

Page 450: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 450/725

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

InduSoft Web Studio Página 449

•  SetTranslationFile(strFileName): Especifica o arquivo da planilha Translation e traduz todos ostextos 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 suportadaspelo 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 osarquivos sejam salvos na pasta Web de seu projeto, de forma a poderem ser utilizadospor 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 nomesignificativo 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 doarquivo de tradução entre a planilha dupla.

Por exemplo, SetTranslationFile(“English.tra”)

Configurando o Arquivo de Tradução

Page 451: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 451/725

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

InduSoft Web Studio Página 450

  Nota:Caso você salve as planilhas Translation na pasta Web de seu projeto (para tornar osarquivos disponíveis para Web Thin Clients), deve-se também digitar o caminho dodiretó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ãopara abrir o diálogo Object Properties.

  Digite SetTranslationFile(“strFileName”)no campo Expression — para substituir o nome dosegundo 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 osdois 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 deRetorno

Descrição

0 Success

1 Invalid number of parameters

Clique no Botão Spanishe os Objetos de Telaserão Exibidos emEspanhol

Clique no Botão Englishe os Objetos de Telaserão Exibidos Displayem Inglês

Page 452: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 452/725

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

InduSoft Web Studio Página 451

2 Wrong parameter type

3 Translation file could not be foundor opened

Utilizando Ext(“strText”) 

Pode-se utilizar a função ext(“strText”) para traduzir strings de texto da aplicação, como osresultados 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 umnome 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 EditorPara 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á fechadoimediatamente.

•  Caso exista alterações não salvas em planilha(s) Translation aberta(s), o IWS irá requisitar quetais 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.

Page 453: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 453/725

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

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 entretarefas 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 LinkingEmbedded – Database) e ODBC (Open Database Connectivity). Utilizando-se dessa capacidade, é possívelconectar-se a qualquer banco de dados compatível a MDAC (veja  Conformance Test Table para a lista debanco 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 umbanco de dados relacional.

  Events: A aplicação pode salvar e/ou entregar mensagens de evento em um banco de dadosrelacional.

  Trends: A aplicação pode salvar e/ou entregar valores históricos de Trend em um banco dedados relacional.

  Viewer: Informações do banco de dados podem ser exibidas tanto em formato tabela ( Alarm eobjetos 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 dadosrelacional, 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 dochã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 decompatibilidade foram executados junto aos seguintes bancos de dados:

Banco deDados

Versão ADO.NET Provider Versão do Grupo

Microsoft SQL Server 2000

8.0 System.Data.SqlClient 1.0.5000.0

Microsoft  Access2000

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 

Page 454: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 454/725

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

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 GeraisEssa seção descreve banco de dados e fornecedores, além do modo como o IWS estabelece interface comdiferentes bancos de dados.

Banco de Dados Relacionais SQL

Um Banco de Dados SQL Relacional é um conjunto de informações armazenadas em tabelas comcampos 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çãoadiciona ou lê um ou mais desse registros, de acordo com a condição apresentada.

Database DB1

Table X

Register 1

Register 2Register 3

Field A Field B Field C

Table Y

Register 1

Register 2Register 3

Field D Field E Field F

Database DB1

Table X

Register 1

Register 2Register 3

Field A Field B Field C

Register 1

Register 2Register 3

Field A Field B Field C

Table Y

Register 1

Register 2Register 3

Field D Field E Field F

Register 1

Register 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 dediferentes bancos de dados através de comandos SQL. O ADO.NET Provider para um banco dedados específico pode ser suprimido por um sistema operacional ou por um fabricante de banco dedados.

  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.

Page 455: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 455/725

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

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 comoutilizar 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 seustring 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 bancode dados, o IWS permite a flexibilidade para estabelecer um link de cada tarefa a um banco dedados 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ãouniformes, apesar do banco de dados específico escolhido.

Page 456: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 456/725

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

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óricoatravés do combo-box  History Format disponível para cada tarefa. A tabela a seguir mostra asopções disponíveis para cada tarefa:

Tarefa FormatoHistórico

Configurações

Proprietary

File Format: Texto (UNICODE). O IWS utilize o caracterebarra vertical (|)para separar os campos.

Default Path: …\<AplicationPath>\Alarm\ALYYMMDD.ALH , onde: YY = dois últimos dígitos do ano

MM = Mês

DD = Dia.

Alarms

DatabaseDatabase Type: Escolhido pelo usuário

Default Table Name: AlarmHistory 

Proprietary

File Format: Texto (UNICODE). O IWS utilize o caracterebarra vertical (|) para separar os campos.

Default Path: …\<AplicatiuonPath>\Alarm\EVYYDDMM.EVT , onde: YY = Dois últimos dígitos do ano

MM = Mês

DD = Dia.

Events

Database Database Type: Escolhido pelo usuárioDefault 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 Trend001)

Page 457: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 457/725

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

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 Bancode 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 noSecundário. Caso um deles esteja indisponível, o IWS manterá os dados salvos naqueledisponível no momento. Quando o banco de dados antes indisponível tornar-se disponívelnovamente, o IWS sincroniza ambos automaticamente.

  Store and Forward: Nesse modo, o IWS salva dados somente no Banco de Dados Primário. Casoo Banco de Dados Primário tornar-se indisponível, o IWS salvará os dados no Banco de DadosSecundário. Quando o Banco de Dados Primário tornar-se ativo novamente, o IWS moverá osdados 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 deutilizá-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çãolocal 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).

Page 458: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 458/725

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

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 omesmo tipo de banco de dados (e.x. SQL Server, MS Access, Oracle, etc) é utilizado por todas astarefas 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 essascompartilharã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:

Page 459: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 459/725

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

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 emum computador remoto) via TCP/IP. O Gateway implementa a interface com o Banco de Dadosatravé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 arquivosSTADOSvr.exe e StADOSrv.ini da subpasta \BIN sub-folder do IWS e cola-los em qualquer diretóriodo 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ãodevem 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

Page 460: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 460/725

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

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 entretarefas 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. Aoselecionar o Banco de Dados como Formaro de Propriedade, as configurações da interface do banco dedados 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.

  Escolha o Banco de Dados no combo-box History Format.

  Clique no botão Event Database.

  Configure os parâmetros do banco de dados no diálogo DatabaseConfiguration.

Trend

  Crie ou abra uma planilha Trend.

  Escolha o Banco de Dados no combo-box History Format.

  Clique no botão Database Configuration.

  Configure os parâmetros do banco de dados no diálogo DatabaseConfiguration.

  Nota:

Alarms e Events são salvos em formato de propriedade do IWS, e ambos sãosalvos 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 depropriedade do IWS ou em Banco de Dados SQL Relacional externo.

Page 461: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 461/725

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

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 asconfigurações exibidas na janela Database Configuration serão aplicadas a interface do Bancode Dados Primário. Também aplicam-se a interface do banco de dados Secundário. Pode-seconfigurar 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 Bancode Dados Primário esteja indisponível por qualquer razão, os dados não serão salvos emnenhum outro local. Essa opção pode causar perda de dados, caso o Banco de Dados Primárioesteja indisponível.

Redundant: Nesse modo, o IWS salva dados tanto no Banco de Dados Primário quanto noSecundário. Caso um deles esteja indisponível, o IWS mantém os dados salvos somente nobanco 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. Casoo Banco de Dados Primário tornar-se indisponível, o IWS salva os dados no Banco de DadosSecundário. Quando o Banco de Dados Primário tornar-se disponível novamente, o IWS moveos 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 oBanco 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

Page 462: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 462/725

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

InduSoft Web Studio Página 461

Secundário na estação local para salvar dados temporariamente caso o Banco de DadosPrimá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 osparâ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. Aoinvés de registrar o Connection string manualmente, pode-se apertar o botão do browse (…) eselecionar 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çõessobre 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 dousuá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 onúmero de segundos configurados nesse campo. 

Page 463: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 463/725

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

InduSoft Web Studio Página 462

  Botão Advanced: Após apertar esse botão, você obterá acesso a algumas configuraçõescostumizáveis. Para a maioria das aplicações, o valor padrão não precisa ser modificado, e deveser mantido. 

 –   combo box  Milliseconds: Pode-se configurar como os milissegundos serão salvos aoconfigurar e salvar a data no banco de dados. Cada banco de dados salva a data emformatos 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. Aoselecionar Default, o IWS utiliza os parâmetros pré-configurados para o tipo de bancode dados atual. Caso você esteja utilizando um banco de dados que já tenha sidopreviamente testado e configurado pela InduSoft, a opção Default tentará salvar osmilissegundos em um campo separado. 

  Dica:

  A opção padrão para cada banco de dados está configurada no arquivoStudioADO.ini, armazenado na subpasta \BIN do IWS. Veja “Studio DatabaseGateway” 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 timestampscom a precisão de milissegundos, embora o banco de dados que você está utilizandonã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 nobanco de dados. Essa opção deve ser habilitada para evitar problemas horários a seremsalvos. 

 –   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ãonã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 comoconfigurar 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

Page 464: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 464/725

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

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ãosalvos. 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-sede 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/ouentrega 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 desalvar dados no banco de dados, a menos que você tenha configurado uma tabela com o nomeconfigurado 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-seapertar 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 dadoshistó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ãodisponí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 dedados não está disponível ou sua configuraçãoestá 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 deconfiguração, você deverá especificar o tag de reload. Quando desejar reconectar-se aobanco de dados utilizando os valores atualizados de seus tags, configure o tag nesse campocomo 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 GatewayO Studio Database Gateway é um server TCP/IP que interage com banco de dados utilizando-se doMicrosoft .NET Framework 1.1 e pode rodar no mesmo computador em que está rodando a aplicação do IWSou em um computador distinto. O Database Gateway Host de Advanced Settings (veja “Diálogo DiálogoDatabase 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 automaticamentepelas tarefas do IWS. Por outro lado, ao rodar o gateway remotamente, você precisará iniciar o gateway deforma manual. Para isso, copie os arquivos StADOSvr.exe e StudioADO.ini da pasta BIN do IWS para ocomputador 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 deporta padrão é 3997, e esse é modificado especificando-se o número da porta desejado no prompt decomando (e.x. StADOSvr 1111). Rodar StADOSvr, adicionará o seguinte ícone à barra de ferramentas:

Page 465: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 465/725

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

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ãodisponíveis os seguintes parâmetros:

Page 466: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 466/725

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

InduSoft Web Studio Página 465

Parâmetro Escala de Valores Descrição

SaveMSec1 - Deasabilitar 2 - Habilitar 3 - Separar Coluna 

Essa configuração especifica ocomportamento padrão para o provedor aosalvar milissegundos. O padrão pode ser alterado em Advanced Settings nos diálogos

Database Configuration Dialogs .

 Assembly Qualquer string quecontenha assembly .Net Framework 

Opção Assembly para todos os provedores,a qual possui todas as classes requisitadaspara estabelecer interface com o banco dedados. A maioria dos provedores estãodentro da assembly System.Data.

ConnectionClassQualquer classe deconexão dentro deassembly 

Connection Class é um dos implementospara a interfaceSystem.Data.IDbConnection.

DataAdapterClassQualquer adaptador de

dados dentro de assembly 

Data Adapter class é utilizaa em operaçõesonde são necessários atualizações para obanco de dados. Deve ser compatível com a 

classe de conexão especificada, e deveimplementar o IDbDataAdapter.

CommandBuilderClassQualquer classe deconstructor de commanddentreo 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, edefine 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 emdemonstrações SQL 

ColumnDelimiterSuffix Qualquer caracterer ougrupo de caracteres

Especifica um caractere que será substituído após nomes de colunas emdemonstrações SQL 

 TableDelimiterPrefix Qualquer caracterer ougrupo de caracteres

Especifica um caractere que será substituído antes de nomes detabelas emdemonstrações SQL 

 TableDelimiterSuffix Qualquer caracterer ougrupo de caracteres

Especifica um caractere que será substituído após nomes detabelas emdemonstraçõ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 (?)

Page 467: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 467/725

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

InduSoft Web Studio Página 466

  ValueStringPrefix Qualquer String

Esse valor indica um prefixo para ser utilizado antes de valores. Valores Oraclepor exemplo requisitam um prefixo. Asdemonstrações SQL utilizam identificadoresde valores utilizando-se de seus prefixos,

embora esses parâmetros em Connectionclass não utilizem o prefixo.

  ValueAddNumber 0 ou 1

Indica se um número sequencial deve ser adicionado ao ValueString para identificar oparâmetro ou não. Para Microsoft SQL database, esse parâmetro deve ter o valor 1,pois os parâmetros são identificadosutilizando-se @Value1, @Value2 …,@ValueN. Para ODBC, esse parâmetro deveser 0.

BoolType

Qualquer string

representando um tipo dedados válidos para o bancode 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 tipode dados especificado é capaz de salvar  valores Boolean.

IntegerType

Qualquer stringrepresentando um tipo dedados válidos para o bancode dados

 Ao tentar criar colunas para armazenar integer values, o tipo de valores especificadonesse parâmetro deverá ser utilizado. Deve-se certificar-se deque o tipo de valor especificado é capaz de armazenar valoresde 32 bit.

RealType

Qualquer stringrepresentando um tipo dedados válidos para o bancode dados

o tentar criar colunas para armazenar real values, o tipo de valores especificado nesseparâmetro deverá ser utilizado. Deve-secertificar-se deque o tipo de valor especificado é capaz de armazenar 64 valores reais.

StringType

Qualquer stringrepresentando um tipo de valor válido para o bancode dados

 Ao tentar criar colunas para armazenar  valors de string, o tipo de valoresespecificados nesse parâmetro será utilizado. Deve-se certificar-se de que o tipode dados especificado é capaz de salvar onúmero de caracteres que você deseja salvar em sua aplicação.

 TimeStampType

Qualquer stringrepresentando um tipo de valor válido para o bancode dados

 Ao tentar criar colunas para armazenar 

 valores TimeStamp, o datatype especificadonesse parâmetro será utilizado.

EnableTop 0 ou 1

Quando esse campo está configurado como1, ADO substituirá TOP na demonstraçãoSQL para limitar a quantidade de registrosrequisitados.

SingleConnection 0 ou 1 Quando esse campo está configurado como1, ADO tarefasou computadores que

Page 468: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 468/725

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

InduSoft Web Studio Página 467

estejam requisitando-o. A sincronizaçãoentre tarefas que serão executadas pelogateway não serão efetuadas se essa opçãoestiver habiliutada, e não serão capazes deserem executadas simultaneamente.

Uma chamada única de seção [Providers] possui todos os parâmetros. Os valores padrões estãoespecificados no início do arquivo, com a utilização do prefixo “Default” em cada parâmetro comomostrado a seguir:

[Providers]DefaultSaveMSec=3DefaultAssembly=System.Data DefaultConnectionClass=System.Data.OleDb.OleDbConnectionDefaultDataAdapterClass=System.Data.OleDb.OleDbDataAdapter DefaultCommandBuilderClass=System.Data.OleDb.OleDbCommandBuilder DefaultValueString=@ValueDefaultValueAddNumber=1DefaultBoolType=INTEGER DefaultIntegerType=INTEGER 

DefaultRealType=REAL DefaultStringType=VARCHAR(255)DefaultTimeStampType=DATETIMEDefaultSingleConnection=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 doprovedor, 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 

ColumnDelimiterPrefix2=[

ColumnDelimiterSuffix2=]

 TableDelimiterPrefix2=[

 TableDelimiterSuffix2=]

RealType2=FLOAT 

Page 469: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 469/725

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

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 

StringType4=VARCHAR(255)

 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

ColumnDelimiterPrefix5=[

ColumnDelimiterSuffix5=]

 TableDelimiterPrefix5=[

 TableDelimiterSuffix5=]

Provider6=MYSQLPROV 

 Assembly6=ByteFX.MySqlClient 

ConnectionClass6=ByteFX.Data.MySqlClient.MySqlConnection

DataAdapterClass6=ByteFX.Data.MySqlClient.MySqlDataAdapter 

CommandBuilderClass6=ByteFX.Data.MySqlClient.MySqlCommandBuilder 

Page 470: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 470/725

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

InduSoft Web Studio Página 469

 ValueString6=@Value

 ValueAddNumber6=1

StringType6=VARCHAR(128)

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 

StringType7=VARCHAR(255)

 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 oseventos de alarme ao banco de dados de históricos, de acordo com o Formato do Arquivoconfigurado em Alarm History e Events. As informações salvas no arquivo histórico estão descritasna tabela a seguir.

Nome do Campo Tipo deDados

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 IWSsalva 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 Boolean0: Indica que o alarme foi reconhecido ou nãorequer reconhecimento

1: Indica que o alarme não foi reconhecido

Al_Active Boolean0: 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

Page 471: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 471/725

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

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 Boolean0: Requisita reconhecimento (Ack)

1: Não requisita reconhecimento

Al_Norm_Time  TimeStamp

 Timestamp indicano quando o alarme foinormalizado.

Quando o Formato de Arquivo é Propriedade, o IWSsalva 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 foireconhecido.

Quando o Formato de Arquivo é Propriedade, o IWSsalva a Data (MM/DD/YYYY) em um campo e a Hora (HH:MM:SS.MSS) no próximo campo.

Al_User StringUsuáio logado quando o evento de alarme ocorreu.Esse campo existe somente para Versão >=1

Al_Comment StringComentário (opcional) digitado pelo operador quando o alarme foi reconhecido. Esse campoexiste somente para Versão >=1

Al_User_Full StringNome complete do usuário logado quando o eventode alarme ocorreu. Esse campo existe somente para  Versão >=2

Al_Station StringNome da estação (computador) onde o evento dealarme 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 etempo GMT. Esse campo existe somente para  Versão >=3

Page 472: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 472/725

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

InduSoft Web Studio Página 471

Al_Last_Update  TimeStamp

 Time Stamp quando o registro foicriado/modificado. Esse campo é utilizado para sincronizar os bancos de dados ao utilizar o Bancode Dados Secundário além do Banco de DadosPrimá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 umbanco de dados, editando o arquivo <AplicaçãoName>.APP como se segue:

[Alarm]

<DefaultName>=<NewName>

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ãodescritas 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 Timeno 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.

Page 473: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 473/725

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

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 campoexiste 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

Last_Update  TimeStamp

 Time Stamp quando o registro foi criado/modificado. Essecampo é utilizado para sincronizar os bancos de dados aoutilizar oe Banco de Dados Secundário além do Banco deDados Primário. Esse campo é criado somente quando FileFormat é 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]

<DefaultName>=<NewName>

Por exemplo:

[EventLogger]

Event_Info=Information

Message=Event_Message

Page 474: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 474/725

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

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 arquivohistó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çõesselecionadas no combo-box History Format, o IWS salva os dados históricos Trend emarquivos binários de propriedade ou em um Banco de Dados SQL Relacional. Os campossalvos no Histórico Trend são descritos na tebela a seguir:

Field Name Data Type Remarks

Time_Stamp  TimeStamp TimeStamp (Data e Hora) quando osdados foram salvos.

<Tag Name>Integer ou Real(dependendo do

tipo de tag)

O IWS will criará um campo (coluna) nobanco de dados para cada tag

configurado na planilha Trend.

Page 475: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 475/725

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

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 problemasde configuração com bancos de dados. Casso você esteja tendo problemas na interface com um banco dedados, 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 dedesenvolvimento), 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 dedados. 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çõesadicionais, 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 maisdetalhada. Por exemplo, caso sua tarefa Trend falhe para adicionar um registro no banco de

Page 476: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 476/725

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

InduSoft Web Studio Página 475

dados, por um cabo está desconectado, deve-se primeiramente esperar o recebimento de umerro na rede de trabalho; caso a tarefa tente adicionar mais registros antes do períodoespecificado 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 quesua 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 DatabaseInterface 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. OBanco 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 DatabaseGateway” para maiores informações sobre como adicionar os provedores ADO.NET para oarquivo StADOSvr.ini.

Q: Por que, ao atualizar informações em uma linha no objeto Grid , mais de uma linha estarãosendo atualizadas em meu banco de dados?

 A: O objeto grid promove um comando de atualização no banco de dados utilizando os valores detodas 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á oproblema.

Q: Por que eu preciso utilizar uma Column separada para armazenar os milissegundos em meubanco de dados?

  A: Alguns bancos de dados não suportam milissegundos no campo Time Stamp. A interfaceDatabase do IWS, por padrão, requisite outra coluna para o smilissegundos. Caso seu banco dedados 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 dedados 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 oequipamento 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ãotenha o provedor que você esteja utilizando. Tente utilizar o gateway remotamente seguindo asinstruções de “Estabelecendo Link do Banco de Dados através de um Provedor EstabelecendoLink 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 obanco 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->AdministrativeTools->Microsoft .Net Framework x.x Configuration. O provedor deverá ser listado em Assembly Cache .

Page 477: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 477/725

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

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 receboa 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 podemser 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 comum server name menor. Por exemplo, o server name especificado por 192.168.89.98, possui 13caracteres 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 de192.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 obanco 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 deteste, o teste é efetuado, mas quando eu tento rodar minha aplicação, eu recebo o seguinteerro: Database: Error: Parse error: DSN 'MyDatabase' does not exist. O que estou fazendo deerrado?

 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 createconnection class [iAnywhere.Data.AsaClient.AsaConnection]?

  A: Você não possui o Provedor ADO.NET instalado em seu computador. O programa deconfiguração do banco de dados tem uma opção para instalação do Provedor. Rode novamenteo programa de configuração e certifique-se de que você verificou que aquela opção esteja habilitada.

Page 478: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 478/725

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

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.

Page 479: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 479/725

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

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 driversODBC 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ãocom um ODBC DSN. O string de conexão pode ser construído automaticamente clicando-se no botão doBrowse (…). Quando aparecer a janela Data Link, você deverá selecionar a opção Microsoft OLE DB Providerfor ODBC Drivers como mostrado abaixo: 

Clicar no botão Next fará aparecer a seguinte janela:

Page 480: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 480/725

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

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 dousuário e a senha nessa janela, ao invés de espcificar no diálogo Database Configuration, lembre-se dehabilitar 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 dedados Microsoft SQL Server relacionais. Você deverá seguir os passos abaixo para configurar o banco dedados SQL Server:

1.  Clique no botão Browse na janela  Database Configuration Dialog . A janela a seguir será exibida:

Page 481: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 481/725

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

InduSoft Web Studio Página 480

2.  Selecione o Provedor Microsoft OLE para SQL Server, e clique em Next. A seguinte janela será exibida:

Page 482: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 482/725

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

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 dadosORACLE:

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á:

Page 483: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 483/725

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

InduSoft Web Studio Página 482

3.  Preencha os campos nessa janela com as informações de seu banco de dados. Lembre-se dehabilitar 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 thanmaximum (16), onde 19 é o número de letras em Server Name. Leia “ResolvendoProblemas do Banco de Dados” para maiores soluções para contornar esseproblema.

4.  Clique em OK para finalizar a configuração Connection String.

  Nota: Tais procedimentos foram testados utilizando-se ORACLE 10g Release 1.

Page 484: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 484/725

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

InduSoft Web Studio Página 483

Apêndice do Banco de Dados D: Utilizando Banco de Dados de Acesso daMicrosoft

 A interface do Banco de Dados do IWS permite a entrega e armazenamento de informações em arquivosMicrosoft 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á:

Page 485: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 485/725

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

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 grandesquantidades 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 deforma muito lenta, e você poderá não obter os resultados esperados. Caso vocênecessite armazenar uma grande quantidade de dados, recomendamos a utilizaçãode formato de prioridade ou um banco de dados relacional potente, como Microsoft SQL Server ou ORACLE. Microsoft Access é recomendado como sendo um Banco deDados 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 WindowsCE. 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>

Page 486: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 486/725

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

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 grandesquantidades de dados de forma eficiente. Portanto, caso você tente armazenar todosseus dados históricos nesse tipo de banco de dados, a tarefa poderá funcionar deforma muito lenta, e você poderá não obter os resultados esperados. Caso vocênecessite armazenar grandes quantidades de dados, recomendamos a utilização deformato de propriedade ou um banco de dados relacional potente, como Microsoft SQL Server ou ORACLE. SQL Server CE é recomendado como um Banco de DadosSecundá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 executadoscom a utilização da Arquitetura explicada no tópico “ Estabelecendo Link de Banco de Dados através de umRemote 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) demodo a comunicar-se com o banco de dados. Caso DSN não seja criado, o seguinte erro será exibido emLogWin 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 quese segue:

Provider=ASAProv.90; DBF=C:\ Test.db

  Note:  Tais procedimentos foram testados com a utilização de Sybase Server Anywhere9.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. Oprincipal objetivo do uso de banco de dados em Excel é em virtude do objeto Grid . Os passos abaixomostram 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.

Page 487: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 487/725

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

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á:

Page 488: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 488/725

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

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 .

Page 489: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 489/725

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

InduSoft Web Studio Página 488

  Nota:O valor nesse campo deverá ser alterado caso seja utilizada uma versão distinta doExcel.

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="Excel8.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 arquivoem Excel:

Provider=Microsoft.Jet.OLEDB.4.0; Data Source=C:\{TagExcelFile}.xls; ExtendedProperties="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:

Page 490: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 490/725

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

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 doMicrosoft 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 emque 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.

Page 491: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 491/725

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

InduSoft Web Studio Página 490

  A conexão ByteFX.MySqlClient utiliza diferentes palavras-chave para Data Source e para osparâmetros Location no string de conexão. O exemplo acima é passado para a classe de conexão noseguinte formato:

Database=MyDatabaseName; Data Source=192.168.23.200

  Nota:  Tais procedimentos foram testados com a utilização de MySQL v4.0.20a eByteFX.MySqlClient v0.76.

Page 492: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 492/725

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

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 interfacegrá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 dadosde 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 deflexibilidade, 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 necessidadede 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 aoservidor depende das configurações da licença instalada no servidor. O usuário nãoprecisa 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émalterar 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 interfacesgrá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 edados históricos Trend).

Page 493: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 493/725

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

InduSoft Web Studio Página 492

Camada de Controle ISSymbolISSymbol é um componente projetado pela InduSoft que capacita a exibição de telas criadas com o o IWS nobrowser da web, além de trocar dados (valores de tags e dados históricos) com o módulo TCP/IP server doIWS. Na Web Thin Client station, o browser da web (ex. Internet Explorer) é o local que acolhe o controleISSymbol.

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 altoní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 registrodo 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. Obrowser da web não é capaz de exibir telas a partir da aplicação do IWS, caso o controle ISSymbol nãoesteja registrado de forma apropriada na Web Thin Client station.

  Atenção:Certifique-se de que seu browser da web esteja habilitado a efetuar downloadpreenchidos nos controles ActiveX, de modo a efetuar o download do ISSymbol

automaticamente. Caso contrário, você precisará registrar o ISSymbolmanualmente na Web Thin Client station. Verifique a documentação de seubrowser 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 arquivosestejam 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 Studiov6.1 e cole-os em qualquer diretório da Web Thin Client station. Certifique-se de que ambos osarquivos 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 UNICODEnã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>\<ProcessorType>\ 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”)

Page 494: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 494/725

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

InduSoft Web Studio Página 493

Salve as configurações de registro para manter  ISSymbolCE.ocx registrados ao reiniciar oequipamento Windows CE.

•   Windows CE PocketPC:

Copie os arquivos RegSvrCE.exe,  ISSymbolCE.ocx e ndHTTP.dll da subpasta  \Redist\<OSVersion>\<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 mesmodiretó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 oseguinte 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ãoencontrá-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 webserá 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 coma 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 dadosinseridos estão encriptados e enviados para o servidor. A server station verifica a validade dosdados e os direitos para abrir a tela de startup. Caso seja possível, o processo continuará. Casocontrário, você será questionado com uma mensagem de erro indicando que User Name e/ouPassword 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 pelousuá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çãonas telas abertas no servidor, o novo valor é enviado para a Web Thin Client (e vice-versa).

Page 495: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 495/725

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

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 protocoloHTTP 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 IWSfornece 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 WebOs 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, oservidor 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\<WinCEversion>\<Processor Type> do IWS após a instalação. O diretório home (webroot) para os servidores da web fornecidos pela InduSoft é o mesmo de ondeeles são executados. Portanto, a InduSoft recomenda a efetuação de cópiasdesses para a subpasta \Web de sua aplicação antes de rodá-los.

NTWebServer e CEWebServer foram projetados primariamente para estessimples e/ou demos. A InduSoft recomenda a utilização de Web Serverscomerciais 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 doIWS 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 stationsdevem estar salvas como HTML. Para isso, abra a tela no ambiente de desenvolvimento eexecute o comando FileSave as HTML a partir do menu. Utilize a opção do menu FileSaveScreen Group as HTML para salvar grupos de tela (*.sg) como HTML e torná-las disponíveispara 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 (FileSave).

 Dica:Caso você deseje tornar todas as suas telas da aplicação disponíveis para Web Thin Client stations, execute FileSave All como opção de menu HTML.

Page 496: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 496/725

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

InduSoft Web Studio Página 495

  Atenção: Após alterar qualquer configuração na janela de diálogo Project Settings e/ou emTags Database, deve-se executar o comando ToolsVerify 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 rodandono servidor de dados. O módulo TCP/IP Server está embutido no IWS, e é automaticamenteexecutado 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 executadoautomaticamente quando a aplicação for iniciada, utilizando o diálogo ProjectStatusExecution 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ípicasEssa 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. webserver 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 arquivosda 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 IWSdeve estar armazenada nesse computador.

Essa seção não descreve todas as arquiteturas possíveis, embora forneça os conceitos necessáriospara 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

(Ethernet, Internet, Dial-UP)

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 emum 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 detrabalho, 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

Page 497: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 497/725

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

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ãodiretamente conectados a mesma rede de trabalho intranet ou via uma conexão dial-up. Caso o servidor esteja conectado a internet, deve-seestabelecer um endereço IP Fix ao servidor na internet, e a aplicação deverá estar rodando nesse computador. Consulte seu Provedor ISP para maioresinformações sobre como obter um endereço Fix IP para seu computador servidor na internet.

Page 498: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 498/725

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

InduSoft Web Studio Página 497

Arquitetura 2: Web server e Web Thin Client sem uma mesma rede de trabalho; webserver e data server em estações diferentes

Web Server Station

TCP/IP

(Ethernet, Internet, Dial-UP)

Web Thin Client

Files from the \Webapplication 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 nacompanhia. Algumas companhias utilizam um computador como web server padrão para todasas 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) eapenas 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 emum 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 webserver station. A Aplicação (e o IWS) mantém-se rodando em outro computador fisicamenteconectado a internet.

•  Habilita a utilização de um web server baseado em Linux (ex. Apache). Não será necessárioinstalar 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 Clientstation. 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 desegurança.

  Nota:Não é necessário que o IWS seja instalado na web server station. Oscomponentes a seguir devem estar disponíveis na web server station:

*   Web server (ex. IIS da Microsoft)

*  Arquivos da subpasta \Web da Aplicação 

Page 499: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 499/725

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

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 detrabalho, o Web Thin Client poderá acessar as server stations diretamente, através de seusendereços IP (ou host names).

Exemplo de Configuração:

Esse exemplo é baseado nas seguintes premissas:

•  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 

Page 500: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 500/725

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

InduSoft Web Studio Página 499

Arquitetura 3: Servidores Redundantes e Web Thin Client stations na mesma rede detrabalho

Server Station #1

TCP/IP

(Ethernet, Internet, Dial-UP)

Web Thin Client

Server Station #2

Studio Runtime + ApplicationData Server (TCP/IP Server)Web Server (HTTP Server)

Studio Runtime + ApplicationData Server (TCP/IP Server)Web Server (HTTP Server)

 

Essa Arquitetura é similar a Arquitetura 1, embora nessa arquitetura duas server stations com osmesmos arquivos rodem a mesma aplicação em redundância. O Web Thin Client conecta-se aoservidor 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. 

Page 501: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 501/725

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

InduSoft Web Studio Página 500

Interface Project Settings Web 

Diálogo Advanced

Page 502: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 502/725

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

InduSoft Web Studio Página 501

Arquitetura 4: Web server e Web Thin Clients em redes de trabalhos diferentes

Web Server StationWeb Thin Client

TCP/IP

(Intranet)

Data Server Station

Files from the \Webapplication 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 umendereç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 roteamentopara a solução desse problema.

O WTG deverá estar instalado no computador com o Endereço Fix IP na internet (consulte seuprovedor 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.

Exemplo de Configuração: 

Esse exemplo é baseado nas seguintes premissas:

•  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 

Page 503: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 503/725

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

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:

Interface Project Settings Web 

Page 504: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 504/725

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

InduSoft Web Studio Página 503

Janela de Diálogo Advanced

  Nota:Caso seu web server seja capaz de fornecer arquivos via HTTPS (SSL – SecureSocket 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.

Page 505: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 505/725

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

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 algunsfatores 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 procedimentopara 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écnicoExistem 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 Public dase 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 funcionalidadegeneralizada 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 novoarquivo e seu original para encontrar e eliminar as diferenças entre eles. Tal attitude auxiliará na resoluçãodo 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 ouno 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 oproblema 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 omais 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 detrabalho

•  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)

Page 506: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 506/725

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

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 quantasmá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 umerro 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 deservicos, 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 oproduto, essa publicação contém informações sobre as funções básicas do InduSoft WebStudio. Tal publicação é fornecida na pasta  Documentation no CD-ROM do IWS ou no menuHelp 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 quedizem respeito ao ambiente de desenvolvimento do IWS, além de fornecer instruções detalhadaspara a utilização do produto. Tal publicação é fornecida na pasta Documentation no CD-ROM doIWS ou no menu Help da barra de menu principal.

•  Drivers User Guides : Explica como configurar os drivers individuais do InduSoft, de acordo comas características de seus próprios protocolos. Um guia do usuário personalizado está incluídoa 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 menuprincipal.

 Visite o site da InduSoft  na Web: www.InduSoft.com.

Verificando sua AplicaçãoDa barra de menu, selecione Tools → Verify Application para recompilar planilhas Math, lógicas de tela eatualizar arquivos HTML atuais utilizando as configurações no tabWeb  (diálogo Project Settings ). Tags nobanco de dados são remapeados para todas as planilhas e telas.

Page 507: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 507/725

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

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 etelas 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 dedados atual. Ao executar a aplicação, o IWS compara a tela ou planilha com o banco dedados da aplicação atual e caso não exista coincidência (mismatch), o IWS recompila asexpressõ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 ComunsListados 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 PCBased 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 tagsconfigurados na aplicação. Cada posição de array e cada membro de classe dos tags configurados no tagdatabase do IWS são contados.

Page 508: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 508/725

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

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:\ProgramFiles\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 deferramentas Active Objects.

Selecione o objeto  ActiveX a ser inserido na aplicação a partir do list box, e aperte o botão OK. Oobjeto 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). Odinâmico properties e a lista methods podem ser visualizados seleiconando o botão Methods. Aspropriedaes estáticas podem ser configuradas pelo botão Properties (uma descrição detalhada daspropriedades do objeto podem ser encontradas na documentação do componente, fornecida pelodesenvolvedor 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 doobjeto, 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á nodiá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 doIWS. Selecione a opção de menu Tools→ Register Controls, aperte o botãoRegister… e selecione o arquivo ActiveX (geralmente um arquivo OCX) que deverá ser registrado.

Page 509: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 509/725

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

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, edigite 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 arquivoda 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 bitmapno 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-seutilizar a função HST2TXT em uma planilha Math para converter arquivos binários para formato texto deforma 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 seucampo 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 configurea função ShutDown() na última linha dessa planilha Math .

Page 510: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 510/725

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

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 alarmesempre 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 PLCe 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 oruntime:

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\StudioManager.exe+Asc2Str(34)+” “+Asc2Str(34)+ “C:\Program Files\InduSoft WebStudio\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çõesStartTask(<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).

Page 511: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 511/725

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

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 deComm.

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 Studioutilizando 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 osserviços Network DDE e Network DDE DSDM esteja iniciados. (Utilize o atalhoServices 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.xv3.xandv4.1

v4.2 orhigher

v3.x V4.x V5.x

  Windows XP Any 

 Windows2000

 Any             

 Windows NT  V4.0+SP4or higher 

           

  Windows ME Any             

  Windows 98 Any             

  Windows 95 Any             

Page 512: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 512/725

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

InduSoft Web Studio Página 511

Sistema Operacional Studio CEView

Nome Versão v2.xv3.xandv4.1

v4.2 orhigher

v3.x V4.x V5.x

 V2.12             Windows CE  V3.x             

 V4.0

 V4.1  WindowsCE.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\WindowsNT\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) eSeparator=<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:ocê 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.

Page 513: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 513/725

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

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íveispara 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 configureo 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 formatoHTML (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, essecomponente é baixado e registrado automaticamente. Do contrário, é necessáriocopiá-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.

Page 514: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 514/725

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

InduSoft Web Studio Página 513

•  Como enviar um email da aplicação do IWS?

Siga o procedimento abaixo:

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 emaildeva 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 arquivosanexados

•  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álogoProject 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álogoProject 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 é automaticamentebaixado 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 ThinClient (Browser). Os tags configurados como Local possuem valores independentes no Server e Web ThinClient (Browser).

Page 515: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 515/725

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

InduSoft Web Studio Página 514

  Atenção:É necessário executar o programa  Tools → Verify Application após modificar asconfigurações dos tags. Do contrário, as alterações não serão atualizadas emarquivos 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 doobjeto 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ãoserão entregues a partir dele da maneira adequada pelo objeto Trend. Caso você precise adicionar ouremover tags de arquivos históricos, existem dois procedimentos válidos: Criar uma nova planilha Trend oudeletar 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. Essearquivo 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:dicione 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) noscampos Expression (mantenha os campos Tag Name em branco). Esses tags serãoadicionados ao arquivo <ScreenName>.TAGL e estarão disponíveis para comunicação TCP/IP com a Server station.

Page 516: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 516/725

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

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 recursosbaseados 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?

Siga o procedimento abaixo:

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 doControl 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.

Page 517: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 517/725

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

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       

Page 518: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 518/725

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

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 ClientAsc2Str() 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       

Page 519: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 519/725

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

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çõesTrigonomé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 FechandoFunções do Windows

Execução NT/2K/XP Win CE Web Client

CloIf()  Assíncrona       

Page 520: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 520/725

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

InduSoft Web Studio Página 519

Open()  Assíncrona       OpenPrevious()  Assíncrona       

Page 521: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 521/725

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

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

Execução NT/2K/XP Win CE Web Client

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       

Page 522: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 522/725

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

InduSoft Web Studio Página 521

Funções do MóduloActivity

Execução NT/2K/XP Win CE Web Client

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       

Page 523: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 523/725

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

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       

Page 524: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 524/725

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

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 DatabaseAccess

Execução NT/2K/XP Win CE Web Client

ForceTagChange  NA       

Funções ODBC Execução NT/2K/XP Win CE Web Client

Page 525: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 525/725

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

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       

Page 526: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 526/725

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

InduSoft Web Studio Página 525

Funções Email Execução NT/2K/XP Win CE WebClient

CNFEmail() Síncrona       GetStatussendEmailExt() Síncrona       SendEmail() Síncrona       SendEmailExt()  Assíncrona       

Funções Dial-Up Execução NT/2K/XP Win CE WebClient

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       

Page 527: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 527/725

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

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       

Page 528: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 528/725

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

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 destrTag). Pode-se também substituir números estáticos por tags numéricos (por exemplo, insira 45.6543 ao invés de numTag).

Page 529: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 529/725

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

InduSoft Web Studio Página 528

Funções Log MessageEssa 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 emLogWin

•  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âmetrostrOutputMessage. Por exemplo,

Trace(“The tag second has the value”+second+” and the Internal Clock =“+GetTickCount( ))

Page 530: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 530/725

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

InduSoft Web Studio Página 529

Funções AritiméticasEssa 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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

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: 

Nomedo Tag

Expressão

  Tag ABS(“-54.9788”) // Valor de retorno = 54.9788

  Tag ABS(numValue) // Valor de retorno = valor absoluto do número no tagnumValue.

Page 531: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 531/725

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

InduSoft Web Studio Página 530

Div(numNumerator, numDenominator)

Grupo Aritimética 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Divide o valor em numNumerator pelo valor de numDenominator e retorna somenteo 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:

Nome do Tag Expressão

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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Modifica o formato de um valor numérico, de acordo com o flag. 

Page 532: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 532/725

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

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 onúmero mínimo de caracteres de retorna pela função, adicionando espaços embranco à 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 decaracteres decimais para valores de retorno flutuantes retornadospela 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:

Nome do Tag Expressão

  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”

Page 533: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 533/725

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

InduSoft Web Studio Página 532

Nome do Tag Expressão

  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("%06.1f",12.34) // valor de retorno = “0012.3”

  Tag Format("%6.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”

Page 534: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 534/725

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

InduSoft Web Studio Página 533

Nome do Tag Expressão

  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”

  Tag Format("%h",60) // valor de retorno = “00:01:00”

  Tag Format("%h",90) // valor de retorno = “00:01:30”

  Tag Format("%h",3600) // valor de retorno = “01:00:00”

  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çãopara converter o número de segundos no seguinte formato:

hh:mm:ss(strFlag =%h)

Os parâmetros h e m são opcionais.

Page 535: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 535/725

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

InduSoft Web Studio Página 534

GetBit(tagName, numBitNumber)

Grupo Aritimética 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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: 

Nome do Tag Expressão

  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 taginteger.

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).

Page 536: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 536/725

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

InduSoft Web Studio Página 535

Mod(numNumerator, numDenominator)

Grupo Aritimética 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Retorna o resultado de numBase para numExponent. 

Page 537: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 537/725

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

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:

Nome do Tag Expressão

  Tag Pow(2, 3) // Valor de retorno = 8

  Tag Pow(10,4) // Valor de retorno = 10000

ResetBit(“tagName”, numBitNumber)

Grupo Aritimética 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag ResetBit(“numSource”, 4) //Caso o tagnumSource contenha o valor 16, essa função deverá retornar o valor 0 e numSource deverá suportar o valor 0.

Page 538: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 538/725

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

InduSoft Web Studio Página 537

  Tag ResetBit(“numSource”,1) //Caso o tagnumSource 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âmetrotagName) 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 taginteger. Por exemplo, insira Second->b0 para acessar LSB (Least Significant Bit doSegundo tag), e Second->b31 para acessar MSB (Most Significant Bit do Segundotag).

Round(numValue)

Grupo Aritimética 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag Round(“345.87”) // Valor de retorno = 346

  Tag Round(“65.323”) // Valor de retorno = 65

SetBit(“tagName”, numBitNumber)

Grupo Aritimética 

Execução Síncrona 

Page 539: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 539/725

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

InduSoft Web Studio Página 538

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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)

•  Valores de Retorno:

0 Sem Erro

1 Parâmetro inválido

2 Tag não existe

•  Exemplos:

Nome do Tag Expressão

  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âmetrotagName) 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 deum 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 doSegundo tag).

SQRT(numValue)

Grupo Aritimética 

Page 540: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 540/725

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

InduSoft Web Studio Página 539

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client 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 sereminvertidos.

•  Valores de Retorno: Retorna o valor numérico após inverter os bytes. 

•  Exemplos:

Page 541: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 541/725

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

InduSoft Web Studio Página 540

Nome do Tag Expressão

  Tag Swap16(16) // 16 = 0000000000010000 em Binário. Valor de retorno = 4096 = 0001000000000000 em Binário.

  Tag Swap16(43760) // 43760 = 1010010111110000 em Binário. Valor de retorno = 61610 = 1111000010100101 em Binário.

Swap32(numValue)

Grupo Aritimética 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Suportado

•  Descrição: Inverte duas palavras em um tag.

•  Parâmetros:

numValue Tag Integer que suporta o valor numérico de palavras a sereminvertidas.

•  Valores de Retorno: Retorna o valor numérico após inverter as palavras.

•  Exemplos:

Nome do Tag Expressão

  Tag Swap32(16) // 16 = 00000000000000000000000000010000 emBinário. Valor de retorno = 1048576 = 00000000000100000000000000000000em Binário.

  Tag Swap32(246333120) // 286333120 =1010101010101010101111111100000000 em Binário. Valor deretorno = -1094709586= 11111111000000001010101010101010 emBinário.

Trunc(numValue)

Grupo Aritimética 

Execução Síncrona 

Windows NT/2K/XP Suportado

Page 542: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 542/725

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

InduSoft Web Studio Página 541

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag Trunc(234.987) // Valor de retorno = 234

  Tag Trunc(-3465.9) // Valor de retorno = -3465.9

Page 543: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 543/725

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

InduSoft Web Studio Página 542

Funções EstatísticasEssa 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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 dosquais tirar as médias.

numSample Tag Integer contendo o número de elementos array a seremtirados a média.

optnumIgnore Tag Integer ou Real opcional contendo o valor a ser ignorado nocálculo da média.

•  Valores de Retorno: Retorna a média dos valores.

•  Exemplos:

Nome do Tag Expressão

  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 andtagArray[3]=60, o Valor de retorno = 30

Page 544: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 544/725

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

InduSoft Web Studio Página 543

Nome do Tag Expressão

  Tag Avg(“tagArray[1]”,3,10) // Se tagArray[1]=10, tagArray[2]=20 andtagArray[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 osformatosAvg(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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 seremanalisados.

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:

Nome do Tag Expressão

  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

Page 545: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 545/725

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

InduSoft Web Studio Página 544

  Tag Max(“tagArray[1]”,3) // Se tagArray[1]=10, tagArray[2]=20 andtagArray[3]=60, o Valor de retorno = 60

  Tag Max(“tagArray[1]”,3,10) // Se tagArray[1]=10, tagArray[2]=20 andtagArray[3]=60, o Valor de retorno = 60

  Nota:Essa função possui dois formatos:

•  Caso o primeiro parâmetro seja um Tag numérico ou valor, você deverá utilizar osformatosMax(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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

  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 seremanalisados.

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:

Nomedo Tag

Expressão

  Tag Min(1,2.34,5,7,4,8,9.4) // Valor de retorno = 1

Page 546: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 546/725

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

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 etagArray[3]=60, o Valor de retorno = 20

  Nota:Essa função possui dois formatos:

Caso o primeiro parâmetro seja um Tag numérico ou valor, você deverá utilizar osformatosMin(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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Suportado

•  Descrição: Gera um número randomizado entre 0 e 1.

•  Valores de Retorno: Retorna um número real entre 0 e 1.

•  Exemplos:

Nome do Tag Expressão

  Tag Rand() // Valor de retorno = ?, Onde: 0<?<1

Page 547: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 547/725

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

InduSoft Web Studio Página 546

Funções LogarítimicasEssa seção descreve as seguintes funções Logarítimicas do InduSoft Web Studio:

•  Exp(numValue)

  Log(numValue)•  Log10(numValue)

Exp(numValue)

Grupo Logarítimico

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag Exp(1)// Valor de retorno = 2.718282

  Tag Exp(5.25896) // Valor de retorno = 192.281415

Log(numValue)

Grupo Logarítimico

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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).

Page 548: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 548/725

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

InduSoft Web Studio Página 547

•  Exemplos:

Nome do Tag Expressão

  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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  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 econfigurará a qualidade do tag de retorno para BAD.

Page 549: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 549/725

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

InduSoft Web Studio Página 548

Funções LógicasEssa 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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno:

0 Caso tag ou Expressão não seja logicamente falsa.

1 Caso tag ou Expressão seja logicamente falsa.

•  Exemplos:

Nome do Tag Expressão

  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.

Page 550: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 550/725

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

InduSoft Web Studio Página 549

If(numExpression, numThen, optnumElse)

Grupo Lógico

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição:  Determina se os conteúdos de numExpression são logicamente verdadeiros, eretorna 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.

•  Valores de Retorno:

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:

Nome do Tag Expressão

  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).

Page 551: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 551/725

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

InduSoft Web Studio Página 550

True(numExpression)

Grupo Lógico

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno:

0 Caso tag ou Expressão não seja logicamente verdadeira.

1 Caso tag ou Expressão seja logicamente verdadeira.

•  Exemplos:

Nome do Tag Expressão

  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.

Page 552: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 552/725

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

InduSoft Web Studio Página 551

Funções StringEssa 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)

Page 553: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 553/725

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

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 a2 34 " 66 B 98 b3 35 # 67 C 99 c4 36 $ 68 D 100 d5 37 % 69 E 101 e6 38 & 70 F 102 f 7 39 ' 71 G 103 g8 ** 40 ( 72 H 104 h9 ** 41 ) 73 I 105 i10 ** 42 * 74 J 106 j

11 43 + 75 K 107 k12 44 , 76 L 108 l13 ** 45 - 77 M 109 m14 46 . 78 N 110 n15 47 / 79 O 111 o16 48 0 80 P 112 p17 49 1 81 Q 113 q18 50 2 82 R 114 r 19 51 3 83 S 115 s20 52 4 84 T 116 t21 53 5 85 U 117 u

22 54 6 86 V 118 v23 55 7 87 W 119 w24 56 8 88 X 120 x25 57 9 89 Y 121 y26 58 : 90 Z 122 z27 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 â

Page 554: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 554/725

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

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 caracterescarriage 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

Execução Síncrona 

Windows NT/2K/XP Suportado

Page 555: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 555/725

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

InduSoft Web Studio Página 554

Windows CE Suportado

Web Thin Client Suportado

•  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 convertidopara um caractere ASCII.

•  Valores de Retorno:  Retorna uma string de caracteres ASCII correspondentes aos valoresdecimais inseridos.

•  Exemplos:

Nome do Tag Expressão

  Tag Asc2Str(67) // Valor de retorno = C

  Tag Asc2Str(83, 116, 117, 100, 105, 111) // Valor de retorno = IWS

CharToValue(“tagName”, “tagArray”)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

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.

Page 556: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 556/725

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

InduSoft Web Studio Página 555

  Nota:Não é possível utilizar essa função para caracteres UNICODE, pois converte somenteo menor byte de caracteres UNICODE.

CharToValueW(“tagName”, “tagArray”)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Converte uma string para uma array de valores inteiros (utilizando palavras ao invésde 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:

Nomedo 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) eassim por diante.

  Nota:Essa função pode ser útil ao converter caracteres UNICODE para códigos.

ClassMembersToStrVector (“strClassTag”, numStartPos, numNumPos, “strArrayTag”,

optBooStartPosTarget)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Page 557: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 557/725

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

InduSoft Web Studio Página 556

Web Thin Client Suportado

•  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 destrClassTag.

strArrayTag  Valor da string contendo o tag array que receberá os valores destrClassTag.

optBooStartPosTarg

et

Posição inicial (índice array) de strArrayTag. Se omitido, o valor padrão será 1.

•  Valores de Retorno:

-6 Tamanho da Array de strClassTag não é grande osuficiente 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:

Nomedo 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

Page 558: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 558/725

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

InduSoft Web Studio Página 557

da array strArrayTag seja grande o suficiente para receber todos os valores destrClassTag.

NCopy(strSource, numStartChar, numQtdChar)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 primeirocaractere 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:

Nome do Tag Expressão

  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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Page 559: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 559/725

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

InduSoft Web Studio Página 558

Web Thin Client Suportado

•  Descrição: Converte uma string para real.

•  Parâmetros:

StrValue Tag String contendo o número de caracteres a seremconvertidos para formato real.

•  Valores de Retorno: Retorna o número (formalmente em um formato string) em formato real.

•  Exemplos:

Nome do Tag Expressão

  Tag Num(“321654.987”) // Valor de retorno = 321654.987

  Tag Num(“5.6589626246”) // Valor de retorno = 5.6589626246

  Nota: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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:Nome do Tag Expressão

  Tag Str(321654.987) // Valor de retorno = “321654.987”

  Tag Str(5.65896246) // Valor de retorno = “5.658962”

Page 560: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 560/725

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

InduSoft Web Studio Página 559

Str2Asc(strChar)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag Str2Asc(“C”) // Valor de retorno = 67

  Tag Str2Asc(“o”) // Valor de retorno = 111

StrGetElement(strSource, strDelimiter, numElementNumber)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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. Oprimeiro elemento possui o número 1. O Segundo possui onúmero 2, e assim por diante.

•  Valores de Retorno: Retorna o elemento (Valor da string) entregue a partir de strSource.

Page 561: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 561/725

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

InduSoft Web Studio Página 560

•  Exemplos:

Nome do Tag Expressão

  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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Determina o comprimento da string. 

Page 562: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 562/725

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

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:Nome do Tag Expressão

  Tag StrLen(“IWS Tag database6.1”) // Valor de retorno = 18

  Tag StrLen(“Technical Reference Manual”) // Valor de retorno = 26

StrLower(strSource)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag StrLower(“IWS Tag database6.1”) // Valor de retorno = “IWS Tagdatabase6.1”

  Tag StrLower(“Technical Reference Manual”) // Valor de retorno =“technical reference manual”

StrRChr(strSource, strChrSequence)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Page 563: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 563/725

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

InduSoft Web Studio Página 562

Windows CE Suportado

Web Thin Client Suportado

•  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 umcaractere junto a uma string source.

•  Exemplos:

Nome do Tag Expressão

  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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag StrRight(“IWS Tag database6.1”, 8) // Valor de retorno = “sion 5.1”

  Tag StrRight(“Technical Reference Manual”, 9) // Valor de retorno = “ceManual”

Page 564: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 564/725

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

InduSoft Web Studio Página 563

StrSetElement(strSource, strDelimiter, numElementNumber, strValue)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Obtém um elemento específico de uma string source.

•  Parâmetros:

strSource Tag String contendo a string source.

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. OSegundo possui o número 2, e assim por diante.

strValue  Valor da string que será registrada a numElementNumber dotag string strSource.

•  Valores de Retorno: Retorna o valor da string atualizada a partir de strValue.

•  Exemplos:

Nome do Tag Expressão

  Tag StrSetElement(StringTag,“|”, 2, “abcd”)

  Tag StrSetElement(StringTag,“,”, 3, “defg”)

StrStr(strSource, strCharSequence)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Isola a primeira ocorrência 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.

Page 565: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 565/725

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

InduSoft Web Studio Página 564

•  Valores de Retorno: Retorna a string de caracteres seguidos da primeira ocorrência de umcaractere junto a uma string source.

•  Exemplos:

Nome do Tag Expressão

  Tag StrStr(“IWS Tag database6.1”, “i”) // Valor de retorno = “io Version5.1”

  Tag StrStr(“Technical Reference Manual”, “a”) // Valor de retorno =”al Reference Manual”

StrStrPos(strSource, strCharSequence)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Encontra a primeira ocorrência de um caractere 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 um inteiro correspondente a primeira ocorrência de um caractere junto a uma string source.

•  Exemplos:

Nome do Tag Expressão

  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

Page 566: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 566/725

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

InduSoft Web Studio Página 565

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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çoespecificados.

•  Exemplos:

Nome do Tag Expressão

  Tag StrTrim(“IWS Tag database6.1 “) // Valor de retorno = “IWS Tagdatabase6.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 Tagdatabase6.1 “

  Tag StrTrim(“IWS Tag database6.1 “, 2) // Valor de retorno = “IWS Tagdatabase6.1“

StrTrimAll(strReference, strOptTrimChar)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Elimina um caractere específico de uma string inteira. 

Page 567: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 567/725

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

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 removidospor uma função.

•  Exemplos:

Nome do Tag Expressão

  Tag StrTrimAll(“IWS Tag database6.1 “,””) // Valor de retorno = “IWS Tagdatabase6.1“

  Tag StrTrimAll(“IWS Tag database6.1 “,” “.””) // Valor de retorno = “IWS Tagdatabase6.1“

StrUpper(strSource)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag StrUpper(“IWS Tag database6.1”) // Valor de retorno = “IWS Tagdatabase6.1”

  Tag StrUpper(“Technical Reference Manual”) // Valor de retorno =“TECHNICAL REFERENCE MANUAL”

Page 568: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 568/725

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

InduSoft Web Studio Página 567

ValueToChar(“tagArray”, numChars)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 seremconvertidos.

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:

Nome do Tag Expressão

  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 convertesomente os bytes de caracteres UNICODE.

ValueWToChar(“tagArray”, numChars)

Grupo String

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Converte uma string para um array de valores inteiros (utilizando palavras).

Page 569: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 569/725

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

InduSoft Web Studio Página 568

•  Parâmetros:

“tagArray” Nome do tag array contendo valores interios de caracteres a seremconvertidos.

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:

Nome do Tag Expressão

  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.

Page 570: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 570/725

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

InduSoft Web Studio Página 569

Funções Data e HoraEssa 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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Calcula a data, baseando-se em quantos segundos se passaram desde as 19:00:00EST 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:

Nome do Tag Expressão

  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 dehora central. Valor de retorno = 04/15/2002

  Nota:Essa função faz a contagem na Zona de Tempo especificada no Control Panel docomputador local.

Page 571: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 571/725

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

InduSoft Web Studio Página 570

ClockGetDayOfTheWeek(numSeconds)

Grupo Data e Hora 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Calcula o dia da semana, baseando-se em quantos segundos se passaram desde as19: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 as19: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:

Nome do Tag Expressão

  Tag ClockGetDayOftheWeek(0)// Caso o computador esteja na zona detempo Central. Valor de retorno = 3

  Tag ClockGetDate(1018886359) // Caso o computador esteja na zona detempo Central. Valor de retorno = 1

  Nota:

Essa função faz a contagem na Zona de Tempo especificada no Control Panel docomputador local.

Page 572: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 572/725

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

InduSoft Web Studio Página 571

ClockGetTime(numSeconds)

Grupo Data e Hora 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Calcula a hora, baseando-se em quantos segundos se passaram desde as 19:00:00EST 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 as19:00:00 ETS 12/31/1969.

•  Valores de Retorno: Retorna a hora calculada em formato string.

•  Exemplos:

Nome do Tag Expressão

  Tag ClockGetTime(0) // Caso o computador esteja na zona de tempoCentral. Valor de retorno = 18:00:00

  Tag ClockGetTime(1018886359) // Caso o computador esteja na zona detempo Central.

 Valor de retorno = 10:59:19

  Nota:Essa função faz a contagem na Zona de Tempo especificada no Control Panel docomputador local.

  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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Page 573: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 573/725

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

InduSoft Web Studio Página 572

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  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

  Nota:Essa função faz a contagem na Zona de Tempo especificada no Control Panel docomputador local.

GetClock()

Grupo Data e Hora 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Calcula quantos segundos se passaram desde as 19:00:00 EST 12/31/1969 nomomento 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.

Page 574: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 574/725

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

InduSoft Web Studio Página 573

•  Exemplos:

Nomedo 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 deretorno = 0

  Nota:Essa função faz a contagem na Zona de Tempo especificada no Control Panel docomputador local.

Hour2Clock(strTime)

Grupo Data e Hora 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 formatoHH:MM:SS.

•  Valores de Retorno: Retorna o número de segundos equivalentes ao total de horas, minutos esegundos especificados.

•  Exemplos:

Nome do Tag Expressão

  Tag Hour2Clock(“01:00:00”) // Valor de retorno = 3600

  Tag Hour2Clock(“10:01:01”) // Valor de retorno = 36061

SetsystemDate(strDate)

Grupo Data e Hora 

Execução Síncrona 

Page 575: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 575/725

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

InduSoft Web Studio Página 574

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

SetSystemDate(“04/15/2002”) // Configura o relógio do sistema para 

 April 15th 2002.

SetSystemTime(strTime)

Grupo Data e Hora 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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ógioserá configurado.

•  Valores de Retorno: Sem valor de retorno.

•  Exemplos:

Nome do Tag Expressão

SetSystemTime(“15:45:18”) // Configura o relógio do sistema 3:45:18PM.

Page 576: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 576/725

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

InduSoft Web Studio Página 575

Funções TrigonométricasEssa 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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag ACos(1) // Valor de retorno = 0.000000

  Tag ACos(0) // Valor de retorno = 1.570796

ASin(numValue)

Grupo Trigonométrica 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

Page 577: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 577/725

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

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:

Nome do Tag Expressão

  Tag ASin(1) // Valor de retorno = 1.570796

  Tag ASin(0) // Valor de retorno = 0.000000

ATan(numValue)

Grupo Trigonométrica 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag ATan(1) // Valor de retorno = 0.785398

  Tag ATan(0) // Valor de retorno = 1.570796

Cos(numAngle)

Grupo Trigonométrica 

Execução Síncrona 

Windows NT/2K/XP Suportado

Page 578: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 578/725

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

InduSoft Web Studio Página 577

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Calcula o Cosseno de um valor.

•  Parâmetros:

NumAngle Tag numérico contendo o ângulo (em radianos) do qual calcular oCosseno.

•  Valores de Retorno: Retorna o Cosseno de numAngle.

•  Exemplos:

Nome do Tag Expressão

  Tag Cos(1.570796) // Valor de retorno = 0.000000

  Tag Cos(0) // Valor de retorno = 1.000000

Cot(numAngle)

Grupo Trigonométrica 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag Cot(0.785398) // Valor de retorno = 1.000000

  Tag Cot(0) // Valor de retorno = 0.00000

Page 579: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 579/725

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

InduSoft Web Studio Página 578

  Nota:Embora, matematicamente, a tangente de Pi seja infinita, o IWS retorna somente omaior número possível.

Pi()

Grupo Trigonométrica 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Calcula Pi.

•  Valores de Retorno: Retorna Pi.

•  Exemplos:

Nome do Tag Expressão

  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)

Grupo Trigonométrica 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Calcula o Seno de um valor.

•  Parâmetros:

NumAngle Tag numérico contendo o Ângulo (em radianos) do qual calcular oSeno.

•  Valores de Retorno: Retorna o Seno de numAngle.

Page 580: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 580/725

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

InduSoft Web Studio Página 579

•  Exemplos:

Nome do Tag Expressão

  Tag Sin(0) // Valor de retorno = 0.000000

  Tag Sin(1.570796) // Valor de retorno = 1.000000

Tan(numAngle)

Grupo Trigonométrica 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  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 somenteo maior número possível.

Page 581: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 581/725

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

InduSoft Web Studio Página 580

Abrindo e Fechando JanelasEssa 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 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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:

Nome do Tag Expressão

Close(“main”)

Close(“alarms”)

 Atenção: Ao abrir uma tela utilizando Replace style, as telas fecham-se automaticamente comatributos 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)

Grupo Abrindo e Fechando Janelas

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Page 582: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 582/725

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

InduSoft Web Studio Página 581

Web Thin Client Suportado

•  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.

optnumX2  Tag Integer opcional contém a coordenada X para o canto superior esquerdo da tela em pixels.

optnumY2  Tag Integer opcional contém a coordenada X para o canto inferior direitoda tela em pixels.

•  Valores de Retorno:

0 Função executada com sucesso.

1 Função não foi executada com sucesso.

•  Exemplos:

Nome do Tag Expressão

  Tag Open(“main”)

  Tag Open(“alarm”, 50, 50, 690, 530)

 Atenção:lguns 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 somenteletras minúsculas para o nome da tela.

OpenPrevious(numOptionalX1 , numOptionalY1 , numOptionalX2 , numOptionalY2 )

Grupo Abrindo e Fechando Janelas

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Reabre a última tela que foi fechada.

Page 583: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 583/725

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

InduSoft Web Studio Página 582

•  Parâmetros:

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.

optnumX2  Tag Integer opcional contém a coordenada X para o canto superior esquerdo da tela em pixels.

optnumY2  Tag Integer opcional contém a coordenada Y para o canto superior esquerdo da tela em pixels.

•  Valores de Retorno:

0 Função não foi executada com sucesso

1 Função executada com sucesso

•  Exemplos:

Nome do Tag Expressão

OpenPrevious()

OpenPrevious0,0,800,600()

Page 584: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 584/725

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

InduSoft Web Studio Página 583

Funções de SegurançaEssa 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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno:

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:

Nome do Tag Expressão

  Tag BlockUser(“Bob”)

  Tag BlockUser(“Albert”)

Page 585: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 585/725

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

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á sendoutilizado 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 dedados secundário.

  Dica:Pode-se utilizar o programa ExtUser.exe (localizado na pasta Bin) para gerenciar osusuários nesse banco de dados secundário.

CreateUser(strUserName, strGrupoName, strPassword, strOptUserFullName)

Grupo Segurança 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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. Esseparâmetro é opcional .

•  Valores de Retorno:

0 Novo usuário criado com sucesso

1 Número inválido de parâmetros

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() 

Page 586: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 586/725

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

InduSoft Web Studio Página 585

•  Exemplos:

Nome do Tag Expressão

  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 umbanco de dados secundários.

  Dica:

Pode-se utilizar o programa ExtUser.exe (localizado na pasta Bin) para gerenciar osusuários nesse banco de dados secundário.

GetUserState(strUserName)

Grupo Segurança 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno:

0 Usuário está desbloqueado

1 Usuário está bloqueado

3 Usuário não existe

4 Não é possível registrar dados com segurança 

Page 587: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 587/725

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

InduSoft Web Studio Página 586

•  Exemplos:

Nome do Tag Expressão

  Tag GetUserState(“Bob”)

  Tag GetUserState(“Albert”)

GetUserNames ( “tagUsers” , optnumUserType , “opttagGrupos” )

Grupo Segurança 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  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 ambientede desenvolvimento

“opttagGrupos” Nome do tag array que receberá o Grupo para cada usuárioespecífico

•  Valores de Retorno: Número de usuários ou um número negativo que pode ser um dosseguintes:

-1 Número inválido de parâmetros

-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: 

Nome do Tag Expressão

NumberOfUsers GetUserNames("UsersArray") //Entrega usuários, armazena seusnomes no tag UsersArray tag e o Número de usuários no tag

Page 588: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 588/725

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

InduSoft Web Studio Página 587

NumberOfUsers.

NumberOfUsers GetUserNames("UsersArray", 1) //Entrega todos os usuárioscriados durante o run-time, armazena seus nomes no tagUsersArray tag e o Número de usuários no tag NumberOfUsers.

NumberOfUsers GetUserNames("UsersArray", 2) // Entrega todos os usuárioscriados durante o run-time, armazena seus nomes no tagUsersArray tag e o Número de usuários no tag NumberOfUsers.

NumberOfUsers GetUserNames("UsersArray", 2, “Grupos”) //Entrega todos osusuários criados no ambiente de desenvolvimento, armazena seusnomes no tag UsersArray e o Número de usuários no tagNumberOfUsers. O nome do grupo por usuário é armazenado notag Groups.

RemoveUser(strUserName)

Grupo Segurança 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Remove um usuário do sistema.

•  Parâmetros:

StrUserName Tag String contendo o nome do tag user a ser removido.

•  Valores de Retorno:

0 Usuário removido 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 dados com segurança 

•  Exemplos:

Nome do Tag Expressão

  Tag RemoveUser(“Bob”)

  Tag RemoveUser(“Albert”)

Page 589: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 589/725

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

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 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno:

0 A nova senha já está configurada 

1 Usuário está bloqueado

3 Usuário não existe

4 Não é possível registrar dados com segurança 

5 Operação foi cancelada 

•  Exemplos:

Nome do Tag Expressão

  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.

Page 590: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 590/725

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

InduSoft Web Studio Página 589

UnblockUser(strUserName)

Grupo Segurança 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno:

0 Usuário desbloqueado 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 dados com segurança 

•  Exemplos:

Nome do Tag Expressão

  Tag UnblockUser(“Bob”)

  Tag UnblockUser(“Albert”)

Page 591: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 591/725

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

InduSoft Web Studio Página 590

Funções do Módulo AtividadeEssa 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

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

Page 592: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 592/725

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

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 )

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

 AppActivate(“Microsoft Word – test.doc”, 5)

AppIsRodando(strAppTitle)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Verifica se uma aplicação está aberta e rodando.

•  Parâmetros:

strAppTitle Tag String contendo o nome do tag Aplicação.

•  Valores de Retorno:

1 Aplicação está rodando.

0 Aplicação não está rodando.

Page 593: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 593/725

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

InduSoft Web Studio Página 592

•  Exemplos:

Nome do Tag Expressão

  Tag AppIsRunning(“Microsoft Word – test.doc”)

AppPostMessage(strAppTitle, numwParam, numlParam)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 

•  Valores de Retorno: Sem valores de retorno.

  Exemplos:Nome do Tag Expressão

  Tag AppPostMessage(“Microsoft Word – test.doc”, 3, 1)

AppSendKeys(strKeys1, strKeys2, ..., strKeysN)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Envia comandos de teclado para a aplicação ativa.

•  Parâmetros:

Page 594: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 594/725

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

InduSoft Web Studio Página 593

StrKeys (1-N) Tags String contendo os comandos de teclado a seremutilizados.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

 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ódigoigual aos comandos de teclado Alt, Ctrl, ou Shift. Para enviar o caractere < especifique << no texto.

CleanReadQueue()

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Remove todas as atividades de leitura do módulo de comunicação.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

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.

Page 595: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 595/725

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

InduSoft Web Studio Página 594

CloseSplashWindow()

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Fecha a tela de som (splash) do IWS.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

CloseSplashWindow()

EndTask(strTask)

Grupo Módulo Atividade

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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 dosseguintes):

•  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

•  Valores de Retorno: Sem valores de retorno.

Page 596: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 596/725

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

InduSoft Web Studio Página 595

•  Exemplos:

Nome do Tag Expressão

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)

Grupo Módulo Atividade

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

ExitWindows(1)

Page 597: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 597/725

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

InduSoft Web Studio Página 596

IsScreenOpen(strScreen)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Verifica se uma tela está aberta.

•  Parâmetros:

strScreen Tag String contendo o nome do tag screen a ser verificado.

•  Valores de Retorno:

0 Tela não está aberta.

1 Tela está aberta.

•  Exemplos:

Nome do Tag Expressão

  Tag IsScreenOpen(“main”)

IsTaskRodando(strTask)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Verifica se a tarefa está rodando.

•  Parâmetros:

strTask Tag String contendo o nome do tag task a ser verificado.

•  Valores de Retorno:

0 Tarefa não está rodando.

1 Tarefa está rodando.

Page 598: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 598/725

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

InduSoft Web Studio Página 597

•  Exemplos:

Nome do Tag Expressão

  Tag IsTaskRunning(“viewer”)

IsViewerInFocus()

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Verifica se o módulo Viewer está em foco na tela.

•  Valores de Retorno:

0 Viewer não está em foco.

1 Viewer está em foco.

•  Exemplos:

Nome do Tag Expressão

  Tag IsViewerInFocus()

KeyPad(“TagName”)

Grupo Módulo Atividade

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

Page 599: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 599/725

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

InduSoft Web Studio Página 598

•  Valores de Retorno:

0 Sucesso

1 Usuário pressionou ESC para fechar keypad

2 Parâmetro inválido

•  Exemplos:

Nome do Tag Expressão

  Tag KeyPad(“tagA”)

LogOff( )

Grupo Módulo Atividade

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Efetua log off do usuário atual e loga o usuário guest.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

LogOff()

Logon(optstrUser, optstrPassword)

Grupo Módulo Atividade

Execução Assíncrona 

Windows NT/2K/XP SuportadoWindows CE Suportado

Web Thin Client Suportado

•  Descrição: Loga um usuário especificado utilizando a senha especificada. Caso não seja fornecido o usuário, um diálogo logon abrirá.

Page 600: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 600/725

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

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 logon.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

Logon()

Logon(“Albert”, “EMC2”)

Math(numWorksheet)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Executa uma planilha math especificada.

•  Parâmetros:

numWorksheet Tag numérico contendo o número de planilhas math a seremespecificadas.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

Math(6)

 Atenção:Rodar uma planilha math de dentro de outro módulo causará uma pausa no móduloaté 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.

Page 601: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 601/725

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

InduSoft Web Studio Página 600

PostKey(numKeydownOrKeyup, numwParam, numlParam)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

PostKey(0, 0x24, 0)

Recipe(strFunction)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Ativa uma função Recipe especificada.

•  Parâmetros:

Page 602: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 602/725

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

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.

•  Valores de Retorno:

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:

Nome do Tag Expressão

  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)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Salva um relatório em disco ou envia-o para a impressora. 

•  Parâmetros:

Page 603: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 603/725

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

InduSoft Web Studio Página 602

“strFunction” String especificando a operação a ser executada e a folha derelatório a ser utilizada na sintaxe de formato “[Operation]:[Reportworksheet] 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).

optnumOrientat

ion 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 noparâmetro “strFunction”é diferente de Prn.

  Nota:O parâmetro optnumOrientation Não é suportado ao rodar a aplicação sob sistema operacional Windows CE. 

•  Valores de Retorno:

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 sobrescritoou caminho inválido)

•  Exemplos:

Nome do Tag Expressão

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 WindowsCE.

Page 604: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 604/725

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

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)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

  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. Osseguintes 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 enviadopara Shift.

optnumCtrl Tag numérico Opcional , indicando se deverá ser enviadopara Ctrl.

optnumAlt Tag numérico Opcional , indicando se deverá ser enviadopara Alt.

optstrTargetScreen  Tag String Opcional contendo a tela a receber o key Code.

•  Valores de Retorno: Sem valores de retorno.

Page 605: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 605/725

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

InduSoft Web Studio Página 604

•  Exemplos:

Nome do Tag Expressão

SendKeyObject(0, “R”, 1, 0, 0, “main”)

  Notas:numEvent define como uma função executa Expressões especificadas para  OnDown, 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)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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.

•  Valores de Retorno:

0 Falha na configuração do caminho.

1 Sucesso na configuração do caminho.

•  Exemplos:

Nome do Tag Expressão

SetAppPath(“C:\ InduSoft Web Studio\”)

Page 606: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 606/725

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

InduSoft Web Studio Página 605

  Nota:Caso o computador esteja em rede de trabalho, pode-se utilizar a sintaxe //<IPaddress ou host name>/<Path> para definir o local de um outro modo na rede detrabalho.

SetKeyboardLanguage(strLanguage)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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çõesdisponíveis atualmente são: “EN” (English, default ), and “GE”(German).

•  Valores de Retorno:

0 Sucesso

1 Erro

•  Exemplos:Nome do Tag Expressão

  Tag SetKeyboardLanguage(“EN”)

  Tag SetKeyboardLanguage(TagLanguage)

SetViewerInFocus()

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Configura o foco para a tarefa Viewer.

Page 607: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 607/725

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

InduSoft Web Studio Página 606

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

SetViewerInFocus()

SetViewerPos(numLeft, numTop, optnumWidth, optnumHeight)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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 empixels.

OptnumHeight Tag numérico Opcional contendo a altura do Viewer em pixels.

•  Valores de Retorno:

0 Erro

1 Sucesso

•  Exemplos:

Nome do Tag Expressão

  Tag SetViewerPos(50, 50, 640, 480)

  Nota:  Ao omitir os parâmetros opcionais (numWidth e numHeight), o IWS obtém otamanho da janela do Viewer a partir da resolução da aplicação.

Page 608: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 608/725

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

InduSoft Web Studio Página 607

ShutDown()

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Desliga todos os módulos ativos da aplicação.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

ShutDown()

 Atenção:Ess função não fecha o ambiente de desenvolvimento, Database Spy , ou LogWin .

StartTask(strTask)

Grupo Módulo Atividade

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Inicia um módulo do IWS que não está rodando atualmente. 

Page 609: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 609/725

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

InduSoft Web Studio Página 608

•  Parâmetros:

StrTask Tag String contendo o nome do tag task para iniciar (deve ser uma dasseguintes 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

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

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 >”) 

Page 610: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 610/725

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

InduSoft Web Studio Página 609

ViewerPostMessage(strScrTitle, numwParam, numlParam)

Grupo Módulo Atividade

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Envia uma mensagem interna para o Viewer. 

•  Parâmetros:

strScrTitle Tag String contendo o nome do tag screen para o qual a mensagemserá enviada.

numwParam Tag numérico contendo wParam da mensagem do Windows.

numlParam Tag numérico contendo lParam da mensagem do Windows.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

 ViewerPostMessage(“main”, 3, 1)

Wait(numMillisec)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Interrompe a execução da planilha math por um número especificado demilissegundos.

•  Parâmetros:

NumMillisec Tag Integer contendo o número de milissegundos a esperar.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Page 611: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 611/725

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

InduSoft Web Studio Página 610

Nome do Tag Expressão

 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”)

Grupo Módulo Atividade

Execução Assíncrona / Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 uminteiro 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.

Page 612: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 612/725

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

InduSoft Web Studio Página 611

optnumSync Tag numérica opcional ou constante que especifica sea função executará sincronica ouassincronicamente. Ao executar sincronicamente, a função retornará quando o executável terminá-la; Aoexecutar assincronicamente, a função retornará 

imediatamente. Para verificar se um programa queiniciou-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 Tagque receberá o Código de retorno (ao executar sincronicamente) do arquivo executável ou oprograma a ser manuseado pode ser utilizado na função WinExecIsRodunnig para determinar se a 

executável ainda está rodando.

•  Valores de Retorno:

0 Comando não foi executado com sucesso.

1 Comando foi executado com sucesso.

•  Exemplos:

Nome do Tag Expressão

  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 econtinua executando as próximas linhas no script 

  Tag WinExec( "C:\MyTasks.bat", 0, 1, “result” ) // Inicia um arquivobatch, executa-o em modo oculto e continua a execução nas próximaslinhas no script somente quando o batch finalize sua Execução. Oresultado é armazenado no tag integer result.

  Tag WinExec( "C:\MyTasks.bat", 0, 0, “handle” ) // Inicia um arquivobatch, executa-o em modo oculto e segue para a próxima linha doscript. O tag handle recebe um número que pode ser passado para a 

função WinExecIsRunning para determinar se o batch ainda está emexecução ou não [WinExecIsRunning(handle)].

Page 613: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 613/725

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

InduSoft Web Studio Página 612

WinExecIsRunning(numHandle, “opttagReturn”)

Grupo Módulo Atividade

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 WinExecstroptReturnorHandle.

“opttagReturn” Tag que recebe o código de retorno pelo programa executadopela função WinExec().

•  Valores de Retorno:

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:

Nome do Tag Expressão

  Tag WinExecIsRunning(numHandle)

  Tag WinExecIsRunning(numHandle, “return”)

Page 614: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 614/725

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

InduSoft Web Studio Página 613

Funções de ArquivoEssa 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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Apaga os arquivos no caminho (path) e com a máscara (mask) selecionada, queforem 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 maisantigo que essa data será deletado.

•  Valores de Retorno: Retorna o número de arquivos deletados.

Page 615: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 615/725

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

InduSoft Web Studio Página 614

•  Exemplos:

Nome do Tag Expressão

  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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Cria o diretório especificado.

•  Parâmetros:

strDirectory Tag string ou valor contendo o nome e o caminho do arquivo dodiretório a ser criado.

optBooEmptyOnly  flag opcional. Se omitido ou parâmetro com valor igual a 0, o diretórioserá criado somente se todos os diretórios anteriores existirem. Caso oparâmetro possua valor diferente de 0, o caminho completoespecificado no parâmetro strDirectory será criado.

•  Valores de Retorno:

-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:

Nome do Tag Expressão

  Tag DirCreate(“C:\Studio\Temp”) // A pasta Temp foi criada no caminhoC:\Studio (somente se o caminho C:\Studio já exista).

  Tag DirCreate(“C:\Studio\Temp”,1) // O caminho completoC:\Studio\Temp foi criado.

Page 616: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 616/725

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

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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Deleta o diretório especificado.

•  Parâmetros:

strDirectory Tag string ou valor contendo o nome e o caminho do arquivo dodiretório a ser deletado.

optBooEmptyOnly  Flag opcional. Se omitido ou se o parâmetro possui o valor 0, odiretório será deletado somente se estiver vazio.

•  Valores de Retorno:

-2 Tentativa de deletar um diretório não vazio quando tal ação não é

permitida (optBooEmptyOnly <> 0)

-1 Parâmetros inválidos

0 Falha ao deletar o diretório (e.x. Diretório não existe.)

1 Diretório deletado com sucesso.

•  Exemplos:

Nome do Tag Expressão

  Tag DirDelete(“C:\Studio\Temp”) // A pasta Temp de C:\Studio foideletada.

  Tag DirDelete (“C:\Studio\Temp”,1) // A pasta Temp de C:\Studio será deletada somente se estiver vazia.

Page 617: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 617/725

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

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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  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.

•  Valores de Retorno:

-2 Diretório não existe.

-1 Parâmetros inválidos

>=0 Tamanho (em bytes) dos arquivos e subpastas do diretório

•  Exemplos:

Nome do Tag Expressão

  Tag DirLength(“C:\Studio”) // Retorna o tamanho (em bytes) de todos osarquivos 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.

Page 618: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 618/725

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

InduSoft Web Studio Página 617

  Nota:Quando essa função é executada a partir de uma Web Thin Client station, odiretório é verificado na server station (mas não em Web Thin Client).

DirRename(strPath, strDirectoryFrom, strDirectoryTo)

Grupo Arquivo

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  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 odiretório original.

•  Valores de Retorno:

-1 Parâmetros inválidos

0 Falha ao renomear o diretório (e.x. strDirectoryFrom não existe.)

1 Diretório renomeado com sucesso.

•  Exemplos:

Nome do Tag Expressão

  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:\Studioserá deletada somente se estiver vazia.

  Nota:Quando essa função é executada a partir de uma Web Thin Client station, odiretório é renomeado na server station (mas não em Web Thin Client).

Page 619: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 619/725

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

InduSoft Web Studio Página 618

  Dica:Essa função suporta wildcard (* and ?).

FileCopy (strSourceFile, strTargetFile, optnumTimeOut)

Grupo Arquivo

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno:

-1 Timeout expirou.

0 Falha ao copiar o arquivo(s).

1 Arquivo(s) copiado com sucesso.

•  Exemplos:

Nome do Tag Expressão

  Tag FileCopy(“C:\ IWS\Aplication\HST\*.hst”, “C:\Temp\Hst\”, 1000)

  Tag FileCopy(“C:\ IWS\Aplication\ropert.txt”,“C:\Temp\Tuesday_Report.txt”, 500)

Page 620: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 620/725

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

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çãopara 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 otimeout 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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Deleta o arquivo especificado. 

•  Parâmetros:

strFile Tag String contendo o nome e o caminho do arquivo a ser deletado.

•  Valores de Retorno:

0 Falha ao deletar o arquivo

Real Retorna o tamanho do arquivo deletado

•  Exemplos:

Nome do Tag Expressão

  Tag FileDelete(“C:\ IWS\readme.txt”)

FileLength (strFile)

Grupo Arquivo

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Retorna o tamanho de um arquivo

Page 621: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 621/725

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

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:Nome do Tag Expressão

  Tag FileLength( "C:\readme.txt" )

FileRename(strOldName, strNewName)

Grupo Arquivo

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

FileRename(“C:\readme.txt”, “C:\pleasereadme.txt”)

FileWrite(strFileName, strWriteText, numoptAppend)

Grupo Arquivo

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Registra uma string ASCII para um arquivo especificado. Caso o arquivo não exista,a função criará o arquivo.

Page 622: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 622/725

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

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 textoespecificado para strWriteText.

  Caso você especifique um valor diferente de zero (1, 2, 3, …), a função adiciona o novo texto especificado utilizandostrWriteText como uma nova linha para o arquivo.

•  Valores de Retorno:

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:

Nome do Tag Expressão

  Tag FileWrite(“c:\test.txt”, “This is a test”)

  Tag FileWrite(TagFileName, TagText)

  Tag FileWrite(TagFileName, TagText, 1)

FindFile(strFile, "opttagFilesFound", optnumTimeOut)

Grupo Arquivo

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

Page 623: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 623/725

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

InduSoft Web Studio Página 622

•  Valores de Retorno:

-1 Timeout 

0 Arquivos não encontrados

N Número de arquivos encontrados

•  Exemplos:

Nome do Tag Expressão

  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çãopara 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 otimeout especificado e o scan continuará.

FindPath(strPathName)

Grupo Arquivo

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Verifica a existência do diretório.

•  Parâmetros:

strPathName Tag String contendo o caminho do arquivo a ser pesquisado.

•  Valores de Retorno:

0 Caminho não encontrado

1 Caminho encontrado

•  Exemplos:

Page 624: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 624/725

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

InduSoft Web Studio Página 623

Nome do Tag Expressão

  Tag FindPath(“C:\WINNT\”)

GetFileAttributes(strFile)

Grupo Arquivo

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Lê os atributos de um arquivo especificado. 

•  Parâmetros:

strFile Tag string, contendo o arquivo do qual os atributos serão lidos.

•  Valores de Retorno:

-1 Erro

1 Somente Leitura 

2 Oculto

4 Sistema 

16 Diretório

32 Arquivo

128 Normal

256 Temporário

•  Exemplos:

Nome do Tag Expressão

  Tag GetFileAttributes(“C:\readme.txt”)

GetFileTime(strFileName, numFormat)

Grupo Arquivo

Execução Síncrona 

Page 625: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 625/725

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

InduSoft Web Studio Página 624

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 retornoespecificados.

•  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:

Nome do Tag Expressão

  Tag GetFileTime(“C:\readme.txt”)

GetLine(strFileName, strSeqChar, "tagStore", optnumCase, "optOveflowTag")

Grupo Arquivo

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Pesquisa uma seqüência de caracteres (string) em um arquivo ASCII e armazena (emum Tag string) os conteúdos de toda uma linha na qual a seqüência de caracteres foiencontrada.

•  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 serempesquisados.

“tagStore” Nome do Tag string que recebe a linha toda de caracteres dosquais a seqüência foi encontrada.

Page 626: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 626/725

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

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 deuma verificação de sobrefluxo.

•  0: OK •  1: sobrefluxo

Page 627: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 627/725

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

InduSoft Web Studio Página 626

•  Valores de Retorno:

N Quantidade de linhas nas quais a seqüência foi encontrada no arquivoalvo 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

-7 Número inválido de parâmetros

•  Exemplos:

Nome do Tag Expressão

  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

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Exporta informações do arquivo(s) histórico trend binário de propriedade (*.hst) para um arquivo texto (*.txt).

Page 628: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 628/725

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

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 arquivoa ser registrado. Se omitido, a função cria um arquivo com omesmo nome de propriedade do arquivo, mas utilizando a extensão TXT.

optstrSeparator  Tag String opcional contendo os caracteres para separaçãode dados para o arquivo. Se omitido, a função utiliza ocaractere 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 notimestamp 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 arquivotexto:

“DMY”: Day, Month, Year 

“MDY”: Month, Day, Year 

“YMD”: Year, Month, Day 

Se omitido, a função utiliza o formato DMY para otimestamp no arquivo texto. 

•  Valores de Retorno:

-3 Número inválido de parâmetros

-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:

Nome do Tag Expressão

  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", "," ,

Page 629: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 629/725

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

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 dedados históricos Trend de formato binário de propriedade para um arquivo quepode ser aberto com o Microsoft Excel.

HST2TXTIsRodando()

Grupo Arquivo

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Retorna o status da função HST2TXT().

•  Valores de Retorno:

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.

Page 630: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 630/725

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

InduSoft Web Studio Página 629

•  Exemplos:

Nome do Tag Expressão

  Tag HST2TXT()

Print( strFilePath , optnumOrientation)

Grupo Arquivo

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  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á rodandosob sistema operacional Windows CE. 

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

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ãopodem ser impressas com essa função.

Page 631: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 631/725

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

InduSoft Web Studio Página 630

RDFileN("tagSelecioneedFile", strSearchPath, strMask, numChangeDir)

Grupo Arquivo

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 umarquivo selecionado(s).

StrSearchPath Tag String contendo o caminho do arquivo a ser 

pesquisado.

StrMask  Tag String contendo o mask utilizado para filtrar osarquivos.

NumCahngeDir Tag numérico contendo 0 para desabilitar alteração dediretórios.

•  Valores de Retorno:

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:

Nome do Tag Expressão

  Tag RDFileN("FileName", “C:\ IWS\”, “*.doc”, 1)

Page 632: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 632/725

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

InduSoft Web Studio Página 631

Funções GráficasEssa 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 

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Abre o diálogo de configuração padrão do Sistema Operacional, onde a impressora pode ser selecionada e configurada. 

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

  Tag PrintSetup()

PrintWindow(strScreenName , optnumOrientation)

Grupo Gráfico

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Imprime um screenshot da tela da aplicação.•  Parâmetros:

strScreenName Tag String contendo o nome do tag screen o qual deseja-seimprimir. Caso esse parâmetro esteja omitido, a tela aberta atualmente será impressa. Esse parâmetro deve ser omitido aoexecutar essa função sob sistema operacional WinCE.

Page 633: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 633/725

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

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á rodandosob sistema operacional Windows CE. 

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

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áficoExecução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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).

Page 634: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 634/725

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

InduSoft Web Studio Página 633

•  Exemplos:

Nome do Tag Expressão

  TagColor RGBColor(51,153,102) // Essa função retorna o valor 13434828, oqual é a cor do código para Sea Green.

  TagColor RGBColor(TagRed,TagGreen,TagBlue) // Essa função retorna o códigoda cor dos valores RGB configurados nos tags TagRed, TagGreen and TagBlue, respectivamente.

 Dica:eja 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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Retorna o código de um dos componentes RGB a partir do código de coresestabelecido.

•  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 docódigo de cores apresentado.

Page 635: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 635/725

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

InduSoft Web Studio Página 634

•  Exemplos:

Nome do Tag Expressão

  TagRed RGBColor(13434828,0) // Essa função retorna o valor 51, o qual é ocomponente 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 docó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.

Page 636: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 636/725

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

InduSoft Web Studio Página 635

Funções de TraduçãoEssa seção descreve as seguintes funções de Tradução do InduSoft Web Studio:

•  Ext(strText)

  SetTranslationFile(strFileName)

Ext(strText)

Grupo Tradução

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

Page 637: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 637/725

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

InduSoft Web Studio Página 636

optStrColumnName    Tag string ou valor contendo o nome do tag column doarquivo 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.

•  Valores de Retorno:

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:

Nome do Tag Expressão

  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 queessa função possa funcionar.

 Atenção:Deve-se possuir um arquivo de tradução na utilidade Translation File .

Page 638: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 638/725

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

InduSoft Web Studio Página 637

Funções MultimídiaEssa 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 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

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.

Page 639: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 639/725

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

InduSoft Web Studio Página 638

Funções Informações do SistemaEssa 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.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Page 640: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 640/725

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

InduSoft Web Studio Página 639

Web Thin Client Suportado

•  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:Nome do Tag Expressão

  Tag DbVersion()

GetAppHorizontalResolution( )

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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:

Nome do Tag Expressão

  Tag GetAppHorizontalResolution( ) // Valor de retorno = 640

  Tag GetAppHorizontalResolution( ) // Valor de retorno = 800

GetAppVerticalResolution( )

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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.

Page 641: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 641/725

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

InduSoft Web Studio Página 640

•  Exemplos:

Nome do Tag Expressão

  Tag GetAppVerticalResolution( ) // Valor de retorno = 480

  Tag GetAppVerticalResolution( ) // Valor de retorno = 600

GetComputerIP( )

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag GetComputerIP() // Valor de retorno = 192.168.0.1

  Tag GetComputerIP() // Valor de retorno = 248.12.2.78

GetComputerName( )

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Suportado

•  Descrição: Retorna o nome do computador local.

•  Valores de Retorno: Retorna o nome do computador local como uma string.

Page 642: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 642/725

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

InduSoft Web Studio Página 641

•  Exemplos:

Nome do Tag Expressão

  Tag GetComputerName() // Valor de retorno = Terminal53

  Tag GetComputerName() // Valor de retorno = BobsComputer 

GetFreeMemoryCE(optnumType)

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Não suportado

Windows CE Suportado

Web Thin Client 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

•  Valores de Retorno:

>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:

Nome do Tag Expressão

  Tag GetFreeMemoryCE(opt2)

GetHardKeyModel()

Grupo System Info.

Execução Síncrona 

Page 643: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 643/725

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

InduSoft Web Studio Página 642

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Retorna o modelo de seu hardkey.

•  Valores de Retorno:

Hardkey located: Retorna uma string com o modelo do hardkey.

Hardkey not installed or not found: Sem valores de retorno. 

•  Exemplos:

Nome do Tag Expressão

  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.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Retorna o número serial do hardkey.

•  Valores de Retorno:

Hardkey located: Retorna uma string com o número serial do hardkey.

Hardkey not installed or not found: Retorna a 0.

•  Exemplos:

Nome do Tag Expressão

  Tag GetHardkeySN() // Valor de retorno = 120.745

  Tag GetHardkeySN() // Valor de retorno = 224.941

Page 644: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 644/725

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

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.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Retorna o número dos endereços IP assinalados para a estação local e armazena osEndereç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.

•  Valores de Retorno:

N Número do Endereço IP encontrado

-1 Número inválido de parâmetros

-2 Tipo de parâmetro inválido

•  Exemplos:

Nome do Tag Expressão

  Tag GeDicaAll(“TagArrayIP”) // Valor de retorno = 1

  Tag GeDicaAll(“TagArrayIP”, second) // Valor de retorno = 2

GetMemoryCE(optnumType)

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Não suportado

Page 645: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 645/725

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

InduSoft Web Studio Página 644

Windows CE Suportado

Web Thin Client Não suportado

•  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 oIWS 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

•  Valores de Retorno:

>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:

Nome do Tag Expressão

  Tag GetMemoryCE(opt1)

GetNetMACID(“strOptMACID”, “strOptAdapterName” )

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  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 detrabalho instalado atualmente na estação, o usuário poderá configurar um tag string array nesse parâmetro, de modo quecada posição de array recebe o MAC ID de um adaptador da rede de trabalho.

Page 646: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 646/725

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

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 trabalhoinstalado 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.

•  Valores de Retorno:

>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:

Nome do Tag Expressão

NumNIC GetNetMACID(“MACIDTag”)

NumNIC GetNetMACID(“MACIDTag”, “AdapterName”)

NumNIC GetNetMACID(“MACIDTag[1]”, “AdapterName[1]”)

GetProductPath( )

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag GetProductPath() // Valor de retorno = C:\Program Files\ IWS 51\

Page 647: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 647/725

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

InduSoft Web Studio Página 646

GetOS( )

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Relata o sistema operacional atual.

•  Valores de Retorno:

0 Windows 3.11

1 Windows 95/98/ME

2 Windows NT/2000/XP

3 Windows CE

•  Exemplos:

Nome do Tag Expressão

  Tag GetOS() //Valor de retorno = 2

GetPrivateProfileString(strSeção, strName, strDefault, strFileName)

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Lê um parâmetro especificado de um arquivo .INI utilizando o formato padrão .INI.

Page 648: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 648/725

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

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:

Nome do Tag Expressão

  Tag GetPrivateProfileString( “boot loader”, “timeout”, “50”, “C:\boot.ini”) // Valor de retorno = 30

GetScrInfo()

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

optstrInfoTypevalue

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 noparâmetro “strInfoData”..

Page 649: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 649/725

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

InduSoft Web Studio Página 648

4 Registra a coordenada RIGHT para o tag configurado no parâmetro“strInfoData”.

•  Valores de Retorno:

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: 

Nome do Tag Expressão

  TagErroCódigo Tag GetScrInfo( "main" , “TagXY[0]” ) // Retorna as coordenadas

  TOP, LEFT, BOTTOM e RIGHT das telas MAINS.SCR em quatroposiçõ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.

Execução Síncrona 

Windows NT/2K/XP Não suportadoWindows CE Não suportado

Web Thin Client Suportado

•  Descrição: 

•  Parâmetros: Nenhum

•  Valores de Retorno: Nome do Server host para ISSymbol e 127.0.0.1 para outros.

•  Exemplos: 

Nomedo Tag

Expressão

GetServerHostName()

Page 650: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 650/725

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

InduSoft Web Studio Página 649

GetTickCount( )

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag GetTickCount // Valor de retorno = 9400907

InfoAppAlrDir( )

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag InfoAppAlrDir() // Valor de retorno = C:\DemoApp\alarm\

  Tag InfoAppAlrDir() // Valor de retorno = C:\ IWS\Projects\App\alarm\

GetAppPath()

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Page 651: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 651/725

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

InduSoft Web Studio Página 650

Windows CE Suportado

Web Thin Client Não suportado

•  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:

Nome do Tag Expressão

  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.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag InfoAppAlrDir() // Valor de retorno = C:\DemoApp\HST\

  Tag InfoAppAlrDir() // Valor de retorno = C:\ IWS\Projects\App\HST\

InfoDiskFree(strDisk)

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Page 652: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 652/725

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

InduSoft Web Studio Página 651

Windows CE Não suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag InfoDiskFree( “C” ) // Valor de retorno = 2803804605.000000

InfoResources(numSelecione)

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag InfoResources( 0 ) // Valor de retorno = 76.000000

  Tag InfoResources( 1 ) // Valor de retorno = 76.000000

  Tag InfoResources( 2 ) // Valor de retorno = 80.000000

  Tag InfoResources( 3 ) // Valor de retorno = 16150528.000000

Page 653: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 653/725

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

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.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Determina se um controle ActiveX está registrado. 

•  Parâmetros:

NumType  Tag numérico especificando um formato para o tagstrProgIDorFileNAme.

•  0: Verificar pelo ID do Programa •  1: Veriicar pelo Nome do Arquivo

strProgIDorFileName Tag String contendo ID do Programa ou Nome do Arquivodo Controle ActiveX.

•  Valores de Retorno:

0 ActiveX está registrado.

1 ActiveX não está registrado.

•  Exemplos:

Nome do Tag Expressão

  Tag IsActiveXReg(0, “ISSYMBOL.ISSymbolCtrl.1”) // Valor de retorno = 0

  Tag IsActiveXReg(1, “C:\winNT\system32\MediaPlayer.ocx”) // Valor deretorno = 1

KeyPad(“TagName”, strOptKeyboardType, booOptIsPassword)

Grupo System Info.

Execução Assíncrona 

Windows NT/2K/XP Suportado

Page 654: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 654/725

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

InduSoft Web Studio Página 653

Windows CE Suportado

Web Thin Client Suportado

•  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 esseparâ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 VirtualKeyboard aparecerão como“*”. Essa opção é útil quandousuário digita uma senha.

  Valores de Retorno: Retorna a hora (em segundos) desde a última ação do keyboard.•  Exemplos:

Nome do Tag Expressão

  Tag NoInputTime()

  Nota:Não pode-se implementar essa função diretamente de um objeto texto I/O.

NoInputTime(optUpdateTrigger)

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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.

Page 655: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 655/725

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

InduSoft Web Studio Página 654

•  Exemplos:

Nome do Tag Expressão

  Tag NoInputTime()

  Nota:Não pode-se implementar essa função diretamente de um objeto de texto I/O.

ProductVersion( )

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Retorna o número da tag databasedo IWS.

•  Valores de Retorno: 

0 Sucesso

1 Erro

•  Exemplos:

Nome do Tag Expressão

  Tag KeyPad(“tagA”)

  Tag KeyPad(“tagA”, “EnhKeypad”)

  Tag KeyPad(“tagA”, “EnhKeypad”, 1)

SaveAlarmFile(numType, optRemotePath)

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Page 656: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 656/725

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

InduSoft Web Studio Página 655

Web Thin Client Não suportado

•  Descrição: Utilize essa função para habilitar/desabilitar o recurso para salvamento dehistóricos de alarme e para configurar o caminho onde os arquivos históricos de alarme devemser 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 discolocal.

  1 – Habilita o salvamento de arquivo de alarme para o discolocal.

  2 – Habilita o salvamento do arquivo de alarme para o disco locale para o caminho remoto especificado no parâmetroOptRemotePath.

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.

•  Valores de Retorno:

0 Sucesso

1 Segundo parâmetro não é uma string.

2 Segundo parâmetro está faltando.

•  Exemplos:

Nome do Tag Expressão

  Tag SaveAlarmFile(0)

  Tag SaveAlarmFile(1)

  Tag SaveAlarmFile(2, “Z:\Apps\AppDemo”)

SetAppAlarmPath(strPath)

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

Page 657: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 657/725

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

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.

• Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

SetAppAlarmPath(“C:\ IWS\Alarm\”)

SetAppHSTPath(strPath)

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

SetAppHstPath(“C:\ IWS\History\”)

SetDateFormat(strSeparator, strFomat)

Grupo System Info.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Configura o formato e separador para a string date.

Page 658: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 658/725

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

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 

•  Valores de Retorno:

0 Sem Erro

1 Parâmetro inválido

•  Exemplos:

Nome do Tag Expressão

  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.

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  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âmetrosconfigurados 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 (ouhostname) do computador onde o módulo TCPServer do IWS está rodando.

strOptBackupURL Alternativa URL  Opcional  para as web pages da aplicação. O Web Thin Client procurará por webpages nessa URL e se não encontrá-los no mesmoURL registrado no campo Address do browser da 

Page 659: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 659/725

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

InduSoft Web Studio Página 658

 web.

strOptPath Caminho Opcional onde as web pages que deverãoser atualizadas estão armazenadas.

numOptHostPort Número da Porta TCP Opcional  que o Web ThinClient deverá utilizar para trocar dados com omódulo TCP Server do IWS.

strOptSecondaryServerIP Endereço IP do data server alternativo e Opcional .O Web Thin Client tentará conectar-se ao móduloServer TCP do IWS nesse Endereço IP e não será capaz de conectar-se ao módulo TCP Server modulerodando no Endereço IP especificado no parâmetrostrServerIP. 

numOptProtocolFlag Opcional  - Ao utilizar a opção Web TunnelingGateway, esse parâmetro especifica se o Web ThinClient 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 ThinClient deverá utilizar para trocar dados com o WebServer 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âmetrostrOptGtwIP. 

strOptISSymbolURL URL Opcional  de onde a tag databaseatualizada deISSymbol ((Controle ActiveX) deve ser baixada casonão seja propriamente registrada na Web ThinClient station. 

•  Valores de Retorno:

0 Sem Erro

1 Número inválido de parâmetros

2 Endereço IP do Server inválido

3 URL inválida 

Page 660: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 660/725

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

InduSoft Web Studio Página 659

4 Caminho opcional inválido

5 Web pages não encontradas

•  Exemplos:

Nome do Tag Expressão

  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 WEBautomaticamente durante o runtime, de acordo com as configurações da rede detrabalho de cada projeto (IP address, Web Server URL, etc).

Somente o primeiro parâmetro dessa função é mandatório (strServerIP). Os outrosparâ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.

Page 661: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 661/725

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

InduSoft Web Studio Página 660

Função LoopEssa 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 

Windows NT/2K/XP Suportado

Windows CE Suportado

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 LoopFor.

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:

Nome do Tag Expressão

  Tag For( 1, 5, 1)

Next 

  Nota:Deve-se compartilhar muitas funções For() com uma notação Next . Como mostradono exemplo, deve-se colocar a notação Next no campo do tag do script math.

Page 662: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 662/725

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

InduSoft Web Studio Página 661

Função Database AccessEssa seção descreve a Função Database Access do InduSoft Web Studio, ForceTagChange(strTagName,numValue).

ForceTagChange(strTagName, numValue)

Grupo Database

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 onovo valor.

numValue Tag contendo o novo valor a ser registrado no tag alvo.

•  Valores de Retorno: Sem valores de retorno.

•  Exemplos:

Nome do Tag Expressão

ForceTagChange( “TagA”, 5 )

Page 663: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 663/725

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

InduSoft Web Studio Página 662

Funções ODBCEssa 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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Inicia uma transação com a origem de dados de conexão.

Page 664: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 664/725

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

InduSoft Web Studio Página 663

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Erro ao começar transação

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCBeginTrans( 5 )

ODBCBindCol(numHandler, strColName, strColType, strTagName)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

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 seseguem):

•  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 

Page 665: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 665/725

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

InduSoft Web Studio Página 664

strTagName Tag String contendoo nome do tag a ser retido na coluna.

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

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:

Nome do Tag Expressão

  Tag ODBCBindCol( 5, “OrderDate”, “SQL_DATE”, “Order_Date” )

ODBCCanAppend(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Retorna se o banco de dados permitirá a adição de novos registros.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Banco de Dados não permite novos registros

Non-Zero Banco de Dados permite novos registros

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCCanAppend( 5 )

Page 666: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 666/725

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

InduSoft Web Studio Página 665

ODBCCanTransact(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Retorna se o banco de dados permite transações.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Banco de dados não permite transações.

Non-Zero Banco de dados permite transações.

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCCanTransact( 2 )

ODBCCanUpdate(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Retorna se o banco de dados pode ser atualizado.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Banco de dados não permite atualizações.

Page 667: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 667/725

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

InduSoft Web Studio Página 666

Non-Zero Banco de dados permite atualizações.

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCCanUpdate( 6 )

ODBCClose(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Fecha uma conexão ao banco de dados.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCClose( 5 )

ODBCCommitTrans(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Encerra uma transação. Solicite essa função após completar transações.

Page 668: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 668/725

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

InduSoft Web Studio Página 667

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Erro ao cometer transação

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCCommitTrans( 1)

ODBCDelete(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Deleta o registro atual. Após uma deleção com sucesso. Você deverá explicitar umdas seguintes funções Move para mover os registros deletados. 

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Deleta erro

Page 669: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 669/725

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

InduSoft Web Studio Página 668

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCDelete( 5 )

ODBCExecuteSQL(numHandler, strSqlCommand)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Executa um comando SQL diretamente. A função ODBCExecuteSQL não retorna registros de dados. 

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

strSqlCommand Tag String especificando um comando SQL válido.

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Parâmetro inválido

4 Erro na execução do comando SQL 

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCExecuteSQL( 3, “ )

  Tag ODBCExecuteSQL( 4, “ )

ODBCInsert(numHandler)

Grupo ODBC

Page 670: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 670/725

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

InduSoft Web Studio Página 669

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Insere um novo registro ao banco de dados. O InduSoft utiliza os valores dos tagsem negrito na função ODBCBindCol para criar o novo registro. 

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Inserir erro

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCInsert( 7 )

ODBCIsBOF(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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 deregistros contém quaisquer registros ou se está vazio. Imediatamente após solicitar ODBCQuery, ecaso 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 registroatual, 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:

Page 671: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 671/725

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

InduSoft Web Studio Página 670

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Registro encontrado

Non-Zero Conjunto de registros não contém registros ou você rolou acima doprimeiro registro

•  Exemplos:

ODBCIsDeleted(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Relata se o registro atual foi deletado. Caso você role para um registro eODBCIsDeleted retorna um valor diferente de zero, você deverá rolar para outro registro antes

de poder executar quaisquer operações.•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

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:

Nome do Tag Expressão

  Tag ODBCIsDeleted( 8 )

Nome do Tag Expressão

  Tag ODBCIsBOF( 1 )

Page 672: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 672/725

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

InduSoft Web Studio Página 671

ODBCIsEOF(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Relata se você esteve acima do primeiro registro do conjunto de registros. (Soliciteessa 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émalgum registro ou se está vazio. Imediatamente após solicitar  ODBCQuery (e se o conjunto deregistros não contiver registros), ODBCIsEOF retornará um valor diferente de zero. Ao abrir umconjunto 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:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Registro encontrado.

Non-Zero Conjunto de registros não contém registros ou você rolou opostamente,antes do último registro.

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCIsEOF( 5 )

ODBCIsFieldNULL(numHandler, strColName)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Relata se um campo especificado em um conjunto de registros foi transmitido comoNull.

Page 673: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 673/725

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

InduSoft Web Studio Página 672

•  Parâmetros:

numHandler  Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

strColName Tag String contendo o nome da coluna.

•  Valores de Retorno:

0 O campo especificado não é transmitido como Null.

Non-Zero O campo especificado é transmitido como Null.

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCIsFieldNULL( 7, “CustomerName”)

  Tag ODBCIsFieldNULL( 3, “CompanyName”)

ODBCIsFieldNullable(numHandler, strColName)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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çãoODBCOpen().

strColName Tag String contendo o nome da coluna.

•  Valores de Retorno:

0 O campo especificado não é transmitido como Nullable.

Non-Zero O campo especificado é transmitido como Nullable.

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCIsFieldNullable( 1, “Price”)

Page 674: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 674/725

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

InduSoft Web Studio Página 673

  Tag ODBCIsFieldNullable( 1, “Model”)

ODBCMove(numHandler, numOffset)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Move o apontador do registro atual junto a um conjunto de registros, para frente epara trás. Caso você passe um valor de 0 para Offset, ODBCMove atualizará o registro atual.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

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 conjuntode registros.

•   Valores negativos movem para trás, em direção ao começo doconjunto de registros.

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Mover erro

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCMove(2, 3)

  Tag ODBCMove(8, 2)

ODBCMoveFirst(numHandler)

Grupo ODBC

Page 675: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 675/725

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

InduSoft Web Studio Página 674

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Move o primeiro registro junto ao conjunto de registros.

•  Parâmetros:

NumHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Mover erro

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCMoveFirst(4)

ODBCMoveLast(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Move o último registro junto ao conjunto de registros.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

Page 676: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 676/725

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

InduSoft Web Studio Página 675

2 Banco de Dados não aberto

3 Mover erro

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCMoveLast(7)

ODBCMoveNext(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Move o próximo registro junto ao conjunto de registros.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Sucesso1 Manuseador inválido

2 Banco de Dados não aberto

3 Fim do conjunto de registros pesquisados

4 Mover erro

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCMoveNext(9)

ODBCMovePrev(numHandler)

Grupo ODBC

Execução Síncrona 

Page 677: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 677/725

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

InduSoft Web Studio Página 676

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Move para o próximo registro junto ao conjunto de registros.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Começo do conjunto de registros alcançados

4 Mover erro

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCMovePrev(2)

ODBCOpen(strDsn, strUser, strPassw, strTable, strFilter, strSort)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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 ascolunas 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.

Page 678: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 678/725

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

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.

•  Valores de Retorno:

N Se sucesso, retorna o manuseador para identificação do banco dedados

-1 Parâmetro inválido

-2 DSN ou TableName contém uma string vazia 

•  Exemplos:

Nome do Tag Expressão

  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-seencerrar as colunas e chamar a função ODBCQuery.

ODBCQuery(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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çãonovamente.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

Page 679: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 679/725

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

InduSoft Web Studio Página 678

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

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:

Nome do Tag Expressão

  Tag ODBCQuery(6)

ODBCROllback(numHandler)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Reverte as alterações feitas durante a transação.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Erro ao voltar para a transação

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCROllback( 4)

Page 680: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 680/725

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

InduSoft Web Studio Página 679

ODBCSetFieldNull(numHandler, strColName, numValue)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

strColName Tag String contendo o nome da coluna.

numValue Tag integer, o qual especifica os dados do campo como Null if 0 e non-Null em non-zero.

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Parâmetro inválido

4 Nome da coluna inválido

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCSetFieldNull(2, “Price”, 1)

  Tag ODBCSetFieldNull(4, “CompanyName”, 0)

ODBCSetFilter(numHandler, strFilter)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Page 681: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 681/725

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

InduSoft Web Studio Página 680

Web Thin Client Não suportado

•  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 inCalifornia" ("state = ‘CA’"). Lembre-se de solicitar ODBCQuery após chamar essa função.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

strFilter Tag String contendo a cláusula SQL: WHERE.

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Parâmetro inválido

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCSetFilter(3, “Name='Morgan'”)

ODBCSetSort(numHandler, strSort)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Registros especificados selecionados pelo IWS.

Pode-se utilizar esse recurso para especificar os registros em uma ou mais colunas. Lembre-se desolicitar ODBCQuery após chamar essa função.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

strSort Tag String contendo a cláusula SQL: ORDER BY.

•  Valores de Retorno:

0 Sucesso

Page 682: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 682/725

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

InduSoft Web Studio Página 681

1 Manuseador inválido

2 Tipo de parâmetro inválido

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCSetSort(5,"Name DESC")

ODBCUnbindCol(numHandler, strColName)

Grupo ODBC

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Desmembra uma coluna de um tag.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

strColName Tag String contendo o nome da coluna.

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Tipo de parâmetro inválido

3 Coluna sem limites

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCUnbindCol(7, “Name”)

ODBCUpdate(numHandler)

Grupo ODBC

Page 683: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 683/725

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

InduSoft Web Studio Página 682

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Atualiza o registro atual. O IWS utiliza os valores de tags bound pela funçãoODBCBindCol para atualizar o registro atual.

•  Parâmetros:

numHandler Tag Integer contendo o manuseador retornado pela funçãoODBCOpen().

•  Valores de Retorno:

0 Sucesso

1 Manuseador inválido

2 Banco de Dados não aberto

3 Erro na atualização

•  Exemplos:

Nome do Tag Expressão

  Tag ODBCUpdate(1)

Page 684: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 684/725

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

InduSoft Web Studio Página 683

Funções MailEssa 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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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çãoSendEmail(),SendEmailExt(), Interface Alarm Email interface, etc.).

•  Parâmetros:

strSMTP Tag String contendo o nome do Server SMTP ou EndereçoIP.Para aplicações em CEView, deve-se especificarO EndereçoIP para SMTP IP ao invés do nome do server.

strFrom   Tag String contendo o endereço do remetente. Esseendereço deverá ser um endereço de email válido para oServer POP3.

strPOP3  Tag String contendoo nome do Server POP3. 

strUser  Tag String contendo o nome da conta do usuário remetentepara o Server POP3. 

strPassword  Tag String contendo a senha da conta do usuário para oServer POP3. 

optnumTimeOut  Tag Numérico opcional contendo o limite de timeout limit (em segundos) utilizado ao enviar mensagens. Casonenhuma resposta seja recebida do Server após esseperíodo de tempo, a operação será abortada automaticamente.

Page 685: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 685/725

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

InduSoft Web Studio Página 684

optAuthType   Tag Numérico opcional  contendo o Tipo de AutenticaçãoSMTP:

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 utilizadopara logar no Server SMTP quando esse requer autenticação. Caso esse parâmetro seja omitido a o tipooptAuthType esteja configurado para 1, o valor configuradopara strUser será automaticamente utilizado comooptstrSMTPUser. 

optstrSMTPPassword Tag opcional String contendo a Senha utilizada para logar no Server SMTP quando esse requer autenticação. Casoesse parâmetro seja omitido a o tipo optAuthType esteja configurado para 1, o valor configurado para strPasswordtambém será automaticamente utilizado como

optstrSMTPPassword. 

•  Valores de Retorno:

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)

Page 686: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 686/725

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

InduSoft Web Studio Página 685

•  Exemplos:

Nome do Tag Expressão

  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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 quandoconfigurar essa função para qualquer dinâmico de tela (como Text I/O,Position, etc).

•  Valores de Retorno:

-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çãoSendEmailExt().

2 Último email foi enviado com sucesso. Pode-se executar a funçãoSendEmailExt() novamente.

3 Houve um Erro no envio do último email. Execute a funçãoSendEmailExt()novamente.

Page 687: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 687/725

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

InduSoft Web Studio Página 686

•  Exemplos:

Nome do Tag Expressão

  Tag GetStatusSendEMailExt(second)

  Tag GetStatusSendEMailExt()

SendEMail(strSubject, strMessage, strTO)

Grupo Mail

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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).

•  Valores de Retorno:

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)

Page 688: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 688/725

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

InduSoft Web Studio Página 687

11 Erro no envio de DATA (enviando mensagem)

•  Exemplos:

Nome do Tag Expressão

  Tag SendEMail( “Subject”, “Message”, “[email protected]”)

SendEMailExt(strSubject, strMessage, strTO, strCC, strBCC, strFile1, ..., strFileN)

Grupo Mail

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 seremCCed.

strBCC Tag String contendo os endereços dos destinatários a seremBCCed.

strFile (1-N) Tags String, cada uma contendo o nome e caminho do arquivopara enviar um email.

•  Valores de Retorno:

-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

Page 689: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 689/725

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

InduSoft Web Studio Página 688

enviado.

2 Erro interno

•  Exemplos:

Nome do Tag Expressão

  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 outrosparâmetros são opcionais.

Pode-se utilizar um valor nulo para a string ("") para strTO, strCC, ou parâmetrosstrBCC 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.

Page 690: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 690/725

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

InduSoft Web Studio Página 689

Funções Dial-UpEssa 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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  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 dotag strPhonebookEntryorModem.

•  0: Phonebook •  1: Modem Name•  2: Direct Connection Name

strPhonebookEntryOrModem Tag String contendo um Phonebook Name, ModemName, 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 stringrecebendo a Mensagem de Erro.

Page 691: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 691/725

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

InduSoft Web Studio Página 690

optRefresh  Tag opcional , que faz com que a função deatualização retorne seu valor. Esse parâmetros éopcional, embora você deverá utilize-lo aoconfigurar essa função para qualquer dinâmico detela (como Text I/O, Position, etc).

•  Valores de Retorno:

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.

Page 692: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 692/725

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

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 Accessdial out.

634 Não é possível registrar seu computador em uma rede de trabalhoremota.

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 trabalhoremota.

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.

Page 693: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 693/725

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

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çãodo arquivo .INF do equipamento.

654 Um comando ou resposta na seção do arquivo .INF refere-se a ummacro indefinido.

655 <message macro não encontrado seção do arquivo .INF doequipamento.

656 <defaultoff macro seção do arquivo .INF do equipamento contém ummacro indefinido.

657 O arquivo .INF do equipamento não pôde ser aberto.

658 O nome do equipamento no arquivo .INF ou .INI media é muitoextenso.

659 O arquivo media .INI refere-se a um nome do equipamentodesconhecido.

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 equipamentoDesconhecido.

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.

Page 694: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 694/725

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

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 nodomí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

Page 695: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 695/725

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

InduSoft Web Studio Página 694

698 Uma keyname de resposta no arquivo .INF do equipamento não está noformato esperado.

699 A resposta do equipamento causou overfluxo em buffer.

700 O comando ampliado no arquivo .INF do equipamento está muitoextenso.

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 deconexã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 ouconfunde-se com a senha do usuário anterior.

710 Erros Serial overrun foram detectados ao estabelecer comunicação comseu 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.

Page 696: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 696/725

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

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 maisde 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 trabalhonã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 podeutilizar 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 assinaladopela verificação do log de evento.

745 ERRO_INVALID_SMM

Page 697: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 697/725

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

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:

Nome do Tag Expressão

  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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Obtém o endereço IP para a Client station RAS de uma conexão Dial-Up. Deve-seexecutar essa função na Client station RAS (não  na Server station RAS) ou a função nãofuncionará de maneira adequada.

•  Parâmetros:

numType Tag Numérico especificando o conteúdo do tagstrPhonebookEntryorModem.

•  0: Phonebook Name•  1: Modem Name•  2: Direct Connection Name

Page 698: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 698/725

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

InduSoft Web Studio Página 697

strPhonebookEntryOrModem Tag String contendo Phonebook Name, ModemName, ou Direct Connection Name utilizado para efetuar a conexão. O tag numType especifica qualdesses 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çãopara qualquer dinâmico de tela (como Text I/O,Position, etc).

•  Valores de Retorno:

-5 Função GetClienTip não encontrada em IndRAS.DLL.

-4 Tipo inválido (0: Phonebook, 1: Modem, 2: Direct Connection)

-3 Número inválido de parâmetros

-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:

Nome do Tag Expressão

  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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  Descrição: Obtém o endereço IP para a Client station RAS de uma conexão Dial-Up. Deve-seexecutar essa função na Client station RAS (não  na Server station RAS) ou a função nãofuncionará de maneira adequada.

Page 699: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 699/725

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

InduSoft Web Studio Página 698

•  Parâmetros:

numType Tag Numérico especificando o conteúdo do tagstrPhonebookEntryorModem.

•  0: Phonebook Name•  1: Modem Name•  2: Direct Connection Name

strPhonebookEntryOrModem Tag String contendo Phonebook Name, ModemName, ou Direct Connection Name utilizado para efetuar a conexão. O tag numType especifica qualdesses métodos será utilizado.

“tagServerIP” Nome do Tag string que recebe 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çãopara qualquer dinâmico de tela (como Text I/O,Position, etc).

•  Valores de Retorno:

-5 Função GetServerIP não encontrada em IndRAS.DLL.

-4 Tipo inválido (0: Phonebook, 1: Modem, 2: Direct Connection)

-3 Número inválido de parâmetros

-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:

Nome do Tag Expressão

  Tag DialGetClineTip( 0, “Office DialUp”, “ClienTipTag” )

  Tag DialError( 1, “USRobotics_SportsterFaxModem”, “ClienTipAddress”,second )

  Tag DialError( 2, “DirectDial”, “IPAdd”)

Page 700: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 700/725

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

InduSoft Web Studio Página 699

DialStatus(numType, strPhonebookEntryOrModem,

optStatus, optRefresh)

Grupo Dial-Up

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Retorna o status de cada conexão

•  Parâmetros:

NumType   Tag Numérico especificando o conteúdo do tagstrPhonebookEntryorModem.

•  0: Phonebook Name•  1: Modem Name•  2: Direct Connection Name

strPhonebookEntryOrModem Tag String contendo Phonebook Name, ModemName, ou Direct Connection Name utilizado para efetuar a conexão. O tag numType especifica qualdesses métodos será utilizado.

optStatus Nome do Tag string que recebe 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).

•  Valores de Retorno:

-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…

Page 701: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 701/725

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

InduSoft Web Studio Página 700

3 O equipamento foi conectado com sucesso

4 Todos os equipamentos na cadeia de equipamentos foramconectados 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.

Page 702: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 702/725

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

InduSoft Web Studio Página 701

•  Exemplos:

Nome do Tag Expressão

  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

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Dispara uma conexão dial-up

•  Parâmetros:

numType Tag Numérico especificando o contéudo do tagstrPhonebookEntryorModem.

•  0: Phonebook Name

•  1: Modem Name•  2: Direct Connection Name

strPhonebookEntryOrModem Tag String contendo Phonebook Name, ModemName, ou Direct Connection Name utilizado para efetuar a conexão. O tag numType especifica qualdesses métodos será utilizado.

strUserName Tag String contendo o Username a ser utilizadopara log on.

strPassword Tag String contendo Password a ser utilizado para log on.

optstrDomain  Tag opcional  String contendo o nome do domíniopara especificar quando efetuar log on.

strPhoneNumber Tag String contendo o número do telefone a ser discado (utilizado somente quando o parâmetronumType=1).

Page 703: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 703/725

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

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 decriar phonebooks temporarios em Windows NT/2000.

Para lidar com esse problema:

1.  Configure DialUp() utilizando o parâmetro Modem Name ao invés dePhonebook 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 coma utilização da função DialUp() (user name, password, domain, e telephone). Pode-se, então, alterar esses parâmetros durante o runtime.

•  Valores de Retorno:

0 OK: discagem iniciada 

-1 Erro: INDRAS.DLL não encontrado

-2 Erro: INDRAS.DLL danificado

-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 doTag

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”)

Page 704: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 704/725

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

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

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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çãoremota do WinCE.

strMyNumber Tag Numérico contendo o número do telefone da estaçãoremota 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 nomepara conectar-se ao computador Windows NT/2000/XP apósretornar a ligação.

strPassword Tag String contendo a senha a ser utilizada pela estaçãoremota WinCE. CERasSvr.exe utilizará essa senha para conectar-se ao computador Windows NT/2000/XP apósretornar 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 automaticamentequando a função é executada 

•  0: Requisitar confirmação antes de disparar a conexãoDialupToCE automaticamente quando a função é executada 

Page 705: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 705/725

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

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

•  Valores de Retorno:

0 Falha, incapaz de discar DialUpToCE.

1 Sucesso, DialUpToCE executado.

•  Exemplos:

Nome do Tag Expressão

  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 WindowsNT/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/XPpara retorno de chamada de um equipamento WinCE e configurando também a conexão TCP/IP.

FindAllDevices(“tagArray”)

Grupo Dial-Up

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Retorna a lista de todos os modems disponíveis e interfaces de conexão direta (COMports) na estação local.

•  Parâmetros:

“tagArray” Nome de um tag de array string recebendo a lista de modemsdisponíveis e interfaces de conexão direta.

Page 706: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 706/725

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

InduSoft Web Studio Página 705

•  Valores de Retorno: Retorna o número de modems e/ou interfaces encontradas.

•  Exemplos:

Nome do Tag Expressão

  Tag FindAllDevices(“SerialConnections[1]”)

FindModem("tagArray")

Grupo Dial-Up

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  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 modemsdiponíveis.

•  Valores de Retorno: Retorna o número de modems encontrados.

•  Exemplos:

Nome do Tag Expressão

  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 oparâmetro strPhonebookEntryOrModem para as funções DialError(), DialStatus(),DialUp(), e HangUp().

HangUp(numType, strPhonebookEntryOrModem)

Grupo Dial-Up

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Page 707: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 707/725

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

InduSoft Web Studio Página 706

Web Thin Client Não suportado

•  Descrição: Finaliza uma conexão dial-up.

•  Parâmetros:

numType Tag Numérico especificando o conteúdo do tagstrPhonebookEntryorModem.

•  0: Phonebook Name•  1: Modem Name•  2: Direct Connection Name

strPhonebookEntryOrModem Tag String contendo Phonebook Name, ModemName, ou Direct Connection Name utilizado para efetuar a conexão. O tag numType especifica qualdesses métodos será utilizado.

•  Valores de Retorno: Essa função retorna os seguintes valores:

0 OK.

-1 Erro: INDRAS.DLL não encontrado

-2 Erro: INDRAS.DLL danificado

-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:

Nome do Tag Expressão

  Tag HangUp(0, “OfficeDialup”)

  Tag HangUp(1, ‘USRobotics_SportsterFaxModem”)

  Tag HangUp(2, “DirectDial”, “Rberton”, “MyPassword”)

PhoneDialUp(strPhoneNumber, OptStrModemName)

Grupo Dial-Up

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

Page 708: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 708/725

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

InduSoft Web Studio Página 707

•  Descrição: Disca para um número de telefone utilizando TAPI  (Telephony Aplication ProgramInterface).

•  Parâmetros:

strPhoneNumber Número do telefone ao qual a função ligará.

OptStrModemName Nome do modem utilizado para discar. Caso você nãoespecifique um modem, o IWS utilizará p primeiro modemencontrado no Sistema Operacional.

•  Valores de Retorno: Essa função retorna os seguintes valores:

0 OK (disdcagem disparada)

-1 Número inválido de parâmetros

-3 Biblioteca INDTAPI.DLL não encontrada 

-4 Função PhoneDialUp() não suportada pela biblioteca atual

INDTAPI.DLL 

•  Exemplos:

Nome do Tag Expressão

PhoneDialUp (“512-123-4567”)

PhoneDialUp (StringPhoneNumberTag)

PhoneDialUp (StringPhoneNumberTag, StringModemNameTag)

PhoneDisableListen(optStrModemName)

Grupo Dial-Up

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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ãoespecifique um modem, o IWS utilizará p primeiro modemencontrado no Sistema Operacional.

•  Valores de Retorno: Essa função retorna os seguintes valores:

Page 709: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 709/725

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

InduSoft Web Studio Página 708

1 OK (pára a resposta para chamadas a serem recebidas)

-1 Biblioteca INDTAPI.DLL não encontrada 

-2 Função PhoneDisableListen() Não suportada pela biblioteca atual

INDTAPI.DLL 

•  Exemplos:

Nome do Tag Expressão

PhoneDisableListen ()

PhoneDisableListen (“Hayes Compatible Modem on COM1”)

PhoneDisableListen (StringModemNameTag)

PhoneEnableListen(OptStrModemName)

Grupo Dial-Up

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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ãoespecifique um modem, o IWS utilizará o primeiro modemencontrado no Sistema Operacional.

•  Valores de Retorno: Essa função retorna os seguintes valores:

1 OK (respondendo chamadas a receber)

0 Erro na execução da função PhoneEnableListen() 

-1 Biblioteca INDTAPI.DLL não encontrada 

-2 Função PhoneEnableListen() Não suportada pela biblioteca atual INDTAPI.DLL 

•  Exemplos:

Nome do Tag Expressão

PhoneEnableListen ()

Page 710: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 710/725

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

InduSoft Web Studio Página 709

PhoneEnableListen (“Hayes Compatible Modem on COM1”)

PhoneEnableListen (StringModemNameTag)

PhoneHangUp(OptStrModemName)

Grupo Dial-Up

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Não suportado

Web Thin Client Não suportado

•  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ãoespecifique um modem, o IWS utilizará o primeiro modemencontrado no Sistema Operacional.

•  Valores de Retorno: Essa função retorna os seguintes valores:

1 OK (a conexão discada foi modificada)

-1 Biblioteca INDTAPI.DLL não encontrada 

-2 Função PhoneHangUp()Não suportada pela biblioteca atual

INDTAPI.DLL 

•  Exemplos:

Nome do Tag Expressão

PhoneHangUp()

PhoneHangUp (“Hayes Compatible Modem on COM1”)

PhoneHangUp (StringModemNameTag)

PhoneStatus ("strStatus", optStrModemName)

Grupo Dial-Up

Execução Síncrona 

Windows NT/2K/XP Suportado

Page 711: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 711/725

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

InduSoft Web Studio Página 710

Windows CE Não suportado

Web Thin Client Não suportado

•  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ãoespecifique um modem, o IWS utilizará o primeiro modemencontrado no Sistema Operacional.

•  Valores de Retorno: Essa função retorna os seguintes valores:

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:

Nome do Tag Expressão

 Tag StatusCode

PhoneStatus (“String Tag Status”)

 Tag StatusCode

PhoneStatus (“String Tag Status”, “Hayes Compatible Modem onCOM1”)

 Tag Status

Code

PhoneStatus (“String Tag Status”, “StringModemNameTag”)

Page 712: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 712/725

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

InduSoft Web Studio Página 711

Funções ActiveXEssa 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 

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

Nome do Tag Expressão

  Tag XGet(“ActXRec”, “Color”)

XRun(strName, strMethod, Parameter1, Parameter2, …, ParameterN)

Grupo ActiveX 

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Executa (Method) no objeto ActiveX especificado.

Page 713: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 713/725

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

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 (nemtodos os métodos retornam resultados).

•  Exemplos:

Nome do Tag Expressão

  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 de0 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 dosparâmetros do componente (Boolean, Integer, String, ou Real).

XSet(strName, strProperties, Value)

Grupo ActiveX 

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 

•  Valores de Retorno: Sem valores de retorno.

Page 714: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 714/725

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

InduSoft Web Studio Página 713

•  Exemplos:

Nome do Tag Expressão

  Tag XSet(“ActXDisplay”, “Display”, “Status Normal”)

Page 715: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 715/725

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

InduSoft Web Studio Página 714

Event Logger FunçõesEssa seção descreve a Função Event Logger do InduSoft Web Studio: SendEvent(strEvent).

SendEvent(strEvent, optBooFlag, optStrComment)

Grupo Event Logger 

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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 arquivoEvent Log.

optBooFlag Se omitido ou igual a 0 (zero), o evento não possui umcomentário. Do contrário, existirá um comentário associadoao evento.

optStrComment String de valor do tag contendo o texto do comentário para oevento salvo no banco de dados. Se omitido, o usuário

receberá um diálogo padrão onde o comentário poderá ser digitado.

•  Valores de Retorno:

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:

Nome do Tag Expressão

  Tag SendEvent(“Valve Open”) // Salva a mensagem de evento.

  Tag SendEvent(“Valve Open Oven No.” + OvenID) // Salva a mensagem deevento concatenada ao valor do tag OvenID

  Tag SendEvent(“Valve Open”, 1) // Exibe um diálogo onde o operador 

Page 716: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 716/725

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

InduSoft Web Studio Página 715

poderá digitar seus comentários.

  Tag SendEvent(“Valve Open”, 1, TagComment) // Salva a mensagem deevento com comentário configurado no tag TagComment.

  Atenção:Essa função é Síncrona. Portanto, a execução dessa função finaliza-se somenteapós os dados do evento (incluindo o comentário, caso exista) estarem salvos noarquivo do banco de dados. É recomendado que você não configure essa função emtarefas background (e.x. Math e Scheduler ), a menos que você não planeje utilizar ocomentário ou configurá-lo diretamente (digitando a partir do diálogo) na função.

Page 717: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 717/725

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

InduSoft Web Studio Página 716

Funções FTPEssa 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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE SuportadoWeb Thin Client Suportado

•  Descrição: Configura parâmetros FTP (File Transfer Protocol). Deve-se configurar essesparâmetros e executar essa função antes de transferor arquivos com funções FtpGet ou FtpPut.

•  Parâmetros:

strServer Nome do server FTP

strUserNome do usuário

Padrão é Anonymous.

strPwnSenha do usuário

Padrão é blank . 

numPassiveMode

0 – Modo passivo desabilitado

1 – Modo passivo habilitado

Padrão é 0.

numPortNúmero da Porta TCP/IP

Padrão é 21. 

•  Valores de Retorno:

0 Sucesso

-1 Número inválido de parâmetros

-2 Nome do server inválido

-3 Nome do usuário inválido

Page 718: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 718/725

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

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:

Nome do Tag Expressão

  Tag CNFFtp(“ftp.mycompany.com”, “admin”, “12345”, 1) // Configura oserver ftp utilizando o modo passive

ftpGet (strRemoteFile , strLocalFile , numOverWrite , numTransferType)

Grupo FTP

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  Descrição: Essa função entrega um arquivo a partir do server FTP e armazena-o sob o nome doarquivo especificado, criando um novo arquivo local. Antes de executar essa função, deve-seconfigurar alguns parâmetros utilizando CNFFtp. Essa função é executada assincronicamente;Portanto, você precisará chamar FtpStatus de modo a determinar se a transferência foicompletada 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 eminúsculas, de maneira que você terá que inserir a capitalizaçãocorreta.

strLocalFileNome 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.

Page 719: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 719/725

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

InduSoft Web Studio Página 718

•  Valores de Retorno:

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 Tipoo de transferência inválida 

•  Exemplos:

Nome do Tag Expressão

  Tag FtpGet(“\Reports\040303.txt”, “C:\Report.txt”) // Entrega o arquivo040303 da pasta Reports no Server FTP e armazena-o no arquivoC:\Report.txt 

ftpPut (strLocalFile , strRemoteFile, numTransferType)

Grupo FTP

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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:

strLocalFileNome 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á queinserir a capitalização correta 

optnumTransferType

0 – Desconhecido

1 – ASCII

2 – Binário

Padrão é 0 .

Page 720: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 720/725

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

InduSoft Web Studio Página 719

•  Valores de Retorno:

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:

Nome do Tag Expressão

  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

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Suportado

•  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.

•  Valores de Retorno:

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 

Page 721: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 721/725

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

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:

Nome do Tag Expressão

  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.

Page 722: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 722/725

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

InduSoft Web Studio Página 721

Funções do Banco de DadosEssa 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

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  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ãoesteja 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.

•  Valores de Retorno:

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.

Page 723: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 723/725

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

InduSoft Web Studio Página 722

•  Exemplos:

Nome do Tag Expressão

  Tag SyncAlarm() //Sincroniza o banco de dados utilizando a data atual

  Tag SyncAlarm(“10/20/2004”) //Sincroniza o banco de dados somentepara o dia 10/20/2004

  Tag SyncAlarm(“10/20/2004”, “10/28/2004”) //Sincroniza o banco dedados de 10/20/2004 até 10/28/2004

SyncEvent( strOptionalStartDate, strOptionalEndDate)

Grupo Database

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Sincroniza o banco de dados alarm [Event, Trend].

•  Parâmetros:

strOptionalStartDate String com a data de início. Caso esse parâmetro nãoesteja 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.

•  Valores de Retorno:

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.

Page 724: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 724/725

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

InduSoft Web Studio Página 723

•  Exemplos:

Nome do Tag Expressão

  Tag SyncEvent() //Sincroniza o banco de dados utilizando a data atual

  Tag SyncEvent(“10/20/2004”) //Sincroniza o banco de dados somentepara o dia 10/20/2004

  Tag SyncEvent(“10/20/2004”, “10/28/2004”) //Sincroniza o banco dedados de 10/20/2004 para 10/28/2004

SyncTrend(numGrupo, strOptionalStartDate, strOptionalEndDate)

Grupo Database

Execução Assíncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Sincroniza o banco de dados alarm [Event, Trend].

•  Parâmetros:

numGrupo Número do grupo Trend

strOptionalStartDate String com a data de início. Caso esse parâmetro nãoesteja 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 deinício.

•  Valores de Retorno:

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.

Page 725: Manual Portugues ISW v6.1sp2-727pag

7/3/2019 Manual Portugues ISW v6.1sp2-727pag

http://slidepdf.com/reader/full/manual-portugues-isw-v61sp2-727pag 725/725

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

•  Exemplos:

Nome do Tag Expressão

  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 dedado somente para o dia 10/20/2004

  Tag SyncTrend(“10/20/2004”, “10/28/2004”) //Sincroniza o grupo 1 dobanco de dados de 10/20/2004 a 10/28/2004

SyncAlarmStatus( )

Grupo Database

Execução Síncrona 

Windows NT/2K/XP Suportado

Windows CE Suportado

Web Thin Client Não suportado

•  Descrição: Retorna o status de sincronização.

•  Valores de Retorno:

3 Sincronização finalizada.

2 Falha na sincronização

1 Ainda sincronizando

0 Sincronização não está sendo executada.

-1 O formato não está configurado para “Database.”

•  Exemplos:

Nome do Tag Expressão