Manual Portugues ISW V6.1sp2-727pag

InduSoft Web Studio v6.
1 A-0

Guia do Usurio e
Manual de
Referncias
Tcnicas

InduSoft Web Studio
6.1

www.iwsdobrasil.com.br

InduSoft Web Studio 6.1 sp2
IWS 20/06/2007
Copyright IWS do Brasil Informtica Ltda.

InduSoft Web Studio

Pgina 1

IWS do Brasil Informtica Ltda.
E-mail: suporte@iwsdobrasil.com.br

Copyright 2007 IWS do Brasil Informtica Ltda.
Todos os direitos reservados.
Este documento registrado e no pode ser reproduzido ou copiado de qualquer forma, sem que seja feita uma
solicitao por escrito IWS do Brasil Informtica Ltda.
Windows, Windows XP, Windows 2000, e Windows NT so marcas registradas da Microsoft Corporation nos
Estados Unidos da Amrica e outros pases.
Todas as outras marcas ou nomes de produtos so registros ou marcas registradas de seus respectivos
fabricantes.

IWS 20/06/2007

InduSoft Web Studio

Pgina 2
Contedo
Sobre essa Publicao.......................................................................................................................... 11
A quem Endereada essa Publicao....................................................................................... 12
Convenes...................................................................................................................................... 12
Convenes de Texto ...............................................................................................................12
Mouse e Convenes de Seleo............................................................................................13
Convenes do Windows.........................................................................................................13
Recursos Adicionais ....................................................................................................................... 15
Trabalhando com Suporte Tcnico.............................................................................................. 15
Captulo 1: O que o InduSoft Web Studio?.................................................................................... 19
Viso Geral do Produto.................................................................................................................. 19
Recursos do Produto...................................................................................................................... 20
Captulo 2: Instalando o InduSoft Web Studio................................................................................. 22
Antes de Comear........................................................................................................................... 22
Instalando o IWS............................................................................................................................. 24
Instalando o CEView...................................................................................................................... 26
Desisntalando o InduSoft Web Studio e CEView....................................................................... 28
Licenciando seu Produto ............................................................................................................... 30
Verses do Produto..................................................................................................................30
Licenas Invlidas....................................................................................................................31
Modos de Execuo........................................................................................................................ 31
Tipos de Proteo............................................................................................................................ 33
Configuraes da Licena.............................................................................................................. 34
Instalando Licenas de Hardkey para o InduSoft Web Studio................................................ 35
Instalando uma Nova Licena................................................................................................35
Atualizando a Licena de Hardkey Atual .............................................................................35
Instalando uma Licena de SoftKey para o InduSoft Web Studio.......................................... 37
Instalando uma Nova Licena................................................................................................37
Atualizando a Licena Atual...................................................................................................39
Instalando uma Licena de SoftKey para CEView .................................................................... 42
Instalando ou Atualizando uma Licena (Localmente) ......................................................42
Instalando ou Atualizando uma Licena (Remotamente) ..................................................45
Captulo 3: Trabalhando com o Ambiente de Desenvolvimento do IWS...................................... 48
Navegando no Ambiente de Desenvolvimento............................................................................ 48
Utilizando a Barra de Ttulo ...................................................................................................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
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 Padro............................................................................................................................ 72
Virtual Keyboard ......................................................................................................................72
Fontes ........................................................................................................................................73
Interface Color ..........................................................................................................................75
Tarefas Comuns de Execuo....................................................................................................... 78
Accessando Projetos e Arquivos.............................................................................................79
Abrindo projetos.......................................................................................................................79
Abrindo arquivos......................................................................................................................80
Fechando projetos....................................................................................................................80
Fechando arquivos...................................................................................................................80
Utilizando Botes Comuns .....................................................................................................80
Utilizando Select All .................................................................................................................82
Cortar, Copiar, Colar Objetos.................................................................................................82
Encontrando Informaes do Sistema..................................................................................83
Pesquisando Tags - Utilizando a opo cone Find.............................................................84
Utilizando a opo Go To ........................................................................................................84
Utilizando a Barra de Ferramentas Tag Properties ............................................................85
Utilizando o cone Object Finder............................................................................................85
Utilizando a opo X-ref..........................................................................................................86
Utilizando a opo Global Tags Replace...............................................................................86
Substituindo Tags....................................................................................................................87
Testando Exibies ..................................................................................................................89
Verificando a Aplicao...........................................................................................................89
Rodando Aplicaes.................................................................................................................90
Restaurando Padres...............................................................................................................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 parmetros do tipo de origem.......................................................95
passo 3: Filtrar os tags............................................................................................................96
IWS 20/06/2007

InduSoft Web Studio

Pgina 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
Mdulos de Desenvolvimento ..................................................................................................... 108
Grficos....................................................................................................................................108
Tarefas .....................................................................................................................................109
Comunicaes Gerais................................................................................................................... 110
Captulo 4: Compreendendo a Estrutura do IWS.......................................................................... 111
Compreendendo a Estrutura Interna e o Fluxo de Dados..................................................... 111
Executando/Mudando Mdulos do IWS................................................................................... 113
Executando/Alternando o Background Task........................................................................... 118
Captulo 5: Trabalhando com Tags .................................................................................................. 121
O que um Tag?........................................................................................................................... 121
Projetando um Tag ....................................................................................................................... 122
Escolhendo o Tipo de Tag .....................................................................................................122
Tags bsicos............................................................................................................................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 Aplicao........................................................................................... 129
Adicionando Tags para a Planilha da Aplicao ...............................................................130
Adicionando Tags On-the-Fly............................................................................................131
Reiniciando o Tags database................................................................................................132
Criando Classes ............................................................................................................................ 132
Configurando Propriedades de Tag............................................................................................ 134
Configurando os Parmetros de Propriedades do Tag .....................................................136
Configurando os Alarmes Tab de Propriedades de Alarmes ........................................137
Configurando Propriedades do Histrico............................................................................139
Utilizando Tags em Sua Aplicao............................................................................................. 140
Editando Tags ...............................................................................................................................140
Do Datasheet de Tags da Aplicao ....................................................................................141
Da pasta Tag List ...................................................................................................................141
Deletando Tags.............................................................................................................................. 142
IWS 20/06/2007

InduSoft Web Studio

Pgina 5
Captulo 6: Criando e Configurando um Projeto............................................................................ 143
Criando Aplicao para um Novo Projeto ................................................................................. 143
Especificando a Resoluo Padro de uma Tela...............................................................146
Compartilhando Tags de Banco de Dados do Programa de Controle Baseado em PC147
Especificando Configuraes de Projeto Adicionais................................................................ 149
Provendo informaes de Identificao do Projeto............................................................150
Configurando as Parmetros do Tab Options ...................................................................150
Habilitando Traduo de Linguagem..................................................................................153
Especificando o nvel de licena para Target System.......................................................154
Salvando arquivos histricos de alarme.............................................................................155
Compartilhando tags com aplicao de controle baseada em pc...................................155
Communicao com Drivers e OPC (Buffer) ......................................................................155
Especificando um porta TCP................................................................................................155
Configurando configuraes do banco de dados para salvar histricos de
Alarme/evento..................................................................................................................156
Janela do Dilogo Database Configuration........................................................................156
Configurando um Banco de Dados Padro para Todos os Histricos de Tarefas........160
Configurando os Parmetros da rea de Trabalho de Runtime .....................................161
Configurando os Parmetros de Comunicao .................................................................165
Configurando Seu Projeto para Acesso Remoto a Web....................................................166
Especificando Parmetros Web Thin Client.......................................................................169
Habilitando Mensagens de Aviso.........................................................................................172
Iniciando Mdulos de Runtime no Target system................................................................... 174
Captulo 7: Configurando Telas e Grficos ..................................................................................... 178
Trabalhando em um Ambiente Orientado pelo Objeto........................................................... 178
Trabalhando com Atributos de Tela .......................................................................................... 179
Especificando Cores de Background......................................................................................... 184
Utilizando Objetos e Dinmicas ................................................................................................. 185
Utilizando a Barra de Ferramentas Mode ..........................................................................185
Utilizando a Barra de Ferramentas Align e Distribute.....................................................187
botes Object Alignment .......................................................................................................188
botes Changing Object Layers ...........................................................................................191
Botes 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 6
Pasta Symbols ........................................................................................................................290
Captulo 8: Configurando Planilhas de Tarefas ............................................................................. 291
Configurando uma Tarefa de Alarme ........................................................................................ 292
Configurando uma Tarefa Trend................................................................................................ 302
Convertendo Arquivos Histricos de Trend de Binrio para Texto ................................310
Convertendo Arquivos Histricos Trend de Texto para Binrio......................................311
Criando Histricos 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
Captulo 9: Configuraes de Evento............................................................................................... 322
Configurando Parmetros de Eventos...................................................................................... 323
Captulo 10: Comunicao ................................................................................................................ 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 Parmetros Customizados...........................................................................349
Configurando TCP/IP Server................................................................................................350
Configurando DDE....................................................................................................................... 350
Configurando DDE Client .....................................................................................................350
Configurando DDE Server ....................................................................................................351
Captulo 11: Configurando um Sistema de Segurana................................................................. 353
Inserindo uma Senha............................................................................................................353
Definindo Grupos ......................................................................................................................... 354
Definindo Usurios....................................................................................................................... 358
Sistema de Segurana Remoto ............................................................................................366
Configurando o Nvel de Acesso de Segurana..................................................................367
Definindo Usurios....................................................................................................................... 368
Especificando Usurios Guest .............................................................................................368
Logging On/Off ............................................................................................................................. 369
Captulo 12: Testando e Corrigindo Erros em Sua Aplicao...................................................... 370
Testando sua Aplicao............................................................................................................... 370
Corrigindo Erros da Aplicao a partir do Database Spy ...................................................... 371
Corrigindo Erros da Aplicao a partir da Janela Output..................................................... 372
IWS 20/06/2007

InduSoft Web Studio

Pgina 7
Utilizando o Mdulo LogWin (NT e CE) ..................................................................................... 374
Utilizando Ferramentas Remotas............................................................................................... 376
Utilizando Database Spy Remoto ........................................................................................377
Utilizando LogWin Remoto....................................................................................................377
Captulo 13: Configurando uma Web Solution.............................................................................. 378
Antes de Comear......................................................................................................................... 380
Definindo um Diretrio Home..............................................................................................380
Instalando e Registrando ISSymbol.ocx .............................................................................380
Rodando o Web Server ..........................................................................................................381
Rodando O TCP/IP Server ....................................................................................................383
Testando a Aplicao ................................................................................................................... 387
Captulo 14: Gerenciando Aplicaes Remotamente..................................................................... 390
Fazendo o Download da Aplicao............................................................................................. 390
Configurando a Target station.............................................................................................390
Configurando a Estao de Desenvolvimento ...................................................................391
Monitorando/Gerenciando Aplicaes a partir de uma Estao Remota ........................... 395
Captulo 15: Linguagens de Script: IWS e VBScript ..................................................................... 396
Trabalhando com com Linguagem de Script do IWS, Expresses e Funes..................... 396
Utilizando Tags.............................................................................................................................. 396
Especificando Tipos de Dados .................................................................................................... 396
Acessando Tag database.......................................................................................................397
Operaes Aritimticas..........................................................................................................397
Operaes Lgicas..................................................................................................................398
Utilizando Funes....................................................................................................................... 398
Viso Geral do VBScript .............................................................................................................. 400
VBScript no IWS ........................................................................................................................... 400
Global Procedures..................................................................................................................402
Graphic Module - Graphics Script ......................................................................................403
Graphic Module - Screen Script ..........................................................................................405
Graphic Module Dinmica Command .............................................................................406
Graphic Module - ActiveX Events........................................................................................407
Tarefa Background - Startup Script ...................................................................................410
Tarefa Background Grupos Script....................................................................................411
Referncia de Linguagem............................................................................................................ 413
Constantes ..............................................................................................................................413
Erros.........................................................................................................................................417
Funes ...................................................................................................................................420
Palavras-Chave.......................................................................................................................421
Mtodos....................................................................................................................................421
Objetos e Colees .................................................................................................................421
Operadores..............................................................................................................................423
Propriedades ...........................................................................................................................424
IWS 20/06/2007

InduSoft Web Studio

Pgina 8
Demonstraes.......................................................................................................................425
Dicas e Truques ............................................................................................................................ 427
VBScript Editor - IntelliSense ..............................................................................................427
VBScript comparado a VBA..................................................................................................429
Eventos de Tela.......................................................................................................................430
Funes 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 Variveis.................................................................................433
Declarando Variveis.............................................................................................................433
Criando Constantes...............................................................................................................434
Precedncia de Operadores VBScript .................................................................................434
Utilizando Demonstraes Condicionais............................................................................435
Executando em Loop Atravs do Cdigo ............................................................................437
Procedimentos em VBScript .................................................................................................440
Captulo 16: Utilizando a Ferramenta/Editor de Traduo......................................................... 442
Configuraes do Projeto para Traduo Automtica ............................................................ 443
Configurando Object Properties para Objetos de Tela .....................................................444
Translation Editor ........................................................................................................................ 445
Editando Planilhas.................................................................................................................446
Salvando suas planilhas.............................................................................................................. 448
Executando as Funes de Traduo........................................................................................ 448
Utilizando SetTranslationFile(strFileName).....................................................................449
Utilizando Ext(strText)........................................................................................................451
Fechando o Translation Editor................................................................................................... 451
Captulo 17: Interface Banco de Dados do IWS............................................................................. 452
Conceitos Gerais........................................................................................................................... 453
Banco de Dados Relacionais SQL........................................................................................453
Formato Histrico ..................................................................................................................455
Bancos de Dados Primrios e Secundrios .......................................................................456
Banco de Dados Padro ........................................................................................................457
Estabelecendo Link do Banco de Dados atravs de um DB Provider Remoto .............458
Configurando Parmetros dos Bancos de Dados .................................................................... 459
Dilogo Database Configuration..........................................................................................460
Studio Database Gateway ........................................................................................................... 463
Resolvendo Problemas do Banco de Dados.............................................................................. 474
Database FAQ.........................................................................................................................474
Apndice do Banco de Dados A: Utilizando Banco de Dados ODBC ................................... 478
Apndice do Banco de Dados B: Utilizando Microsoft SQL Server....................................... 479
Apndice do Banco de Dados C: Utilizando Banco de Dados ORACLE............................... 481
IWS 20/06/2007

InduSoft Web Studio

Pgina 9
Apndice do Banco de Dados D: Utilizando Banco de Dados de Acesso da Microsoft...... 483
Apndice do Banco de Dados E: Utilizando SQL Server CE.................................................. 484
Apndice do Banco de Dados F: Utilizando Sybase ................................................................ 485
Apndice do Banco de Dados G: Utilizando Microsoft Excel ................................................. 485
Apndice do Banco de Dados H: Utilizando MySQL............................................................... 489
Captulo 18: Web Solution................................................................................................................. 491
Camada de Controle ISSymbol................................................................................................... 492
Como Funciona............................................................................................................................. 493
Configurando uma Aplicao Baseada na Web....................................................................... 494
Arquiteturas Tpicas..................................................................................................................... 495
Arquitetura 1: Web server e Web Thin Clients em uma mesma rede de trabalho ......495
Arquitetura 2: Web server e Web Thin Client sem uma mesma rede de trabalho; web
server e data server em estaes diferentes ................................................................497
Arquitetura 3: Servidores Redundantes e Web Thin Client stations na mesma rede de
trabalho.............................................................................................................................499
Arquitetura 4: Web server e Web Thin Clients em redes de trabalhos diferentes.......501
Captulo 19: Correo de Problemas................................................................................................ 504
Antes de entrar em contato com o Suporte Tcnico ............................................................... 504
Verificando sua Aplicao ........................................................................................................... 505
Erros Comuns ...............................................................................................................................506
Banco de Dados & Sistema de Segurana.........................................................................506
Grficos....................................................................................................................................507
Tarefas .....................................................................................................................................508
Comunicao ..........................................................................................................................509
Resoluo de Erros Gerais....................................................................................................510
Apndice A. Funes do InduSoft Web Studio............................................................................... 516
Prottipos e Descries de Funes........................................................................................... 527
Funes Log Message................................................................................................................... 528
Funes Aritimticas.................................................................................................................... 529
Funes Estatsticas .................................................................................................................... 542
Funes Logartimicas................................................................................................................. 546
Funes Lgicas............................................................................................................................ 548
Funes String.............................................................................................................................. 551
Funes Data e Hora.................................................................................................................... 569
Funes Trigonomtricas ............................................................................................................ 575
Abrindo e Fechando Janelas....................................................................................................... 580
Funes de Segurana................................................................................................................. 583
Funes do Mdulo Atividade..................................................................................................... 590
Funes de Arquivo...................................................................................................................... 613
Funes Grficas .......................................................................................................................... 631
Funes de Traduo................................................................................................................... 635
Funes Multimdia...................................................................................................................... 637
IWS 20/06/2007

InduSoft Web Studio

Pgina 10
Funes Informaes do Sistema............................................................................................... 638
Funo Loop.................................................................................................................................. 660
Funo Database Access............................................................................................................. 661
Funes ODBC.............................................................................................................................. 662
Funes Mail ................................................................................................................................. 683
Funes Dial-Up........................................................................................................................... 689
Funes ActiveX............................................................................................................................ 711
Event Logger Funes.................................................................................................................. 714
Funes FTP.................................................................................................................................. 716
Funes do Banco de Dados....................................................................................................... 721

IWS 20/06/2007

InduSoft Web Studio

Pgina 11
Sobre essa Publicao
Esse Guia do Usurio e Referncias Tcnicas foi projetado para ajud-lo a obter os melhores resultados, a
partir da utilizao de seu software InduSoft
Web Studio. Essa publicao prove informaes e instrues

tcnicas passo a passo, para todas as tarefas que necessitem criar Aplicaes HMI/SCADA habilitadas para
Web.
As informaes nessa publicao organizada em captulos, da seguinte forma:
Esse Captulo: Descreve o propsito, contedo e organizao do Guia do Usurio e Referncias
Tcnicas do IWS. Alm disso, esse Captulo contm as seguintes informaes:
o Explica como formatar e utilizar o mouse e as convenes do Windows
o Cita outras publicaes, as quais fornecem informaes sobre o InduSoft Web Studio
o Explica como entrar em contato com os representantes do suporte tcnico da InduSoft
Captulo 1. Sobre o InduSoft Web Studio Fornece uma viso geral de alto nvel sobre a
utilizao do produto, assim como seus recursos e Funes.
Captulo 2. Instalando o InduSoft Web Studio: Fornece instrues passo a passo para
instalao, licenciamento, inicializao e desinstalao tanto do InduSoft Web Studio quanto do
CEView.
Captulo 3. Trabalhando com o Ambiente de Desenvolvimento do IWS: Descreve a interface do
InduSoft Web Studio (ou ambiente de desenvolvimento), alm de explicar algumas habilidades
tcnicas bsicas que devem ser compreendidas, antes da criao de uma nova Aplicao.
Captulo 4. Compreendendo a Estrutura do IWS: Descreve a estrutura interna do InduSoft
Web Studio, incluindo como ocorre o fluxo de dados atravs dos mdulos de runtime, alm de
prover informaes sobre como esses mdulos so executados.
Captulo 5. Trabalhando com Tags: Explica coiceitos bsicos sobre o banco de dados do
produto, os tipos de tags (arrays, classes e pointers), valores e parmetros de tags. Seguindo os
conceitos da discusso, esse Captulo fornece instrues para criar e editar tags para suas
Aplicaes.
Captulo 6. Criando e Configurando um Projeto: Fornece funes passo a passo para criar e
configurar um novo projeto na Aplicao.
Captulo 7. Configurando Telas e Grficos: Explica como utilizar as diferentes ferramentas de
desenvolvimento do InduSoft Web Studio para a criao das telas e dos grficos de sua
aplicao.
Captulo 8. Configurando Planilhas de Tarefa: Explica como criar e configurar as diferentes
planilhas de tarefas no InduSoft Web Studio para as Aplicaes de seus projetos.
Captulo 9. Configuraes de Evento. Descreve o logging e os recursos de entrega de eventos.
Captulo 10. Comunicao: Desscreve como configurar o InduSoft Web Studio para ler e
escrever as variveis de tags de sua aplicao, para ou a partir da memria do equipamento. As
informaes incluem instrues para configurao de drivers de comunicao OPC, TCP/IP, e
DDE (troca de dados dinmicos).
Captulo 11. Configurando um Sistema de Segurana: Explica como configurar e gerenciar um
sistema de segurana para suas Aplicaes.
Captulo 12. Testando e Corrigindo Erros de sua Aplicao: Discute como testar e corrigir erros
de suas Aplicaes utilizando ferramentas como Database spy e output window. Esse Captulo
inclui uma lista de possveis mensagens de erro, alm de mtodos para corrigir tais erros..
Captulo 13. Configurando a Web Solution: Explica como configurar e rodar sua Aplicao na
Web.
Captulo 14. Gerenciando Aplicaos Remotamente: Explica como fazer download, monitorar e
corrigir erros das Aplicaes, a partir de estao de trabalho de runtime remota.
IWS 20/06/2007

InduSoft Web Studio

Pgina 12
Captulo 15. Trabalhando com a Linguagem de Script do IWS, Expresses e suas Funes:
Descreve a sintaxe da linguagem de script do InduSoft Web Studio, que inclue mais de
200 Funes.
Captulo 16. Utilizando O Editor de Traduo: Explica como utilizar o Editor de Traduo para
traduzir o texto em suas Aplicaes, de uma lngua para alguma outra.
Captulo 17. Interface do Banco de Dados do IWS: Explica como conectar o InduSoft Web
Studio a banco de dados compatveis.
Captulo 18. Soluo da Web: Explica como utilizar o Web Thin Client para visualizar a
interface grfica em uma estao remota.
Captulo 19. Resolvendo Problemas: Fornece instrues para verificao de Aplicaes, descreve
alguns erros de desenvolvimento comuns e explica o que fazer caso seja necessrio entrar em
contato com um representante da equipe de suporte.
Apndice As. Funes do Studio: Contm tabelas e informaes, as quais descrevem as
diferentes funes disponveis tanto no InduSoft Web Studio como no CEView.
A quem Endereada essa Publicao

Esse Guia do Usurio e Manual de Referncias Tcnicas um documento destinado a ser de fcil
compreenso, fornecendo informaes teis tanto para novatos quanto para usurios experientes do
InduSoft Web Studio.
Novos Usurios: Essa publicao utiliza procedimentos passoa a passo para o processo de
desenvolvimento da Aplicao. Certifique-se de que os captulos de introduo tenham sido lido
e compreendidos, os quais descrevem os recursos do produto e seu ambiente de
desenvolvimento.
Usurios Experientes: Essa publicao oferece instrues avanadas, dicas e informaes
sobre correo de erros para ajudar na obteno de resultados satisfatrios nas Aplicaes
construdas no seu produto.
Nota:
Ns assumimos que voc esteja familiarizado com o ambiente de trabalho do
Windows. Caso voc desconhea alguma de suas funes de procedimento,
recomendamos a utilizao do recurso Help (Start Help) ou consultar a
documentao de seu Microsoft Windows.

Convenes

Essa seo descreve o texto, mouse e as convenes do Windows utilizadas em todas as publicaes da
InduSoft.

Convenes de Texto

As seguintes convenes de texto e tcnicas de formatao so utilizadas nessa publicao para
auxlio na identificao rpida de certos tipos de informaes:
Nome de arquivos e texto tela/mensagem so indicados com a utilizao do texto bold,
monospace (por exemplo: \DRunStartup.exe).
IWS 20/06/2007

InduSoft Web Studio

Pgina 13
Quando informaes so solicitadas, tais como um nome de arquivo, uma entrada indicada
entre brackets < > e indicam a utilizao 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.
Botes, opes de menu e teclas do teclado esto indicados para a utilizao de uma typeface
narrow bold (por exemplo, Aperte a tecla Enter.)
O texto que requer nfase especial (como advertencias, novos termos, ou nomes do produto)
indicado pela utilizao de itlicos para chamar sua ateno para aquele item (por exemplo, Do
not save the file.)
Alm disso, essa publicao separa alguns textos em boxes Tip, Note, e Caution para auxilixar
na identificao rpida e fcil de informaes.
o Tips (B) fornece informaes teis para salvar o perodo de desenvolvimento ou para
melhorar a performace da aplicao.
o Notes () fornece informaes relacionadas ao texto ao redor (geralmente o pargrafo que
precede a nota) para auxiliar na obteno de maiores informaes para a compreenso de
um conceito ou para o fornecimento de informaes adicionais.
o Cautions (C) fornece informaes necessarias para a preveno de erros que podem causar
problemas quando a aplicao estiver rodando, podendo resultar em danos para a
aplicao.
Mouse e Convenes de Seleo
Em razo de a minoria dos PCs utilizados para o desenvolvimento da aplicao rodarem uma verso
do Windows que requer a utilizao de um mouse, essa publicao partir do princpio de que o
usurio esteja utilizando um mouse. Geralmente, o mouse do PC configurado de forma tal que o
boto esquerdo do mouse o boto principal, sendo o boto da direita para uso secundrio.
Essa publicao utiliza as seguintes convenes de seleo e mouse:
Double-click significa clicar duas vezes em um objeto com o boto esquerdo do mouse.
Right-click significa clicar uma vez no objeto com o boto direito do mouse.
Click e Select significa clicar uma vez no objeto com o boto esquerdo.
Em geral, voc deve clicar nos botes e selecionar a partir das listas.
Select tambm significa que voc deve utilizar seu equipamento para evidenciar ou especificar
um item na tela do computador. Selecionar um objeto com um toque na tela usualmente igual
a selecionar o objeto com o mouse, exceto ao tocar (selecionar) um objeto de tela ou seo. Para
selecionar objetos com seu teclado, deve-se utilizar tipicamente a tecla Tab para circular pelas
opes, 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 boto apropriado do mouse e mov-lo antes de soltar o boto.
Geralmente uma sombra do objeto move-se juntamente ao cursos do mouse.
Para instrues sobre como selecionar mltiplas barras de menu e/ou opes de menu, utilize
as setas para ilustrar a seqncia de seleo. Por exemplo, caso voc vizualize . . .
Selecione Start Programs InduSoft Web Studio Register para registrar seu produto.
. . . voc deve clicar no boto Start do Windows, selecionar a opo Programs selecionar a opo
InduSoft Web Studio e a opo Register.
Convenes do Windows
Essa publicao utiliza as seguintes convenes do Windows:
Dialog boxes (ou dilogos) so janelas que permitem inserir informaes.
Text boxes (ou campos) so reas em um dilogo, onde voc pode alterar o texto.
IWS 20/06/2007

InduSoft Web Studio

Pgina 14
Radio buttons so crculos brancos nos quais o ponto em preto aparece ou desaparece,
quando clica-se no boto. O ponto indica que a opo ou funo est enabled (ativada). O
crculo em branco indica que a opo/funo est disabled (inativada).
Check-boxes so quadrados brancos nos quais um visto de verificao ( ) aparece ou
desaperece ao serem selecionados. O visto de verificao indica que a opo ou funo est
enabled (ativada) e quadrado em branco indica opo/funo disabled (inativada).
Buttons so boxes contendo texto ou grficos que executam uma ao juntamente ao
programa. Os botes aparecem como pressionados quando clicados.
Tipo do Boto Descrio

Clique para executar uma ao.
Por exemplo, clque em Save para salvar seu projeto ou clique em
Cancel para cancelar a operao em andamento.

Clique em um boto contendo texto com reticncias (...) para abrir o
dilogo a ele relacionado.
Por exemplo, clique no boto Options para abrir o dilogo Options.

Clique para executar uma ao.
Por exemplo, clique no boto Open Library para abrir o dilogo Symbol
Library.

Alguns botes esto duplicados, o que significa que clicar o boto um
recurso, modo ou exibio on/off particular.
Por exemplo, clique no boto Output Window para alterar entre on/off
na output window (LogWin), na janela do ambiente de desenvolvimento.

Tabela de Exemplos de Botes
Lists so painis (boxes brancas ) em janelas ou dilogos contendo duas ou mais opes
selecionveis.
Combo-Boxes so 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 so janelas que podem se mover para uma interface, e juntar-se a ela.
Toolbars so janelas dockable que contm somente botes e caixas de texto.
IWS 20/06/2007

InduSoft Web Studio

Pgina 15
Recursos Adicionais
Para maiores informaes sobre o InduSoft Web Studio, esto disponveis os seguintes recursos:
Recurso Descrio
Publicaes
Relacionadas
Guia Inicial do InduSoft Web Studio: Projetado para usurios
novatos, essa publicao contm informaes sobre as
Funes bsicas do InduSoft Web Studio. Essa publicao
fornecida na pasta de Documentao, no CD-ROM do IWS ou
no menu Help localizado na barra de menu principal.
Guias do Usurio de Drivers Individuais: Explica como
configurar drivers individuais InduSoft, de acordo com suas
caractersticas nicas de protocolo. Um guia do usurio
costumizado est includo em cada driver InduSoft. Essas
publicaes so fornecidas no subdiretrio DRV da pasta do
InduSoft Web Studio, no CD-ROM do IWS ou no menu Help
localizado na barra de menu principal.
Perguntas Freqntes Sobre o InduSoft Web Studio (FAQ): Lista
a maioria das perguntas geralmente questionadas, com
respostas sobre o InduSoft Web Studio.
Site da InduSoft Visite o site www.InduSoft.com para mais informaes sobre os
produtos InduSoft, downloads e demos disponveis, FAQ do
produto, informaes de driver, oportunidades de treinamento,
distribuidores, alm das ltimas novidades da InduSoft.

Tabela de Informaes sobre Recursos
Trabalhando com Suporte Tcnico
Os engenheiros especializados em suporte da InduSoft esto empenhados em resolver quaisquer dvidas e
questes a respeito dos produtos rpida e acuradamente. Nossos centros de suporte tcnico localizam-se
em Austin, Texas e So Paulo, Brasil.
Suporte Contato
Austin, Texas Telefone: 877-INDUSOFT (877-463-8763)
Fax: 512-349-0375
Email: support@indusoft.com
So Paulo, Brasil Telefone: +55 11 3849-2000
Fax: +55 11 3849-2000 ext. 26
Email: suporte@iwsdobrasil.com.br

Nossas opes de suporte tcnico incluem:
Suporte Eletrnico
Suporte via telefone
Atualizao das verses do Produto
IWS 20/06/2007

InduSoft Web Studio

Pgina 16
Acesso pgina da IWS para suporte tcnico (http://www.iwsdobrasil.com.br)
Sistema FaxBack
Ao requisitar suporte tcnico, por favor tenha as seguintes informaes em mos:
Nome do Contratante
Informaes para Contato

Mtodo de contato de
preferncia
E E-mail E Telefone E Celular E Outro
Setor Industrial (Por exemplo
Automotivo, Farmacutico,
Fabricante):

Nmero de estaes
supervisionadas:
E Uma E Duas E Trs E Outras

Campo do Equipamento (Por exemplo, Allen Bradley Data Highway Plus):
Fabricante:
Modelo:
Quantidade:
Protocolo:
Driver(s) da InduSoft:

Ambiente do Computador:
Tpico Sub-Item Caractersticas
Hardware Hardware 32-bit
Workstation

Vendedor

Nmero do
Modelo

Procesador

Relgio

Memria RAM

Outras informaes com as quais nossos engenheiros podem
colaborar sobre o hardware:

IWS 20/06/2007

InduSoft Web Studio

Pgina 17
Ambiente do Computador (cont.):
Software Hardware do
Sistema
Operacional

Tipo
Verso
Pacote de
Servios

Linguagem
colaborar sobre o software:

Software Microsoft Internet
Explorer
Hardware

Software
Verso
Pacote de
Servios

Linguagem
colaborar sobre a instalao do Microsoft Internet Explorer:

Software InduSoft
Hardware

Software
Verso
Pacote de
Servios

colaborar sobre a instalao do Indusoft:

IWS 20/06/2007

InduSoft Web Studio

Pgina 18

Ambiente do Computador (cont.):

Software CEView
Hardware

Software
Verso
Pacote de
Servios

colaborar sobre a instalao do CEView:

Descrio do Problema:

Formulrio de Informaes sobre o Cliente

IWS 20/06/2007

InduSoft Web Studio

Pgina 19
Captulo 1: O que o InduSoft Web Studio?

O InduSoft Web Studio (IWS) um programa de software poderoso, completo e integrado, o qual permite o
desenvolvimento e construes com recursos ricos de IHMs (Interfaces Homem-Mquina (Human-Machine
Interface) ou Aplicaes em SCADA (Controle Supervisrio e Aquisio de Dados) para:
Aquisio de dados
Estaes de Superviso Locais
Estaes de Superviso Remotas
Concentradores de Dados em processos distribudos
Comunicao de dados com sistemas da corporao
Viso Geral do Produto
As aplicaes IWS rodam em microcomputadores conectados em tempo real com mquinas ou
processadores atravs de controladores programveis, equipamentos remotos de I/O e outros equipamentos
para aquisio de dados.
Essas aplicaes consistem em telas de interface operadoras, drivers de PLC configurvel (controlador lgico
programvel). Alm de outros equipamentos I/O controlveis, contm um banco de dados de tags da
aplicao e mdulos opcionais, como monitores de alarme, lgica, trend charts, recipes, schedulers, e um
sistema de segurana. A interface da Aplicao do IWS com sistemas I/O industriais e outras aplicaes em
modo runtime utilizam os seguintes protocolos:
ODBC (Open Database Connectivity)
DDE (Dynamic Data Exchange)
NetDDE (Network Dynamic Data Exchange)
OPC (Open Connectivity)
TCP/IP (Transmission Control Protocol/Internet Protocol)
Aps o desenvolvimento de uma aplicao, pode-se rod-la em sua estao de trabalho de desenvolvimento
ou fazer um download da aplicao para uma estao de trabalho em runtime (utilizando uma conexo
TCP/IP ou em srie) e assim rod-la com a utilizao dos softwares InduSoft Web Studio ou CEView. A
estao de trabalho processa dados escaneados dos equipamentos conectados, de acordo com parmetros
definidos na Aplicao, os quais processam, exibem, armazenam e atualizam dados.
O InduSoft Web Studio consiste de:
Software para Sistema de Desenvolvimento que roda em uma rea de trabalho, laptop ou PC
industrial que rode Windows
NT/2000/XP
Software de Sistema de Runtime que roda em uma estao 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 necessrio, voc pode
atualizar a verso do CEView do software do sistema de desenvolvimento, fazendo
o download da verso atual para a IHM.

IWS 20/06/2007

InduSoft Web Studio

Pgina 20
Recursos do Produto
O InduSoft Web Studio fornece os seguintes recursos:
Ambiente de Desenvolvimento integrado, com barra de ferramentas, dilogos e menus;
o Menus de atalho, os quais podem ser acessados dando um clique com o boto direito do
mouse em qualquer area do ambiente de desenvolvimento (As opes variam de acordo com
o contexto)
o Barra de ferramentas customizveis e flutuantes
o Tarefas, objetos e controles organizados em um explorador tree-view
Objetos com muito recursos e dinmicos (habilidade para modificar propriedades do objeto,
executar comandos ou inserir valores para tags utilizados na construo de telas em runtime):
o Objetos configurveis, como botes, retngulos, elipses, polgonos, linhas e texto
o Propriedades Dinmicas, como grficos de barras, colorao, redimensionamento, posio,
exibir/no exibir, rotao, comando, hyperlink e texto de entrada/sada
o Lista de alarmes histricos exibida Online
o Trending histrico e Online
o Ferramentas de Alinhamento e Distribuio
o Criar e editar Camada de fundo de bitmap
o Importao de Grficos
o Caixas para objeto ActiveX
Gerenciamento e configurao remotos e Online
Arquitetura complacente a Microsoft, com OPC complete e suporte XML
Interface na Web habilitada, a qual exporta telas da Aplicao para um thin client atravs da
Internet/intranet e por troca de dados online atravs do protocolo TCP/IP
Biblioteca de Smbolos, com mais de 100 smbolos e objetos dinmicos, como pushbuttons,
meters, sliders, switches, text e exibies nmericas, indicadores LED-style, tubulao,
bombas, icons, veculos, vlvulas, molduras, motores, medidores e controles comuns
Ferramentas de Correo de erros:
o Janela Database Spy para monitorar/forar valores de tag e executar funes
o Mdulo de LogWin para gravar OPC, DDE, e transaes TCP/IP, ativao de mdulos, tags
de log, etc
o Referncia cruzada para locar tags atravs do projeto
o Sistema Online e diagnsticos de rede de trabalho
Tags Database poderosos e flexveis (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 traduo, o qual capacita a traduo da Aplicao para vrias linguagens diferentes,
alm de alter-las enquanto o sistema de runtime est online
Mdulos 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 padro como MODBUS RTU/ASCII,
DeviceNet, Profibus, Interbus, etc
OPC Server e OPC Client com Browser OPC integrado
Segurana de runtime atravs de senhas para Telas e Objetos (256 nveis)
Expresses de lgicas e uma linguagem de script com mais de 200 funes
IWS 20/06/2007

InduSoft Web Studio

Pgina 21
Construtores de Receita e Relatrio (nos formatos ASCII, UNICODE, e RTF) integrados no
produto
Calendrios de evento baseado em data, hora e condio dos dados (resoluo de 100ms)
Aplicao com multi-camadas, significando que planilhas modulares e telas podem juntar-se
facilmente a outras Aplicaes
Integrao completa com programas de controle baseados em PC (banco de dados para
importao de tags) como ISaGRAF, SteepleChase, Think&Do, e ASAP
Funes Dial-Up para disparar, monitorar e manipular uma conexo dial-up com o RAS Server
das estaes remotas
Funes para enviar email a partir do IWS (ou CEView)
Documentao do Projeto em tempo real
Conversor de resoluo de tela
Nota:
O IWS fornece diferentes tipos de produtos, de acordo com cada nvel da aplicao a ser
construda. Porm, o IWS no suporta alguns recursos em certos tipos do produto
(como o CEView). Pode-se revisar a documentao TargetVersions.pdf no CD-ROM do
InduSoft Web Studio para informaes mais detalhadas sobre as limitaes de cada um
dos produtos.

IWS 20/06/2007

InduSoft Web Studio

Pgina 22
Captulo 2: Instalando o InduSoft Web Studio
Esse captulo explica como instalar, licenciar, rodar e desinstalar o InduSoft Web Studio (IWS) e o
CEView.
Pode-se instalar o IWS a partir do CR-ROM do InduSoft Web Studio CD-ROM ou criar disquetes de
instalao de 3.5 polegadas. Para aplicaes do Windows CE, pode-se utilizar o IWS para fazer um
download do CEView (software de runtime) para a IHM do Windows CE HMI por link serial ou TCP/IP.
O programa de instalao do IWS cria automaticamente os diretrios necessaries, copia arquivos para seu
drive do harware e cria o cone InduSoft Web Studio em sua pasta Desktop.
Notas:
Caso voc esteja utilizando o Windows CE:
Para utilizar o IWS para fazer um download do CEView (o software de runtime)
para a IHM do Windows CE utilize um link serial ou TCP/IP.
Ao instalar o InduSoft Web Studio em computadores com Windows NT/2000/XP, o
IWS armazena os arquivos de runtime do CEView runtime nas seguintes pastas:
<InduSoft Web Studio Folder>\Redist\CEView\<Processou Type>\
Onde:
<Installation Folder> o diretrio de instalao escolhido durante a instalao
(C:\Program Files\InduSoft Web Studio o diretrio de instalao padro).
<Processor Type> a plataforma do processador. A InduSoft fornece um runtime do
CEView para a maioria das plataformas de processados suportadas pelo sistema
operacional WinCE.

Antes de Comear

Nota:
Deve-se ter privilgios de Administrador para estaes 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 verses mais antigas e instale aquelas mais recentes em um
diretrio diferente). Alm disso, no pode-se instalar a mesma verso do IWS em dois caminhos
diferentes de um mesmo computador.
Requerimentos do Sistema
Para desenvolver aplicaes do IWS, deve-se instalar os seguintes hardwares e softwares:
o Computador IBM compatvel com um processador Intel
Pentium IV-compatvel ou mais

atualizado
o Sistema operacional de servidor Windows 2000/XP/2003
o Sistema operacional Windows NT/2000/XP ou Windows CE v3.00 para runtime
o Um mnimo de random-acess de 512MB (memria RAM)- memria de 1GB ou maiores so
recomendadas
o MS Internet Explorer 6.0 ou mais atualizado
IWS 20/06/2007

InduSoft Web Studio

Pgina 23
o Mnimo de 500MB de espao em disco rgido livre, para instalao do produto e da
aplicao (arquivos histricos/banco de dados que requerem espao adicional em disco)
o Adaptador para Ethernet
o Adaptador de exibio VGA ou SVGA 100% IBM-compatvel, com 64MB de memria RAM
de Video (VRAM) ou maiores
o Equipamento de apontamento (mouse, trackball ou touch-screen) Microsoft-compatvel
o Teclado padro com teclas de funo 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 so baseados em aplicaes tpicas.
Dependendo de sua aplicao especfica, os requisitos mnimos podem variar.
Aplicaes desenvolvidas com oInduSoft Web Studio podem rodar em
dispositivos melhorados pelo sistema operacional do Windows CE (Windows
CE v3.0 ou Windows CE .NET) como IHMs industriais ou PDAs (PocketPC).
Consulte o vendedor de hardware para obter seus requisitos ao rodar suas
aplicaes sob sistema operacional Windows CE.
Alm do sistema operacional descrito acima, a estao Web Thin Client podem
rodar os sistemas operacionais Windows 98 ou Windows ME.
Ao utilizar uma Hardkey ao inves de uma Softkey para licenciar o produto, a
porta paralela ou USB devem estar disponveis no computador local.
Alguns dos itens listados acima como opcionais podem ser obrigatrios,
dependendo de sua Aplicao. Por exemplo, caso voc precise trocar
dados com um PLC via uma interface serial, o computador deve prover
uma porta COM serial.

IWS 20/06/2007

InduSoft Web Studio

Pgina 24
Instalando o IWS
Utilize os seguintes procedimentos para instalar o IWS a partir do CD-ROM:
E Ligue seu computador e tenha certeza de que no existe nenhum outro programa rodando.
E Insira o CD-ROM de instalao no driver do computador.
Uma janela Welcome to Indusoft dever aparecer automaticamente:

Janela Welcome to InduSoft
Caso a janela Welcome to Indusoft no aparecer, voc pode iniciar o programa do Windows Explorer.
Navegar para o diretrio <D>:\Installation (onde <D> o seu drive de CD-ROM), e a seguir rodar o arquivo
Setup.exe (clicar no cone InduSoft Web Studio far com que esse programa rode).
A janela Welcome to Indusoft contm as seguintes pastas:
Welcome to InduSoft Web Studio v6.1: Pgina principal
About InduSoft: Contm apresentaes em PowerPoint sobre a InduSoft.
Installation: Contm links de instalao do InduSoft.
Documentation: Contm toda a documentao do IWS em formato .pdf.
Sample Aplications: Contm amostras de Aplicaes para auxiliar no desenvolvimento de suas prprias
aplicaes, alm de fornecer exemplos para auxiliar no desenvolvimento de suas prprias Aplicaes com a
utilizao do InduSoft Web Studio.
Technical / Application Notes: Contm documentos tcnicos em formato .pdf.
Viewer Utilities: Contm o Microsoft PowerPoint Viewer (necessrio para visualizar as apresentaes
fornecidas pela InduSoft em formato .ppt), Adobe
Reader
(necessrio para visualizar os documentos da

InduSoft fornecidos em formato .pdf), e WinZip
(para retirar do zip os arquivos comprimidos).

IWS 20/06/2007

InduSoft Web Studio

Pgina 25

E Na janela Welcome to Indusoft, clique no link Installation, e depois no link do InduSoft Web
Studio desejado para iniciar a instalao: InduSoft Web Studio Installation Wizard.
E Um dilogo Setup aparece para infom-lo de que o Wizard est carregando.
E Siga as seguintes instrues, founecidas pelo Wizard, para prosseguir a instalao, a qual
inclui:
Ler e aceitar o Contrato de Licena
Inserir um nome de usurio e o nome de sua companhia
Escolher um local de destino (aeitar o destino padro)
Selecionar os componentes para instalao (aceitar o padro)
Um dilogo Setup Status exibido enquanto o programa instalado, e o dilogo Setup Complete aparecer
assim que a instalao esteja concluda:

Dilogo de instalao concluda
E Deve-se reiniciar o computador para continuar. Assim, clique no radio buttom Yes, I want to
restart my computer now e clique em Finish.
E Caso deseja-se instalar o Service Pack, instale-o agora da mesma maneira.
E Aps reiniciar o computador, clique duas vezes no cone InduSoft Web Studio na rea de
trabalho ou selecione Start All Programs InduSoft Web Studio InduSoft Web Studio para
iniciar o programa do IWS.

IWS 20/06/2007

InduSoft Web Studio

Pgina 26

Inicializando o InduSoft Web Studio
D Dica:
Pode-se rodar o ambiente de desenvolvimento sob qualquer configurao de video;
porm, para rodar Aplicaes em plataforma CE, recomendamos configurar suas
configuraes Display de video para uma resoluo de 800x600 (ou mais avanada)
e com a utilizao de 256 cores (ou mais) para obteno de um ambiente mais
convidativo. A resoluo da aplicao (dimenses da tela) independente da
resoluo do sistema operacional.

Nota:
O Microsoft .NET Framework 1.1 ser automaticamente instalado, iniciando com o
Pacote de Servios 3 do IWS v.6. Veja em Utilizando Banco de Dados ODBC
Interface do Banco de Dados do IWS para maiores informaes.

Instalando o CEView

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

Ao instalar o InduSoft Web Studio no Windows NT/2000/XP, o IWS armazena os arquivos de runtime do
CEView na seguinte pasta:
<InduSoft Web Studio Folder>\Redist\<OS Version>\<Processor Type>\
Onde:
<InduSoft Web Studio Folder> o diretrio de instalao escolhido durante a instalao
(C:\Program Files\InduSoft Web Studio o diretrio padro para instalao).
<OS Version> a verso do sistema operacional na qual o CEView ser instalado. A subpasta
do CEView armazena os arquivos para WinCE v3.0. A pasta WinCE 4.0 armazena os arquivos
para WinCE v4.0. A pasta WinCE 4.1 armazena os arquivos para WinCE v4.1, e assim por
diante.
Da rea de Trabalho
Do Menu Iniciar
IWS 20/06/2007

InduSoft Web Studio

Pgina 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:
E Ligue o equipamento WinCE, e o dilogo Remote Agent dever carregar-se automaticamente.
Caso o dilogo no aparea, copie o arquivos CEServer.exe do diretrio \InduSoft Web
Studio\Redist\CEView\<Processou Type>\BIN no computador com WinNT/2000/XP onde o
IWS foi instalado, cole o arquivo em uma pasta \<non-volatile> de seu WinCE, e rode o arquivo.
Nota:
Existem diferentes caminhos para copiar-se um arquivo em um equipamento
WinCE (por exemplo, pode-se mapear uma pasta compartilhada do computador
com WinNT/2000/XP no equipamento WinCE ou utilizar o ActiveSync). Caso seja
necessria assistncia para copiar esse arquivo para o WinCE, entre em contato
com o suporte tcnico da InduSoft.
E Aps a execuo do arquivo CEServer.exe, o dilogo Remote Agent ser carregado no WinCE.
E Clique no boto Setup no dilogo Remote Agent e configure o link (de srie ou TCP/IP) para
conectar o equipamento ao computador com WinNT/2000/XP.
Nota:
A InduSoft recomenda a utilizao do link TCP/IP entre o WinCE e seu computador
WinNT/2000/XP para a efetuao de downloads e atualizao de arquivos.

E Inicie o InduSoft Web Studio no computador WinNT/2000/XP.
E Seleione Project Execution Environment a partir da barra de menu principal.
E Quando aparecer o dilogo Execution Environment, selecione um tipo de conexo (Network IP,
Serial Port ou Microsoft ActiveSync) e configure seus parmetros (por exemplo, Endereo IP ou
Porta COM).

Dilogo do Ambiente de Execuo
E Clique no boto Connect para conectar o InduSoft Web Studio ao WinCE.
E Clique no boto Install System Files, a partir do dilogo Execution Environment (tab Target) para
baixar arquivos do CEView para o WinCE.
IWS 20/06/2007

InduSoft Web Studio

Pgina 28
Desisntalando o InduSoft Web Studio e CEView
Caso seja necessrio remover o InduSoft Web Studio de seu sistema, siga as seguintes instrues:

C Ateno:
Antes de iniciar o procedimento para desinstalao, certifique-se de que todos os
arquivos tenham um back-up, pois esses podero ser teis no futuro. Salve-os na
pasta \InduSoft Web Studio\.
Alm disso, certifique-se de que voc possua a verso atual (ou mais recente) do CD-
ROM de instalao do InduSoft Web Studio ou disquetes que possam ser reinstalados
mais tarde caso seja necessrio.

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

Abrindo o Control Panel
E Clique duas vezes no cone Add/Remove Programs na janela Control Panel:

E Quando o dilogo Add/Remove Programs Properties aparecer, selecione InduSoft Web Studio a
partir da lista e, a seguir, clique no boto Add/Remove.
IWS 20/06/2007

InduSoft Web Studio

Pgina 29

Removendo o InduSoft Web Studio
E Quando o dilogo Confirm File Deletion aparecer, clique em Yes.
Aparecero os seguintes dilogos: Uninstall Shield Wizard e Remove Programs from Your
Compute.

Removendo Programas:Tela de Progresso
E Quando a mensagem Uninstall successfully completed aparecer, e o boto OK se tornar ativo,
clique no boto.
E Verifique que o InduSoft Web Studio no esteja mais listado no dilogo Add/Remove Programs
Properties.
E Clique no boto Close ( ), para fechar o dilogo Add/Remove Programs Properties. Feche a
janela Control Panel.
E Abra o Windows Explorer. O browser conter o diretrio InduSoft Web Studio.
E Verifique que todos os arquivos e pastas do InduSoft Web Studio fouam deletadas. (Devero ser
deletados manualmente caso ainda permaneam.)
IWS 20/06/2007

InduSoft Web Studio

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

Licenciando seu Produto
Essa seo explica como licenciar seus produtos InduSoft Web Studio (IWS) e CEView.

Notas:
Essas instrues so vlidas para o InduSoft Web Studio v5.1 ou verses mais recentes.
Os arquivos de runtime do CEView para cada plataforma esto armazenados na
estao de desenvolvimento durante a instalao do IWS. Pode-se utilizar as
ferramentas de gerenciamento remoto do IWS para fazer o download de arquivos de
runtime do CEView para o WinCE.

Verses do Produto
IWS e CEView devem possuir a mesma verso, a qual utiliza a sintaxe:
X.Y+SPWW (por exemplo, InduSoft Web Studio v5.0+SP1 e CEView v5.0+SP1)
Onde:
X: Representa a Family version. A verso familiar alterada somente queo melhorias so
adicionadas s tecnologias e conceitos do produto.
Y: Representa a Sub-version: A Sub-Verso altera-se que melhorias menores e/ou novos
recursos so adicionados ao produto.
WW: Representa o Service Pack. A verso do Pacote de SErvios altera-se que voc deve instalar
pacotes adicionais para entrar em concoudncia com o seguinte:
o Atualizar arquivos da verso previamente instalada
o Corrigir erros no produto (showstoppers e no-workarounds)
o Fornecer melhorias de menor porte antes da publicao da prxima verso do produto
Cada pacote de Servios publicado super excede aquele anterior. Por exemplo, SP2 inclui
todo o Contedo do SP1 e todos os arquivos recentemente atualizados, correo de erros e
melhorias. SP3 inclui todos os contedos de SP2 e todos os arquivos atualizados, correo
de erros, melhorias, e assim por diante.
C Ateno:
Tanto o IWS quanto o CEView podem executar Aplicaes construdas em verses
anteriores do produto. Porm, verses mais antigas do IWS e CEView no podem
executar Aplicaes construdas ou modificadas em verses mais recentes do
produto.
Por exemplo, voc no pode executar uma aplicao da verso 5.1 do IWS utilizando
uma verso 5.0, embora aplicaes da verso 5.0 possam ser executadas na verso
5.1 do IWS.

IWS 20/06/2007

InduSoft Web Studio

Pgina 31
C IMPORTANTE!
So nomeadas licenas especficas Family e Sub-version (X.Y) para cada verso, e a
licena vlida para somente aquela verso (incluindo o Pacote de Servios). Porm, a
licena no ser vlida para uma verso mais recente de Family ou Sub-Versions do
Produto. A qualquer momento em que voc instalar uma nova verso do IWS ou
CEView, voc deve atualizar a licena atual para a nova verso a qual est sendo
instalada. Caso voc tenha instalado apenas o Pacote de Servios, a atualizao da
licena no obrigatria.
Licenas Invlidas
Ao tentar rodar o IWS com uma licena invlida, voc receber uma mensagem de aviso, a qual d
as informaes necessrias para resolver esse detalhe.
Exemplos:

Verso do software mais atualizada do que a licena instalada

O target system selecionado no suportado pela licena atualmente instalada
Modos de Execuo
O InduSoft Web Studio e o CEView suportam os seguintes modos de execuo:

Modo de Execuo InduSoft Web Studio CEView
Modo de Validao
-
Modo Demo
- -
Licenciado somente para
Engenharia
-
IWS 20/06/2007

InduSoft Web Studio

Pgina 32
Licenciado somente para Runtime
- -
Licenciado para Engenharia
+Runtime
-

- = Aplica; =No 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 validao inclui qualquer tempo para que voc rode
um modulo de produto (engenheiro ou runtime). Pode-se utilizar esse perido de validao de
forma contnua ou no (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).
Aps rodar as 40 horas em Modo de Validao, o perodo de validao termina, e o IWS
automaticamente converte-se e roda em Demo Mode (veja as descries a seguir) at que seja
instalada uma licena vlida (Hardkey ou Softkey).Voc no pode reativar o modo de
Validaomesmo em caso de desinstalao e reinstalao do produto em seu computador.

Nota:
Cada verso do produto possui um perodo de validao, o qual independente de
cada verso do InduSoft Web Studio. Por exemplo, se o perodo de validao de sua
verso 5.1 do IWS expirar, e voc estiver rodando em Demo Mode por no ter
instalado uma licena vlida, ao instalar a verso 6.1 do IWS no mesmo
computador, a verso mais recente comear a rodar suas prprias 40 horas de
validao, e a verso 5.1 continuar rodando somente no Demo Mode.

Demo Mode: permite habilidade para fazer download e upload de Aplicaes para estaes
remotas, e rodar Aplicaes para teste e/ou demonstraes. Pode-se executar tarefas de
runtime e utilizar as ferramentas de correo de erros (LogWin e Database Spy), embora estas
desliguem automaticamente aps rodarem por duas horas ininterruptas. Voc pode reiniciar o
Demo Mode novamente e rodar por mais duas horas, e assim por diante.
Voc no pode criar ou modificar telas, planilhas ou configuraes da Aplicao em Demo
Mode.
As opes de menu a seguir esto disponveis em Demo Mode:
Arquivo Vizualizao Projeto Ferramentas Ajuda
Abrir
Projeto
Fechar
Barra
Ferramentas
Zoom
Biblioteca
Configuraes
Status
Rodar
Aplicao
Parar
Aplicao
Enviar Projeto
para
Alvo
Execuo
Ambiente
Logon
Controles de
Registro
Converter
Resoluo
Verificar
Aplicao
Informaes do
Sistema
Todas as
opes

Licensed fou Engineering Only: Habilita todas as opes de trabalho por tempo ilimitado.
Esse modo tambm permite a execuo de tarefas de runtime e ferramentas de correo de
erros (Database Spy, output window, e mdulo LogWin) por 24 horas, continuamente. Aps
IWS 20/06/2007

InduSoft Web Studio

Pgina 33
esse perodo, as tarefas se desligaro, mas voc pode reinici-las e rod-las por mais 24 horas,
e assim por diante. Voc pode utilizar essa licena somente para desenvolvimento e teste.
Licensed for Runtime Only: Capacita todos os runtimes e ferramentas de correo de erros
(Database Spy,output window, e mdulo LogWin) por tempo ilimitado, mas voc no poder
criar ou modificar telas e/ou planilhas.
As opes de menu disponveis no modo Runtime Only so as mesmas opes listadas para
Demo Mode (veja a tabela anteriou).
Licensed fou Engineering + Runtime: Capacita todas as ferramentas de engenharia, tarefas de
runtime e ferramentas para correo de erros (Database Spy, Output window e mdulo LogWin)
por perodo ilimitado.

C IMPORTANTE!
Cada licena contm restries, assim como quais Tipos de Produtos so suportados
para aquela licena. Consulte seu vendedor de software sobre quais tipos de produto
esto disponveis, e quais recursos so habilitados para cada tipo.

Notas:
As ferramentas do Ambiente de Execuo do IWS esto sempre disponveis; voc
poder fazer uploads ou downloads de arquivos a partir de ou para estaes remotas
(como equipamentos WinCE remotos) utilizando o dilogo Execution Environment
(Project Execution Environment).

Pode-se selecionar Help About a partir da barra de menu principal para visualizar qual o Modo
de Execuo que est em andamento. A tela About InduSoft Web Studio contm informaes sobre
o Modo de Execuo atual. Caso esteja rodando o modo Evaluation, o tempo remanescente de
execuo aparecer no campo Modo de Execuo.

Verificando Verso, Modo de Execuo, e Tempo de Validao Remanescente
Tipos de Proteo
O InduSoft Web Studio e CEView suportam os seguintes tipos de proteo:

Tipo de Proteo InduSoft Web Studio CEView
Hardkey
-
Softkey
- -

IWS 20/06/2007

InduSoft Web Studio

Pgina 34
- = Aplica ; = No aplica
Hardkey: Um chip encapsulado que deve ser fisicamente conectado a uma porta paralela do
computador (LPT1) ou da interface USB.
A licena IWS reside no hardkey, e no possvel compartilh-la com mais de uma cpia do
IWS na rede de trabalho. Caso voc conecte o hardkey em outro computador, voc estar
transferindo a licena para esse outro computador.
Utilizar o hardkey no incapacita a conexo de outros equipamentos (como uma impressora)
para a porta paralela do computadoro hardkey deve ser eletronicamente transparente para
outros equipamentos conectados porta paralela. Voc simplesmente conecta o hardkey ao
computador, e ento conecta o cabo da impressora no hardkey. Porm, podem ser encontrados
problemas nessa tarefa, caso voc instale mais de um hardkey (para diferentes produtos)
mesma porta paralela. Por outro lado, ao utilizar o hardkey USB, essa porta no poder ser
compartilhada com outros equipamentos.

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

Softkey: Ao instalar o IWS ou CEView, o programa gera um nico cdigo, chamado Site Code.
Voc pode enviar esse cdigo local para seu vendedor do software, o qual poder gerar um
cdigo de licena chamado Site Key para habilitar seu cdigo local. A chave local instala a
licena do IWS ou CEView em seu computador ou equipamento ou WinCE.
Nota:
Ao instalar um softkey, o IWS recodifica a licena na mmoria no-voltil de seu
computador (ou no equipamento WinCE). Caso esse equipamento esteja danificado,
voc perder essa licena.

Configuraes da Licena
Tanto as licenas de hardkey quanto de softkey configuram os seguintes parmetros:
Product Type: Especifica quais recursos e restries esto habilitadas para a Aplicao (como
um nmero mximo de tags suportado, nmero mximo de drivers rodando simultaneamente,
e assim por diante). Consulte seu vendedor de software sobre quais os tipos de produto esto
disponveis e quais recursos esto habilitados para cada tipo.
Modo de Execuo: Especifica as seguintes opes
Engineering Only: Configura e roda a Aplicao para teste somente durante seu
desenvolvimento. Voc no poder utilizar essa licena de runtime a longo prazo.
Runtime Only: Roda a Aplicao por tempo ilimitado. Voc no poder utilizar essa licena para
desenvolver ou modificar a Aplicao.
Engineering + Runtime: Configura, modifica e roda a Aplicao por tempo ilimitado.
Number of Web Thin Clients: Especifica quantos Web Thin Clients so suportados
simultaneamente pelo servidor. Voc pode conectar um ou mais Web Thin Clients ao servidor
simultaneamente (em caso de carga adicional), embora a licena instalada no servidor deve
suportar esses Web Thin Clients adicionais.
IWS 20/06/2007

InduSoft Web Studio

Pgina 35
Number of Thin Clients (Secure Viewer): Especifica quantos Thin Clients so suportados
simultaneamente pelo servidor. Voc pode conectar um ou mais Thin Clients ao servidor
simultaneamente (em caso de carga adicional), embora a licena instalada no servidor deve
suportar esses Thin Clients adicionais.
A opes para adicionar Web Thin Clients e Thin Clients so as seguintes:
Server for InduSoft Web Studio (WinNT/2000/XP): Conecta 0, 1, 2, 4, 8, 16, 32, 64, 128, ou
256 Web Thin Clients e/ou Thin Clients ao servidor simultaneamente.
Server for CEView (WinCE): Conecta 0, 1, 2, 4, ou 8 Web Thin Clients e/ou Thin Clients ao
servidor simultaneamente.
Version Supported: Ao gerar uma licena, essa especificar a verso do produto ao qual ela
suporta.
Instalando Licenas de Hardkey para o InduSoft Web Studio
Essa seo explica como instalar uma licena de hardkey em um computador
Windows NT/2000/XP.
Instalando uma Nova Licena
Para instalar uma nova licena no IWS, siga os seguintes passos:
E Instale o InduSoft Web Studio em seu computador utilizando as instrues fornecidas
previamente nesse Captulo.
E Conecte o hardkey porta paralela (LPT1) ou interface USB no computador onde o IWS foi
instalado.

C Ateno:
Cuidado ao instalar ou remover um hardkey de seu computador. Recomendando
que o computador seja desligado antes de instalar ou remover um hardkey.
E Rode o InduSoft Web Studio.
Atualizando a Licena de Hardkey Atual
Para atualizar sua licena atual do IWS, execute os seguintes passos:
E Feche todos os mdulos de desenvolvimento e runtime do InduSoft Web Studio.
E Assegure-se de que o hardkey esteja conectado porta paralela (LPT1) ou interface USB no
computador onde o IWS est instalado.
E Selecione Start Programs InduSoft Web Studio Register to execute the Register
module.
E Quando o dilogo Protection Manager aparecer, habilite o boto Hardkey na seo Protection
Type e a seguir, clique no boto Check.

Gerenciador de Proteo: Selecionar Hardkey
IWS 20/06/2007

InduSoft Web Studio

Pgina 36
Caso voc no possua uma licena de hardkey vlida conectada porta do computador paralelo ou
interface USB, a seguinte mensagem de erro aparecer:

No h Hardkey
Caso voc possua uma licena de hardkey vlida conectada porta paralela do computador (LPT1) ou
interface USB, o dilogo Hardkey Settings aparecer, contendo as configuraes da licena atual gravadas
no hardkey.

Verificando as Configuraes do Hardkey
E Clique no boto Change License para abrir o dilogo Change License Hardkey:

Alterando o Dilogo da Licena
E Copie o cdigo da caixa de texto Site Code e envie-o ao vendedor do software.
E O vendedor do software dever enviar um Site Key para validar o cdigo local.
Digite esse cdigo local no campo Site Key do dilogo Change License Hardkey e clique no
boto Authorize.
Voc ser requisitado a confirmar a operao. Caso o programa aceite (valide) seu cdigo local,
a seguinte mensagem aparecer:

Registro: foi executado com sucesso
IWS 20/06/2007

InduSoft Web Studio

Pgina 37
Nota:
Caso seu novo Site Key no esteja vlido, uma mensagem de erro aparecer. Caso
isto acontea, verifique se voc digitou o Site Key corretamente. Caso tenha sido
digitado corretamente, e a mensagem de erro ainda permanecer, contate o
vendedor de seu software para maior assistncia.

Voc pode atualizar qualquer configurao da licena (Tipo de Produto, Modo de Execuo, ou
Nmero de Web Thin Clients) simultaneamente suportados pelo servidor, ou atualizar a verso do
software que esteja sendo suportada atualmente. O custom da atualizao depender das
configuraes da licena atual e das configuraes da licena a qual ser atualizada.
Instalando uma Licena de SoftKey para o InduSoft Web Studio
Essa seo explica como instalar e atualizar uma licena de SoftKey para o IWS
(em Win NT/2000/XP).

Nota:
Voc deve ter privilgios de Administrador para a estao de trabalho
Windows NT/2000/XP na qual voc est instalando ou modificando a licena de
softkey.

Instalando uma Nova Licena
Para instalar uma nova licena de softkey no IWS, siga os seguintes passos:
E Instale o InduSoft Web Studio em seu computador utilizando as instrues fornecidas
anteriormente nesse Captulo.
E Execute o mdulo Register selecionando Start Programs InduSoft Web Studio
Register.
Clque (habilite) o radio button Softkey no grupo Protection Type, e clique no boto Check.

Gerenciador de Proteo: Softkey

Nota:
Caso voc possua uma licena de hardkey instalada em seu computador, o
dilogo Register aparecer com a mensagem Warning: this will change the
protection method of the software. Continue anyway?.
Para continuar a instalao do softkey, clique em Yes.
O dilogo Softkey Settings aparecer.
IWS 20/06/2007

InduSoft Web Studio

Pgina 38
o Caso voc j possua uma licena de softkey instalada e vlida para o InduSoft Web Studio,
as configuraes dessa licena aparecero.
o Caso voc no tenha uma licena previamente instalada, a caixa de texto Status exibir a
mensagem License not found.

Checking the Softkey Settings
E Clique no boto Change License no dilogo Softkey Settings.
E Quando o dilogo Change License Softkey aparecer, copie a informao do cdigo da caixa de
texto Site Code e envie-o para o vendedor do software.

Alterar Licena: Softkey
O vendedor de seu software dever enviar uma Site Key que valide esse Site Code. Digite o Site Key no
campo Site Key do dilogo Change License Softkey e depois clique no boto Authorize.
Voc ser requisitado a confirmar a operao. Caso o programa aceite (valide) seu Site Key, a seguinte
mensagem aparecer:

A instalao do Site Key foi Executada com Sucesso

Nota:
Caso seu novo Site Key no esteja vlido, uma mensagem de erro aparecer. Caso
acontea, certifique-se de que o cdigo local tenha sido digitado corretamente. Se a
mensagem de erro ainda permanecer, entre em contato com o vendedor do software
para maior assistncia.

E Feche o mdulo Register e rode o InduSoft Web Studio.
IWS 20/06/2007

InduSoft Web Studio

Pgina 39
Atualizando a Licena Atual
Para atualizar sua licena do IWS, siga os passos a seguir:
E Antes de atualizar uma licena de softkey, voc dever reinstalar o InduSoft Web Studio no
mesmo computador onde a licena foi instalada primeiramente.
C Ateno:
No desinstale o InduSoft Web Studio antes de obter uma licena atualizada de seu
vendedor do software, ou voc perder a licena atual e no ser permitida a
instalao da licena atual. (Dever ser feito um novo pedido de instalao.)

E Para a instalao da verso mais recente do InduSoft Web Studio, abra a sub-pasta \BIN e rode
o programa SKEYUPG.exe.
O dilogo Upgrade Softkey aparecer:

Dilogo de Atualizao do Softkey

E No dilogo Upgrade Softkey, clique no boto e quando o dilogo Browse dialog aparecer,
selecione o caminho(local) onde a verso anterior (j habilitada) do IWS foi instalada. As
informaes do caminho especifco aparecer automaticamente na caixa de texto Path na seo
Old Version.

Encontrando o Softkey Instalado Anteriormente
E Clique no boto Save SKEYUPG.BIN file para salvar as informaes necessrias para a gerao
de uma licena atualizada.
E Copie o arquivos SKEYUPG.BIN do diretrio onde voc executou o programa SKEYUPG.exe e
envie-os para seu vendedor do software.
IWS 20/06/2007

InduSoft Web Studio

Pgina 40
E Seu vendedor do software dever reenviar um Site Key que valide as informaes salvas no
arquivo SKEYUPG.BIN.
E Execute o mdulo Register ( Register) para a verso mais recente instalada do InduSoft Web
Studio (onde o programa SKEYUPG.exe foi executado para gerar o arquivo SKEYUPG.BIN).
E Quando aparecer o dilogo Protection Manager, clique (habilite) o boto Softkey na seo
Protection Type e clique no boto Check.

Gerenciador de Proteo: Selecionar Softkey
O dilogo Softkey Settings aparecer.
Caso voc no tenha instalado uma licena anteriormente, a caixa de texto Status exibir a mensagem
License not found:

Dilogo de Configurao de Softkey
Caso voc j possua uma licena vlida de Softkey para o InduSoft Web Studio, as configuraes da licena
atual aparecero:

Configuraes de Softkey Settings: Licena encontrada
Pode-se atualizar qualquer configurao da licena (Tipo do Produto, Modo de Execuo, ou Nmero de Web
Thin Clients) simultaneamente suportadas pelo servidor, ou tambm atualizar a verso do software a qual
est sendo suportado. O custom de atualizao depender das configuraes de sua licana atual, assim
como das configuraes de sua licana a ser atualizada.
IWS 20/06/2007

InduSoft Web Studio

Pgina 41
E No dilogo Softkey Settings, clique no boto Change License para abrir o dilogo Change
License Softkey:

Alterar Licena: Softkey
E Digite o cdigo local enviado para seu vendedor do software no campo Site Key do dilogo
Change License Softkey.
E Clique no boto Authorize.
Caso o Cdigo Local for aceito (validado), a seguinte mensagem aparecer:

Instalao do Cdigo Local Executada com Sucesso

Nota:
Caso o novo cdigo local no seja vlido, uma mensagem de erro aparecer. Caso
acontecer, verifique se voc digitou o cdigo local corretamente. Se a mensagem
ainda permanecer, entre m contato com o vendedor do software para maior
assistncia.

E Feche o mdulo Register e rode o InduSoft Web Studio.
IWS 20/06/2007

InduSoft Web Studio

Pgina 42
Instalando uma Licena de SoftKey para CEView
Existem dois modos de registrar uma licena 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 licena ao equipamentoWinCE.
Nota:
Pode-se obter equipamentos WinCE com a licena para o CEView j instalada e
habilitada. Consulte o vendedor do software sobre essa outra possibilidade.

Instalando ou Atualizando uma Licena (Localmente)
Para instalar (ou atualizar uma j existente) uma nova licena de softkey para o CEView
(localmente), siga o seguinte procedimento:
E Faa 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 aps a
reinicializao do equipamento WinCE.
Nota:
O caminho \<Non-Volatile Folder> pode variar de acordo com cada fabricante do
equipamento WinCE.

Aps instalar o IWS no computador com WinNT/2000/XP, o arquivo do programa Remote
Agent (CEServer.exe) encontrado no caminho:
<InduSoft Web Studio Path>\Redist\<WinCE version>\<Platfoum>\BIN\
CEServer.exe
Onde:
<InduSoft Web Studio Path> o diretrio onde o IWS foi instalado (por exemplo, C:\Program Files\InduSoft
Web Studio\).
<WinCE version> indica que a verso 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 carto de memria (FlashCard memory) conectado ao equipamento. Alm
disso, antes de fazer o download do Remote Agent (CEServer.exe) para seu WinCE,
certifique-se de que este ainda no est carregado (no caminho: \<Non-Volatile
Folder>).

IWS 20/06/2007

InduSoft Web Studio

Pgina 43
D 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 estao WinNT/2000/XP para um
equipamento WinCE. Voc tambm pode fazer o download do ActiveSync
no site da Microsoft.
Pode-se utilizar a sintaxe a seguir para mapear uma pasta
compartilhada de um computador WinNT/2000/XP para a maioria dos
equipamentos WinCE:
net use [<Local Name>] [Remote Name] [/user:<UserName>]
Aps executar esse commando, abra a janela Comme Prompt e utilize o
comando COPY para copiar os arquivos para o WinCE.
Recomendamos que voc configure o equipamento WinCE para que seja executado
o programa Remote Agent automaticamente ao ligar o equipamento. Veja a
documentao do fabricante do equipamento para maoires informaes sobre como
configurar o programa de inicializao (Startup) no equipamento.

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

Dilogo Remote Agent
E No dilogo Remote Agent, clique no boto Setup para abrir o dilogo Setup:

Dilogo Setup
IWS 20/06/2007

InduSoft Web Studio

Pgina 44
E Clique no boto License para abrir o dilogo License:

Dilogo License
E Clique no boto Change License para abrir o dilogo Change License:

Dilogo Change License
Copie o cdigo (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 cdigo local. Digite o Site Key no
campo Site Key no dilogo Change License, e clique no boto Authorize.
Caso o cdigo local seja aceito (validado), a seguinte mensagem aparecer:

Site Key Instalado com Sucesso
Nota:
Caso o novo cdigo local no seja validado, aparecer uma mensagem de erro.
Caso acontea, certifique-se de que o cdigo local tenha sido digitado
corretamente. Se a mensagem de erro ainda assim persistir, entre em contato
com o vendedor do software para maior assistncia.

IWS 20/06/2007

InduSoft Web Studio

Pgina 45
Instalando ou Atualizando uma Licena (Remotamente)
Para instalar (ou atualizar) uma licena de SoftKey para CEView (remotamente), siga o seguinte
procedimento:
E Execute os trs primeiros passos descritos na seo anterior.
E No dilogo Setup, especifique o tipo de conexo do equipamento (Device Connection) clicando
(habilitando) em Serial Port ou TCP/IP. (Caso voc habilite o boto Serial Port, voc dever
selecionar uma porta a partir da lista combo-box). Clique em OK para fechar o dilogo.
E Rode o InduSoft Web Studio na estao WinNT/2000/XP e conecte essa estao ao
equipamento WinCE utilizando um link serial ou TCP/IP.
E A partir da barra de menu principal do IWS, selecione Project Execution Environment para
abrir o dilogo Execution Environment:

Dilogo Execution Environment
E Especifique uma target station, clicando um dos seguintes radio buttons em Target Station
(target station):
Local
Network IP e digite o endereo IP no campo apropriado
Serial Port e selecione uma porta a partir da lista de combo-box fornecida
Microsoft ActiveSync
E Quando o boto Connect ficar ativo, clique neste boto para conectar-se ao equipamento
WinCE no qual o Remote Agent esteja rodando. (Caso voc selecione uma Network IP, voc
dever inserir o endereo IP na caixa de texto apropriada.)
D Dica:
Os links TCP/IP possibilitam uma melhor performance de comunicao, quando
comparados a links seriais.

IWS 20/06/2007

InduSoft Web Studio

Pgina 46
O campo Status dever exibir a seguinte mensagem:
Connected to CEView <CEView Version>

Conectando-se ao CEView
E Selecione o tab CE License para visualizar quais configuraes de licena esto instaladas
atualmente em seu equipamento WinCE.

CEView License Settings
E Na seo License Codes do dilogo Execution Environment, copie as informaes exibidas no
campo Site Code e envie-as para o vendedor de seu software.
Esse dever reenviar uma Site Key que valide esse cdigo local enviado. Digite o cdigo local no campo Site
Key.
Clique no boto Send para enviar o cdigo para o Remote Agent que esteja rodando no equipamento WinCE.
O programa Remote Agent requisitar a instalao de uma nova licena utilizando o cdigo local enviado
pelo InduSoft Web Studio. Caso o cdigo local seja aceito (validado), a seguinte mensagem aparecer:

Instalao do Cdigo Local Executada com Sucesso

IWS 20/06/2007

InduSoft Web Studio

Pgina 47
Nota:
Caso o novo cdigo local no seja vlido, uma mensagem de erro aparecer. Caso
acontea, verifique se o cdigo foi digitado corretamente. Se a mensagem ainda
assim persistir, entre em contato com seu vendedor do software para maior
assistncia.

C Ateno:
Aps enviar a licena para o equipamento WinCE, certifique-se de que as
configuraes de registro foram salvas. Caso essas configuraes no sejam
salvas, voc perder a licena quando reiniciar o equipamento.

IWS 20/06/2007

InduSoft Web Studio

Pgina 48
Captulo 3: Trabalhando com o Ambiente de
Desenvolvimento do IWS
Esse Captulo fornece uma viso geral do ambiente de desenvolvimento do InduSoft Web Studio. As
informaes esto organizadas nas seguintes sees:
Navegando na Janela do ambiente de Desenvolvimento
Utilizando o Editor Tela/Planilha
Utilizando o Database Spy
Utilizando a Output window
Customizando o Workspace
Mdulos de Desenvolvimento
Comunicaes gerais
Navegando no Ambiente de Desenvolvimento
O InduSoft Web Studio utiliza ferramentas padro e semelhantes s do Windows, alm de interfaces que
fornecem um ambiente de desenvolvimento integrado e amigvel:
IWS 20/06/2007

InduSoft Web Studio

Pgina 49
Tal ambiente de desenvolvimento consiste dos seguintes recursos:
Barra de ttulo
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 tambm contm
alguns desses recursos (como barra de menu).

Utilizando a Barra de Ttulo
A barra de ttulo est localizada na janela acima do ambiente de desenvolvimento e contm o cone
da InduSoft, o nome do produto e o nome da tela ativa ou planilha (qualquer que seja planilha).

Exemplo de Barra de Ttulo
A Barra de Ttulos tambm contm os seguintes botes(da esquerda para a direita):
Boto Minimize ( ): Clque para minimizar a janela do ambiente de desenvolvimento.
Boto Restore Down/Maximize ( / ): Clique para manipular a janela do ambiente de
desenvolvimento para dois tamanhos diferentes:
Restore Down reduz a janela a seu tamanho original (padro)
Maximize Aumenta a janela, preenchendo toda a tela de seu computador
Boto Close ( ): Clique para salvar o database e fechar o ambiente de desenvolvimento. Caso
voc modifique quaisquer telas ou planilhas, o programa requisitar que se salve o trabalho
efetuado. A funo desse Boto similar a seleo do comando Exit no menu File.
Nota:
Fechar o sistema de desenvolvimento no fecha o sistema de runtime.

IWS 20/06/2007

InduSoft Web Studio

Pgina 50
Utilizando a Barra de Menu
A menu bar est localizada logo abaixo da barra de ttulos.

Menu Bar
A barra de menu prove acesso aos seguintes menus e as suas opes:
File: Contm opes que permitem o gerenciamento dos arquivos da aplicao.
Edit: Contm opes que permitem o gerenciamento de telas e planilhas.
View: Contm opes que permitem o gerenciamento de ferramentas, alm de fornecer atalhos
para dilogos usados com maior frequencia.
Insert: Contm opes que permitem a configurao de tags da aplicao, classes de tags,
documentos, drivers, usurios, configuraes de segurana, telas, e objetos ActiveX.
Project: Contm opes que permitem a execuo da aplicao local e remotamente, alm de
fornecer links utilizados para a configurao de parmetros gerais da aplicao.
Tools: Contm opes que permitem acesso a links para ferramentas auxiliaries no
desenvolvimento.
Window: Contm opes que permitem o gerenciamento da abertura de telas e planilhas.
Help: Contm opes para links com informaes do produto InduSoft Web Studio e sobre a
InduSoft.
Ao clicar no menu, um menu anexo aparecer, contendo uma variedade de opes relacionadas.
Por exemplo, ao clicar em View, o seguinte menu aparecer:

Menu Anexo Opo View
Notas:
Opes de menu individuais so discutidas em detalhes ao longo dessa publicao
sempre que seu uso seja relacionado a performance de uma tarefa especfica.
Em muitos casos, a funcionalidade das opes do menu duplicada com a utilizao
de botes nas diversas barras de tarefas. Por exemplo, voc pode clicar no Boto ou
selecionar File Print para abrir o dilogo Print.

IWS 20/06/2007

InduSoft Web Studio

Pgina 51
Recursos do menu anexo
Certos recursos em um menu anexo fornecem mais do que voc pode esperar ao selecionar um item
no menu principal.
Reticncias ( ): Indica que um dilogo ou janela abrir ao selecionar essa opo. Por
exemplo, ao selecionar a opo New, o dilogo New aparecer.
Setas ( ): Indica que um menu em cascata (um Segundo menu em anexo)
aparecer ao selecionar essa opo. Por exemplo, ao selecionar a opo Toolbars, o seguinte
menu em cascata aparecer:

Menu em Cascata da Barra de tarefas
Keyboard Combinations e Function Keys: Indicam um mtodo alternativo (atalho) para
selecionar a opo a partir do menu anexo. Por exemplo,
Pressionar as teclas Ctrl e p simultaneamente o mesmo que selecionar a opo Print no menu
File.
Pressionar as teclas Alt e 1 simultaneamente abre/fecha a janela Output.
Pressionar a funo F4 abre a janela Zoom.
Botes Inverter ( ) ou ( ): Clique no Boto para alternar entre deixar o recurso em on
e off .
Por exemplo, se voc clicar uma vez no Boto Standard exibido na figura acima, voc desligar
a barra de tarefas Standard e esta no aparecer no ambiente de desenvolvimento. Clique no
Boto novamente, e a barra de tarefas reaparecer. De forma similar, clicar no Boto
Workspace, inverters a exibio do Workspace em e off .
Option Name only: Indica que, ao clicar no nome da opo, o IWS executar a tarefa
imediatamente, ou colocar o usurio no modo correto para a execuo da tarefa. Por exemplo,
selecionando File Save, o IWS salva imediatamente a tela ativa da Aplicao.
IWS 20/06/2007

InduSoft Web Studio

Pgina 52
Reposicionando a barra de menu
A barra de menu um recurso reposicionvel, o que significa que voc pode move-la para outro
local na janela do ambiente de desenvolvimento.
Para mover e reposicionar a barra de menu:
E Clique na barra de menu e arraste-a para o novo local.
E Solte o Boto do mouse para anexar ou posicionar a barra de menu.
Utilizando a Barra de Ferramentas
O InduSoft Web Studio prov vrias barras de ferramentas que habilitam a execuo de diferentes
tarefas junto ao programa. Essa seo descreve a funo e o local padro de cada barra de
ferramentas.
A barra de ferramentas a seguir contm ferramentas de uso geral, e so localizadas ao longo da
parte superior do Workspace, abaixo da barra de menu (padro):
Standard
Tag Properties
Execution Control
Web
Align and Distribute
As barra de ferramentas a seguir contm ferramentas para edio de telas, e so localizadas ao
longo do lado direito da janela do ambiente de desenvolvimento (por padro):
Mode
Static Objects
Active Objects
Dynamic Properties
Bitmap
Notas:
A barra de ferramentas Bitmap est oculta por padro. Selecione View Toolbars
Bitmap do menu principal para exibir ou ocult-la.
Instrues detalhadas para utilizao dessas barra de ferramentas e suas opes
so fornecidas ao longo dessa publicao quando essas deverem ser utilizadas para
executar uma tarefa especfica.

Posicionando um barra de ferramentas
Todas as barras de ferramentas so reposicionveis,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:
E Clique na barra de ferramentas e arraste-a para o novo local.
E Solte o Boto do mouse para anexar e posicionar a barra de ferramentas em sua nova posio.
D Dica:
Posicione seu cursor em um Boto e a barra de status (localizada abaixo da interface do
IWS) fornecer uma breve descrio daquele Boto.

IWS 20/06/2007

InduSoft Web Studio

Pgina 53
Utilizando o Workspace
A janela Workspace uma interface amigvel que permite encontrar a localizao de qualquer
componente da aplicao (como tags, telas, planilhas, etc) de forma fcil e rpida.
Pode-se redimensionar, mover ou ocultar a janela Workspace para assim adaptar-se ao seu estilo de
desenvolvimento.
Workspace contm quatro tabs:
Database: Prov acesso a todos os tags do banco de dados e components do sistema de
segurana configurados para a aplicao atual.
Graphics: Prov acesso a todas as telas e smbolos na aplicao.
Tasks: Prov acesso a todas as planilhas de tarefas na aplicao.
Comm: Prov acesso a todos os drivers configurados para estabelecer comunicao com outro
equipamento ou programa de software utilizando protocolos disponveis.
Em cada tab, os componentes da aplicao (representados por um cone e descrio nicos) esto
organizados em uma exibio tree-view como a que se segue:

Tabs do Workspace
Clique no Boto ou clique duas vezes na pasta para visualizar os contedos da pasta ou clique
no Boto para fechar a pasta.
Caso voc clique com o Boto direito em qualquer componente no Workspace, um menu exibir
opes relacionados a aquele componente. Por exemplo, o menu pop-up a seguir permite abrir
(Open) o tags database da Aplicao, Insert (criar) um novo tag, ou Refresh a visualizao atual do
tags database da Aplicao:

Clique com o Boto direito para abrir um Menu Pop-Up
IWS 20/06/2007

InduSoft Web Studio

Pgina 54
Clicando-se duas vezes no Boto ou nome de qualquer componente em uma pasta, um dilogo,
planilha ou tela relacionados ao IWS aparecer, podendo-se assim editar o componente. Por
exemplo:

O restante dessa seo descreve cada um dos tabs do Workspace.
Duplo-clique Development
para abrir o dilogo Group
Account
Duplo-clique Datasheet View
para abrir a Application Tags
Worksheet
Duplo-clique Main.scr para
abrir a tela de exposio
Main.scr
IWS 20/06/2007

InduSoft Web Studio

Pgina 55
Tab Database
Selecione o tab Database para acessar todos os tags do banco de
dados e os componentes do sistema de segurana disponveis
para a aplicao atual. Esse tab contm as seguintes pastas:
Aplication Tags contm tags criadas durante o
desenvolvimento da aplicao (como tags de tela ou tags de
leitura/escrita para preencher equipamento).
D Dica:
Pode-se escolher os dados nas planilhas de Tags da
Aplicao e/ou inserir/remover colunas adicionais
clicando-se com o Boto direito e escolhendo a
opo aplicvel no menu pop-up.

Classes contm tags compostas, chamadas class tags,
criadas para associar um conjunto de valores (mais do que
um nico valor) ao objeto.
Shared Database contm tags criadas em um programa de
software de controle baseado em PC e depois importadas
para o banco de dados de tags do IWS.
Por exemplo, voc poder importar tags SteepleChase tags
para o IWS, e Esse ler/escrever dados de um produto de
controle baseado em PC SteepleChase.
Internal Tags contm tags pr-definidos com funes pr-determinadas utilizadas pelo IWS
para tarefas de superviso especficas (por exemplo, Date tags mantm a data atual em formato
string).
Todos os tags internos so read-only, o que significa que voc no poder adicionar, editar ou
remover esses tags do banco de dados.
Security: Contm contas de segurana de todos de um grupo ou de
usurios individuais configurados para a aplicao atual.
Event Settings: Contm recursos de logging e entrega de eventos.
Global Procedures: Esta relao usada declarar e executar os
procedimentos que podem ser chamados por toda a outra relao de
VBScript disponvel 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 aplicao.
Abra uma pasta Tag List ou Member List e clique duas vezes em quaisquer nomes de tags
existents para abrir um dilogo Properties. Pode-se tambm utilizar os parmetros nesse
dilogo para modificar as propriedades de tags j existentes.
Para modificar uma conta Security existente, abra a pasta Groups ou Users e clique duas vezes em
um grupo ou nome de usurio. Quando aparecer o dilogo Group Account/User Account, utilize os
parmetros do dilogo para alterar as propriedades da conta existente.
IWS 20/06/2007

InduSoft Web Studio

Pgina 56
Notas:
Captulo 5: Trabalhando com Tags fornece instrues para criar e editar tags no banco
de dados de Tags do IWS.
Captulo 11: Configurando um Sistema de Segurana fornece instrues para configurar
um sistema de segurana para sua aplicao.

Tab Graphics
Selecione o tab Graphics para acessar todas as telas, pginas da web, objetos da biblioteca, e
smbolos da Aplicao.
Esse tab contm as seguintes pastas:
Screens: Contm todas as telas de exibio criadas para a
aplicao atual.
Group Screen: Contm todos os grupos telas (individuais
combinadas a grupos gerenciveis) criadas para a aplicao
atual (Note: Grupos de tela no esto disponveis para
Windows CE.)
Web Pages: Contm todas as web pages (telas salvas em
formato HTML) criadas para a aplicao.
Symbols: Contm todos os smbolos de um usurio definido,
os quais podem ser grupos de imagens e/ou textos. Pode-se
criar smbolos customizados para a aplicao e salv-los
nessa pasta.
Graphics Script: Essa interface pode ser utilizada para
executar lgicas nos eventos das telas.
Essa interface pode ser utilizada para executar lgicas nos
eventos
Library: Contm uma biblioteca de smbolos comuns e grficos fornecidos juntamente ao
InduSoft Web Studio. Clique duas vezes no Boto Library para abrir a utilidade Symbol Library
do IWS, que consiste de um painel de lista (contendo todos os grupos de smbolos) e uma tela
de exibio.
Layout: Esta interface indica todas as telas atualmente abertas no Screen Editor e permite a
visualizao das telas em runtime.

Para abrir a tela Web page ou smbolo para edio, clique duas vezes no Boto apropriado.
Nota:
Instrues especficas para edio de telas, Web pages, ou smbolos so fornecidas mais
adiante nesse captulo (Utilizando o Editor de Tela/Planilha na pgina 59) e no Captulo
7: Configurando Telas e Grficos.

IWS 20/06/2007

InduSoft Web Studio

Pgina 57
Tab Tasks
Selecione o tab Tasks para acessar todas as planilhas de tarefas da
aplicao atual.
Esse tab contm as seguintes pastas de tarefas:
Alarms: Contm as planilhas Alarm utilizadas para configurar
grupos de alarme e tags relacionados a cada grupo de alarme
da Aplicao. Pode-se tambm utilizar a tarefa Alarm para
definer as mensagens de alarme geradas pelo IWS.
Trend: Contm as planilhas Trend utilizadas para configurar
grupos histricos que armazenam curvas de tendncia para a
Aplicao. Pode-se utilizar a tarefa Trend para declarer quais
tags devem ter seus valores armazenados em disco, e tambm
para a criao de arquivos histricos para grficos de
tendncia. O IWS armazena as amostras em um arquivo
histrico binrio (*.hst), e exibe ambos em amostras
histricas e on-line em uma tela grfica de tendncia.
Recipes: Contm as planilhas Recipe utilizadas para configurar como os dados so trocados
entre o banco de dados da aplicao e os arquivos de disco em formato ASCII ou DBF, e como
os valores so transferidos entre arquivos e memria em tempo real.
Reports: Contm as planilhas Report utilizadas para configurar relatrios (tipo texto) que so
enviados para uma impressora ou disco. Tarefas de relatrio permitem a configurao de
relatrios de texto com dados do sistema, os quais fazem a criao de relatrios com maior
facilidade e eficincia.
ODBC: Contm as planilhas ODBC utilizadas para configurar como a interface ODBC rodar
em um ambiente de rede de trabalho. Tambm utilize configurao padro Windows ODBC.
Pode-se configurar tarefas ODBC para troca de dados entre o IWS e qualquer banco de dados
suportem a interface ODBC.
Math: Contm planilhas Math utilizadas para configurar e implementar mtodos de trabalho
adicionais a diferentes tarefas do IWS. O IWS executa planilhas Math como Background Tasks
durante o runtime. Pode-se configurar planilhas Math para fornecer ambientes livres para
clculos matemticos e tarefas lgicas requisitadas pela Aplicao.
Script: Contm as planilhas Script utilizadas para configurar e implementar rotinas adicionais
para trabalhar com diferentes tarefas do IWS. O IWS executa planilhas Scipt como Background
Tasks durante o runtime. Esta relao til para inicializar variveis ou executar lgicas que
devem ser executadas quando a aplicao estiver iniciandoContm planilhas
Scheduler: Contm planilhas Scheduler utilizadas para configurar eventos utilizando
expresses matemticas definidas, executadas de acordo com perodo, data ou outros eventos
monitorados.
Para abrir as planilhas Task para edio, clique duas vezes no Boto task, e a planilha exibir a
janela Screen/Display.
Nota:
Instrues detalhadas para edio de planilhas so fornecidas no Captulo 8:
Configurando Planilhas Task.

IWS 20/06/2007

InduSoft Web Studio

Pgina 58
Tab Communications
Selecione o tab Communications para acessar todos os
drivers configurados para a sua Aplicao. Drivers so
utilizados para estabelecer comunicao com outros
equipamentos ou programas de software utilizando
protocolos disponveis.
Drivers: Conm as planilhas Driver utilizadas para
configurar uma interface(s) de comunicao entre a
aplicao do projeto e o equipamento remoto (como
um PLC ou transmissores).
Communication driver um arquivo .dll que contm
informaes especficas a respeito de equipamentos
remotos, alm de implementar o protocolo de
comunicao.
OPC: Contm planilhas OPC utilizadas para configurar interfaces OPC entre a Aplicao e um
OPC. Um mdulo OPC Client do InduSoft Web Studio capacita o sistema do IWS a comunicar-
se com qualquer equipamento que implemente um OPC Server, pela implementao de um OPC
padro, tarefa descrita no documento OLE for Process Control Data Access Standard Version
2.0, publicado pela OPC Foundation.
TCP/IP: Contm planilhas TCP/IP utilizadas para configurar interfaces TCP/IP Client para
outras estaes InduSoft.
Mdulos TCP/IP Client e Server do IWS habilitam duas ou mais aplicaes para manter seus
bancos de dados sincronizados, atravs da utilizao do protocolo TCP/IP para prover
comunicao entre aplicaes.
DDE: Contm planilhas DDE utilizadas para configurar um DDE Client para uma aplicao
DDE Server (como Microsoft Excel ou qualquer outro programa do Windows que suporte essa
interface).
DDE (Dynamic Data Exchange) um protocolo que permite troca de dados dinmicos entre
aplicaes do Windows. Uma conversao DDE uma interao entre aplicaes do servidor e
cliente. O IWS prove interfaces que rodam como clientes ou servidores.
Nota:
Por padro, o mdulo DDE Client do IWS suporta DDE Servers que acomodem dados
de string em formato UNICODE. Caso o DDE Server acomode dados de string em
formato ASCII ANSI, os seguintes parmetros devem ser configurados manualmente no
arquivo <AplicaoName>.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 edio, clique duas vezes na
planilha, e essa exibir a janela Screen/Worksheet.
Nota:
Instrues detalhadas para editar planilhas de comunicao so fornecidas no Captulo
10: Comunicao.

IWS 20/06/2007

InduSoft Web Studio

Pgina 59
Utilizando o Editor Tela/Planilha
Utilize o editor de tela orientado pelo objeto para criar e editar uma variedade de telas e planilhas
para suas aplicaes. Voc poder inserir informaes utilizando seu mouse e teclado, retirar dados
de controle para seus processos e atualizar automaticamente telas baseadas e entrada de dados a
partir de seus processos.
Outros recursos do editor de tela incluem:
Simple point-and-Clique, drag-and-drop interface
Agrupar objetos para preserver os passos da construo 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 dilogos e janelas da aplicao

Editor Screen/Workspace
As barras de ferramentas a seguir contm ferramentas de propsito geral que permitem a execuo
de diferentes tarefas juntamente ao programa.
Barra de Ferramentas Standard: Fornece cones (atalhos) que duplicam a funcionalidade,
encontrados nos menus File, Edit, e View.

Barra de Ferramentas Standard
Boto New ( ): Clique para abrir o dilogo New e criar novas aplicaes (projetos) ou arquivos como parte
de sua aplicao.
IWS 20/06/2007

InduSoft Web Studio

Pgina 60
Nota:
Utilizar o Boto New o mesmo que selecionar File New da barra de menu ou
digitar a combinao de teclas Ctrl+N.

Boto Open Project ( ): Clique para localizar e abrir uma Aplicao do InduSoft Web Studio.
Nota:
Utilizar o cone Open Project o mesmo que selecionar File Open Project da
barra de menu ou abrir a pasta InduSoft Web Studio do Windows Explorer e
clicar duas vezes no nome do projeto.

Boto 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 combinao de teclas Ctrl+S.
A funo Save torna-se disponvel somente quando voc modifica o arquivo ativo.

Boto Save All ( ): Clique para salvar todas as telas ou planilhas abertas.
Nota:
Utilizar o cone Save All o mesmo que selecionar File Save All da barra de
menu.
A funo Save All torna-se disponvel somente quando voc modifica uma tela
ou planilha.

Boto Cut ( ): Clique para remover um objeto selecionado da planilha/tela e armazen-lo n rea de
transferncia, substituindo quaisquer selees anteriores que estejam na rea de transferncia. Ustilize-o
em combinao com o Boto Paste.
Nota:
Utilizar o cone Cut o mesmo que selecionar Edit Cut da barra de menu ou
digitar a combinao de teclas Ctrl + X.
Boto Paste ( ): Clique para substituir os contedos da rea de transferncia para o canto esquerdo e
acima da tela ativa. Pode-se Paste um objeto ou cpia mltiplas vezes em vrias planilhas/telas.
Nota:
Utilizar o cone Paste o mesmo que selecionar Edit Paste da barra de menu
ou digitar a combinao de teclas Ctrl + V.

Boto Copy ( ): Clique para duplicar um objeto selecionado e armazen-lo na rea de transferncia.
Pode-se utilizar o Boto Paste para mover o objeto copiado para outro local na mesma ou em diferentes
telas.
IWS 20/06/2007

InduSoft Web Studio

Pgina 61
Nota:
Utilizar o cone Copy o mesmo que selecionar Edit Copy da barra de menu
ou digitar a combinao de teclas Ctrl+C.

Boto Delete ( ): Clique para deletar a seleo. Caso voc delete acidentalmente um objeto, Pode-se
restaur-lo utilizando o Boto Undo.
Note:
Utilizar o cone Delete o mesmo que selecionar Edit Delete da barra de
menu ou digitar a combinao de teclas Ctrl+X.

Boto Undo ( ): Clique para cancelar a ltima ao executada ao trabalhar na planilha ou tela. Pode-se
cancelar at 20 aes feitas antes da ltima ao. As aes em propriedades do objeto no ampliam a
sequencia do Boto Undo.
Nota:
Utilizar o cone Undo o mesmo que selecionar Edit Undo da barra de menu
ou digitar a combinao de teclas Ctrl+Z.

Boto Print ( ): Clique para imprimir a tela ou planilha ativa ou especificar propriedades impressora
/impresso.
Nota:
Utilizar o cone Print o mesmo que selecionar File Print da barra de menu
ou digitar a combinao de teclas Ctrl+P.

Boto 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 combinao de teclas Alt+ 0.

Boto 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 combinao de teclas Altl+1.
Veja tambm Utilizando a Janela Output na pgina 70.

Boto Database Spy Window ( ): Inverter para exibir (abrir) ou remover (fechar) a janela Database Spy.
IWS 20/06/2007

InduSoft Web Studio

Pgina 62
Notas:
Utilizar o cone Database Spy Window o mesmo que selecionar View
Toolbars Database Spy da barra de menu ou digitar a combinao de teclas
Alt+2.
Veja tambm Utilizando o cone Database Spy na pgina 69.

Boto Library ( ): Clique para abrir a biblioteca dos objetos previamente configurados.

Nota:
Utilizar o cone Library o mesmo que selecionar View Library da barra de
menu ou digitar a combinao de teclas Ctrl+A.
Veja tambm Captulo 7: Configurando Telas e Grficos.

Boto Layout ( ): Essa interface exibe todas as telas atualmente abertas no Editor de Telas, e permite:
Modificar Screen Attributes: Clique com o Boto direito na tela exibida no tab Layout e utilize
as opes de alinhamento ou o link Screen Attributes para modificar a posio da tela. Pode-se
tambm clicar e arrastar a tela para alterar sua posio (Acima e Esquerda) ou redimension-
la (Largura e Altura).
Visualizar como as telas apresentam-se juntas durante o runtime. Essa opo especialmente
til ao criar telas de dilogo/pop-up ou grupos de telas.

Nota:
As telas abrem o tab Layout de acordo com a ordem que essas telas so
abertas no ambiente de desenvolvimento. Ao alterar a posio de tabs das telas
no ambiente de desenvolvimento (da esquerda para a direita), vo modificar a
ordem na qual essas telas sero exibidas no tab Layout.

= Dica:
Clique com o Boto direito no tab Layout para exibir a opo para
habilitar/desabilitar o Auto Scale. Caso voc habilite essa opo, as telas
sero automaticamente auto-escalonadas para acomadarem-se no tab
Layout.

Boto 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 Boto direito na tela para alterar o cursor
para o modo de seleo novamente.
combo-box Zoom ( ): Seleciona a escala de zoom desejada.
Boto Context Sensitive Help ( ): Clique nesse Boto e depois clique na rea onde voc deseja ler as
informaes de ajuda.
Barra de ferramentas Tag Properties: Fornece uma caixa de texto e vrios cones (atalhos) que
habilitam a criao, localizao, e acesso a diferentes tags, funes e propriedades do tag.

Barra de Ferramentas Tag Properties
IWS 20/06/2007

InduSoft Web Studio

Pgina 63
text box Tagname ( ): Digite um nome na caixa de texto para criar um novo tag para sua
aplicao. Os botes Cross Reference e Tag Properties iro referenciar esse nome do tag para suas aes.
Boto Object Finder ( ): Clique para abrir o dilogo Object Finder, o qual lista todos os Tags e Funes
atualmente configuradas para essa aplicao. Veja Utilizando o cone Object Finder na pgina 85.
Boto Cross Reference ( ): Clque para pesquisar todas as telas e planilhas da aplicao para o tag
anotado no text box Tagname. Essa funo escreve um log, detalhando todas as ocorrncias do tag para o
tab XRef na janela Output. Veja Utilizando a opo X-ref na pgina 86.
Boto Tag Properties ( ): Clique para configurar parmetros para cada tag. O dilogo Tag Properties
exibido de forma que voc possa especificar Esses parmetros. (Para maaiores informaes sobre a
especificao de propriedades do tag, veja Propriedades de Configurao do Tag no Captulo 5.
Trabalhando com Tags.)
Boto Global Tags Replace ( ): Permite a substituio de qualquer tag(s) de todos os documentos (telas e
planilhas) de toda a aplicao. Pode-se editar tanto a coluna From aquanto a coluna To.

Barra de Ferramentas Execution Control: Permite a execuo e gerenciamento de uma aplicao
localmente ou de um local remoto.

Barra de ferramentas Execution Control
Boto Test Display ( ): Ativa o modo de exibio teste, o qual permite a configurao da aplicao ao
mesmo tempo que visualize-se dinmicos grficos online no ambiente de desenvolvimento. O modo de
exibio teste no habilita a utilizao de Command, dinmicos de entrada Text I/O, ou execuo de
planilhas.
Boto Stop display test ( ): Pra o modo de exibio teste.
Boto Run Aplicao ( ): Atualiza os mdulos de runtime especificados como Automatic no dilogo
Project Status (tab Execution Tasks).
Boto Stop Aplicao ( ): Pra todas as taretas de runtime.
Boto Send project to target ( ): Permite o envio da aplicao para a target station remota.
Boto Execution Environment ( ): Permite o gerenciamento de estaes de trabalho remotas.

Nota:
Para maiores informaes, veja o Captulo 12: Testando e Corrigindo Erros em Sua
Aplicao e Captulo 14: Gerenciando Aplicaes Remotamente..
Barra de Ferramentas Web: Permite abrir e navegar em arquivos HTML.

Barra de Ferramentas Web
IWS 20/06/2007

InduSoft Web Studio

Pgina 64
Nota:
Deve-se instalar o Internet Explorer v4.1 (ou verso mais atual) antes de poder
utilizar qualquer uma das ferramentas da barra de ferramentas Web. Veja Captulo
7: Configurando Telas e Grficos, e Captulo 13: Configurando a Web Solution para
maiores informaes.

Boto Back ( ): Clique para retornar ao ltimo endereo de URL aberto no ambiente de desenvolvimento.
Boto Forward ( ): Clique para retornar ao endereo URL aberto anteriormente, clicando no Boto Back
no ambiente de desenvolvimento.
Boto Stop ( ): Clique para cancelar o processo de download de arquivos de um endereo URL especfico.
Boto Refresh ( ): Clique para recarregar o endereoURL especificado no text box Address.
Boto Home ( ): Clique para abrir a Home Page configurada em seu browser Internet Explorer Web.
text box Address ( ): Digite o endereo URL de uma Web page no text box para abrir
(fazer download) essa pgina para seu browser Internet Explorer.
Boto Go ( ): Clique para fazer downloads de pginas especficas no text box Address.

Barra de Ferramentas Align and Distribute: Permite a edio de objetos de telas. Pode-se
redimensionar, alinhar, flip, rotear, dar espao em objetos de grupo.

Barra de Ferramentas Align and Distribution
Nota:
Veja Utilizando a Barra de Ferramentas Align e Distribute na pgina 187 no
Captulo 7: Configurando Telas e Grficos para descrio detalhada e exemplos
desses botes.
Boto 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.
IWS 20/06/2007

InduSoft Web Studio

Pgina 65
Boto Resize width ( ): Clique para configurar a largura de todos os objetos selecionados, a mesma do
ltimo objeto (objeto com handles preenchidos). Pode-se utilizar Resize width para redimensionar um objeto
selecionado utilizando a largura e altura.
Boto Align left ( ): Clique para alinhar todos os objetos selecionados esquerda do ltimo objeto
selecionado.
Boto Align right ( ): Clique para alinhar todos os objetos selecionados direita do ltimo objeto
selecionado.
Boto Align top ( ): Clique para alinhar todos os objetos selecionados acima do ltimo objeto selecionado.
Boto Align bottom ( ): Clique para alinhar todos os objetos selecionados na parte inferior do ltimo
objeto selecionado.
Boto Center vertically ( ): Clique para alinhar todos os objetos selecionados ao centro e verticalmente do
ltimo objeto selecionado.
Boto Center horizontally ( ): Clique para alinhar todos os objetos selecionados ao centro e
horizontalmente ao ltimo objeto selecionado.
Boto Evenly space horizontally ( ): Clique para colocar uma quantia equivalente de espaos horizontais
entre uma srie de objetos (dois ou mais).
Boto Evenly space vertically ( ): Clique para colocar uma quantia equivalente de espaos verticais entre
uma srie de objetos (dois ou mais).
Boto Flip horizontally ( ): Clique para inverter o objeto selecionado horizontalmente. O objeto move-se
atravs de uma linha imaginria central at que seja uma imagem espelho do objeto original.
Boto Flip vertically ( ): Clique para inverter o objeto selecionado verticalmente. O objeto move-se atravs
de uma linha imaginria central at que seja uma imagem espelho do objeto original.
Boto Rotate ( ): Clique para rotear o objeto selecionado a 90 graus (um quarto de volta) .
Boto Move to back ( ): Clique para mover um objeto(s) para baixo de outros objetos na tela. O IWS
assina o mais baixo ID# para o objeto e move o objeto para baixo de outros objetos na tela.
Boto Move to front ( ): Clique para mover um objeto(s) selecionado para afrente de todos os outros
objetos na tela. O IWS assina o maior ID# para o objeto, de modo que Esse move-se para trs de todos os
objetos na tela.
Boto Group ( ): Clique para combinar mltiplos objetos em um nico objeto para assim facilitar a
seleo e manipulao de objetos. (Pode-se acessar cada parte de um grupo no dilogo Object Properties.)
Boto Ungroup ( ): Clique para separar um objeto agrupado em seus componentes individuais.
A barra de ferramentas a seguir contm ferramentas de edio de tela. Tais barras de ferramentas
esto localizadas ao longo do lado direito da janela da interface por padro, e so habilitadas
somente ao editar telas grficas:
Barra de Ferramentas Mode: Permite a edio de suas telas.
IWS 20/06/2007

InduSoft Web Studio

Pgina 66

Barra de Ferramentas Mode
Nota:
Veja Utilizando a Barra de Ferramentas Mode na pgina 185 no Captulo 7:
Configurando Telas e Grficos para uma descrio mais detalhada.
Boto Selection ( ): Clique para exibir um cursor que permitir selecionar e mover objetos na tela.
Boto Bitmap Editor ( ): Clique para alternar entre as duas camadas bsicas de edio (Objects layer e
Background Picture layer).
Boto Fill Color ( ): Clique para especificar uma colorao padro para Polgonos fechados, elipses,
retangulos arredondados e retngulos.
Boto Fonts ( ): Clique para especificar a fonte e colorao de objetos de texto selecionados ou para
especificar umas fonte padro e colorao para objetos novos.

Boto Line Color ( ): Clique para especificar uma linha para objetos selecionados ou para configurar uma
colorao padro para novos objetos.
Boto Background Color ( ): Clique para especificar uma colorao de fundo para a tela.
Boto Grid ( ): Clique para especificar se desejado mostrar ou ocultar o grid no editor de tela.
Barra de Ferramentas Static Objects: Permite a criao de polgonos, retngulos, linhas, e
outros objetos para sua tela.

Barra de Ferramentas Static Objects
Nota:
Veja Utilizando a barra de ferramentas Static Objects na pgina 198 no
Captulo 7: Configurando Telas e Grficos para uma descrio mais detalhada.
Boto Open Polygon ( ): Clique para desenhar um polgono aberto com uma moldura na colorao de
fundo especificada.
Boto Closed Polygon ( ): Clique para desenhar um polgono fechado, utilizando uma colorao de
moldura especificada.
Boto Line ( ): Clique para desenhar uma linha ortogonal na rea de desenho.
Boto Ellipse ( ): Clique para desenhar elipses, cordas, arcos e crculos.
Boto Rounded Rectangle ( ): Clique para desenhar retngulos arredondados (vazios ou preenchidos).
Boto Rectangle ( ): Clique para criar retngulos.
Boto Boto ( ): Clique para criar botes para redimensionamento customizado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 67
Boto Text ( ): Clique para criar objetos de texto.
Barra de Ferramentas Active Objects: Permite a criao de objetos dinmicos que tipicamente
requisitam mais parmetros do que objetos estticos. Tambm fornece dinmicos embutidos.

Barra de Ferramentas Active Objects
Nota:
Veja Utilizando a Barra de Ferramentas Active Objects na pgina 214 no Captulo
7: Configurando Telas e Grficos para uma descrio mais detalhada, alm de
exemplos.
Boto Alarm/Event Control Object ( ): Clique para adicionar um Objeto de Controle Alarme/Evento na
sua tela da aplicao.
Boto Trend Control ( ): Clique para exibir pontos de dados (valores) a partir de diferentes fontes de dados
em um formato grfico.
Boto Trend ( ): Clique para selecionar uma rea na tela na qual sero exibidas as curvas de tendencias
dos dados do tag.
Boto List Box Object ( ): Clique para criar um box de lista em sua tela. Geralmente, ao executar uma
aplicao, o box do objeto de lista active exibe uma lista de mensagens.
Boto Smart Message Objects ( ): Clque para criar um ou mais objetos de mensagens, nos quais voc
poder exbir mensagens e grficos ao executar a aplicao.
Boto PushButton ( ): Clique para criar um objeto pushButton utilizando o cone das propriedades do
objeto dinmico Command com um objeto ou pushBotos pr-configurados.
Boto ActiveX Control ( ): Clique para abrir o dilogo Insert ActiveX Control. Voc poder utilizar os
componentes ActiveX desse dilogo em sua tela.
Boto .NET Control Object ( ): Clique para abrir o dilogo .NET Framework Components. Voc poder
utilizar os componentes .NET desse dilogo em sua tela.
Boto Combo-Box ( ): Clique para selecionar uma marca nica de uma lista de marcas em um combo-
box.
Boto Alarm ( ): Clique para especificar uma rea na tela onde exibir mensagens de alarme.
Boto Grid ( ): Clique para especificar uma rea na tela para criar um novo objeto Grid.
Boto Check Box Boto ( ): Clique para criar um objeto check-box na tela.
Radio Boto ( ): Clique para criar um objeto radio Boto na tela.
Barra de Ferramentas Dynamic Properties: Permite a aplicao de dinmicos para objetos ou
grupos de objetos. Dinmicos permitem a modificao de propriedades do objeto em fly
(durante o runtime) de acordo com os valores do tag. Alguns dinmicos tambm permitem a
execuo de comandos e insero de valores (set points) para os tags.
IWS 20/06/2007

InduSoft Web Studio

Pgina 68

Barra de Ferramentas Dynamic Properties
Nota:
Veja Utilizando a Barra de Ferramentas Dynamic Properties na pgina 204 no
Captulo 7: Configurando Telas e Grficos para uma descrio mais detalhada.
Boto Command ( ): Clique para adicionar a propriedade de comando para um objeto ou grupo de
objetos selecionados. A propriedade de comando permite clicar no objeto ou pressionar uma tecla pr-
definida para executar o comando durante o runtime.
Boto Hyperlink ( ): Clique para adicionar uma propriedade hyperlink para um objeto ou grupo de
objetos selecionados. Aplicar essa propriedade permite clicar nesse objeto(s) durante a execuo do runtime
para iniciar o browser padro e carregar a URL especificada.
Boto Bargraph ( ): Clique para adicionar propriedades grficas para um objeto selecionado, e depois
clique duas vezes no objeto para abrir o dilogo Object Properties.
Boto Text I/O ( ): Clique para adicionar uma propriedade de texto de entrada e sada para um objeto de
texto selecionado. Aplicar a propriedade Text I/O permite a insero e exibio de valores de tag em tempo
real ao utilizar um cone do teclado ou um keypad da tela para rodar a aplicao.
Boto Colors ( ): Clique para adicionar a propriedade para troca de cores a um objeto selecionado. O
dinmico Colors permite a especificao de at quarto cores em Change Limit.
Boto Position ( ): Clique para especificar quando e onde exibir um objeto, utilizando os valores de tag
especificados no cone.
Boto Resize ( ): Clique para aumentar ou diminuir o tamanho de um objeto selecionado ou smbolo.
Boto Dynamic Rotation ( ): Clique para rotear uma linha.
Barra de Ferramentas Bitmap: Permite acesso a ferramentas do editor de tela bitmap. (Essa
ferramenta est disponvel somente quando a camada Background Picture layer est ativa.
Pode-se habilitar a camada Background Picture no dilogo Screen Attributes.)

Barra de Ferramentas Bitmap
Note:
A Barra de Ferramentas Bitmap est oculta por padro.
Veja Utilizando a Barra de Ferramentas Bitmap na pgina 197 no Captulo 7:
Configurando Telas e Grficos para uma descrio mais detalhada.
Boto Select rea ( ): Clique para selecionar uma rea junto ao Bitmap Screen Editor.
Boto Flood Fill ( ): Clique no Boto Flood Fill e depois clique na tela para pintar a rea ao redor com a
colorao especificada com a utilizao do Boto Fill Color.
IWS 20/06/2007

InduSoft Web Studio

Pgina 69
Boto Pixel Editing ( ): Clique para abrir um dilogo Edit Image, onde possvel desenhar bitmaps
detalhados, pixel por pixel.
Boto Erase rea ( ): Clique para apagar uma rea selecionada da tela.
Boto Change Colors ( ): Clique para tornar transparente uma rea selecionada da tela.
Nota:
Antes de utilizar Esse Boto, j deve estar especificada cor de preenchimento
(Boto Fill Color), selecionado a cor transparente (Boto Select Transparent
Color), e definido a rea de preenchimento (Boto Select rea).

Boto Select Transparent Color ( ): Clique para especificar uma colorao transparente (no Boto
Change Colors).
Boto Inverter Transparent Color ( ): Clique para aplicar a cor selecionada utilizando o Boto Select
Transparent Color para tornar os bitmaps (selecionados em Bitmap Screen Editor) transparentes.
Utilizando o cone Database Spy
A janela Database Spy (localizada abaixo do Workspace por padro) uma ferramenta de correo
de erros do IWS que permite:
Monitorar e enviar valores para o banco de dados de tags
Executar e testar funes
Executar e testar expresses algortmicas

Exemplo da janela Database Spy
A janela Database Spy consiste dos seguintes elementos:
Boto Hide Docked Window ( ): Clique para inverter entre janela aberta e fechada. (De froma
alternativa, Pode-se utilizar o Boto no menu View Toolbars ou Alt+2 para
abrir e fechar essa janela.)
Boto 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 funes e equaes.
IWS 20/06/2007

InduSoft Web Studio

Pgina 70
Value: Exibe valores de retorno e resultados de equaes.
Quality: Exibe uma avaliao de qualidade (Good ou Bad) da origem do tag ou funo.
Continuous: Exibe se o IWS est reavaliando o tag, funo ou equao de forma contnua.
Scroll bars: Utilize para visualizar reas da Database Spy que esto difceis de vizualizar por
causa do tamanho tanto da janela quanto da planilha atual.
Notas:
O Database Spy reposicionvel, o que significa que voc pode move-lo para outro
local no ambiente de desenvolvimento. Clique na barra de ttulo e arraste-o para o novo
local. Solte o Boto do mouse para anexar ou reposicionar a janela em seu novo local.
Instrues detalhadas sobre como utilizar o cone Database Spy so fornecidas no
Captulo 12: Testando e Corrigindo Erros da Aplicao.

Utilizando a Janela Output
A janela Output (localizada prxima ao Database Spy por padro) outra ferramenta de correo de
erros do IWS, similar quanto s funes ao mdulo LogWin.

Exemplo de Janela Output
Embora funcione em uma escala menor do que a do LogWin, a janela Output habilita o
monitoramento dos componentes de sua aplicao diretamente a partir do ambiente de
desenvolvimento. (Para uma descrio detalhada do mdulo LogWin, veja o Captulo 12: Testando e
Corrigindo Erros na sua Aplicao.)
A janela Output contm os seguintes elementos:
tab Log: Utilize Esse tab para coletar dados e monitorar a sada 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 71
Trace messages
Database messages
Insert dates/times
Tags
Esse recurso loga seus dados em bases first-in, first-out (FIFO) para salvar espao e memria,
alm de permitir a pausa na coleta de dados, a fim de revisar os resultados.
tab XRef: Utilize Esse tab para perquisar e exibir o local (caminho, nome do arquivo, coluna e
linha) de cada exemplo onde um tag especfico est sendo utilizado junto a sua aplicao. (Veja
tambm Utilizando a opo X-ref na pgina 86.)
Boto 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 Boto ou
pressionar Alt+1 para abrir/fechar a janela.
Boto Contract/Expand ( ): Clique para contrair e expandir a janela Output.
Scroll Bars: Clique e arraste para visualizar reas da janela Output que esto ocultas por causa
do tamanho ou largura de seus dados.
Notas:
A janela Output reposicionvel, o que significa que voc pode mov-lo para outro
local no ambiente de desenvolvimento. Clique na barra de ttulo e arraste a janela
para sua nova localizao. Solte o Boto do mouse para anexar e reposicion-lo para
sua nova localizao.
Instrues detalhadas sobre como utilizar a janela Output so fornecidas no
Captulo 12: Testando Corrigindo Erros na sua Aplicao.

Utilizando o cone Status Bar
A barra de status (localizada na parte inferior da janela do IWS) contm campos utilizados para
identificar os botes da barra de ferramentas que fornecem informaes sobre a tela ativa (ou
qualquer tela).

Exemplo de Status Bar
Os campos aparecem como se segue (da esquerda para a direita):
Campo Hint: Fornece uma curta descrio de qualquer Boto da barra de ferramentas, ou exibe
objetos que podem ser tocados pelo cursor.
Campo Caps Lock: Indica se a tecla Caps Lock est on (CAP) ou off (vazio).
Campo Num Lock: Indica se a tecla Num Lock est on (NUM) ou off (vazio).
Campo Scroll Lock: Indica se a tecla Scroll Lock est on (SCRL) ou off (vazio).
Campo ID : Exibe o nmero 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 72
Campo Screen Coordinate: Exibe a localizao atual do cursor (ou apontador) na tela ativa.
Onde: X o nmero de pixels do limite esquerdo da tela e Y o nmero de pixels do topo da
tela.
Campo Object Size: Exibe o tamanho (em pixels) de um objeto selecionado, onde W a largura
e H altura.
Campo No DRAG: Indica se a tarefa arrastar est desabilitada (No Drag) ou habilitada (vazio) na
tela ativa. Pode-se inverter o recursos No Drag pressionado Ctrl+D.
Nota:
Utilize o atalho Ctrl+D para habilitar/desabilitar o recurso No Drag ao editar a tela.
Pode-se utilizar o recurso No Drag para evitar que objetos se movam na tela ao
alterar suas propriedades.

Customizando o Workspace
O InduSoft Web Studio permite que voc customize o ambiente de desenvolvimento:
Boto Hide Docked Window ( ): Clique para inverter entre abrir e fechar a janela. (De forma
alternativa, Pode-se utilizar o Boto no menu View Toolbars ou Alt+2 para abrir
e fechar essa janela.)
Boto Contract/Expand ( ): Clique para inverter entre contrair e expandir a janela Database
Spy.
Interfaces Padro
As interfaces padro discutidas nessa seo consistem de interfaces bsicas que so utilizadas
frequentemente medida que se trabalha no ambiente de desenvolvimento do InduSoft Web Studio.
Elas incluem:
Virtual Keyboard
Fonts
Color Interface
Virtual Keyboard
O Virtual Keyboard (VK) do IWS permite ao usurio a insero de dados (texto ou nmeros) durante
o runtime utilizando-se de um equipamento touch-screen, em vez de um teclado fsico.
Pode-se habilitar o VK para sua Aplicao no dilogo Runtime Desktop (Project->Settings->Runtime
Desktop). Pode-se designar um Virtual Keyboard padro, bem como aplicar uma Escala (tamanho)
para todos os Virtual Keyboards durante o runtime.
Ao configurar os objetos e dinmicos que suportem dados de entrada, Pode-se assinar um VK do
objeto pelo combo-box do VK (padro ou especfico). Esto disponveis os seguintes VKs padres:

Nome Figura Descrio
AlphaNumeric

Esse VK utilizado
para inserir valores
alfanumricos
(caracteres e/ou
nmeros).
IWS 20/06/2007

InduSoft Web Studio

Pgina 73
EnhKeypad

Esse VK utilzado para
inserir valores
alfanumricos
(caracteres e/ou
nmeros) em
equipamentos que
forneam uma pequena
tela (e.x. PDAs). O
Boto -> permite que os
usurios naveguem
atravs de diferentes
painis at encontrar o
caractere desejado.
Keypad

Esse VK utilizado
numricos (somente
nmeros).

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 dinmico de texto
I/O configurado com Input Enabled-entrada habilitada).
Executar a funo built-in Keypad().
Pode-se alterar o idioma do Virtual Keyboard atravs da funo built-in
SetKeyboardLanguage().

D 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 Ingls; VKGE=
Virtual Keyboards em Alemo, etc). Consulte seu fornecedor do software para
maiores informaes sobre como editar e configurar Esse arquivo.
Por padro, o VK encontrado perto do objeto na tela a ele associado. Porm,
Pode-se configurar os seguintes parmetros no arquivo <AplicaoName>.APP,
de forma que o VK sempre estar aberto em uma posio 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 disponvel para sistema operacional onde o IWS esteja
rodando. Portanto, possivel configurar interfaces com a utilizao de caracteres de idiomas que
no utilizem caracteres ocidentais de linguagem, como Japons, Chins, rabe, Cirlico, etc.
A fonte utilizada no ambiente de desenvolvimento do IWS (Planilhas, Dilogos, etc.) a fonte padro
instalada no ambiente de desenvolvimento e depende do idioma do sistema operacional. Clique na
opo de menu Edit Set Font para selecionar uma fonte distinta para o desenvolvimento.
IWS 20/06/2007

InduSoft Web Studio

Pgina 74
Ao editar objetos que exibam texto durante o runtime, Pode-se configurar a fonte na qual o texto
aparecer clicando no Boto Fonts na janela Object Properties. O Boto Font abre o dilogo padro
Font:

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

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

O cone exibido esquerda do nome da fonte indica a tecnologia da fonte.
cone Tecnologia Descrio

TrueType

OpenType
Outline
Fontes TrueType e OpenType fonts so fontes que so executadas
por comandos line e curve. OpenType uma extenso deType.
Ambas podem ser escalonadas e roteadas, tm boa aparncia em
todos os tamanhos e equiipamentos de output suportados pelo
Windows.
O Windows fornece uma seleo 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 so suportadas porque um nmero de programas
so dependentes dela. So executadas a partir de um modelo
IWS 20/06/2007

InduSoft Web Studio

Pgina 75
matemtico, e so utilizadas primariamente com plotters. O
Windows suporta trs vector fonts: Modern, Roman e Script.
N/A Raster
Fontes Raster so suportadas porque um nmero de programas
so dependentes dela.
Fontes Raster so armazenadas em arquivos como imagens
bitmaps e compostas de uma srie de pontos, exibidos em tela ou
papel.
recomendvel que se utilize somente as fontes TrueType ou OpenType fonts. Fontes projetadas
com outras tcnologias (e.x. Courier) no podem ser escalonadas de forma apropriada e podem
causar danos durante o runtime.
C Ateno:
Ao projetar telas, as fontes que podem ser utilizadas so aquelas disponveis no
sistema operacional de sua estao de desenvolvimento. As fontes na estao de
runtime, entretanto, podem aparecer diferentes (e.x. tamanho diferentes em pixels),
mesmo se as configuraes forem as mesmas em ambas as estaes. Tal situao
ocorre com maior frequencia quando as aplicaes esto rodando em sistema
operacional Windows CE, onde as fontes nem sempre se equivalem s proprores
das fontes do Windows NT/2K/XP. Portanto, importante testar as interfaces grficas
(telas) na plataforma de runtime atual durante o desenvolvimeto da aplicao. No
deve-se esperar at que toda a aplicao tenha sido desenvolvida, ou sera necessrio
reprojetar as telas de modo que os objetos de texto sejam exibidos da maneira
apropriada na plataforma de runtime.
Interface Color
Pode-se editar a cor de um componente utilizando Color interface.
E Clique no cone na barra de ferramentas:

E 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.
E Clique em More Colors caso voc deseje aplicar uma cor diferente. O dilogo Colors abrir,
exibindo as 143 cores padro de seu sistema operacional.
IWS 20/06/2007

InduSoft Web Studio

Pgina 76

Dilogo Colors
E Clique no tab Custom para editar os cdigos HSL (Hue, Sat, Lum) ou RGB (Red, Green, Blue) de
qualquer uma das 143 cores padro, criando assim uma cor customizada.

Tab Custom Colors
E Clique no Boto OK para aplicar a cor selecionada ao componente que est sendo editado.
E Dependendo do componente que est sendo editado, a opo Fill Effects estar disponvel na
interface pop-up (veja o Segundo passo acima). Clique nessa opo para aplicar coloraes
graduais com diferentes estilos e variaes. O dilogo Fill Effects abrir.
IWS 20/06/2007

InduSoft Web Studio

Pgina 77

Dilogo Fill Effects
E Selecione duas cores nos campos Start e End, selecione Style, e clique na variante escolhida.
Finalmente, clique no Boto OK para aplicar o efeito de preenchimento ao componente que est
sendo editado.
Nota:
Para aplicaes em sistema operacional WinCE, a interface Fill Effects est disponvel
somente para o objeto Rectangle.

C Ateno:
Embora Fill Effect seja uma ferramenta til para melhorar a aparncia e sensibilidade
das telas, o sistema operacional leva um tempo maior para preencher um objeto com
efeitos de preenchimento do que com cores padro. Deve-se estabelecer um critrio
para utilizar Esse recurso sem causar uma diminuio na performance do sistema,
especialmente sob sistema operacional WinCE.

Utilizando o cone dinmico, , Pode-se modificar a colorao de um objeto esttico durante o
runtime. Ao configurar Esse dinmico Type = By Color, Pode-se configurar a colorao que sera
aplicada no objeto durante o runtime, atravs do cdigo de cores. A tabela a seguir fornece os
valores do cdigo, bem como os valores RGB para as cores mais comumente utilizadas:

Cdigo RGB
Cor Nome
R (Red) G (Green) B (Blue)
Valor do
Cdigo
Black 0 0 0 0
Dark Red 128 0 0 128
Red 255 0 0 255
Pink 255 0 255 16711935
Rose 255 153 204 13408767
Brown 153 51 0 13209
Orange 255 102 0 26367
Light Orange 255 153 0 39423
Gold 255 204 0 52479
IWS 20/06/2007

InduSoft Web Studio

Pgina 78
Tan 255 204 153 10079487
Olive Green 51 51 0 13107
Dark Yellow 128 128 0 32896
Lime 153 204 0 52377
Yellow 255 255 0 65535
Light Yellow 255 255 153 10092543
Dark Green 0 51 0 13056
Green 0 128 0 32768
Sea Green 51 153 102 6723891
Bright Green 0 255 0 65280
Light Green 204 255 204 13434828
Dark Teal 0 51 102 7877376
Teal 0 128 128 8421376
Aqua 51 204 204 13421619
Turquoise 0 255 255 16776960
Light Turquoise 204 255 255 16777164
Dark Blue 0 0 128 8388608
Blue 0 0 255 16711680
Light Blue 51 102 255 16737843
Sky Blue 0 204 255 16737843
Pale Blue 153 204 255 16764057
Indigo 51 51 153 10040115
Blue-Gray 102 102 153 10053222
Violet 128 0 128 8388736
Plum 153 51 102 6697881
Lavender 204 153 255 16751052
Gray-80% 51 51 51 3355443
Gray-50% 128 128 128 8421504
Gray-40% 150 150 150 9868950
Gray-25% 192 192 192 12632256
White 255 255 255 16777215

D Dica:
As funes RGBColor() e RGBComponent() podem ser utilizadas para manipular cdigos
de cores durante o runtime.

Nota:
O nmero de cores disponveis ao desenvolver uma aplicao depende dos parmetros
de cores configurados no sistema operacional, na estao de desenvolvimento. O
nmero de cores disponveis ao rodar a aplicao (runtime) depende dos parmetros
configurados no sistema operacional da estao de runtime.

Tarefas Comuns de Execuo
As terafas comuns discutidas nessa seo consistem de procedimentos bsicos que voc poder utilizar
frequentemente, medida que trabalha com o ambiente de desenvolvimento do InduSoft Web Studio. Tais
tarefas incluem:
Accessar Projetos e Arquivos
Utilizar botes de comando
Gerenciar Janelas do Ambiente de Desenvolvimento
IWS 20/06/2007

InduSoft Web Studio

Pgina 79
Alterar Resoluo de Tela
Utilizar menus Pop-up
Utilizar Select All
Cortar, Copiar e Colar Objetos
Utilizar o cone Symbols Library
Encontrar informaes do sistema
Procurar tags e Objetos de tela
Substituir tags
Testar Exibies
Verificar a Aplicao
Rodar a Aplicaos
Restaurar Padres
Salvar seu Trabalho
Imprimir telas do projeto
Accessando Projetos e Arquivos
Para criar um novo projeto, veja o Captulo 6: Criando e Configurando um Projeto.
Abrindo projetos
Para abrir um projeto, na barra de menu Principal, selecione File Open Project.
Selecionar a opo Open Project exibe o dilogo Open, o qual lista todas as pastas existentes. Pode-
se utilizar o dilogo Open para localizar e abrir um projeto InduSoft Web Studio.

Dilogo Open
Nota:
De forma alternativa, Pode-se abrir um novo projeto utilizando um dos seguintes
mtodos:
Clique no Boto Open Project na barra de ferramentas Standard para exibir o
dilogo Open.
Abra o Windows Explorer, localize a pasta InduSoft Web Studio, e clique duas vezes no
nome do projeto.

IWS 20/06/2007

InduSoft Web Studio

Pgina 80
Abrindo arquivos
Na barra de menu Principal, selecione File Open File. Selecionar a opo Open File exibe o dilogo
Open (como mostrado na seo anterior), o qual lista todas as pastas existentes. Para localizar e
abrir um arquivo da aplicao do InduSoft Web Studio nesse dilogo, clique no Boto Files of type,
e depois clique em um nome de arquivo para selecion-lo a partir da lista.
Fechando projetos
Na barra de ferramentas Standard, selecione File Save para salvar quaisquer telas ou planilhas
ativas. A opo Save torna-se habilitada (ativa) somente ao modificar o arquivo ativo.

Nota:
Pode-se tambm utilizar o Boto Save ( ) na barra de ferramentas Standard ou
digitar Ctrl+s para salvar a planilha/tela ativa.

Na barra de ferramentas Standard, selecione File Save As para salvar telas ou planilhas ativas e
especificar um novo nome e localizao para esse arquivo.
Selecione a opo Save As HTML para salvar a exibio ativa em formato HTML.
Pode-se tambm seleconar File Save All na barra de menu para salvar todas as telas ou planilhas
abertas. A opo Save All torna-se habilitada (ativa) ao modificar o arquivo ativo.

Nota:
Utilizar File Save All o mesmo que apertar o Boto Save All ( ) na barra de
ferramentas Standard.

Selecione a opo File Save All As HTML para salvar todas as exibies da aplicao em formato
HTML. Deve-se fechar todos os documentos antes de executar esse comando.
Selecione File Save Screen Group As HTML para salvar o Screen Group em formato HTML
tornando-o disponvel para Web Thin Client remoto atravs 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 no todos as alteraes no salvas antes de fechar a tela/planilha.

Nota:
Utilizar File Close o mesmo que utilizar o Boto Exit ( ) localizado na barra de
ttulo.

Pode-se tambm selecionar File Close All. Selecionar a opo Close All fecha todas as telas ou
planilhas abertas. O IWS requisitar salvar ou no todos as alteraes no salvas antes de fechar a
tela/planilha.
Utilizando Botes Comuns
A tabela a seguir descreve botes que aparecem tipicamente no dilogo e janelas do IWS:

IWS 20/06/2007

InduSoft Web Studio

Pgina 81
Boto Propsito
OK Clique nesse Boto para executar e salvar todas as alteraes, e fechar o
dilogo ou janela.
Apply Clique nesse Boto para executar e salvar todas as alteraes, embora deixe o
dilogo ou janela abertos.Esse Boto habilita a vizualizao dos efeitos das
suas alteraes antes de fechar a janela/dilogo.
Cancel Clique nesse Boto para fechar o dilogo/janela imdiatamente (descartando
quaisquer alteraes).
Open Clique nesse Boto para abrir um arquivo. Geralemente, Esse Boto 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 Boto Open para abrir o
arquivo.
Close Clique nesse Boto para fechar o arquivo, tela dilogo, etc que estejam abertos.
Browse Clique nesse Boto para abrir um dilogo Browse para persquisar por um
arquivo ou pasta que estejam abertos.
Back Clique nesse Boto para voltar a uma tela prvia em uma sequencia de telas.
Next Clique nesse Boto par ir para aprxima tela em uma sequencia de telas.
Replace Clique para abrir um dilogo Replace, que habilita a troca de tags ou strings
associadas ao objeto de tela selecionado.
Remove Clique para remover um objeto selecionado (highlighted) de uma lista ou uma
exibio de tela.

Tabela de Botes Comuns
Alterando a Resoluo das Telas
Feche para abrir todos os documentos e selecione Tools Convert Resolution para abrir o dilogo
Convert Resolution, o qual permite a alterao da resoluo de sua aplicao.

Dilogo Convert Resolution
IWS 20/06/2007

InduSoft Web Studio

Pgina 82
Para alterar a resoluo de sua aplicao:
E Clique (habilite) o radio button da resoluo que voc deseja utilzar para converter a Aplicao.
E Clique no Boto Convert.
E Clique no Boto Close para fechar o dilogo ao terminar.
Antes de converter a Aplicao para sua nova resoluo, o IWS faz backup de todas as telas em
seus tamanhos anteriores em um pasta Backup localizada na pasta Screen de seu diretrio
\<Aplicao>\. O asterisco (*) prximo resoluo denota resoluo (base) atual. (Note: Ao
selecionar uma nova resoluo, todas as telas sero escalonadas a partir da nova base de
resoluo)
Utilizando Menus Pop-Up
Clicando com o Boto direito em qualquer componente do Workspace, aparecer um menu exibindo
com opes relacionadas quele componente. Por exemplo, o menu pop-up a seguir habilita Abrir o
tags database da Aplicao, Insert (criar) um novo tag ou Refresh para a visualizao do banco de
dados de tags atual da aplicao:

Clique com o Boto direito para abrir um Menu Pop-Up
Utilizando Select All
Na barra de menu, selecione Edit Select All para selecionar todos os objetos na tela ativa.
Cortar, Copiar, Colar Objetos
Na barra de menu, selecione Edit Cut para remover um item selecionado da tela, e armazen-lo
no clipboard do Windows (substituindo qualquer objeto selecionado anteriormente que esteja
armazenado no clipboard). Pode-se utilizar Cut junto opo File Paste para mover um objeto
para outro local na mesma tela, ou em outra tela distinta.
Nota:
Utilizar a opo de menu Cut o mesmo que utilizar o Boto Cut localizado na barra
de ferramentas Standard.

Na barra de menu, selecione Edit Copy para duplicar um item selecionado e armazen-lo no
clipboard do Windows. Utilize Copy juntamente opo Paste para substituir um objeto copiado
para outro local na mesma tela, ou em uma tela distinta. Pode-se colar um objeto copiado mltiplas
vezes.
Nota:
Utilizar a opo de menu Copy o mesmo que utilizar o Boto Copy localizado na
barra de ferramentas Standard.

IWS 20/06/2007

InduSoft Web Studio

Pgina 83
Na barra de menu, selecione Edit Paste para substituir contedos do clipboard do Windows
(objetos copiados ou cortados) para uma tela ativada. Caso o clipboard j contenha o objeto, o IWS
ir colar esse objeto no canto superior esquerdo da tela. Pode-se colar um objeto recortado ou
copiado mltiplas vezes.
Nota:
Pode-se facilmente copiar (arrastar) itens selecionados segurando-os simultanemante
com o Boto esquerdo do mouse e a tecla Ctrl.
Utilizar a opo de menu Paste o mesmo que utilizar o Boto Paste localizado
na barra de ferramentas Standard.

Pode-se selecionar Edit Undo para desfazer a ltima ao executada (e at 20 aes executadas
antes desta ltima) ao trabalhar na tela. (aes Object Properties no aumentam o nmero de
tarefas Undo).
Nota:
Utilizar a opo de menu Undo o mesmo que utilizar o Boto Undo localizado
na barra de ferramentas Standard.

Encontrando Informaes do Sistema
Na barra de menu, selecione Tools System Information para abrir a janela System Information, a
qual fornece informaes 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.
Aplicaos: Lista as Aplicaes rodando atualmente.
ProcEsses: Exibe todas as tarefas do Windows que esto rodando atualmente.
Services: Lista os servios do Windows NT/2000 que esto sendo utilizados pelo IWS (somente
Windows NT/2000).

Janela System Information
IWS 20/06/2007

InduSoft Web Studio

Pgina 84
Nota:
Embora voc abra a janela System Information a partir do IWS, essa janela fornecer
informaes gerais somente a respeito da estao local e rede de trabalho. A janela
System Information no exibe informaes especficas sobre a aplicao.

Pesquisando Tags - Utilizando a opo cone Find
Selecione Edit Find para abrir o dilogo Find, o qual permite a pesquisa de uma palavra na
planilha ativa.

Dilogo Find
Digite a string do texto no text box Find What e especifique parmetros de pesquisa clicando em
uma ou mais das seguintes opes:
Match whole word only: O IWS pesquisa somente o item especificado, no incluindo amostras
onde o termo especificado parte de uma palavra inteira. Por exemplo, especificando a palavra
back, o IWS encontrar somente back, e no backward.
Match case: O IWS pesquisa pelo termo utilizando o cone specificado, da forma como foi
escrito. Por exemplo, especificando TankLevel, o IWS no pesquisar por tanklevel.
Direction: Controla em qual direo o IWS deve pesquisar atravs da planilha (Up ou Down).
Clique no Boto Find Next para iniciar a busca. (Clique no Boto novamente para organizar a
pesquisa da planilha.)
Utilizando a opo Go To
No menu principal, selecione Edit Go to para pular um linha em uma planilha aberta ou para
selecionar um objeto utilizando o nmero ID do objeto. O IWS aplica um nmero sequencial de
identificao (ID) para cada objeto criado na tela. Ao selecionar um objeto, o nmero ID aparece na
barra de status. Os objetos so numerados de acordo da forma com suas camadas, iniciando- se
com zero (o primeiro objeto). Esses objetos so renumerados ao traz-los para frente ou para trs.
Ao agrupar objetos, estes tornam-se um nico.

Dilogo Line
Para pular uma linha ou um objeto, selecione Go to. Quando aparecer o dilogo Line, digite o
nmero da linha ou nmero ID do objeto no text box Number e clique no Boto OK.
IWS 20/06/2007

InduSoft Web Studio

Pgina 85
D Dica:
Caso voc possua muitos objetos superpostos, e no possvel selecionar um objeto
utilizando o equipamento de apontamento, Pode-se utilizar a opo Go to para editar as
propriedades de um objeto que esteja abaixo de outros objetos.

Utilizando a Barra de Ferramentas Tag Properties
A barra de ferramentas Tag Properties fornece um text box, alm de vrios botes (atalhos) que
permitem a criao, localizao e acesso a diferentes tags, funes, e propriedades do tag.

Barra de ferramentas Tag Properties
Utilizando o cone Object Finder
Clique no Boto Object Finder para abrir o dilogo Object Finder, que lista todos os Tags e
Funes atualmente configuradas para a aplicao.

Dilogo Object Finder
Para selecionar uma funo/tag j existente, clique duas vezes no nome da funo/tag e clique
em OK para fechar o dilogo. O nome selecionado aparecer no text box Tagname.
Para selecionar um ndice array especfico, clique no Boto Index aps ter especificado o nome
do tag array.
Para selecionar o nome especfico de um membro, clique no Boto Member aps ter
especificado o nome da classe do tag.
Para criar um novo tag, clique no Boto New.
Quando aparecer o dilogo New Tag, insira a seguinte informao e depois clique em OK para
fechar o dilogo:
Name
Array Size
Type (Boolean, Integer, Real, String, Class:Control, Class:msgonline, or Class:Alr)
IWS 20/06/2007

InduSoft Web Studio

Pgina 86
Description
Web data (local ou server)
Utilizando a opo X-ref
Clique no Boto Cross Reference para pesquisar em todas as telas e planilhas da aplicao
anotadas no text box Tagname. Essa funo escreve um log, detalhando todas as ocorrncias do
tag, para o tab XRef na janela Output. Por exemplo, os resultados da pesquisa para um tag
BlinkFast so os seguintes:

Resultados para XRef
Veja tambm Utilizando a Janela Output na pgina 70.
Utilizando a opo Global Tags Replace
Ao selecionar o Boto Global Tags Replace na barra de ferramentas Tag Properties, aparecer o
dilogo Global Replace:

Dilogo Global Replace
No dilogo Global Replace, Pode-se substituir qualquer tag(s) de todos os documentos (telas e
planilhas) em toda a aplicao. Pode-se editar as colunas From e To.
Ao substituir tags compostas (array size > 0 e/ou Type = Class), Pode-se configurar uma posio
especfica de array (por exemplo, TagA[1]) ou um mebro de classe (por exemplo, TagB.MemberX) ou
ambos (por exemplo, TagC[3].MemberY). Caso voc configure somente Main Tag Name (por exemplo,
TagC) na coluna From, todos os tags provenientes desse tag principal sero modificados para o tag
configurado na coluna To.
IWS 20/06/2007

InduSoft Web Studio

Pgina 87
Caso uma substituio invlida seja configurada (por exemplo, substituir o tag Main Tag de um tipo
de classe por um tag simples que no seja um tag de classe), o Boto OK sera disabled. Quando o
Boto OK for pressionado, os tags configurados no dilogo Global Replace sero substitudos pelo
modo como foram configurados na interface do dilogo.
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 aplicao.
A opo Replace ser criada no menu Edit. Utilizar essa opo habilita prontamente o dilogo
Global Replace, porm as alteraes sero aplicadas somente tela ou planilha que esto abertas
no momento.
Substituindo Tags
Clique duas vezes no objeto para abrir o dilogo Object Properties. Para substituir tags, selecione o
Boto Replace localizado no dilogo Object Properties.

Dilogo Object Properties
IWS 20/06/2007

InduSoft Web Studio

Pgina 88
Pode-se selecionar um ou mais tags para serem substitudos atravs do tab Replace Strings. Os
tags utilizados atualmente sero exibidos. Voc pode digitar em New Tag a direita de cada Current
Tag.

Tab Replace Tags
Pode-se tambm selecionar uma ou mais strings para substituio selecionando o tab Replace
Strings. Strings atuais utilizadas sero exibidas. Voc poder digitar em New String direita de
cada Current String.
Ao terminar clique no Boto OK.

Tab Replace Strings
IWS 20/06/2007

InduSoft Web Studio

Pgina 89
Testando Exibies
Na barra de menu, selecione Project Test Display para ativar o modo de testar a exibio, que
permite a configurao da aplicao ao mesmo tempo que se visualize dinmicos grficos online no
ambiente de desenvolvimento. O modo de exibio do tipo teste no habilita a utilizao de
Comandos ou dinmicos de entrada Text I/O, bem como execuo de planilhas.
Nota:
Utilizar a opo Test Display do menu o mesmo que utilizar o Boto na barra de
ferramentas Execution Control.

Para parar o modo de exibio teste, selecione Project Stop display test.
Nota:
Utilizar a opo Stop display test do menu o mesmo que utilizar o Boto na barra
de ferramentas Execution Control.
Verificando a Aplicao
Na barra de menu, selecione Tools Verify Application para recompilar planilhas algortmicas e
telas de lgica, alm atualizar os arquivos HTML atuais, utilizando os parmetros configurados no
tab Web (dilogo Project Settings). Os Tags no banco de dados so remapeados para todas as telas e
planilhas.

Verificando uma Aplicao
D Dica:
Ao salvar uma tela ou planilha, o IWS inclui um apontador para a verso do banco de
dados atual. Ao executar a aplicao, o IWS compara a tela ou planilha ao banco de
dados da aplicao atual, e caso exista alguma discordncia, o IWS recompile as
expresses.
Para evitar efetuar essas tarefas durante o runtime da aplicao, recomendamos rodar
a funo Verify Application antes de fazer download e/ou finalizar uma Aplicao. Deve-
se utilizar essa funo ao converter uma aplicao para uma nova verso do programa.

Nota:
O comando Verify Application deleta os arquivos *.txt e *.tag da pasta \Screen para
salvar espao em disco e limpar a aplicao antes de ser deployed para a estao de
runtime.

IWS 20/06/2007

InduSoft Web Studio

Pgina 90
Rodando Aplicaes
Na barra de menu, selecione Project Run Application para iniciar os mdulos de runtime
especificados como Automatic no dilogo Project Status (tab Execution Tasks).
Ao iniciar o mdulo Viewer, ele abre a tela(s) que esto sendo atualmente editadas.
Caso voc no especifique tarefas Automatic, o InduSoft Web Studio iniciar as tarefas Viewer e
BGTask automaticamente ao executar Run Aplication.
Caso voc no esteja editando telas atualmente no ambiente de desenvolvimento, o mdulo
Viewer abre a tela especificada no campo Startup screen no tab Runtime Desktop (dilogo
Project Settings).
Nota:
Utilizar a opo Run Application o mesmo que utilizar o Boto na barra de

C Ateno:
Run Application afeta a aplicao desde sua target station (configurada no dilogo
Execution Environment). Ceritifique-se de qual target station est configurada (local ou
remota) antes de executar o comando Run Application.

Para parar todas as tarefas de runtime, selecione Project Stop Application.
C Ateno:
Stop Application afeta a aplicao desde sua target station (configurada no dilogo
Execution Environment). Certifique-se de qual target station est configurada (local ou
remota) antes de executar o comando Stop Application.

Nota:
Utilizar o cone Stop Application o mesmo que utilizar o Boto na barra de

Restaurando Padres
Na barra de menu, selecione View Restore Defaults aps adicionar ou modificar a interface para
retornar ao ambiente de desenvolvimento padro do IWS. Ser necessrio fechar e reabrir o IWS
para que as alteraes sejam aplicadas.
Salvando seu Trabalho
Clique no Boto Save para salvar quaisquer telas ou planilhas ativas.
Notas:
Utilizar o Boto Save o mesmo que selecionar File Save da barra de menu ou
digitar a combinao de teclas Ctrl+ S.
A funo Save torna-se disponvel somente quando voc modifica o arquivo ativo.

Clique no Boto Save All pilhas abertas.
IWS 20/06/2007

InduSoft Web Studio

Pgina 91
Nota:
Utilizar o Boto Save All o mesmo que selecionar File Save All na barra de menu.
A funo 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 dilogo Print Setup. A partir desse
dilogo, voc poder especificar qual impressora utilizar, e como configurar diferentes opes de
impresso, como tamanho do papel e orientao de impresso (retrato ou paisagem).

Dilogo Print Setup
Nota:
Para especificar uma impressora padro:
V para o menu Start e selecione Start Settings Printers.
Ao aparecer o dilogo Printers, clique com o Boto direito no nome da impressora.
Ao aparecer o menu pop-up, selecione Set As Default.
Um check aparecer prximo a Set As Default indicando que a impressora selecionada
o padro.
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 botes localizados ao longo da parte superior da janela Print Preview como se segue:
Clique Print para abrir o dilogo Print e imprimir a tela ou planilha (o mesmo que utilizar o
comando File Print).
Clique Next Page para visualizar a prxima pgina de uma srie de pginas.
Clique Prev Page para visualizar a pgina anterior de uma srie de pginas.
Clique Two Page para visualizar duas pginas ao mesmo tempo.
Clique Zoom In para verificar detalhes.
Clique Zoom Out Para voltar ao tamanho padro.

Notas:
Os botes Next Page, Prev Page, e Two Page tornam-se ativos somente quando voc
est imprimindo mais de uma pgina.
O Boto Zoom Out torna-se ativo aps voc efetuar Zoom In.

Clique Close para fechar a janela Print Preview.
Pode-se tambm selecionar File Print na barra de menu e abrir o dilogo Print (idntico ao
dilogo Print Setup discutido previamente). Pode-se utilizar o dilogo Print para imprimir telas ou
planilhas ativas.
Nota:
Selecionar o menu Print o mesmo que utilizar o Boto Print na barra de
ferramentas Standard.
IWS 20/06/2007

InduSoft Web Studio

Pgina 93
Dicas e Truques
Essa seo fornece dicas e truques ties para ajud-lo a obter vantagem maxima das ferramentas
fornecidas pelo IWS, melhorando sua produtividade ao desenvolver aplicaes 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 configurao dos parmetros do objeto selecionado. O
contedo dessa janela de dilogo varia de acordo com o objeto/dinmico especfico que est sendo
editado. Porm, sempre existe um Boto pin no canto esquerdo e acima nessa janela de dilogo:

Dilogo Object Properties
O Boto pin aparece dessa forma, , quando liberado, e quando pressionado, aparecer assim
.

Quando o Boto pin est liberado, o foco passado para o objeto na tela assim que esse seja
selecionado, portanto, recomendamos que voc mantenha esse Boto liberado quando deseja-se
manipular (copiar, colar, cortar ou deletar) objetos. Embora a janela Object Properties esteja na
parte superior, os commandos do teclado (Ctrl+C, Ctrl+V, Ctrl+X ou Del) so enviados diretamente
aos objetos.

Quando o Boto pin est habilitado, o foco mantido na janela Object Properties, mesmo ao clicar
nos objetos da tela. Recomendamos que voc mantenha esse Boto habilitado quando desejar
modificar as configuraes dos objetos. Pode-se clicar em um objeto e digitar um novo valor de
propriedade diretamente na janela Object Properties (no necessrio clicar na janela para que o
foco volte-se para ela).Alm disso, quando o Boto pin est habilitado, a janela Object Properties
No se fecha de forma automtica ao clicar na tela.
Importando um Banco de Dados
Import Wizard uma ferramenta poderosa que reduz o tempo de engenharia durante o
desenvolvimento da aplicao. Utilizando o cone Import Wizard, voc pode importar tags de
diferentes origens de dados diretamente para o Banco de Dados de Tags do IWS. Dependendo da
origem dos dados, Pode-se importar no somente nomes de tags como tambm interfaces de
comunicao (o link entre os tags e os endereos PLC).
Ao selecionar File Import Wizard, um dilogo Import Database Wizard aparecer para gui-lo
atravs do processo de importao de tags. Existem trs passos para a importao de tags a partir
desses tipos de origens de dados:
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 Boto data Source Type, de onde os dados esto sendo importados. Clique no Boto Next.
IWS 20/06/2007

InduSoft Web Studio

Pgina 95
passo 2: Configurar os parmetros do tipo de origem

Import Wizard Selecionando o Tipo de Origem de Dados
A maioria das configuraes na segunda janela dependem do tipo de Origem de Dados selecionado
no primeiro passo. O screenshot acima um exemplo de um Tipo de Origem de Dados (OPC Server
Database). As configuraes mais comuns para qualquer data Source Type so as descritas abaixo:
Options box: Selecione Do not import duplicated tags caso voc no queira tags importados para
reescrever tags com o mesmo nome j existente no Banco de Dados de Tags da aplicao atual.
Selecione Replace duplicates with tags imported para reescrever tags no Banco de Dados de
Tags com tags importados de mesmo nome.
Use Prefix: Verifique para especificar um prefixo (de at 4 caracteres) para ser concatenado ao
nome de tags importados. vantajoso utilizar um prefixo a fim de diferenciar os tags
importados daqueles criados manualmente.
Nota:
Para utilizar a opo Remote, o InduSoft Web Studio dever estar rodando em
um computador remoto.
Aps configurar os parmetros nessa janela de dilogo, clique no Boto Next.
IWS 20/06/2007

InduSoft Web Studio

Pgina 96
passo 3: Filtrar os tags

O screenshot acima um exemplo de um Tipo de Origem de Dados (OPC Server Database). Os
campos e configuraes que so comuns para todos os Tipos de Origem de Dados incluem os que
se seguem:
Grid: Displays the list of tags found on the data source.
Nome do
Campo
Descrio
Check-box
Habilite para importar tag da origem de dados para o Tags Database da
aplicao 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 Descrio do tag
Check Boto: Clique para selecionar/importar todos os tags no grid.
Uncheck Boto: Clique para desabilitar todos os tags no grid.
Filter Boto: Clique para filtrar os tags. A janela de dilogo Filter aparecer, permitindo a
especificao de uma mask para cada coluna no grid. Wild cards (* and ?) podem ser usados
para filtrar dados.
Clear filter Boto: Clique para reiniciar o filtro.
Import Filtered Tags Only check-box: Cheque essa opo para importar somente os tags que
estejam visves no grid (filtrados).
Status box: Exibe mensagens descrevendo o status do tag atualmente selecionado no grid. Essa
informao especialmente til para indicar por que o tag no pode ser importado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 97
Legend box: Desceve o significado das cores que representam o status do tag:
Cor Significado Descrio
Red Error
Tag no pode ser importado por no ser
suportado pelo IWS. Veja oStatus box para
uma descrio detalhada do erro.
Blue Tag will be imported
Tagser importado aps clicar no Boto
Finish.
Gray Tag can be imported
Tag pode ser importado, embora no tenha
sido verificado.
Database size box: Exibe informaes resumidas do Import Wizard atual:
Marca Descrio
Current
Indica o nmero de tags configurados no banco de dados de tags da aplicao
atual.
Importing Indica o nmero de tags selecionados para serem importados.
Replacing
Indica o nmero de tags configurados no Banco de Dados de Tags da
aplicao atual, os quais sero substitudos pelo tag importado de mesmo
nome.
Aps selecionar os tags a serem importados, clique no Boto Finish ou clique em Cancel para
abortar a operao.
As outras configuraes variam de acordo com a origem de dados selecionados no primeiro passo, e
so descritos nas sees especficas para cada tipo de origem de dados, como se segue:
o Importando a partir de outros Banco de Dados do InduSoft Web Studio
o Importando a partir de OPC Server Databases
o Importando a partir de CSV Databases
o Importando a partir de ODBC Databases
o Importando a partir de PanelBuilder Database Wizard
o Importando a partir de RSLogix 5000 CSV Database Wizard
o Importando a partir de OMRON CX Programmer Databases
o Importando a partir de PanelMate Plus Database Wizard
Importando a partir de outros Banco de Dados do InduSoft Web Studio
Esse wizard permite a importao de interfaces (tags e planilhas) a partir de outras aplicaes do
IWS. Ao importar somente tags, a partir de um computador remoto, a planilha TCP/IP Client
poder ser automaticamente criada para estabelecer um link entre os tags e ambas as estaes
(local e remota), e compartilhar os valores desses tags entre ambas as estaes durante o runtime.
IWS 20/06/2007

InduSoft Web Studio

Pgina 98

Importando a partir do InduSoft Web Studio Database Wizard

Campo Descrio
Import tags only Quando essa opo est selecionada, os tags de outra aplicao
sero importadas para a aplicao atual. As outras interfaces da
aplicao (planilhas) no sero importadas.
Import the whole
Aplicao
Quando essa opo est selecionada, as seguintes interfaces de
outra aplicao sero importadas para a aplicao atual:
Tags Database
Global Procedures
Tags Database
Global Procedures
Screens
Group Screens
Web Pages
Alarms
Trend
IWS 20/06/2007

InduSoft Web Studio

Pgina 99
Recipes
Reports
ODBC
Math
Script
Scheduler
Drivers
OPC
TCP/IP
DDE
Essa opo til para unir aplicaes e aplicaes exemplares de
importao (s).
Nota:
Ao selecionar a opo para importar toda a aplicao, as
planilhas a seguir sero sempre importadas (exceto aquelas j
existentes que possuam o mesmo nmero na aplicao atual):
ODBC, Math, Script, Scheduler, Drivers, OPC, TCP/IP and DDE.
Caso exista planilhas com o mesmo nmero na aplicao atual,
as planilhas importadas sero inseridas como planilhas
adicionais na Aplicao atual (o nmero de cada planilha
automaticamente aumentado para evitar substituio de
arquivos da aplicao atual.
Do not import
duplicated
Quando essa opo est selecionada, as interfaces a seguir no
so importadas em caso de j existir uma interface equivalente na
Aplicao atual:
Tags Database (tags de mesmo nome no sero importados)
Global Procedures (os Procedimentos globais no sero
importados)
Screens (telas com o mesmo nome no sero importadas)
Group Screens (grupos de telas de mesmo nome no sero
importados)
IWS 20/06/2007

InduSoft Web Studio

Pgina 100
Web Pages (web pages de mesmo nome no sero importadas)
Alarms (alarmes assinados a tags com mesmo nome no sero
importados)
Trends (trend logs assinados a tags com mesmo nome no sero
importados)
Recipes (recipes com mesmo nome no sero importados)
Reports (reports com mesmo nome no sero importados)
Script (the Startup Script com mesmo nome no ser importado)
Replace
duplicated with
imported
Quando essa opo est selecionada, as interfaces de outra
aplicao sero importadas, e as interfaces da Aplicao atual com
mesmo nome (caso haja) sero reescritas.
Local Selecione essa opo para importar tags de uma Aplicao
armazenados no computador local para a aplicao atual. Para isso,
clique no Boto Browse e selecione o arquivo *.APP da Aplicao que
possua os tags que voc deseja importar.
Remote Selecione essa opo para importar tags de uma Aplicao que
esteja rodando em uma estao remota. Digite um endereo IP (ou o
host name) do computador remoto, no campo Remote. Os tags da
aplicao atual do computador remoto estaro disponveis para
importao. Essa opo est disponvel para importar tags only,
mas no para whole Application.
Generate TCP/IP
Client worksheet
Ao selecionar Remote (ao inves de Local) e checar essa opo, o IWS
configurar a planilha TCP/IP Client automaticamente a fim de
trocar dados com a aplicao remota.
Use Prefix Cheque para especificar um prefixo (de at 4 caracteres) para ser
concatenado ao nome dos tags importados. Tal funo til para
utilizar um prefixo a fim de diferenciar os tags importados daqueles
criados manualmente.

IWS 20/06/2007

InduSoft Web Studio

Pgina 101
Importando a partir de OPC Server Databases
Esse wizard permite importar tags tanto de OPC Servers remotos quanto de Locais. Ao importar
tags do OPC Server, a planilha OPC Client autimaticamente criada para estabelecer um link entre
tags, eliminando a necessidade de configurar uma interface de comunicao entre o OPC Client do
IWS e um OPC Server externo.

Wizard Import OPC Server Database
Local/Remote: Fornece as seguites opes:
Server Descrio
Local
Selecione essa opo para importar tags de um OPC Server
instalando no computador local.
Remote
Selecione essa opo para importar tags de um OPC Server
instalando em um computador remoto. Digite o Endereo IP (ou the
host name) do computador remoto no campo Remote de onde o IWS
est rodando.
combo-box Merge Local e Remote OPC Servers: Caso vo selecione um Remote server, habilite
essa opo para exibir a lista de OPC Servers instalados no computador local e tambm no
computador remoto. Desabilite esse check-box para exibir somente a lista de OPC Servers
instalados no computador remoto.
combo-box Identifier: Exibe a lista de OPC Servers disponveis.
Branch: Clique no Boto Browse para selecionar o branch do OPC Server do qual os tags (itens)
sero importados. Deixe esse campo em branco caso voc deseje importar tags de todos os
branches configurados no OPC Server.
check-box Use the item path for the tagname: Habilite essa opo para concatenar o caminho
para o nome do item ao importar tags do OPC Server. Desabilite essa opo para utilizar
somente os nomes dos itens configurados no OPC Server.
No grid exibido no terceiro passo () para esse Data Source Type, existe um campo adicional com
a marca OPC, que exibe o nome dos itens existentes no OPC Server.
IWS 20/06/2007

InduSoft Web Studio

Pgina 102
Nota:
Veja os passos 1, 2 e 3 na seo acima para configuraes e campos comuns a
todos os Source Types.
Importando a partir de CSV Databases
Esse wizard permite importar tags de um campo de texto no formato CSV (Comma Separated
Values) ou qualquer formato similar.

Wizard Import CSV Database
File Name: Pressione o Boto Browse para selecionar o campo de texto do qual os tags sero
importados.
Data Column box: Selecione um nmero para cada propriedade de tag que corresponda ao
nmero da coluna no arquivo de importao. Por exemplo, caso Tag, Array Size e Type estejam
listados nas segunda, terceira e quarta colunas do arquivo de importao, respectivamente,
selecione 2 em Tag, 3 em Array Size e 1 em Type. A propriedade Tag (nome do tag) obrigatria,
embora as outras propriedades sejam opcionais.
Para propriedades que no estejam includas no arquivo de texto, selecione a opo Not used. O
IWS ir inserir padres ou deixar o campo em branco, de acordo com a seguinte tabela:
Propriedade Valor Padro
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 (padro). Pode-se selecionar
mais de um delimitador em algum momento, alm de poder tambm utilizar a opo Other para
inserir um delimitador customizado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 103
Nota:
Veja os passos 1, 2 e 3 na seo acima para as configuraes e campos que so
comuns para todos os Source Types.
Importando a partir de ODBC Databases
Esse wizard permite importar tags a partir de um Banco de Dados SQL Relational externo, como
Microsoft Access, SQL Server, Oracle, My SQL, Sybase e outros, atravs da interface ODBC (Open
DataBase Connectivity).

Wizard Import ODBC Database
Boto Select Data Source: Clique para selecionar o ODBC Data Source Name (DSN) vinculado
ao banco de dados do qual os tags sero importados. O DSN deve ter sido previamente criado
na janela Data Sources (ODBC) (Control Panel Administrative Tools Data Sources
[ODBC]). Aps selecionar um DSN, os outros campos dessa janela sero povoados de forma
automtica com informaes do banco de dados selecionado.
combo-box Table: Selecione a tabela que mantenha os dados no banco de dados de importao.
combo-box Tag: Selecione o nome da coluna que mantenha os tags no banco de dados de
importao.
combo-box Array Size: Selecione o nome da coluna que mantenha o tamanho do array para os
tags no banco de dados de importao.
Type combo-box: Selecione o nome da coluna que mantenha o tipo de tag type no banco de
dados de importao.
Description combo-box: Selecione o nome da coluna que mantenha a descrio do tag no banco
de dados de importao.
Web Data combo-box: Selecione o nome da coluna que mantenha os Dados da Web para os tags
no banco de dados de importao.
IWS 20/06/2007

InduSoft Web Studio

Pgina 104
Nota:
Veja Passos 1, 2 e 3 na seo acima, para as configuraes e campos comuns
para todos os Source Types.
Importando a partir de RSLogix 5000 CSV Databases
Esse wizard permite importar tags a partir de um programa para ControlLogix/FlexiLogix PLC
desenvolvido com RSLogix 5000 e expostado para um arquivo CSV. Ao importar tags da arquivo
CVS RSLogix 5000, a planilha do driver ABCIP automaticamente criada para fazer um link entre
os tags importados com o PLC, eliminando a necessidade de configurar a interface de comunicao
entre o IWS e o PLC manualmente.

Importing Data from the RSLogix 5000 CSV Database
PLC Options box: Fornece as seguintes opes:
Option Description
Scope (Folder Name):
Use Full Scope
Do Not Use Scope
Use Limited Scope

Selecione Use Full Scope para importar os tags utilizando o cone
full scope configurado no programa PLC.
Selecione Do Not Use Scope para ignorar o escopo dos tags
configurados no programa PLC.
Selecione Use Limited Scope para configurar o nmero de
caracteres do escopo que devem ser utilizados ao importar os tags
do programa PLC.
PLC IP Address
Digite o Endereo IP do PLC. Essa informao sera utilizada para
configurar as planilhas do driver de comunicao
automaticamente.
IWS 20/06/2007

InduSoft Web Studio

Pgina 105
CSV File: Clique no Boto Browse para selecionar o arquivo CSV exportado pelo RSLogix
5000 com a lista de tags configuradas no programa do PLC.
L5K File: Clique no boto Browse para selecionar o arquivo L5K salvo pelo RSLogix 5000 com
a lista de tags UDT (User Defined Type) configurados no porgrama PLC. Esse arquivo opcional
para o wizard. Porm, caso esse arquivo no esteja selecionado, os tags UDT no sero
importados.
Create class tags when suitable: Cheque esse check-box para criar tags e classes de tags UDT
importados do programa PLC. Desabilite esse check-box para importar tags como tags simples
(diferente de tipo de classe) do programa PLC.
No grid exibido Passo 3 (Importando um Banco de Dados) para esse Data Source Type, existe
um campo adicional com a marca Address, que exibe o nome dos itens do programa RSLogix.
Nota:
Veja Passos 1, 2 e 3 na seo acima, para as configuraes e campos comuns
para todos os Source Types.
Importando a partir de the PanelMate Database Wizard
C Ateno:
Esse wizard fornecido como um adicional e requer uma licena para ser habilitado.
Consulte seu vendedor do software para maiores informaes.
Esse wizard permite importar no somente tags como telas, configuraes de alarme e interface de
comunicao de um projeto criado com o software PanelMate Plus software. Utilizando esse
wizard, pode-se converter uma aplicao PanelMate Aplicao (desenvolvida com o PanelMate
Plus) para o formato do IWS e rod-lo sob qualquer plataforma suportada pelo IWS.

Wizard Import PanelBuilder Database
IWS 20/06/2007

InduSoft Web Studio

Pgina 106
Import Screens: Habilite essa opo para importar as telas grficas (incluindo objetos e
dinmicos) para o IWS.
PanelMate Model: Pressione o boto Browse para selecionar o diretrio onde os arquivos do
banco de dados do projeto PanelMate Plus que voc pretende importar esto armazenados.
Aplicao: Aps selecionar o caminho correto no campo PanelMate Model, as aplicaes
disponveis nesse diretrio estaro disponveis nesse combo-box. Selecione a Aplicao que voc
pretende importar antes de pressionar o boto Next.
D Dica:
Consulte a documentao desse import wizard para informaes detalhadas
sobre como exportar uma Aplicao do software PanelMate Plus para o IWS.

Nota:
Veja os Passos 1, 2 e 3 na seo acima para as configuraes e campos
Importando a partir de OMRON CX Programmer Databases
C Ateno:
Esse import wizard cria o driver de comunicao para o OMRON, o qual
habilitado somente para clientes que adquiriram o produto diretamente da
OMRON. Consulte seu vendedor de software para maiores detalhes. Mais do
que isso, o driver de comunicao OMRON comunica-se com PLCs atravs do
FINS Gateway, suportado pelos sistemas operacionais Windows 2000/XP.
Portanto, FINS Gateway deve estar instalado no computador para habilitar a
comunicao entre o IWS e PLCs atravs do driver da OMRON.
Esse wizard permite importar tags de um programa para PLCs OMRON desenvolvidos com CX
Programmer e exportados para um arquivo CXT. Ao importar tags do arquivo CX Programmer CXT,
a planilha de trabalho OMRON automaticamente criada para estabelecer Link entre tags
importados e o PLC, eliminando a necessidade de configurar a interface de comunicao entre o
IWS e o PLC manualmente.
IWS 20/06/2007

InduSoft Web Studio

Pgina 107

Wizard Import OMRON CX Programmer Database
Prefix: Esse box permite a concatenao de um dos seguintes tipos e prefixos para os tags
importados do programa CX Programmer:
Prefixo Descrio
Custom
Habilite essa opo para concatenar um prefixo customizado com at 8
caracteres para o nome dos tags importados.
PLC
Habilite essa opo para concatenar o nome ou nmero do PLC ao nome
dos tags importados.
Program
Habilite essa opo para concatenar o nome ou o nmero do Programa ao
nome dos tags importados.
Serial Auto Address: Esse box permite configurar o Network Address e o Initial Node Address
para os PLCs configurados no produto com comunicao Serial (caso haja):
Configurao Descrio
Network
Address
Essa configurao sera aplicada para todos os PLCs configurados no projeto
com comunicao Serial.
Node
Address
Essa configurao sera aplicada para o primeiro PLC configurado no projeto
com comunicao Serial. Tal configurao sera incrementada e aplicada aos
PLCs subsequentes configurados no produto com comunicao Serial.
CXT File: Clique no boto Browse para selecionar o arquivo CXT, exportado pelo CX
Programmer, do qual os tags sero 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 seo acima para as configuraes e campos
IWS 20/06/2007

InduSoft Web Studio

Pgina 108
Importando a partir de TwinCAT PLC Databases
Esse wizard permite importar tags de um programa desenvolvido com o software de controle
baseado em PC (TwinCAT PC-Based Control software) pela Beckhoff e exportado para um arquivo
Report (*.SYM). Ao importar tags do arquivo TwinCAT PC-Based Control SYM, a planilha de driver
do TWCAT automaticamente criada para estabelecer um link entre tags importados e o projeto
PC-Based control, eliminando a necessidade de configurar a interface de comunicao entre o IWS e
o software PC-Based Control manualmente.

TwinCAT PLC: Esse box permite ao usurio configurar os seguintes parmetros:

Configurao Descrio
MAS Net ID Digite o ID AMS Net ID do projeto TwinCAT.
TCP Port
Selecione uma porta TCP utilizada pelo driver para trocar dados com
o software TwinCAT PC-Based Control durante o runtime. Pode-se
selecionar uma das portas TCP padro (801, 811, 821 or 831), ou
digitar o nmero de uma porta TCP customizada para ser usada na
comunicao.
Report File
Clique no boto Browse para selecionar o arquivo .SYM do qual tags
devem ser importados.
Mdulos de Desenvolvimento
Essa seo mostra uma viso geral de grficos e mdulos de desenvolvimento de tarefas. Para
maiores informaes, veja o Captulo 7: Configurando Telas e Grficos e Captulo 8: Configurando
Planilhas de Tarefas.
Grficos
A funo mais bsica executada pelo InduSoft Web Studio o fornecimento de uma janela dentro
do porcesso. A habilidade para exibir o status do processo pela interao com instrumentao (ou
computadores), descrita como um Interface Homem-Mquina (HMI).
O InduSoft Web Studio permite a criao de aplicaes que Podem monitorar processos com a
utilizao de telas coloridas de alta resoluo.
IWS 20/06/2007

InduSoft Web Studio

Pgina 109
As ferramentas grficas do InduSoft Web Studio consistem de dois mdulos:
Screen/Worksheet Editor na area de trabalho do InduSoft Web Studio (utilizado para criar ou
importar grficos)
Viewer do runtime da aplicao
Pode-se utilizar animation links para criar objetos de grficos dinmicos ou smbolos. Links de
animao provocam a alterao da aparncia de objetos e smbolos, refletindo essas alteraes no
valor de um tag ou em uma expresso. Cada tela uma associao de objetos dinmicos e
estticos.
Telas podem ter um bitmap opcional que atua como um background na janela do objeto. Na tela a
seguir, por exemplo, as imagens estticas Podem ser parte de um bitmap no objeto de fundo e
objetos animados em camadas de objetos dinmicos Podem refletir as alteraes na planta, dando a
impresso de que a tela tridimensional.

Exemplo de Tela de Emulao do CEView
Todas as tarefas de configurao do IWS requerem um equipamento apontador compatvel com o
Windows, como mouse ou touch pad. Pode-se rodar a aplicao no Viewer sem a utilizao de um
apontador caso voc configure keypads ou teclas para todos os comandos.
Tarefas
Utiliza-se o tab Tasks do IWS para configurar planilhas tarefa-especficas, cada uma composta de
um Cabealho (onde voc define informaes globais da planilha) e um Corpo (onde voc configure
os tags e expresses utilizadas em cada tarefa).
You can configure the following task-specific worksheets:
Alarm Groups : Utilize para definir um grupo de alarme, suas caractersticas e suas
mensagens, que sero reportadas em condies de alarme. O propsito principal desses
alarmes de informar os operadores a respeito de qualquer problema ou alterao de estado
durante o processo; dessa forma, aes 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 mantero uma sequencia do
comportamento das variveis do processo. Pode-se armazenar amostras em um arquivo
histrico e exibir ambos em amostras online, em um grfico de tendncias de tela.
Recipes : Utilize para ler e escrever arquivos ASCII de e para o hard disk, alm de transferir
valores entre arquivos e memria de tempo real. Tipicamente, Pode-se armazenar receitas de
IWS 20/06/2007

InduSoft Web Studio

Pgina 110
processos, embora tais arquivos possam armazenar qualquer tipo de informao, como
operaes de log, senhas, etc. Pode-se tambm utilizar Esse modulo para armazenar dados em
formato XML.
Reports : Utilize para configurar seus prprios relatrios dos dados do sistema, nos
formatos ASCII ou RTF. O propsito principal desse mdulo a criao de relatrios de maneira
mais simples e mais eficiente.
Math Worksheets : Utilize para implementar rotinas adicionais para trabalhar com funes
bsicas do mdulos do InduSoft Web Studio. Uma planilha Math um grupo de linhas
programacionais que so executadas como uma das tarefas de Background da aplicao. Pode-
se configurar a matemtica em blocos, em diferentes planilhas.
Essa planilha fornece um ambiente livre para rotinas de lgica e calculos matemticos necessarios ao
projeto. Para tais propsitos, a linguagem de script simples e de fcil utilizao.
Scheduler : Utilize para gerar as bases de tempo utilizadas em uma aplicao. O Scheduler
capaz de disparar eventos.
ODBC Configuration : Utilize para habilitar aplicaes do InduSoft Web Studio para acessar
quaisquer bancos de dados que sejam compatveis com o protocolo ODBC (como Access, Excel,
Oracle, SQL Server, etc).

Nota:
A interface ODBC no est disponvel para aplicaes em WinCE.

Comunicaes Gerais
Pode-se habilitar as aplicaes do InduSoft Web Studio Aplicaos para comunicar (trocar valores
de dados) com outras aplicaes, equipamentos remotos (como um PLC ou transmissores), e
quaisquer dispositivos que implementem Servers OPC ou DDE.
Para habilitar a comunicao, configure task worksheets fornecido pelo IWS. Instrues para
configurar essas planilhas so fornecidas no Captulo 10: Communication nas seguintes sees:

Configurando um Driver: Explica como configurar uma planilha de Driver para implementar um
protocolo de comunicao (OPC, TCP/IP, ou DDE).
Configurando OPC: Explica como configurar uma planilha de OPC para gerenciamento de
comunicao entre OPC Clients e Servers locais ou remotos.
Configurando TCP/IP: Explica como configurar uma planilha TCP/IP para gerenciamento de
comunicao entre duas aplicaes do IWS.
Configurando DDE: Explica como configurar uma planilha de DDE para gerenciamento de
comunicao entre DDE Clients e Servers locais ou remotos.
Utilize o tab Comm para acessar todas as planilhas configuradas para estabelecer comunicao
com outro equipamento ou software utilizando protocolos disponveis.
IWS 20/06/2007

InduSoft Web Studio

Pgina 111
Captulo 4: Compreendendo a Estrutura do IWS
Esse Captulo explica a estrutura interna do IWS, incluindo a maneira como os dados fluem atravs
do ambiente de runtime do IWS, alm dos vrios mdulos de runtime que podem ser executados.
C IMPORTANTE!
Para evitar comportamentos no previstos, e garantir a melhor performance quando
executar as Aplicaes, recomendamos que as informaes desse captulo sejam
cuidadosamente lidas e compreendidas antes de iniciar o desenvolvimento de
Aplicaes complexas.

Compreendendo a Estrutura Interna e o Fluxo de Dados
O ambiente de runtime do IWS roda uma estao de trabalho operadora (Rodando em Windows
NT/2000/XP/CE). Esta consiste dos seguintes mdulos ou threads (elementos do programa que
podem ser executados independentemente de outros elementos do programa):
Background Task (uma tarefa de superviso): Executa outras tarefas internas (planilhas do
IWS). Por exemplo, a tarefa Background executa scripts configurados nas planilhas Math e
Scheduler, alm de gerenciar parmetros configurados nas planilhas Alarm, Recipe, Report, e
Trend.
Database Spy (ferramenta para correo de erros):
o Executa Funes e/ou expresses 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 comunicao DDE com um servidor DDE (local ou remoto), de acordo
com parmetros configurados nas planilhas DDE Client.
DDE Server: Gerencia comunicao DDE com um DDE Client (local ou remoto).
LogWin (ferramenta para correo de erros): Envia mensagens geradas a partir de outros
mdulos/tarefas.
Driver Runtime: Gerencia os comandos read/write configurados nas planilhas do Driver.
OPC Client: Gerencia comunicao OPC com um OPC Server (local ou remoto), de acordo com
parmetros configurados nas planilhas OPC Client.
OPC Server: Gerencia comunicao OPC com um OPC Client (local ou remoto).
ODBC Runtime: Gerencia comunicao de dados ODBC com qualquer banco de dados
relacionado a SQL, de acordo com parmetros configurados nas planilhas ODBC.
TCP/IP Client: Gerencia comunicao TCP/IP com um modulo remoto TCP/IP Server (do IWS),
de acordo com parmetros configurados nas planilhas TCP/IP Client.
TCP/IP Server: Gerencia mensagens de comunicao TCP/IP com um mdulo TCP/IP Client
remoto (do IWS).
Viewer: Executa todos os scripts (On Open, On While, On Close, Command, Hyperlink, etc)
configurados para telas da Aplicao, alm de atualizar objetos de tela.
Nenhum dos mdulos de runtime precedentes troca dados diretamente com um outro modulo ou
tarefa. Alm disso, mdulos de runtime enviam e recebem dados do banco de Tags, o corao do
IWS.
O banco de Tags controla o fluxo de dados entre mdulos. Alm, das Tags armazenarem todos os
valores de tags e o status de todas as propriedades associadas a cada tag (como condies de
alarme, timestamp, qualidade, etc).
IWS 20/06/2007

InduSoft Web Studio

Pgina 112
Nota:
Tags so variveis (como pontos de comunicao em equipamentos de campo,
resultados de clculos, etc) utilizadas em telas e planilhas.
Para informaes mais detalhadas sobre tag, valores de tags, e propriedades de tag,
veja o Captulo 5: Trabalhando com Tags.

Fluxo de Dados do IWS
Cada mdulo do IWS contm uma tabela virtual de tags que so relevantes para determinado
modulo naquele exato perodo de tempo. O tags database utiliza essa tabela para determinar quais
informaes devem ser atualizadas para cada mdulo. Por exemplo, o Viewer contm uma tabela
virtual que lista todos os tags configurados para todas as telas abertas da Aplicao. Caso o valor
de um tag se altera, o tags database envia uma mensagem para o Viewer, e este atualiza o valor em
todos os objetos onde o tag estiver configurado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 113
Por exemplo, se um driver l um novo valor a partir de um PLC (controlador lgico programvel), o
driver atualiza o tag a ele associado com esse valor do Tags database. Depois disso, essa nova
informao dever ser exibida na tela da Aplicao, e o Tags database envia um novo valor de tag
para a tarefa Viewer, e este atualiza a tela.

Exemplo de Fluxo de Banco de Dados
Note que o driver no envia um novo valor de tag diretamente para o Viewer. Alm disso, no
existem requisitos de dados entre tarefaso tags database recebe a informao atualizada e a
repassa imediatamente para todas as tarefas de runtime que necessitam desta informao.

C IMPORTANTE!
O mdulo Viewer atualizar um objeto somente quando (pelo menos) um dos valores de
tag seja alterado.
Se voc configurar um objeto dinmico (como Text I/O) com uma funo que no requer
o uso de um tag (por exemplo, NoInputTime()), o Viewer no atualizar o objeto, pois
no existem tags associadas quele objeto.

A Arquitetura do IWS melhora significantemente a performance do fluxo interno de dados, alm de
torn-lo um processo mais fcil para a adio de novas tarefas internas. Mesmo que cada tarefa
trabalhe de forma independente, possvel acessar informaes a partir de qualquer outra tarefa
atravs do tags database.
Executando/Mudando Mdulos do IWS
O IWS um sistema SCADA composto de mdulos 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 concepo comum o conceito de executar um sistema SCADA ao executar um
programa PLC. Um programa de PLC contm um loop simples:
IWS 20/06/2007

InduSoft Web Studio

Pgina 114

Loop do Programa do PLC
Porm, em um sistema SCADA, existem vrios mdulos rodando simultaneamente, e a maioria
deles pode ler ou escrever dados. O sistema SCADA modifica dados (valores de tags) continuamente
durante execuo de tarefas; por isso, o diagrama precedente no aplicvel.
O IWS possui apenas um processoStudio Manager.exe. Ao executar uma aplicao de runtime, o
processo Studio Manager.exe inicia-se no tags database e todos esses mdulos configurados para a
aplicao. Pode-se especificar quais mdulos (como Viewer e Driver) iniciaro durante o runtime
(veja Iniciando Mdulos de Runtime no Target system na pgina 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 algortmo de cada
processo. Alm disso, ao criar uma thread, um valor prioritrio especificado. O sistema
operacional escanea continuamente todos os threads ativos atualmente, e executa as threads de
acordo com seus valores prioritriosexecutando primeiramente threads de alta prioridade.
Quando threads com valores de alta prioridade esto ativados, as threads com valores de alta
prioridade no so execitados. Caso haja mais de uma thread com o mesmo valor e prioridade, e
no existem outras threads com valores de alta prioridade, o sistema operacional alterna-se entre
threads com mesma prioridade.
IWS 20/06/2007

InduSoft Web Studio

Pgina 115
Nota:
Todas as threads do IWS so configurados em prioridade 7:
THREAD_PRIORITY_NORMAL.
(A maioria dos programas contm esse valor de prioridade.)
Threads de programas em tempo real (como SoftPLCs e Drivers de Equipamentos) so
designados com um valor de alta prioridade (THREAD_PRIORITY_HIGHEST); porm,
esses programas devem fornecer um mecanismo que deixe-os inativos por algum
perodo de tempo ou de threads com prioridade normal as quais nunca sejam
executadas.
O IWS utiliza a biblioteca UNICOMM.DLL para drivers seriais. Essa biblioteca cria uma
thread THREAD_PRIORITY_HIGHEST que descansa (permanence inativada) at que
os dados cheguem ao canal serial. Quando o IWS detecta novos dados em um canal
serial, a thread THREAD_PRIORITY_HIGHEST acorda (torna-se ativada) e transfere
os dados do sistema operacional buffer para o buffer de thread, onde pode ser lido pelo
Driver. Essa thread a nica thread de maior prioridade criada pelo IWS.

Caso voc permita que as threads permaneam ativas durante todo o tempo, o uso da CPU dever
ficar em 100% durante todo o tempo tambm, o que deve ser evitado em razes de performance.
Cada programa fornece um mecanismo para previnir que threads fiquem ativadas todo o tempo.
O IWS utiliza os seguintes parmetros para previnir tal ao:
TimeSlice (do sistema operacional): Induz o sistema operacional a alternar as threads ativas
com valor de mesma prioridade.
Como padro, o sistema operacional executa cada thread ativa por aproximadamente 20ms, e a seguir,
alterna a prxima thread ativa, ou seja, caso haja mltiplas threads ativas com o mesmo valor de prioridade
esperando para serem executadas, o sistema operacional no 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 parmetro deve ser utilizado adicionalmente ao parmetro TimeSlice do sistema operacional.
Configura-se um valor TimeSlice para cada thread do IWS (exceto para Background Task) e especifica-se
por quanto tempo cada thread permanecer continuamente ativa. Contanto que uma thread esteja ativa, o
sistema operacional ser capaz de alternar para esta determinada thread.
Period (do IWS): Especifica a quantidade maxima de tempo que cada thread do IWS (exceto
Background Task) capaz de permanecer inativa.

C Ateno:
Recomendamos que voc no modifique esses valores padro, a menos que
absolutamente necessrio. Configurar esses parmetros de forma incorreta pode
causar o mal funcionamento de todo o sistema (por exemplo: A uso da CPU rodar com
100% de sua capacidade), alm de fazer com que algumas tarefas funcionem de forma
no satisfatria.
Caso voc necessite mudar os parmetros padro, anote os valores antes de fazer as
alteraes; assim, caso ocorra algum problema de funcionamento, voc poder retornar
s configuraes originais.

IWS 20/06/2007

InduSoft Web Studio

Pgina 116
Para alterar os valores de parmetro padro do IWS TimeSlice e Period:
E A partir do diretrio de instalao do IWS (por exemplo, C:\Program Files\<Installation
Folder>\bin), clique duas vezes em \BIN para abrir a pasta.
E Clique duas vezes no arquivo Program Settings.INI para abrir o arquivo Notepad da Microsoft
.
A lista a seguir mostra todos os parmetos contidos nesse arquivo .ini, alm de seus valores
padro (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:
possvel que voc no veja todos esses parmetros listados acima ao abrir seu
arquivo Program Settings.INI. Porm mesmo que um parmetros no esteja visvel
na lista, o IWS ainda assim utiliza o parmetro e seu valor padro.

Para alterar o valor padro de um parmetro exibido: Em Notepad, delete o valor padro e digite o novo
valor.
Para alterar o valor padro de um parmetro no exibido na lista: Em Notepad, digite o nome do parmetro
exatamente como mostrado na lista e com o mesmo sinal. Depois, digite o novo valor.
E Salve o arquivo (File Save) e feche o Notepad (File Exit).
IWS 20/06/2007

InduSoft Web Studio

Pgina 117
A figura a seguir mostra como o IWS executa um thread genrico (como o Viewer).

Onde:
Sinal O o perodo de tempo Period (configurado para 50ms nesse exemplo).
Sinal O mostra quando um thread est ativo para o sistema operacional.
Sinal O o perodo de tempo TimeSlice (configurado para 30ms nesse exemplo).
Sinal O mostra a execuo de um thread.
Nesse exemplo, o IWS gera uma mensagem Period a cada 50ms (sinal O). Ao gerar essa mensagem,
o thread do IWS torna-se ativo e assim permanece at o perodo de tempo TimeSlice especificado
expirar. O thread ento permanece inativo at que o IWS gere a prxima mensagem Period (sinal
O).
Enquanto o thread est ativo, o sistema operacional responsvel pela execuo do thread. Porm,
um thread estar ativo no significa que o sistema operacional executar esse thread imediatamente
o sistema operacional pode estar executando outros threads, por exemplo.
Quando o sistema operacional executa um thread, o timer TimeSlice inicia a contagem, e da em
diante o thread executado por 20ms (TimeSlice a partir do sistema operacional). Aps o perodo de
20ms, o sistema operacional altera automaticamente para o prximo 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 no suportado para a execuo de mais de um thread em cada TimeSlice do IWS.
Porm, especificando valores mais altos para o perodo de tempo TimeSlice do IWS, provvel que o
sistema operacional seja capaz de executar o mesmo thread mais de uma vez em um mesmo
perodo de tempo TimeSlice.
No exemplo a seguir, os valores de Period e TimeSlice foram alterados como se segue, mas o perodo
TimeSlice do sistema operacional padro (20 ms) no foi alterado.
Sinal O o perodo de tempo Period (configurado para 100ms).
Sinal O mostra quando o thread est ativo para o sistema operacional.
Sinal O o perodo de tempo TimeSlice do IWS (configurado para 80ms).
Sinal O mostra a execuo do thread.
IWS 20/06/2007

InduSoft Web Studio

Pgina 118

Configurando um TimeSlice mais Alto
Note que o thread pode ser executado mais de uma vez em um mesmo perodo de tempo TimeSlice.
Quando o TimeSlice do IWS expira, o sistema operacional interrompe a execuo do thread; porm,
mesmo que os parmetros Period e TimeSlice do IWS estejam configurados para 100ms e 80ms
respectivamente, o sistema operacional no executar esse thread continuamente por mais de
20ms, pois o TimeSlice do sistema operacional est configurado para 20ms.
Quando o sistema operacional no est executando o thread Viewer, a CPU pode executar qualquer
outro thread ou at mesmo permanecer ociosa (caso no haja outros threads ativos a serem
executados). Lembre-se de que os parmetros Period e TimeSlice do IWS foram criados para
prevenir que todos os threads fiquem ativos em um mesmo perodo, evitando assim a capacidade de
100% de uso da CPU.
Duante a execuo do thread, esse dever fazer manuteno de suas mensagens pendentes. Por
exemplo, o mdulo Viewer deve atualizar quaisquer objetos de tela relacionados. Caso no haja
mensagens pendentes, o prprio thread se desativar e passar o controle de volta ao sistema
operacional. O sistema operacional imediatamente alternar para o prximo thread ativo, ou seja,
um thread pode interromper sua prpria execuo mesmo se o TimeSlice do sistema operacional
ainda no tenha expirado (o que ocorre frequentemente em aplicaes de mundo real).

Nota:
Os mdulos Database Spy, DDE Server, LogWin, e ODBC Runtime no possuem um
parmetro TimeSlice do IWS. Consequentemente, aps cada thread manusear todas as
suas mensagens pendentes, os threads tornam-se inativos at a prxima mensagem
Period de cada um dos threads.

Background Task uma exceo para processos de execuo/alternamento j discutidos. O
mecanismo para execuo/alternamento do Background Task sera descrito na prxima seo.
Executando/Alternando o Background Task
O Background Task executa scripts a partir de planilhas Math e Scheduler (por exemplo,
mensagens a partir de planilhas de Alarm e Trend). Alm disso, o Background Task executa todos
os comandos Recipe e Report quando as Funes Recipe() ou Report() so executadas durante o
runtime.
Emboras as tarefas Alarm, Math, Scheduler, e Trend no sejam threads, pode-se especificar ou
trocar seus tempos no Period no arquivo Program Settings.INI localizado na pasta C:\Documents
and Settings\\Local Settings\Aplicao Data\InduSoft Web Studio v6.1 (veja
Executando/Mudando Mdulos do na pgina 113).
IWS 20/06/2007

InduSoft Web Studio

Pgina 119
Os valores padro de Period (em milissegundos) so:
[Period]
Math=100
Sched=50
Alarm=100
Trend=1000
Esses valores significam que, a cada 100ms, o IWS gera uma mensagem Period para a tarefa Math.
A cada 50ms, o IWS gera uma mensagem Period para a tarefa Scheduler, e assim por diante.
C Ateno:
Recomendamos que voc no modifique os valores padro do Background Task a
menos que seja absolutamente necessrio. Configurar qualquer um desses parmetros
de forma incorreta pode acarretar o mal funcionamento do sistema como um todo (por
exemplo, uso de 100% da CPU) e/ou fazer com que algumas tarefas funcionem
inadequadamente.
Caso voc necessite trocar os parmetros padro, anote os valores antes de fazer suas
alteraes. Assim, caso ocorra mau funcionamento, possvel retornar s
configuraes originais.

Mantenha em mente que o thread Background Task possui a mesma prioridade de qualquer outro
thread no IWS (Drivers, Viewer, etc), o que significa que o sistema operacional no executar essa
tarefa continuamente por mais de 20ms.
O Background Task executa os comandos Recipe e Report quando as funes Recipe() ou Report()
so executadas. Como essas funes so sincrnicas (Recipe() e Report(), uma vez que o
Background Task inicie a execuo dessas funes, no sera possvel alternar para outra tarefa
(Alarm, Math, Scheduler, ou Trend) at que essas sejam executadas inteiramente. Executar uma
funo Recipe() ou Report() geralmente leva alguns milissegundos.
O Backgound Task deve alternar entre tarefas Alarm, Math, Scheduler, e Trend. Quando o
Background Task alternar para a tarefa Scheduler, no sera possvel alternar para outra tarefa
(Alarm, Math, ou Trend) at que todas as planilhas Scheduler sejam executadas. Aps a execuo de
todas as planilhas Scheduler, o Background Task no executar o Scheduler novamente, at que
esse receba a prxima 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 no alternar para outra
tarefa at que todas as mensagens pendentes sejam manuseadas. Dessa forma, o Backgound Task
no executar as tarefas Alarm ou Trend novamente at que o IWS gere a prxima mensagem
Period para cada uma dessas tarefas.
IWS 20/06/2007

InduSoft Web Studio

Pgina 120
O Backgound Task executa tipicamente as tarefas Alarm, Scheduler, e Trend em alguns
milissegundos. Porm, pode lever um tempo maior para executar a tarefa Math, j que essa
geralmente contm loops e scripts complexos. Conseqentemente, o mecanismo utilizado para
executar as tarefas Alarm, Scheduler e Trend no 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 no pode executar a tarefa Math novamente
pelos prximos 50ms; porm, o Background Task pode executar outras tarefas (Alarm, Recipe,
Report, Scheduler, ou Trend) durante esse perodo de 50ms. Aps ter executado todas as planilhas
Math a ferramenta no 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 criao desse processo, projetado para prevenir o uso de
100% da capacidade da CPU o tempo todo.
C Ateno:
Recomendamos precauo ao utilizar a funo Math() em uma planilha Scheduler ou
para um objeto de tela (como o dinmico Command).
Quando a tarefa Scheduler executa uma funo Math(), nenhuma outra tarefa poder
ser executada pelo Background Task at que o Scheduler tenha executado de forma
completa a planilha Math chamada pela funo Math(). Esse processo pode levar vrios
milissegundos ou at segundos, dependendo de como voc tenha configurado o script
na planilha Math (especialmente para loops).
Caso voc configure uma funo Math() para um objeto de tela, o Viewer pra a
atualizao da tela at que o Viewer execute inteiramente a planilha Math chamada
pela funo Math().
Caso voc necessite utilizar a funo Math() para a tarefa Scheduler ou um objeto de
tela, recomendamos a utilizao do seguinte procedimento, prevenindo assim possveis
atrasos no processo:
E Especifique um tag auxiliar com valor 1, e as tarefas Scheduler ou Viewer enviaro
uma mensagem para o tags database a fim de atualizar esse valor de tag.
E 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.
E Reinicie o tag na ltima linha da planilha Math (escreva o valor 0 para o tag
auxiliar).
Como resultado, o Background Task no executar a planilha Math no prximo scan, a
menos que o tag auxiliar seja configurado como valor 1 novamente.

IWS 20/06/2007

InduSoft Web Studio

Pgina 121
Captulo 5: Trabalhando com Tags
Como discutido no Captulo 4, o banco de tags database o corao do IWS, j que o responsvel
pelo gerenciamento do fluxo de dados entre mdulos de runtime, bem como o armazenamento de
todos os tags, valores do tag, e propriedades do Tag. O tags database a media utilizada por todos
os mdulos para ler ou escrever valores do tag.
Esse Captulo explica conceitos bsicos sobre os tags, valores de tag e propriedades do tag
utilizadas no tags database do IWSincluindo como criar e editar tags para seus projetos.
Nota:
Recomendamos a leitura e compreenso dos conceitos discutidos no Captulo 4:
Compreendendo a Estrutura do IWS, antes de ler esse Captulo.

O que um Tag?
Tags so variveis projetadas para receber resultados de expresses especificadas em telas e
planilhas (como pontos de comunicao em equipamento de campo, resultado de clculos, pontos
de alarme, etc).
Todos os tags so organizados atravs das seguintes categorias (representadas por pastas no tab
Database no Workspace):
Aplication Tags so tags criadas durante o desenvolvimento da
Aplicao.
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 matemticos
Classes so tags compostos criados para associar um conjunto de
valores (mais de um nico valor) com uma classe. Estruturas de
classes permitem um alto grau de encapsulamento junto ao tags
database.
Shared Database os tags so criados em um programa de software de
controle baseado em PC e depois importados para o tags database do
IWS.
Por exemplo, pode-se criar tags em SteepleChase e import-los para o IWS, assim
o IWS poder ler/escrever dados de SteepleChase ,um produto de controle
baseado em PC.
Nota:
Pela necessidade de configurar um projeto ANTES de poder compartilhar tags,
instrues para tal procedimento so fornecidas no Captulo 6: Criando e
Configurando um Projeto. Veja Compartilhando Tags database com Programas de
Controle Baseados em PC na pgina 147.

No possvel modificar tags compartilhados com o IWSdeve-se modificar os tags no programa de
controle baseado em PC original, para depois reimport-los para o tags database.
IWS 20/06/2007

InduSoft Web Studio

Pgina 122
Internal Tags so tags pr-definidos com funes pr-determinadas, e so utilizados para
tarefas de superviso do IWS. Por exemplo,
o Tags de data apresentam a data atual em formato de string
o Tags de hora apresentam o horrio atual em formato de string
A maioria dos tags internos so read-only, significando que voc no 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.
Aps criar um tag, Pode-se utiliza-lo em qualquer local da aplicao, alm de poder utilizar o
mesmo tag para mais de um objeto ou atributo.
Projetando um Tag
Antes de criar um tag para determinado propsito, voc dever compreender quais os tipos de tags
podem ser criados, alm dos elementos bsicos ou caracteres de um tag, que incluem:
Tipos de dados de tags
Compartilhados ou no
Propriedades do Tag
Aps ler as informaes fornecdias nessa seo, voc sera capaz de criar tags que adequem-se de
forma apropriada s necessidades da sua aplicao.
Escolhendo o Tipo de Tag
O IWS permite a criao 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 usurio
(Boolean, Integer, Real ou String) ou estruturas de tipo de dados.
Indirect tags so apontadores que forncem acesso indireto a outro tipo de tag, incluindo classes
de tags.
Segue-se uma breve discusso desses tipos de tags.
Tags bsicos
Um Tag bsico recebe um valor nico. Tipicamente, a maioria dos tags definidos para uma
aplicao do IWS so tags bsicos. Alguns exemplos de um tag bsico incluem:
TankID (para identificar tanques diferentes em sua aplicao)
Temperature (para identificar a temperature atual de um objeto)
Status (para identificar se um objeto est aberto ou fechado)
IWS 20/06/2007

InduSoft Web Studio

Pgina 123
Tags de Array
Um tag de array consiste de um conjunto de tags que possuem o mesmo nome, embora utilizem
indices nicos de array (uma matriz de n linhas e uma coluna) para diferenciao entre cada tag.
um array index pode ser um valor fixo, um outro tag ou uma expresso. Tamanhos mximos de
array so determinados pelas especificaes do produto.
Pode-se utilizar tags de array para:
Simplificar configuraes
Habilitar multiplexidade em telas, receitas e interfaces de comunicao
Economizar tempo de desenvolvimento durante declarao 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 expresso que consiste de um tag
e uma operao aritimtica), digite <ArrayTagName>[<anothertag>+c]
Onde:
<ArrayTagName> o nome do tag
[<ArrayIndex>] o indice nico (valor fixo ou outro tag)
+ qualquer operao aritimtica
c uma constante numrica
Notas:
Deve-se especificar um ndice mximo para cada tag de array, digitando um
valor (n) na coluna Array Size de uma planilha Aplication Tags ou no campo
Array Size de um dilogo New Tag. (Veja Criando Tag database da Aplicao
na pgina 129).
Ao criar um tag de array de posio n, o IWS na verdade cria n+1 posies (de 0 a n).
Por exemplo, se voc especificar ArrayTag[15], o array ter 16 elementos; onde 0 a
posio inicial e 15 a posio final.
Voc no dever utilizar espaos em um tag de array.
Ao ler um tag, o IWS comea pelo primeiro caractere, e continua at encontrar o
primeiro espao ou caractere nulo. Consequentemente, o sistema no reconhece
quaisquer caracteres seguidos de espao com parte de tag de array.
Por exemplo, digitando a[second + 1] o IWS reconhece a[second como o tag, e o
considera invlido, pois o IWS no encontra (reconhece) o bracket closing. Porm, se
voc digitar a[second+1], esse um tag de array vlido.

Pode-se especificar um tag array em qualquer lugar onde voc possa. Alm disso, em razo dos tags
array simplificarem de forma significativa as tarefas de configurao e economizarem tempo no
desenvolvimento, sugerimos que estes sejam utilizados sempre que possvel.
Por exemplo, suponha que voc deseje monitorar a temperatura de quatro tanques. O mtodo de
configurao convencional :
temperature1 high temperature on tank 1
IWS 20/06/2007

InduSoft Web Studio

Pgina 124
Pode-se utilizar tags array para simplificar essa tarefa, como se segue (onde [n] representa o
nmero do tanque):
temperature[n] high temperature on tank [n]
A tabela a seguir contm alguns exemplos adicionais de um tag array:
Exemplo de Array Tag Descrio
Tank[1], Tank[2], Tank[500] Arrays simples, onde os ndices de array (1, 2 e
500) so constantes numricas. Por exemplo,
nmero de tanques.
Tank[tk] Arrays simples, onde o ndice de array (tk) um
tag.
Por exemplo, a tag representando o nmero de
tanques.
Tank[tk+1] Array complexo, onde o ndice de array (tk+1)
uma expresso. Por exemplo, o valor de tk (nmero
de tanques) mais 1.
Exemplos de Tag Array
Tags Class
Class tags so tags compostos que permitem um alto grau de encapsulamento com tags database.
Onde tags bsicos recebem valores nicos, classes so projetados para receber valores mltiplos.
Pode-se criar um tag class-type agrupando tags bsicos ou array, os quais se tornam membros de
classe. O nmero mximo de membros para qualquer classe depende da especificao do produto.
Especifica-se tags class-type em um dos seguintes formatos:
Para uma classe de tag simples, a sintaxe <TagName>.<ClassMemberName>. (Onde o perodo
utilizado como separador.)
Por exemplo, caso voc deseje monitorar vrias condies diferentes (como temperatua, nvel e presso) em
um tanque, deve-se criar um tag de classe como se segue:
Tank.Temperature
Tank.Level
Tank.Pressure
Para criar um tag de classe complexo (utilizando um tag array) a sintaxe
<ArrayTagName>[<ArrayIndex>].<ClassMemberName>. (Onde, novamente, o perodo utilizado
como separator.)
Caso voc deseje monitorar condies de temperatura, nvel, e presso em mltiplos 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 nmero do tanque.
IWS 20/06/2007

InduSoft Web Studio

Pgina 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
criao de tags duplicados (e tambm a lgica de construo neles includos).
Pode-se criar um tag indireto a partir de qualquer tag string-type, bastando digitar o smbolo @
frente do nome do tag: @<TagName>.
Para Referir-se a um Tag simples, supor o tag strX (um tag string) guarde o valor To reference
a simple tag, assume the strX tag (a string tag) holds the value Tank, o qual o nome de outro
tag, e depois a ler de ou escrever para @strX fornece acesso para o valor do tag Tank.
Para referir-se a um Tag tipo classe e membro, voc simplesmente cria um tag string que
aponte para a tag class e membro. Por exemplo, se a tag strX (um tag string) guarda o valor
Tank.Level, o qual o nome do tag class, ento lendo de ou escrevendo para @strX fornece
acesso para o valor do tag Tank.Level To reference a class-type tag and member, you simply
create a string tag that points to the class tag and the member. Por exemplo, if a tag strX (a
string tag) holds the value Tank.Level, which is the name of the class tag, then reading from
or writing to @strX provides access to the value of the Tank.Level tag.
Pode-se tambm apontar diretamente para um membro de tag class-type; identificando-se um
class-type que Aponte para um membro de classe. Por exemplo: para acessar o membro Tank.Level
da classe, deve-se armazenar o valor Tank com o tag strX , e utilizar a sintaxe: @strX.Level.
Escolhendo Tipo de Dados do Tag
Outra considerao sobre como projetar um tag sobre qual tipo de dados o tag dever receber. O
IWS reconhece os seguintes tipos de dados de Tag como padro:
Boolean (um bit): Boolean ou variveis digitais (0 ou 1). Tipicamente utilizados para deixar
objetos ligados ou desligados (off e on) ou para fechar e abrir objetos.
Integer (quatro bytes): nmero 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 nmeros e valores.
Real (floating point, oito bytes): Nmero Real que armazenado internamente como uma
palavra dupla. Equivalente ao C-type duplo. Tipcamente utilizado para medidas ou para valores
decimais ou fracionrios.
String (dados alfanumricos, 0254 cacacteres): String de caractere com at 255 caracteres que
suportam letras, nmeros ou caracteres especiais. Suporta tanto caracteres ASCII quanto
UNICODE.
Por exemplo: Recipe product X123, 01/01/90, *** On ***
Compartilhando Tags com um Web Thin Client
O IWS permite decider se um valor de tag pode ser compartilhado (exibido) com uma estao Web
Thin Client.
Local: Impede que um valor de tag na estao Server seja compartilhado com estaes Web
Thin Client.
Server: Possibilita que um valor de tag seja exibido em uma pgina HTML, o que torna o valor
disponvel para um Web Thin Client.
Caso voc deseje visualizar e gerenciar todas as suas aplicaes remotamente, deve-se certificar-se de que a
opo Server est especificada para todos os tags relacionados ao processo de gerenciamento. Por exemplo,
caso vo queira responder alarmes remotamente, voc dever habilitar a opo Server para todos os tags
relacionados ao gerenciamento de alarme.
IWS 20/06/2007

InduSoft Web Studio

Pgina 126
Escolhendo Propriedades de Tag
Propriedades de Tag so atributos (ou parmetros) que so inerentes a um tag do banco de dados
(como valores mnimos/mximos, tamanho, descrio, etc).
Ao definir tags para uma aplicao do IWS, Pode-se especificar propriedades de tag que so
utilizadas durante o runtime como campos de tag. Esses campos de tag do runtime so descritos na
tabela a seguir.
Tipo de tag Associado ao Campo
Nome do
Campo do
tag
Descrio do Valor Associado a Cada
Campo
Boolean Integer Real String
R=Read
Only
RW=Read+
Write
Description Descrio do Tag (no Banco de
Dados deTag)
- - - - RW
Max Valor mximo que pode ser escrito
para o tag durante runtime.
- - RW
Min Valor mnimo que pode ser escrito
para o tag durante runtime
- - RW
Quality Qualidade do Tag (192=GOOD;
0=BAD).
O Campo atualiza-se cada vez que
resultados de expresses so
recebidos ou um valor de tarefa de
comunicao (Driver ou OPC).
Expresses invlidas (como diviso
por zero) ou erros na comunicao
de leitura associados ao tag que
configurar a qualidade do tag como
BAD de forma automtica.
- - - - R
Size Tamanho do Array. Caso o tag no
seja um tag array, o valor retorna
para 0.
- - - - R
TimeStamp Hora & Data que o valor do tag
alterado.
- - - - R
Unit Descrio breve (at nove caracteres)
da unidade de engenharia do valor
do tag (Por exemplo: Kg).
- - - - RW
B0 B31 Valor (0 ou 1) de qualquer dos 32
bits (b0, b1, b2, b31) de um tag
integer. (B0: LSB B31: MSB).
- RW
IWS 20/06/2007

InduSoft Web Studio

Pgina 127
Nome do
Campo do
tag
Campo
R=Read
Only
RW=Read+
Write
Valor Integer contendo o status de
todos os alarmes atualmente ativos
associados ao tag. Cada bit desse
valor de integer indica um status
especfico, como se segue:
Bit 0 (LSB): HiHi Alarm active
Bit 1: Hi Alarm active
Bit 2: Lo Alarm active
Bit 3: LoLo Alarm active
Bit 4: Rate Alarm active
Bit 5: Deviation+ Alarm active
Bit 6: Deviation- Alarm active
- - - R AlrStatus
Por exemplo:
If Tag->AlrStatus retorna para valor 2, Hi alarm is active.
If Tag->AlrStatus retorna para valor 3, HiHi and Hi alarme ativos
simultaneamente.
If Tag->AlrStatus retorna para valor 0, no h alarmes ativos associados a esse tag.
Para tags Boolean, somente valores 1 (bit 1), 4 (bit 2) ou 16 (bit 4) os valores so
retornados.
Ack Esse campo pode ter dois valores :
0: Sem alarmes associados com esse
tag.
1: Pelo menos um alarme associado com
esse tag.
- - - RW
AlrDisable Esse campo pode ter dois valores:
0: Habilita alarmes associados com tag.
Quando ocorre condio de alarme, o
alarme torna-se ativo.
1: Desabilita alarme associado com tag.
Caso ocorra condio de alarme, o
alarme no 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 128
Nome do
Campo do
tag
Campo
R=Read
Only
RW=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 alarmes
Deviation .
- - RW
DevpLimit Valor limite para alarme Deviation+. - - RW
DevmLimit Valor limite para alarme Deviation-. - - RW
Tabela de Campoz de Tag
Para acessar um campo de tag no runtime, digite o nome do tag e campo (utilizando a sintaxe:
TagName->Field) no Database Spy, uma janela de comando, ou um campo de execuo.
C Ateno:
No possvel utilizar campo de tag (como campos Bit) para configurar planilhas Alarm
ou Trend.
Embora seja possvel aplicar propriedades do tag para tags internos, tais propriedades
no persistiro se for feito um download de sua aplicao em um equipamento CE.

IWS 20/06/2007

InduSoft Web Studio

Pgina 129
Nota:
Caso uma aplicao tente escrever um valor para o tags database que saia da escala
especificada nos campos Min e Max, o banco de dados no aceitar o novo valor e
escrever uma mensagem para a window Output do IWS.
Caso voc especifique zero (0) para os campos Min e Max, a Aplicao poder escrever
qualquer valor para tipo do tag no tags database.
Criando Tag database da Aplicao
Essa seo explica o processo para criao de tags bsicos, array e pointero para a aplicao de seu
projeto.
Notas:
Ao especificar o nome do tag, deve-se aderir s seguintes guidelines:
Seus nomes de tag devem ser nicos no Pode-se especificar o mesmo nome para
dois tags ou (funes) diferentes. Caso voc digite um nome de tag j existente, o IWS
reconhece que o nome j existe, e no criar o novo tag.
Deve-se iniciar cada nome de tag com uma letra. De outra forma, Pode-se utilizar
letras, nmeros e um caractere underscore (_) em seu nome de tag.
No Pode-se utilizar os seguintes smbolos em um nome de tag:
` ~ ! @ # $ % ^ & * ( ) - = \ + \ [ ] { } < > ?
Pode-se utilizar um mximo de 255 caracteres para um nome de tag ou nome de
membro de classe.
Pode-se utilizar caracteres em letra maiscula ou minuscula, pois o IWS no
estabelece diferena entre caracteres em letra maiscula ou minscula. Ambos
podem ser utilizados para tornar os nomes de tags mais legveis (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 criao e edio de tags a partir de uma variedade de
localizaes junto ao ambiente de desenvolvimento.
Pode-se adicionar tags utilizando planilha de tags da aplicao
Pode-se adicionar tags on-the-fly a partir de um menu pop-up ou de qualquer text box Tag ou
Expression (localizado nos dilogos Object Properties, planilhas, etc)
Instrues e mtodos para adio de tags so fornecidas nas prximas duas sees.
IWS 20/06/2007

InduSoft Web Studio

Pgina 130
Adicionando Tags para a Planilha da Aplicao
Siga os seguintes passos para criar tags a partir da planilha de tags da aplicao:
E Seleione o tab Database e abra a pasta Aplication Tags.
E Clique duas vezes no cone Datasheet View para abrir o datasheet Aplication
Tags:

Datasheet Aplication Tags
E Localize uma linha vazia no datasheet e configure os seguintes campos.
(Dica: Voc pode utilizar a tecla Tab para mover para a prxima 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 Aplicao) que adeque-se aos guidelines
descritos na pgina 129.
o Campo Array Size:
Para um tag array, digite um valor para especificar o ndice mximo 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 necessrio, reveja Escolhendo Tipos de Dados doEscolhendo
Tipo de Dados do Tag na pgina 125.)
o Campo Description (opcional): Digite uma descrio para fins de documentao.
o combo-box Web Data: Clique na seta para especificar se o valor do tag sera compartilhado
(exibido) com estaes Web Thin Client.
Local: Impede que um valor de tag do Server seja compartilhado com estaes Web Thin
Client. Por exemplo, quando voc deseja visualizar um valor de tag em sua estao de
trabalho, no interferindo no valor de tag exibido em outras estaes de trabalho Web Thin
Client.
Server: Compartilha um valor de tag do Server com estaes Web Thin Client. Por exemplo,
quando voc deseja compartilhar/vizualizar valores (como On ou Off).
E Clique em uma nova linha para criar um outro tag ou salve diretamente o(s) tag(s) no banco de
dados de Tags (File Save) e feche o datasheet Aplication Tags.
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 criao de tags individuais on-the-fly:
Clique com o boto 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 (disponvel nos dilogos Object Properties,
planilhas, etc). Um dilogo Question aparecer, e clique em Yes para criar um novo tag.

Criando um Novo Tag
IWS 20/06/2007

InduSoft Web Studio

Pgina 132
Utilizar tais procedimentos far com que um dilogo New Tag aparea:

Dilogo New Tag
Os campos e combo-boxes nesse dilogo correspondem em nome e funo s colunas no datasheet
Aplication Tags. Consequentemente, Pode-se configurar esse dilogo utilizando as instrues
fornecidas nas pginas 130. Ao terminar, clique em OK para salvar o tag no tags database e feche o
dilogo New Tag.
Reiniciando o Tags database
Seleione Tools > Reset Tags Database para regravar o tags database na estao local. Esse
commando afeta todos os tags armazenados na pasta Aplication Tags. Essa opo til para
reiniciar tags da aplicao e restaurar valores da aplicao quando essa foi gravada pela primeira
vez. Ao parar a aplicao e deixar o ambiente de desenvolvimento aberto, os tags, por padro, no
so reiniciados quando a aplicao novamente iniciada. Portanto, Pode-se executar esse comando
para reinici-los antes da aplicao rodar novamente.
Quando esse comando executado, o Valor Startup configurado para cada tag (dilogo Tags
Properties) escrito ao respectivo tag. Caso voc no configure um Startup Value para um tag
numrico (Boolean, Integer ou Real), o valor 0 (zero) escrito para o tag. Caso voc no 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 estao
local. Deve-se fechar todas as tarefas em runtime (Project > Stop Application) antes de executar
esse comando.

Nota:
Os tags armazenados nas pastas Internal Tags e Shared Tags (caso haja) no so
afetados por esse commando.

= Dica:
Caso voc deseje reiniciar os tag da aplicao automaticamente sempre que rodar a
aplicao (Project > Run Application), Pode-se habilitar a opo Reset Tags Database
when starting Application no tab Preferences do dilogo Project Settings.

Criando Classes
Para criar um tag class:
No tab Database, clique com o boto direito na pasta Classes, e selecione Insert Class do menu pop-up que
aparecer.
IWS 20/06/2007

InduSoft Web Studio

Pgina 133

Inserindo Class em Popup
E Quando o dilogo Insert Class aparecer, digite um nome no campo Name utilizando a sintaxe
da pgina 124 e as diretrizes indicadas na pgina 129.

Dilogo Insert Class
E Clique em OK para fechar o dilogo Insert Class e a planilha Class: aparecer automaticamente.
E Configure as colunas desta planilha como se segue:
o Campo Name: Digite um nome do membro de classe (Veja pgina 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 descrio do membro de classe (para fins de
documentao somente).

Planilha exemplo de CTank
E Clique na prxima linha em branco e fornea as informaes para o prximo membro de classe
que voc deseja incluir nessa classe. Ou, caso voc tenha terminado de adicionar todos os
membros, feche a planilha Class.
Pode-se expandirr a pasta Classes e as subpastas para vizualizar a estrutura dos dados:
IWS 20/06/2007

InduSoft Web Studio

Pgina 134

Pasta Classe Expandida
E A seguir, utilize as instrues fornecidas em Criando Tag database da Aplicao na pgina
129, para criar e associar um tag com o nova classe.
Note que, ao clicar no boto de seta para visualizar a lista Type, seu novo nome de classe (CTank) j est
includo (veja a linha 5 da figura a seguir). Selecione o nome de classe da lista.

Criando o tag class Tank
E Ao terminar, salve seu trabalho e feche a planilha.
Configurando Propriedades de Tag
Essa seo explica como configurar propriedades de tag.
E No tab Database, abra o datasheet Aplication Tags (ou exiba a lista de tags no Workspace) e
coloque o cursor no tag que voc deseja configurar propriedades.
E Clique no boto Tags Properties na barra de ferramentas Tags Properties.
Um dilogo Tag Properties aparecer de forma similar ao que se segue:
IWS 20/06/2007

InduSoft Web Studio

Pgina 135

Dilogo Tag Properties
Um dilogo Tag Properties pode possuir um, dois ou trs tabs, dependendo do tipo de tag
selecionado no datasheet:
Parameters: Utilize esse tab para configurar reteno, 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 histricas.
Nota:
Nem todas as propriedades esto disponveis para todos os tipos de tags.
Consequentemente, os recursos de cada tab podem variar, dependendo do tipo de tag
selecionado. Por exemplo, valores Minimum e Maximum no so necessarias para tags
String.
Reveja a tabela na pgina 126 para ver quais propriedades esto disponveis para os
diferentes tipos de tags.

Instrues sobre como configurar os parmetros em cada tab esto disponveis a seguir.
IWS 20/06/2007

InduSoft Web Studio

Pgina 136
Configurando os Parmetros de Propriedades do Tag
Essa seo explica como configurar todos os diferentes parmetros de propriedades de tags.
Lembre-se de que a variabilidade de cada parmetro depende do tipo de tag selecionado.

Tag Properties: Tab Parameters
check-box Retentive Value: Habilite ( ) esse box para salvar continuamente o valor do tag, caso
o sistema desligue-se inesperadamente. Ao reiniciar o sistema, o tag reter o ltimo valor salvo.
C Ateno:
Especificar o parmetro Retentive Value para tags com valores alterveis pode
causar o acesso frequente ao disco rgido, o que diminui a perfdormance do
programa.

check-box Retentive Parameters: Habilite ( ) esse box para salvar todas as alteraes feitas nos
campos de tags durante o runtime.
Campo Startup Value: Digite um valor do tag para carregar o sistema. O tag utilizar esse valor
caso voc desabilite a opo Retentive Value.
Campo Min (acessvel durante o runtime): Digite um valor mnimo para o tag em unidade de
engenharia.
Campo Max (acessvel durante o runtime): Digite um valor mximo para o tag nas unidades de
engenharia.
C Caution:
O IWS no pode aceitar valores de tags que saiam das escalas especificadas
Min/Max. Porm, o IWS gerar uma mensagem na window Output para mant-lo
informado que o sistema tentou escrever um valor, o qual estava fora dos padres
definidos.

Campo Unit (acessvel durante o runtime): Digite uma string (de at nove (9) caracteres) para
especificar as unidades do tag (como Ohms, deg., ou MHz) para propsitos de exibio.
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 variao permitida acima e abaixo do valor central de um tag (no
reconhecido para alarmes). Quando o valor de tag exceder a banda morta permitida, o IWS gerar um
alarme.
check-box Smoothing: Habilite ( )esse box para reduzir a taxa de troca para o valor do tag.
Por exemplo, caso voc especificar Smoothing para um tag contendo o valor 50, e o a prxima pesquisa, o
IWS armazena a media de 50 + 60 no banco de dados, e o novo valor sera igual a 55.
Configurando os Alarmes Tab de Propriedades de Alarmes
Essa seo explica como visualizar e configurar todas as propriedade de alarme para um tag
selecionado.

Dilogo Tag Properties: Tab Alarms - Type
check-box Alarms Enabled: Habilite ( ) esse box para ligar a funo de alarme para esse tag.
Campo Remote Ack tag: Digite um tag para permitir que um receptor saiba sobre um alarme
remotamente, o que ocorre quando os valores do tag so alterados.
Campo Dead Band Value: Digite um valor para especificar uma variao de banda morta. O
IWS utilize esse valor para filtrar alarmes.
Por exemplo, caso voc configure o tag TANK com Alarm Limit Value = 90 e Dead Band Value = 5, o IWS
gerar um alarme quando TANK for 95. O alarme retorna para o normal (normalize) quando o valor do
TANK for 90.
check-box Translation Enabled: Habilitando ( ) esse box permite ao IWS traduzir mensagens
de alarme para outro(s) idioma(s). (Para maiores informaes sobre traduo de aplicaes, leia
o Captulo 16: Utilizando o Translation Editor.)

Nota:
O IWS salva automaticamente mensagens de Alarme com o atributo Translation
Enabled j habilitado por padro. Essas mensagens so salvas em um arquivo
IWS 20/06/2007

InduSoft Web Studio

Pgina 138
chamado Alarm.txt, localizado no diretrio \DATABASE\ de sua aplicao.

check-boxes Alarm type (disponveis durante o runtime): Habilita ( ) um ou mais dos seguintes
tipos de alarme para esse tag
HiHi: Habilita alarmes Very High
Hi: Habilita alarmes High
Lo: Habilita alarmes Low
LoLo: Habilita alarmes Very Low
Rate: Cria um alarme baseado na taxa de alterao
Deviation+: Cria um alarme baseado em uma derivada do set point assinalado
Deviation: Cria um alarme baseado em uma derivada do set point assinalado
Por exemplo:
Para SetPoint = 50, Deviation + = 5, Deviation = 5, e Deviation Dead Band = 0.5
o IWS gera um alarme, onde a temperature maior que 55.5 ou menor que 44.5 e retorna
ao normal quando a temperatura maior que 45 ou menor que 55.
Ao habilitar quaisquer tipos de alarmes precedentes, os seguintes campos aparecero 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 parmetro Rate tambm
fornece uma lista, a qual permite a especificao de uma taxa para esse limite 1/s(econd), 1/min(ute), e
1/hour.
Message: Digite um string de mensagem para exibir quando o IWS dever gerar um alarme.
Group: Digite um valor indicando qual nmero do grupo (nmero da planilha) esse tab pertence. O IWS
utilize esse valor para filtrar alarmes de um ou mais grupos de usurios. Pode-se tambm utilizar uma
virgula ou barra para especificar mais de um grupo (Por exemplo, 1,3,5-6).
IWS 20/06/2007

InduSoft Web Studio

Pgina 139
Priority: Digite um nmero 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 mximo de sete caracteres (todos os outros caracteres sero ignorados).
Campo Deviation SetPoint (acessvel durante o runtime): Digite um valor indicando um ponto
de referncia para a derivao.
Campo Deviation Dead Band (acessvel durante o runtime): Digite um valor indicando um valor
de banda morta de referncia para essa derivao.
check-box Off: Habilite ( ) esse box para gerar um alarme quando o valor do tag for zero.
check-box On: Habilite ( ) esse box para gerar um alarme quando o valor do tag for one.
check-box Changed: Habilite ( ) esse box para gerar um alarme sempre que o valor do tag se
altere.
painel Mnemonic: Utilize os campos Off, On, e Ack para configurar mneumnicos (Por exemplo,
Closed ou Open) para os estados do alarme Off, On, e Ack (tags Boolean somente). Durante o
runtime, o Objeto Alarm/Event Control exibe esses mneumnicos na coluna Value para tags
Boolean associados com a mensagem de alarme.

Nota:
Caso voc no configure um mneumnico, o Objeto Alarm/Event Control exibe um
valor de tag (0 ou 1) na coluna Value.

Configurando Propriedades do Histrico
Essa seo explica como vizualizar e configurar propiedades do histrico para um tag selecionado.
Essas propriedades correspondem a colunas, em uma planilha Trend (na qual sera discutida na
pgina 298). O IWS desabilita essas propriedades do tab caso voc tenha uma planilha Trend
aberta. Antes de utilizar esse dilogo, deve-se j ter criado grupos Trend.

Dilogo Tag Properties: Tab History

Notas:
Histricos no suportam tags tipo string.
O IWS salva arquivos histricos automaticamente (.hst) na pasta Aplicao, a menos
que voc altere esse padro local explicitamente.

IWS 20/06/2007

InduSoft Web Studio

Pgina 140
No dilogo Tag Properties, habilite histricos logando como se segue:
check-box History Enabled: Habilite ( ) esse box para armazenar exemplos de valores de tag.
Campo Group Number: Digite o nmero do grupo associado com esse tag.
Campo Log Dead Band: Digite um valor para especificar uma variao de Dead Band para logs.
Quando o valor do tag for igual ou maior que esse valor, o IWS levar essa amostra para o
arquivo histrico.
Configurar esse valor no 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 faa
download de tags Internos para equipamento CE, as propriedades do tag no
persistiro atravs do download. Voc perder tais propriedades.

Utilizando Tags em Sua Aplicao
Uma vez adicionados tags ao banco de dados de sua aplicao, voc poder utilizar os tags associando-os a
objetos na tela da aplicao.
O processo bsico para associao de tag tela consiste dos seguintes passos:
E Na tela da aplicao, selecione o objeto no qual voc deseja associar o tag.
E Clique em um dos botes de propriedades e um dilogo
Object Properties aparecer.
E Localize o text box Tag para a propriedade em questo e digite o nome do tag dentro do campo.
Nomes e localizaes do text box Tag podem variar, dependendo do tipo de propriedade que voc est
utilizando. Por exemplo:

Aplicando Tags a um Objeto
Instrues de fcil compreenso para aplicao de tags a objetos de tela so fornecidas ao longo
desse manual no momento apropriado.
Editando Tags
Pode-se alterar as propriedades de um tag em qualquer momento durante o desenvolvimenhto ou
runtime. Essa seo descreve dois mtodos que podem ser utilizados para edio de tags.

IWS 20/06/2007

InduSoft Web Studio

Pgina 141
Nota:
Pode-se clicar com o boto direito em uma propriedade de tag e utilizar os comandos
padro do Windows para cortar (Ctrl+X), copiar (Ctrl+C), ou colar (Ctrl+V) qualquer tag
e suas propriedades. Pode-se tambm desfazer (Ctrl+Z) a ltima modificao feita em
um campo.

Do Datasheet de Tags da Aplicao
Siga os seguintes passos para editar um ou mais tags no datasheet Tags aplication:
E Selecione o tab Database e clique duas vezes no botot Datasheet View .
E Quando o datasheet Aplication Tags abrir, localize seu tag.
E Clique duas vezes na coluna que contenha as informaes a serem alteradas, e digite as novas
informaes no datasheet.
E Ao finalizar a edio, selecione File Save para salvar suas alteraes 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 opo aplicvel, no menu
pop-up.

Da pasta Tag List
Utilize os passos a seguir para editar um ou mais tags na pasta Tag List:
E Selecione o tab Database e clique duas vezes na pasta Tag List para visualizar uma lista de
todos os seus tags.
E Localize seu tag e clique duas vezes no nome do tag para abrir um dilogo Properties.

Nota:
Pode-se tambm clicar duas vezes no cone do tab e selecionar Properties do menu
pop-up.

Dilogo Properties
O dilogo Properties contm campos e combo-boxes que correspondem em nome e funo a colunas no
datasheet Aplication Tags.
E Faa suas alteraes no dilogo Properties como se segue:
Par alterar as propriedades atuais Tag Type ou Web Data, clique no boto de seta e
selecione a nova informao da lista.
IWS 20/06/2007

InduSoft Web Studio

Pgina 142
Para alterar Array Size ou Description, clique com o cursor no texto existente e digite a
nova informao no text box.
E Clique em OK para salvar suas alteraes ao tags database e feche o dilogo Properties.

= Dica:
Pode-se alterar os dados no sheet Aplication Tags e/ou inserir/remover colunas
adicionais do sheet clicando com o boto direito e escolhendo a opo aplicvel
do menu pop-up.

Deletando Tags
C Ateno:
Antes de deletar um tag, recomendamos a utilizao do boto Object Finder na
barra de ferramentas Tag Properties (veja Utilizando o cone Object Finder na
pgina 85) a fim de verificar que voc no est utilizando o tag em outra parte da
Aplicao (telas planilhas de math, etc). Caso voc deletar um tag do banco de dados
da aplicao que ainda esteja sendo utilizado, um erro de compilao ser causado e
sua aplicao funcionar de uma maneira menos satisfatria.

Para deletar um tag do tag database, siga os passos a seguir:
E Abra a planilha do projeto Aplication Tags como descrito na pgina 141.
E Localize e clique no nome do tag que voc deseja deletar.
E Recorte o tag da pgina como se segue:
Selecione Edit Cut da barra de menu principal.
Clique com o boto direito no nome do tag e selecione Cut do menu pop-up.
Aperte Ctrl+x no teclado.
E Quando aparecer o prompt de pop-up Are You Sure? clique em Yes para continuar ou em No
para cancelar a deleo.
E Salve a pgina (File Save).
IWS 20/06/2007

InduSoft Web Studio

Pgina 143
Captulo 6: Criando e Configurando um Projeto
Esse Captulo explica como criar e configurar projetos no InduSoft Web Studio. As informaes nesse
captulo esto organizadas da seguinte maneira:
Criando Aplicao para um Novo ProjetoProjeto
Especificando Configuraes Adicionais do Projeto
Iniciando Mdulos de Runtime no Target system
Criando Aplicao para um Novo Projeto
Utilize os seguintes passos para criar a aplicao para um novo projeto:
E A partir da barra de menu principal, selecione File New.
E Quando o dilogo New aparecer, selecione o tab Project.

Dilogo New: Tab Project
necessrio fornecer um nome para a aplicao do projeto, alm de indicar onde dever ser armazenado
tanto o projeto quanto todos os arquivos a ele relacionados (como os arquivos de configurao).
E Digite um nome na caixa de texto Application name nunca esquecendo-se de que:
Voc dever seguir as convenes de nomeao usuais do Windows.
No utilize espaos caso voc queira acessar seu projeto a partir da Web. (URLs no
reconhecem espaos.)

Nomeando o Projeto
IWS 20/06/2007

InduSoft Web Studio

Pgina 144
Notas:
O IWS armazena todos os projetos, por padro, no diretrio C:\Documents and
Settings\My Documents\InduSoft Web Studio v6.1 Projects\, assim esse caminho
estar exibido no campo de texto Location (um campo view-only) automaticamente.
A caixa de texto Configuration file tambm um campo view-only. O IWS armazena
automaticamente seu arquivo de configurao do projeto na mesma pasta onde
est seu projeto.

Armazenando Projeto e Arquivos de Configurao
E Para salvar seu projeto em um local que no seja no diretrio padro, clique no boto Browse
para localizar e selecionar uma pasta.
E Selecione um nvel de licena a partir da lista Target platform para indicar a plataforma na qual
voc rodar esse projeto.

Lista Target Platform
Para verificar o nvel de sua licena atual, feche todos os mdulos do IWS, e depois selecione Start
Programs InduSoft Web Studio Register.
E Quando o dilogo Protection Manager aparecer, clique no boto Check para abrir o dilogo
Hardkey Settings ou Softkey Settings (dependendo do seu tipo de proteo da licena), o qual
dever conter as informaes de sua licena atual.
E Feche ambos os dilogos quando estiver terminado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 145

Verificando o seu nvel de Licena
C IMPORTANTE!
Caso voc tente abrir ou desenvolver uma Aplicao que tenha sido originalemnte
desenvolvida com a utilizao de uma licena mais avanada do que a existente, o
IWS ir imped-lo de abrir a Aplicao e colocar em modo Demo. Para corrigir essa
situao, selecione Project Settings na barra de menu principal.
Quando aparecer o dilogo Project Settings, selecione o tab Options, e clique no
boto de seta Target Station. O IWS exibe somente aquelas plataformas alvo as
quais so autirizadas para utiliz-lo. Selecione uma dessas plataformas para
acomodar seu nvel de licena atual.
Embora a licena possa ser alterada (utilizando o dilogo Project Settings),
recomendamos que voc verifique e selecione seu nvel de licena atual, evitando
assim a perda de tempo no desenvolvimento da aplicao que requeira um nvel de
licena no compatvel ao atualmente configurado para utilizar o equipamento de
runtime. Recomendamos tambm o desenvolvimento com o menor nvel de licena
caso voc esteja rodando sua aplicao em computadores mltiplos e com
diferentes licenas.

E Ao terminar a configurao da tab Project, clique em OK para fechar o dilogo New.
O dilogo Project Wizard aparecer automaticamente, como se segue:
IWS 20/06/2007

InduSoft Web Studio

Pgina 146

Dilogo Project Wizard
E Enforce Viewer/Web compatibility: Quando esta opo checada, o modo de engenharia ajuda
o usurio a configurar a aplicao, sabendo quais funes funcionaro ou no em plataformas
remotas (InduSoft Secure Viewer e Web Thin Client). Nota: Na aplicao precedente esta opo
deschecada para manter compatibilidade.
E Utilize esse dilogo para especificar um modelo, configurar a resoluo padro de tela e para
indicar que voc deseja compartilhar tags com outros banco de dados do produto de softwares
do sistema, como Steeplechase ou ISaGRAF.
Instrues para a utilizao desses recursos so fornecidas nas sees que se seguem.
Especificando a Resoluo Padro de uma Tela
Utilize os botes no painel Resolution para especificar uma resoluo padro (dimenso para
exibio) para as telas da aplicao de seu projeto.

Selecionando uma Resoluo Padro
Nota:
Pode-se ajustar a resoluo da tela on-the-fly selecionando Tools Convert
Resolution. O recurso Convert Resolution utilize a resoluo de tela padro com uma
base e converte o tamanho de todas as telas da Aplicao de seu projeto.
IWS 20/06/2007

InduSoft Web Studio

Pgina 147

Compartilhando Tags de Banco de Dados do Programa de Controle Baseado em PC
Pode-se configurar seu projeto para que sejam compartilhados tags do banco de dados criados em
um programa de controle baseado em PC, como SteepleChase ou SixNet. Ao definer uma relao de
compartilhamento e selecionar um banco de dados, o IWS entregar os tags e ir adicion-los ao
banco de dados de sua aplicao. O IWS tambm configura as planilhas do Driver da Aplicao e
tags para utilize-las no outro programa.

Nota:
No possvel modificar tags compartilhadas com o IWSdeve-se modificar os tags no
programa de controle baseado em PC, e depois reimport-las para o tag databases.

Para definer uma relao de compartilhamento entre IWS e um programa de controle baseado em
PC, siga os passos a seguir:
E Partir do painel Shared Tags no dilogo Project Wizard, selecione um dos seguintes programas
de software da lista Name.
First ISaGRAF
ISaGRAF
Think & Do
SteepleChase
SixNet
Open Control
Straton
E Quando o boto Configure tornar-se ativo, clique nesse boto para abrir o dilogo
Configure:<Program Name>.

Compartilhando Tags
E No painel Diretrio da Aplicao clique(habilite) um dos seguintes botes:
Create: Cria um diretrio para uma nova Aplicao.
Select: Fornece a localizao de um diretrio de aplicao j existente.
IWS 20/06/2007

InduSoft Web Studio

Pgina 148
Digite o caminho do diretrio e nome da pasta no campo Select, ou clique no boto Browse
para selecionar a localizao.
Nota:
Os parmetros restantes no dilogo Configure:<Program Name> podero variar
dependendo do programa selecionado no primeiro passo. Cada programa de
controle baseado em PC possui sua prpria e costumizada interface. Antes de
compartilhar informaes entre Aplicao de controle baseado em PC e o IWS,
deve-se fornecer as informaes sobre a interface do programa de controle.
E Utilize a documentao do fabricante para seu programa de controle baseado em PC, e
configure os parmetros restantes no dilogo Configure:<Program Name>:
Parmetro Descrio
text field Server Name O IWS completa automaticamente esse campo. Para
alterar o padro, digite as informaes apropriadas
na caixa de texto.
check-box Automatic exchange data Habilitar ( ) esse box permite que os dois programas
troquem dados automaticamente.
check-box Communication with
Simulation Mode
Habilitar ( ) esse box permite que os dois programas
comuniquem-se em Modo de Simulao.
text field IP Address (Think and Do only) Digite o endereo IP da Aplicao controle baseada
em PC compartilhada.
Painel de Opes do Projeto:
Campo de texto Name (Steeplechase e
SixNet somente)
Digite o nome da Aplicao de controle baseada em
PC compartilhado.
Campo de texto Status (Steeplechase
somente)
Digite o status atual da Aplicao de controle
baseada em PC.
Campo de texto Version (Steeplechase
somente)
Digite a verso atual da Aplicao de controle
baseada em PC compartilhada.
Campo de texto Last Modification (SixNet
somente)
Digite a data quando a Aplicao de controle
baseada em PC foi atualizada pela ltima vez.
Boto Update (Steeplechase e SixNet
somente)
Clique nesse boto para atualizar sua Aplicao do
IWS com os dados da Aplicao de controle baseada
em PC compartilhada.

Configure: Tabelas de Parmetro <Program Name>
IWS 20/06/2007

InduSoft Web Studio

Pgina 149
Especificando Configuraes de Projeto Adicionais
Aps a criao de um novo projeto, voc pode utilizar os passos a seguir para configurar alguns parmetros
adicionais para tal projeto:
E A partir da barra de menu, selecione Project Settings tpara abrir o dilogo Project Settings, o
qual controla configuraes que afetam a Aplicao como um todo.

Dilogo Project Settings Tab Identification
O dilogo Project Settings contm cinco tabs:
Identification
Options
Runtime Desktop
Communication
Web
Preferences
As descries de cada tab, e as instrues para os parmetros de configurao dessas tabs
esto na prxima seo.
E Ao terminar a configurao dos parmetros no dilogo Project Settings, clique em OK para
fech-lo.

Nota:
Embora voce possa trocar os parmetros em Project Settings a qualquer momento
durante o desenvolvimento da Aplicao, recomendamos a configurao desses
parmetros j no comeo de seu projeto.
Por exemplo, o campo Startup screen define qual tela abrir ao iniciar sua
aplicao. Dessa forma, caso voc tente modificar ou rodar a aplicao sem um
IWS 20/06/2007

InduSoft Web Studio

Pgina 150
valor legtimo nesse campo, o IWS gerar uma mensagem de erro.
Provendo informaes de Identificao do Projeto
Ao abrir o dilogo Project Settings, aparecer o tab Identification por padro:

Dilogo Project Settings:Tab Identification
E Utilize os campos de texto nesse tab para fornecer as informaes a respeito de seu projeto.
Configurar esses campos uma tarefa opcional, mas as informaes podem ser muito teis
caso voc esteja compartilhando sua aplicao do projeto com colegas de trabalho, clientes, etc.
Description: Fornece uma breve descrio de seu projeto (como seu propsito).
Revision: Digite o nmero/letra da reviso atual para manter um traado das revises feitas
para sua aplicao.
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: Fornea o nome ou tipo de equipamento no qual a aplicao do projeto estar
rodando.
Notes: Insira quaisquer notas que voc ache que sejam teis.
E Ao terminar, clique em outro tab para continuar ou feche o dilogo.
Configurando as Parmetros do Tab Options
Selecione o tab Options para configurar o que se segue:
Habilitar traduo de linguagem
Especificar um target system
Especificar por quanto tempo salvar um arquivo Alarm History
Indicar o compartilhamento de tags com outra aplicao do software
Especificar como buffer comandos de Driver e escrita OPC
Especificar uma porta TCP
IWS 20/06/2007

InduSoft Web Studio

Pgina 151
Configurar parmetros para o banco de dados padro

Dilogo Project Settings Tab Options
Segue uma descrio dos parmetros do tab Options:
Target system: Utilize o combo box para especificar o target system para o projeto atual. O target system
configura as restries da aplicao (como o nmero de tags suportados) e deve aceitar sua licena. A
descrio das restries principais da licena para cada target system so exibidas abaixo do combo-box
onde voc a escolheu.
C Ateno:
Caso voc especifique um nvel de Target System level que no aceite o nvel da
licena atual na target station, a aplicao no rodar de forma apropriada.
Resolution: Exibe a resoluo da aplicao.
Automatic Translation: Clique (habilite) o check box Enable Translation para habilitar o recurso de
traduo. Digite o caminho do diretrio e o nome do arquivo a ser traduzido no campo de nome em
Translation File. O IWS utilize esse arquivo de traduo como uma linguagem padro ao iniciar a aplicao.

IWS 20/06/2007

InduSoft Web Studio

Pgina 152
Advanced:

Startup Column name: Nome da Coluna Inicial.
Ignore space chars at the end and beginning of the text: Ignorar caracteres de
espaos no final e no comeo do texto.
Keep original text when translation is blank: Manter texto original quando no
houver traduo (campo vazio).
Alarm History and Events: Digite um valor no campo History Life Time (em dias) para especificar por quanto
tempo deve-se manter os arquivos histricos de evento e alarme. Aps a especificao do nmero de dias, o
IWS deleta automaticamente os arquivos histricos existentes mais antigos do que o perodo especificado.
Caso voc digite zero nesse campo, o IWS no deletar quaisquer arquivos histricos automaticamente.
Nesse caso, deve-se criar um procedimento externo para limpar os arquivos histricos antigos; de outra
forma, uma memria livre no computador eventualmente sera deletada.
History Format: Selecione Proprietary para salvar dados histricos de Alarm/Event em formato de
propriedade (texto) a partes do IWS ou Banco de Dados para salvar os dados histricos de alarme/Evento
em um Banco de Dados Relacional, como um SQL Server, MS Access, Oracle, etc. Caso voc selecione
Database ao invs de Proprietary, clique em Event Database e Alarm Database para configurar o link com
banco de dados externos para dados histricos de Evento e Alarme. Veja na janela de dilogo Database
Configuration Dialog Window para maiores informaes.
Default Database: Permite a configurao de um Banco de Dados padro, que deve ser compartilhado por
diferentes tarefas e objetos. Veja em Configurando um Banco de Dados Padro para Todos os Histricos de
Tarefas para maoires informaes.
Shared Tags: Selecione um terceiro software a partir do combo-box. Clique no boto Configure para
configurar os parmetros para importao de tags a partir de uma das seguintes origens de dados em uma
pasta de Banco de Dados compartilhados:
Nome Descrio
<None> No compartilha tags com qualquer software externo
First ISaGRAF
Importa tags de um projeto First ISaGRAF para pasta Shared Tags da
aplicao atual e, quando habilitado, configura a interface de
comunicao com o driver ISAGR automaticamente.
ISaGRAF
Importa tags de um projeto ISaGRAF para a pasta Shared Tags da
aplicao atual e, quando habilitado, configure a interface de
comunicao com o driver ISAGR automaticamente.
Think & Do
Importa tags de um projeto Think & Do para a pasta Shared Tags da
aplicao atual e, quando habilitado, configure a interface de
comunicao com o driver TND automaticamente.
SteepleChase
Importa tags de um projeto SteepleChase para a pasta Shared Tags da
aplicao atual e configura a interface de comunicao com o driver
VLC automaticamente.
SixNet
Importa tags de um projeto SixNet para a pasta Shared Tags da
aplicao atual e configure a interface de comunicao com o driver
SNET automaticamente.
IWS 20/06/2007

InduSoft Web Studio

Pgina 153
Open Control
Importa tags de um projeto OpenControl para a pasta Shared Tags da
aplicao atual e configure a interface de comunicao com o driver OC
automaticamente.
Straton
Importa tags de um projeto Straton para a pasta Shared Tags da
aplicao atual e configura a interface de comunicao com o driver
STRAT automaticamente.

Nota
Cada controle baseado em PC possui sua prpria interface costumizada, a qual requer
o fornecimento de informaes sobre a aplicao de controle baseada em PC de forma a
compartilhar tags com aplicao do IWS.
Habilitando Traduo de Linguagem
Uma das utilidades fornecidas pelo IWS o Translation Editor, o qual permite a traduo da
aplicao a partir de um idioma para outro automaticamentetraduz essas aqplicaes para
quantos idiomas forem necessrios.
Caso voc queira traduzir seu projeto para outro idioma, deve-se habilitar o recurso de traduo e
especificar um arquivo de traduo padro, a partir do painel Automatic Translation no tab Options:
E Habilite ( ) o check-box Enable Translation.
E Utilize a caixa de texto Translation File name para especificar um nome de arquivo de traduo
padro e localizao.
O arquivo de traduo padro do projeto (<project name>.tra) controla o idioma na qual seu
ambiente de desenvolvimento e aplicao do projeto sero exibidos.
Por exemplo, caso voc especifique um arquivo de traduo padro em Espanhol , seu ambiente
de desenvolvimento e aplicao do projeto aparecero em Espanhol por padro.
Caso o nome do arquivo padro e localizao forem aceitveis, nenhuma ao sera
requisitada.
Caso voc queira especificar um arquivo de traduo distinto ou localizao, digite o nome
do arquivo e localizao na caixa de texto.
Nota:
Pode-se salvar arquivos de traduo em qualquer diretrio, embora recomendamos
que esses arquivos sejam salvos em sua pasta da Web, assim eles podero ser
utilizados por um Web Thin Client.
Por exemplo, caso seu idioma padro de desenvolvimento seja Ingls, e voc deseja
tornar o arquivo disponvel em Web Thin Clients, voc dever alterar o nome
padro da planilha para English.tra e salvar o arquivo na seguinte pasta:
C:\Program Files\InduSoft Web Studio\Projects\
<Project Name>\Web\English.tra

Aps habilitar a ferramenta de traduo para sua aplicao do projeto, v para o Captulo 16:
Utilizando o Translation Editor para uma descrio da utilidade, e tambm para finalizar a
configurao de seu projeto para traduo.
IWS 20/06/2007

InduSoft Web Studio

Pgina 154
Especificando o nvel de licena para Target System
O target system no qual voc rodar sua aplicao configura as restries da aplicao (como
suportar muitos dos tags). Conseqentemente, o nvel da licena do target system, assim como o
nvel da estao de desenvolvimento devem ser compatveis, ou sua Aplicao poder no rodar da
forma apropriada.
Clique no boto de seta do combo-box Target system e selecione seu nvel de licena do target
system a partir da lista.

Painel do Target system
A resoluo padro de tela exibida logo abaixo do combo-box. Essa resoluo o valor padro
especificado ao criar o projeto.
Nota:
Para alterar essa resoluo on-the-fly, feche todas as telas e selecione
Tools Convert Resolution a partir da barra de menu. Quando aparecer o dilogo
Convert Resolution, defina o tamanho que voc deseja utilizar, e a seguir clique no
boto Convert.

IWS 20/06/2007

InduSoft Web Studio

Pgina 155
Salvando arquivos histricos de alarme
O painel Alarm History permite o controle de quanto tempo os arquivos de histricos de alarme
ficaro armazenados em seu sistema.
Digite um valor no campo File Life Time (days) para especificar quantos dias os arquivos de alarme
devem ser mantidos. Por exemplo, caso voc especifique que sejam 7 dias, o IWS deleta
automaticamente todos os arquivos de alarme que tiverem mais de uma semana.

Painel Histrico de Alarme
Compartilhando tags com aplicao de controle baseada em pc
O processo para configurar esse painel idntico ao utilizado para a criao de um novo projeto.
Reveja Compartilhando Tags do Banco de Dados do Programa de Software de Controle Baseado em
PC na pgina 147.
Communicao com Drivers e OPC (Buffer)
Dado que IWS contm mltiplos mdulos que podem afetar valores no tag databases, e que
somente um mdulo pode rodar por vez, possvel que um valor de tag possa trocar vrias vezes
antes que o driver ou OPC Client receba esse valor e envie-o para o PLC ou OPC Server.
Conseqentemente, o IWS oferece a opo de amortecer os valores de tag.
Caso voc prefira utilizar o buffer, o IWS enviar cada troca de valor de tag para o PLC ou OPC
Serverna ordem na qual a troca realizada.
Caso voc decida no utilizar o buffer, o IWS enviar somente o valor atual para o PLC ou OPC
Server.
Utilize os parmetros do painel Communication para especificar como as trocas so escritas pelos
drivers e equipamentos OPC para equipamentos alvo, como PLCs e OPC Servers.
Clique no boto Driver and OPC do combo-box e selecione uma das seguintes opes da lista.
Send last state: Escreve apenas o valor do tag atual para o equipamento ou OPC Server.
(Selecionar essa opo conservar a memria.)
Send every state: Escreve todos as trocas de valores do tag para o equipamento ou OPC Server.
(Selecionar essa opo utiliza maior quantidade de memria, embora assegure uma
vizualizao completa e apurada das aes ocorrentes.)

Painel Communication
Especificando um porta TCP
Utilize o campo de texto Port no painel TCP para especificar uma porta para os mdulos TCP/IP
Client e Server do IWS para serem utilizados. Digite o nmero da porta no campo de texto:
IWS 20/06/2007

InduSoft Web Studio

Pgina 156

Painel TCP
Configurando configuraes do banco de dados para salvar histricos 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 especfico de
Banco de Dados capaz de suportar o banco de dados escolhidos.
Cada tarefa (Alarm, Events or Trend) pode ser configurada para salvar dados para arquivos com o
formato de prorpiedade do Studio ou Banco de Dados SQL Relacionados. Utilize o tab Options para
configurar o banco de dados e salvar histricos Alarm e Event. (Veja Configurando Parmetros do
Banco de Dados para Salvar Histricos de Trend para instrues sobre como salvar histricos de
tarefas de trend.)
Utilize o combo-box History Format para selecionar Banco de Dados, e clique nos botes Alarm
Database ou Event Database. A janela do dilogo Database Configuration dever abrir-se.

Nota:
Alarms e Events devem ser salvos em formato propriedade do IWS ou em Banco
de Dados Relacionados externo, embora possam ser salvos em diferentes
bancos de dados.
Cada planilha Trend pode ser configurada para salvar dados em formato de
propriedade IWS ou em um Banco de Dados Externo Relacional.

Janela do Dilogo Database Configuration
A janela de dilogo Database Configuration permite a configurao de parmetros necessrios para
o link do IWS com um Banco de Dados SQL Externo Relacional.

IWS 20/06/2007

InduSoft Web Studio

Pgina 157

Janela Database Configuration

combo-box Database: Permite selecionar Primary ou Secondary. Com Primary, todas as
configuraes exibidas em uma janela Database Configuration aplicaro para a interface do
Banco de Dados Primrio. Caso no for selecionado, sero aplicados para a interface do Banco
de Dados Secundrio. Pode-se configurar o banco de dados Secondary nos seguintes modos:
Disabled: Nesse modo, o IWS salva dados somente no banco de dados Primrio.Caso esse
esteja indisponvel por alguma razo, os dados no so salvos em nenhum outro local. Essa
opo pode causar perda de dados, caso o Banco de Dados Primrio no esteja disponvel.
Redundant: Nesse modo, o IWS salva dados em ambos os bancos de dados. Caso um deles
esteja indisponvel, o IWS mantm os dados salvos somente naquele banco de dados
disponvel no momento. Quando o banco de dados tornar-se disponvel novamente, o IWS
sincroniza ambos os banco de dados automaticamente.
Store and Forward: Nesse modo, o IWS salva dados somente no Banco de Dados Primrio.
Caso este esteja indisponvel, o IWS salvar os dados no Banco de Dados Secundrio.
Quando o primrio voltar a estar disponvel, o IWS mover os dados do Banco de Dados
Secundrio para o Primrio.
Utilizando o Banco de Dados Secundrio, voc pode ampliar a realstica do sistema, alm de
poder utiliz-lo como um backup quando o Banco de Dados Primrio no estiver disponvel.
Essa Arquitetura particularmente til quando o Banco de Dados Primrio est localizado em
uma estao remota. Nesse caso, voc poder configurar um Banco de Dados Secundrio na
estao local para salvar dados temporariamente se o Banco de Dados Primrio no estiver
disponvel (durante uma falha na rede de trabalho, por exemplo).
check-box Use Application default: Quando esta opo est habilitada, o IWS usar as
configuraes do Banco de Dados Padro para a tarefa a ser configurada (Connection string,
User name, Password, Retry Interval e Advanced Settings). Quando no habilitada, pode-se
configure-las individualmente para a tarefa atual.
Campo Connection string: Esse campo define o banco de dados onde o IWS escrever e ler
valores e parmetros principais utilizados ao conectar-se ao banco de dados. Ao inves de
IWS 20/06/2007

InduSoft Web Studio

Pgina 158
escrever a string de Conexo manualmente, pode-se pressionar o boto do browse () e
selecionar o tipo de banco de dados, a partir da janela Data Link Properties.

Janela Data Link Properties
Nota:
A lista de Fornecedores de Banco de Dados exibida na janela Data Link
Properties depende dos fornecedores atualmente instalados e disponveis no
computador onde o IWS est rodando. Consulte a documentao do sistema
operacional (ou a documentao do banco de dados) para maiores
informaes a respeito das configuraes do Fornecedor para o banco de
dados utilizado.

Campo User name: Nome do usurio utilizado para conectar-se ao banco de dados. Esse nome
do usurio configurado nesse campo deve ser compatvel quele configurado no banco de
dados.
Campo Password: Senha utilizada para conectar-se ao banco de dados. A senha configurada
nesse campo deve ser compatvel quela configurada no banco de dados.
Campo Retry Interval: Caso o IWS esteja desabilitado a conectar-se ao banco de dados por
qualquer razo, ele tentar nova conexo automaticamente aps o nmero de segundos
configurados nesse campo.
Boto Advanced: Aps pressionar esse boto, voc ter acesso a personalizao de algumas
configuraes. Para a maioria das aplicaes, o valor padro dessas configuraes no
necessitam ser modificados, e por isso devem continuar os mesmos.

IWS 20/06/2007

InduSoft Web Studio

Pgina 159

Janela Database Configuration Advanced
combo box Milissegundos: Voc pode configurar como os milissegundos sero salvos ao
salvar a data no banco de dados. Cada banco de dados salva a data em um formato
diferente; por exemplo, alguns bancos de dados no suportam milissegundos em um campo
Date. Esto disponveis as seguintes opes:
Default: Utiliza o formato pr-definido para o banco de dados atual. Os banco de dados
previamente testados pela InduSoft j esto configurados para a opo mais segura. Ao
selecionar o Padro, o IWS utiliza o parmetro pr-configurado para o tipo de banco de
dados atual. Caso voc esteja utilizando um banco de dados que no tenha sido
previamente testado pela InduSoft, a opo Default tentar salvar os milissegundos em um
campo separado.
Disable: No 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 preciso de milissegundos) e o nmero de milissegundos salvo
em uma outra coluna. Essa opo est indicada para quando voc desejar salvar
timestamps com milissegundos precisos, embora o banco de dados que voc est utilizando
no suporte milissegundos para os campos Date.

= Dica:
A opo padro para cada banco de dados est configurada no arquivo
StudioADO.ini, armazenado na sub-pasta \BIN do IWS. Veja Studio Database
Gateway, no Captulo 17:Interface do Banco de Dados do IWS, para informaes
sobre como configurar o arquivo StudioADO.ini.

check-box Save time difference: Quando essa opo estiver habilitada (padro), o IWS salva
o Time Zone em cada registro do banco de dados configurado no computador onde a
aplicao est rodando. Essa opo deve estar habilitada para evitar problemas com
horrios salvos (daylight).
Database Gateway: Insira o Endereo Host Name/IP onde o gateway do banco de dados do
Studio estiver rodando. O nmero da Porta TCP tambm pode ser especificado, mas caso
voc no esteja utilizando o padro, o gateway do banco de dados do Studio dever ser
configurado com a mesma Porta TCP. Veja Gateway do Banco de Dados do Studio, no
Captulo 17: Interface do Banco de Dados do IWS, para informaes sobre como configurar
os parmetros avanados do Gateway do Banco de Dados do Studio.
IWS 20/06/2007

InduSoft Web Studio

Pgina 160
Disable Primary Key: Para alguns mdulos, o IWS tentar definir uma chave primria para
a tabela de modo a aumentar a performance das consultas. Caso voc esteja utilizando um
banco de dados que no suporte chaves primrias (e.x. Microsoft Excel), voc dever
verificar esse campo.
Painel Table: Essa area permite a configurao de parmetros da Tabela onde os dados sero
salvos. Todas as tarefas podem compartilhar o mesmo banco de dados. Entretanto, cada tarefa
(planilhas Alarm, Events, Trend) devem estar em link com sua prpria tabela. A InduSoft no
faz verificaes em configuraes invlidas nesse campo, portanto voc dever certificar-se de
que a configurao vlida para o banco de dados que voc est utilizando.
check-box Use default name: quando esta opo estiver habilitada (padro), o IWS salva e/ou
entrega os dados na Tabela com o nome padro escrito no campo Name.
check-box Automatically create: Quando essa opo estiver habilitada (padro), o IWS cria uma
tabela com o nome escrito no campo Name automaticamente. Caso essa opo no esteja
habilitada, o IWS no criar a tabela. Portanto, caso no sera possvel salvar dados no banco de
dados, a menos que exista uma tabela configurada com o nome no campo Name manualmente.
Name: Especifica o nome da tabela do banco de dados onde os dados histricos sero salvos.
Boto Refresh: Caso o banco de dados esteja disponvel, pode-se pressionar o boto Refresh
para preencher o combo-box Name com o nome das tabelas atualmente disponveis no banco
de dados. Desse modo, pode-se selecionar a tabela onde os dados histricos devero 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. Esto disponveis os
seguintes campos:
check-box Status (output): O tag nesse campo receber um dos seguintes valores:

Valor Descrio
0
Desconectado do banco de dados. O banco de dados no est disponvel ou a
configurao 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 configurao. Quando voc deseja reconectar o banco de
dados utilizando os valores atualizados em seus tags, configure o tag nesse campo para valor 1.
O IWS atualizar as configurao na tentativa de executar a ao no banco de dados,
configurando o tag de volta a quando estiver finalizado.
Configurando um Banco de Dados Padro para Todos os Histricos de Tarefas
Embora o IWS permita a configurao de diferentes banco de dados para cada tarefa, o mesmo tipo
de banco de dados, tipicamente, (ex. SQL Server, MS Access, Oracle, etc) utilizado por todas as
tarefas do mesmo projeto. Portanto, de modo a economizar tempo ao configurar a aplicao, o IWS
permite a configurao do Default Database. Ao configurar cada tarefa, voc poder escolher o que
ser configurado em cada banco de dados padro. Escolhendo esse mtodo, no sera necessrio
reconfigurar os mesmos parmetros para cada tarefa, desde que essas compartilhem o mesmo
banco de dados.
As configuraes padro para o Default Database podem ser ajustadas pressionando o boto
Configure no box Default Database, no tab Options do dilogo Project Settings.

IWS 20/06/2007

InduSoft Web Studio

Pgina 161

A janela do dilogo Default Database Configuration abrir.

Janela Default Database Configuration
Retorne a seo anterior, janela do dilogo Database Configuration, para auxlio no preenchimento
dos campos nessa janela.
Configurando os Parmetros da rea de Trabalho de Runtime
Ao rodar uma aplicao na estao de trabalho de runtime (ou alvo), o IWS exibe a aplicao em
uma janela Viewer. Pode-se configurar a aparncia dessa janela Viewer como se segue:
E Selecione a aba Runtime Desktop no dilogo Project Settings:
IWS 20/06/2007

InduSoft Web Studio

Pgina 162

Dilogo Project Settings Tab Runtime Desktop
E Habilite ( ) um ou mais dos seguintes check-boxes para exibir os recursos na janela Viewer (ou
desabilite os boxes para esconder o recurso):
Nota:
O IWS salva todas as propriedades exibidas no arquivo .APP da aplicao.

Titlebar: Exibe uma barra de ttulo no topo da janela. Digite um nome no prximo campo para alterar o
texto padro do ttulo na barra.
Minimize Box, Maximize Box, e Close Box: Exibe trs botes, podendo minimizar, maximizar ou fechar a
janela Viewer.
Start Maximized: Maximiza a janela automaticamente ao rodar a aplicao.
Menu: Exibe uma barra de menu na janela Viewer.
Para especificar quais menus e opes de menu estaro disponveis na barra de menu, clique no
boto Options.
IWS 20/06/2007

InduSoft Web Studio

Pgina 163

Dilogo 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 especfica da aplicao ao iniciar seu runtime.
Para especificar uma tela, digite o nome da tela no campo de texto fornecido (por exemplo
main).
Show ???? when quality is not GOOD: Exibe marcas a (???) ao invest de valores de tags quando a qualidade
do tag no estiver boa.
Hide Taskbar: Esconde a barra de tarefas Windows por padro.
Enable ToolTips: Exibe Windows ToolTips ao rodar a aplicao.
Para configurar ferramentas para um objeto em sua aplicao, clique duas vezes no objeto
para abrir o dilogo Object Properties e digite seu caminho no campo Hint.
Auto Screen Scaling: Dimensiona a tela da aplicao automaticamente ao redimensionar a janela Viewer.
Esse recurso est disponvel para aplicaes locais rodando em Windows NT/2000/XP (ou Web Thin
Clients). Esse parmetro no est disponvel para aplicaes locais rodando em Windows CE.
Show Object Edge: Troca o limite do objeto ao mover o cursor sob qualquer objeto onde um dinmico
Command foi aplicado.
Change Mouse Cursor Troca o cursor do mouse ao move-lo sob qualquer objeto onde o dinmico Command
foi aplicado.
Mouse Cursor: Exibe o cursor do mouse na janela Viewer.
Virtual Keyboard: O IWS Virtual Keyboard (VK) permite ao usurio inserir dados (textos ou nmeros)
durante o runtime utilizando um equipamento touch-screen ou um teclado convencional.
Voc pode habilitar o VK para sua aplicao no dilogo Runtime Desktop (item do menu:
Project pulldown->Settings->tab Runtime Desktop). Pode-se designar um Default Virtual
Keyboard, assim como aplicar uma Escala (dimensionamento) para todos os teclados
virtuais durante o runtime.
Ao configurar objetos e dinmicos que suportam dados de entrada, pode-se selecionar um
VK para o objeto atravs do combo-box VK (padro ou especfico). Esto disponveis os
seguintes VKs padro:

IWS 20/06/2007

InduSoft Web Studio

Pgina 164
Nome Figura Descrio
AlphaNumeric

Esse VK utilizado
alfanumricos
(smbolos ou
nmeros).
EnhKeypad

Esse VK utilizado
alfanumricos
(caracteres ou
nmeros) em
equipamentos que
possuam uma tela
pequena (e.x. PDAs).
O boto -> permite
aos usurios navegar
por diferentes painis
at encontrar o
caractere desejado.
Keypad

Esse VK utilizado
numricos (somente
nmeros).

Existem duas formas de alcanar um Virtual Keyboard durante o runtime:
Clique no objeto onde novos valores (dados) possam ser inseridos (e.x. Texto com dinmico
Text I/O configurado com Entrada habilitada).
Execute a funo built-in Keypad() .
Alterar a linguagem do Virtual Keyboard atravs da funo built-in SetKeyboardLanguage().
D Dicas:
Pode-se criar uma nova linguagem para qualquer Virtual Keyboard editando o
arquivo VK<Language>.INI na sub-pasta \BIN do IWS, onde <Language> a
marcao da linguagem para os VKs (ex. VKEN.INI = Virtual Keyboards em
Ingls; VKGE= Virtual Keyboards em Alemo, etc). Consulte seu fornecedor do
software para maiores informaes a respeito de como editar e configurar esse
arquivo.
Por padro, o VK posicionado prximo ao objeto na tela associada a ele.
Porm, possvel configurar os seguintes parmetros no arquivo
<AplicaoName>.APP, e o VK sempre estar aberto em uma posio 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.
IWS 20/06/2007

InduSoft Web Studio

Pgina 165
Scale: Usando esta opo o usurio pode aumentar ou diminuir os teclados para ficarem de
acordo com o melhor tamanho para o target panel. A escala de 100% representa o tamanho
default de cada um dos teclados virtuais. As opes de tamanho so de 25% a 400%, mas voc
pode tambm determinar um tamanho customizado de escala.
Show Hint: Especifique aqui o ttulo do Virtual Keybord a ser mostrado no dilogo.
Show Min/Max fields: Habilite esse check-box para a visualizao dos valores mximos e
mnimos permitidos pelo tag.

E Ao terminar, clique em outra tab para contibuar, ou feche o dilogo.
Configurando os Parmetros de Comunicao
Utilize esse tab para especificar parmetros de comunicao relacionados a aplicao em geral.

Project Settings > Tab Communcation
Driver and OPC: Selecione o mtodo utilizado para todos os drivers de comunicao e planilhas OPC
configuradas na aplicao atual ao escrever valores para o equipamento PLC remoto
Send every state: Quando a tarefa de comunicao est configurada para escrever valores
para um troca de valores de tag, todas as trocas nos valores de tag sero manipuladas e
enviadas para o equipamento quando a a tarefa de comunicao for executada (para Driver
ou OPC).
Send last state: Quando a tarefa de comunicao est configurada para escrever valores
sob uma alterao de valores de tag, somente a valor atual (o ltimo) do tag sera enviado
para o equipamento quando a tarefa de comunicao (Driver ou OPC) for executada.
Quando esse metdo estiver selecionado, caso o valor do tag mude mais de uma vez
enquanto tarefa de comunicao no estiver sendo executada, os valores transitrios do tag
no sero enviados para o equipamento. Esse o comportamento desejado para a maioria
das aplicaes.
TCP: Configurar os parmetros para os mdulos TCP/IP Client e TCP/IP Server:
IWS 20/06/2007

InduSoft Web Studio

Pgina 166
Port: Porta TCP utilizada pelos mdulos TCP/IP Client e TCP/IP Server que estejam
rodando no computador atual. Ao alterar esse valor na aplicao local, certifique-se de que
seja o mesmo valor da aplicao remota comunicando-se com a aplicao local.
Send Period (ms): Perodo (em milissegundos) utilizado entre duas mensagens consecutivas,
enviadas pelos mdulos TCP/IP Client ou TCP/IP Server para a atualizao dos valores de
tag na estao remota. Tipicamente, um nmero menor de igualdades tm melhor
performance e trfico mais avanado pela rede de trabalho.
Enable Cryptography: Verifique essa opo para habilitar a criptografia quando os mdulos
TCP/IP Client ou TCP/IP Server enviam as mensagens para a estao remota. A
criptografia aumenta a segurana do sistema; porm, diminui a eficincia (performance) da
aplicao. Ao conectar duas estaes via mdulos TCP/IP Client e TCP/IP Server,
certifique-se de que essa configurao est habilitada para ambas as aplicaes, ou
desabilitada para as duas igualmente.
Configurando Seu Projeto para Acesso Remoto a Web
Para configurar um projeto da aplicao de forma que Web Thin Clients possam acessar a aplicao
a partir da maioria dos browsers da web (como Internet Explorer ou Netscape), utilize o seguinte
procedimento:
E Selecione o tab Web no dilogo Project Settings:

Project Settings Dialog Web Tab
E Configure os parmetros nesse tab, como se segue:
campo Data Server IP Adress: Digite os dados do endereo IP server (endereo IP onde a aplicao rodar).
campo Send Period: Especifique a frequncia (em milissegundos) com que as estaes Server e Web Thin
Client podem trocar (enviar) dados.
IWS 20/06/2007

InduSoft Web Studio

Pgina 167
check-box Disable Remote Client Commands: Habilite ( ) esse box para evitar que um Web Thin Client
remoto d comandos sua aplicao.
check-box Enable ToolTips: Habilite ( ) esse box para ver Windows ToolTips ao visualizar as telas da
aplicao no Web Thin Client (browser).
check-box Auto Screen Scaling: Habilite essa opo caso esteja rodando a aplicao 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
aplicao. Essa opo til para a reduo no tempo de downloadparticularmente se uma conexo lenta
estiver estabececida entre Server e Web Thin Client.
Pode-se especificar quais computadores estejam habilitados a acessar sua aplicao como Web Thin
Clients. Clique no boto IP Security para abrir o dilogo IP Security:

Dilogo IP Security
Utilize os parmetros desse dilogo para especificar quais computadores podero ter acesso sua
aplicao:
Clique no check-box Enable ( ) para ativar os campos From e To.
Digite os endereos IP de sada e entrada nos campos From e To, respectivamente.
Aparecer uma lista de computadores especficos em IP Address Range.
Clique no boto Add para adicionar endereos IP lista IP Address Range ou clique no
boto Remove para deletar endereos IP da lista.
Notas:
Pode-se especificar os mesmo endereo IP nos campos From e To a fim de
limitar a escala a um nico endereo IP.
Pode-se tambm especificar vrias escalas.

Clique em OK para fechar o dilogo IP Security.
Para gerar arquivos de log na mquina Web Thin Client para correo de erros, habilite ( ) o check-box
Enable (na painel Log) e indique onde o IWS dever salvar os arquivos, digitando o nome e local do arquivo
no campo de texto FileName.
Para habilitar o Virtual Keyboard para estaes Web Thin Client, independentemente da estao 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 aplicao. As opes so
AlphaNumeric, EnhKeypad e Keypad.
IWS 20/06/2007

InduSoft Web Studio

Pgina 168
Scale: Habilitando essa opo, possvel aumentar ou alargar os teclados para
adequarem-se propriamente com o tamanho da tela do painel alvo. Scale: 100%
representa tamanho padro de cada Virtual Keyboard. As opes vo de 25% a
400%, embora voc tambm possa inserir uma escala customizada.
Show Hint: Especifique aqui o ttulo do Virtual Keybord a ser mostrado no dilogo.
Show Min/Max fields: Habilite esse check-box para a visualizao dos valores mximos e

E Ao terminar, clique em outra tab para continuar ou feche o dilogo.
IWS 20/06/2007

InduSoft Web Studio

Pgina 169
Especificando Parmetros Web Thin Client
Utilize o procedimento a seguir para especificar parmetros Web Thin Client:
E Selecione a tab Web no dilogo Project Settings:

E Configure os parmetros nesse tab como se segue:
campo Data Server IP Address: Digite o endereo IP (ou host name) da estao servidora de seus dados. A
estao servidora de dados o computador ou equipamento onde o mdulo TCP/IP server do IWS est
rodando.

D Dica:
Pode-se utilizar o endereo IP 127.0.0.1 (local host) para acessar o TCP/IP server no
computador local (apesar do endereo IP da rede de trabalho). Essa opo til para
testes locais; porm, no sera possvel acessar o servidor de dados de computadores
remotos utilizando essa configurao.

campo Send Period (ms): Digite um valor para especificar o perodo de envio em milissegundos) utilizado
para trocar dados entre o servidor e estaes 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 padro de 1000 (milissegundos). Pode-se configurar um valor menor nesse
campo a fim de aumentar a taxa de atualizao entre o servidor e os Web Thin
Clients, resultando em maior trfico de informaes atravs da rede de trabalho (a
rede de trabalho sera acessada com maior frequencia) caso os tags estejam sendo
trocados continuamente (com mais de 1 segundo).
IWS 20/06/2007

InduSoft Web Studio

Pgina 170
check-box Disable Remote Client Commands: Clique para habilitar esse box para a preveno de
comandos provenientes de clientes remotos a partir do Web Thin Client para seu servidor. Quando essa
opo est habilitada, o Web Thin Client capaz de ler dados do servidor, embora no possa enviar dados
(valores de tag, set-points) para o servidor de tags. Nesse caso, a estao Web Thin Client aparece como um
estao 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 automtica de telas exibidas em uma janela
do browser da web. Utilizando essa opo, a tela dimensiona-se ao tamanho da janela do browser, de
acordo com sua resoluo.

Nota:
A opo Auto Screen Scaling no vlida para browsers que estejam rodando sob
sistemas operacionais Windows CE.

check-box Enable File Compression: Clique para habilitar a compresso de arqueivos armazenados na
pasta \Web da Aplicao. Essa opo til para reduzir o tempo de download, particularmente se voc tiver
uma conexo lenta entre seu servidor e o Web Thin Client.
Log (check-box Enable e text field FileName): Clique para habilitar o check box, e digite o nome do arquivo
no campo de texto para gerar um arquivo de log na estao Web Thin Client. Tambm pode-se utilizar esse
arquivo de log para correo de erros.
Virtual Keyboard: Quando essa opo est habilitada, o virtual keyboard estar capacitado para estaes
Web Thin Client. O teclado virtual permite ao usurio a insero de dados durante o runtime, com touch
screen baseado em painis Web Thin Client.
Default: O usurio pode selecionar o teclado padro utilizado na aplicao para as estaes Web Thin
Client.
Scale: Utilizandoessa opo, o usurio 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 padro de
cada teclado virtual.
boto IP Security: Clique nesse boto para abrir o dilogo IP Security.

Dilogo IP Security
Utilize os parmetros desse dilogo para especificar a escala de endereos IP para os computadores que so
habilitados a acessar a aplicao como Web Thin Clients. Essa opo til para controlar os endereos IP
de computadores Web Thin Client os quais so permitidos a conectar-se com o Server.
IWS 20/06/2007

InduSoft Web Studio

Pgina 171
Clique no check-box Enable e quando os parmetros do painel Edit tornarem-se ativos, digite os endereos
IP nos campos From e To para especificar a escala dos endereos IP. Utilize os botes Add e Remove para
mover os endereos IP para a lista IP Address Range. Quando um Web Thin Client tentar conectar-se ao
servidor, este ser verificado pela estao, e esse recurso permitir o acesso somente para aqueles
endereos IPs os quais esto adicionados lista previamente estabelecida no dilogo. O servidor recusar a
conexo de Web Thin Clients no encontrados.
Boto Advanced: Clique nesse boto para abrir um dilogo onde voc poder editar as configuraes
Avanadas para Web. Na maioria dos casos, essas configuraes no devem ser modificadas. Porm,
dependendo da Arquitetura utilizada em seu projeto, voc ter a flexibilidade de configurar configuraes
avanadas.
Campo Secondary Data Server IP Address: Digite o endereo IP (ou host name) da estao
servidora de dados secundria, o computador ou equipamento onde o mdulo TCP/IP
server do IWS est rodando. Esse campo deve ser preenchido quando voc estiver
utilizando servidores de dados redundantes de Web Thin Clients. Caso o servidor primrio
falhar, o Web Thin Client tentar conexo com o servidor secundrio automaticamente.
Campo BackUp URL: Digite a URL onde os arquivos da web esto armazenados (arquivos
da sub-pasta \Web da Aplicao). Essa URL utilizada para fazer download de arquivos a
partir do servidor secundrio da web, quando o servidor primrio no estiver disponvel.

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 primrio, mesmo que voc
no possua uma Arquitetura redundante.

Campo ISSymbol download path: Quando o Web Thin Client conecta-se ao servidor, este
tenta carregar o controle ISSymbol. Caso este no esteja registrado no computador local
(Web Thin Client), o browser tentar fazer seu download a partir da URL especificada nesse
campo. A URL padro um site da web onde a InduSoft mantm a maioria das verses
atulaizadas de ISSymbol disponveis para download. Talvez seja necessrio configurar um
local distinto, especialmente quando o computador Web Thin Client no estiver conectado
internet. ISSymbol.cab e ISSymbolA.cab (armazenados na sub-pasta \BIN do IWS) devero
estar disponveis na URL configurada nesse campo.

D Dica:
Quando as estaes Web Thin Client no possuem acesso internet,
recomendado que os arquivos ISSymbol.cab e ISSYmbolA.cab estejam
disponveis na estao servidora da web, e que a URL seja configurada por
eles nesse campo.

Nota:
Browsers da Web que estejam rodando sob sistema operacional Windows CE
no so capazes de fazer o download automtico do controle ISSymbol
(ISSymbolCE.ocx) a partir de um local remoto. Assim, ISSymbolCE.ocx dever
ser registrado manualmente no equipamento com Windows CE para esse
poder ser usado como um Web Thin Client.

IWS 20/06/2007

InduSoft Web Studio

Pgina 172
check box Web Tunneling Gateway: Habilite essa opo para capacitar o Web Tunneling
Gateway. Dependendo da Arquitetura de seu projeto, pode ser necessria a utilizao do
Web Tunneling Gateway para conduzir computadores Web Thin Client ao servidor de
dados.
HTTP Port: Selecione essa opo 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 padro para protocolos HTTP).
SSL Port: Selecione essa opo ao utilizar (Secure Socket Layer) com o servidor da web
IIS da Microsoft. Pode-se especificar a porta TCP utilizada pelo seu servidor HTTPS (443
a porta TCP para protocolos HTTPS).
IP Address: Endereo IP do computador onde o Web Tunneling Gateway est rodando.
Esse dever ser o endereo IP do servidor da web acessvel a partir da(s) estaes Web
Thin Client.
Secondary IP Address: Endereo IP do computador web server onde o Web Tunneling
Gateway est rodando. Esse dever ser o endereo IP do web server secundrio acessvel
a partir da(s) estaes Web Thin Client. Esse campo dever ser configurado quando web
servers redundantes estiverem sendo utilizados.

D Dica:
A maioria das configuraes da Web podem ser modificadas dinamicamente
atravs da funo SetWebConfig(). Essa funo especialmente til quando
deseja-se criar uma aplicao nica, e certificar-se de que as configuraes
da web sero automaticamente configuradas ao rodar a aplicao em
diferentes estaes, com diferentes endereos IP.

Habilitando Mensagens de Aviso
O IWS permite o controle do aparecimento de mensagens de aviso antes que as telas da aplicao
sejam baixadas no target system.
E Selecione o tab Preferences.
E Clique no check box Display warning messages before downloading screen to the target system
para habilitar ( ) ou desabilitar ( ) a funo. Quando essa opo estiver habilitada e voc
modifica o nome de qualquer tag na planilha de Tags da aplicao, voc ser requisitado a
substituir o nome antigo do tag pelo novo para toda a aplicao. Com essa opo est
habilitada, o IWS executar o comando de substituio global, a fim de substituir os nomes em
todos os documentos da Aplicao (telas e planilhas).
E Clique em qualquer das outras mensagenss:
Display confirmation message when renaming application tags: Quando essa opo est habilitada e voc
deseja modificar o nome de qualquer tag na planilha de Tags da aplicao, voc sera requisitado a
substituir o nome antigo do tag pelo novo nome em toda a Aplicao. Com essa opo habilitada, o IWS
executar a substituio global em todos os documentos da aplicao (telas e planilhas).
Display confirmation message when changing the screen position and size: Quando essa opo est
habilitada, voc sera requisitado a atualizar screen attributes (Largura, Altura, Superior e Esquerda) aps
a modificao dessas telas na interface de Layout.
Display warning message after saving symbols: Opo que exibe ou no uma caixa de dilogo aps salvar
symbols. uma mensagem de alerta para que a screen seja salva pois as alteraes no .sym no garantem
que o symbol inserido numa screen tambm seja atualizado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 173
Quality Feedback Service: Esta seo permite que voc configure o IWS ou CEView para gerar
arquivos de registro e/ou arquivos de dump com informao til para eliminar erros e detectar
a razo dos problemas, como erros fatais ou problemas causados por hardware ou software.
Generate a log file when an unexpected error happens: Quando esta opo checada, os
mdulos runtime adicionam o arquivo de Dump.txt sempre que um erro interno (exceo)
ocorre. Estas excees no necessariamente terminam os mdulos runtime. Entretanto, as
excees podem afetar a estabilidade do sistema, assim devem ser investigadas.
Generate a log file when an unexpected error happens: Ao checar esta opo, os mdulos
runtime geram um novo arquivo de Dump (binrio) com informao til sobre as condies de
erro. A informao disponvel neste arquivo pode ser decodificada somente pelos desnvolvedores
do produto. A fim de evitar que um arquivo de Dump sobrescreva quando um erro novo ocorra,
estes arquivos so nomeados WinXXX.dmp, onde XXX um nmero aleatrio (no formato
hexadecimal) gerado automaticamente pelo sistema. Conseqentemente, se mais de um erro
ocorrer, voc encontrar arquivos de mais de um Dump no mesmo diretrio.
Enable log of memory: Quando esta opo checada, os mdulos runtime adicionam
informaes sobre o alocamento de memria atual na plataforma runtime ao arquivo de
Dump.txt a cada 15 minutos. Aps ter comeado o IWS ou CEView, voc ter que esperar 15
minutos antes que a arquivo de registro (Dump.txt) seja adicionado com o primeiro registro de
memria. Esta informao til para identificar situaes de perda memria.
Todos os arquivos de registro (formato de texto) e os arquivos de Dump (formato binrio) so
criados na sub pasta \Web\Dump da aplicao.
Mesmo se nenhum dos check-boxes disponveis nesta relao forem checados, um arquivo de
Dump nomeado WinDump.dmp estar gerado caso o IWS ou CEView so terminados por um
erro fatal.
O arquivo de Dump.txt ser adicionado at que alcanar seu tamanho mximo (2MB). Aps ter
alcanado seu tamanho mximo, o Dump.txt suprimido e um arquivo novo criado.
Quando um arquivo de Dump gerado, o arquivo de registro indica o nome do arquivo de
Dump associado a cada erro. Conseqentemente, para finalidades de eliminao de erros,
recomendado habilitar todas as opes disponveis nesta seo 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 Aplicao: Caso essa opo estiver verificada, os tags da aplicao sero
reiniciados automaticamente sempre que voc rodar a aplicao (Project > Run Application). Veja Tools >
Reset Tags Database para maiores detalhes sobre esse recurso.
Enforce Viewer/Web compatibility: Quando esta opo checada, o modo de engenharia ajuda o usurio a
configurar a aplicao, sabendo quais funes funcionaro ou no em plataformas remotas (InduSoft
Secure Viewer e Web Thin Client). Nota: Na aplicao precedente esta opo deschecada para manter
compatibilidade.

IWS 20/06/2007

InduSoft Web Studio

Pgina 174

Dilogo Project Settings Tab Preferences
E Ao terminar, clique em outro tab ou feche o dilogo.
Iniciando Mdulos de Runtime no Target system
Aps especificar um target system para a aplicao de seu projeto, o, InduSoft Web Studio permite
a especificao de quais mdulos de runtime de seu projeto devero ser iniciados automaticamente
no target system, e quais deles devero ser iniciados manualmente.
Nota:
O IWS configura, por padro, certos mdulos para iniciarem-se automaticamente,
embora permita a alterao desses padres.

Com o dilogo Project Status, voc pode:
Configurar as tarefas que devero ser executadas automaticamente assim que a aplicao
for iniciada (tab Execution Tasks)
Iniciar/parar cada tarefa de runtime manualmente (tab Execution Tasks)
Rever informaes a respeito do sistema de desenvolvimento e de suas aplicaes (tab
Information)
O tab Execution Tasks exibe a lista de tarefas disponveis para a aplicao atual. Status e modos de
startup (Automtico ou Manual) tambm so exibidos.
Para especificar como os mdulos sero iniciados no target system, siga os seguintes passos
E A partir da barra de menu principal, selecione Project Status para abrir o dilogo Project
Status.
IWS 20/06/2007

InduSoft Web Studio

Pgina 175
E Selecione o tab Execution Tasks, no qual esto as listas de todos os mdulos de runtime
associados ao seu projeto, alm do status atual do start-up.
Nota:
O tab Execution Tasks estar disponvel somente quando a opo Target Station do
dilogo Execution Environment (Project Execution Environment) estiver
configurado como Local.

Essa lista contm trs colunas, incluindo Task Name, Status de runtime configurao de
Startup atual (Automatic ou Manual) de cada tarefa de runtime.
Por exemplo, veja a figura que se segue:

Dilogo Project Status: Tab Execution Tasks
A lista de tarefas disponveis nesse dilogo depende do target system configurado no tab Options. A
tabela a seguir lista as tarefas que no estaro disponveis para aplicaes projetadas em sistema
operacional Windows CE:
Tarefa Disponvel para WinCE runtime OS
Background Task Sim
Database Spy No
DDE Client Runtime No
DDE Server No
HAD OPC Server No
Driver Runtime Sim
LogWin No
ODBC Runtime No
OPC Client Runtime Sim
Studio Scada OPC Server Sim
TCP/IP Client Runtime Sim
TCP/IP Server Sim
Viewer Sim

IWS 20/06/2007

InduSoft Web Studio

Pgina 176

Notas:
Como existem muito drivers sendo adicionados constantemente, o mdulo Driver
runtime inicia por si s todos os drivers configurados na aplicao atual do projeto.
Started no sera exibido na coluna Status quando voc iniciar o mdulo Driver;
porm, aparecer um cone para cada driver no canto direito e embaixo da barra de
tarefas do Windows.
Para parar um driver individual, clique com o boto direito no cone e selecone Exit
no menu pop-up.

Driver Runtime - OMETH Driver Runtime - KOYO

Verificando que os drivers estejam rodando
E Pode-se configurar tarefas para execuo automtica quando a aplicao iniciada. Para isso,
clique nome da aplicao no tab Execution Tasks, pressione o boto Startup e escolha a opo
Automatic.

Dilogo Startup
As tarefas configuradas como Startup = Automatic so executadas automaticamente
quando a aplicao for iniciada; as tarefas configuradas como Startup = Manual no sero.
Pode-se tambm Iniciar/Parar cada tarefa de runtime clicando-se no nome, e ento
pressionando os botes Start ou Stop.
Nota:
Caso o tab Execution Tasks no esteja visvel, clique em click Project ->
Execution Environment e certifique-se de que a Estao Alvo (Target Station)
esteja configurada como Local. O tab Execution Tasks estar disponvel
somente quando o Target Station for local.

D Dica:
Pode-se tambm iniciar/parar cada tarefa durante o runtime utlizando-se das
funes built-in StartTask() e EndTask(). possvel tambm utilizar a funo
IWS 20/06/2007

InduSoft Web Studio

Pgina 177
IsTaskRunning() para verificar cada tarefa que esteja rodando durante o
runtime.

C Ateno:
Os comandos disparados pelo dilogo sero executados na estao remota (e no
no computador local) assim que voc estiver conectado a uma estao remota.

E O tab Information do dilogo Project Status exibe a lista de tarefas disponveis para a aplicao
atual, como ilustrado a seguir:

Dilogo Project Status: Tab Information
A maioria das informaes importantes exibidas nesse dilogo so aquelas do banco de dados
da aplicao (inicial), fornecendo o nmero de tags da aplicao configurados na aplicao
atual. Essas informaes so teis para avaliar quais licenas sero mais apropriadas para a
aplicao em questo.
E Ao terminar, clique em OK para fechar o dilogo Project Status.

Aps criar e configurar um projeto, voc poder fazer o design das telas da aplicao, alm de criar
suas planilhas de tarefas.
Instrues para a criao de telas so fornecidas no Captulo 7: Configurando Telas e Grficos.
Instrues para a criao de planilhas so fornecidas no Captulo 8: Configurando Planilhas de
Tarefas.
IWS 20/06/2007

InduSoft Web Studio

Pgina 178
Captulo 7: Configurando Telas e Grficos
Esse Captulo fornece informaes sobre como configurar telas e grficos. Antes de criar uma tela na
aplicao, voc dever levar em considerao a estrutura da tela. As aplicaes em Windows NT/2000/XP
permitem que voc abra mais de uma tela, mas aplicaes em Windows CE criam uma tela padro com
cabealho e rodap (a ser utilizada como modelo temporrio), e nessa tela voc poder inserir os objetos.
Aps criar e inserir objetos na tela, voc dever salvar a tela temporria com nomes diferentes para que
telas diferentes sejam criadas.
Tipicamente, uma tela da aplicao do InduSoft Web Studio consiste de trs reas bsicas (ou tipos de
telas):
Header: Objetos localizados na parte superior da tela, fornecendo informaes padro (data,
hora, etc).
Footer: Objetos localizados na parte inferior da tela (tipicamente, um objeto de alarme exibindo
o ltimo alarme).
Regular: rea entre o cabealho e o rodap, fornecendo informaes sobre processos, telas de
alarme, tendncias, etc.
Utilizando essa estrutura para o desenvolvimento de telas promove as seguintes vantagens:
Colocar telas de forma conjunta, de acordo com a utilidade na aplicao.
Configurar apenas uma vez links e dinmicas comuns para todas as telas.
Promover um formato padro para a aplicao.
Construir telas modulares e utiliz-las em outros projetos.
Trabalhando em um Ambiente Orientado pelo Objeto
Selecione o tab Graphics para acessar todas as telas, pginas da web, objetos de biblioteca e smbolos na
aplicao.

Tab Graphics
Screens: Contm todas as telas de exibio criadas para a aplicao atual.
Group Screen: Contm os grupos de telas completos (telas individuais combinadas em grupos
gerenciveis) criados para a aplicao atual.
Nota:
Group Screen no est disponvel para Windows CE.
IWS 20/06/2007

InduSoft Web Studio

Pgina 179

Web Pages: Contm todas as pginas da web (telas salvas em formato HTML) criadas para a
aplicao.
Library: Contm a biblioteca de smbolos e grficos fornecidos pelo InduSoft Web Studio. Clique
duas vezes no boto Library para abrir a utilidade IWS Symbol Library, que consiste de um
painel de lista (contendo todos os grupos de smbolos) e uma tela de exibio.
Symbols: Contm todos os smbolos pr-definidos pelo usurio, que podem ser grupos de
imagens e/ou texto. Pode-se criar smbolos personalizados para a aplicao e salv-los nessa
pasta.
Trabalhando com Atributos de Tela
A pasta Screens contm telas com compilaes grficas finalizadas e rascunhos do projeto. Para visualizar
uma tela, amplie a pasta Screens e as telas aparecero na janela a direita no Workspace. Clique duas vezes
na tela para abri-la.
Para criar uma nova tela, abra o dilogo Screen Attributes utilizando um dos seguintes mtodos:
E Clique no boto New ( ) na barra de ferramentas Standard. Quando o dilogo New Document
abrir, clique em Display, e depois clique em OK.
E Clique com o boto direito na pasta Screens, selecione Insert, e clique no pop-up:

Criando uma Nova Tela
E Selecione File New da barra de menu. Quando o dilogo New Document abrir, clique em
Display, e depois em OK.
IWS 20/06/2007

InduSoft Web Studio

Pgina 180
E Selecione Insert Screen da barra de menu. Quando o dilogo New Document abrir, clique em
Display, e depois em OK.

Dilogo Screen Attributes
Para exibir o dilogo Screen Attributes para uma tela de sada, selecione View Screen Attributes da barra
de menu.
Utilize os parmetros no dilogo Screen Attributes como se segue:
text box Description: Digite uma descrio do atributo da tela para fins de documentao. O
texto inserido nesse campo ser exibido na barra de status (por padro) localizado na parte
inferior e esquerda da tela quando voc est em modo Run Aplication.
rea Background Picture: Especifique os seguintes parmetros para background.
check-box Enable background: Clique para habilitar ou desabilitar (padro) o uso de bitmaps
de background.
combo-box Enable Background: Clique para selecionar uma das seguintes opes de
background do Windows NT/2000/XP:
BMP
TIF
DXF
EPS
WMF
IMG
JPG
WPG
PCD
PNG
FMF
FPX
FAX
TGA

Nota:
O Windows CE suporta somente .BMPs.

IWS 20/06/2007

InduSoft Web Studio

Pgina 181
check-box Shared Image: Clique (habilite) para salvar um arquivo .BMP em formato
comprimido. Ativado somente quando o check-box Enable Background tenha sido selecionado.
C Ateno:
No possvel ler o arquivo .BMP salvo em formato comprimido caso voc
modifique ou instale os valores de configurao do Windows em um ambiente
com a utilizao de diferentes nmeros de cores. Recomendamos que as telas
sejam salvas em formato no comprimido, caso voc deseje alternar entre
diferentes configuraes. Em Windows CE, os bitmaps devem ser cor-16.

rea Size: Digite um nmero inteiro nos boxes Width e/ou Height para especificar o tamanho
(em pixels) da janela selecionada.
rea Location: Digite um nmero inteiro nos campos Top e/ou Left para especificar a
localizao da janela (em pixels) em relao a tela atual.
C Ateno:
Caso voc utilize o mouse (apontador) para redimensionar um janela diretamente
(estilo Thin ou Resizing) e depois Selecionar View Screen Attributes da barra de
menu, o IWS solicitar a atualizao do tamanho e localizao da tela atual.

Campo Security: Especifique o mesmo nvel de segurana para a janela (padro zero) definido
para acesso do usurio, utilizando o tab Security no tab Database.
check-box Hide: Clique para manter a tela gravada na memria aps solicit-la pela primeira
vez, facilitando o carregamento mais rpido ao abrir a tela. O IWS executar Screen Logics
normalmente.
Habilitar esse recurso (padro como desabilitado) causa uma utilizao elevada de pesquisas GDI,
conseqentemente, recomendamos que, durante o desenvolvimento, voc mantenha o monitoramento
dessas pesquisas utilizando a funo InfoResources.
rea Runtime Properties: Especifique os seguintes parmetros para definir as propriedades da
janela ao rodar a aplicao.
Titlebar: Clique nesse box para habilitar/desabilitar uma Titlebar para a nova tela. Mesmo se
voc no verificar esse check-box, voc poder configurar texto para a Titlebar; porm, a Barra
de Ttulo ser exibida somente se essa opo estiver habilitada.
D Dicas:
Pode-se modificar o texto da Titlebar dinamicamente durante o runtime,
configurando tags entre colchetes. O valor do(s) tag(s) est concatenado com
o texto da Titlebar.
Configurar texto dinmicas na Titlebar til mesmo quando esse no est
visvel nas telas. Quando o comando Print disparado dos objetos Grid ou
Alarm/Event Control, o texto da Titlebar da tela onde o objeto configurado
ser imprimido no cabealho dessas telas.
check-box System Menu: Clique para habilitar o menu do sistema.
check-box Maximize Box: Clique (habilite) para ativar o boto Maximize.
check-box Minimize Box: Clique para ativar o boto Minimize.
Style: Clique para selecionar um estilo para a janela (padro Replace).
Overlapped abre uma janela sem fechar qualquer outra janela.
Popup abre uma janela que permanecer frente das outras janelas, deixando as outras
tambm habilitadas.
IWS 20/06/2007

InduSoft Web Studio

Pgina 182
Dialog abre uma janela que permanecer frente das outras janelas, embora desabilite as
outras janelas at que voc feche aquela janela aberta.
Replace abre uma janela e fecha quaisquer outras janelas Replace e Popup style.
Border: Clique para selecionar um estilo para as bordas:
None: Sem bordas. No permite redimensionamento ou barra de ttulos.
Thin: Janela de bordas finas que no poder ser redimensionada durante runtime.
Resizing (padro): Borda Normal que pode ser redimensionada durante o runtime.
text box Dont Redraw: Digite um tag ou valor para controlar como os dinmicas de tela sero
atualizados. Especificar um valor maior que zero desabilita todos os dinmicas da tela.
rea Screen Logics: Clique (habilite) os boxes para executar Funes matemticas em um ou
mais desses eventos: On Open, While Open, On Close.
Aps habilitar um evento, clique no boto correspondente para abrir um dilogo onde voc poder
inserir as informaes a seguir:
Tag Name: Digite o nome de um tag para receber um valor de retorno a partir da coluna
Expression.
Expression: Digite uma expresso matemtica ou funo a ser executada. O valor de retorno
aplicado ao campo Tag Name.
Trigger (somente dilogo While Open). Digite um tag para que funcione como um disparador
(qualquer alterao de valor) para execuo dessa planilha. Caso voc deixe esse campo em
branco, o IWS executar a planilha no tempo mnimo que seu sistema capaz de suportar.
rea Focus: Utilize as opes a seguir para configurar o comportamento do foco ao utilizar um
grupo de telas (mais de uma tela aberta simultaneamente):
Receive focus on open: Habilite essa opo para trazer o foco ao primeiro objeto sensvel a foco,
quando esse estiver aberto.
Share tab order with other screens: Habilite essa opo para alternar o foco de objetos dessa
tela para objetos configurados em outras telas. Tal tarefa ocorrer aps apertar a tecla Tab
enquanto o ltimo objeto sensvel a foco estiver em foco na tela.
Tab Order: Digite um nmero (0 - 32767) para configurar a ordem do tab. Quando existem
mais de uma tela abertas, e voc deseja apertar a tecla Tab (durante o runtime), o foco alterna
entre entre as telas com o menor nmero Tab Order, para as telas com o maior nmero Tab
Order, e volta para a tela o o nmero mais baixo Tab Order (e assim por diante).
D Dica:
Para configurar a ordem em que as telas do grupo sero abertas quando
determinado grupo de telas solicitado, clique com o boto direito no nome do
grupo da tela no tab Graphics do workspace.
IWS 20/06/2007

InduSoft Web Studio

Pgina 183
Clique no boto Save ( ) na barra de ferramentas Standard ou selecione File Save (ou
File Save As) da barra de menu para salvar a nova tela. Quando o dilogo 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 184
Especificando Cores de Background
Para alterar a cor de background da tela, clique no boto Background Color ( ), localizado na barra de
ferramentas Tools toolbar e clique com o boto direito na tela em branco. Escolha Background Color do
menu pop-up.
Quando o dilogo Color aparecer, clique em uma cor, e depois clique em OK.

Dilogo Color
D Dica:
Clique duas vezes em uma cor para selecionar a cor desejada, e o dilogo Color ser
fechado automaticamente.

Nota:
Dependendo da paleta configurada para seu sistema, as cores dos objetos grficos
importadas para o ambiente podero ter distores da cor. Caso isso acontea, altare a
paleta configurada para seu sistema.

IWS 20/06/2007

InduSoft Web Studio

Pgina 185
Utilizando Objetos e Dinmicas
O InduSoft Web Studio fornece objetos e dinmicas com recursos completos (habilidade para modificar
propriedades do objeto, executar comandos ou inserir valores para tags utilizadas na construo de telas
flutuantes em runtime).
Utilizando a Barra de Ferramentas Mode
A barra de ferramentas Mode fornece botes para edio geral da tela.

Barra de Ferramentas Mode
A barra de ferramentas Mode posuui os seguintes botes
Boto Selection ( ): Clique para exibir um cursor o qual permite selecionar ou mover objetos
na tela.
Boto Bitmap Editor ( ): Clique para alternar entre duas camadas de edio bsicas:
Camada Objects: A camada na qual voc cria os objetos dinmicas para seu sistema.
Camada Background Picture: A camada de background esttica da mesma tela.
Quando a camada Background Picture est ativa a barra de ferramentas Bitmap ser exibida
automaticamente.
Nota:
Voc pode desabilitar automaticamente o boto Bitmap Editor ao desabilitar o
check-box Enable Background (somente tipo .BMP) no dilogo Screen Attributes.

Boto Fill Color ( ): Clique para especificar uma cor de preenchimento padro para os
seguintes objetos:
Polgonos fechados
Elipses
Retngulos arredondados
Retngulos
D Dica:
Para economizar tempo no desenvolvimento, selecione vrios objetos (de qualquer
tipo especificado na lista anterior) e utilize Fill Color para especificar um
preenchimento padro.

Boto Fonts ( ): Clique para especificar a fonte e cor para objetos de texto selecionados para
novos objetos de texto.
D Dica:
Para economizar tempo no desenvolvimento, selecione vrios objetos de texto e
utilize o boto Fonts para especificar configuraes de fonte e cor para todos os
objetos de uma vez s. (No possvel utilizar essa funo para objetos de texto
agrupados.)

IWS 20/06/2007

InduSoft Web Studio

Pgina 186
Boto Line Color ( ): Clique para especificar um cor para linha para objetos selecionados ou
para configurar uma cor padro para novos objetos, incluindo os que se seguem:
Plgonos abertos
Polgonos fechados
Linhas
Elipses
Retngulo arredondado
Retngulos
Ao clicar no boto Line Color, o dilogo Line Selection aparecer. Utilize esse dilogo para especifcar os
estilos de linha e cor para objetos selecionados:

Dilogo Line Selection
D Dica:
Para economizar tempo no desenvolvimento, pode-se selecionar vrios dos objetos
anteriores e utilizar o boto Line Color para especificar uma cor para a linha para
todos os objetos.

Boto Background Color ( ): Clique para especificar uma cor de background para a tela.
Nota:
Esse boto desabilita-se automaticamente quando voc habilitar o check-box
Enable Background no dilogo Screen Attributes.

Boto Grid ( ): Clique para especificaes sobre exibir ou ocultar a grade no editor de tela.
D Dica:
Pode-se utilizar o dilogo Grid para configurar as configuras padro para um grid.
Para abrir esse dilogo, clique com o boto direito na tela e selecione Grid Settings
quando aparecer o menu pop-up.

IWS 20/06/2007

InduSoft Web Studio

Pgina 187
Utilizando a Barra de Ferramentas Align e Distribute
A barra de ferramentas Align and Distribute fornece botes que permitem a edio de objetos na
tela.

Barra de Ferramentas Align and Distribute
Utilize as seguintes opes da barra de ferramentas para redimensionamento:
Boto Resize height ( ): Clique para configurar a altura de todos os objetos selecionado, que
seja igual a altura do objeto selecionado (o objeto com os handles preenchidos). Pode-se utilizar
Resize height para redimensionar um objeto configurando sua altura para um tamanho igual a
sua largura.
Boto Resize width ( ): Clique para configurar a largura de todos os objetos selecionados
para largura do ltimo objeto selecionado (o objeto com handles preenchidos). Pode-se utilizar
Resize width para redimensionar um objeto selecionado configurando sua largura para uma
tamanho igual a sua altura.
D Dica:
Pode-se utilizar Resize width e Resize height para criar crculos a partir de uma elipse
ou quadrados a partir de retngulos. Selecione somente um objeto antes de utilizar
essas ferramentas.

Pode-se tambm utilizar o cursor, mouse e setas do teclado para redimensionar objetos em sua
tela. Ao selecionar um objeto (ou grupos de objetos) com o cursor, Selection handles (quadrados em
preto) aparecem em cada canto e no ponto medial de cada lado. Pode-se utilizar esses handles como
se segue:
Para ampliar um objeto, clique em um handle e arraste seu cursor (ou apontador) na direo
indicada pelas setas que aparecero. Clicando e arrastando um lado redimensiona o objeto
inteiro (altura e largura), enquanto clicar em um lado redimensiona o objeto somente em uma
direo (somente altura ou somente largura).
Para ampliar um objeto com controle de redimensionamento, clique em um handle e no solte o
boto esquerdo do mouse. Clique nas setas do teclado para redimensionar o objeto (na direo
indicada pelas setas de redimensionamento) um pixel por vez. Solte o boto do mouse quando o
redimensionamento do objeto desejado estiver concludo.
Para selecionar e redimensionar um polgono aberto ou fechado, desenhe uma caixa de seleo
ao redor do polgono e agrupe-o (como descrito em Botes Object Grouping e Ungrouping
pgina 192). Depois, clique em um handle e arraste-o para redimensionar o objeto.
Para alterar a forma de um polgono aberto ou fechado, clique em um handle e uma caixa
quadrada aparecer na base de seu cursor. Arraste o handle para mover sua posio e alterar a
forma do polgono.

Notas:
Todos os objetos com propriedades dinmicas e objetos Group of Symbols
(incluindo a maioria dos objetos de smbolo e biblioteca) possuem mltiplos
dilogos Object Properties e propriedades. Utilize uma lista drop-down no dilogo
Object Properties (View Object Properties) para acessar esses dilogos e
propriedades.
IWS 20/06/2007

InduSoft Web Studio

Pgina 188
Caso voc queira redimensionar um smbolo ou grupos de objetos, o IWS
redimensiona todos os objetos em concordncia com o smbolo ou grupo.

botes Object Alignment
Ao selecionar uma srie de objetos (dois ou mais), pode-se alinhar tais objetos baseados na
localizao do ltimo objeto selecionado. Ao selecionar objetos, handles slidas aparecem no ltimo
objeto selecionado, e os handles em todos os objetos previamente selecionados tornam-se vazios
(no preenchidos).
Nota:
De todas as figuras fornecidas, o retngulo representa o ltimo objeto selecionado.

Utilize os botes de alinhamento que se seguem para alinhas uma srie de objetos.
Boto Align left ( ): Clique para alinhar todos os objetos selecionados para o limite esquerdo
do ltimo objeto selecionado. Por exemplo :

Alinhando objetos esquerda
Boto Align right ( ): Clique para alinhar todos os objetos selecionados para o limite direito
do ltimo objeto selecionado. Por exemplo:

Alinhando objetos direita
Boto Align top ( ): Clique para alinhar todos os objetos selecionados para o limite superior
do ltimo objeto selecionado. Por exemplo:
IWS 20/06/2007

InduSoft Web Studio

Pgina 189

Alinhando objetos na parte superior
Boto Align bottom ( ): Clique para alinhar todos os objetos selecionados para o limite
inferior ao ltimo objeto selecionado. Por exemplo:

Alinhando objetos na parte inferior
Boto Center vertically ( ): Clique para alinhar todos os objetos selecionados ao centro e
verticalmente do ltimo objeto selecionado. Por exemplo:

Centrando objetos verticalmente
Boto Center horizontally ( ): Clique para alinhar todos os objetos selecionados ao centro e
horizontalmente ao ltimo objeto selecionado. Por exemplo:

Centrando objetos horizontalmente
IWS 20/06/2007

InduSoft Web Studio

Pgina 190
Boto Evenly space horizontally ( ): Clique para colocar uma quantidade igual de espaos
horizontais entre uma srie de objetos (dois ou mais). Por exemplo:

Espaando objetos horizontalmente
Boto Evenly space vertically ( ): Clique para colocar um quantidade igual de espaos
verticais entre uma srie de objetos (dois ou mais). Por exemplo:

Espaando objetos verticalmente
Nota:
As funes de espaamento podem mover o ltimo objeto selecionado (com handles
slidos) por no mais que poucos pixels para espaamento igual para todos os objetos.

Utilize os botes a seguir para alterar a orientao de um nico objeto selecionado ou um grupo de
objetos. No possvel utilizar essas botes com mltiplos objetos selecionados.)
Boto Flip horizontally ( ): Clique para inverter o objeto selecionado horizontalmente. O
objeto rota-se em torno de uma linha imaginria atravs de seu centro horizontal at ser uma
imagem espelho do objeto original. Por exemplo:

Roteando objetos horizontalmente
IWS 20/06/2007

InduSoft Web Studio

Pgina 191
Boto Flip Vertically ( ): Clique para inverter o objeto selecionado verticalmente. O objeto
rota-se em torno de uma linha imaginria atravs de seu centro vertical at ser uma imagem
espelho do objeto original. Por exemplo:

Roteando objetos verticalmente
Boto Rotate ( ): Clique para rotear o objeto selecionado a 90 graus. Por exemplo:

Roteando objetos
botes Changing Object Layers
Utilize os seguintes botes de camada do objeto para mover objetos(s) selecionados para trs ou
para a frente de um outro objeto(s) da tela.
Notas:
IWS assinala um nmero nico de identificao (ID#) para cada objeto na tela. Esses
ID#s sempre iniciam-se em zero e alcanam o total de nmeros 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 atrs de
outro objeto na tela. Objetos com ID#s mais baixos exibem-se atrs de objetos com
ID#s mais altos.
Caso voc selecionar um grupo de objetos e mov-los para trs ou para frente de um
outro objeto, o grupo selecionado de objetos mantm sua ordem de exibio original.

IWS 20/06/2007

InduSoft Web Studio

Pgina 192
Boto Move to back ( ): Clique para mover um objeto ou objetos selecionados para trs de
todos os objetos na tela. O IWS assinala o objeto de menor ID# e move esse objeto para trs de
todos os outros objetos na tela. Por exemplo:

Movendo objetos para trs (Selecionando o Retngulo Azul)
Nota:
De forma alternativa, clique com o boto direito em um objeto e selecione Move to
back do menu pop-up do objeto.

Boto 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 trs
de todos os objetos na tela. Por exemplo:

Movendo objetos para a frente (Selecionando o Crculo Vermelho)
Nota:
De forma alternativa, clique com o boto direito em um objeto e selecione Move to
front do menu pop-up do objeto.

Botes Object Grouping e Ungrouping
Utilize os botes que se seguem para agrupar e deseagrupar dois ou mais objetos selecionados.
Nota:
Todos os objetos com propriedades dinmicas e objetos Group of Symbols (incluindo a
maioria dos objetos de smbolos e bibliotecas) possuem mltiplos dilogos e
propriedades Object Properties. Pode-se utilizar a lista drop-down no dilogo Object
Properties (View Object Properties) para acessar esses diferentes dilogos e
propriedades.

Boto Group ( ): Clique para combinar mltiplos objetos em um nico objeto, facilitando a
seleo e manipulao do objeto. (Pode-se acessar cada parte do grupo no dilogo Object
Properties.)
IWS 20/06/2007

InduSoft Web Studio

Pgina 193
Nota:
De forma alternativa, clique com o boto direito em um objeto e selecione Group do
menu pop-up do objeto.

Boto Ungroup ( ): Clique para separar um objeto agrupado em seus componentes
individuais.
Notas:
De forma alternativa, clique com o boto direito em um objeto e selecione Ungroup
do menu pop-up do objeto.
Um grupo complexo de objetos pode consistir de vrios conjuntos de objetos
agrupados (conhecidos como subgrupos). Conseqentemente, pode haver a
necessidade de deseagrupar todos os subgrupos para desagrupar completamente
um objeto complexo.
Utilizando Grupos de Telas
O IWS fornece um recurso para agrupar telas (screen-grouping) que permite a abertura de um link de telas
ao mesmo tempo.
Da barra de menu, selecione Insert Screen Group para abrir o dilogo Insert Screen Group, onde pode-se
criar um novo grupo de telas para sua aplicao.

Dilogo 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 tambm criar um novo grupo de telas a partir do tab Graphics no Workspace.
Clique com o boto direito na pasta Group Screen e depois selecione Insert screen
group a partir do menu pop-up. A pasta Group Screen combina telas de exibio
individuais da pasta Screens para grupos mais gerenciveis.
Selecione File Save Screen Group As HTML para salvar Screen Group em formato
HTML, tornando-os disponveis para Web Thin Client remotos atravs 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 boto direito no nome do grupo da tela (a partir do tab Graphics do Workspace).
Clique em Set Open Order no menu pop-up.
IWS 20/06/2007

InduSoft Web Studio

Pgina 194

Dilogo Set Open Order
Utilizando a Barra de Ferramentas da Web
A barra de ferramentas da Web fornece botes que permitem abrir e navegar em arquivos HTML.

Barra de ferramentas da Web
Nota:
Deve-se instalar o Internet Explorer v4.1 (ou verses mais atuais) antes de utilizar
qualquer das ferramentas na barra de ferramentas da Web.

Boto Back ( ): Clique para retornar ao ltimo endereo URL aberto no ambiente de
desenvolvimento.
Boto Forward ( ): Clique para retornar a um endereo URL aberto anteriormente, clicando
no boto Back do ambiente de desenvolvimento.
Boto Stop ( ): Clique para cancelar o processo de download de arquivos a partir de um
endereo URL especfico.
Boto Refresh ( ): Clique para recarregar um endereo URL especificado no text box Address.
Boto Home ( ): Clique para abrir a Home Page configurada em seu browser da web Internet
Explorer.
text box Address ( ): Digite um endereo URL da pgina da Web dentro
do text box para abrir (fazer download) daquela pgina para seu browser da Web Internet
Explorer.
Boto Go ( ): Clique para fazer downloads de pginas especificadas no text box Address.
Salvando Telas em Formato HTML
O IWS tambm habilita o salvamento de telas em formato HTML. No possvel criar pginas HTML
contidas na pasta Web Pages; elas so geradas a partir de telas pr-existentes. Para mais informaes
sobre como configurar e rodar uma aplicao Web Thin Client, veja Captulo 13: Configurando uma Web
Solution.
IWS 20/06/2007

InduSoft Web Studio

Pgina 195
Para criar uma pgina HTML, deve-se primeiramente criar uma tela de exibio. Configure uma tela
normalmente (crie objetos, adicione propriedades, etc), mantendo em mente que essa tela ser uma pgina
da Web. Ao terminar, salve a tela normalmente. Depois, com a tela ainda aberta, selecione File Save As
HTML.
C Ateno:
As pginas da web que so geradas ao selecionar File Save As HTML so
independentes do arquivo de tela a partir do qual foram gerados. Conseqentemente,
caso voc altere aquela tela de exibio, tais alteraes no aparecero na pgina da
Web at que voc selecione File Save As HTML novamente.
Selecione File Save Screen Group As HTML para salvar Screen Group em formato HTML, tornando-os
disponveis para Web Thin Clients remotos atravs de um Browser da Web.
Para visualizar pginas da Web, deve-se primeiramente configurar os parmetros da Web no dilogo Project
Settings (tab Web).

Dilogo Project Settings: Tab Web
E Abra o dilogo e digite o endereo IP (a partir do qual a aplicao ser rodada) no campo Data
Server IP Address.
E Digite um valor no campo Send Period para especificar o perodo de envio (em milissegundos)
utilizados para trocar dados entre o Server e Web Thin Client stations.
IWS 20/06/2007

InduSoft Web Studio

Pgina 196
E Clique (habilite) os seguintes check-boxes caso seja aplicvel:
check-box Disable Remote Client Commands: Clique (habilite) esse box para previnir que um cliente remoto
tenha a permisso 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
aplicao 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 parmetro caso voc esteja rodando em um Web Thin Client remotamente, e voc deseja que o
IWS escale telas automaticamente quando redimensionar a janela do Browser.
check-box Enable File Compression: Clique (habilite) esse box para comprimir os arquivos armazenados na
pasta \Web da Aplicao. Essa opo til para reduzir tempo de download, particularmente se voc
possui uma conexo lenta entre seu Server e o Web Thin Client.
E Clique no boto IP Security para abrir o dilogo IP Security. Utilize os parmetros nesse dilogo
para especificar a escala de endereos IP para os computadores que so permitidos a ter acesso
a Aplicao como Web Thin Clients.

Dilogo IP Security
Quando os parmetros do painel Edit tornarem-se ativos, digite os endereos IP nos campos From e To para
especificar a escala de endereo IP. Utilize os botes Add e Remove para mover os endereos IP para a lista
IP Address Range. O IWS permitir aos computadores listados nesse painel o acesso as aplicaes como
Web Thin Clients.
E 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 gerao de um arquivo de log
na Web Thin Client station. Pode-se utilizar esse arquivo de log para correo de erros.
E Para habilitar o Virtual Keyboard para Web Thin Client stations, independentemente da estao
local, clique no check-box Virtual Keyboard. Quando esse box est habilitado, os campos
abaixo tornam-se ativos.
Default: Selecione o teclado padro utilizado na aplicao.
Scale: Com essa opo, pode-se ampliar ou diminuir os teclados para que adaptem-se de
forma apropriada com o tamanho da tela do painel alvo. Escala: 100% representa o
tamanho padro de cada Virtual Keyboard. As opes vo de 25% a 400%, embora voc
possa inserir um nmero personalizado.
- Show Hint: Especifique aqui o ttulo do Virtual Keybord a ser mostrado no dialogo.
- Show Min/Max fields: Habilite esse check-box para a visualizao dos valores mximos e
IWS 20/06/2007

InduSoft Web Studio

Pgina 197

E Clique em OK para fechar o dilogo Project Settings.
Notas:
Caso voc altere quaisquer informaes da Web no dilogo Project Settings, deve-se
verificar novamente a Aplicao para que a nova configurao surta efeito. Para
verificar a Aplicao, Selecione Tools Verify da barra de menu. (Caso voc tenha
janelas abertas no sistema de desenvolvimento, o IWS solicitar o fechamento dessas
antes de verificar a Aplicao).
As pginas da Web exibem informaes a partir da Aplicao atravs do Web server.
Assim, voc dever estar rodando o sistema em runtime Web server TCP/IP server a fim
de visualizar suas pginas 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 disponvel somente quando a camada Background Picture estiver ativa. Pode-
se habilitar a camada Background Picture no dilogo Screen Attributes.)

Barra de ferramentas Bitmap
A barra de ferramentas Bitmap contm os seguintes botes:
Boto Selecione rea ( ): Clique para selecionar uma rea com o Bitmap Screen Editor.
Boto Flood Fill ( ): Clique no boto Flood Fill e depois clique na tela para pintar a rea
adjacente com a cor especificada com o boto Fill Color.
Boto Pixel Editing ( ): Clique para abrir um dilogo Edit Image, onde voc poder desenhar
bitmaps detalhados, pixel por pixel.

Dilogo Edit Image
IWS 20/06/2007

InduSoft Web Studio

Pgina 198
Boto Erase rea ( ): Clique para remover uma rea selecionada da tela.
Boto Change colors ( ): Clique para alterar o preenchimento transparente para uma rea
selecionada.
Nota:
Antes de poder utilizar esse boto, voc dever j ter especificado uma cor para
preenchimento (Boto Fill Color), selecionado uma cor de transparncia (Boto
Selection Transparent Color), e definido a rea a ser preenchida (Boto Selection
rea).

Boto Selection Transparent Color ( ): Clique para especificar uma cor transparente
(referido pelo boto Change Colors).
Boto Toggle Transparent Color ( ): Clique para aplicar a cor selecionada, utilizando o boto
Select Transparent Color para tornar transparente os bitmaps selecionados em Bitmap Screen
Editor.
D Dica:
Pode-se utilizar os comandos Copy (Ctrl+C) e Paste (Ctrl+V) para trocar figuras de
bitmap entre Bitmap Screen Editor do IWS e quaisquer outros editores de bitmap
(Paint Brush, por exemplo).

Utilizando a barra de ferramentas Static Objects
A barra de ferramentas Static Objects fornece botes a serem utilizados para criar polgonos,
retngulos, linhas e outros objetos para sua tela.

Barra de Ferramentas Static Objects
A barra de ferramentas Static Objects contm os seguintes botes:
Boto Open Polygon ( ): Clique para desenhar um polgono aberto com uma borda na cor
especificada para primeiro plano.
Para desenhar um polgono aberto na rea de desenho:
Clique com o boto esquerdo do mouse para configurar o ponto de incio do polgono.
Mova o cursor para o novo local e clique novamente para adicionar seu Segundo vrtice.
Repita esse processo at que voc tenha criado a forma do polgono desejado.
Clique duas vezes para finalizar o desenho do polgono.
Para visualizar as propriedades do objeto, clique duas vezes no objeto pogono e o dilogo Object Properties
ser exibido:
IWS 20/06/2007

InduSoft Web Studio

Pgina 199

Dilogo Object Properties: Open Polygon
Utilize o dilogo Object Properties para especificar os seguintes parmetros para o polgono:
Line: Especifica um estilo de linha fronteiria, clicando-se nos botes No Line, Solid Line, ou
Dashed Line.
Color: Especifica uma cor para linha fronteiria, clicando-se no boto Color. Quando o dilogo
Color abrir, clique em uma cor para selecion-la, e a seguir feche o dilogo.
Weight: Especifica a largura da linha fronteiria (em pixels) digitando um nmero
representando a largura da linha dentro de um text box.
Boto Closed Polygon ( ): Clique para desenhar um polgono fechado, utilizando uma borda
na cor especificada para primeiro plano.
Para desenhar um polgono fechado na rea de desenho:
Clique com o boto esquerdo do mouse para configurar o ponto de incio do polgono.
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 polgono desejado.
Clique duas vezes para finalizar o desenho do polgono.
Para visualizar as propriedades do objeto, clique duas vezes no objeto polgono. O dilogo Object Properties
ser exibido:

Dilogo Object Properties: Closed Polygon
Utilize o dilogo Object Properties para especificar os seguintes parmetros para o polgono:
Line: Especifica o estilo de linha para as bordas, clicando-se nos botes No Line, Solid Line, ou
Dashed Line.
Color: Especifica a cor para linha das bordas, clicando-se no boto Color. Quando o dilogo
Color abrir, clique em uma cor para selecion-la e depois feche o dilogo.
Weight: Especifica a largura da borda (em pixels) digitando um nmero representando a largura
da linha dentro do text box.
Fill: Para especificar se o polgono dever ser preenchido, clique em No Fill ou Fill.
Caso voc habilite a opo Fill, pode-se especificar uma cor de preenchimento clicando no
boto Color. Quando o dilogo Color aparecer, clique em uma cor para selecion-la e depois
feche o dilogo.
Boto Line ( ): Clique para desenhar uma linha ortoginal na rea de desenho, como se segue:
IWS 20/06/2007

InduSoft Web Studio

Pgina 200
Clique com o boto esquerdo do mouse para configurar o ponto de incio 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 dilogo Object Properties
aparecer:

Object Properties: Line
Utilize o dilogo Object Properties para especificar os seguintes parmetros para a linha
ortogonal:
Line: Especifica o estilo da linha, clicando-se nos botes No Line, Solid Line, ou Dashed Line.
Color: Especifica uma cor para a linha, clicando se no boto Color. Quando o dilogo Color
abrir, clique em uma cor para selecion-la e depois feche o dilogo.
Weight: Especifica a largura da linha (em pixels) digitando um nmero representando a largura
da linha dentro do text box.
Boto Ellipse ( ): Clique para desenhar elipses, acordes, arcos e anis. Por exemplo:

Oval, Acorde, Arco, e Anel
D 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 boto do mouse para finalizar o desenho.
Utilize o dilogo Object Properties para alterar a forma para um acorde, arco, anel, etc.
Clique duas vezes no objeto para visualizar o dilogo Object Properties:

Object Properties: Ellipse
IWS 20/06/2007

InduSoft Web Studio

Pgina 201
Utilize o dilogo Object Properties para especificar os seguintes parmetros para a elipse:
Style: Especifica o estilo do objeto, selecionado Ellipse, Arc, Chord, ou Ring da lista drop-down.
A seguir, selecione Left-Bottom, Left-Top, Right-Bottom, ou Right-Top da lista Style para
escolher o quadrante no qual a elipse ser desenhada.
Por exemplo, para representar uma metade de um cano, crie dois objetos Ring. Especifique um
como Left-Bottom e o outro como Right-Bottom e depois una os dois objetos, criando assim um
cano pela metade.
Fill: Para especificar se a elipse ser preenchida, clique em No Fill ou Fill.
Caso voc teha selecionado a opo Fill, especifique uma cor para preenchimento, clicando
no retngulo Color. Quando o dilogo Color aparecer, clique em uma cor para selecion-la e
depois feche o dilogo.
Line: Especifica um estilo de linha para as bordas da elipse, clicando-se nos botes No Line,
Solid Line, ou Dashed Line.
Color: Especifica a cor das bordas da elipse, clicando-se no boto Color para abrir o dilogo
Color. Clique na cor e selecione-a, e depois feche o dilogo.
Weight: Especifica a largura para a linha da borda de uma elipse, digitando um nmero
representando a largura da linha (em pixels) dentro do text box fornecido.
Boto Rounded Rectangle ( ): Clique para desenhar retngulos arredonados (vazios ou
preenchidos), como se segue:
Clique na rea de desenho e arraste o mouse/cursor para criar o retngulo.
Solte o boto do mouse para finalizar o desenho do objeto.

Object Properties: Rounded Rectangle
Notas:
No possvel utilizar o boto retngulos arredondados para criar um bar graph
para aplicaes em Windows CE.
Um retngulo arredondado possui uma marca extra no canto inferior esquerdo, o
que permite a modificao do ngulo do arco.
Utilize o dilogo Object Properties para especificar os seguintes parmetros para a linha ortogonal:
Line: Especifica um estilo de borda, clicando-se nos botes No Line, Solid Line, ou Dashed Line.
Color: Especifica um estilo de cor para bordas, clicando-se no boto Color para abrir o dilogo
Color. Clique na cor para selecion-la e depois feche o dilogo.
Weight: Especifica a largura de uma borda digitando um nmero representando a largura da
linha (em pixels) dentro do text box fornecido.
Fill: Especifica se o retngulo ser preenchido, clicando-se em No Fill ou Fill.
Caso voc selecionar a opo Fill, especifique uma cor de preenchimento, clicando-se no
boto Color. Quando o dilogo Color aparecer, clique em uma cor para selecion-la e depois
feche o dilogo.
IWS 20/06/2007

InduSoft Web Studio

Pgina 202
Color: Especifica uma cor de preenchimento, clicando-se no boto Color para abrir o dilogo
Color. Clique em uma cor para selecion-la e depois feche o dilogo.
Caption: Essa opo no est disponvel para esse objeto.
Boto Rectangle ( ): Clique para criar retngulos, como se segue:
Clique na rea de desenho e arraste o mouse/cursor para desenhar o retngulo.
Solte o boto do mouse quando o retngulo estiver no tamanho desejado.

Object Properties: Rectangle
Utilize o dilogo Object Properties para especificar os seguintes parmetros 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 boto Color para abrir o dilogo
Color. Clique na cor para selecion-la e depois feche o dilogo.
Weight: Especifica a largura de uma linha de borda, digitando um nmero representando a
largura da linha (em pixels) dentro do text box fornecido.
Fill: Especifica se o retngulo deve ser preenchido, clicando-se em No Fill ou Fill.
Caso voc tenha selecionado a opo Fill, especifique uma cor de preenchimento, clicando-se no
retngulo Color. Quando o dilogo Color aparecer, clique em uma cor para selecion-la e depois
feche o dilogo.
Color: Especifica uma cor de preenchimento, clicando-se no boto Color para abrir o dilogo
Color. Clique em uma cor para selecion-la e depois feche o dilogo.
Caption: Aperte esse boto para abrir o dilogo Caption onde voc poder editar o texto a ser
escrito dentro do objeto retngulo.

Selecionando o boto Caption
* Caption: Digite o texto que voc deseja exibir dentro do objeto retngulo nesse text box.
* Extern translation (opcional): Especifica um arquivo de traduo externa para o caption
retngulo, clicando-se no box.
IWS 20/06/2007

InduSoft Web Studio

Pgina 203
* Fonts: Especifica um estilo de fonte para caption, clicando-se no boto Fonts.
* Align: Especifica o alinhamento para o caption do retngulo.
* Multiline: Permite que o texto do retngulo seja exibido em mais de uma linha, quando
habilitado.
* Wrap Text: Quando habilitado, o objeto envolve o texto quando necessrio.
* Auto gray out: Faz o caption do retngulo tornar-se cinza quando o clique aplicado ao
retngulo est desabilitado pelo campo Disable ou devido ao sistema de segurana.
Boto Button ( ): Clique para criar botes personalizados, como se segue:
Clique na rea de desenho e arraste o mouse/cursor para criar a forma do boto.
Solte o boto do mouse quando o boto est do tamanho desejado.

Object Properties: Button
Utilize o dilogo Object Properties para especificar os seguintes parmetros para o boto:
Caption: Especifica um caption, digitando o texto dentro do text box.
Fonts: Especifica um estilo de fonte para o caption, clicando-se no boto Fonts.
Quando o dilogo Fonts aparecer, especifique os seguintes parmetros:
* Font (typeface)
* Font style
* Size
* Effects
* Color
* Script style
Weight: Especifica a largura de uma linha de borda, digitando um nmero representando a
largura da linha (em pixels) dentro do text box.
Extern translation (opcional): Especifica um arquivo de traduo externa para a marca inferior,
clicando-se (habilitando) no box.
Multiline: Permite o caption do boto ser exibido em mais de uma linha, quando habilitado.
Wrap Text: Quando habilitado, o objeto envolve automaticamente o texto quando necessrio.
Auto gray out: Muda o caption do boto para cinza, quando a dinmica Command aplicada ao
boto est desabilitada pelo campo Disable ou devido ao sistema de segurana.
Boto 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.
Aps inserir uma string de texto, clique duas vezes no novo objeto de texto para visualizar o
dilogo Object Properties.
IWS 20/06/2007

InduSoft Web Studio

Pgina 204

Object Properties: Text
Utilize o dilogo Object Properties para especificar os seguintes parmetros 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 boto Fonts. Quando o dilogo
Fonts aparecer, pode-se especificar os seguintes parmetros:
* 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 retngulo Color. Quando o dilogo Color aparecer,
clique em uma cor para selecion-la e depois feche o dilogo.
Background: Especifica uma cor de fundo, clicando-se no boto Color. Quando o dilogo Color
aparecer, clique em uma cor para selecion-la e depois feche o dilogo.
Transparent: Especifica uma cor para bordas, clicando-se no boto Color. Quando o dilogo
Color aparecer, clique em uma cor para selecion-la e depois feche o dilogo.
Extern translation (opcional): Especifica um arquivo de traduo 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 dinmicas a objetos ou um grupo
de objetos. Dinmicas habilitam a modificao de propriedades do objeto durante execuo (em
runtime) em concordncia com valores de tags. Algumas dinmicas habilitam tambm a execuo
de comandos ou insero de valores (set points) para os tags.

Barra de Ferramentas Dynamic Properties
A barra de ferramentas Dynamic Properties contm os seguintes botes:
propriedade Command ( ): Clique para adicionar a dinmica Command para um objeto
selecionado ou grupos de objetos. A dinmica Command habilita voc a clicar no objeto ou
pressionar uma tecla pr-definida para executar o comando em runtime.
E Clique duas vezes no objeto para visualizar as propriedades do objeto.
IWS 20/06/2007

InduSoft Web Studio

Pgina 205

Object Properties: Command
A dinmica Command fornece um tag para cada um dos eventos por ele suportados. Note que mais de um
evento pode ser configurado simultaneamente para a mesma dinmica Command:
Evento Descrio
On Down
Executa command/script uma vez quando o usurio clica no objeto
com o boto esquerdo do mouse.
On While
Mantm execuo de command/script continuamente, enquanto o
mouse pressionado sob o objeto. O perodo (em milissegundos) de
execuo para command/script configurado no campo Rate da tela
de dilogo Configuration, exceto para a opo VBScript, que
executada o mais rpido possvel.
On Up
Executa command/script uma vez que o usurio libera o boto
esquerdo do mouse no objeto.
On Right Down
Executa command/script uma vez que o usurio clica no objeto com
o boto direito do mouse.
On Right Up
Executa command/script uma vez que o usurio libera o boto
direito do mouse no objeto.
On Double
Click
Executa command/script uma vez que o usurio clica duas vezes no
objeto com o boto esquerdo do mouse.

Notas:
O IWS trata as aes touch-screen do mesmo modo que trata as aes do mouse.
Em outras palavras, transparente para o IWS caso algum evento foi disparado
por uma interface touch-screen ou por um mouse regular.
Os eventos On Right Down, On Right Up e On Double Click no so suportados
por aplicaes do CEView (Rodando em sistema operacional Windows CE).
Ao criar uma aplicao para um equipamento touch-screen, importante que se
mantenha em mente que eventos On Right Down e On Right Up no podero ser
disparados em tais equipamentos.

IWS 20/06/2007

InduSoft Web Studio

Pgina 206
Key: Atalho utilizado para disparar eventos On Down, While Down e On Up com a utilizao de um
teclado. Essa opo especialmente til ao criar aplicaes para equipamentos em runtime que
no forneam um mouse ou interface touch-screen o teclado a nica interface fsica disponvel
para interagir com a aplicao durante o runtime.
Config: Inicia a tela de dilogo Configuration, onde a dinmica Command pode ser totalmente
configurada.
Esse dilogo permite a configurao dos parmetros Command, como se segue:

Dilogo Configuration
* Type: Esa configurao define o tipo de ao que dever ser executada pelo evento da
dinmica Command. Note que cada evento possui seu prprio tipo. Portanto, a mesma
dinmica Command pode ser configurado com diferentes tipos de ao para diferentes
eventos. Os seguintes tipos so suportados:

Tipo Descrio
Built-in
Language
Permite que voc configure um script utilizando a linguagem built-in do
IWS. Quando esse tipo selecionado, o usurio pode configurar at 12
expresses para cada evento no coluna Expression. Essas expresses so
executadas sequencialmente a partir da primeira linha at a ltima
quando o evento disparado. O resultado de cada expresso registrada
para o tag configurado na coluna Tag (caso haja). Consulte o Captulo
Linguagem Buil-in do IWS para maiores informaes.
VBScript
Permite que voc configure um script utilizando o padro de linguagem
VBScript. Quando esse tipo selecionado, o usurio pode configurar um
script no editor VBScript para a dinmica Command. Consulte o Captulo
VBScript para maiores informaes sobre a linguagem VBScript.
Open Screen
Permite que voc configure a dinmica Command para abrir uma tela
especfica quando o evento disparado durante o runtime. Esse tipo
equivalente a funo built-in Open() do IWS. Voc pode tambm digitar o
nome da tela no campo Open Screen ou naveg-lo. Mais do que isso, voc
IWS 20/06/2007

InduSoft Web Studio

Pgina 207
Tipo Descrio
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 dinmica Command para fechar uma tela
especfica quando o evento disparado durante o runtime. Esse tipo
equivalente a funo built-in Close() do IWS. Voc tambm pode digitar o
nome da tela no campo Close Screen ou naveg-la. Voc tambm pode
digitar um tag string entre colchetes {TagName} nesse campo. Quando o
evento executado, o IWS tentar fechar a tela nomeada.
Set Tag
Permite que voc configure a dinmica Command para configurar um tag
quando o evento disparado durante o runtime. Voc pode tambm 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 dinmica Command para reiniciar um tag
o nome do tag no campo Reset Tag ou naveg-lo. Quando o evento
executado, o IWS registrar o valor 0 para o tag configurado nesse campo.
Toggle Tag
Permite que voc configure a dinmica Command para inverter um tag
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 configuraes a seguir so compartilhadas para todos os eventos:
* Enable Focus: Quando essa opo est habilitada, o objeto que a dinmica Command ao
qual foi aplicada pode receber o foco durante o runtime, atravs de teclas de navegao.
* Force: Quando essa opo est habilitada, qualquer tag que receba um valor ir gerar
eventos baseados em suas alteraes, mesmo se o valor do tag em questo no se altere.
Por exemplo, caso um tag tenha o valor 0 e a dinmica Command reescreva o mesmo
valor 0 para esse tag 0, qualquer outra tarefa do IWS reconhecer que esse tag alterou
seu valor (mesmo que no tenha alterado) aps executar o dinmico. Essa opo til
quando voc deseja certificar-se de que aes dirigidas por alteraes de tag (e.x. Write
on Tag Change a partir de um driver de comunicao) so disparadas aps a dinmica
Command ser executada.
* Beep: Quando essa opo est habilitada, um som curto tocado quando Command
executado. Essa opo til para fornecer um feed-back audvel para o usurio,
indicando que Command foi executado, e no indica, entretanto, se a ao disparada
pela dinmica Command foi alcanada com sucesso ou no.
* Release: Quando essa opo est habilitada, o evento On Up executado quando voc
arrasta o cursor (ou seu prprio dedo) para fora da rea do objeto (caso o boto tenha
sido liberado ou no). Essa opo til para certificar-se de que o evento On Up ser
sempre executado aps um evento On Down, mesmo que o usurio leve o cursor do
mouse para fora da rea do objeto antes de liber-lo.
* Confirm: Quando essa opo est habilitada, o usurio ter que responder uma
pergunta de confirmao antes de executar o comando. Essa opo til para diminuir
disparos acidentais de eventos crticos durante o runtime.
* E-Sign: Quando essa opo est habilitada, o usurio ser requisitado a inserir a
Assinatura Eletrnica antes de executar o dinmico.
* Disable: Desabilita a ao pelo usurio quando o resultado da expresso configurada
nesse campo VERDADEIRA (TRUE) (valor diferente de 0).
IWS 20/06/2007

InduSoft Web Studio

Pgina 208
* Security: Nvel de Acesso ao Sistema de Segurana requisitado para o objeto/dinmico

Boto Hyperlink ( ): Clique para adicionar a propriedade de hyperlink para um objeto ou
grupo de objetos selecionados. Aplicar essa propriedade permite clicar no objeto (s) durante a
execuo para inicializar o browser padro e carregar a URL especificada.
Clique duas vezes no objeto para abrir o dilogo Object Properties:

Object Properties: Hyperlink
Pode-se utilizar esse dilogo para especificar os seguintes parmetros:
combo-box Hyperlink Type: Clique no boto 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 opo est habilitada, o usurio solicitado a inserir uma
Campo URL: Digite o endereo da URL que voc deseja carregar (Por exemplo: iwsdobrasil.com).
D Dica:
Voc no precisar inserir o tipo de protocolo no campo URL. Ao selecionar um
tipo de protocolo da lista Hyperlink Type, o IWS adiciona automaticamente o
prefixo do protocolo para o endereo da URL.

Disable: Digite um valor maior que zero nesse campo para desabilitar a propriedade de
comando hyperlink para o objeto(s) selecionado.
Campo Security: Digite um valor nesse campo para especificar um nvel de segurana para o
objeto (s). Caso um usurio efetuar logs on, e no possuir o nvel de segurana requisitado, o IWS
desabilitar o comando hyperlink para o objeto(s).
Boto Bargraph ( ): Clique para adicionar propriedades bar graph para um objeto
selecionado, e depois clique duas vezes no objeto para abrir o dilogo Object Properties.

Object Properties: BarGraph
IWS 20/06/2007

InduSoft Web Studio

Pgina 209
Nota:
No pode-se utilizar o boto retngulo arredondado para criar um bar graph para
aplicaes em Windows CE.
Utilize o dilogo Object Properties para especificar os seguintes parmetros:
Campo Tag/Expression: Digite um tag ou uma expresso que determine o nvel de bar graph.
Pode-se tambm clicar no boto para procurer entre seus diretrios um tag ou expresso existente.
Campo Minimum Value: Digite uma constante numrica ou valor de tag nesse campo para
definir o valor mnimo utilizado para calcular o tamanho das barras.
Campo Maximum Value: Digite uma constante numrica ou um valor de tag nesse campo para
definir o valor mximo utilizado para calcular o tamanho das barras.
D Dica:
O IWS tambm permite a insero de constantes em campos de valor
tag/numrico. Valores constantes (definidos pelo caractere #) so equivalentes a
valores numricos, embora constantes sejam exibidos no dilogo Tag Replace.
Deve-se encontrar constantes teis para fins de documentao ou para criao de
objetos genricos. Por exemplo: #Name:100.
Onde o valor (100) seguindo o caractere (:) a constante, e Name somente a
constante mneumnica e no adicionada ao banco de dados.

Foreground Color: Para especificar uma cor de preenchimento para barras, clique no boto do
combo-box. Quando o dilogo Color aparecer, clique em uma cor para selecion-la e depois feche o
dilogo.
painel Direction: Clique no radio button Vertical ou Horizontal para especificar a direo de bar
graph.
painel Orientation: Clique nos botes Up, Center, ou Down para especificar a orientao dos
valores mximos e mnimos ao desenhar as barras.
IWS 20/06/2007

InduSoft Web Studio

Pgina 210
Boto Text I/O ( ): Clique para adiccionar o dinmico de propiedade de texto input ou
output para um objeto de texto selecionado. Aplicar a propriedade Text I/O permite a insero
e exibio de valores de tags em tempo real, caso voc esteja utilizando o teclado ou keypad on-
screen para rodar uma aplicao.
Nota:
Pode-se aplicar essa propriedade de dinmico somente para objetos de texto que
contenham o caractere # (Cada # representa um caractere) para ser substitudo por
um valor durante o runtime.

Clique duas vezes no objeto para abrir o dilogo Object Properties. Pode-se utilizar esse dilogo para
especificar os seguintes parmetros:

Object Properties: Text I/O
Campo de Texto Tag/Expression: Digite um dos tpicos que se seguem no campo:
* Um tag no qual executar uma operao de entrada e sada
* Uma expresso na qual executar somente uma operao de sada
* Pode-se clicar no boto para procurar em seus diretrios para um tag ou expresso j
existentes.
check-box Input Enable: Habilite essa opo para permitir entrada de dados. Desabilite a opo
e esse dinmico executa somente os dados de sada.
check-box Confirm: Habilite essa opo para requisitar usurios a confirmar quaisquer valores
configurados durante o runtime.
Campo Minimum Value: Habilite essa opo para definir um valor mnimo para o tag associado
a esse objeto de texto. No ser permitida a entrada de um usurio com nmero menor que esse
valor.
Campo Maximum Value: Habilite essa opo para definir um valor mximo para o tag
associado a esse objeto de texto. No ser permitida a entrada de um usurio com nmero maior
que esse valor.
check-box Password: Habilite essa opo para ocultar o texto senha para entrada, substituindo
o texto por asteriscos (*).
combo-box Fmt (format): Clique no boto do combo-box para selecionar um formato para o
campo input/output. (Decimal o nico formato disponvel para aplicaes em CE.)
check-box E-Sign: Quando essa opo est habilitada, o usurio solicitado a inserir a
Assinatura Eletrnica antes de alterar o valor do tag.
Campo VK: O tipo de Virtual Keyboard utilizado para esse objeto. Voc precisa habilitar a opo
Virtual Keyboard na interface Project Settings Runtime Desktop antes de configurar o Virtual
Keyboard para essa interface.
IWS 20/06/2007

InduSoft Web Studio

Pgina 211
Campo Disable: Digite um valor maior que zero nesse campo para desabilitar as propriedades
de entrada de dados do tag.
Campo Security: Digite um valor nesse campo para especifcar o nvel de segurana para um
objeto de entrada de dados especfico (como definido na seo Security).
Boto Colors ( ): Clique para adicionar a propriedade de alterao de cor para um objeto selecionado. O
dinmico Colors permite a modificao da cor de um objeto esttico durante o runtime baseado no valor de
um tag ou expresso.
Clique duas vezes no objeto para abrir a caixa de dilogo Object Properties.

Object Properties: Colors
Campo Type: Determina o modo no qual esse dinmico funcionar:
* By Limit: Ao selecionar esse tipo, pode-se especificar at quatro limites (Change Limit)
para esse dinmico e uma cor para cada limite. Quando o valor do tag ou expresso
configurado no campo Tag/Expr alcana os limites, a cor associada com o respectivo
limite aplicada ao objeto.
* By Color: Ao selecionar esse tipo, pode-se especificar o cdigo que deve ser aplicado ao
objeto diretamente no campo Tag/Expr. Utilizando esse cdigo, pode-se aplicar ao objeto
qualquer cor suportada pelo seu equipamento.
D Dica:
Pode-se configurar a funo RGBColor() no campo Tag/Expr quando Type = By
Color, o que permite a configurao da cor por seus cdigos RGB. Veja IWS
Development Environment -> Standard Interfaces -> Color Interface para uma
tabela com os cdigos para as cores mais comumente utilizadas.
Campo Tag/Expression: Digite o nome de um tag ou expresso a qual voc deseja monitorar.
Quando Type = By Limit, o IWS compara o resultado do tag/expresso com os Limites de Alterao
especificados para determinar a cor apropriada para o objeto selecionado. Quando Type = By Color,
o resultado desse campo configure a cor que ser aplicada ao objeto.
Campo Change Limit: Digite um valor limite (uma constante numrica ou tag) para a alterao da
cor. Os nmeros devem ser configurados em ordem ascendente, de acordo com a seguinte
seqncia de campos exibidos na janela de dilogo Object Properties: Campos esquerda acima,
esquerda a baixo, direita acima e direita abaixo. Clicando no boto More, pode-se configurar at 16
limites diferentes para o dinmico color.
IWS 20/06/2007

InduSoft Web Studio

Pgina 212

Caixa de Dilogo Color Limits
combo-box Color: Clique no boto do combo-box para associar uma cor com cada limite de cor.
Quando o dilogo Color abrir, clique em uma cor para selecion-la e depois feche o dilogo.
combo-box Blink: Clique no boto do combo-box para especificar se a alterao de cor dever
piscar, e a velocidade que dever ocorrer.
Nota:
Os campos que se seguem so desabilitados automaticamente quando Type =
By Color: Change Limit, Color e Blink.
Boto Position ( ): Clique para especificar quando e onde exibir uma objetos, utilizando os
valores de tags especificados.

Object Properties: Position
Pode-se utilizar esse dilogo para especificar os paramtros a seguir:
Campo Show on condition: Digite uma expresso nesse campo. Caso o valor de retorno seja
zero ou menor, o objeto ser oculto (a direo que o slider move-se determinada pela configurao
de Horz: ou Vert: linhas da propriedade. (Nota: Quando um objeto est invisvel, utilizar a condio
show on tambm 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 nvel de segurana
requisitado que permita a entrada de operadores com a utilizao de objetos slider.
IWS 20/06/2007

InduSoft Web Studio

Pgina 213
Campo Tag: Digite um tag associado ao objeto, permitindo que o objeto mova-se
horizontalmente e verticalmente atravs da tela.
Campo Range: Digite valores nesses campos para especificar os limites mais altos e mais baixos
para os valores de tags, permitindo ao objeto mover-se atravs da tela de acordo com o valor do tag
junto a essa escala.
Campo Position: Digite valores nesse campo paea especificar quantas alteraes de posio (em
pixels) pode-se mover um objeto na tela de acordo com a condio estabelecida. Pode-se inserir
valores negativos no Segundo campo (posio de destino).
combo-box Reference: Selecione uma das seguintes opes como um ponto de referncia a ser
utilizado ao mesmo tempo que o objeto movido na tela. necessrio especificar essa opo
somente se voc desejar redimensionar o objeto ou mov-lo.
* Left: Canto esquerdo do objeto
* Right: Canto direito do objeto
* Center: Centro do objeto
* Top: Canto superior do objeto
* Bottom: Canto inferior do objeto
Boto Resize ( ): Clique para aumentar ou diminuir o tamanho de um objeto ou smbolo
selecionado. Clique duas vezes no objeto/smbolo para abrir o dilogo Object Properties:

Object Properties: Resize
Utilize o dilogo Object Properties para especificar os seguintes parmetros:
Campos Tag: Digite valores nos campos Height e Width para aumentar ou diminuir o tamanho
na horizontal e na vertical do objeto.
Campos Range: Digite valores para especificar os maiores e menores limites do tag, os quais
sero utilizados pelo IWS para aumentar ou diminuir o tamanho do objeto.
Campos Size (%): Digite valores para especifcar uma escala de porcentagem, o qual o IWS
utilizar para aumentar e diminuir o tamanho do objeto.
combo-boxes Reference: Selecione um dos seguintes pontos de referncia para determinar como
o objeto aumenta seu tamanho horizontalmente e verticalmente.
* Left: A partir do lado esquerdo
* Right: A partir do lado direito
* Center: Horizontal e verticalmente a partir do centro do objeto
* Top: A partir do lado de cima
* Bottom: A partir do lado de baixo
Boto Dynamic Rotation ( ): Clique para rotear uma linha. Clique duas vezes na linha para
abrir o dilogo Object Properties:
IWS 20/06/2007

InduSoft Web Studio

Pgina 214

Object Properties: Dynamic Rotation
Utilize esse dilogo para especificar os seguintes parmetros:
Campo Tag/Expression: Digite um nome de tag ou expresso para associar com a linha
selecionada. O IWS l o valor representado na tela utilizando essa varivel ou expresso.
rea Range: Digite valores de tags Minimum e Maximum utilizados para mover a linha atravs
da tela, de acordo com a condio estabelecida.
rea Rotation (degrees): Digite valores de incio e trmino para especificar quantos graus pode-
se rotear uma linha na tela (rotao dinmica).
* Windows NT: Pode-se rotear uma linha em at 360 graus
* Windows CE: Pode-se rotear uma linha no mais do que 90 graus
combo-box Reference: Selecione um dos seguintes pontos de referncia para rotear o objeto
atravs 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 botes para que voc possa criar objetos dinmicos.
Objetos dinmicos tipicamente requisitam mais parmetros do que objetos estticos.

Barra de Ferramentas Active Objects
A barra de ferramentas Active Objects contm os seguintes botes:
Boto Alarm/Event Control Object ( ): Clique para adicionar um Objeto de Controle
Alarm/Event para a tela de sua aplicao.
Para criar e configurar um Objeto de Controle Alarm/Event:
Clique no boto Alarm/Event Control.
Clique na tela e arraste o mouse para criar e ajustar a forma do objeto.
IWS 20/06/2007

InduSoft Web Studio

Pgina 215

Object Properties: Alarm/Event Control
Utilize o dilogo 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 boto para exibir mensagens de alarme atuais.
* History: Clique (habilite) nesse boto para exibir mensagens de alarme a partir do banco
de dados histrico 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 216
Clique no boto Font para abrir o dilogo Font onde voc poder especificar propriedades de
exibio para texto de alarme.

Dilogo Font
Utilize Font, Font Style, e listas Size para especificar um typeface, estilos de fonte e
tamanho.
* Clique (habilite) os check-boxes no painel Effects para Strikeout (strikeout text) ou
Underline (underlining) o texto de alarme, ou utilize o combo-box para especificar uma
cor para o texto de alarme. (Nota: O painel Sample mostra como o texto aparecer no
objeto.)
* Por padro, o IWS utiliza fontes Western-style. Caso voc deseje alterar o padro, clique
no boto Script do combo-box e selecione-o a partir da lista. (Nota: Os contedos das
listas desse combo-box dependero de seu sistema operacional.)
* Ao terminar, clique em OK para fechar o dilogo Font.
IWS 20/06/2007

InduSoft Web Studio

Pgina 217
Clique no boto Columns para abrir o dilogo Columns onde voc poder especificar
propriedades de exibio para colunas no Objeto de Controle Alarm/Event.

Dilogo Columns
* Utilize o box Key para assinalar um atalho para cada coluna, o que permitir
procurer/organizar a informao no objeto Alarm Control por cada coluna, utilizando
teclas do teclado ao invs do cursor do mouse.
* A lista Available contm todos os tipos de colunas disponveis para esse objeto.
* A lista Visible contm todos os tipos de colunas atualmente em uso para o objeto.
* Clique nos botes para mover selees entre duas listas.
D Dica:
Utilize o dilogo Columns para exibir o valor mais recentemente substitudo pelo
novo valor. Para isso, mova ambos, Value e Previous da lista Available para a
lista Visible.

* Clique nos botes 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 padro das marcas e
larguras em runtime.
* Utilize o combo-box Align para especificar o alinhamento (Left, Center, ou Right) para o
texto da mensagem de alarme junto a uma coluna especificada.
* Clique (habilite) o check-box Available during runtime para permitir ao usurio
adicionar colunas selecionadas para a lista visvel durante o runtime.
* Ao terminar, clique em OK para fechar o dilogo Columns.
IWS 20/06/2007

InduSoft Web Studio

Pgina 218
Para filtrar mensagens de alarme durante o runtime, clique no boto Filters. O dilogo Filters
ser exibido, de forma que voc poder especificar parmetros de filtrao para o Objeto de Controle
Alarm/Event.

Dilogo Filters
* Utilize o campo Group para filtrar mensagens de alarme para um ou mais grupos de
usurios. Digite o nmero Group no campo de texto (Por exemplo, 1). Tambm pode-se
utilizar uma virgula ou um trao 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 parmetros de From e To no painel Priority para filtrar mensagens de alarmes
baseadas em prioridade. Digite valores nos campos de texto para delimitar a escala de
prioridade.
IWS 20/06/2007

InduSoft Web Studio

Pgina 219
* Utilize os campos de texto Tagname, Message, e/ou Username no painel Search in
columns para especificar um critrio para filtrao de mensagens de alarme. Digite um
tagname, mensagem, e/ou nome de usurio no campo de texto para o qual voc deseja a
busca pelo IWS.
* Utilize os parmetros no painel Interval para filtrar mensagens de alarme pelo ltimo
nmero x de mensagens (Latest) ou baseadas em um perodo de tempo (Period).
* Utilize os parmetros no painel Initial Sort para configurar o padro para
procura/organizao. Selecione um tipo de coluna do combo-box Column, clique no
radio button Asc ou Desc para pesquisa em ordem ascendente ou descendente. Clique
no check-box Allow sort in runtime caso voc deseje habilitar a pesquisa para que
ocorra durante o runtime.
Notas:
Pode-se configurar nomes de tags (tags string) entre colchetes { } nos campos
Group, Selection, Tagname, Message, e Username para modificar as opes de
filtragem durante o runtime.
Pode-se configurar nomes de tags inteiros para esses campos no painel Priority
e/ou no ltimo campo do painel Interval para modificar tais valores durante o
runtime.
Pode-se configurar nomes de tags de string para os campos Period no painel
Interval para modificar tais valores de tag durante o runtime.
Pode-se utilizar wildcards (* e ?) ao especificar valores para os campos Selection,
Tagname, Message, e Username.

Clique no boto Advanced para abrir o dilogo Advanced onde voc poder especificar
propriedades avanadas para o Objeto de Controle Alarm/Event.

Dilogo Advanced
IWS 20/06/2007

InduSoft Web Studio

Pgina 220
Utilize os parmetros no painel Date and Time Format para controlar quais informaes
sobre data e hora sero 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 previso de quais informaes aparecero na tela.
Utilize os parmetros no painel Ack para controlar como os alarmes devem ser
reconhecidos.
* Campo Security: Digite um valor numrico para especificar quais nveis de segurana
reconhecem uma mensagem de alarme. Somente os usurios com o nvel de segurana
especificado podero responder.
* Campo Ack all tag: Digite um tag para receber um valor. Quando o valor do tag se
altera, isso indica que todas as mensagens no objeto de alarme foram reconhecidas.
* Campo Ack tag: Digite um tag para receber um valor. Quando o valor do tag altera-se,
isso indica que as mensagens na parte superior do objeto de alarme foi reconhecida.
* check-box Confirm: Clique (habilite) esse box para exibir um dilogo de confirmao
quando o usurio tentar reconhecer um nico alarme.
* check-box Enable comment (individual ack only): Clique (habilite) esse box para permitir
que o usurio insira comentrios sobre o alarme, logo aps seu reconhecimento.
Utilize os parmetros 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 dilogo permitindo que voc personalize as colunas visveis 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 dilogo permitindo que voc filtre as colunas visveis no
objeto.
Utilize os parmetros no painel Delete Message para controlar quem poder deletar
mensagens de alarme a partir do Histrico de Alarme:
* Security: Utilize esse campo para especificar qual nvel de segurana poder deletar
mensagens de alarme. Somente aqueles usurios com o nvel de segurana especificado
sero permitidos a deletar uma mensagem de alarme.
* Confirm: Clique (habilite) esse box para requisitar o usurio a confirmar uma seleo de
mensagem antes que o IWS realmente delete a mensagem de alarme em questo.
* Campo Total items: Digite um tag integer para ver quantos alarmes permanecem aps o
IWS filtrar o objeto de alarme com a utilizao de parmetros especificados no dilogo
Filters.
* Campo Selected tag: Digite um tag string para habilitar o usurio final a clicar em uma
mensagem de alarme, a fim de visualizar o nome do tag associado com o evento de
alarme.
* Campo Print trigger: Digite um tag nesse campo para imprimir um resumo do alarme a
partir de sua impressora padro quando o valor desse tag se alterar.
* Boto Navigation Triggers...: Insira tags nos campos para navegao pelo objeto de
alarme.
Ao terminar, clique OK para fechar o dilogo 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.
IWS 20/06/2007

InduSoft Web Studio

Pgina 221
Clique (habilite) o check-box Ext translation para habilitar a traduo externa de mensagens de
alarme, utilizando a Ferramenta Translation. (VejaCaptulo 16: Utilizando o Translation Editor
para maiores informaes.)
check-box E-Sign: Quando essa opes est habilitada, o usurio solicitado a inserir a
Campo VK: Tipo Virtual Keyboard utilizado para esse objeto. necessrio habilitar a opo
Virtual Keyboard na interface Project Settings Runtime Desktop antes de configurar o
Virtual Keyboard para essa interface.

Trend Control object ( ): Clique para exibir data points (valores) de diferentes origens de
dados em um formato grfico. Os principais recursos fornecidos pelo objeto Trend Control so:
Exibio de mltiplas penas simultneamente
Suporte para diferentes Data Sources, como Tag, Batch, Database e Text File
Capacibilidade para gerar grficos X/Y de origiens de dados configurados (veja Trend Control
Object - Apndice A, ainda nessa seo, para um exemplo de um grfico X/Y)
Exibio simultnea de um nmero ilimitado de pontos de dados. Esse recurso pode ser
limitado pelo hardware utilizado, j que memria disponvel e execuo podem variar.
Barra de ferramentas Built-in, fornecendo interfaces para o usurio para interagir com o objeto
Trend Control durante o runtime
Legenda Built-in, que exibe a informao principal associada a cada pena com link ao objeto
Ferramentas de Zoom e auto-scaling
Orientao horizontal e vertical
Nota:
Para compatibilidade com aplicaes criadas em verses mais antigas do IWS
(legacy), o objeto Trend ainda suportado e disponvel a partir da barra de
ferramentas Legacy. Porm, o objeto Trend Control fornece todas as
funcionalidades do objeto Trend anterior em adio a outras vantagens. Por
isso, recomenda-se a utilizao do objeto Trend Control para novos projetos.

Trend Control Interface de Desenvolvimento
Essa seo descreve a interface de desenvolvimento e todas as configuraes disponveis para a
formao do objeto na tela.
Embora o objeto Trend Control suporte configuraes flexveis que vo de encontro a
necessidades especficas de sua aplicao, a maioria das configuraes so estabelecidas por
padres baseados nas interfaces mais comumente utilizadas. Portanto, em muitos casos, voc
configurar somente pontos de dados (exibidos durante o runtime) que possam ser facilmente
executados clicando-se no boto Points da janela Object Property.
Clique na ferramenta Trend Control para adicion-la a tela de sua aplicao. Clique duas vezes
no objeto para iniciar sua janela de dilogo Object Properties, como se segue:
IWS 20/06/2007

InduSoft Web Studio

Pgina 222

Dilogo 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 tambm selecionar a cor da linha de borda
com o box color direita do campo Type.
* box Fill: Clicando-se em Fill, pode-se escolher uma cor de fundo para o objeto Trend
Control, atravs de sua seleo 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 botes desse dilogo iniciam outros dilogos para configuraes especficas do
objeto Trend Control:
* O boto Data Sources no dilogo Object Properties Trend Control inicia esse dilogo:

Dilogo Data Sources
O data source define a localizao dos valores de pontos de dados a ele associados.
Muitos pontos podem compartilhar o mesmo data source no h necessidade de criar
um data source para cada ponto de dados.
O tag data source est disponvel por padro para o objeo Trend Control. Pode-se
adicionar mais Data Sources utilizando o boto New. O nome inserido ser utilizado
como um alias para estabelecer link entre de data points para o novo data source.
Os outros campos desse dilogo permitem a edio das configuraes 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 mxima de dados (em bytes) que sero prendidos na
memria runtime.
Sort: Esta opo til para traar dados de um arquivo de texto. Quando permitida
(checado), classifica os dados e mostra o valor da coluna do cursor at o Max. Buffer
IWS 20/06/2007

InduSoft Web Studio

Pgina 223
estiver enchido. Quando desabilitado (deschecado), os dados no so classificados e
o valor da coluna do cursor no mostrado.
Data Source Settings: Clique para definir as configuraes dos tipos de Source Type
selecionados.

A tabela a seguir resume as configuraes para cada Tipo Data Source:
Tipo de
Data
Source
Descrio CampoX-Axis Configuraes de Data Source
Batch
Batch gerado
pela tarefa
Trend do IWS
Desabilitado. Os
dados X-Axis
sero entregues
automaticamente
na posio correta
da propriedade do
arquivo Batch
gerado pelo IWS.

Insira o Nome Batch dos valores data point
para entrega. Pode-se configurar um tag entre
colchetes nesse campo para alterar essa
configurao de forma dinmica durante o
runtime.
Database
Banco de
Dados SQL
Relacional
Nome do Campo
que contm os
dados X-Axis

Configure os parmetros para estabelecer link
entre esse Data Source a Banco de Dados
SQL Relacional, o qual suporta os valores
data point. Veja Janela Database
Configuration Dialog no Captulo 17 para mais
informaes sobre essa janela de dilogo. Leia
Objeto Trend Control - Apndice B para um
exemplo de configurao para banco de
dados.
Text File
Arquivo de
Texto (e.x.
CSV file) com
valores data
point
separados por
um
delimitador
especfico
Nmero de
colunas que
suportam os
dados X-Axis. O
nmero 0 refere-se
a primeira coluna,
1 refere-se a
segunda coluna,
etc.

Insira o Nome do Arquivo de Texto que
suporta os data points. O caminho padro o
caminho da aplicao atual. Pode-se
configurar um tag entre colchetes para aletrar
IWS 20/06/2007

InduSoft Web Studio

Pgina 224
essa configurao de forma dinmica durante
o runtime.
Pode-se tambm escolher um ou mais
delimitadores para dados armazenados nesse
arquivo de texto. O valor de cada linha est
escrito entre dois delimitadores. Ao utilizar
uma vrgula como delimitador, o objeto grid
estar disponvel para leitura de dados de
arquivos CSV. Pode-se tambm escolher um
delimitador personalizado, verificando a opo
Other. Leia Objeto Trend Control - Apndice A,
para um exemplo de como configurar arquivos
de texto.
* O boto Points no dilogo Object Properties de Trend Control iniciam o dilogo abaixo:

Dilogo 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 devero estar visveis
durante o runtime (adicionar/remover penas para o grfico), apesar do nmero de data
Points associados com o objeto Trend Control.
A tabela a seguir resume as propriedades de cada Data Point:
Propriedade Descrio
Point
ID de Data Point. Cada data Point possui um nico ID, que assinalado
automaticamente quando o data Point criado nessa interface.
Label
A marca associada ao Data Point pode ser exibida em Legenda durante o runtime,
promovendo uma breve referncia ao usurio sobre cada data Point.
Color Cor da pena utilizada para desenhar valores de Data Point no objeto Trend Control
Data Source
Data Source que suporta os valores para o data Point. O Tag Data Source est
disponvel por padro. Veja o boto Data Sources acima para maiores informaes
sobre como tornar Data Sources adicionais disponveis para o objeto.
Tag/Field
O significado desse parmertro depende do Tipo de Data Source associado ao data
Point:
IWS 20/06/2007

InduSoft Web Studio

Pgina 225
Tag: Digite o nome do tag com valores a serem exibidos. Caso o tag esteja
configurado na tarefa Trend, os dados histricos so entregues automaticamente;
de modo contrrio, somente valores online so exibidos.
Batch: Digite o nome do tag com valores a serem entregues do arquivo Histrico
Batch gerado pela tarefa Trend e exibido no objeto.
Database: Digite o nome do campo (coluna) no Banco de Dados SQL Relacional
que suporta os valores data Point.
Text File: Digite o nmero de uma coluna que suporte valores data Point. O
nmero 0 refere-se a primeira coluna, 1 refere-se a segunda coluna, etc.
Min Valor mnimo exibido na escala Y para o data Point
Max Valor mximo exibido na escala Y para o data Point
Style
Configure o estilo da pena (cor, tipo, estado, etc.).Veja o dilogo Pen Style abaixo
para maiores informaes.
Options
Configure parmetros opcionais para cada data Point. Pode-se utilizar o dilogo para
configurar tais parmetros ou digitar seus valores diretamente no campo Options,
utilizando vrgulas como delimitadores. Veja o dilogo Options acima para maiores
informaes sobre tais configuraes para maiores informaes sobre essa
configuraes.
Hide
Pode-se configurar um tag nesse campo. Quando esse tag possui o valor 0, a pena
associada ao ponto exibia no objeto; do contrrio, ela estar oculta.

* Dilogo Pena Style: Esse dilogo permite a configurao da pena utilizada para desenhar
os valores data Point no objeto durante o runtime. Alm disso, esse dilogo pode ser
inicializado durante o runtime, permitindo ao usurio a personalizao dessas
configuraes on-the-fly.
Voc ter a opo para definir um Hi Limit e um Lo Limit para cada data Point com o
dilogo Options. O dilogo Pena Style permite a configurao de diferentes parmetros
para a pena (e.x. color), tanto para valores com limites (State: Normal) quanto para
valores sem limites (State: Out of Limits).

Dilogo Pen Style
Aps selecionar um Estado (Normal ou Out of Limits), pode-se configurar o estilo para
sua pena:
IWS 20/06/2007

InduSoft Web Studio

Pgina 226
Propriedade Descrio
Use Normal Settings
Disponvel somente para estado Out of Limits.
Quando verificado, a pena ser sempre exibida
com as configuraes para state Normal state,
mesmo se os valores data point no estejam nos
limites configurados.
Type
Selecione o tipo de linha utilizado para desenhar
a pena.
Weight
Selecione o peso (espessura) da linha utilizada
para desenhar a pena.
Expansion
Selecione os algortimos utilizados para
estabelecer links entre points, como se segue:
: Os pontos consecutivos so interpolados
diretamente de um a outro, com a utilizao de uma
linha. Essa opo adaptada para valores anlogos.
: Os pontos consecutivos so ligados apenas
por linhas horizontais e verticais (passos). Essa opo
adaptada para valores Booleanos.
Marker
Selecione o tipo de marcador (caso exista) que
dever ser exibido em cada amostra especfica
entregue a partir do Data Source e exibido no
objeto.
Color
Selecione a cor para o Marcador (caso exista) e a
linha utilizada para desenhar a pena no objeto.
Marker Size Selecione o tamanho do Marcador (caso exista).

Nota:
Ao rodar a aplicao sob sistema operacional WinCE ou em Web Thin Client
(qualquer OS), o dilogo Pena Style disponvel durante o runtime permite ao
usurio alterar somente a cor da pena.
* Dilogo Options: Utilize esse dilogo para configurar parmetros opcionais para cada
data Point, como se segue:
IWS 20/06/2007

InduSoft Web Studio

Pgina 227

Dilogo Options
Propriedade Descrio
Descrio
Esse texto pode ser exibido em legenda,
promovendo uma breve descrio sobre data
point durante o runtime. Ao utilizar tags, a
descrio padro aquela configurada para o
tag.
Eng. Unit
O texto pode ser exibido em legenda,
promovendo a associao entre Engineering
Unit e data point durante o runtime. Ao utilizar
tags, as unidades padro so aquelas
configuradas para o tag.
Lo Limit
Quando o valor do data point est abaixo desse
limite, sua pena pode ser exibida com um estilo
diferente (e.x. cor) durante o runtime. Veja o
dilogo Pena Style acima para maiores
informaes. Ao utilizar tags, o padro Low
Limit o valor Low Alarm configurado para o
tag.
Hi Limit
Quando o valor do data point est acima desse
limite, sua pena pode ser exibida em um estilo
diferente (e.x. cor) durante o runtime. Veja o
dilogo Pena Style acima para maiores
informaes. Ao utilizar tags, o padro High
Limit o valor High Alarm configurado para o
tag.
Hide Scale
Pode-se controlar um tag nesse campo para
controle da visibilidade da escala (Eixo Y)
associado a essa pena durante o runtime,
alterando-se o valor desse tag (0=Mostrar ;
1=Ocultar).
Break Interval
Intervalo mximo entre dois pontos
consecutivos. Caso o tempo entre duas
IWS 20/06/2007

InduSoft Web Studio

Pgina 228
amostras consecutivas seja maior que esse
nmero (em segundos), o Trend Control
assume que no h coleo de dados para esse
perodo, e no desenhar uma linha
estabelecendo link entre ambas as amostras.
Quando o Eixo X configurado como nmerico,
o valor nesse campo representa um valor de
escala numrica. Caso o Eixo X esteja
configurado como data/hora, o valor nesse
campo ser exibido em segundos.
X Axes off-set
Off-set para esse data point a partir da escala
do eixo X configurada para o objeto. Essa opo
til quando deseja-se exibir dados de dois ou
mais data points com a utilizao de uma
escala em X distinta (perodo de tempo/valor)
para cada um, de forma que Pode-se compar-
los. Quando o Eixo X est configurado como
numrico, o valor nesse campo representa um
valor de escala nmerica. Caso o Eixo X esteja
configurado como data/hora, o valor nesse
campo ser exibido em segundos.
Cursor Value
Pode-se configurar um tag nesse campo.
Durante o runtime, o objeto Trend Cursor
atualiza o valor desse tag com o valor da
interseco entre a pena do data point pena e o
cursor Vertical (caso exista).
* Boto Axes: O Boto Axes no dilogo Object Properties de Trend Control inicializa o
seguinte dilogo:

Dilogo Axes
Esse dilogo permite a configurao de parmetros para os eixos X e Y.
IWS 20/06/2007

InduSoft Web Studio

Pgina 229
Data Type: O Eixo X pode exibir tanto valores Data/Hora quanto valores numricos,
de acordo com a configurao.

Tipo de dados Formato da Escala
Date/Time

Numeric

Period or Range: As configuraes disponveis nessa interface dependem do Tipo de
Dados configurado no Eixo X, como se segue:
Tipo de Dados Propriedade Descrio
Type
Start Date/Time: Quando essa opo est selecionada, o valor do
tag configurado no campo Time define Data/Hora iniciais para os
dados exibidos no objeto.
Hours Before Now: Quando essa opo est selecionada, o valor do
tag configurado no campo Time define a quantidade de tempo
antes da Data/Hora atual, a qual ser utilizada como incio
Data/Hora para os dados exibidos no objeto.
Duration
Define o Perodo de dados exibidos no objeto. Pode-se configurar um
tag string nesse campo, de forma que voc poder alterar a durao
dinamicamente durante o runtime, alterando o valor desse tag> O
formato do valor suportado por essa propriedade HH:MM:SS. E.x.
36:00:00 (trinta e seis horas)
Date/Time
(Period)
Time
Esse campo opcional. O valor do tag configurado nesse campo
representa um perodo de tempo, data ou hora melhor especificadas. O
significado desse valor depenader da configurao dessa opo para a
propriedade Type.
Quando o Tipo configurado como Start Date/Time, o valor do tag
IWS 20/06/2007

InduSoft Web Studio

Pgina 230
configurado nesse campo dever ser igual ao formato de Data e Hora.
E.x.: 02/10/2005 18:30:00.
Quando o Tipo configurado como Hours Before Now, o valor do tag
configurado nesse campo dever ser igual aos seguintes formatos:
a. Hora (valor de string). E.x. 48:00:00 (quarenta e oito horas)
b. Nmero de horas (valor real). E.x. 2.5 (duas horas e trinta minutos)
Min Valor Mnimo exibido no Eixo X
Numeric
Max Valor Mximo exibido no Eixo X

Nota:
Os tags configurados nos campos Period/Range so automaticamente
atualizados quando o usurio altera a escala X dinamicamente durante o
runtime, com a utilizao da barra Time do objeto.
Caso o campo Time seja deixado em branco (ou o tag configurado nesse campo
tenha o valor 0), o objeto exibe dados at a Data/Hora atual.

Grid (Eixo X ou Eixo Y): Pode-se configurar o nmero de divises (linhas verticais ou
horizontais) desenhadas no objeto para os eixos X e/ou Y respectivamente, assim
como a cor dessas linhas.
Time bar: Quando habilitada, essa barra exibida abaixo do Eixo X durante o
runtime; do contrrio, ela est oculta. A barra time uma interface padro que pode
ser utilizada pelo operador para alterao da escala do Eixo X durante o runtime.
Scroll bar: Quando habilitada, a barra Scroll exibida abaixo do Eixo X durante o
runtime; do contrrio, ela est oculta. A barra time bar uma interface padro que
pode ser utilizada pelo operador para navegar atravs da escala do Eixo X durante o
runtime. De forma opcional, pode-se configurar um tag no campo Scroll bar, o qual
define o perodo para a barra scroll. Caso esse campo seja deixado vazio, o perodo
ser igual ao valor atual para Durao do Eixo X.
Cursor: O cursor uma ferramenta ortogonal opcional para o Eixo X, o qual deve
ser utilizado durante o runtime para obter o valor de qualquer pena em um ponto
especfico (interseco da pena com o cursor). Ao clicar nesse boto, O dilogo
Cursor inicializa, e o local onde voc poder configurar os parmetros para o
cursor vertical opcional, como se segue:

Dilogo Cursor
Propriedade Descrio
Enable Quando habilitado, o cursor vertical est visvel durante o runtime.
Color Cor da linha desenhada para o cursor
Position (0-100)
Pode-de configurar um tag numrico nesse campo, proporcional a
posio do cursor no Eixo X, de 0 a 100%. Quando esse valor
IWS 20/06/2007

InduSoft Web Studio

Pgina 231
alterado, a posio do cursor modificada automaticamente.
Value Output
Pode-se configurar um tag string nesse campo, que retorna o valor do
Eixo X no qual o cursor est posicionado atualmente.
Position: Define a posio do Eixo X, bem como sua direo e orientao, como se
segue:

Dilogo Position
Propriedade Descrio
Placement Poso onde o Eixo X ser colocado
Direction Direo do Eixo X
Orientation Orientao do Eixo X
Scale: Define as propriedades do Eixo Y, como se segue:
Propriedade Descrio
Min / Max
Padro mnimo e mximo dos valores exibidos no Eixo Y. Utilizado
quando mais de uma pena compartilha de uma mesma escala
(Mltiplas Sees desabilitadas), e/ou para os pontos onde os campos
Min e Max no esto configurados (deixados em branco).
Multiple Sections
Quando habilitada, a escala Y dividida automaticamente em uma
seo para cada pena; do contrrio, todas as penas compartilham de
uma mesma escala Y.
Format
Inicializa um dilogo para Configurao do formato dos nomes
exibidos pelo Eixo Y.

IWS 20/06/2007

InduSoft Web Studio

Pgina 232
* Boto Legenda: O Boto Legend no dilogo Object Properties de Trend Control inicia
esse dilogo:

Dilogo Legenda
Show: Quando habilitada, a legenda exibida durante o runtime. Essa interface
fornece informaes teis associadas a penas atualmente com links estabelecido
com o objeto.
Available / Visible: Os campos no box Visible so exibidos em legenda durante o
runtime. Pode-se adicionar e remover campos do box Visible, utilizando os botes >>
e << respectivamente. Alm disso, pode-se utilizar os botes Move Up e Move Down
para alterar a ordem na qual os campos so exibidos em legenda durante o runtime.
Properties: Permite a configurao de propriedades para todos os campos marcados
nos boxes Available ou Visible:
Propriedade Descrio
Label Nome para o campo exibido durante o runtime
Width Largura para o campo (em pixels) durante o runtime.
Align Alinhamento dos dados exibidos no campo
Available during runtime
Quando essa opo est habilitada, o usurio pode exibir ou ocultar o
campo durante o runtime.
Maximum size: Define o tamanho de legenda em, termos de nmeros de linhas. Por
exemplo, o usurio poder ter 8 pontos sendo exibidos no objeto trend, caso o
tamanho mximo esteja configurado para dois, legenda ter uma barra de rolagem
para permitir ao usurio rolar para os outros pontos.
IWS 20/06/2007

InduSoft Web Studio

Pgina 233
Number of items: Nmero de pontos (padro) exibidos em legenda. Pode-se permitir
ao usurio adicionar/remover pontos durante o runtime apesar do valor estipulado
nesse campo.
Selected Item: Pode-de configurar um tag numrico nesse campo. O objeto registra
nesse tag o nmero de linhas selecionadas. Alm 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.
* Boto Toolbar: O Boto Toolbar no dilogo Object Properties de Trend Control inicia esse
dilogo:

Dilogo Toolbar
Show: Quando esse box est habilitado, a barra de ferramentas exibida durante o
runtime. Essa interface fornece botes teis para o disparo de aes relacionadas ao
objeto. Pode-se configurar os seguintes parmetros para cada Command (Boto)
disponvel na barra de ferramentas:
Propriedade Descrio
Show
Quando esse box est habilitado, o Boto exibido na barra de ferramentas do
objeto Trend durante o runtime.
Activation Tag
Pode-se configurar um tag nesse campo (opcional). Quando o tag altera seu valor,
esse dispara o respectivo comando. Essa opo til ao criar interfaces
personalizadas para disparo de comandos, ao invs de utilizar (ou redundante) a
barra de ferramentas.
* Boto Advanced: O Boto Advanced no dilogo Object Properties de Trend Control inicia
esse dilogo:
IWS 20/06/2007

InduSoft Web Studio

Pgina 234

Dilogo Advanced
Opes Run Mode: As configuraes nessa rea definem o comportamento do trend
quando em modo de execuo:
Propriedade Descrio
Update trigger Quando o tag configurado nesse campo altera seu valor, o objeto
Trend atualizado.
Update interval Quando diparador de atualizao disapardo e o Eixo X sendo tipo
numrico, o valor nesse campo ser adicionado aos valores mnimo e
mximo do Eixo X.
Move to current time on
run
Quando o Eixo X tipo Data/Hora e esse campo est habilitado, o
comando Run sempre mover o Eixo X para a hora atual.
Retrieve bounding
samples

Quando estiver habilitada, o objeto recupera os dados limitados do
objeto (somente os primeiros pontos). Deasbilitar esta opo pode
melhorar o desempenho, desde que os pontos limitados do objeto no
sejam recuperados do histrico. Por outro lado, o objeto no
desenhar as linhas que ligam o primeiro e ltimas amostras s
extremidades do objeto.

Run-Time Config: As configuraes do Objeto Trend modificadas durante o runtime
podem ser salvas em arquivos temporrios. Essa opo pode ser utilizada para:
Manter os ajustes consistentes, de forma que o usurio poder fechar a tela e abri-la novamente, ou
reiniciar a aplicao, os parmetros configurados durante o runtime no sero perdidos.
Cria configuraes padro para diferentes cenrios, alm de carregar a configurao apropriada
durante o run-time, baseando-se em uma condio pr-definida, ou na seleo do usurio.

IWS 20/06/2007

InduSoft Web Studio

Pgina 235
As propriedades dessa moldura so descritas na tebela abaixo:
Propriedade Descrio
Save trigger
Quando o tag configurado nesse campo altera seu valor (e.x.
inverte), as configuraes atuais do objeto Trend so salvas
no arquivo temporrio. Esse comando no est disponvel
para Web Thin Client.
Load trigger
Quando o tag configurado nesse campo altera seu valor
(e.x.inverte), as configuraes do arquivo temporrio so
carregadas e aplicadas ao objeto Trend durante o runtime.
File Name
Caso esse campo seja deixado em branco, o arquivo
temporrio salvo no sub-diretrio \Web da aplicao com a
sintaxe <ScreenName><ObjectID>TrendControl.stmp (e.x.
MyScreen10TrendControl.stmp). A Web Thin Client station
salva/carrega o arquivo temporrio no diretrio Temp padro
do sistema operacional (e.x. \Documents and
Settings\<CurrentUser>\Local Settings\Temp).
Pode-se configurar um nome de arquivo personalizado para o
arquivo temporrio nesse campo ou at configurar um tag
string entre colchetes, de forma que o usurio poser aletar o
nome do arquivo de configurao dinamicamente durante o
runtime atravs da alterao do valor desse tag. Caso voc
no especifique um caminho, o arquivo salvo no sub-
diretrio \Web da aplicao por padro.
Auto Save
Quando esse box est habilitado, as configuraes atuais de
Trend so salvas automaticamente no arquivo temporrio
quando a tela onde o Trend est configurado fechada
durante o runtime. Caso o box no esteja habilitado, as
configuraes so salvas somente quando o comando Save
trigger executado.

C Ateno:
Aps a tela onde o Objeto Trend est configurado ter sido salva, as
configuraes no so carregadas automaticamente a partir do arquivo
temporrio quando a tela aberta novamente, a menos que o comando
Load trigger seja executado antes da tela ser fechada.
Custom point Selecioneion: O usurio no pode utilizar esse opo caso queira
personalizar a tela para selecionar pontos durante o runtime. As seguintes opes
esto disponveis:
Propriedade Descrio
Screen Nome da tela que ser aberta para selecionar uma tela especfica.
Point number Nmero do ponto. Esse nmero identifica a linha onde o ponto foi adicionado na
tela de configurao do ponto
Add Indicator Configure para 1 caso o usurio esteja adicionando um novo ponto. De modo a
adicionar um novo ponto, o usurio poder aumentar o nmero de pontos (veja
configurao da legenda) e configurar o Add Indicator de volta para 0.
VK: Tipo de Virtual Keyboard utilizado para esse objeto. Voc precisar habilitar a
opo Virtual Keyboard da interface Project -> Settings -> Runtime Desktop antes de
configurar o Virtual Keyboard para essa interface.
IWS 20/06/2007

InduSoft Web Studio

Pgina 236
Ext Translation: Quando essa opo 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 usurio na interao com Trend
Control durante o runtime. Essa seo descreve essas interfaces:
* Toolbar: Os comandos diposnveis na Barra de Ferramentas so descritos na tabela que
segue:
Comando cone Descrio Tag de Ativao
Run

Configura o Trend para Modo Play.
Nesse modo, o Eixo X continualmente
atualizado (Modo Online). Essa opo
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 no atualizado
continuamente (Modo Histrico), de
modo que o usurio poder visualizar
dados histricos em um perodo
congelado de tempo. Essa opo
desabilitada (em cinza) quando o trend
j est em Modo Stop.
0 = Modo Stop ligado
1 = Modo Stop desligado

Period

Inicia um dilogo, onde o usurio pode
modificar as configuraes principais
na escala do Eixo X
Window Zoom

Permite ao usurio clicar na rea
Trende arrastar o cursor para
selecionar a rea que dever estar
visvel quando o cursor for liberado.
Essa opo desabilitada (grayed out)
quando a opo Multiple Section (para
a escala Y) est ativada.
Horizontal
Zoom

Permite ao usurio clicar em dois
pontos na rea Trend, definindo a
escala Horizontal que dever estar
disponvel
Vertical Zoom

Permite ao usurio clicar em dois
pontos na rea Trend, definindo a
escala Vertical que dever estar
diposnvel. Essa opo desabilitada
(grayed out) quando a opo Multiple
Section (para a escala Y) est ativa.
Quando o tag de ativao altera
seu valor (e.x. toggles), esse
comando executado.
Zoom In

Permite ao usurio efetuar zoom para
aproximao (exibio de metade das
escalas X e Y atuais) a cada vez que
clicarem na rea Trend.
0 = Zoom In ligado
1 = Zoom In desligado

Zoom Out

Permite ao usurio efetuar zoom para
afastamento cada vez que clicarem na
rea Trend.
0 = Zoom Out ligado
1 = Zoom Out desligado

IWS 20/06/2007

InduSoft Web Studio

Pgina 237
Cancel Zoom

Cancela o Zoom selecionado
Legenda
Properties

Inicializa um dilogo, onde o usurio
poder modificar as configiuraes
principais da legenda
Pena Style

poder modificar o estilo da pena
selecionada.
Add Pena

poder adicionar uma nova pena para o
Objeto Trend
Remove Pena

Remove a pena selecionada do Objeto
Trend
Quando
o tag de ativao altera seu
valor (e.x. toggles), esse
comando executado.
Multiple
Sections

Alterna a escala Y para Multiple
Sections (uma seo para cada pena)
ou Single Section (todas as penas
compartilham a mesma seo da escala
Y).
0 = Multiple Sections ligado
1 = Multiple Sections desligado

Cursor

Alterna o cursor (rgua) para visvel ou
oculto
0 = Cursor ligado
1 = Cursor desligado

Auto Scale

Altera a escala do Eixo Y para adaptar-
se a todos os valores das penas que
esto sendo monitoradas atualmente.

Quando o tag de ativao altera
seu valor (e.x. toggles), esse
comando executado.
* Legend: Os comandos disponveis na Legenda so descritos na tabela abaixo:
Comando cone Descrio
Selecioneion

Inicializa um dilogo, onde o usurio pode substituir data points
associados a pena selecionada na legenda
Remove

Remove a pena selecionada do Objeto Trend
Hide

Quando habilitada, a pena selecionada estar visvel; do contrrio,
estar oculta.
Pena Style

Inicializa um dilogo, onde o usurio poder modificar o estilo da pena
selecionada.
Scale

Quando esse box est habilitado, a escala do Eixo Y estar visvel; do
contrrio, estar oculta. A escala poder ser oculta somente quando a
opo Multiple Sections estiver desligada.
* Scroll bar: Utilizando a barra Scroll, o usurio poder mover-se atravs dos valores do
Eixo X, de acordo com o perodo configurado.
* Time bar: Utilizando a barra Time, o usurio poder modificar a Durao, assim como a
Data de incio/Hora e/ou a Data/Hora de finalizao para os dados exibidos no objeto.
Alterar esses valores afetar os tags associados a escala do Eixo X (caso exista).
Objeto Trend Control Apndice A Utilizando o Arquivo de Texto Data Source
O Trend Control pode gerar grficos a partir de qualquer Arquivo Texto que tenha seus valores
organizados em colunas e linhas. As colunas devero ser separadas umas das outras por caracteres
IWS 20/06/2007

InduSoft Web Studio

Pgina 238
especiais (geralmente vrgulas). Cada amostra (um par de valores representando um ponto no
grfico) representada por uma linha (uma linha no arquivo). Suponha que o usurio queira exibir
um grfico com as informaes da tabela a seguir:
Valor X Valor Y1 Valor Y2
0 0 10
1 1 20
2 2 30
3 3 40
Temos uma varivel que representa o Eixo X e duas variveis (Y1 e Y2) que representam linhas
diferentes do grfico. O primeiro passo ser converter os dados para um arquivo texto. Caso
adotemos a vrgula como separador, o arquivo ser exibido dessa maneira

Recomendamos que o arquivo seja salvo na mesma pasta onde a aplicao esteja. Fazendo isso, no
teremos que Especificar o caminho complete e a sua aplicao ainda funcionar, mesmo que seja
copiada para um outro computador.
Uma vez adicionado o Trend Control para sua tela, clique duas vezes no objeto para abri-lo, e
depois em Object Properties e clique em Axis. Altere os Tipos de Dados (Data Type) do Eixo X para
numrico, e configure as escalas como mostrado na figura abaixo:

IWS 20/06/2007

InduSoft Web Studio

Pgina 239
Clique em Ok nessa Janela e depois, na janela Object Properties, clique no boto 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 boto,
Especifique o Nome do Data Source MyTextFile e clique em Create. Agora, voc dever vizualizar
as seguintes informaes:

No campo X Axis, precisaremos indicar qual coluna em nosso texto representar o Eixo X. Nesse
exemplo, estamos utilizando coluna zero, de modo a inserir zero para esse campo. Depois de clicar
no boto Data Source Settings, a seguinte janela aprecer:

IWS 20/06/2007

InduSoft Web Studio

Pgina 240
Caso voc tenha copiado o arquivo de texto para a pasta da aplicao, voc ter somente que
especificar o nome do arquivo; do contrrio, insira o caminho completo onde o arquivo est
localizado (utilize o boto browse caso necessrio). Clique em Ok nessa janela e em Ok novamente
para finalizar a configurao de data source e fechar a janela Data Source Configuration.
Agora, precisamos definir nosos Y1 e Y2. Eles sero representados por pontos em nossa Trend
Control. Clique duas vezes em Trend Control para obter acesso a janela Object Properties, e depois
clique em Points. O prximo passo ser definir os pontos de acordo com a figura a seguir:

Aps concluir esses passos, rode sua aplicao, e voc dever visualizar uma figura semelhante a
que se segue:

IWS 20/06/2007

InduSoft Web Studio

Pgina 241
Objeto Trend Control Apndice B Utilizando Data Source Database
O Trend Control pode gerar grficos de tendncia para quaisquer Banco de Dados Relacionais que
possam ser acessados atravs da tecnologia ADO.Net. Esse Apndice ilustra como acessar um
Banco de Dados Microsoft Access; caso voc esteja utilizando algum outro tipo de banco de dados,
quase todas as definies podero ser aplicadas; porm, voc precisar configurar sua conexo de
um outro modo. Para informaes sobre como configurar outros bancos de dados, leia os Apndices
na seo 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 grfico baseado nas informaes contidas na tabela a seguir:

O primeiro passo ser adicionar o Trend Control a sua tela. Agora, clique duas vezes no objeto para
abri-lo, e depois em Object Properties. Clique em Data Sources. A seguinte janela ser exibida:

Precisamos criar uma data source de modo a obter acesso ao banco de dados. Clique no novo
boto, Especifique o Nome para Data Source MyDB e clique em Create. Agora, voc dever
visualizar essas informaes:
IWS 20/06/2007

InduSoft Web Studio

Pgina 242

Altere o Source Type para Database e especifique Time_Stamp no campo X Axis. Clique no boto
Data Source Settings, e a janela a seguir aparecer:

Desabilite o check box Use application default e clique no boto browse de modo a configurar uma
string de conexo. A seguinte janela aparecer:
IWS 20/06/2007

InduSoft Web Studio

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

IWS 20/06/2007

InduSoft Web Studio

Pgina 244
Clique em Ok para finalizar a configurao da string de conexo. Agora, desabilite a opo Use
default name e selecione a tabela de seu banco de dados, como mostrado abaixo:

Clique em Ok nessa janela e em Ok novamente para finalizar a configurao de data source. Feche
a janela Data Source Configuration.
Agora, precisaremos definir Temperature e Pressure, as quais sero representadas por pontos em
nosso Trend Control. Clique duas vezes em Trend Control novamente para acessar a janela Object
Properties. Clique em Points. Seu prximo passo dever ser definir os pontos de acordo com a
figura que se segue:

Caso voc rode o trend, esse se inicializar com data/hora atuais. De modo a visualizar os dados no
grfico, voc ter que configurar, de maneira apropriada, data/hora iniciais, como mostrado abaixo:
IWS 20/06/2007

InduSoft Web Studio

Pgina 245

Boto Trend ( ): Clique para selecionar uma rea na tela na qual exibir curvas de tendncia
dos dados do tag. Pode-se exibir at oito curvas simultaneamente no objeto, e utilizar os
campos de configurao em propriedades do objeto para a especificao de:
Perodo de tempo a ser exibido
Valores a serem exibidos
Formato do grfico
Para criar um objeto Trend:
Clique no Boto 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 dilogo Object Properties:

Object Properties: Trend
Utilize o dilogo Objeto Trend Properties para especificar os seguintes parmetros:
Trigger: Digite (ou clique no Boto para selecionar) uma varivel para definir como as curvas de
tendncia sero redesenhadas. Quando o valor desse tag alterar-se, o IWS redesenhar as
curvas de tendncia exibidas. Voc dever completar esse campo caso voc especifique (habilite)
trends On Line, embora no seja exigido para trends Histricos.
Campo Update: Digite uma varivel para que o IWS possa utilizar na criao do trend. Utilize
esse campo somente em conjuno a trends Crisp.
combo-box Curve Type: Selecione um tipo de curva a partir das seguintes opes:
IWS 20/06/2007

InduSoft Web Studio

Pgina 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
aplicao
* Crisp: Selecione para plotar valores de curvas em um formato apropriado para
estabelecimento de interfaces com estaes VAX
combo-box Orientation: Selecione uma das seguintes opes para especificar como as
penas de trend sero orientadas em relao 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 histricas de trend da aplicao.
C Ateno:
Para utilizar grficos tipo histricos 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 parmetros Save on Tag Change ou
Save on Trigger na planilha Trend Group. Tais tags tero suas amostras
armazenadas no disco rgido.

radio button On Line: Clique (habilite) para exibir curvas de trend online para a aplicao.
Nota:
Caso voc habilite esse boto, voc dever inserir um valor no box de texto
Trigger para indicar quando o IWS ir redesenhar as curvas de trend.

combo-box Border Color: Clique para selecionar uma cor para a rea de borda do grfico de
trend. Quando o dilogo Color aparecer, clique em uma cor para selecion-la, e depois feche o
dilogo.
combo-box Background Color: Clique para selecionar uma cor de fundo para a rea do grfico
de trend. Quando o dilogo Color aparecer, clique em uma cor para selecion-la, e depois feche
o dilogo.
Boto Horizontal Scale: Clique para abrir o dilogo Horizontal Scale, o qual permite a definio
de propriedades de escala horizontais para as curvas de trend.
Nota:
O contedo desse dilogo altera-se dependendo dos parmetros especificados
no dilogo Object Properties Trend.

IWS 20/06/2007

InduSoft Web Studio

Pgina 247

Exemplo de Dilogo Horizontal Scale
A seo a seguir explica como configurar todos os parmetros de Horizontal Scale.
* check-box Scale Visible: Clique (Habilite) para exibir a escala horizontal ou desabilite o
box para ocultar a escala horizontal.
* Campo Number of Labels: Digite um valor para especificar quantos nomes voc poder
utilizar na escala horizontal.
* rea Grid: Utilize os seguintes parmetros para configurar um grid para o grfico trend.
Campo Divisions: Especifique quantas linhas de diviso a serem utilizadas no grid. Caso
voc deixe esse campo em branco, no aparecro linha na grade.
combo-box Color: Clique para selecionar uma cor para a grade. Quando o dilogo Color
aparecer, clique em uma color para selecion-la e depois feche o dilogo.
* rea Scale String Format: Utilize os seguintes parmetros para especificar um formato
para a string de texto na escala horizontal.
Boto Fonts: Clique nesse Boto para abrir o dilog Fonts, o qual permite a seleo de
um estilo, cor e tipo de fonte para os nomes dos eixos horizontais.
check-boxes DD/MM/YY (somente Curva X/Y e Grfico X/t): Clique (check) nesses boxes
para adicionar uma data (dias/meses/ano) a string de texto na escala.
check-boxes HH:MM:SS (somente Curva X/Y e Grfico X/t): Clique (check) nesse boxes
para adicionar a hora (horas:minutos:segundos) a string de texto na escala.
* rea Vertical Cursor: Utilize os seguintes parmetros para especificar um formato para o
cursor vertical.
check-box Enable: Clique (habilite) para exibir um cursor vertical.
combo-box Color: Clique para selecionar uma cor para o cursor vertical. Quando o
dilogo Color aparecer, clique em uma cor para selecion-la e depois feche o dilogo.
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 posio do cursor (0
corresponde ao limite esquerdo e 100 ao limite direito da trend).
Campo Date/Time output (torna-se ativo ao habilitar o cursor horizontal): Inisra um tag
name para receber uma string, que ser constantemente atualizada com a hora atual do
cursor vertical do trend.
* Campo Horizontal axis Duration (Somente curva do tipo X/t) ou Duration (horas)
(somente histricos e Grficos X/t): Digite um tag name ou valor numrico 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 inico ao fim.
IWS 20/06/2007

InduSoft Web Studio

Pgina 248
* Campo Hours before now: Especifica um tag para executar rolagem na rea Trend. O
valor desse tag Especifica uma hora de incio do trend em relao a hora atual.
Por exemplo: caso voc especifique as configuraes a seguir, o IWS permitir a exibio
do grfico 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
C Ateno:
O dilogo Graphic trend suporta um mximo de 16.000 amostras.

Nota:
Ao utilizar o parmetro Hours Before Now, voc estar manipulando dados
histricos. Conseqentemente, deve-se configurar as penas do trend em um
grupo de trend (Utilizando a pasta Trend no tab Tasks).

rea Type of History Files (somente Grficos e Histricos X/t): Utilize os seguintes parmetros
para especificar em qual formato os arquivos histricos foram criados.
* Date (padro): Clique para manipular arquivos criados em formato de data pelo grupo de
trend (formato InduSoft).
* Batch: Clique para manipular arquivos criados em formato batch por grupo de trend
(formato de arquivo batch).
* Start Date (somente Grficos e Histricos X/t): Especifica uma data (tipicamente um tag
tipa string) em formato DD/MM/YYYY para especificar o nico das curvas histricas.
* Campo Start Time (somente Grficos e Histricos X/t): Especifia uma hora (tipicamente
um tag tipa string) em formato HH:MM:SS para especificar o incio das curvas histricas.
* Campo Tag X (somente Grfico 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 Grfico X/Y): Especifica o nmero de pontos (amostras) no
dilogo graph.
* Campo Max (somente Grfico X/Y): Especifica um valor mximo para a varivel X.
* Campo Min (somente Grfico X/Y): Especifica um valor mnimo para a varivel X.
D Dica:
Pode-se utilizar o mdulo Recipe (no tab Tasks) para salvar e carregar
informaes histricas para o trend X-Y. Veja Captulo 8: Configurando Planilhas
de Tarefas.

Boto Vertical Scale: Clique para abrir o dilogo Vertical Scale, o qual permite a definio de
propriedade de escala vertical para as curvas de trend.
IWS 20/06/2007

InduSoft Web Studio

Pgina 249

Exemplo de Dilogo 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 podero ser
utilizados na escala vertical.
rea Grid: Utilize os seguintes parmetros para configurar uma grade vertical para o grfico de
trend .
* Campo Divisions: Especifique quantas linhas divisrias sero utilizadas para a grade
vertical. Caso voc deixe esse campo em branco, no sero exibidas linhas nessa grade.
* Lista drop-down Color: Clique para selecionar uma cor para a grade vertical. Quando o
rea Scale String Format: Utilize os seguintes parmetros para especificar um formato para a
string texto em escala vertical.
* Boto Fonts: Clique nesse boto para abrir o dilogo Fonts, o qual permite selecionar
um estilo, cor e fonte para os nomes dos eixos verticais.
* Campo Width: Especifica quantos dgitos so permitidos para nmeros na string da
escala vertical.
* Campo Decimals: Especifica quantos espaos decimais so permitidos na string da
escala vertical.
Por exemplo: Caso voc insira Width = 3 e Decimals = 2, a string da escala horizontal
poder utilizar nmeros de trs dgitos com dois espaos decimais.
rea Scale Range: Utilize os seguintes parmetros para calcular quantas posies de curva so
definidas no dilogo Pens. Pode-se utilizar um valor nmerico ou um tag para alterar
dinamicamente a escala vertical.
* Campo Minimum: Digite um valor mnimo para a escala do grfico trend.
* Campo Maximum: Digite um valor mximo para a escala do grfico trend.
Boto Pens: Clique para abrir o dilogo Pens:
IWS 20/06/2007

InduSoft Web Studio

Pgina 250

Dilogo Pens
Utilize os seguintes parmetros 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 dilogo Trend genrico, Especificando um tag indireto para definir o tag a ser
monitorado.
Botes Line: Clique para selecionar uma cor para as linhas em cada curva de trend. Quando o
dilogo Color aparecer, clique em uma cor para selecion-la e depois feche o dilogo. Pode-se
utilizar at oito linhas de coloraes diferentes em um grfico trend.
Campos Min e Max: Especifica um valor mnimo e mximo de escala (numrico ou tag) com o
qual desenhar a curva.
Nota:
Os valores mnimos e mximos de cada tag no necessitam ter os mesmos
valores mnimos/mximos como a escala de grfico trend.

Campos Cursor Value: Digite tags para receber o valor da linha Trend onde esse intersecciona-
se com o cursor vertical.
C Ateno:
O trend On-Line aloca memria para cada ponto dentro do perodo de
visualizao. O CEView descartar os valores mais antigos (mesmo que
estejam dentro do perodo de visualizao) quando a memria disponvel
menor do que o limite crtico (1MB por padro). Alm disso, uma mensagem
de precauo iniciada localmente.

IWS 20/06/2007

InduSoft Web Studio

Pgina 251
Boto SPC: Clique para abrir o dilogo SPC Parameters, o qual voc poder utilizar para
retornar valores Mean, Min, Max, e Standard Deviation (-2s, +2s) a partir do perodo
selecionado para cada pena. (Tambm Pode-se desenhar o resultados no Objeto Trend.)

Dilogo SPC Parameters
Utilize os parmetros desse dilogo como se segue:
combo-box Pen: Clique no boto de seta para selecionar uma pena da lista.
Disable: Digite um tag no campo de texto. Caso o valor do tag seja diferente de 0 (falso), o IWS
desabilitar o recurso SPC.
Campos Tag: Digite um tag name nos campos de texto para retornar valores de Mean, Min,
Max, Median, Sum, e/ou Standard Deviation.
check-box Draw: Clique (habilite) nesses boxes para desenhar os resultados dos valores Mean,
Min, Max, Median, Sum, e/ou Standard Deviation -2s/+2s no grfico trend.
Boto Line: Aps habilitar o check-box Draw, clique nesse boto para exibir parmetros para
diferentes linhas de penas.
Quando o dilogo Line Selection aparecer, especifique o seguinte:
* painel Line: Clique em um radio button para especificar Solid ou Dashed Line e digite
um valor no text box Weight para configurar a espessura da linha.
* combo-box Color: Clique no boto de seta para exibir uma paleta de cores. Clique em
um boto Color para selecionar uma cor de linha para a pena e depois clique em OK
para fechar o box de paleta de cores.
Boto List Box Object ( ): Clique para criar um objeto list box em sua tela. Geralmente, ao
executar uma aplicao, o objeto list box ativo exibe uma lista de mensagens.
Em uma tela contendo somente um objeto list box e nenhum box de texto, o objeto list box ser ativado
automaticamente.
Em uma tela contendo mltiplos 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 visvel de um
objeto list box, o objeto fornecer barras de rolagem.)
Use o box Enter Reqd no dilogo Object Properties para configurar mensagens selecionadas como se segue:
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 funo PostKeys() para rolar
atravs da lista de mensagem. Depois, utilize a tecla Enter para selecionar a mensagem e
registrar seu valor para o tag escrito. Pode-se utilizar as teclas Esc e Tab para retornar a
mensagem previamente selecionada a qualquer momento, pressionando a tecla Enter.
Desabilite o campo Enter Reqd para registrar o valor de uma mensagem selecionada
(highlighted) automaticamente.
Para adicionar objetos list box a uma tela:
Clique no boto List Box na barra de ferramentas Active Objects.
Clique na tela e arraste para criar/ajustar um retngulo amplivel.
* Height e tamanho da fonte determinam quantas mensagens esto visveis.
* Width determina quanto do comprimentonto das mensagens est visvel.
Aps criar um retngulo, pode-se ajustar as caractersticas de tamanho e fonte para permitir
que mais mensagens sejam exibidas no espao dado.

Object Properties: List Box
D Dica:
Tambm pode-se abrir o dilogo Object Properties clicando-se com o boto
direito no objeto list box ou selecionando o objeto, pressionando as teclas
Alt+Enter e selecionando Properties a partir do menu pop-up resultante.

Lista drop-down Value (localizada abaixo do boto Replace): Clique para selecionar um dos
seguintes valores de tag utilizados para o ndice da lista de mensagem.
* Boolean
* Integer (padro)
* LSB (bit menos significante)
Nota:
Para maiores informaes, veja a discusso sobre o campo State no dilogo
Messages Configuration.

IWS 20/06/2007

InduSoft Web Studio

Pgina 253
Boto Messages: Clique para abrir o dilogo Messages Configuration.

Dilogo Message Configuration
Utilize os parmetros nesse dilogo como se segue:
* Campo State (somente leitura): Utilize esse campo para visualizar as mensagens
individuais indexadas. O IWS numera esse campo baseando ser no tipo Read/Search
Tag selecionado:
Boolean: Fornece dois estados vlidos, nomeados de 0 e 1
Integer: Fornece 255 estados vlidos, nomeados de 1 a 255
LSB: Fornece 32 estados vlidos (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 (tambm, o mesmo valor escrito ao tag registrado).
Caso voc Especifique LSB para o campo Value, o IWS utiliza o valor especificado no
campo State para Read/Search Tag e para registrar o tag.
* Campo de cor Text Foreground: Clique para especificar uma cor de primeiro plano para
o texto da mensagem. Quando o dilogo Color aparecer, clique em uma cor para
selecion-la e depois feche o dilogo.
* check-box Text Blink: Clique (habilite) para fazer com que uma mensagem selecionada
pisque, uma vez por segundo, quando for exibida.
Boto Fonts: Clique para abrir o dilogo Font, o qual permite a alterao das caractersticas
(estilo, tamanho, etc) da fonte da mensagem.
text box User Enable: Digite um tag, expresso ou um nmero (diferente de zero) para
selecionar um mensagem na aplicao em runtime. O padro 1 (verdadeiro, habilitado).
text box Control Enable: Digite um tag, expresso ou um nmero (diferente de zero) para
selecionar uma mensagem na aplicao em runtime dependendo do valor atual de
Read/Search Tag. O padro 1 (verdadeiro, habilitado).
O IWS baseia esse parmetro no campo Value (dilogo Messages Configuration) que voc
associa a mensagem selecionada. Habilitar esse campo permite que tag alteradas disparadas
pelo processo afetem as mensagens que voc poder selecionar.
text box Read/Search Tag: Digite um tag integer ou Boolean para apontar a uma mensagem
selecionada no campo Value da mensagem (dilogo Messages Configuration). Pode-se utilizar os
campos Control Enable e User Enable para controlar se o operador ou um processo podem
alterar esse tag.
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 contm 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 usurio a insero da Assinatura
Eletrnica antes de executar o dinmico.
check-box Row: Clique (habilite) para incluir setas de configurao e desconfigurao (set up e
set down) na barra de rolagem do objeto list box.
check-box Page: Clique (habilite) para incluir setas para pgina acima e pgina abaixo (page up
e page down) na barra de rolagem do objeto list box.
check-box Start/End: Clique (habilite) para incluir setas de incio e fim (home e end) na barra
de rolagem do objeto list box.
check-box List wrap: Clique (habilite) para continuar a exibio e rolagem da lista de mensagem
(iniciar-se no lado oposto) aps rolar para o incio ou final da lista.
check-box Enter Reqd: Clicando (habilitando) nesse box permite a seleo de mensagens
utilizanso somente a tecla Enter, o que evita a utilizao da tecla Tab para seleo das
mensagens.
boxes Color: Clique no color box para abrir o dilogo Color ou o dilogo 16-color Color Selection.
Tais dilogos permitem a especificao ou alterao de cores para o objeto list box. Clique em
uma cor para selecion-la e depois clique em OK para fechar o dilogo.
box Highlight Color: Especifica uma cor para seleo de mensagens (o padro azul).
box Text Color: Especifica uma cor para seleo de mensagens de texto (o padro preto).
box Win Color: Especifica uma cor de fundo para o objeto list box (o padro branco).
box Border Color: Especifica uma cor para as bordas do objeto list box (o padro preto).
Boto Smart Message Objects ( ): Clique para criar um ou mais objetos de mensagens, o
qual podero ser utilizados para exibir mensagens e grficos baseados em valores de tags ao
executar a aplicao. O IWS fornece os seguintes tipos de objetos Message Smart:
Message Display: Habilita a exibio de qualquer uma das mensagens smart com um nico
objeto de tela.
Multistate Indicator: Habilita a exibio de qualquer uma das mensagens smart mulDicale com
um nico obejto de tela, alm de possuir a habilidade de exibir imagens de bitmap junto as
mensagens.
Multistate PushBoto: Habilita a exibio de mensagens e imagens bitmap. Esse objeto tambm
assemelha-se a um alternador de mltiplas posies, 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 grficos,
registrar um tag, e controlar quantas mensagens e grficos sero exibidos na tela. Porm, todos os tipos de
objeto podem receber entradas de processo (Valor Read Tag) para determinar qual mensagem dever ser
exibida.
Para adicionar um objeto smart message tela:
Clique no boto Smart Message e posicione o mouse na tela.
Clique e arraste para criar (e ajuste as dimenses) um retngulo.
Utilize o tamanho do retngulo e fonte para determinar o tamanho do texto e da imagem bitmap
que sero exibidos na tela. Mais tarde, voc poder alterar o tamanho da fonte e as
caractersticas da fonte para permitir que mensagens maiores sejam exibidas em um espao
estipulado.
Clique duas vezes no objeto para abrir o dilogo Object Properties.
IWS 20/06/2007

InduSoft Web Studio

Pgina 255

Object Properties: Smart Message
combo-box Type: Clique para selecionar o tipo de objeto smart message. O tipo do objeto diz
respeito ao comportamento do objeto durante o runtime, alm dos recursos por ele suportados:
* Message Display (padro)
* Multistate Indicator
* Multistate PushBoto
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 vlidos. Utilize essa seleo quando voc desejar exibir
uma de duas diferentes mensagens, baseando-se em um valor booleano (0 ou 1).
* Integer (padro) Fornece 500 estados vlidos. Utilize essa seleo quando voc desejar
exibir diferentes mensagens baseando-se em valores especficos de um tag Integer.
* LSB (bit menos significante) Fornece 32 estados vlidos (32 bits em um valor inteiro).
Utilize essa seleo quando voc desejar exibir diferentes mensagens baseando-se em
qual bit de tag integer est selecionado. Caso mais de um bit do tag Integer esteja
configurado simultaneamente, a mensagem associada ao bit menos significativo
configurado (valor 1) ser exibida.

Nota:
Caso o PushBoutton Multistate seja o tipo Smart Message, somente 16 mensagens
diferentes podero ser associadas ao objeto, mesmo para Integer ou tipos de
valores LSB.

text box Read Tag/Expr: Insira o nome de um tag Integer ou Boolean. O valor do tag
determinar qual mensagem ser exibida pelo objeto durante o runtime.
text box Write Tag (opcional e disponvel somente para PushButton Multistate): Insira o nome de
um tag integer ou Boolean. O valor associado mensagem atualmente exibida est registrado a
esse tag.
Align: Selecione o alinhamento do texto exibido pelo objeto Smart Message o.
Key (opcional e disponvel somente para PushButton Multistate): Atalho utilizado para ir para a
prxima mensagem (passo) utilizando um teclado quando o tipo PushButton Multistate est
selecionado. Tal opo especialmente til ao criar aplicaes para equipamentos de runtime
que no fornecem um mouse ou interface touch-screen, ou seja, quando a nica interface fsica
disponvel para a interao com a aplicao durante o runtime o teclado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 256
Lista drop-down Event (disponvel somente para PushButton Multistate): Selecione uma das
seguintes opes para especificar quando a mensagem dever ser alterada:
* On Down: Alterna para a prxima mensagem ao clicar no objeto (padro).
* While Down: Alterna para a prxima mensagem de forma contnua enquanto o boto de
baixo do mouse estiver no objeto.
* On Up: Alterna para a prxima mensagem quando libera-se o boto do mouse no objeto.
E-Sign (disponvel somente para PushButton Multistate): Quando essa opo est habilitada, o
usurio ser requisitado a inserir a Assinatura Eletrnica antes da execuo do dinmico.
text box Security (disponvel somente para PushButton Multistate): Nvel de Acesso ao Sistema
de Segurana requisitado para o objeto/dinmico.
No Line: Quando essa opo est habilitada, a linha da borda do objeto no estar visvel.
Line Weight: Define a espessura da linha desenhada em redor do objeto (borda).
Fonts: Inicia o dilogo Fonts, onde voc poder configurar os parmetros de fonte para o texto
exibido no objeto.
Boto Config: Inicia o dilogo Configuration, onde voc poder configurar as mensagens para
o objeto, como se segue:

Exemplo de Dilogo Configuration: Smart Message
o Data Source: As mensagens exibidas pelo objeto tambm podem ser configuradas
diretamente no objeto (Data Source = Static) ou podem ser lidas a partir de arquivo de texto
externo (Data Source = Text File). Quando Data Source = Static, o dilogo Configuration
ser exibido como mostrado na figura acima, e voc poder configurar todos os parmetros
na prpria grade. Quando Data Source = Text File, o dilogo Configuration exibir um
campo para insero do caminho e nome do arquivo a partir do qual as mensagens sero
lidas (o arquivo de origem). Veja Source File Format para maiores detalhes sobre o formato
do arquivo de texto o qual suportado pelo objeto Smart Message quando Data Source =
Text File.
o Extern translation: Quando essa opo 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 Descrio
Text/Message Mensagem (texto) que ser exibida quando selecionada durante o
IWS 20/06/2007

InduSoft Web Studio

Pgina 257
runtime. Pode-se concatenar valores de tag para a mensagem,
configurando o tag entre colchetes. Por exemplo: O valor do nvel
{TagLevel}.
Value
Deve-se associar um nico valor a cada mensagem. Durante o
runtime, o objeto exibir a mensagem associada com o valor que ai de
encontro ao valor do tag configurado no campo Read Tag. Caso no
exista tal mensagem, a mensagem configurada na primeira linha
(State = Error) ser exibida durante o runtime. Quando o Tipo de
objeto est configurado para Multistate PushBoto, o valor associado
a mensagem atual tambm registrado ao tag configurado no campo
Write Tag (caso exista).
Text (FG)
Cor de primeiro plano para as mensagens exibidas durante o
runtime.
Text (BG) Cor de fundo para as mensagens exibidas durante o runtime.
Text Blink Caso habilitado, o texto da mensagem piscar durante o runtime.
Rec (FG) Cor da linha (Borda) do retngulo abaixo da mensagem.
Rec (BG) Cor de fundo (Preencchimento) do retngulo abaixo da mensagem.
Rec Blink
Quando habilitado, o retngulo abaixo da mensagem piscar durante
o runtime.
Graphic File
Caminho e nome do arquivo bitmap (*.BMP) (caso exista) que ser
exibido quando a mensagem associada a ele selecionada durante o
runtime. Caso o caminho no seja especificado, o arquivo bitmap
dever ser armazenado no diretrio da aplicao.
Transparent
Selecione a cor que ser transparente no arquivo do grfico, caso o
check-box En. Transparent esteja habilitado.
En.
Transparent
Quando habilitado, a cor selecionada no campo Transparent ser
configurada para transparente no arquivo do grfico.

Nota:
As propriedades Graphic File, Transparent e En. Transparent no esto disponveis
para o tipo Message Display.

D Dica:
Pode-se copiar dados a partir desse dilogo e cola-los em uma planilha Excel e vice-
versa.

Formato do arquivo de origem
Essa seo descreve o formato do arquivo de texo suportado pelo objeto Smart Message quando
Data Source = Text File. A principal vantagem da utilizao de um Arquivo de Texto externo em
lugar de Valores Estticos, que o primeiro promove a flexibilidade para alterao de mensagens
durante o runtime, apontando-se para um Arquivo de Texto distinto ou mesmo alterando-o
dinamicamente.
O Arquivo Texto dever ser criado em formato CSV (vrgula separando valores), onde o caractere
vrgula (,) utilizado para dividir as colunas (dados) em cada linha do arquivo. Portanto, pode-se
utilizar qualquer Editor CSV, como Microsoft Notapad e Microsoft Excel para criar o arquivo CSV
com as mensagens e propriedades para o objeto Smart Message.
A Descrio de cada propriedade associada s mensagens fornecida na seo Smart Message. A
ordem dos dados no arquivo CSV descrita na tabela abaixo:

Coluna # Propriedade Valor Padro
1 Text/Message -
2 Value -
IWS 20/06/2007

InduSoft Web Studio

Pgina 258
3 Text (FG) 0
4 Text (BG) 16777215
5 Text Blink 0
6 Rec (FG) 8421376
7 Rec (BG) 16777215
8 Rec Blink 0
9 Graphic File -
10 Transparent 0
11 En. Transparent 0

Ao configurar mensagens de texto que contenham o caractere vrgula como parte da mensagem,
deve-se configurar toda a mensagem entre aspas (e.x. Warning, Turn the motor Off); do contrrio,
a vrgula ser interpretada como um separador de dados ao invs de uma parte da mensagem.
A primeira linha desse arquivo equivalente a State = Error. Em outras palavras, caso no exista
mensagem associada ao valor do tag atual configurado no campo Read Tag, a mensagem
configurada na primeira linha (State = Error) ser exibida durante o runtime.
Os dados configurados na coluna Value column da primeira linha desse arquivo irrelevante. Tal
linha dever ser sempre configurada, apesar do tipo do objeto (mesmo para PushButton Multistate).
Somente as colunas Text/Message e Value so mandatrias. As outras colunas so opcionais, e os
valores padro sero utilizados caso voc no especifique um valor (veja a tabela).
Os campos Text(FG),Text(BG),Rec(FG),Rec(BG) e Transparent podem ser configurados com o cdigo
da cor a ele associada. O cdigo pode ser inserido diretamente em formato decimal (e.x. 255) ou
hexadecimal, utilizando a sintaxe #value (e.x. #0000FF).
Os campos Text Blink, Rec Blink e En. Transparent podem ser configurados com valores Booleanos
0 ou 1 (0 = No habilitado; 1 = Habilitado), ou com as palavras-chave FALSE ou TRUE (FALSE =
No 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

D Dica:
Pode-se utilizar o editor Smart Message (Data Source = Static) para a configurao de
mensagens, valores e cores. Para tanto, selecione a configurao, copie e cole em uma
planilha Excel worksheet como um arquivo CSV (File > Save As). Tal procedimento
promove uma utilizao amigvel da interface para o usurio na configurao de
cdigos de cores.

Boto PushButtons ( ): Clique para criar um objeto pushbutton com a utilizao da
propriedade do objeto dinmica Command para um objeto ou pushbuttons pr-configurados.
O IWS fornece os seguintes tipos de boto pr-configurados, todos os quais imitam os botes de
painel padro de um mesmo nome:
Momentary (padro): Altera estado (Open ou Closed) ao pressionar o boto, e reverte para o estado
inicial quando solta-se o boto. Esse tipo de boto sempre exibido em sua posio normal quando
uma tela est sendo criada.
IWS 20/06/2007

InduSoft Web Studio

Pgina 259
Maintained: Altera estado (Open or Closed) ao pressionar o boto, embora no reverta seu estado
inicial ao soltar o boto. Deve-se pressionar o boto novamente para alterar o estado atual. Esse
tipo de boto mantm seu estado atravs das alteraes da tela.
Latched: Altera estado (Open ou Closed) ao pressionar o boto e permanece nese estado at que
voc o libere, alterando o tag Reset.
O IWS tambm fornece os seguintes estilos de botes:
Retangular com uma face e luz indicadora
Retangular sem uma face ou lua indicadora (padro)
Retangular com 3-D
Retangular com aparecncia flutuante
Para adicionar um ou mais botes pr-configurados a uma tela:
Clique no boto Pushbutton e posicione o mouse (apontador) na tela.
Clique e arraste para criar/ajustar o tamanho do boto Retangular.
O tamanho do Boto e as caractersticas da fonte de texto determinam quanto texto poder
ser exibido, alm do tamanho da rea de uma tela que poder ser tocada em uma touch
screen. Pode-se redimensionar o boto e alterar as caractersticas da fonte posteriormente,
permitindo assim que mensagens mais longas sejam exibidas em um espao especfico.

Object Properties: Pushbuttons
D Dica:
De forma alternativa, clique com o boto direito ou selecione o objeto, pressione as
teclas Alt+Enter e selecione Properties a partir do menu pop-up resultante para
abrir o dilogo Object Properties.

Lista drop-down Type: Clique para selecionar o tipo de pushbutton (Momentary (padro),
Maintained, ou Latched).
Lista drop-down State: Clique para especificar um estado padro para o pushbutton (Normally
Opena (padro) ou Normally Closed).
Clique no boto para inverter entre os estados padro e no padro (de acordo com seu
Tipo especificado). Por exemplo, no estado inicial do boto, poder estar de acordo com as
caractersticas Especificadas na rea Open do dilogo Configuration (veja abaixo). Clique no
boto novamente para inverter para seu estado oposto, que nesse exemplo mostra-se como
Closed, e de acordo com as caractersticas Especificadas na rea Closed.
text box Tag/Exp: Digite um tag ou expresso para realizar o seguinte:
IWS 20/06/2007

InduSoft Web Studio

Pgina 260
* Digite um tag para receber Write Value a partir do estado na rea apropriada (Open ou
Closed) no dilogo Configuration.
* Digite uma expresso para executar On Down, ao pressionar o pushbutton.
Nota:
O IWS no registra o resultado de qualquer expresso no campo Tag/Exp
para um tag.

text box Indicator: Digite um tag para definir um indicador que faz o boto alterar para uma cor
Especificada quando o valor do tag altera-se para dois dos valores Especificados. Deve-se
definir cores e valores de tag no dilogo Configuration. Caso voc deixe esse campo em branco, o
indicador alterar a cor automaticamente ao pressionar o boto.
check-box E-Sign: Selecione (habilite) essa opo para requisitar o usurio a inserir a
text box Reset (ativo somente para tipo pushbutton Trancado): Digite um tag para controlar o
estado trancado do boto, como se segue:
* Digite zero no valor do tag e o boto permanecer em um estado trancado aps voc
pression-lo.
* Digite um valor diferente de zero para um tag e um boto trancado tornar-se
destrancado aps pression-lo. Deve-se reiniciar o valor do tag para zero antes de poder
pressionar o boto novamente.
rea Key: Especifica uma tecla do teclado ou cria uma tecla de combinao para inverter um
pushbutton quando no se tm equipamento de apontamento (mouse ou touch screen) ou caso
voc queira criar teclas de atalho em adio a pushbuttons.
Lista drop-down Key: Digite uma tecla no text box ou seleicone uma tecla no numrica da lista
drop-down. Insira um caractere nico ou somente uma tecla. Nmeros no so entradas
vlidas para esse campo.
Clique (habilite) no box Shift, Ctrl, ou Alt para criar uma tecla de combinao, significando que
as teclas Shift, Ctrl, ou Alt devem ser pressionados com a tecla especificada na lista drop-down.
Clique (habilite) no box para abrir o dilogo Key Modifier, que habilita a modificao de suas
combinaes de teclas. Pode-se escolher Left, Right ou Left or Right para especificar a posio
no teclado das teclas Shift, Ctrl ou Alt na combinao de teclas. Caso voc escolha Left or
Right, o comando ser executado a qualquer momento que essas teclas forem pressionadas em
combinao com a tecla especificada na lista drop-down.

Dilogo Key Modifier

IWS 20/06/2007

InduSoft Web Studio

Pgina 261
text box Disable: Digite um tag utilizando um valor defirente de zero para desabilitar esse
pushbutton. Assim, pressionar esse boto no surtir efeito algum. Esse box est vazio por
padro, o qual habilita a propriedade command.
check-box Ext Trans.: Clique (habilite) para traduzir o texto automaticamente, utilizando-se das
planilhas de traduo pr-configuradas.
text box Security: Digite um valor para especificar um nvel de segurana (0 a 255) para esse
boto. Caso o usurio no tenha o nvel de segurana especificado, o boto torna-se inativo.
Caso o usurio tenha o nvel de segurana apropriado ou deixar esse campo em branco, o boto
permanecer ativo.
Boto Config: Clique para abrir o dilogo Configuration, o qual permite a especificao dos
parmetros de estilo e estado para o pushbutton:

Dilogo Configuration
Esse dilogo fornece os seguintes parmetros:
combo-box Style: Clique no boto do combo-box para selecionar o estilo de um pushbutton
(Rectangle (padro) ou Rectangle with Indicator).
combo-box Effect: Clique para selecionar um efeito 3-D para o pushbutton.
* Floating (padro): Botes assemelham-se a um objeto flat com uma sombra
* 3D: Botes tm limites no nivelados e parecem mergulhar na tela quando
pressionados.
Pode-se utilizar os parmetros Style e Effect em combinao para criar quatro botes
diferentes, como mostrado nas figuras abaixo:

Estilos de Pushbutton
Align: Especifica o alinhamento para a captao do pushbutton.
IWS 20/06/2007

InduSoft Web Studio

Pgina 262
box Boto Color: Clique para especificar uma cor padro para a rea do boto de um um objeto
pushbutton que inclui um indicador e uma faceplate. Quando o dilogo Color aparecer, clique
em uma cor para selecion-la e depois feche o dilogo.
box Legend Plate Color: Clique para especificar ou alterar uma cor padro para a rea de
legenda de um objeto pushbutton que inclui um indicador. Quando o dilogo Color aparecer,
clique em uma cor para selecion-la e depois feche o dilogo.
Uma legenda possui um boto e uma luz indicadora . Esse campo torna-se inativo caso o Estilo
do pushbutton no inclua um indicador.
reas Open e Closed: Os parmetros a seguir so utilizados para configurao da aparncia de
um objeto pushbutton, bem como seus possveis estados: aberto e fechado.
box Color: Clique para especificar uma cor padro para um indicador em cada Estado. Quando
o dilogo Color aparecer, clique em uma cor para selecion-la e depois feche o dilogo.
Caso voc tenha selecionado um estilo de pushbutton que no inclua um indicador, pode-se
utilizar esse campo para especificar uma cor de boto para cada Estado.
combo-box Blink: Clique para especificar se a cor escolhida no box Color capaz de piscar e
qual a sua freqencia para cada estado (None (sem piscar, padro), 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 boto).
text box Caption: Utilize esse text box para inserir uma captao do boto. De forma
alternativa, pode-se utilizar a legenda, caso o estilo do boto inclua um indicador.
Boto Fonts: Clique para abrir o dilogo Font, o qual pode ser utilizado para especificar ou
alterar as caractersticas da fonte da mensagem para cada estado.
combo-box Text Blink: Clique para especificar se o texto especificado dever piscar e a
freqencia com que dever piscar para cada estado (None (sem piscar, padro), Slow, e Fast).
Ao contrrio de uma cor piscante, o texto aparecer piscando, aparecendo e desaparecendo.
combo-box Write Value: Clique para selecionar um valor no campo. Quando o pushbutton est
no estado apropriado (Open ou Closed), o IWS registra esse valor para o tag especificado no
campo Tag/Exp (dilogo Object Properties).
Boto ActiveX Control ( ): Clique para abrir o dilogo Insert ActiveX Control, o qual poder ser
utilizado para a colocao de componentes ActiveX em sua tela.
O dilogo que se abre (como na figura abaixo) contm uma lista de todos os componentes ActiveX
registrados em seu computador.

Dilogo Insert ActiveX Control
Clique em um ou mais componentes da lista e depois clique em OK para fechar o dilogo e exibir todos os
componentes selecionados em sua tela.
IWS 20/06/2007

InduSoft Web Studio

Pgina 263
Controles ActiveX so componentes projetados de acordo com um padro. 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: Variveis das quais os valores podem ser lido e/ou registrados para a aplicao (e.x.
Object Color, FileName, URL, etc)
Methods: Funes do objeto ActiveX que podem ser diparadas pela aplicao (e.x. abrir um
dilogo, executar um clculo, etc)
Events: Mensagens internas que podem disparar a execuo de expresses na aplicao (e.x.
Mouse_Click, Download_Completed, etc)
O nome das propriedades, mtodos e eventos suportados por cada objeto ActiveX dependem de sua prpria
implementao.
Existem dois modos distintos para estabelecer interface entre a aplicao e o controle ActiveX:
Utilizando as Funes do ActiveX XGet(), XSet() e XRun()
OU
Utilizando a janela Object Properties para configurao do objeto
C Ateno:
Ao utilizar controles ActiveX em sua Aplicao, certifique-se de que a target
station (estao runtime) tenha o mesmo ActiveX, registrado da forma
apropriada. Os arquivos da aplicao do IWS incluem links para os
contoles ActiveX; entretanto, a instalao desses controles na target station
devero ser executadas manualmente. Alm disso, quando controles
ActiveX so utilizados em telas abertas em Web Thin Clients remotos, os
controles ActiveX devero tambm ser instalados manualmente nas Web
Thin Client stations. Consulte o fornecedor de seu ActiveX para maiores
informaes sobre instalao.
Ao Configurar Aplicaes com ActiveX para CEView, certifique-se de que o
controle ActiveX utilizado na Aplicao suportado na plataforma (sistema
operacional Windows CE e tipo de processo) onde voc pretende rodar a
aplicao. Consulte seu fornecedor do ActiveX para maiores informaes
sobre as plataformas suportadas.
Clique duas vezes no controle ActiveX para abrir o box de dilogo Object Properties.

Object Properties: ActiveX Control
A janela Object Properties exibe o nome do controle ActiveX. Geralmente, cada controle ActiveX pode ser um
arquivo *.dll ou *.ocx registrado em seu computador local. Deve-se assinalar um nome (alias) para o
controle ActiveX da aplicao no campo Name (e.x. MyControl). Esse nome ser utilizado como referncia ao
objeto ao configurar as funes ActiveX a partir da linguagem do IWS.
IWS 20/06/2007

InduSoft Web Studio

Pgina 264
Nota:
No deve-se configurar dois controles ActiveX em uma mesma tela e com um
mesmo nome. Por exemplo, caso voc insira dois controles ActiveX Windows
Media Player em uma mesma tela e nomear um objeto como MyMP1 (Name
field), voc no poder colocar o mesmo nome no Segundo objeto dessa mesma
tela. Voc dever nomear o segundo objeto como MyMP2, por exemplo.
O boto Property Pages abre a janela padro para a configurao de Propriedades Estticas (caso exista). O
layout e as opes nessa janela de dilogo dependem da implementao de cada controle ActiveX. Utilize
essa interface para configurar propriedades que no devero ser alteradas durante o runtime (propriedades
fixas).
O boto Configuration na janela Object Properties abre dilogos que permitem:
Associar tags a propriedades do objeto ActiveX
Disparar mtodos do objeto ActiveX baseados em alterao de tag
Configurar scripts, os quais so executados quando ocorrem Evento do objeto ActiveX
As sees a seguir descrevem como configurar tais interfaces.
Notas:
Embora o dilogo Configuration exiba a lista de todas as propriedades,
mtodos e eventos, somente os itens necessarios para seu projeto devero
ser configurados.
Os tpicos de tela utilizados nas sees a seguir dizem respeito ao controle
ActiveX Windows Media Player. Embora nomes de propriedades, mtodos e
eventos variem dependendo de cada controle ActiveX, a interface de
configurao a mesma para qualquer controle ActiveX. Os conceitos
descritos aqui so aplicados a todos eles.

Configurando Propriedades
O tab Properties fornece uma grade com os seguintes campos:
IWS 20/06/2007

InduSoft Web Studio

Pgina 265

Dilogo Configuration Tab Properties

Property: Lista todas as propriedades disponveis no objeto ActiveX, alm de indicar seus tipos:

cone
da
Prop
rieda
de
Tipo de
proprie
dade

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 ocorrncias).
Nota:
Pode-se configurar uma expresso nesse campo caso voc deseje registrar o
resultado de uma expresso para a propiedade do objeto ActiveX. Porm, nesse
caso, o valor da propriedade no ser lido de volta a um tag (a menos que se utilize
da funo XGet()). Portanto, quando uma expresso configurada nesse campo, o
campo Scan ser automaticamente configurado para Set.
Action: Define a direo da interface entre o tab ou expresso configurados no campo Tag/Expression e a
propriedade do ActiveX de acordo com a tabela a seguir:
Ao Descrio
Get
L o valor da propriedade
IWS 20/06/2007

InduSoft Web Studio

Pgina 266
ActiveX e registra-os ao
tag configurado no campo
Tag/Expression.
Set
Registra o valor do tag ou
expresso configurada no
campo Tag/Expression
para uma propriedade do
ActiveX.
Get+Set
Executa ambas as aes
(Get e Set). Porm, ao abrir
uma tela com o objeto
ActiveX, o IWS executa o
comando Get antes de
executar qualquer
comando Set. O tag
configurado no campo
Tag/Expression ser
atualizado com o valor da
propriedade ActiveX
quando o IWS abre a tela
onde o ActiveX est
configurado.
Set+Get
Executa ambas as aes
(Get e Set). Porm, ao abrir
uma tela com o objeto
ActiveX, o IWS executa o
comando Set antes de
executar qualquer
comando Get. A
propriedade ActiveX ser
atualizada com o valor do
tag configurado no campo
Tag/Expression quando o
IWS abre a tela onde o
ActiveX est configurado.

Nota:
Quando o valor da propriedade est como "Somente Leitura" (No pode ser
modificado pela aplicao), o campo Action automaticamente configurado para
Get.
Scan: Define a efetuao do mtodo polling para obteno de valores a partir das propriedades do ActiveX,
de acordo com a seguinte tabela:
Scan Descrio
No
O valor da propriedade
ActiveX lido e registrado
ao tag configurado no
campo Tag/Expression,
onde somente a tela com o
objeto ActiveX est aberta,
e quando o objeto ActiveX
IWS 20/06/2007

InduSoft Web Studio

Pgina 267
envia uma mensagem para
que o IWS atualize esse tag.
Always
O IWS mantm a efetuao
de polling do valor da
propriedade do ActiveX e
atualiza o valor do tag
configurado no campo
Tag/Expression com esse
valor.

Nota:
Alguns controles ActiveX so projetados para enviar mensagens a seus containeres
(Aplicao), indicando que uma propriedade alterou valor e o novo valor dever ser
lido (Get) novamente. Porm, outros controles ActiveX no implementam esse
algortmo. Nesse caso, o nico meio para obteno dos valores atualizados das
propriedades ActiveX manter o polling desses valores a partir do controle ActiveX
(Scan=Always).

Configurando Mtodos
Methods fornece uma grade com os seguintes campos:

Dilogo Configuration Tab Methods
Method: Lista todos os mtodos disponveis a partir do objeto ActiveX.
Parameters: Os tags configurados nesse campo so associados com os parmetros do mtodo
correspondente ao objeto ActiveX. Caso o mtodo no suporte parmetro algum, o texto fixo <None>
exibido no campo Parameters. Do contrrio, pode-se digitar os tags associados nos parmetros do objeto
ActiveX. Quando o mtodo possui mais de um parmetro, pode-se digitar um tag para cada parmetro,
separando-os por uma vrgula (,). Por exemplo, TagA , TagB , TagC. Quando o mtodo executado, os
valores do tag so registrados aos parmetros do mtodo (parmetros de entrada), ou, aps a execuo do
mtodo, o ActiveX registrar o valor dos parmetros para o tag (parmetros).
IWS 20/06/2007

InduSoft Web Studio

Pgina 268
= Dica:
Ao clicar no boto Browse ( ), aparecer uma lista de parmetros suportados pelo
mtodo, permitindo a associao de um tag a cada parmetro.
Trigger: Quando o tag configurado nesse campo altera seu valor, o respectivo mtodo do controle ActiveX
executado.
Return: O tag configurado nesse mapo recebe o valor de retorno pelo mtodo (caso exista).
Configurando Events
O tab Events fornece uma grade com os seguintes campos:

Dilogo Configuration Tab Events
Event: Lista todos os eventos disponveis no objeto ActiveX.
Parameters: Os tags configurados nesse campo so associados a parmetros do evento correspondente ao
objeto ActiveX. Caso o evento no suporte qualquer parmetro, o texto fixo <None> exibido no campo
Parameters. Do contrrio, pode-se digitar os tags associados aos parmetros do objeto ActiveX. Quando e
evento possui mais de um parmetro, pode-se digitar um tag para cada parmetro, separando-se por uma
vrgula (,). Por exemplo, TagA , TagB , TagC. Quando o evento gerado, o valor dos tags so registrados aos
parmetros do evento (parmetros de entrada), ou os valores do parmetros so registrados para os tags
(parmetros de sada).
= Dica:
Ao clicar no boto Browse ( ), aparecer a lista de parmetros pore le suportados,
permitindo a associao de um tag com cada parmetro.
Script: O script configurado nesse campo ser executado quando o evento for disparado pelo controle
ActiveX.
IWS 20/06/2007

InduSoft Web Studio

Pgina 269
= Dica:
Ao clicar no boto Browse ( ), aparecer um dilogo com o script completo
associado ao evento. A janela de dilogo principal exibe somente a expresso
configurada na primeira linha do script.

Boto Combo-Box ( ): Clique para selecionar um nome nico a partir da lista de nomes do
combo-box.
Caso a lista seja maior que o espao delimitado, o IWS habilita uma barra de rolagem para a lista. Durante
o runtime, selecionando um nome da lista do combo-box se ocultar, e o nome selecionado ser exibido no
combo-box.
Clique duas vezes no objeto combo-box para abrir o dilogo Object Properties:

Object Properties: Combo-Box
Pode-se utilizar esse dilogo para configurar os seguintes parmetros:
combo-box Align: Clique para especificar o nome do alinhamento (Left, Center, ou Right) que
afeta o alinhamento tanto na lista quanto em seu combo-box.
text box Position/Index: Digite um tag integer, o qual corresponde ao nome atualmente exibido
no combo-box. Alterar o valor desse tag alterar o nome a ser exibido.
text box Label: Digite um tag string para receber o valor do nome atualmente exibido no combo-
box.
check-box Input Enabled: Clique (habilite) para permitir que um operador selecionando um
nome digitando os contedos desse nome em um tag no campo Label.
check-box Confirm: Clique (habilite) para requisitar ao operador a confirmao de um comando
durante o runtime.
check-box E-Sign: Clique (habilite) para requisitar ao usurio a insero da Assinatura
Eletrnica antes de executar o dinmico.
Campo VK: tipo de Virtual Keyboard utilizado para esse objeto. Voc precisar habilitar a opo
Virtual Keyboard na interface Project Settings Runtime Desktop antes de configurar o
Virtual Keyboard para essa interface.
box Color: Clique para especificar uma cor de fundo para o combo-box. Quando o dilogo Color
abrir, clique em uma cor para selecion-la e depois clique em OK para fechar o dilogo.
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 (padro) para habilitar a propriedade Command.
Caso voc desabilite o combo-box, este aparecer em cinza durante o runtime.
text box Security: Digite um nvel de segurana para o comando (0 a 255). Caso um operador
efetue log on e no possua o nvel de segurana especificado, o comando se tornar inativo.
IWS 20/06/2007

InduSoft Web Studio

Pgina 270
Caso um operador efetue log on, no possua o nvel de segurana especificado oudeixe esse
espao em branco, a propriedade Command permanece ativa.
Boto Fonts: Clique para abrir o dilogo Font. Utilize esse dilogo para alterar as caractersticas
da fonte de uma mensagem.
Boto Data...: Clique para abrir o dilogo Combo Data, o qual permite a definio de nomes e
suas ordens dentro do combo-box.

Dilogo Combo Data
Utilize os parmetros no dilogo Combo Data como se segue:
Type: Especifica a utilizao de Array of labels ou static list of labels para definir o combo-box.
Sort: Clique (habilite) para exibir os contedos de seu tag array de nomes em ordem alfabtica.
Esse parmetro est disponvel somente ao selecionar o tipo Array Tag.
Array Tag: Digite um tag name para uma string tipo tag array contendo os valores do nomes no
combo-box.
Number of Items: Digite em um integer ou um tag para especificar quantos nomes podero ser
exibidos no combo-box. Mantenha em mente que o combo-box conta array index 0 como
primeiro item. Caso voc especifique quatro nomes array, o combo-box exibira array index 0 e
array index 3 somando um total de quarto nomes.
Drop list size (Items): Digite em um integer ou um tag para especificar quantos nomes podero
ser visualizados no combo-box a qualquer momento.
Combo Static Labels List: Especifica o parmetro 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 posio 0. O nome na linha seguinte est na posio 1e
assim por diante.
Boto Alarm ( ): Clique para especificar uma rea da tela na qual exibir mensagens de
alarme.
A seguir, clique na tela e arraste o mouse para designar uma rea para mensagens. Ao terminar, clique
duas vezes no objeto para abrir o dilogo Object Properties:
IWS 20/06/2007

InduSoft Web Studio

Pgina 271

Object Properties: Alarm
Boto On Line: Clique (habilite) nesse Boto para exibir mensagens de alarme online para o
objeto.
Boto History: Clique (habilite) nesse Boto para exibir mensagens de alarme de arquivos
histricos.
C Ateno:
Voc dever utilizar a opo Save to Disk, localizada na planilha Alarm (Tab
Tasks), para salvar mensagens de alarme especificadas como arquivos
histricos.

combo-box Border: Clique para definir uma cor para as bordas da mensagem de alarme.
Quando o dilogo Color aparecer, clique em uma cor para selecion-la e depois feche o dilogo.
combo-box Win: Clique para definir uma cor de fundo para o dilogo Alarm Message. Quando o
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 parmetros para definir um formato para mensagens
de alarme. Pode-se formatar alarmes para que incluam datas, horrios (horas), nomes, tags e
mensagens.
Boto Font: Clique para abrir o dilogo Fonts e Especificar um estilo, tamanho, cor e tipo de
fonte para o texto da mensagem de alarme.
check-boxes DD,MM,YY: Clique (habilite) para exibir a data do alarme no texto da mensagem.
check-boxes HH,MM,SS,MSS: Clique (habilite) para exibir o horrio do alarme no texto da
mensagem.
Nota:
Caso voc habilite os boxes DD,MM,YY e/ou HH,MM,SS,MSS, o caractere
asterisco (*) ser exibido entre data/hora do alarme e mensagem do alarme.

Campo Tag: Especifica quantos caracteres so permitidos para um nome de tag.
Campo Message: Especifica quantos caracteres so permitidos para uma mensagem.
check-box Ack: Clique (habilite) para adicionar a hora de reconhecimento de uma mensagem de
alarme.
check-box End: Clique (habilite) para adicionar o horrio de normalizao mensagem de
alarme.
IWS 20/06/2007

InduSoft Web Studio

Pgina 272
Boto Selection: Clique para abrir o dilogo Alarm Filters, o qual permite a especificao de
filtros para as mensagens de alarme.

Dilogo Alarm Filters
Utilize os seguintes parmetros para especificar esses filtros:
Campo Group: Insira um valor para selecionar e exibir grupos de alarme no objeto alarm
summary.
* Insira zero no campo para selecionar todos os grupos de alarme.
* Insira qualquer valor diferente de zero para selecionar um grupo de alarme especfico.
Campo Selection: Digite a string de caractere especificado na coluna Selection na planilha
Alarm (tab Tasks). O IWS filtra alarmes de exibio, 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.

D Dica:
Caso voc insira a string de caractere entre colchetes ({ }), pode-se modificar o
valor do tag durante o runtime.

Campos Priority Range: Especifica uma escala (baseada na prioridade do alarme,
Especificada na coluna priority da planilha Alarm) o qual filtra e exibe mensagens de
alarme.
Por exemplo, caso voc assinale prioridades de alarme de 1 A 5 na planilha Alarm, e depois
assinalar de 0 a 4 nesses campos Priority Range, o IWS exibir prioridades de alarme de 1 a
4 e no exibir a prioridade 5.
rea Sort: Utilize os radio buttons para especificar e exibir mensagens de alarme como se
segue:
Time: Clique (habilite) nesse boto para especificar alarmes de acordo com o horrio no
qual o alarme foi recebido.
Priority: Clique (habilite) nesse boto para especificar e exibir alarmes de acordo com as
propriedades assinaladas nos campos Priority Range.
IWS 20/06/2007

InduSoft Web Studio

Pgina 273
Print Tag: Digite um tag name para filtrar e imprimir todos os alarmes, quando alteraes
so efetuadas ao tag.
Campo Ack Tag: Digite um tag name para filtrar e reconhecer o alarme ativo (na parte
superior da lista do objeto alarm) quando voc altera o tag.
D Dica:
Pode-se utilizar o tag interno AckAlr para reconhecer o ltimo alarme da
Aplicao.

Campo Ack All Tag: Digite um tag name para reconhecer todos os alarmes ativos e filtrados
ao alterar o tag.
D Dica:
Pode-se utilizar o tag interno AckAll para reconhecer todos os alarmes da
Aplicao.

Campo View %: Digite um tag nesse campo (Especifique um tag de 0% a 100%) para
controlar quantas mensagens de alarme esto visveis na lista alarm durante o runtime.
Tambm Pode-se utilizar esse tag para rolar a lista para cima e para baixo durante o
runtime.

Lista Alarms com barra de rolagem
Boto Grid ( ): O objeto Grid permite a leitura/registro de dados em um formato tabular a
partir da data source configurada no objeto. Para desenhar, faa o seguinte:
E Clique na ferramenta Grid.
E Clique na tela, clique no Boto esquerdo do mouse, e arraste o mouse pela tela para criar
um box do tamanho desejado (enquanto segura o boto do mouse).
E Solte o boto do mouse, e o o objeto Grid aparecer.

Criando um Objeto Grid
IWS 20/06/2007

InduSoft Web Studio

Pgina 274
E Clique com o boto direito no objeto Grid e selecione Properties do menu. O dilogo Object
Properties abrir. Utilize esse dilogo para configurar os parmetros do Objeto Grid:

Object Properties: Grid Object
Data Source: Selecione o tipo de dados de origem. O objeto suporta trs origens de dados:

Data
Source
Descrio
Text File
Exibe dados de um arquivo texto em formatos ASCII ou Unicode (e.x.
arquivos CSV).
Class Tag
Exibe valores de um Tag Class, onde os membros do tag so campos
(colunas) do objeto grid, e cada posio de array uma linha no
objeto grid.
Database
Exibe dados de um Banco de Dados Relacional SQL Relational
Database, utilizando ADO (objeto ActiveX Database) para trocar
dados com o banco de dados.

E-Sign: Ao habilitar essa opo, o usurio ser requisitado a inserir a assinatura eletrnica
antes de inserir ou modificar dados no objeto.
VK: Selecione um tipo de Virtual Keyboard utilizado para esse objeto. A opo <Use default>
seleciona o Virtual Keyboard padro configurado no desktop da interface Project Settings
Runtime. Tambm Pode-se especificar um virtual keyboard diferente para esse ObjetoGrid.
Security: Insira o nvel de acesso ao sistema de segurana requisitado para o objeto/dinmico.
Disable: Pode-se inserir uma expresso nesse campo para desabilitar entrada de dados ou
aes pelo usurio.
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 dilogo Fonts, onde voc pode estabelecer as configuraes de fonte
para o texto a ser exibido no objeto Grid.
Columns: Clique para iniciar o dilogo Columns, onde voc pode estabelecer as condiguraes
(como nome, coluna, largura, etc.) para as colunas do objeto Grid.
Pode-se configurar os parmetros para cada coluna exibida pelo objeto Grid durante o runtime, como se
segue:

IWS 20/06/2007

InduSoft Web Studio

Pgina 275

Dilogo Columns
* Column: O Nmero ID define a posio da coluna na tabela.
* Label: Insira um Ttulo para cada coluna, a qual ser exibida como cabealho (first) no
objeto Grid.
* Field: Insira o nome do campo (coluna) no Banco de Dados SQL Relacional ao qual o
objeto Grid vinculado. Caso esse campo seja deixado em branco, o texto configurado
no campo Label ser utilizado como Field. (Tal configurao est disponvel somente
quanto o tipo de Data Source est configurado para o Banco de Dados.)
* Type: Selecione o tipo de interface que ser utilizada na coluna. As opes so:

Type Descrio
Text Exibe valores alfanumricos
Numeric Exibe valores numricos
Picture Exibe a figura (formato *.bmp ou *.ico) do data source.
Por exemplo, caso o valor do data source seja
MyFile.bmp, o objeto grid exibir a figura do arquivo
MyFile.bmp armazenado na pasta da aplicao. A figura
ser automaticamente redimensionada para adaptar-se
clula do objeto grid. O arquivo(s) da figura devero ser
armazenados na subpasta \Web da aplicao para
suportar esse recurso em Web Thin Client stations.
Aplicaes em CEView suportam figuras em formato
bitmap (*.bmp), mas no 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 contrrio, o check-box estar habilitado.
Por padro, o IWS utilizar o valor 0 para desabilitado e
1 para habilitado.
Time Exibe o valor em formato Time (e.x. HH:MM:SS). Essa
configurao est disponvel somente quando o tipo de
Data Source est configurado para Banco de Dados.
IWS 20/06/2007

InduSoft Web Studio

Pgina 276
Date Exibe o valor em formato Date (e.x. MM/DD/YYYY). Essa
configurao est disponvel 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 configurao est disponvel somente
quando o tipo Data Source est configurado para Banco
de Dados.

Notas:
Quando o tipo Data Source est configurado para Database,
importante certificar-se de que o Tipo para cada coluna configurada no
objeto adapte-se ao Tipo do campo respectivo no banco de dados.
Quando o tipo Data Source est configurado para Database, pode-se
configurar demonstraes SQL vlidas diretamente no Campo (e.x.
List(DISTINCT [Cell_Name]) AS [Cell Name]). Tambm Pode-se
configurar os tag names entre colchetes para modificar essa
configurao durante o runtime (e.x. {MyFieldName}).

D Dica:
Caso Picture seja um tipo de coluna, o objeto Grid exibe um cone padro ( )
caso o arquivo da figura no seja encontrado durante o runtime. Pode-se
configurar uma figura diferente a ser exibida quando o arquivo no for
encontrado, copiando-se o arquivo da figura para a subpasta \Web da
Aplicao e configurando seu nome no arquivo <AplicaoName>.APP, como
se segue:
[Objects]
GridPatternPicture=<PictureFileName>

* Width: Insira a largura da coluna, em pixels.
* Align: Selecione um alinhamneto para os dados exibidos na coluna. Existem trs opes:
Left, Right ou Center.
* Input: Habilite para permitir ao usurio inserir dados nessa coluna durante o runtime.
* Key: Designa um atalho para valores Especificados nesse campo. Um atalho uma
combinao de teclas pressionadas ao mesmo tempo no teclado (e.x. CTRL + C, CTRL +
V, etc.). Essa opo especialmente til ao criar Aplicaes para equipamentos de
runtime que no fornecem um mouse ou interface touch-screen, possuindo somente o
teclado para interao durante o runtime.
Nota:
Quando o tipo Data Source est configurado para Class Tag, e o dilogo
Columns deixado em branco, o objeto exibe os valores de todos os
membros do Class Tag com as seguintes configuraes padro 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 nmero de cada linha automaticamente.
* Allow sorting columns: Habilite para que o usurio possa Especificar os valores nas
colunas durante o runtime, clicando no nome ou utilizando um atalho, configurado para
cada coluna. Essa opo estar desabilitada caso a opo Show header do dilogo
Advanced no estiver habilitada.

D Dica:
Utilize os botes Move Up e Move Down para reordenar a exibio das
colunas.

Data: Clique para iniciar o dilogo Data, onde voc poder especificar uma data source (data
source) para o objeto Grid.
Esse dilogo permite a configurao de parmetros para data source, como se segue:
* Data Source Text File
Quando o tipo Data Source configurado para Text File, pode-se configurar os seguites
parmetros:

File: Insira o nome da origem do arquivo de texto. Pode-se digitar o nome do
arquivo e seu caminho ou clicar no boto para a pesquisa. (Caso o arquivo
seja armazenado na pasta da aplicao, pode-se omitir o caminho.)
Delimiters: Configura o delimitador(es) utilizados no arquivo de data source. Por
exemplo, caso os dados sejam lidos a partir de um arquivo CSV (valores
separados por vrgulas), voc dever selecionar a opo Comma. Tambm Pode-se
escolher um delimitador personalizado, habilitando a opo Other e digitando o
delimitador personalizado no campo logo acima.

D Dica:
Pode-se configurar tag names entre colchetes {TagName} no campo File.
IWS 20/06/2007

InduSoft Web Studio

Pgina 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. (No especifique um
membro especfico do tag classe.) Pode-se especificar a posio inicial do array
nesse campo (e.x. Mytag[10]); do contrrio, 0 (zero) ser utilizado, por padro,
para a posio.
Number of Items: Insira o nmero de posies do array para o Class Tag que
dever ser exibido.
View: Quando tag configurado no campo opcional altera seu valor (e.x. inverte-se)
durante o runtime, o objeto grid inicia um dilogo, permitindo que o usurio
mostre/oculte ou modifique posies.

* Data Source Database
Quando o tipo de Data Source type configurado para Database, pode-se configurar os
seguintes parmetros:
IWS 20/06/2007

InduSoft Web Studio

Pgina 279

Leia: Janela de Dilogo Database Configuration para maiores informaes sobre esse
dilogo.
Advanced: Clique para iniciar o dilogo Advanced, onde voc poder configurar vrios
parmetros para o objeto Grid.
Esse dilogo permite a configurao dos parmetros em Advanced, como se segue:
IWS 20/06/2007

InduSoft Web Studio

Pgina 280

Dilogo Advanced
* User Enable: Caso o valor desse tag seja TRUE (diferente de 0), o usurio pode
selecionar linhas diferentes do objeto, clicando nessas linhas durante o runtime. Esse
campo pode ser configurado com um tag ou um valor numrico.
* Selected Values: Os valores de cada coluna da linha selecionada so registrados para
cada posio do tag array configurado nesse campo. Alm disso, pode-se modificar o
valor das clulas atualmente selecionados no objeto Grid, alterando-se o valor do tag
array configurado nesse campo. A posio inicial do array (offset) pode ser configurada
nesse campo.
* Row Number: O objeto Grid registra o nmero de linhas atualmente selecionadas
durante o runtime. Alm disso, pode-se selecionar linhas diferentes, registrando seus
valores nesse tag.
* Reload: Quando o tag configurado nesse campo invertido, o objeto recarrega e exibe os
dados a partir do data source.
* Condition: Esse campo pode ser configurado com a expresso para filtro de dados. Essa
expresso deve seguir a sintaxe bsica: <ColumnName> <Comparison Operator>
<Value> (e.x. ColumnX > 200). Ao utilizar Text File ou Class Tag para Data Sources,
<ColumnName> ser o valor especificado em the Label. Ao utilizar o Banco de Dados
para Data Source, a coluna ser o valor especificado em Field. (Caso Field seja deixado
em branco, o valor da coluna ser aquele especificado em Label.)

D Dicas:
Pode-se combinar vrias condies simultneamente no campo Condition,
utilizando os operadores lgicos AND, OR, e NOT. Por exemplo,
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 condies de filtragem durante o runtime.

* Number of Rows: O objeto grid registra o nmero de linhas atualmente disponveis no
objeto grid ao tag configurado nesse campo.
* Print: Quando o tag configurado nesse campo invertido, os dados atualmente filtrados
no objeto so enviados para impresso.
* Save Trigger: Quando o tag configurado nesse campo invertido, o data source (Text File
ou Database) atualizado com os valores atuais do objeto grid. Esse campo no est
disponvel quando o tipo Data Source type for Class Tag, j que os valores dos tags sero
atualizados automaticamente assim que voc alterar uma clula da grade.
* Insert Trigger: Quando Auto refresh after insert trigger estiver habilitado (checado), o
Tag configurado neste campo usado como um trigger para atualizar a tabela da base
de dados. Sempre que o valor do Tag muda, uma fileira nova adicionada tabela e os
valores do array configurado no campo Inserted Values so introduzidos
automaticamente.
* Inserted Values : Se o Insert Trigger estiver sendo usado, ento o Tag array configurado
neste campo fornece os valores que sero introduzidos. Este campo deve conter somente
um Tag array, embora possa ser de qualquer tamanho.
* Save on data change: Quando essa opo est habilitada, os valores so atualizados em
data source (Text File ou Database) assim que o usurio insira um novo valor na grade
durante o runtime. Essa opo estar desabilitada quando o tipo Data Source for Class
Tag, j que os valores dos tags sero atualizados automaticamente assim que voc
alterar uma clula da grade.
* Enable Slider/Resize: Caso esse box no esteja habilitado, o usurio no ser capaz de
rolar atravs da lista arrastando o boto slider ou alterar o tamanho das clulas durante
o runtime.
* Conditional Check-box: Quando essa opo est habilitada, o usurio no poder
desabilitar um check-box no objeto Grid durante o runtime, a menos que todos os
check-boxes precedentes na mesma coluna j estejam desabilitados. Essa opo
especialmente til quando deseja-se obrigar o usurio a seguir uma seqncia pr-
definida. Esse campo no est disponvel quando o tipo Data Source for Class Tag.
* Show Header: Quando essa opo est habilitada, O cabealho do objeto Grid est
visvel durante o runtime, exibindo o nome de cada coluna.
* Show gridlines: Quando essa opo est habilitada, as linhas em grade do objeto Grid
esto visveis durante o runtime.
* Ext. translation: Quando essa opo est habilitada, o texto exibido pelo objeto Grid
estar susceptvel ao Ferramenta Translation durante o runtime.
* Disable TAB to navigate through cells: Quando essa opo est habilitada, o usurio
poder navegar somente atravs das clulas do objeto Grid com as teclas de seta e a
tecla Tab. Voc dever desabilitar a tecla Tab para navegao caso voc queria que essa
seja utilizada para alternamento de valores para o prximo objeto que suporte foco na
tela.
* Auto refresh after insert trigger: Ler Insert Trigger.
* Concatenate Label for picture: faz a seguinte juno entre o contedo da
coluna Label com o contedo da coluna Field para definir o nome de uma
IWS 20/06/2007

InduSoft Web Studio

Pgina 282
imagem a ser exibida em cada linha do grid. O nome fica na seguinte
forma: <label>_<field>
* Export: Essa interface permite a exportao de dados do objeto grid para
um tag class-array, apesar do Data Source selecionado para o objeto. Os
seguintes campos devero ser configurados para suporte a esse recurso:

Campo Descrio
Class tag Digite o nome do tag principal do tag class-array o qual
receber os valores exportados. Cada linha do objeto grid
ser exportada para uma posio array do tag array atravs
da concordncia de linhas. A posio inicial do array pode ser
configurada nesse campo; 0 o padro.
Trigger Quando o tag configurado nesse campo altera seu valor (e.x.
inverte-se), os dados so exportados do objeto Grid para o tag
class-array configurado no campo Class tag.

D Dicas:
O recurso de Exportao (Export) uma ferramenta poderosa e de fcil
utilizao para a transferncia de dados a partir de diferentes data sources
para tags. Aps exportar os dados para os tags, pode-se utilizar diferentes
tarefas para a manipulao de dados, como a funo FileWrite() ou tarefas
Recipe ou Report para salvar os dados em arquivos de texto (e.x. arquivos
CSV).

Boto Check Box Object ( ): Clique nesse boto para criar um objeto check box em sua tela.
O boto Check Box Object til na criao de interfaces onde usurios podem habilitar/desabilitar uma
opo 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 boto do mouse quando o tamanho do objeto esteja de acordo.

Dilogo Object Properties: Check Box
Utilize o dilogo Object Properties para especificar os seguintes parmetros no Objeto Check Box:
Caption: Especifica o ttulo, digitando o texto no text box.
Fonts: Especifica o estilo da fonte para o ttulo, clicando-se no boto Fonts.
E-Sign: Quando essa opo est habilitada, o usurio ser requisitado a inserir a Senha
Eletrnica antes de executar o comando.
IWS 20/06/2007

InduSoft Web Studio

Pgina 283
check-box Confirm: Clique (habilite) nesse box para assegurar-se de que o IWS requisitar a
confirmao da ao em runtime.
Lista drop-down Key: Selecione um item da lista a ser associado a tecla do teclado com o objeto
ou grupo de objetos. Pode-se ento pressionar esse tecla para habilitar/desabilitar o check-box.
Clique (habilite) no box Shift, Ctrl, ou Alt para criar uma combinao de teclas, significando que
as teclas Shift, Ctrl, ou Alt devero ser pressionadas com o item especificado na lista drop-
downt.
Clique (habilite) no box para abrir o dilogo Key Modifier, que habilita a modificao de sua
combinao de teclas. Pode-se escolher Left, Right ou Left or Right para a especificao da
posio no teclado das teclas Shift, Ctrl ou Alt na combinao de teclas. Caso voc escolha Left
or Right, o comando ser executado a qualquer momento que essas teclas forem pressionadas
em combinao com o item especificado na lista drop-down.

Dilogo Key Modifier

Campo Disable: Digite um tag ou expresso nesse campo para habilitar e desabilitar o objeto. O
objeto check box desabilitado ao inserir um valor diferente de 0.
Campo Security: Digite um valor nesse campo para especificar um nvel de segurana para o
objeto, como definido em Security. Quando um usurio efetua o log e no possui o nvel de
segurana especificado, o IWS desabilita o objeto.
Campo Tag: Quando o usurio clica no check box durante o runtime, o valor desse tag
atualizado. Caso nenhum feedback seja especificado, o valor desse tag tambm utilizado para
indicar o status atual do objeto.
True Value: Especifica um valor que ser utilizado para alterar o estado TRUE e indicar que o
controle est em estado TRUE. Para maiores informaes sobre estados, leia a tabela states.
* Tri-State: Habilitar o controle significa ter o third state, o qual exibido quando o tag
configurado no campo Feedback assume o valor especificado no campo Tri-State. Caso o
campo Feedback seja deixado em branco, o third state ser exibido quando o tag
configurado no campo Tag assume o valor especificado no campo Tri-State.
* Feedback: Valor que indica o estado do objeto (TRUE, FALSE ou Third-State). Caso o
campo Feedback seja deixado em branco, o tag configurado no campo Tag ser utilizado
como o tag Feedback.
* Ext Trans.: Quando essa opo est habilitada, o ttulo do objeto suporta a traduo.
* Force: Clique (habilite) nesse box para forar o Tag Database a reconhecer uma
alterao do tag quando o usurio clica no objeto, mesmo que o valor do tag em questo
no seja alterado.
* Auto gray out: Faz com que o ttulo do objeto seja exibido em cinza quando esse est
desabilitado pelo campo Disable ou devido ao Sistema de Segurana.
IWS 20/06/2007

InduSoft Web Studio

Pgina 284
* Enable Focus: Quando essa opo est habilitada, o objeto pode receber o foco durante
o runtime atravs das teclas de navegao.
* Push Like: Quando essa opo est habilitada o controle exibido como um Boto, ao
invs da forma padro: check box
* Fill Color: Especifica a cor de preenchimento para o boto. Essa opo habilitada
somente quando a opo Push Like est habilitada.
Existem dois modos de operao para esse objeto: Normal Mode e Tri-State Mode. Tais modos so descritos
abaixo:
NORMAL MODE
Quando a opo 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 contrrio, 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 usurio clica no objeto, o tag configurado no campo Tag atualizado de acordo com a seguinte
tabela:

Status Atual
Valor registrado para o tag configurado
no campo
Tag quando o usurio clica no objeto
FALSE
Valor configurado no campo True Value
field
TRUE
NOT (Valor configurado no campo True
Value)

Nota:
Quando o valor configurado em True Value uma string, o tag configurado no
campo Tag ser invertido entre uma string vazio e o True Value. Caso o True Value
seja deixado em branco, o tag configurado no campo Tag ser invertido entre
UNSELECTED e uma string vazia.

IWS 20/06/2007

InduSoft Web Studio

Pgina 285
TRI-STATE MODE
Quando a opo Tri-State est habilitada, o objeto opera em Tri-State Mode, podendo portanto, assumir
trs estados:

Estado Forma
Forma
(Boto Tipo
Empurrar)
FALSE

TRUE

TRI-STATE

Quando o valor do tag configurado em Feedback igual ao valor do tag configurado em True Value, o estado
configurado para TRUE. Quando o valor do tag configurado em Feedback igual ao valor do tag
configurado em Tri-State, o estado configurado para TRI-STATE. Quando nenhuma dessas condies so
satisfeitas, o estado configurado para FALSE. Caso o campo Feedback seja deixado em branco, o tag
configurado no campo Tag ser utilizado como o tag Feedback.

C Ateno:
O campo Tri-State no dever ser configurado com o mesmo valor do campo True
Value ou com uma string vazio.

Status Atual
Valor registrado para o tag configurado
no campo
FALSE Valor configurado no campo True Value
TRUE NOT (Valor configurado no campo Tri-State)
TRI-STATE
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 mnimo valor inteiro
assinalado, diferente de True Value.
Quando True Value uma string, NOT (Valor configurado no campo True Value)
resultar em uma string vazia. Caso True Value seja uma string vazia, NOT (Valor
configurado no campo True Value) resultar em UNSELECTED.

IWS 20/06/2007

InduSoft Web Studio

Pgina 286
Boto Radio Button Object ( ): Clique nese boto para criar um objeto check box na sua tela.
O Radio Button Object til para a criao de interfaces, onde o usurio pode escolher uma opo a partir
da exibia das opes 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 boto do mouse quando o objeto estiver no tamanho desejado.

Dilogo Object Properties: Radio button
Utilize o dilogo Object Properties para especificar os seguintes parmetros para o Radio button Object:
Caption: Especifica um ttulo, digitando-se o texto em um text box.
Fonts: Especifica um estilo de fonte para o ttulo, clicando-se no boto Fonts.
E-Sign: Quando essa opo est habilitada, o usurio ser requisitado a inserir a Assinatura
Eletrnica antes de executar o comando.
check-box Confirm: Clique (habilite) nesse box para assegurar-se de que o IWS requisitar a
confirmao da ao em runtime.
Lista drop-down Key: Selecione um item da lista para associar uma tecla do teclado a um objeto ou
grupo de objetos. Pode-se ento pressionar essa tecla para habilitar/desabilitar o radio button.
Clique (habilite) no box Shift, Ctrl, ou Alt para criar um combinao de teclas, significando que as
teclas Shift, Ctrl, ou Alt devero ser pressionadas com o item especificado na lista drop-down.
Clique (habilite) no box para abrir o dilogo Key Modifier, que habilita a modificao de suas teclas
combinadas. Pode-se escolher Left, Right ou Left or Right para especificar a posio das teclas
Shift, Ctrl ou Alt no teclado na combinao de teclas. Caso voc escolha Left or Right, o comando
ser executado sempre que essas teclas forem pressionadas em combinao com o item
especificado na lista drop-down.

Dilogo Key Modifier

Campo Disable: Digite um tag ou expresso nesse campo para habilitar e desabilitar o objeto.
Desabilita-se o objeto radio button ao inserir um valor diferente de 0.
IWS 20/06/2007

InduSoft Web Studio

Pgina 287
Campo Security: Digite um valor nesse campo para especificar um nvel de segurana para o objeto,
como definido em Security. Quando um usurio efetua o log e no possui o nvel de segurana
especificado, o IWS desabilita o objeto.
Campo Tag: Quando o usurio clica no radio button durante o runtime, o valor desse tag
atualizado. Caso nenhum feedback for especificado, o valor desse tag tambm utilizado para
indicar o status atual do objeto.
True Value: Especifica um valor que ser utilizado para alterar o controle para estado TRUE e
indicar que o controle est em estado TRUE. Para maiores informaes sobre estados, leia a tabela
states.
Advanced: Pressione esse boto para abrir o dilogo Advanced:

Dilogo Advanced
* Tri-State: Se habilitado, o controle possui um estado third state. O third state ser
exibido quando o tag configurado no campo Feedback assume o valor especificado no
campo Tri-State. Caso o campo Feedback seja deixado em branco, o third state ser
exibido quando o tag configurado no campo Tag assume o valor especificado no campo
Tri-State.
* Feedback: Valor que indica o estado do objeto (TRUE, FALSE ou Third-State). Caso o
campo Feedback seja deixado em branco, o tag configurado no campo Tag ser utilizado
como o tag Feedback.
* Ext Trans.: Quando essa opo est habilitada, o ttulo do objeto suporta a traduo.
* Force: Clique (habilite) nesse box para forar o Tag Database a reconhecer uma
alterao de tag quando o usurio clicar no objeto, mesmo que o valor do tag em
questo no se altere.
* Auto gray out: Faz com que o ttulo do objeto seja exibido em cinza quando esse est
desabilitado pelo campo Disable ou devido ao Sistema de Segurana.
* Enable Focus: Quando essa opo est habilitada, o objeto pode receber o foco durante
o runtime atravs das teclas de navegao.
* Push Like: Quando essa opo est habilitada o controle exibido como um boto, ao
invs da forma padro radio button.
* Fill Color: Especifica a cor de preenchimento para o boto. Essa opo habilitada
quando a opo Push Like est habilitada.
IWS 20/06/2007

InduSoft Web Studio

Pgina 288
Existem dois modos principais de operao para o objeto: Normal Mode e Tri-State Mode. Tais modos so
descritos abaixo:
NORMAL MODE
Quando a opo Tri-State est desabilitada, o objeto opera em Normal Mode. Portanto, poder assumir
somente dois estados:

Estado Forma
Forma
(Boto Tipo
Empurrar)
FALSE

TRUE

Estados em Normal Mode
Quando o valor do tag configurado em Feedback igual ao valor do tag configurado em True Value, o
estado configurado para TRUE. Do contrrio, o estado configurado para FALSE. Caso o campo Feedback
seja deixado em branco, o tag configurado no campo Tag ser utilizado como o tag Feedback.
Ao clicar no objeto, o tag configurado no campo Tag atualizado com o valor configurado no campo True
Value.

TRI-STATE MODE
Quando a opo Tri-State est habilitada, o objeto opera em Tri-State Mode. Portanto, pode assumir trs
estados:

State Shape
Shape
(Push Like)
FALSE

TRUE

TRI-STATE

Quando o valor do tag configurado em Feedback igual ao valor do tag configurado em True Value, o estado
configurado para TRUE. Quando o valor do tag configurado em Feedback igual ao valor do tag
configurado em Tri-State, o estado configurado para TRI-STATE. Quando nenhuma dessas condies so
satisfeitas, o estado configurado para FALSE. Caso o campo Feedback seja deixado em branco, o tag
configurado no campo Tag ser utilizado como o tag Feedback.

C Ateno:
O campo Tri-State no dever ser configurado com o mesmo valor que o campo
True Value ou com um valor vazio para string.

IWS 20/06/2007

InduSoft Web Studio

Pgina 289
Status atual
Valor escrito ao tag configurado no
campo
FALSE Valor configurado no campo True Value
TRUE NOT (Valor configurado no campo Tri-State)
TRI-STATE
Value)

Utilizando a Biblioteca
Symbols so objetos (ou grupos de objetos) reutilizados, que podem ser armazenados para
reaproveitamento. O IWS fornece acesso a uma extensa biblioteca de smbolos, o que habilita a adio e
reutilizao de smbolos de forma rpida e fcil. Pode-se tambm modificar smbolos existentes em apenas
alguns segundos.
Da barra de menu, selecione View Library para abrir a biblioteca a seguir de objetos e smbolos
previamente configurados, incluindo vrios objetos com dinmicos:

Library
Pode-se adicionar smbolos a partir dessa biblioteca para a tela de sua aplicao, o que economiza tempo
durante o desenvolvimento.
Nota:
Utilizar a opo de menu Library o mesmo que utilizar o boto Library na barra
de ferramentas padro.
IWS 20/06/2007

InduSoft Web Studio

Pgina 290
Para adicionar uma imagem tela:
E Clique em uma categoria, localizada no painel esquerda, a fim de ter uma visualizao prvia
das imagens disponveis.
E Clique duas vezes em uma categoria para importar uma cpia da imagem a ser exibida na tela,
a qual mantm seu imagem e fecha o dilogo Libraries.
E Clique em qualquer lugar da tela para colocar a imagem selecionada.
Nota:
A maioria dos smbolos possuem propriedades pr-definidas. Para alterar tais
propriedades, utilize o tab Replace localizado no dilogo Object Properties. Pode-se
adicionar uma tela configurada pelo usurio para a biblioteca Symbol. Desenvolva a tela
como .scr e copie-a ao diretrio \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 mantm-se uma conexo a origem. Um linked
object uma informao (o objeto) criado em um arquivo de origem (outro projeto ou tela). Paste
Link atualiza automaticamente um objeto de tela com link, sempre que voc atualizar o arquivo de
origem, embora o objeto de link no torne-se parte da tela. Caso voc coloque um arquivo de link
em uma pasta ou subpasta da aplicao, pode-se efetuar o download do arquivo com a Aplicao a
estao de trabalho em runtime.
Nota:
Essa opo no funcionar em aplicaes Windows CE.

Pasta Symbols
A pasta Symbols contm uma coleo de smbolos definidos pelo usurio, as quais so grupos de
imagens e/ou texto. Pode-se criar smbolos personalizados para a tela de exibio e salv-los na
pasta Symbols, como se segue.
E Clique no cone Group localizado na barra de ferramentas Object Editing.
E Clique em um smbolo e depois selecione Edit Copy to da barra de menu principal.
E Quando abrir o dilogo Save As salve o novo smbolo na pasta Symbols.
Para utilizar um smbolo da pasta Symbol, selecione Edit Paste from na barra de menu principal.
O IWS importa uma cpia do arquivo selecionado automaticamente para a tela ativa.
IWS 20/06/2007

InduSoft Web Studio

Pgina 291
Captulo 8: Configurando Planilhas de Tarefas
Esse captulo fornece informaes sobre como configurar Planilhas de Tarefas. Uma task controla quantos
tags diferentes no banco de dados podem ser utilizados em relao a sua aplicao.
Antes de continuar o desenvolvimento de sua aplicao, deve-se criar um script de forma a assimilar certas
variveis. Tais variveis devem ser atualizadas constantemente, e por isso voc dever criar essa simulao
em um planilha Math. Em uma aplicao de mundo real, essas variveis poderiam ser provenientes de
equipamentos de Campo, como um PLC ou um Soft Control.
Utilize o tab Tasks para acessar todas as planilhas de tarefas na aplicao atual.

Workspace: Tab Tasks
Esse tab contm as seguintes pastas de tarefas:
Alarms: Contm planilhas Alarm utilizadas para configurar grupos de alarme e tags
relacionados aplicao. Pode-se tambm utilizar a tarefa Alarm para definir mensagens de
alarme geradas pelo IWS.
Trend: Contm as planilhas Trend utilizadas para grupos histricos que armazenam curvas de
tendncas para a aplicao. Pode-se utilizar a tarefa Trend para declarar quais tags devem
possuir seus valores armazenados em disco, e para criar arquivos histricos para grficos de
tendncias. O IWS armazena as amostras em um arquivo histrico binrio (*.hst), e exibe
ambos em amostras on-line, em uma tela de grfico de tendncias.
Recipes: Contm as planilhas Recipe utilizadas para configurar como os dados so trocados
entre o banco de dados da aplicao e arquivos de disco em formato ASCII ou DBF, alm de
como os valores so transferidos entre arquivos e memria em tempo real.
Reports: Contm as planilhas Report utilizadas para configurar relatrios (tipo texto) que so
enviados para impressora ou disco. Tarefas Report permitem a configurao de relatrios de
texto com sistema de dados, os quais fazem a criao de relatrios uma tarefa mais simples e
eficz.
ODBC: Contm as planilhas ODBC utilizadas para configurar como a interface ODBC roda em
um ambiente da rede de trabalho e utilize configurao ODBC padro do Windows. Pode-se
configurar tarefas ODBC para trocar dados entre o IWS e quaisquer bancos de dados que
suportem uma interface ODBC.
Math: Contm as planilhas Math utilizadas para configurar e implementar rotinas adicionais
para trabalhar com diferentes tarefas do IWS. O IWS executa planilhas Math como Background
IWS 20/06/2007

InduSoft Web Studio

Pgina 292
Tasks durante o runtime. Pode-se configurar planilhas Math para prover ambientes livres para
rotinas lgicas e clculos matemticos requeridos pela Aplicao.
Script: Contm as planilhas Script utilizadas para configurar e implementar rotinas adicionais
para trabalhar com diferentes tarefas do IWS. O IWS executa planilhas Scipt como Background
Tasks durante o runtime. Esta relao til para inicializar variveis ou executar lgicas que
devem ser executadas quando a aplicao estiver iniciando.
Scheduler: Contm as planilhas Scheduler utilizadas para configurar eventos utilizando
expresses matamticas definidas, as quais so executadas de acordo com hora, data ou outros
eventos de monitoramento.
Para abrir planilhas Task para edio, clique duas vezes no Boto da tarefa e a planilha ser exibida na
janela Screen/Display.
Configurando uma Tarefa de Alarme
A pasta Alarms habilita a configurao de grupos de alarme e tags relacionados a cada grupo. A tarefa
Alarm define as mensagens de alarme geradas pelo IWS IWS. O propsito primrio de um alarme informar
de quaisquer problemas ou alteraes do estado durante o processo, de forma que voc pode tomar atitudes
a fim de corrigir erros.
Nota:
Pode-se configurar essa tarefa para enviar alertas via email para indivduo(s) designados,
o que requer uma conexo Internet (manualmente com a utilizao de uma funo
dial-up automtica) e deve-se executar a funo CNFEmail (descrita em Funes de Mail
no Apndice A: Funes do Studio) do IWS para configurar o SMTP server, e o domnio
antes de tentar enviar um email.
Para exibir mensagens de alarme na tela, deve-se criar um objeto de alarme clicando no Boto Alarm ( )
ou Alarm/Event Control ( ) na barra de ferramentas Active Objects. Para uma descrio mais detalhada,
veja Utilizando a Barra de Ferramentas Active Objects no Captulo 7: Configurando Telas e Grficos.
Nota:
O IWS incrementa seqencialmente o nmero utilizado para identificar uma planilha
Alarm para cada objeto criado recentemente na planilha.

Para criaram novo alalrme, utilize um dos mtodos a seguir para abrir uma planilha Alarm:
Clique com o Boto direito na pasta Alarm e selecione Insert do pop-up.
Selecione File New da barra de menu ou clique no Boto New na barra de ferramentas
Standard para abrir o dilogo New Document. Selecione Alarm Worksheet, e clique em OK.
IWS 20/06/2007

InduSoft Web Studio

Pgina 293

Planilha Alarm
A planilha Alarm dividida em duas reas:
rea Header (seo acima), que contm informaes para todo o grupo
rea Body (seo inferior), onde voc define cada tag em um grupo, suas condies de alarme e
mensagens.
Utilize os parmetros Header nessa planilha como se segue:
Campo Group Name: Digite um nome para distinguir os grupos de alarme.
C Ateno:
Antes de alterar o Campo Group Name, salve a planilha Alarm, pois as
configuraes de alarme podem ser perdidas em uma planilha quando no so
salvas.

Campo Description: Digite uma descrio do grupo de alarme para fins de documentao.
Boto Email Settings: Clique para configurar a aplicao para que essa envie um email
automaticamente para pessoa(s) designada(s) quando um evento de alarme ocorre.
C IMPORTANTE!
Para utilizar esse recurso, deve-se estar conectado a Internet (manualmente ou
utilizando uma funo dial-up automtica) e voc dever ter executado a funo
CNFEmail (descrita no Apndice A: Funes do Studio) do IWS para configurar o
SMTP server, nome do usurio, senha e domnio antes de tentar enviar um email.

O dilogo Email Settings aparecer:
IWS 20/06/2007

InduSoft Web Studio

Pgina 294

Dilogo Email Settings
Esse dilogo contm os seguintes parmetros:
check-box Enable send automatic email: Clique (habilite) nesse box e digite os endereos de
email nos Campos To (exigido), Cc (opcional), e Bcc (opcional) para enviar automaticamente uma
mensagem de email para o receptor (en)quando ocorrer um alarme.
Boto Use alarm message: Clique (habilite) nesse Boto para utilizar a mensagem verdadeira de
alarme na linha assunto do email.
radio button e Campo Custom: Clique (habilite) nesse Boto para inserir e utilizar a linha de
assunto como voc desejar no email de alarme. Digite o texto na linha de assunto no Campo
fornecido.
check-box Send 1 message by email (disponvel somente quando voc seleciona Custom):
Clique (habilite) esse Boto para enviar cada notificao de mensagem de alarme em um email
separado. (Por exemplo, caso haja trs alarmes, o IWS enviar trs emails.)
Esse parmetro est desabilitado por padro, o que significa que o IWS enviar todas as
mensagens de alarme para receptor designado em um nico email.
check-box Remove failed messages from the buffer: Clique (habilite) esse Boto para remover
mensagens de alarme do buffer quando a notificao de alarme falhar (no pde 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 algum
toma conhecimento do alarme (ack), e/ou quando o alarme normalizado (norm).
Campo Current Status: Digite um tag para receber o status atual do alarme.
Campo Error: Digite um tag para receber o erro que causou o alarme.
Nota:
Veja GetStatusSendEMailExt(optTagName) no Apndice A: Funes do
Studio para uma descrio dos valores retornados para os Campos Current
Status e Error.

painel Message Format: Utilize os parmetros desta rea para formatar as mensagens de sada
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.
IWS 20/06/2007

InduSoft Web Studio

Pgina 295
* Clique em um ou mais desses itens na lista Items para incluir a informao de alarme
na mensagem de email
* Clique nos radio buttons Space, Tab, ou Other para especificar que tipo de separador
utilizar entre elementos da mensagem de evento de alarme
Campo Send trigger: Digite um tag nesse Campo e quando o valor do tag for alterado, o IWS
verificar todos os eventos ativos de alarme. Caso haja qualquer evento de alarme do qual
uma notificao de alarme no tenha sido enviada, o IWS envia automaticamente uma
mensagem de notificao por email para o receptor(es) designado(s).
Campo Max buffer size: Digite um valor para especificar o nmero mximo de mensagens
de alarme para armazenar no buffer. Caso o nmero de mensagens exceda esse valor, o
IWS utiliza o algortimo FIFO (first in-first out) para gerenciar o buffer, deletando a
mensagem mais antiga sempre que ocorrer uma nova mensagem. A capacidade padro do
buffer de 16,000 mensagens. (Note: Esse Campo tambm aceita um tag.)
Campo Buffer size: Digite um tag para exibir nmeros de mensagens de alarme que esto
atualmente no buffer. (o IWS reinicia esses nmeros aps enviar a notificao 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 pra de enviar mensagens
existentes ou novas para o buffer.
Aps configurar os parmetros email clique em OK para fechar o dilogo e retornar para a planilha Alarms.
Nota:
Os arquivos de email de alarme salvos podem ser identificados pela extenso .aem.
Em verses anteriores do IWS, esses arquivos carregavam a extenso .eml;
entretanto, vrios firewalls bloqueiam automaticamente arquivos *.eml, e esses no
podem ser convenientemente baixados para estaes remotas atravs de um
firewall..
Na planilha Alarms, continue configurando os parmetros Header como se segue:

Boto 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.
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 nmero total de
alarmes ativos (reconhecidos ou no) e alarmes normalizados no reconhecidos.
Quando um alarme retorna ao estado normalizado e foi reconhecido, os mdulos de Alarme do IWS no
incluiro aquele tag na contagem total.
Campo Total UnAck: Insira um tag inteiro para receber um valor denotando o nmero total de
alarmes desconhecidos, apesar do estado do alarme (ativos ou normalizados).
Quando um alarme foi reconhecido, o mdulo Alarms do IWS logo inclui aquele alarme na contagem total.
A tabela a seguir fornecida para ilustrar como o mdulo Alarms do IWS faz a contagem de
mensagens de evento de alarmes para os Campos Total Alarms e Total UnAck:

Estado do
Alarme
Estado de
Reconhecimento
Contagem para
Total de tags
Alarm?
Contagem para Total
de UnAck Tag?
Inrreeconhecido
Sim Sim
Ativo
Reconhecido
Sim No
Inrreeconhecido Sim Sim
Normalizado
Reconhecido
No No

Nota:
Recomendamos a utilizao de nomes de tags nicos para os Campos Total Alarms
e Total UnAck para cada planilha Alarms.

Campo Remote Ack Trigger: Quando o valor do tag nesse Campo se altera, todo o grupo
ter conhecimento.
rea Dead Band Time (sec): Especifica os seguintes parmetros.
Campo Activation: Insira um nmero para designar o mnimo de tempo, em segundos, que o
tag dever estar em condio de alarme antes de considerar-se ativo.
Campo Normalization: Insira um nmero para designar o nmero de segundos que o tag dever
ficar fora da condio de alarme antes de considerar-se normal novamente.
Box Time Stamp/Value: Cada alarme mantm um time stamp da ltima atividade significativa,
junto com o valor do Tag naquele tempo. Voc pode selecionar o tipo de atividade que atualiza o
time stamp:
Activation/Norm (default): O tempo quando a dead band terminou que ,
quando o alarme se tornar ativado ou normalizado.
Last Tag Change: O tempo em que o valor do Tag mudou por ltimo durante o dead
band.
Start Condition: O tempo em que a dead band comeou.

rea On Line: Especifica os seguintes parmetros.
IWS 20/06/2007

InduSoft Web Studio

Pgina 297
check-box Display in Alarm Controls: Quando selecionado, envia mensagens de alarme para um
objeto de alarme na tela.
C Ateno:
Caso voc no tenha selecionado a opo Display in Alarm Controls, os alarmes
para esse grupo no aparecero nos objetos de alarme nas telas e impresso
durante a execuo.

check-box Ack Required: Requer o reconhecimento de mensagens de alarme. Disponveis somente
se o Campo Display in Alarm Controls estiver habilitado.
check-box Beep: Soa o beep at que o alarme tenha sido reconhecido. Disponvel somente se os
Campos Ack Required e Display in Alarm Controls estiverem habilitados.
check-box Send to Printer: Envia uma mensagem de alarme desse grupo para a impressora,
incluindo impressoras remotas. Pode-se utilizar essa opo somente com uma inpressora matriz (ou
qualquer impressora que imprima linha por linha).
C Ateno:
O check-box Send to Printer no deve ser utilizado com impressoras DeskJet
ou LaserJet, pois essas utilizam uma pgina inteira de papel para cada
mensagem de alarme. Tais impressoras no so capazes de imprimir apenas
uma linha e esperar pelo prximo comando de impresso.

check-box Save to Disk: Envia mensagens de alarme desse grupo para um arquivo do
disco rgido. Deve-se selecionar essa opo caso voc deseje objetos histricos de alarme.
check-box Generate Ack Messages: Gera mensagens sempre que alarmes desse grupo so
reconhecidos. Disponvel somente se os Campos Save to Disk ou Send to Printer estiverem
habilitados.
check-box Generate Norm Message: Gera mensagens sempre que alarmes desse grupo
retornam aos seus estados normais. Disponvel somente se os Campos Save to Disk ou
Send to Printer estiverem habilitados.
rea Colors in Alarm Controls: Especifica os seguintes parmetros para definir cores dos alarmes
para um objeto de alarme. O IWS exibe cada objeto de alarme em uma mensagem de alarme
utilizando as cores especificadas para os grupos.
check-box Enable color: Clique para especificar cores.
* retngulo Activation: Clique FG para selecionar uma cor para o texto das mensagens de
alarme e BG para selecionar uma cor para o fundo do texto do alarme.
* retngulo Acknowledgment: Clique FG para selecionar uma cor para o texto das
mensagens de reconhecimento e BG para selecionar uma cor para o fundo do texto da
mensagem de reconhecimento.
* retngulo Normalization: Clique FG para selecionar uma cor para o texto de mensagens
de normalidade e BG para selecionar uma cor para o fundo do texto de normalidade.
Quando aparecer o dilogo Color, clique em uma cor e selecione-a. A seguir, feche o
dilogo.
IWS 20/06/2007

InduSoft Web Studio

Pgina 298

Utilize os parmetros Body desta planilha como se segue:
Campo Tag Name: Digite um tag a ser monitorado pelo grupo de alarme.
Lista drop-down Type: Clique para selecionar um dos seguintes tipos de alarmes. (Pode-se
alterar quaisquer desses Campos no mdulo de runtime. Para informaes adicionais, veja
Captulo 5: Trabalhando com Tags.)
HiHi: Limite de alarme muito alto; gera uma mensagem de alarme quando o valor do tag est igual
ou maior que o valor HiHi Limit.
Hi: Limite de alarme alto; gera um alarme quando o valor do tag est igual ou maior que o valor Hi
Limit.
Lo: Limite de alarme baixo; gera um valor de tag quando o valor do tag est mais baixo ou igual ao
valor Lo Limit.
LoLo: Limite de alarme muito baixo; gera um alarme quando o valor do tag est mais baixo ou igual
ao valor LoLo Limit.
Rate: Determina a velocidade da taxa de variao de um tag. Caso a velocidade de variao esteja
maior que aquela estabelecida nesse Campo, um alarme ser gerado. A velocidade pode ser
determinada em segundos, minutos ou horas.
Deviation+: Derivao de uma valor mais alto; gera um alarme quando um aumento no valor do tag
igual ou maior que o limite estabelecido.
Deviation: Derivao de um valor mais baixo; gera um alarme quando uma diminuio no valor do
tag igual ou maior que o limite estabelecido.
Campo Limit: Digite um valor para gerao de um alarme limite.
Campo Message: Digite uma mensagem de alarme a ser exibida.
C Ateno:
Mensagens de alarme podem conter o valor de qualquer tag utilizando-se a sintaxe:
message {tag_name}.

Campo Priority: Digite um nmero 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.
C Ateno:
O Campo Selection deve conter um string com um mximo de 7 caracteres (outros
caracteres no sero considerados).

Alarm summary: Ao habilitar o arquivo de histricos do alarme para um grupo, o IWS salva o
arquivo como ALyymmdd.ALH no diretrio \app\ALARM da aplicao.
Quando yymmdd referir-se ao ano, ms e dia, o arquivo foi criado.
O IWS salva o arquivo histricos de alarme no seguinte formato:
Alarm Summary
P1|P2|P3|P4|P5|P6|P7|P8|P9|P10|P11|P12|P13|P14|P15|P16|P17|P18|P19|P20|P21|P22|P23
IWS 20/06/2007

InduSoft Web Studio

Pgina 299
.
.
.

Onde os valores so os seguintes:
P1 = Verso do arquivo (Current 003)
P2 = Data de Incio (DD/MM/YYYY)
P3 = Hora de Incio (HH:MM:SS)
P4 = Nome do Tag
P5 = Mensagem de Alarme
P6 = Ack onde,
. 0 Indica que o alarme foi reconhecido ou no exige reconhecimento
P7 = Ativo, onde
. 0 Indica que o alarme no est ativo
. 1 Indica que o alarme est ativo
P8 = Valor Limite
P9 = Nmero do Grupo de Alarme
P10 = Nmero de Prioridade
P11 = Seleo
P12 = Tipo, onde
. 1 is HiHi
. 2 is Hi (On)
. 4 is Lo (Off)
. 8 is LoLo
. 16 Rate (Change)
. 32 Derivao+
. 64 Derivao-
P13 = AckReq, onde
. 0 Requer reconhecimento (Ack)
. 1 No requer reconhecimento
P14 = Data de Normalizao (DD/MM/YYYY)
P15 = Hora de Normalizao (HH:MM:SS)
P16 = Ack Date (DD/MM/YYYY)
P17 = Ack Time (HH:MM:SS)
P18 = Nome do Usurio (esse Campo s existir se P1 001)
P19 = Comentrio (esse Campo s existir se P1 001)
P20 = Nome Completo do Usurio (esse Campo s existir se P1 002)
P21 = Station (esse Campo s existir se P1 002)
P22 = Valor Anterior
P23 = Diferena de Tempo (Bias)
Utilize o combo-box History Format para salvar dados de alarme no formato de arquivo Proprietary
history do IWS ou de um banco de dados SQL relacional. As opes para ambos so as seguintes:
IWS 20/06/2007

InduSoft Web Studio

Pgina 300
Proprietary
File Format: Texto (UNICODE). O IWS utiliza o caractere barra vertical (|) para separar os
Campos.
Default Path: \<Aplication Path>\Alarm\ALYYMMDD.ALH , onde:
YY = Dois ltimos dgitos do ano
MM = Ms
DD = Dia
Database
Database Type: Escolhido pelo usurio
Default Table Name: AlarmHistory
A informao salva no arquivo histrico descrita na seguinte tabela:
Nome do
Campo
Tipo de
Dados
Caracteristicas
Version Integer
Ese Campo criado quando o Formato de Arquivo
Prioritrio. Verso atual: 003
Start_Time TimeStamp
Timestamp indicando quando o alarme iniciado.
Quando o Formarto de Arquivo Prioritrio, o IWS salva a
Data (MM/DD/YYYY) em um Campo e a Hora
(HH:MM:SS.MSS) no prximo Campo.
Tag String Nome do tag
Message String Mensagem de alarme
Ack Boolean
0: Indica que o alarme foi reconhecido ou que no requer
reconhecimento
1: Indica que o alarme no foi reconhecido
Active Boolean
0: Indica que o alarme est inativo
1: Indica que o alarme est ativo
Value Real Valor do tag quando o alarme de evento ocorreu
Group Integer Nmero do grupo do alarme
Priority Integer Nmero de prioridade do alarme
Selection String Valor de Seleo do Alarme
Type Integer
1: HiHi
2: Hi(On)
4: Lo(Off)
8: LoLo
16: Rate(Change)
32: Deviation+
64: Deviation-
Ack_Req Boolean
0: Requer reconhecimento (Ack)
1: No requer reconhecimento
Norm_Time TimeStamp
Timestamp indicando que o alarme est normalizado.
Quando o Formato do Arquivo Prioritrio, o IWS salva a
IWS 20/06/2007

InduSoft Web Studio

Pgina 301
Ack_Time TimeStamp
Timestamp indicando que o alarme foi reconhecido.
Quando o Formato do Arquivo Prioritrio, o IWS salva a
User String
Usurio logado quando o evento de alarme ocorreu. Esse
Campo existe somente para Verso >=1
Comment String
Comentrio (opcional) digitado pelo operador quando o
alarme reconhecido. Esse Campo existe somente para
Verso >=1
User_Full String
Nome complete do usurio logado quando um evento de
alarme ocorreu. Esse Campo existe somente para Verso
>=2
Station String
Nome da estao (computador) o evento de alarme ocorreu.
Esse Campo existe somente para Verso >=2
Previous_Value Real
Valor do tag que ocorreu antes do evento de alarme. Esse
Campo existe somente para Verso >=3
Deleted Boolean
0: Mensagem de alarme no foi deletada
1: Mensagem de alarme foi deletada
Esse Campo criado somente quando o Formato de
Arquivo Banco de Dados.
Bias Integer
Diferena (em minuto) das colunas Time Stamp e o perodo
GMT. Esse Campo existe somente para Verso >=3
Last_Update TimeStamp
Time Stamp quando o registro foi criado/modificado. Esse
Campo utilizado para sincronizar os bancos de dados ao
utilizar o Banco de Dados Secundrio adicionado ao Banco
de Dados Primrio. Esse Campo criado somente quando
File Format Database.

= Dica:
Ao salvar Alarmes Histricos em um Banco de Dados SQL Relacional (Formato do
Arquivo = Database), pode-se costumizar o nome das colunas criados em um banco
de dados editando o arquivo <AplicaoName>.APP, como se segue:
[Alarm]
<DefaultName>=<NewName>
Por exemplo:
[Alarm]
Message=Alarm_Message
Ack=Acknowledgment

Para informaes detalhadas sobre como salvar arquivos histricos de alarme, incluindo instrues
para parmetros de configurao do banco de dados, veja Captulo 17: Interface de Banco de Dados
do IWS.
IWS 20/06/2007

InduSoft Web Studio

Pgina 302
Configurando uma Tarefa Trend
A pasta Trend habilita a configurao de grupos histricos para armasenamento de curvas de tendncias.
Pode-se utilizar a tarefa Trend para declarar quais tags devem ter seus valores armazenados em disco, alm
de criar arquivos histricos para grficos de tendncias. O IWS armazena as amostras em arquivo histrico
binrio (*.hst), e exibe ambos os arquivos histricos em amostras online, em um grfico trend em tela.
Para exibir um grfico trend em tela, clique na ferramenta Trend na barra de ferramentas Active Objects
para criar um objeto de trend.

Utilize um dos seguintes mtodos para inserir uma nova planilha Trend:
Clique com o Boto direito na pasta Trend e selecione Insert do pop-up.
Selecione File New da barra de menu ou clique na ferramenta New na barra de ferramentas
Standard para exibir o dilogo 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 (seo superior), que contm informaes para todo o grupo
rea Body (seo inferior), onde define-se cada tag no grupo. Essa seo contm vrias colunas
(Apenas duas so exibidas na figura anterior).
Utilize os parmetros Header nessa planilha, como se segue:
Campo Description: Digite uma descrio da planilha para fins de documentao.
combo-box Type: Clique no Boto de seta para selecionar um tipo de trend da lista. As
seguintes opes esto disponveis:
Proprietary
* File Format: Binrio
* Default Path: \<Aplication Path>\Hst\GGYYDDMM.HST , onde:
MM = Ms
DD = Dia
IWS 20/06/2007

InduSoft Web Studio

Pgina 303
Nota: O IWS fornece os programas HST2TXT.EXE e TXT2HST.EXE que habilitam a
converso de arquivos histricos de trends salvos em formato de propriedade (.hst) para arquivos de
texto (.txt) e vice versa. Para maiores informaes sobre esses programas, veja Convertendo
Arquivos Histricos de Trend de Binrio para Textoo na pgina 310 e Convertendo Arquivos
Histricos Trend de Texto para Binrio, na pgina 311.
Database
* Database Type: Escolhido pelo usurio
* Default Table Name: TRENDGGG (GGG = Trend Worksheet Number e.g. TREND001 for
the Trend Worksheet 001)
Note: Para maiores informaes sobre a estrutura da tabela do Banco de Dados que o IWS
utiliza para salvar arquivos histricos, veja Dados Salvos em Arquivo Histrico de Trend.
Database Configuration: Abre o dilogo Database Configuration para inserir as configuraes
requisitadas para estabelecer o link entre o IWS e um Banco de Dados Relacional SQL Externo,
para salvamento de histricos de tendncias.

Janela Database Configuration

combo-box Database: Permite selecionar tanto Primary quanto Secondary. Em Primary, todas
as configuraes exibidas na janela Database Configuration aplicam-se a interface do Banco de
Dados Primrio. De outra forma, ser aplicado a interface do Banco de Dados Secundrio.
Pode-se configurar o banco de dados Secundrio nos seguintes mdulos:
Disabled: Nesse mdulo, o IWS salva dados somente em Banco de Dados Primrio. Caso esse esteja
indisponvel por qualquer razo, os dados no so salvos em nenhum outro local. Essa opo pode
causar perda de dados, caso o Banco de Dados Primrio no estiver disponvel.
Redundant: Nesse mdulo, o IWS salva dados tanto em Banco de Dados Primrios quanto
Secundrios. Caso um destes esteja indisponvel por qualquer razo, o IWS mantm os dados
salvos naquele que est disponvel. Quando o banco de dados, antes indisponvel tornar-se apto
novamente, o IWS sincroniza ambos os bancos de dados automaticamente.
IWS 20/06/2007

InduSoft Web Studio

Pgina 304
Store and Forward: Nesse mdulo, O IWS salva dados somente em Banco de Dados Primrios. Caso
esse tornar-se indisponvel, o IWS salva os dados no Banco de Dados Secundrio. Quando o Banco
de Dados Primrio tornar-se apto novamente, o IWS move os dados do Banco de Dados Secundrio
para o Primrio.
Utilizando O Banco de Dados Secundrio, pode-se aumentar a realstica do sistema e utilizar o
Banco de Dados Secundrio como um backup quando o Banco de Dados Primrio no estiver
disponvel. Essa arquitetura particularmente til quando o Banco de Dados Primrio estiver
localizado na estao remota. Nesse caso, pode-se configurar um Banco de Dados Secundrio na
estao local para salvar dados temporariamente, caso o Banco de Dados Primrio no esteja
disponvel (durante uma falha na rede de trabalho, por exemplo).
combo-box Use Aplicao default: Quando esta opo est habilitada, o IWS utiliza os
parmetros configurados no Banco de Dados Padro para a tarefa que est sendo
configurada (Connection string, User name, Password, Retry Interval e Advanced Settings).
Quando no habilitada, pode-se configurar esses parmetros individualmente a tarefa
atual.
Campo Connection string: Esse Campo define o banco de dados onde o IWS registrar e
ler valores, assim como os parmetros principais utilizados ao conectar-se ao banco de
dados. Ao invs de registrar a Connection string manualmente, pode-se pressionar o Boto
browse () e selecionar o tipo de banco de dados, na janela Data Link Properties.

Nota:
A Lista de Fornecedores de Banco de Dados mostrada na janela Data Link
Properties depende dos fornecedores instalados e disponveis no computador
onde o IWS estiver rodando. Consulte a documentao do sistema operacional
(ou a documentao do banco de dados) para maiores informaes sobre as
IWS 20/06/2007

InduSoft Web Studio

Pgina 305
configuraes do Fornecedor para o Banco de Dados que est sendo utilizado.

Campo name: Nome do usurio para conect-lo ao banco de dados. O user name
configurado nesse Campo deve estar de acordo com aquele j configurado no banco de
dados.
Campo Password: Senha utilizada para conectar-se ao banco de dados. A senha
configiurada nesse Campo deve estar de acordo com aquela configurada no banco de
dados.
Campo Retry Interval: Caso o IWS estiver indisponvel para conectar-se ao banco de dados
por qualquer razo, automaticamente ser reiniciada a conexo aps o nmero de
segundos configurado nesse Campo.
Boto Advanced: Aps pressionar esse Boto, voc ter acesso a algumas configuraes
costumizveis. Para a maioria das aplicaes, o valor padro dessas configuraes no
necessitam ser modificados, e devem continuar os mesmos.

* combo box Milliseconds: Pode-se configurar como os milissegundos sero salvos quando
os dados esto sendo salvos no banco de dados. Cada banco de dados salva a data em
um formato diferente; Por exemplo, alguns bancos de dados no suportam
milissegundos em um Campo Date. As opes a seguir esto disponveis:
Default: Utiliza o formato pr-definido para banco de dados atual. Os banco de dados
previamente testados pela InduSoft so configurados para a opo mais cabvel. Ao
selecionar Default, o IWS utiliza os parmetros pr-configurados para o tipo de banco
de dados atual. Caso voc esteja utilizando um banco de dados que no tenha sido
previamente configurado pela InduSoft, a opo Default tentar salvar os
milssegundos em um Campo separado.
= Dica:
A opo padro para cada banco de dados configurada no arquivo
StudioADO.ini, armazrnado na subpasta \BIN do IWS. Veja a seo Studio
Database Gateway para informaes sobre como configurar o arquivo
StudioADO.ini.

Disable: No salva os milissegundos ao salvar a data no banco de dados.
Enable: Salva os milissegundos no mesmo Campo onde a data foi salva.
IWS 20/06/2007

InduSoft Web Studio

Pgina 306
salva em um Campo (sem a preciso de milissegundos) e o nmero de milissegundos
salvo em uma coluna diferente. Essa opo indicada onde voc deseja salvar timestamps
com a preciso de milissegundos, apesar de o banco de dados que voc est utilizando no
suportar milissegundos nos Campos Date.

* check-box Save time difference: Quando essa opo est habilitada, (padro), o IWS
salva o Time Zone configurado no computador onde a aplicao est rodando, em cada
registro do banco de dados. Essa opo deve estar habilitada para evitar problemas com
salvamento de horas.
* Database Gateway: Insira o Endereo Host Name/IP onde o Studio database gateway
estar rodando. O nmero TCP Port tambm pode ser especificado, mas caso voc no
esteja utilizando o padro, voc ter que configurar o Studio database gateway com o
mesmo TCP Port. Veja Studio Database Gateway para informaes sobre como
configurar o Studio ADO Gateway.
* Disable Primary Key: Para alguns mdulos, o IWS tentar definir uma tecla primria
para a tabela de forma a aumentar a velocidade das solicitaes. Caso voc esteja
utilizando um banco de dados que no suporte teclas primrias (e.x. Microsoft Excel),
deve-se habilitar esse Campo.
Painel Table: Essa rea permite a configurao de parmetros da Tabela onde os dados
sero salvos. Todas as tarefas podem compartilhar um mesmo banco de dados. Porm,
cada tarefa (planilhas Alarm, Events, Trend) devem possuir um link a sua prpria Tabela. O
InduSoft no habilita configiraes invlidas nesse Campo, portanto voc dever certificar-
se de que a configurao adequada para o banco de dados utilizado.
check-box Use default name: Quando essa opo est habilitada (padro), o IWS salva e/ou
entrega os dados para a Tabela com o nome padro, escrito no Campo Name.
check-box Automatically create: Quando essa opo est habilitada (padro), IWS cria uma
tabela com o nome escrito no Campo Name automaticamente. Caso esta opo no esteja
habilitada, o IWS no cria a tabela de forma automtica. Portanto, no ser capaz de salvar
dados no banco de dados, a menos que voc tenha configurado a tabela com o nome
configurado no Campo Name manualmente no banco de dados.
Name: Especifica o nome da Tabela do banco de dados onde os dados histricos sero
salvos.
Boto Refresh: Caso o banco de dados configurado esteja disponvel atualmente, pode-se
pressionar o Boto Refresh para preencher o combo-box Name com o nome das tabelas
atualmente disponveis no banco de dados. Dessa forma, pode-se selecionar a tabela onde
os dados histricos podero 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 esto
disponveis:
check-box Status (output): O tag nesse Campo receber um dos seguintes valores:
Valor Descrio
0 Desconectado do banco de dados. O banco de
dados no est disponvel ou sua configurao
est incorreta.
1 O banco de dados foi conectado com sucesso.

IWS 20/06/2007

InduSoft Web Studio

Pgina 307
Reload (output): Caso voc esteja utilizando colchetes em quaisquer dos Campos de
configurao, dever ser especificado o tag de recarregamento. Quando voc deseja
reconectar-se ao banco de dados utilizando os valores atualizados de seus tags, configure o
tag nesse Campo como 1. O IWS atualizar a configurao ao tentar executar um ao no
banco de dados e configurar o tag de volta a 0 quando estiver terminado.
Para instrues para configurar um banco de dados padro para todos os histricos de tarefas
(Alarm, Event and Trend), veja Configurando um Banco de Dados Padro para Todos os Histricos
de Tarefas 160.
Para maiores informaes sobre como salvar histricos Trend history, incluindo uma explicao dos
arquivos salvos, veja Captulo 17:Interface do Banco de Dados do IWS.
Painel Save Options: Utilize os parmetros a seguir para definir quando e como salvar arquivos
histricos de trend:
* check-box e Campo Save On Trigger: Clique (habilite) e digite o nome de um tag para
salvar amostras de trends quando algum alterar um tag especfico. (Alterao de Tag
pode ser um evento de Scheduler.)
* check-box Save On Tag Change: Clique (habilite) para salvar sempre a amostra de trend,
quando a alterao de um valor ocorrer em qualquer dos tags daquele grupo.
Boto Advanced: Clique para exibir a janela a seguir:

Janela Trend Advanced Settings
Painel Batch: O painel Batch fornece os seguintes Campos:
* Start/Stop (input): Insira o tag para iniciar/parar seus batches. Quando o tag nesse
Campo est configurado para TRUE (diferente de 0), o IWS iniciar o salvamento de
dados para seu arquivo batch (caso voc esteja utilizando o formato de propriedade), ou
adicionar um novo registro para a tabela BatchHistory em seu banco de dados,
indicando que um batch foi iniciado. Note que dados histricos sero salvos de acordo
com a configurao nos Campos Save Trigger e Save On Tag Change nas opes da
planilha Trend.
* Campo Name (input): Esse Campo representa o nome de batch; seu significado depende
do formato selecionado na Planilha Trend:
Caso voc tenha selecionado Proprietary no Campo Type, Name dever ser compilado
com formato [Path]<FileName>, onde:
Path: Um Campo opcional. Caso caminho no esteja especificado, o arquivo histrico
de batch ser armazenado no mesmo caminho do arquivo <Aplicao>.app.
FileName: Nome do arquivo histrico de batch.
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 histrico de batch ser removido. Com o
formato Database, ser configurado no Campo Delete na tabela BatchHistory para
verdadeiro, embora os dados histricos salvos permaneam os mesmos. O objeto Trend
v somente batches que tenham o Campo delete configurado para 0 (zero).
* Existent (output): O tag inserido nesse Campo receber o valor 1, caso o batch
especificado no Campo Name j exista, de outra forma, tag receber o valor 0.
* Description (output): Esse Campo est disponvel somente ao utilizar o formato
Database. Quando o tag no Campo Start/Stop altera-se para TRUE, o registro adicionado
para a tabela BatchHistory exibir o string nesse Campo.

= Dica:
Pode-se inserir nomes de tags entre colchetes nesse Campo (e.x. {MyTag}).

* Save data even if batch is not Running: Caso esse Campo no esteja habilitado, os
dados histricos sero salvos somente quando o tag no Campo Start/Stop estiver como
TRUE.

= Dica:
Os dados Histricos de Batch podem ser exibidos para o usurio em formato
Grfico ou Tabela. As sees de objeto Trend e Grid explicam como exibir
informaes nesses formatos.

Painel Disk Space Control: Esto disponveis as seguintes opes:
* History Life Time (days): Especifica quantos dias manter o arquivo histrico em disco.
Aps o perodo especificado, o IWS apaga o arquivo automaticamente. Utilize essa opo
somente para arquivos baseados em datas.
* Campo Compress After (days): Especifica quantos dias manter o arquivo histrico de
trend em disco (*.hst) antes de comprimir o arquivo. Aps o perodo especificado, o IWS
comprime o arquivo automaticamente. Utilize essa opo somente para arquivos
baseados em uma data. Essa opo no est disponvel para aplicaes em WinCE.
* Disable All Data Saving: Insira um tag nesse Campo. Quando o valor desse tag for TRUE
(diferente de zero), a tarefa trend pra de gravar dados nessa planilha.
Utilize os parmetros Body na planilha Trend como se segue:
Campo Tag Name: Digite o nome do tag a ser salvo no arquivo histrico.
C Ateno:
Aps adicionar ou remover tags de uma planilha Trend, quaisquer arquivos
histricos (*.HST) previamente criados no sero compatveis com a nova
configurao. Conseqentemente, os dados desses arquivos histricos no sero
exibidos pelo objeto trend.

IWS 20/06/2007

InduSoft Web Studio

Pgina 309
Campo Dead Band: Digite um valor para filtrar alteraes aceitveis quando Save on Tag
Change for utilizado. Por exemplo, Dead Band possui valor = 5. Caso o valor do tag for 50 e
altera-se para 52, o sistema no registrar essa variao em um banco de dados, pois esse
menor que 5. Caso a alterao seja igual ou maior que 5, o novo valor ser salvo no arquivo
histrico.
Field: Nome do Campo no banco de dados onde o tag ser armazenado. Caso esse Campo esteja
em branco esquerda, o nome do tag ser utilizado como tag name. Tags Array tags e Classes
tero os caracteres [ , ] e . substitudos por _.
Exemplos:
Nome do Tag Campo Padro
MyArray[1] MyArray_1
MyClass.Member1 MyClass_Member1
MyClass[3].Member2 MyClass_3_Member2
IWS 20/06/2007

InduSoft Web Studio

Pgina 310
Convertendo Arquivos Histricos de Trend de Binrio para Texto
Por padro, o IWS salva arquivos histricos de trend em um formato binrio (.hst). Caso voc deseje
possuir esses arquivos em formato .txt, o IWS fornece o programa hst2txt.exe para converter
arquivos histricos de trend de formato binrio para texto.
Para converter um arquivo, siga o seguinte procedimento:
E Em uma janela DOS, altere o diretrio (cd) para o diretrio Bin do IWS.
c:\>cd \Program Files\InduSoft Web Studio\Bin
E Assim que o comando responder, copie Hst2txt.exe no mesmo diretrio onde o arquivo .hst est
localizado.
Digite Hst2txt.exe e especifique os seguintes parmetros:
<filename>: Nome do arquivo histrico trend a ser convertido
[<separator>]: Caractere separador de dados (padro <TAB>)
[</e>]: Funcionalidade de extenso (converte dados com mais de 10 caracteres)
[</i:HH:MM:SS>]: Inicia a contagem em horas, (HH) minutos (MM), e segundos (SS)
[</f:HH:MM:SS>]: Finaliza a contagem em horas (HH), minutos (MM), e segundos (SS)
[</m>]: Inclui milissegundos na coluna Time (Digite 1 para imprimir o valor em milissegundos
em um arquivo de texto criado a partir do arquivo .hst.)
Por exemplo:
Hst2txt.exe 01952010.hst
O programa cria um arquivo texto de planejamento .hdr (header) e um arquivo .txt que pode ser visualizado
com a utilizao de qualquer editor de texto (Por exemplo, Notepad).
O arquivo .hdr contm o nome dos tags configurados na planilha Trend.
O arquivo.txt contm os valores do tag salvos no arquivo histrico.
Aps o programa converter o arquivo, digite Exit para fechar a janela DOS.
Nota:
Alternativamente, pode-se utilizar a funo HST2TXT em uma planilha Math para
converter arquivos binrios em formato texto automaticamente, sem a necessidade
de utilizar uma janela DOS.
IWS 20/06/2007

InduSoft Web Studio

Pgina 311
Convertendo Arquivos Histricos Trend de Texto para Binrio
O IWS fornece o programa txt2hst.exe para converter arquivos textos de volta a formato binrio.
Para converter um arquivo, utilize o seguinte procedimento:
E De uma janela DOS, altere o diretrio (cd) para o diretrio Bin do IWS.
c:\>cd \Program Files\InduSoft Web Studio\Bin
E Quando o comando aparecer, copie txt2hst.exe no mesmo diretrio onde o arquivo .txt est
localizado.
Quando o comando aparecer, digite txt2hst.exe e especifique os seguintes parmetros:
<filename>: Nome do arquivo ASCII com dados histricos para converso
[<separator>]: Caractere separador de dados (padro <TAB>)
[</e>]: Funcionalidade extendida (valor dos dados com mais de 10 caracteres)
[</i:HH:MM:SS>]: Hora de incio do valor dos dados em horas (HH), minutos (MM), e segundos (SS)
[</f:HH:MM:SS>]: Hora de trmino 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 binrio .hst.
Aps o programa converter o arquivo, digite Exit para fechar a janela DOS.
Nota:
No pode-se criar um script math para o programa txt2hst.exe e utilize-o em uma
planilha Math para converter arquivos texto em formato binrio como pode-se para
hst2txt.exe. O atalho para script math est disponvel somente para arquivos
binrios.

Criando Histricos Batch

O IWS fornece ferramentas poderosas que capacitam a criao e gerenciamento de informaes
sobre batches histricos. O usurio capaz de criar batches com a utilizao dos seguintes
formatos:
E Proprietary: Ao utilizar o formato de propriedade, cada batch sera armazenado em um arquivo
histrico diferente. O usurio pode salvar dados histricos tanto em arquivos histricos quanto
em batches ao mesmo tempo (veja Configurando uma Tarefa Trend no Captulo 8:
Configurando Planilhas de Tarefas, para maiores informaes sobre tais arquivos).
E Database: Os dados histricos utilizados para o batch so salvos na mesma tabela que aqueles
salvos em dados histricos; uma tabela adicional, chamada BatchHistory mantm registros com
as informaes sobre os batches. A lista abaixo descreve os Campos na tabela BatchHistory:
Nome do
Campo
Tipo de
Dados
Descrio
Group_Number Integer Nmero do grupo Trend. Esse o nmero da planilha
criada para especificar os tags que sero armazenados
em seu histrico 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 312
Sec_Table String Reservado
Description String Descrio do Batch
Deleted Boolean 0: Batch no foi deletado
1: Batch foi deletado

= Dica:
Pode-se costumizar o nome da tabela e o nome das colunas criadas em um
banco de dados editando o arquivo <AplicaoName>.APP, como se segue:
[Trend]
[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 configurao de planilhas Recipe para intercmbio de dados entre o banco de
dados da aplicao e arquivos de disco nos formatos ASCII, XML, ou DBF; transferindo valores entre
arquivos e memria em tempo real.
Tipicamente, utiliza-se uma planilha Recipe para armazenar receitas de processos, embora possa-se
armazenar qualquer tipo de informao (como logs de operao, senhas, etc) nesses arquivos. A tarefa
Recipes l e registra valores de tags da aplicao, alm de transferir valores de tags para a aplicao e vice-
versa.
Nota:
O IWS incrementa seqencialmente o nmero que identifica a planilha Recipe para cada
planilha recentemente criada.
IWS 20/06/2007

InduSoft Web Studio

Pgina 313
Utilize um dos seguintes mtodos para criar uma nova planilha Recipe:
Clique com o Boto direito na pasta Recipes, e clique na tela.
Selecione File New na barra de menu ou clique no Boto New na barra de ferramentas
Standard para abrir o dilogo 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 (seo acima), a qual contm informaes para todo o grupo
rea Body rea (seo abaixo), onde voc define cada tag no grupo.
Utilize os parmetros Header desta planilha como se segue:
Save As XML: Clique (habilite) para salvar informaes em formato XML, ou (desabilite) para
salvar em formato .DAT.
C Ateno:
Pode-se carregar informaes em um arquivo .DAT em tags diferentes utilizando
uma segunda planilha Recipe, embora deva-se carregar informaes em um
arquivo .XML para tags com o mesmo nome do tag do qual os dados foram gerados.

Nota:
Da mesma maneira para as pginas HTML, deve-se estar rodando o server da Web
para visualizar dados em formato XML a partir da Web, embora as pginas XML no
sistema de runtime no necessitem de uma aplicao em andamento para que os
dados possam ser visualizados. (Deve-se possuir o Internet Explorer version 5.0 ou
mais recentes para visualizar dados em formato XML.)

Campo File Name: Digite um nome de arquivo relacionado ao grupo de receitas, utilizando um
texto esttico (File1) ou um valor de tag dinmico ({FileNameTag}).
Campo Register Number: Digite um tag para definir o nmero de registro a ser lido e registrado
em um arquivo DBF. O IWS habilita esse Campo para aplicaes mais antigas, criadas para a
IWS 20/06/2007

InduSoft Web Studio

Pgina 314
utilizao de arquivos DBF. Porm, o software desabilita esse Campo para projetos mais
recentes.
check-box Unicode: Clique (habilite) para salvar a receita em formato UNICODE (dois bytes por
caractere) ou (desabilite) para salvar a receita em um formato ANSI (um byte por caractere).
Nota:
Ao salvar uma planilha, pode-se utilizar qualquer nome de sua preferncia (um nome
pr-definido no requisitado).Um arquivo de configfurao que utilize a extenso
padro .RCP (ou .XSL caso voc especifique Save As XML) contm configuraes de
receitas e o Campo File Name contm o nome do arquivo dos dados a serem lidos e
registrados.

Utilize os parmetros Body desta planilha como se segue:
Campo Tag Name: Digite nomes dos tags a serem atualizados com contedos do arquivo ou
com valores a serem registrados no arquivo. Caso o tag seja um array, deve-se especificar a
primeira posio a ser utilizada.
Campo Number of Elements: Especifica quantas posies de tag array esto em uso.
= Dica:
Pode-se configurar um nome de tag entre colchetes {TagName} nesse Campo,
permitindo ao usurio alterar dinamicamente o Nmero de Elementos
configurados na Receita para cada tag array durante o runtime.

C Ateno:
Ao definir um tag array, sua posio inicial deve ser zero, embora o IWS utiliza o tag
em caso de uma configurao de posio invlida.

Para ler ou registrar um grupo de receita, utilize a funo InduSoft Scripting Language Recipe.
Configurando a Tarefa Reports
O arquivo Reports contm uma definio de relatrios (tipo texto) a serem enviados para uma impressora ou
disco. A tarefa Reports permite a configurao de seu prprio relatrio (tipo texto) com dados provenientes
do sistema. O propsito principal dessa tarefa criar relatrios de forma mais simples e eficz.

Nota:
O IWS incrementa seqencialmente o nmero que identifica a planilha Report para
cada planilha recentemente criada.

Para imprimir um relatrio, utilize uma funo InduSoft Scripting Language em qualquer lugar onde uma
expresso permitida.
Utilize um dos mtodos a seguir para inserir uma nova planilha Report:
Clique com o Boto 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 dilogo New Document. Selecione Report Worksheet e clique em OK.
Uma nova planilha aparecer:
IWS 20/06/2007

InduSoft Web Studio

Pgina 315

Planilha Report
A planilha Report dividida em duas reas:
rea Header (seo acima), a qual contm informaes para todo o grupo.
rea Body (seo abaixo), onde voc define o tag e texto a serem utilizados na gerao de um
relatrio.
Utilize os parmetros Header desta planilha como se segue:
check-box Disk Append: para adicionar em um arquivo,
Habilite o box para adicionar (append) o novo relatrio no final de um arquivo j existente
Desabilite o box para substituir o relatrio j existente pelo novo, nesse mesmo arquivo
check-box Unicode: Clique (habilite) para salvar o relatrio em formato UNICODE (dois bytes
por caractere) ou (desabilite) para salvar o relatrio em formato ANSI (um byte por caractere).
check-box Log Value into the (Tag/Expression) length: Clique para habilitar o resultado de
Expresses/Tags configurados na tarefa Report para encaixar-se entre os colchetes, de acordo
com o nmero de caracteres. Caso voc no habilite esse box, o reltorio utilizar somente o
nmero de caracteres do valor dos dados, apesar do tamanho da expresso/tag.
Campo Output File: Digite o nome do tag para o arquivo de sada (utilizando a sintaxe {tag})
onde os dados esto armazenados ao adicionar para um arquivo, onde o valor do tag parte do
nome do arquivo.
Por exemplo: report{day}.out
Onde o arquivo gerado deve ser report1.out, report2.out ..., de acordo com o valor para dia do tag.
IWS 20/06/2007

InduSoft Web Studio

Pgina 316
Nota:
Um arquivo de configurao de relatrios utiliza .RCP como a extenso padro. O
Campo Output File o arquivo onde os dados esto armazenados.

Boto Edit RTF file: Clique para acessar o relatrio como um arquivo RTF, o qual pode-se editar
para modificao de layout, etc.
Utilize a poro Body dessa planilha para formatao do relatrio. Pode-se configurar um relatrio
utilizando dados do sistema e indicando onde adicionar valores de tag. Cada nome do tag
substituir o nome do tag {tag_name}. Para tags do tipo real, utilize a seguinte sintaxe: {tag_name
n}, onde n o nmero de caracteres decimais desejados a serem adicionados.
Nota:
Caso voc esteja utilizando o editor de relatrio padro (somente texto: ASCII ou
UNICODE), o nmero de caracteres reservados para o valor do tag ser igual ao
nmero de caracteres utilizados para digitar o nome do tag (incluindo os dois curly
brackets). Por exemplo, configure {TagA} no corpo do relatrio, reserve seis caracteres
para o valor do tag no arquivo do relatrio. Tal comportamento no vlido para
relatrios em formato RTF.
Configurando uma tarefa ODBC
A interface ODBC roda em um ambiente de rede de trabalho, e utiliza a configurao padro Windows
ODBC. A tarefa ODBC capacitada para troca de dados entre o IWS e qualquer banco de dados que suporte
essa interface.
Alm de configurar a planilha ODBC, deve-se configurar o driver Windows ODBC padro. O IWS refere-se
ao Usurio DNS (Data Source Name), o qual foi configurado no Painel de Controle (Control Panel). Para
maiores informaes, veja sua documentao do Windows.
Nota:
O IWS incrementa seqencialmente o nmero que identifica a planilha ODBC para cada
planilha criada recentemente.

Utilize um dos seguintes mtodos para inserir uma nova planilha ODBC:
Clique com o Boto 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 dilogo New Document. Selecione ODBC Worksheet e clique em OK.
IWS 20/06/2007

InduSoft Web Studio

Pgina 317

Planilha ODBC
A planilha ODBC dividida em duas reas:
rea Header (seo acima), a qual contm informaes para todo o grupo, define tags para
iniciar eventos de leitura e registro, configure valores de retorno, suporta parmetros de acesso,
etc.
rea Body (seo abaixo), onde voc define cada tag no grupo, alm de relacionar tags a
Campos do registro atual tabela do banco de dados.
Utilize os parmetros de Header nessa planilha como se segue:
Campo Data Source Name: Digite o mesmo Data Source Name (DSN) especificado no Painel de
Controle do Windows, contendo informaes sobre acesso a banco de dados especfico. Pode-se
alterar o nome em Data Source Name durante o runtime configurando um tag entre colchetes
nesse Campo. Por exemplo:
{DSNNameTag}
Campo User: Digite um nome de usurio para acessar o banco de dados> Pode-se alterar o
nome User durante o runtime configurando um tag entre colchetes nesse Campo.
Campo Password: Digite a senha do usurio. Pode-se alterar Password durante o runtime
configurando um tag entre colchetes nesse Campo.
Campo Table: Digite um nome para tabela no banco de dados. Pode-se alterar o nome Table
durante o runtime configurando um tag entre colchetes nesse Campo.
Campo Condition: Digite uma condio 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 operao, e um outro valor para um cdigo de erro.
Campo Transaction Completed: Digite um tag que troque de valor quando a transao estiver
executada.
IWS 20/06/2007

InduSoft Web Studio

Pgina 318
Campo Select, Next, Insert, Delete, ou Update Trigger: Digite um tag para funcionar cada
alterao de valor faz com que o sistema execute o comando correspondente. Ao menos um
Campo disparador requisitado.
Utilize os parmetros em Body nessa planilha como se segue:
Campo Tag Name: Digite os nomes dos tags a serem atualizados com os contedos do arquivo
ou tags dos quais os valores devem ser registrados no arquivo.
Column: Digite o local no qual encontrar dados no arquivo (Por exemplo, em um arquivo Excel,
digitando em Coluna 1, Linha 1, a coluna inteira define-se como coluna 1).
Deve-se utilizar o Painel de Controle do Windows para configurar a interface ODBC para arquivos
em Excel. O procedimento o seguinte:
E Clique em Start Settings Control Panel.
E Quando a janela Control Panel aparecer, clique duas vezes no Boto ODBC para abrir o dilogo
ODBC Data Source Administrator.
E No dilogo ODBC Data Source Administrator, clique Excel Files na lista User Data Sources, e
clique no Boto Configure.
E Quando o dilogo ODBC Microsoft Excel Setup aparecer, digite o nome de configurao do
Windows a ser utilizado no Campo DSN da planilha ODBC no Campo Data Source Name.
E Clique no Boto Select Workbook para configurar o arquivo Excel que voc deseja utilizar.
E Retorne ao dilogo ODBC Data Source Administrator e verifique se o DSN do usurio apareceu
na lista. Clique em OK para fechar o dilogo.
E Aps configurar a interface ODBC do Windows, deve-se configurar as planilhas ODBC do IWS.
E No tab Tasks, insira uma nova planilha ODBC.
E Certifique-se de que voc configurou ODBC Runtime para iniciar-se automaticamente, no tab
Execution Tasks (Project Project Status).
Para iniciar essa configurao, s necessrio rodar o projeto. Sua aplicao aplicar os
disparadores Select, Next, Insert, Delete e Update, permitindo assim a troca de dados atravs das
linhas do Excel e os tags configurados na planilha.
Consulte sua documentao do Windows para obter os significados de cdigos de erro especficos.
Segue uma lista de cdigos de erro do IWS:
Select command
1 - Error in the ODBCPREPARE function.
2 - Error in the ODBCBINDCOL function.
3 - Error in the ODBCEXECUTE function.
4 - Error in the ODBCSETCH function.
Next command
5 - Error in the ODBCSETCH function.
Insert command
8 - Error in the ODBCCOMMITE function.
Update command
Delete command
IWS 20/06/2007

InduSoft Web Studio

Pgina 319
Configurando uma Tarefa Math
A pasta Math permite a implementao de rotinas adicionais para trabalhar com funes bsicas de
diferentes tarefas do IWS. Uma planilha Math contm um grupo de linhas de programao que o IWS
executa com uma tarefa de Background durante o runtime. Pode-se configurar a planilha Math para prover
ambientes livres para rotinas lgicas e clculos matemticos necessrios para o projeto. Para tais
propsitos, o InduSoft Scripting Language simples e de fcil utilizao.
Nota:
O IWS incrementa sequencialemnte o nmero que identifica a planilha Math para cada
planilha criada recentemente.

Utilize um dos seguintes mtodos para inserir uma nova planilha Math:
Clique com o Boto direito na pasta Math e clique na tela.
Selecione File New da barra de menu ou clique no Boto New na barra de ferramentas
Standard para abrir o dilogo New Document. Selecione Math Worksheet e clique em OK.

Planilha Math
A planilha Math dividida em duas reas:
rea Header (seo acima), a qual contm informaes detalhadas para todo o grupo
rea Body (seo abaixo), onde voc define cada tag, expresso e as e Programming Lines
(rotinas lgicas e clculos matemticos para funes e operaes lgicas no grupo).
IWS 20/06/2007

InduSoft Web Studio

Pgina 320
Campo Execution: Digite uma expresso, tag nico ou um valor constante para determinar
quando a planilha deve ser executada.
C Ateno:
O IWS executa a planilha somente quando o resultado do Campo Execution no for
zero. Caso voc sempre queira a planilha para ser executada, digite 1 (valor constante)
no Campo Execution.

Utilize os parmetros em Body desta planilha como se segue:
Campo Tag Name: Digite um tag para receber um valor de retorno para o clculo especificado
na coluna the Expression.
Campo Expression: Digite uma expresso para enviar o valor de retorno para o tag especificado
na coluna Tag Name.
Configurando uma Tarefa Scheduler
A pasta Scheduler gera eventos com expresses matemticas definidas para serem executadas de acordo
com hora, data ou qualquer evento monitorado.
Nota:
O IWS incrementa sequencialmente o nmero que identifica a planilha
Scheduler para cada planilha criada recentemente. Diferentes grupos scheduler
possuem somente funo organizacional.

Utilize um dos seguintes mtodos para inserir uma nova planilha Scheduler:
Clique com o Boto 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 dilogo New Document. Selecione Scheduler Worksheet e clique em OK.

Planilha Scheduler
IWS 20/06/2007

InduSoft Web Studio

Pgina 321
A planilha Scheduler dividida em duas reas
rea Header (seo acima), a qual contm informaes para todo o grupo.
rea Body (seo abaixo), onde voc define cada tag, expresso e condio para o grupo.
Lista drop-down Event: Clique para selecionar um tipo de evento a partir dos segiuintes
Calendar: Gera bases de horrio maiores que 24 horas. Por exemplo, pode-se definir um evento que
imprima um relatrio diariamente, em um horrio especfico.
Nota:
Certifique-se de que o Campo Date esteja completo, caso voc deseje uma data
especfica para execuo do evento.

Clock: Gera bases de horrio menores que 24 horas (intervalos em minutos ou segundos). Essa
funo frequentemente utilizada com grficos de tendncia. Por exemplo, pode-se definir um tag
que ser incrementado a cada hora.
Change: Evento relacionado a troca de um tag no Campo Trigger.
Campo Trigger: Digite um tag que dispare uma troca de evento quando o valor desse tag
alterar-se. Quando o tag Trigger altera-se, o IWS retorna o valor especificado no Campo Value
do tag. Esse Campo utilizado somente pelo evento alterado.
Campo Time: Especifica um intervalo de tempo no qual um evento deve ocorrer, quando
utilizado um relgio em horas (0 a 23), minutos (0 a 59), e segundos (0 a 59). Tambm pode-
se utilizar esse Campo para especificar uma hora a ser utilizada pelos eventos de calendrio.
Campo Date: Especifica uma data na qual um evento de calendrio deve ocorrer dia (1 a 31),
ms (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 calendrio.
Campo Tag: Digite um tag para receber o valor retornado pelo Campo Expression.
Campo Expression: Digite uma expresso para qual tag ser enviado o valor de retorno. Esse
Campo utilizado para todos os eventos.
Campo Disable: Contm uma condio para desabilitao para a funo especificada. Deixe
esse Campo em branco ou utilize um valor de expresso igual a zero (logicamente verdadeiro)
para executar a funo. Utilize um valor de expresso igual a um, e a funo no ser
executada (Disable 1).
IWS 20/06/2007

InduSoft Web Studio

Pgina 322
Captulo 9: Configuraes de Evento
Esse Captulo descreve os novos recursos de logging e entrega de evento do InduSoft Web Studio. Um
evento pode ser qualquer alterao do tag, gerao de relatrios e receitas, abertura e fechamento de telas,
logar e deslogar a partir do sistema de segurana, etc. O InduSoft Web Studio salva todos esses eventos em
um arquivo log file, o qual pode ser entregue pelo objeto Alarm/Event Control.
Arquivos log de Evento so armazenados na pasta \Alarm da apicao, onde o InduSoft Web Studio salva
arquivos histricos. Os nomes dos arquivos log de evento devem estar de acordo com o formato
evYYMMDD.evt, onde:
YY representa os dois ltimos dgitos do ano no qual o arquivo log de evento foi gerado
MM representa o ms 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) so 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 = Verso 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 Usurio
P8 = Nome Completo do Usurio
P9 = Mensagem de Evento
P10 = Estao
P11 = Comentrio
P12 = Valor anterior
P13 = Diferena de Tempo (Bias)

IWS 20/06/2007

InduSoft Web Studio

Pgina 323
Configurando Parmetros de Eventos
Utilize os passos abaixo para configurar o recurso de entrega do evento:
E Selecione o tab Database. Esse tab contm um novo cone, chamado Event Settings:

Tab Database: Event Settings
E Clique com o boto direito no cone Event Settings e selecione Open do pop-up para abrir o
dilogo Event Settings:

Selecionado Event Settings

Dilogo Event Settings
IWS 20/06/2007

InduSoft Web Studio

Pgina 324
E Configure os parmetros no dilogo Event Settings como se segue:
check-box Enable event logger: Habilite esse box para habilitar o monitoramento de eventos (event-logging).
text box Disable: Digite um tag nesse campo. Caso o valor do tag seja diferente de 0 (falso), o InduSoft Web
Studio desabilita o Event Logger automaticamente.
check-box Security System: Habilite esse box para incluir eventos de sistema de segurana em arquivo
histrico de evento. O IWS loga os seguintes eventos para sistema de segurana:
* Log On / Log Off de usurios
* Usurios criados/ removidos utilizando as funes CreateUser() ou RemoveUser()
* Usurio bloqueado/desbloqueado utilizandos as funes BlockUser() ou UnblockUser()
* Usurio bloqueado pelo sistema de segurana aps vrias tentativas de entrada com
uma senha invlida
* Senha expirou
* Senha modificada
* Tentativa de Log On invlida
check-box Display: Habilite esse box para incluir eventos de Abertura/Fechamento de telas em arquivo de
evento histrico.
check-box Recipe: Habilite esse box para incluir eventos de carregar, salvar, iniciar e deletar receitas no
arquivo histrico de evento.
check-box Report: Habilite esse box para incluir eventos relatrios salvos em disco ou enviados para
impresso no arquivo histrico de evento.
check-box Custom Messages: Habilite esse box para incluir eventos gerados pela funo
SendEvent(strEvent) no arquivo histrico de evento.
check-box System Warning: Habilite esse box para incluir eventos de avisos gerais do sistema (como
Division by zero, Attempted to access invalid array index, etc) no arquivo histrico de evento. O IWS loga os
seguintes eventos de aviso do sistema:
* Erros que ocorrem ao enviar alarmes por email
* Tag foi bloqueado/desbloqueado
* Diviso por zero
* Conexo/desconexo do sistema de segurana remoto
check-box Tags: Habilite esse box para capacitor e logar alteraes no arquivo histrico 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 alteraes aceitveis.
Por exemplo, caso voc especifique um valor Dead Band = 5 para um tag de valor = 50 e
o valor do tag altera-se para 52, o sistema no registrar essa variao no arquivo
histrico de evento, pois a variao foi menor que 5. Porm, caso a alterao do valor do
tag for maior ou igual a 5, o sistema salvar o novo valor para o arquivo histrico.
* coluna Message: Digite um string (mensagem) relacionado a essa alterao do tag. Pode-
se especificar tags nas mensagens utilizando a sintaxe {tag name}.
O parmetro Tags pode ser til caso voc deseje gerar um arquivo de log de eventos que no sejam
necessariamente condies de alarme (Por exemplo, Motor On, Motor Off, etc).
Utilize o combo-box History Format para salvar dados de evento em formato arquivo histrico de
Propriedade do IWS ou para um banco de dados SQL externo relacional. As opes so as
seguintes:
Proprietary
IWS 20/06/2007

InduSoft Web Studio

Pgina 325
File Format: Texto (UNICODE). O IWS utiliza o caractere barra vertical (|) para separar os
campos.
Default Path: \<Aplication Path>\Alarm\EVYYDDMM.EVT , onde:
MM = Ms
DD = Dia
Database
Database Type: Escolhido pelo Usurio
Default Table Name: EventHistory
A informao salva no arquivo histrico est descrita na tabela a seguir.

Nome do
Arquivo
Tipo de
Dados
Comentrios
Version Integer
Esse campo criado somente quando o Formato do Arquivo
Propriedade. Verso 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 Usurio logado quando o Evento ocorreu
User_Full String Nome complete do usurio logado quando o evento ocorreu
Message String Mensagem de evento
Station String Nome da estao (computador) onde o evento ocorreu.
Comment String
Comentrio (opcional) digitado pelo operador quando o
evento ocorreu. Esse campo existe somente para Verso >=2
Previous_Value Real
Valor do tag ocorrido antes do evento. Esse campo existe
somente para Verso >=2
Deleted Boolean
0: Mensagem de Evento no foi deletada.
1: Mensagem de evento foi deletada
Esse campo criado somente quando o Formato do Arquivo
Database.
Bias Integer
Diferena (em minutos) das colunas Time Stamp e o horrio
GMT. Esse campo existe somente para Verso >=2
IWS 20/06/2007

InduSoft Web Studio

Pgina 326
campo utilizado para sincronizar os banco de dados ao
utilizar o Banco de Dados Secundrio alm do Banco de
Dados Primrio. Esse campo criado somente quando o
Formato do Arquivo Database.

= Dica:
Ao salvar os Eventos em um Banco de Dados SQL Relacional (Formato do
Arquivo = Database), pode-se costumizar o nome das colunas criadas no banco
de dados, editando o arquivo <AplicaoName>.APP como se segue:
[EventLogger]
POr exemplo:
[EventLogger]
Event_Info=Information
Message=Event_Message
Para informaes detalhadas sobre como salvar arquivos histricos de eventos, incluindo instrues
para parmetros de configurao do banco de dados, veja Captulo 17: Interface do Banco de Dados
do IWS.
IWS 20/06/2007

InduSoft Web Studio

Pgina 327
Captulo 10: Comunicao
Esse captulo explica como habilitar as aplicaes do InduSoft Web Studio para comunicao (troca de
valores de dados) com outras aplicaes, equipamentos remotos (como um PLC ou transmitters), e
quaisquer equipamentos que implementem Servers OPC ou DDE.
Para possibilitar comunicao, pode-se configurar planilhas de tarefas fornecidas pelo IWS. Instrues para
configurao dessas planilhas so fornecidas nas seguintes sees:
Explica como configurar uma planilha Driver para implementer um protocolo de comunicao
(OPC, TCP/IP, ou DDE).
Configurando OPC: Explica como configurar uma planilha OPC para gerenciar comunicao
entre OPC Clients e Servers locais ou remotos.
Configurando TCP/IP: Explica como configurar uma planilha TCP/IP para gerenciar
comunicao entre duas aplicaes do IWS.
Configurando DDE: Explica como configurar uma planilha DDE para gerenciar comunicao
entre DDE Clients e Servers locais ou remotos.
Utilize o tab Comm para acessar todas as planilhas configuradas para estabelecer comununicao com
outro equipamento ou software, utilizando protocolos disponveis.

Workspace: Tab Comm
As pastas no tab Comm so descritas nas pginas subseqentes.
Configurando um Driver
Um driver de comunicao uma DLL que contm informaes especficas sobre o equipamento remoto, e
implementa o protocolo de comunicao. Para desenvolver um driver de comunicao, a InduSoft fornece
um toolkit para drivers. Consulte a InduSoft para maiores informaes.
A pasta Drivers permite a definio da interface de comunicao (ou interfaces) entre o projeto e
equipamento remoto, como um PLC, um single-loop e transmitters.
Nota:
Consulte o menu Help para uma descrio das funes e caractersticas padres
para todos os drivers. Ao desenvolver uma aplicao, pode-se dirigir-se a
documentao especfica fornecida para cada driver de comunicao. Essa
documentao est geralmente localizada no diretrio DRV.
IWS 20/06/2007

InduSoft Web Studio

Pgina 328
Para configurar um driver de comunicao, deve-se especifdicar os parmetros da interface (por exemplo, o
endereo da estao e o baud rate), especificar endereos do equipamento, e depois estabelecer um link com
tags da InduSoft.
Utilize um dos mtodos a seguir para adicionar ou remover um driver configurado:
Clique com o Boto direito na pasta Drivers
Selecione Insert Drivers da barra de menu
Ambos os mtodos abrem um dilogo Communication Drivers, o qual exibe uma lista de drivers disponveis.

Dilogo Communication Drivers
Utilize os parmetros desse dilogo como se segue:
Campo Available Drivers: Lista todos os drivers disponveis, e uma breve descrio de cada um
deles.
Boto Help: Clique para abrir o menu Help, que contm instrues detalhadas para
configuraes do driver atualmente evidenciado no campo Available Drivers.
Boto Select>>: Clique para selecionar o driver atualmente evidenciado no campo Available
Drivers.
Campo Selected Drivers: Lista todos os drivers selecionados e suas descries (caso
disponveis).
Boto Remove: Clique para remover um driver atualmente evidenciado no campo Selected
Drivers.
Ao clicar em OK no dilogo Communications Driver, voc cria uma subpasta para o driver(s) selecionado(s)
na pasta Drivers localizada no tab Comm.
Pode-se clicar com o Boto direito em uma subpasta do driver para acessar a opo Settings, a qual abre o
dilogo Communications Parameters.
IWS 20/06/2007

InduSoft Web Studio

Pgina 329

Dilogo Sample Communications Parameters
Campo Connection Type: Habilita drivers seriais para comunicao com conexes de modem,
TCP/IP ou UDP. Essa configurao suportada somente para drivers seriais desenvolvidos com
a biblioteca UNICOMM, que inclui a maioria dos drivers seriais disponveis no produto.
C Ateno:
A opo Modem no suportada por Pocket PC v3.00 ou mais antigas.

Nota:
Essa seo cobre somente a opo Direct, o que habilita o driver a conectar-se com a
utilizao de um canal serial normal. Dirija-se a Utilizando Encapsulao TCP/IP e
UDP e Utilizando Conexes de Modem logo abaixo para informaes sobre outros
tipos de conexo. Conection Types Test lista os drivers que tm sido testados com
modem e conexes TCP/IP e UDP.
Campo COM: Clique para selecionar uma porta de comunicao serial.
Campos Baud Rate, Data Bits, Stop Bits, and Parity: Clique para selecionar parmetros para
uma configurao de porta serial.
Campos Long1, Long2, String1 e String2: Esses campos so configuraes para personalizao
de drivers. No exemplo acima, o driver utiliza Long1 para configurar o mtodo de deteco do
erro, e String1 para definir o tipo de famlia PLC.
Boto Advanced: Clique para abrir o dilogo Advanced settings. Utilize esse dilogo para alterar
os parmetros do drivers padro.
IWS 20/06/2007

InduSoft Web Studio

Pgina 330

Dilogo: Advanced Settings
Especifique ou altere os parmetros do driver padro como se segue:
rea Timeout (ms)
Campo Start Message: Especfica o timeout para o incio 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 utilizao do controle Request to Send.
Lista drop-down Verify CTS: Especifica a utilizao do tipo de verificao Clear to Send.
check box Disable DTR: Clique (habilite) esse box para desabilitar a funo DTR (o driver no
configurar o sinal DTR antes de iniciar a comunicao).
check box Enable IR (disponvel somente para plataforma Windows CE): Clique (habilite) esse
box para habilitar driver serial para a utilizao de uma Interface Infra-vermelha (Infrared
interface) (COM2 port) ao inves de uma porta serial padro para comunicao com o
equipamento (como PLC, I/O, computadores portteis, etc).
rea Protocol
Campo Retries: Digite um valor numrico para especificar quantas vezes o driver tentar
executar o mesmo comando de comunicao antes de considerar um erro de comunicao
para esse comando.
Campo Station: Alguns drivers slave, como o Modbus Slave (MODSL) requisitam um
endereo de rede de trabalho slave. Utilize esse campo para especificar o endereo slave.
rea Buffers length (bytes)
Campo Tx Buffer: Especifica o comprimento de transmisso do buffer (em bytes).
Campo Rx Buffer: Especifica o comprimento de recepo do buffer (em bytes).
IWS 20/06/2007

InduSoft Web Studio

Pgina 331
O IWS fornece duas interfaces, as quais podem ser utilizadas para configurar o driver (associando
tags da aplicao InduSoft para endereos de equipamento):
MAIN DRIVER SHEET: Fornece o mtodo mais fcil para configurao de comunicao entre
tags da Aplicao InduSoft e endereos de equipamento. Essa interface permite agrupar tags
automaticamente, fornecendo a melhor performance durante o runtime. No pode-se utilizar
essa interface para controle do tempo necessrio para escanear um grupo de tags
individualmente.
STANDARD DRIVER SHEETS: Permite o controle do tempo necessrio para escanear um grupo
de tags individualmente.
Pode-se utilizar ambas as pginas ao mesmo tempo.
Utilizando encapsulao TCP/IP e UDP
A maioria dos drivers serias disponveis no IWS permitem a utilizao de encapsulao TCP/IP ou
UDP/IP .O modo de encapsulao foi projetado para fornecer comunicao com equipamentos
seriais conectados a servers terminais em sua ethernet ou redes de trabalho sem fio. Um server
terminal pode ser visualizado como uma porta serial virtual, e converte mensagens TCP/IP ou
UDP/IP em sua Ethernet rede de trabalho sem fio para dados seriais. Uma vez que a mensagem foi
convertida para uma forma serial, pode-se conectar-se a equipamentos padro que suportem
comunicaes seriais ao server terminal. O diagrama a seguir fornece um exemplo da aplicao
dessa soluo:

Encapsulao TCP/IP
Pode-se habilitar a encapsulao seguindo-se os passos abaixo:
E Clique com o Boto direito na pasta do driver e selecione Settings do menu que ser exibido, o
que prover acesso aos parmetros de comunicao:

IWS 20/06/2007

InduSoft Web Studio

Pgina 332
E No campo Connection Type, selecione TCP/IP ou UDP/IP:

Selecionando um Tipo de Conexo
E Os campos a seguir estaro disponveis:
Campo IP Address: Especifica o Endereo IP para o Server terminal. Esse campo aceita tags
entre colchetes.
Campo Port Number: Insira o nmero da porta TCP/IP ou UDP/IP.
Campo Status Tag: Esse campo est disponvel somente ao utilizar TCP/IP. O tag nesse campo
recebe o valor 1 quando a conexo TCP/IP est estabelecida; de outra forma, recebe o valor 0.
Campo Server Mode: A encapsulao TCP/IP permite o Server Mode, fazendo o servidor
terminal responsvel por estabelecer a conexo para habilitar a comunicao.
Utilizando conexes de Modem
A maioria dos drivers seriais esto disponveis no IWS para permitir o uso de conexes de modem. A
conexo de modem foi projetada para capacitor comunicao com equipamentos seriais remotos
conectados atravs de uma linha telefnica. O diagrama a seguir fornece uma exemplo sobre como
aplicar essa soluo:

Conexo do Modem
Pode-se habilitar a conexo do modem seguindo-se os passos abaixo:
IWS 20/06/2007

InduSoft Web Studio

Pgina 333
E Clique com o Boto direito na pasta do driver, e selecione Settings do menu que ser exibido, o
que permitir acesso aos parmetros de comunicao:

E No campo Connection Type, selecione Modem:

Selecionando um Modem
C Ateno:
A opo Modem no suportada para Pocket PC v3.00 ou mais antigas.

E Os campos a seguir esto disponveis:
Lista drop-down Name: Selecione o modem que o driver utilizar para estabelecer conexo.
Caso voc no saiba o nome do modem, utilize a opo Auto Detect. Auto Detect 1 utilizar o
primeiro modem disponvel, Auto Detect 2 o segundo, Auto Detect 3 o terceiro, e Auto Detect 4
o quarto, etc.
Campo Phone: Insira um nmero de telefone que o driver possa utilizar para conectar-se ao
equipamento remoto. Esse campo aceita tags entre colchetes.
Boto Settings: Clique nesse Boto para configurar os parmetros do modem. A janela que
aparece ao clicar nesse Boto depender do sistema operacional que est sendo utilizado, alm
do tipo de modem utilizado.
C
Ateno:
Os parmetros configurados clicando-se nesse Boto no so salvos junto a sua
aplicao. As informaes so salvas no registro do sistema operacional, e so
IWS 20/06/2007

InduSoft Web Studio

Pgina 334
vlidas somente no computador com o qual voc est interagindo. Caso voc
instale sua aplicao em outro computador, tais parmetros tero que ser
reconfigurados.
Boto Connection: Clique para abrir a janela Connection Control. As configuraes padro de
conexo devem suprir a maioria das aplicaes. Porm, pode-se ter controle total sobre a
conexo, alm de capacitar chamadas de entrada, clicando-se nesse Boto.

Dilogo 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 conexo j tenha sido estabelecida, o
comando ignorado. No necessrio utilizar esse campo caso esteja utilizando Auto
Connect.
Campo Hang up trigger: Quando o valor do tag configurado nesse campo altera-se, o driver
se desconectar do equipamento remoto. Caso o equipamento esteja desconectado, o
comando ser ignorado No necessrio utilizar esse campo caso esteja utilizando
Disconnect call if idle for more than.
Campo Auto Connect: Quando essa opo est habilitada, o driver tentar conectar-se ao
equipamento remoto antes de enviar qualquer informao. Caso a conexo falhe, a prxima
tentative ser feita aps o Intervalo de Entrega (Retry Interval) ter expirado.
Campo Disconnect call if idle for more than: Quando essa opo est habilitada, o driver
desconecta-se automaticamente do equipamento remoto, caso a comunicao seja
executada aps o perodo especificado.
Campo Enable incoming calls: Habilite essa opo caso voc deseje capacitor o driver a
receber chamadas do equipamento remoto. Pode-se utilizar o Hang up trigger para arrastar
uma chamada uma vez que tenha sido estabelecida. Note que um driver pode utilizar tanto
chamadas de entrada quanto chamadas de sada.
rea Status
Campo Code: Insira um tag para receber um dos seguintes cdigos quando o driver estiver
rodando:
Cdigo Descrio
0 Disconnected
1 Connected
2 Dialing
3 Dropping
4 Closing line
IWS 20/06/2007

InduSoft Web Studio

Pgina 335
Campo Description:Insira num tag para receber uma descrio completa do status atual. A
descrio est associada com o campo Code; porm, possui informaes adicionais sobre o
status atual.
Connection Type Tests
A maioria dos drivers seriais devem trabalhar com cada tipo de conexo. Porm, a maioria deles so
desenvolvidos antes que o tipo de conexo tenha sido criado. A tabela a seguir lista tipos de
conexes totalmente testadas junto a certos tipos de conexo; caso o driver que voc pretenda
utilizar no esteja listado abaixo e voc no est certo de que trabalhar da forma correta, entre em
contato com seu distribuidor.
Driver Modem TCP/IP UDP/IP
MODSL
ABKE
MODBU E
OMETH E E
= Item foi testado
E = Item no foi testado

Configurando Planilhas de Driver
Essa seo explica como configurar MAIN e STANDARD DRIVER SHEETs (ou tabelas de
comunicao) para associar tags da aplicao com os endereos do equipamento. Pode-se
configurar mltiplas planilhas de Drivercada uma delas dividida nas sees Header e Body. O
driver MODBU ser utilizado para fins de demonstrao.
Nota:
Nem todos os drivers requerem MAIN DRIVER SHEET. Alguns drivers necessitam
somente de uma Planilha Padro. Consulte a documentao do driver para instrues
especficas.

IWS 20/06/2007

InduSoft Web Studio

Pgina 336
Configurando a planilha de driver padro
Siga os seguintes passos para criar uma nova Planilha de Driver PAdro:
E A partir do ambiente de desenvolvimento do IWS, selecione o tab Comm, localizado abaixo do
painel Workspace.
E No painel Workspace, amplie as pastas Drivers e clique com o Boto direito na subpasta
MODBU.
Quando menu pop-up aparecer, selecione a opo Insert:

Inserindo uma Nova Planilha de Driver
A planilha de Driver (<drivername>.drv) contm duas sees:
Header: Contm todas as informaes sobre comando de registro e leitura
Body: Contm os endereos do operador
Configurando o Header
O Header da planilha de Driver contm informaes de configurao necessarias para as funes do
driver. Inicialmente, deve-se criar uma nova configurao de driver para cada rea com a qual voc
deseja comunicar-se.

Seo Header da Planilha de Driver
O header contm os seguintes campos:
Description: Digite uma descrio da planilha, como tipos de rea e suas escalas, caso a
planilha seja Read, Write, ou Both. Essa descrio est exibida no Workspace, na pasta Drivers.
Increase read priority: Quando eventos de leitura e registros de planilhas (and there can be
more read worksheets with the same read trigger or enabled when idle) acontecem, a planilha
de maior prioridade a primeira a ser lida na prxima chamada do read trigger ou do evento
read when idle.
IWS 20/06/2007

InduSoft Web Studio

Pgina 337
Read Trigger: Contm um tag que sempre gera um evento de leitura quando o valor do tag no
campo se altera.
Enable Read when Idle: Contm um tag ou valor que sempre capacita uma leitura continua
quando seu valor for maior que zero.
Read Completed: Contm um valor de tag que inverte-se quando o evento de leitura est
terminado.
Read Status: Contm um tag que sempre possui seu valor preenchido com um nmero inteiro
quando o evento de leitura termina. Caso esse valor seja igual a zero, o evento foi completado
com sucesso. Caso aparea qualquer outro valor, o evento foi completado com erro. Pode-se
visualizar a mensagem de erro no mdulo Logwin (for NT/2000) ou verificar o arquivo
MODBU.MSG no diretrio DRV do InduSoft Web Studio.
Write Trigger: Contm um tag que gera um evento de registro para toda a planilha, sempre que
o valor do tag se altere.
C IMPORTANTE!
Ao utilizar esse recurso, o driver registra o valor do tag na memria PLC. Essa
operao faz registros com a utilizao de blocos, do primeiro ao ultimo operador
da planilha. Caso haja um operador no declarado na planilha, e seu endereo
esteja entre o primeiro e ltimos blocos, o tag receber o valor zero. Portanto,
certifique-se sobre o que voc deseja registrar ao utilizar esse disparador, e
verifique se h qualquer tipo de espao na planilha que possa causar problemas
para o sistema ou programas PLC.

Enable Write on Tag Change: Quando o valor de um dos tags no corpo diferente do disparador
de registro, o IWS registra o tag alterado na planilha (seu valor maior que zero).
Write Completed: Contm um valor de tag que inverte-se quando um evento de registro
termina.
Write Status: Contm um tag que sempre preenchido com um valor inteiro ao terminar um
evento de leitura. Caso esse valor seja igual a zero, o evento foi concludo com sucesso.
Qualquer outro valor indica um erro. Pode-se visualizar a mensagem de erro no mdulo Logwin
(para NT/2000) ou verificar o arquivo OMPLC.MSG no diretrio \DRV do InduSoft Web Studio.
Station: Deve conter (caso indicado no arquivo help do driver) o ID da CPU, Unit Number, ou
Endereo PLC relacionados a essa planilha especfica. Cada driver possui uma sintaxe diferente
para esse campo.
Por exemplo, o driver GE Fanuc SNP permite a identificao do PLC utilizando todos os caracteres ASCII,
mas o OMRON Host Link Protocol permite de 1 a 31 endereos somente, chamado Unit Numbers.
Tipicamente, pode-se utilizar o endereo do PLC em uma rede de trabalho do equipamento.
Tambm pode-se inserir um tag entre colchetes (Por exemplo: {tag})
Notas:
No pode-se testar a existncia de tags inseridas entre colchetes (ou inseridas em
uma forma diferente dos tags de outros campos), pois esses ainda no foram
criados no tag database. Em outras palavras, o sistema no poder trabalhar de
forma adequada com tags ainda no criados.
Station um campo de string, e deve ser preenchido da forma correta, ou o driver
no funcionar da forma apropriada.

IWS 20/06/2007

InduSoft Web Studio

Pgina 338
Header: Deve conter o header da planilha. Esse campo extremamente importante. Cada driver
possui uma sintaxe diferente para esse campo; porm, deve-se digitar algo como o operators
type, seguido pelo endereo inicial.
A tabela a seguir contm alguns exemplos:

Driver Header Significado
MODBUS 4X:100 4X indica que essa planilha comunicar com os
Holding Registers, a partir do endereo 100 on. No caso
de AEG 984, a partir do endereo 400100 on.
OMPLC (Host
Link)
IR:0 IR indica que essa planilha comunicar com I/O and
Internal Relays, a parir do endereo 0 on. No caso de
C200H, a partir do endereo IR00000 on.
FANUC (SNP) %M %M indica que essa planilha comunicar com o %M
discrete internal operator.No h endereo inicial para
esse driver.
ABKE (DF1) N7:0 N7 indica que essa planilha comunicar com o arquivo
N7, a partir do endereo 0 on. No caso de PLC-5/40, a
partir do endereo N7:0.
AS511
(Siemens PG
Port)
DB5:10 DB5 indica que essa planilha comunicar com Data
Block number 5, a partir de Data word 10 on.

Assim, a sintaxe pode variar para cada tag. A maioria das vezes, esse o endereo do PLC em
uma rede de trabalho do equipamento.
Por exemplo, utilizando a sintaxe do MODBUS:
<reference>:<initial address>
Onde:
<reference> a referncia 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 configurao na coluna Address.
Pode-se utilizar as seguintes referncias:
0X: Coil Status
1X: Input Status (read only)
3X: Input Register (read only)
4X: Holding Register
ID: Report Slave (read only)
No h limites para o endereo inicial, embora tome cuidado ao especificar limites de
endereos. Por exemplo, no PLC no existe 30500. O campo Header aceita a sintaxe 3X:500,
mas o runtime no encontrar esse registro.
Onde Read Only estiver indicado, as funes de registro no funcionaro. No seguro
especificar registro para as funes Input Status, Input Registers e Report Slave.
Esse campo tambm pode ser preenchido com um tag entre colchetes (Por exemplo: {tag}).
IWS 20/06/2007

InduSoft Web Studio

Pgina 339
Nota:
Como acontece no campo Station, no pode-se testar a existncia de tags inseridos
entre colchetes (ou inseridos de uma forma diferente dos tags em outros campos),
pois esses ainda no foram criados no tag database. Em outras palavras, o sistema
no poder trabalhar de forma adequada com tags ainda no criados.

Ao criar sua primeira planilha Driver, o campo est em branco. Aps voc colocar o cursor
neste campo (mesmo se voc tentar deix-lo em branco novamente) o IWS automaticamente
insere o string padro 0X:1. A partir desse ponto, voc no poder deixar o campo em branco.
Porm, pode-se alterar o valor para outro header vlido.
Min / Max: Torna-se habilitado aps clicar ( ) no check-box. Quando selecionado, esse
parmetro capacita uma escala de valores que podem ser convertidos para um formato de
engenharia. Tais campos determinam a escala de valores mximos e mnimos. Por exemplo, a
memria suporta valores de 0 a 4095, o que significa 0% a 100% na interface do usurio. Essa
configurao tem efeito para todos os tags da planilha. Nesse exemplo, os parmetros Min e
Max do tag devem ser configurados de 0 a 100, respectivamente.
Configurando o Body
A seo body da planilha Driver assina o endereo da memria do PLC para tags declarados, alm
de manusear unidades de engenharia.

Seo Body da Planilha Driver
A seo Body contm quarto colunas:
Tag Name: Contm tags utilizados pelo driver de comunicao.
Address: Contm endereos para leitura e registro dos valores do tag para o equipamento.
Como no campo Header, essa coluna diferente para cada driver. Tipicamente, digita-se o
offset para cada endereo inicial configurado no campo Header. Em alguns casos, pode-se
indicar o espao Address especfico.
Para o driver de nosso exemplo, digite o offset do endereo inicial configurado no campo
Header. No pode-se inserir um valor negativo de offseto valor 0 ir substituir o valor
negativo.
Div / Add / Max / Min: Configure como se segue:

Coluna Escala de
Valores
Significado
Div Any Integer or
Real
In read commands: Tag = (Host value) / DIV
In write commands: Host value = Tag * DIV
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 mnimo assinalado para o tag, quando o
valor host correspondente igual ao valor definido no
campo Min no Header da planilha do driver.
Max Any Integer or
Real
Define o valor mximo assinalado para o tag, quando o
valor host correspondente igual ao valor definido no
campo Max do Header de planilha do driver.

Notas:
Para operaes de leitura:
<tag> =((<value in the equipment>) / Div)+ Add
Para operaes de registro:
<value in the equipment> = (<tag> - Add) * Div
Caso voc no configure as colunas como especificado na tabela, as colunas no
sero configuradas e os tags da planilha Driver recebero o mesmo valor do endereo
configurado.

Utilize os passos a seguir para especificar tags do header:
E Especifique os seguintes tags na planilha, nos campos Header. Todos os tags sero arrays, e
voc dever digitar cada elemento em cada planilha.
Por exemplo, RdTr[1] no campo Read Trigger da planilha ABKE001.DRV, e RdTr[5] da planilha
ABKE005.DRV, etc.
Nome
do Tag
Tamanho Tipo Descrio
RdTr 0 Boolean Tag Boolean que estar nos campos "Read
Trigger"
RdEn 0 Boolean Tag Boolean que estar nos campos "Enable
Read when Idle" fields
RdCpl 0 Boolean Tag Boolean que estar nos campos "Read
Complete"
RdSt 0 Integer Tag Integer que estar nos campos "Read
Status"
WrTr 0 Boolean Tag Boolean que estar nos campos "Write
Trigger"
WrEn 0 Boolean Tag Boolean que estar nos campos "Enable
Write when Idle"
IWS 20/06/2007

InduSoft Web Studio

Pgina 341
Nome
do Tag
Tamanho Tipo Descrio
WrCpl 0 Boolean Tag Boolean que estar nos campos "Write
Complete"
WrSt 0 Integer Tag Integer que estar nos campos "Write
Status"
Station 0 String Tag String que estar no campo "Header"
Header 0 String Tag String que estar no campo "Station"

E Especifique TAG_DRV como um tag Array, tamanho 10, para os tags de comunicao.
E Configure uma planilha Driver e uma tela PLC Driver para parecer-se com a seguinte figura:

Configurando a planilha do driver MODBUS
IWS 20/06/2007

InduSoft Web Studio

Pgina 342

Tela do Driver PLC
Configurando main driver sheet (MDS)
Quando voc adiciona um driver MODBU a sua aplicao, o programa automaticamente adiciona a
MAIN Driver Worksheet (MDS) a pasta do driver MODBU como mostrado a seguir:

Selecionando Main Driver Sheet
IWS 20/06/2007

InduSoft Web Studio

Pgina 343
Pode-se utilizar o MDS para associar tags do IWS para endereos no PLC. A maioria dos parmetros
MDS so padres para qualquer driver. Utilize as instrues a seguir para configurar parmetros
especficos do driver MODBU:
E Clique duas vezes no cone Main Driver Sheet para abrir a planilha que se segue:

Planilha Main Driver
E Configure os campos a seguir dessa planilha:
Campo Station: Digite o nmero ID do endereo PLC
Campo I/O Address: Digite o endereo 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 endereo de registro do equipamento.
Bit o nmero de (0 15) da p[alavra referente ao endereo. Esse parmetro opcional e
pode ser combinado somente com endereos 3X- ou 4X.

C
Ateno:
Deve-se utilizar um valor diferente de zero no campo Station. No pode-se deixar
o campo em branco.

IWS 20/06/2007

InduSoft Web Studio

Pgina 344
Executando o Driver
Aps adicionar o driver ao projeto, o Studio configura o projeto para que seja executado
automaticamente ao iniciar o ambiente de runtime.
Para verificar que a tarefa de runtime do driver est habilitada e ser iniciada da forma correta, siga
os passos a seguir:
E Selecione Project Status da barra de menu principal.
Aparecer o dilogo Project Status:

Dilogo Project Status
E Verifique se a tarefa Driver Runtime est configurada para Automatic.
Caso as configuraes estejam corretas, clique em OK para fechar o dilogo.
Caso a tarefa Driver Runtime esteja configurada para o modo Manual, selecione a linha Driver
Runtime. Quando o Boto Startup torna-se ativo, clique no Boto para inverter do modo Startup
para automtico Automatic.
E Clique em OK para fechar o dilogo Project Status.
E Inicia a aplicao para rodar o driver.
Configurando OPC
A pasta OPC permite a configurao de interfaces OPC entre a aplicao e um Server OPC. O mdulo OPC
Client da InduSoft permite que o sistema IWS estabelea comunicao com qualquer equipamento que
implemente um OPC server. Antes de utilizar o mdulo InduSoft OPC Client da InduSoft, deve-se instalar e
configurar o OPC nas mquinas que estejam rodando sua aplicao.
Na mquina do cliente, utilize o programa OPC Client Configuration para configurar o identificador do
server, parmetros de comunicao e os itens que voc deseje que sejam conectados. Para acessar a
configurao do cliente, adicione um novo documento OPC Client na tabela "COMM".
IWS 20/06/2007

InduSoft Web Studio

Pgina 345
Configurando um OPC Client
Utilize os passos a seguir para configurar um OPC Client:
E Selecione o tab Comm, clique com o Boto direito na pasta OPC e insira uma nova planilha OPC
Client.
E Selecione um OPC Server registrado (CimQuestInc.IGOPCAB) no combo-box Server Identifier
para registrar InGear OPC AB.
E Crie um novo jogo de tags para comunicar-se como o OPC Server , como mostrado:

E Na planilha OPC Client, digite OPC_Status no campo OPC Status.
E Na primeira linha da coluna Tag Name, digite OPC_N7_0.
E Para associar esse tag ao item OPC Server, clique com o Boto direito na coluna Item e clique
em OPC Browser para agrupar todos os itens OPC Server configurados. Selecione o item N7_0.

Selecione N7_0
IWS 20/06/2007

InduSoft Web Studio

Pgina 346
Sua planilha OPC Client dever parecer-se com a planilha que se segue:

Planilha OPC Client
A planilha OPC Client contm os campos a seguir:
Description: Digite uma descrio do mdulo OPC para fins de documentao. (O mdulo OPC
Client ignorar essa informao.)
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
comunicao com o OPC server. Especifique como zero, ou deixe o campo em branco para
habilitar a comunicao.
Read Update Rate (ms): Especifique a frequencia com que o servidor dever atualizar esse
grupo (em milissegundos). Especifique zero para indicar que o servidor dever utilizar a escala
mais rpida de atualizao.
Percent Deadband: (vlido somente para itens anlogos): Especifique a porcentagem de
alterao do valor de um item suficiente para causar uma notificao do servidor.
Status: Status atual. Um status bom 1.
Remote Server Name: Nome do n ou endereo IP do servidor na rede de trabalho do nodo.
check-box Read after writing: Habilitar esse check-box fora 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 aps um valor ter sido registrado ao item. Essa opo deve ser utilizada para garantir a
sincronizao entre o valor dos tags do IWS e os itens do OPC Server quando o programa do
PLC transfere os valores registrados pelo IWS para o OPC Server.
Tag Name: Digite os nomes dos tags com link para os itens do servidor.
Item: Digite o nome dos itens do servidor. Aps selecionar um OPC Server, pode-se selecionar
itens do Server utilizando o Browser do OPC. Clique com o Boto direito no campo Item e
selecione a opo OPC Browser.

IWS 20/06/2007

InduSoft Web Studio

Pgina 347
= Dica:
Pode-se configurar o nome do tag entre colchetes {TagName} nesse campo,
permitindo ao usurio alterar os nomes dos itens dinamicamente durante o
runtime.

Scan: Especifica:
Screen: O IWS executa uma atualizao ao abrir um tela contendo o tag especificado.
Always: O IWS executa uma atualizao em Taxa de Atualizao de Leitura (Read Update Rate)
especificado no header da planilha.
Para rodar o modulo run-time do OPC client, pode-se faz-lo rodar automaticamente no start up ou
rod-lo manualmente, selecionando Project > Status da barra de menu. Aps rodar esse programa,
um pequeno cone aparecer em seu sistema.
Para fechar o modulo de run-time OPC client, clique com o Boto direito no cone exibido no
sistema e clique em Exit.
Nota:
O IWS e o CEView tambm fornecem um modulo de comunicao OPC Server
chamado Studio.Scada.OPC. Esse mdulo inicia-se automaticamente quando
qualquer OPC Client (local ou remoto) tenta conectar-se com o servidor
Studio.Scada.OPC server. Um OPC Client pode trocar dados com tags do IWS
(Tags da Aplicao, Tags internos e Tags Compartilhados) utilizando a interface
OPC.
Alm disso pode-se iniciar o mdulo OPC Server automaticamente ao iniciar a
Aplicao. Selecione o mdulo OPC Server no dilogo Project > Status clique no
Boto Startup e especifique Automatic.

= Dica:
Tambm pode-se utilizar a interface OPC para trocar dados entre estaes remotas
rodando o IWS ou CEView. Deve-se configurar o OPC Client em uma estao, e deve-se
executar o OPC Server em uma outra estao.
Resolvendo Problemas de OPC
Ao utilizar o OPC e ter problemas ao estabelecer comunicao, deve-se verificar as mensagens
exibidas em LogWin.
Caso voc esteja utilizando o Windows CE, existem dois modos de verificar o log:
1. LogWin Remoto
2. Log Local
Para informaes sobre a utilizao desses logs, consulte "Utilizando o Mdulo LogWin (NT e CE)"
no Guia dos Usurio e Manul de Referncias Tcnicas.
Caso voc encontre mensagens de erro no log, procure-as nesse sistema de ajuda (manual), e siga
os passos mostrados na documentao para a resoluo 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 tcnico e, de
imediato, fornea-lhe as seguintes informaes:
1. Log file
2. Vendedor do Software e o nome do produto do OPC Server/Client que est sendo utilizado
3. Se possvel, uma cpia ou verso vlida do OPC Server para testes
IWS 20/06/2007

InduSoft Web Studio

Pgina 348
4. Informaes de contato para o suporte tcnico de seu OPC Server/Client
Trs possveis erros e suas solues esto listadas abaixo:
Segurana
Error Code: 0x80070005 or -2147024891
Razo de erro: Quando um OPC Client tenta conectar-se ao the OPC Server,a camada DCOM
geralmente requer autenticao. O computador que est rodando o OPC Server necessita
reconhecer o usurio logado ao computador OPC Client, assim como um usurio necessita de
privilgios para acessar o OPC Server.
Soluo: O primeiro passo criar um usurio nico em ambos os computadores que tenha
privilgios de Administrador e a mesma senha. Faa l log desse usurio, e em seguida tente
estabelecer a conexo.
Caso voc no possa utilizar o mesmo usurio em ambos os computadores por alguns
requisitos especficos de sua aplicao, ou caso o problema persista mesmo aps voc ter
logado com o mesmo usurio, leia a documentao abaixo, a qual ajudar a resolver os
assuntos relacionados a segurana:
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 resoluo no nome do computador.
Solution: Esse problema pode ser resolvido especificando-se o endereo IP do servidor ao inves
do nome especificado no computador.
Proxy for Windows CE
Error: OPCServer: IIndCP::Advise - Could not query callback interface: 0x80040155
Reason for error: Est faltando o OPCCOMN_PS.dll em seu equipamento Windows CE.
Solution: Deve-se fazer o download de .dll para o equipamento, bem como registr-lo. .dll deve
estar disponvel junto a distribuio do Studio, provavelmente em <Studio installation folder>\
Redist\Wince <x.x>\<processor>\
Caso voc no encontre .dll na pasta de seu processador, entre em contato com seu
distribuidor do Studio.
Configurando um OPC Server
O modulo OPC Client do InduSoft Web Studio permite que o sistema comunique-se com qualquer
equipamento que implemente um OPC Server. Veja a documentao do fabricante para instrues
de configurao.
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 estaro automaticamente disponveis. Pode-se ter mltiplas
aplicaes. Somente os tags da aplicao atual estaro disponveis.
Configurando TCP/IP
Os mdulos TCP/IP Client/Server do IWS permitem que duas ou mais aplicaes InduSoft mantenham seus
bancos de dados sincronizados. Tais mdulos utilizam o protocolo TCP/IP da InduSoft para estabelecer
comunicao entre as aplicaes.
IWS 20/06/2007

InduSoft Web Studio

Pgina 349
Antes de utilizar os mdulos IWS TCP/IP Client/Server, deve-se instalar e configurar o protocolo TCP/IP nas
mquinas que rodaro esses mdulos.
Configurando Client
Na mquina do cliente, deve-se utilizar a planilha TCP/IP Client Configuration para configurar o
endereo IP do Server e os tags que voc deseja compartilhar com o servidor.
E Em Workspace, selecione o tab COMM e clique com o Boto direito na pasta TCP para inserir
uma nova planilha TCP.
E Configure os campos que se seguem:
Description: Digite uma descrio da planilha para fins de documentao. O mdulo TCP/IP Client
ignorar esse campo.
Connection Status: Digite o nome de um tag. O mdulo TCP/IP Client atualiza esse tag de acordo
com o status da conexo. Caso o valor do tag seja 0 (zero), a conexo est OK. De outra forma, a
biblioteca Windows enviar um cdigo 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 Endereo IP do servidor. A entrada pode ser um string ou um tag entre
parnteses. Por exemplo, caso voc preencha esse campo com {tag_name}, o mdulo TCP/IP Client
tentar conectar-se ao servidos indicado pelo tag tag_name.
Tag Name: Digite os tags que voc deseja compartilhar com o servidor. Caso o tag seja um array ou
class (ou ambos), cada elemento e membro ser compartilhado. Deve-se digitar o nome do tag
somente nesse campo sem especificar o ndice ou membro de classe. Caso voc especifique um
ndice ou classe, o mdulo TCP/IP Client ir ignor-lo.
Remote Tag: Digite o nome do tag a ser estabelecido um link com o tag especificado no campo Tag
Name. Esse campo opcional. Deixando-o em branco, o mesmo nome do tag utilizado para ambos,
client e server.
C Ateno:
Caso seja necessrio compartilhar um tag array, o tag no servidor dever conter o
mesmo nmero de elementos de um tag em client. Caso seja um classe tag, a definio
de classe dever ser a mesma em aplicaes server e client. Caso voc no siga tais
regras, resultados inesperados podero acontecer.

Configurando Parmetros Customizados
Pode-se configurar os parmetros que se seguem no arquivo Aplication Configuration (.APP)
(selecione Project Settings na barra de menu principal):
[TCP] Port: Nmero da Porta TCP/IP. O padro 1234. Esse parmetro deve ser o mesmo para
as mquinas server e client.
SendPeriod: Perodo em milissegundos antes de o mdulo client/server atualizar os valores do
tag de outra mquina. O padro 250.
ConnectRetryTimeout: Perodo em segundos antes que o cliente possa tentar reconectar-se ao
servidor. O padro 30.
Somente o modulo client utiliza ConnectionRetryTimeout.
Pode-se rodar o Mdulo TCP/IP Client de forma manual ou automtica. Da barra de menu
principal, selecione Project Status. No tab Execution Tasks, configure TCP/IP Client Runtime
para Manual ou Automatic.
IWS 20/06/2007

InduSoft Web Studio

Pgina 350
Aps rodar esse programa, um pequeno cone aparecer em seu sistema.
Configurando TCP/IP Server
Na mquina do server, no necessrio configurar qualquer parmetro, apenas rode o mdulo IWS
TCP/IP Server. Na janela do ambiente de desenvolvimento, v para o dilogo Project Settings e
configure o TCP/IP Server para rodar automaticamente. Na barra de menu principal, selecione
Project Status. No tab Execution Tasks, configure o TCP/IP Server para Automatic. Ao rodar esse
programa, um pequeno cone aparecer em seu sistema.
Para fechar o mdulo TCP/IP Server do IWS, clique com o Boto direito no cone do sistema e
selecione Exit.
Configurando DDE
A pasta DDE permite a configurao de um DDE Client para uma aplicao DDE Server, como em Excel (ou
qualquer outro programa do Windows que suporte tal interface).
Dynamic Data Exchange (DDE) um protocolo para troca dinmica de dados entre aplicaes do Windows,
como Excel. Uma conversao DDE uma interao entre aplicaes server e client. O IWS prove interfaces
qe rodam como clients ou servers. Veja DDE Client Runtime e DDE Server em Execution Tasks (Project
Status).
Para rodar como server, inicie a tarefa DDE ou NetDDE como descrito em Execution Tasks.
Para rodar como client, configure a planilha de interface DDE no tab Comm.
Network Dynamic Data Exchange (NetDDE) uma extenso do DDE que funciona atravs de
computadores de uma rede de trabalho.
Para rodar o IWS como server para uma conexo NetDDE, deve-se iniciar a aplicao DDE
Server.
Para rodar o IWS como client para uma conexo NetDDE, utilize as mesmas planilhas de
interface DDE com a configurao apropriada para enderear uma aplicao 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 padro, o mdulo DDE Client do IWS suporta DDE Servers que suportam dados de
string em formato UNICODE. Caso o DDE Server suporte dados de string em formato
ASCII ANSI, a configurao a seguir dever ser inserida manualmente no arquivo
<AplicaoName>.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 Boto direito na pasta DDE e clique na tela.
Uma nova planilha DDE aparecer:
IWS 20/06/2007

InduSoft Web Studio

Pgina 351

Planilha DDE
O dilogo da planilha DDE dividido em duas reas:
rea Header (seo acima), contm informaes para todo o grupo, e define tags para iniciar a
leitura, registro e recebimento do status da conexo
rea Body (seo abaixo), onde voc define tags na aplicao e itens relacionados a aplicao
DDE server
Cada interface DDE baseada no endereamento da aplicao, utilizando as trs estruturas a
seguir:
Nome da Aplicao
Tpico
Item
Configurando DDE Server
A primeira tarefa encontrar esses identificadores na aplicao DDE Server.
Utilize os parmetros da rea Header da planilha DDE client como se segue:
Campo Description: Digite uma descrio da planilha DDE para fins de documentao.
Campo Aplicao Name: Digite o nome da Aplicao do DDE server.
Campo Topic: Especifique um tpico na Aplicao server.
Campo Connect: Digite um tag para controlar a conexo do DDE client do IWS e a aplicao
DDE server. Quando esse tag for configurado como 1, ele requisitar uma conexo ao servidor.
Caso a conexo no seja possvel ou falhe, o IWS configure o zero novamente para zero. Caso a
conexo 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 parmetro somente
com DDE local; no 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: Contm o status do comando de leitura.
Campo Write Trigger: Digite um tag para habilitar o IWS a gerar comandos poke ao server.
IWS 20/06/2007

InduSoft Web Studio

Pgina 352
Campo Enable Write on Tag Change: Digite uma valor de tag maior que zero para habilitar o
driver de comunicao para verificar continuamente alteraes nos valores do tag da planilha.
Quando o driver detecta uma ocorrncia de alterao, o driver registrar o tag alterado no
equipamento, juntamente ao endereo do tag.
Campo Write Status: Contm o status do comando de registro.
Utilize os parmetros 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 aplicao DDE server.
Campo Item: Digite o espao ITEM do endereo DDE no server. Consulte a documentao de
seu software para informaes sobre a sintaxe apropriada para APP, TOPIC, e ITEM.
Pode-se configurar os campos Topic e Item com tags no endereo utilizando a seguinte sintaxe:
text {tag}. O IWS valida o valor do tag {tag} para um string e utiliza-o no endereo. Por exemplo:
Topic: topic_{tag_topic_name}_example
Item: {tag_item_name} or A{tag_number}
Configurar uma conexo NetDDE semelhante a configurar uma conexo DDE, exceto pelo nome e
tpico do Header da aplicao. Antes de iniciar seus testes, verifique que o DDE Server foi
habilitado na estao com a qual voc deseja trocar dados.
Nota:
Ao conectar-se a outros servidores que no sejam o IWS, consulte a documentao do
servidor para informaes sobre a sintaxe apropriada de APP, TOPIC, e ITEM.

Utilize a planilha os parmetros Header da planilha NetDDE Client para definir os tags que iniciam
a leitura e registro, alm dos tags que recebem o status da conexo, como se segue:
Campo Aplicao Name: Digite <computer name>\NDDE$, onde <computer name> deve ser o
nome vlido de uma rede de trabalho.
Campo Topic: Digite o nome do tpico UNISOFT$ para conectar-se a outra estao do IWS.
Utilize os parmetros Body da planilha DDE client para relatar cada tag a cada espao ITEM do
endereo 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.
IWS 20/06/2007

InduSoft Web Studio

Pgina 353
Captulo 11: Configurando um Sistema de Segurana
Utiliza-se o dilogo Security System para criar grupos e usurios, configurando privilgios de acesso s
ferramentas e aplicaes do InduSoft Web Studio.
Para acessar esse dilogo, clique com o boto direito na pasta Security no tab Database e selecione Settings
do menu pop-up.

Dilogo Security System
Esse dilogo contm os seguintes recursos:
check-box Enable Security System: Habilite ( ) esse box para capacitar o Sistema de
Segurana do IWS.
Boto Main Password: Abre o dilogo Security System Main Password para que voc possa
definir senhas que garantam o acesso ao sistema de segurana.
Boto Groups: Abre o dilogo Groups, onde voc cria e mantm o grupo de usurios.
Boto Users: Abre o dilogo Users, onde voc cria e mantm usurios.
Painl VK: Tipo de Virtual Keyboard utilizado para os dilogos Security System (LogOn, Change
Password, etc). necessrio habilitar a opo Virtual Keyboard na interface Project Settings
Runtime Desktop antes de configurar o Virtual Keyboard para essa interface.
Inserindo uma Senha
Ao clicar no boto Main Password, o dilogo Security System Main Password abre, a fim de que voc
possa inserir uma senha para acesso ao Sistema de Segurana do InduSoft Web Studio.

Dilogo Security System Main Password
Esse dilogo contm 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.
IWS 20/06/2007

InduSoft Web Studio

Pgina 354
C IMPORTANTE!
Aps definir sua senha, voc dever utiliz-la cada vez que acessar o Sistema de
Segurana, portanto, imprescindvel que voc recorde essa senha.

Definindo Grupos
O dilogo Group Account capacita a criao e manuteno de grupos de usurios, habilita/desabilita
operaes e configure escalas de nvel de segurana para sistemas de desenvolvimento e runtime.
Acessa-se esse dilogo clicando no boto Groups Account no dilogo 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.

Dilogo Group Account
O recursos desse dilogo incluem:
combo-box Group Account: Identifica o grupo ao qual o usurio pertence.
Nota:
No pode-se deletar o grupo Guest (um grupo padro).

Campos Security Level Development fields and Security Level Runtime: Define o nvel de
segurana 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 nvel de segurana do objeto no esteja na escala de segurana do
grupo do usurio logado no momento, esse objeto no estar habilitado. Um nvel 0 (zero) significa que o
objeto est sempre habilitado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 355
check-boxes Engineering Access: Controla quais tarefas de engenharia (desenvolvimento) os
usurios desse grupo podero acessar ao efetuarem log on.
C IMPORTANTE!
possvel configurar o nvel de segurana para documentos (como planilhas e
telas) para assim proteg-los no ambiente de desenvolvimento.

check-boxes Runtime Access: Controla quais mdulos de runtime os usurios desse grupo
podero acessar ao efetuarem log on.
boto New: Abre o dilogo New Group Account utilizado na criao de novos grupos.
boto Delete: Deleta o grupo do usurio selecionado atualmente.
Antes de iniciar a configurao de seu sistema de segurana, deve-se decidir quais grupos e
usurios voc deseja que sejam configurados. Deve-se definir os direitos de cada grupo em seu
ambiente.
Utilize o seguinte procedimento para criar esse grupos:
E Em Workspace, selecione o tab Database e clique duas vezes na pasta Security para visualizar
as sub-pastas.
E Clique com o boto direito na pasta Group e selecione Insert Group no menu pop-up:

Inserindo um Group
O dilogo Group Account aparecer:

Dilogo Group Account
IWS 20/06/2007

InduSoft Web Studio

Pgina 356
Lembre-se de que no possvel deletar o grupo padro chamado Guest, devendo-se assim criar um novo
grupo, como se segue.
E Clique no boto New e quando aparecer o dilogo New Group Account, digite um nome do grupo
no campo fornecido. (Nesse exemplo, digite Operation.) Clique em OK para fechar o dilogo.

Inserindo o Group Name
E Retorne para o dilogo Group Account e caso o nome de uma nova conta no aparecer, selecione
Operation no combo-box Group Account.
E Configure os direitos de acesso para esse grupo, como se segue:

Direitos de Acesso: Operation
E Clique no boto New novamente e crie o grupo Maintenance. Clique em OK para fechar o
dilogo New Group Account.
IWS 20/06/2007

InduSoft Web Studio

Pgina 357
E Selecione Maintenance no combo-box Group Account e configure os direitos de acesso para o
grupo, como se segue:

Direitos de Acesso: Maintenance
E Repita o procedimento mais uma vez para criar a Group Account Development.
E Selecione Development no combo-box Group Account e configure os seguintes direitos de
acesso:
IWS 20/06/2007

InduSoft Web Studio

Pgina 358

Direitos de Acesso: Development
E Clique em OK para salvar essa configurao.
Notas:
Cada grupo possui uma escala para nvel em desenvolvimento e runtime. Em algumas
planilhas (por exemplo, na planilha Math), pode-se configurar um nvel de acesso para
prover o grupo com acesso configurao dessa planilha.
Ao logarem-se no sistema, os usurios devero estar associados ao grupo especfico,
com escala de nvel de acesso (desenvolvimento) para a determinada planilha.
Pode-se tambm configurar nveis de acesso de modo que somente usurios
autorizados possam executar comandos (scripts) configurados no ambiente de
desenvolvimento.

Definindo Usurios
A seguir, deve-se criar novos usurios e associ-los a contas de grupos j criados. Siga os seguintes passos:
E Em Workspace, selecione o tab Database e clique duas vezes na pasta Security para visualizar
as subpastas.
E Clique com o boto direito na pasta Users e selecione Insert User no menu pop-up.
IWS 20/06/2007

InduSoft Web Studio

Pgina 359

Inserindo Novos Usurios
O dilogo User Account aparecer:

Dilogo User Account
Lembre-se de que no possvel deletar o usurio padro Guest. Deve-se criar novos usurios, como se
segue.
E Clique no boto New e o dilogo New User Account aparecer. A seguir, digite um nome do
usurio nesse campo. (Nesse exemplo, digite Operator_1.) Clique em OK para fechar o dilogo.

Criando Operator_1 User
E Para associar esse usurio conta de grupo, retorne para o dilogo User Account e verifique se
Operator_1 ainda aparece no combo-box User.
E Selecione Operation no combo-box Security Group.
IWS 20/06/2007

InduSoft Web Studio

Pgina 360

Conta do Usurio Operator
E Para especificar uma senha para esse usurio, clique no boto Password e o dilogo User
Password. Digite oper_1. Clique em OK para fechar o dilogo.
E Reabra o dilogo User Account e adicione o prximo usurio:
Clique no boto New e quando aparecer o dilogo New User Account, digite MaintEng_1 no campo User
Name. Clique em OK para fechar o dilogo.
Associe esse usurio conta de grupo Maintenance e clique em Password para definir main_1 como a sua
senha.

Criando MaintEng_1 User
E Reabra o dilogo User Account mais uma vez, e adicione o ltimo usurio, como se segue:
Clique em New e crie o usurio Developer_1.
Associe esse novo usurio conta de grupo Development e especifique deve_1 como sua senha.

Criando Developer_1 User
E Clique em OK para salvar a configurao.
Agora, caso voc queira ampliar a pasta Security, voc dever abrir todas as subpastas e verificar os
grupos e usurios recm criados.
IWS 20/06/2007

InduSoft Web Studio

Pgina 361

Viso ampla dos Grupos de Segurana e Usurios
Nota:
Pode-se tambm utilizar a funo CreateUser para a criao de novos usurios. Junto
aplicao, os usurios criados dessa maneira aparecero na pasta Users.

Botes de configurao
Pode-se utilizar o check-box User is blocked e o boto Settings (o qual substitui o boto Password
utilizado anteriormente) para controlar o acesso do usurio aplicao. Pode-se tambm acessar
esses recursos a partir do dilogo User Account.
Siga os seguintes passos para abrir esse dilogo e configurar o acesso do usurio:
E Em Workspace, amplie a pasta Security e clique com o boto direito em um nome do usurio.
E Quando o menu pop-up aparecer, selecione Properties para abrir o dilogo User Account:

Security User Properties: Dilogo User Account
E Se necessrio, clique no check-box User is blocked para bloquear o usurio selecionado.
E Clique no boto Settings para abrir o dilogo Settings:
IWS 20/06/2007

InduSoft Web Studio

Pgina 362

User Account: Dilogo Settings
E Configure os parmetros desse dilogo como se segue:
text box User Full Name (opcional): Digite o nome complete do usurio.
text box New Password: Digite a senha do usurio.
text box Confirm Password: Digite a senha do usurio novamente.
E Ao terminar, clique em OK para aplicar as alteraes, e a seguir feche o dilogo Settings.
IWS 20/06/2007

InduSoft Web Studio

Pgina 363
boto Advanced
Pode-se utilizar o boto Advanced para controlar o acesso do usurio Aplicao, atravs do
dilogo User Account.
Siga os seguintes passos para abrir esse dilogo e configurar o acesso do usurio:
E Em Workspace, amplie as pastas Security e Groups, e clique o boto direito em um nome de
grupo.
E Quando aparecer o menu pop-up, selecione Properties para abrir o dilogo Group Account.

Clique com o boto direito em Properties
E Clique no boto Advanced para abrir o dilogo Advanced:

Group Account: Selecionado o boto Advance
IWS 20/06/2007

InduSoft Web Studio

Pgina 364

Group Account: Dilogo Advanced
E Configure os parmetros no dilogo Advanced como se segue:
text box Minimum Password Size: Digite um valor maior do que 0 nesse campo para requisitar um nmero
mnimo de caracteres para uma senha. Todos os usurios assinalados para esse grupo devero fornecer a
uma senha contendo um nmero mnimo de caracteres. Caso o usurio tente criar uma senha com menos
caracteres do que o nmero requisitado, o InduSoft Web Studio rejeitar a senha e exibir a seguinte
mensagem de aviso:

Mensagem de Aviso para Senha Invlida
text box Password aging: Digite um valor maior do que 0 nesse campo para estabelecer a durao (em dias)
de uma senha. Aps a especificao do nmero de dias de validade, InduSoft Web Studio forar os
usurios assinalados nesse grupo a alterar suas senhas. Ao tentar logar-se com a senha antiga, o dilogo
Change Password aparecer automaticamente para o usurio, e esse no poder completar o processo de
log-in at que a nova senha seja fornecida.
IWS 20/06/2007

InduSoft Web Studio

Pgina 365

Dilogo Change Password
text box E-signature time-out: Digite um valor maior que 0 nesse campo para especificar um perodo time-
out (em minutos). Os usurios assinalados nesse grupo devero inserir seus User ID e senha antes que o
perodo de timeout especificado expire, para assim poderem executar os comandos que requeiram uma
assinatura eletrnica. Antes do perodo de timeout expirar, o usurio sera questionado a respeito de sua
senha o sistema assume de forma automtica o username logado na ltima assinatura eletrnica. O
sistema reinicia a contagem de time-out logo aps uma assinatura eletrnica ser executada.
text box Disable E-signature: Quando o valor neste campo for VERDADEIRO (diferente de zero), a assinatura
eletrnica desabilitada para a aplicao inteira. Ao configurar um Tag neste campo, voc pode
permitir/incapacitar a assinatura eletrnica dinamicamente durante o runtime.
Auto Log Off: Permite que voc desconecte o usurio atual automaticamente
text box Log Off after: O nmero de minutos depois do qual o usurio atual deve ser desconectado
automaticamente. Se este campo estiver em branco (ou com o valor 0), o usurio atual nunca ser
desconectado automaticamente
radio button Count time after logon: Quando esta opo selecionada, o usurio atual desconectado
automaticamente aps o perodo de tempo configurado no campo Log Off after desde quando o usurio
atual conectar ao sistema
radio button Count time after last action: Quando esta opo selecionada, o usurio atual desconectado
automaticamente aps o perodo de tempo configurado no campo Log Off after desde que a ltima ao
(ao do mouse ou do teclado) foi executada pelo usurio 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 mximo de
tentativas permitidas a um usurio para logar-se a uma conta. Caso o usurio exceda o
nmero mximo de tentativas (fornecendo senhas invlidas), o InduSoft Web Studio
bloquear a conta do usurio.
* text-box Reset counter after: Digite um valor nesse campo para definir por quanto
tempo, aps uma tentativa invlida, o InduSoft Web Studio esperar (em minutos) at
que se reinicie a contagem de tentativas.
Nota:
Quando um usurio exceder o nmero especfico de tentativas de log-on, o InduSoft
Web Studio bloquear automaticamente, e no reiniciar a contagem aps Reset
counter after expirar. O Administrador do Sistema dever reiniciar a conta do
usurio desabilitando o check-box User is blocked no dilogo User Account ou
executando a funo UnblockUser().
Um crculo vermelho no nome do usurio em Workspace indica que o usurio est bloqueado. Alm disso, o
box User is blocked estar habilitado. As figuras a seguir so exemplos que indicam que o usurio Eng est
bloqueado:
IWS 20/06/2007

InduSoft Web Studio

Pgina 366

Exemplo: Usurio bloqueado
E Ao terminar, clique em OK para aplicar suas alteraes e feche o dilogo Advanced.
Sistema de Segurana Remoto
Caso a sua aplicao seja conectada atravs de um link TCP/IP, possvel designar uma de suas
estaes como o sistema de segurana Central, a partir da qual outras estaes posam utilizar as
definies de Users e Groups. A figura a seguir ilustra essa configurao:

Sistema de Segurana Remoto
Siga o seguinte procedimento para configurar um sistema de segurana central:
E Clique com o boto direito na pasta Security no tab Database e selecione Settings no menu pop-
up para abrir o dilogo Security System:

Clique com o boto direito em: Security Settings
IWS 20/06/2007

InduSoft Web Studio

Pgina 367
E Habilite o novo check-box Use preferentially the Remote Security System para designar um
sistema de segurana remoto.
Caso a aplicao remota seja conectada com sucesso ao sistema de segurana da estao Server, sera
utilizado o sistema de segurana configurado nessa estao. Nesse caso, qualquer alterao implementada
no sistema de segurana da Estao Server ser incorporada automaticamente pela aplicao remota. As
funes do sistema de segurana (como CreateUser(), RemoveUser(), ChangePassword(), etc) sero
atualizadas no sistema de segurana da estao Server mesmo se as funes forem executadas a partir
de uma aplicao remota. Como resultado, todas as aplicaes em um sistema distribudo podem
compatilhar das configuraes de um mesmo sistema de segurana.
Caso o sistema remoto no esteja rodando ou no possa ser alcanado e a aplicao no 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
Alm disso, a aplicao se reverter utilizando-se das configuraes de segurana do computador
local. A aplicao remota tentar conectar-se estao Server do sistema de segurana apenas
quando houver um evento associado ao sistema de segurana (como um logging on de usurio), ou
seja, no h polling entre a aplicao remota e a estao Server durante o runtime.
Configurando o Nvel de Acesso de Segurana
Pode-se utilizar os check-boxes Security Level-Development para configurar uma escala nica de
valores para cada grupo de usurio. Pode-se tambm configurar uma escala nica para qualquer
planilha do InduSoft Web Studio (Alarm, Math, Recipe, Report, Scheduler, TCP Client, Trend, e
aquelas que no esto disponveis em CE: DDE Client, OPC Client, e ODBC).
Clicando em qualquer ponto da planilha pode-se ativar a opo Edit Access Level da barra de
menu principal, o que abrir o dilogo Security, o que permitir assinar um Access Level para
aquela planilha.

Dilogo Security
Assinar um nvel de segurana para uma planilha significa que um usurio poder ter um nvel de
acesso que caia com o Nvel de Segurana especificado escala de Desenvolvimento para editar
aquela planilha.
Por exemplo, UserA de GroupA possui uma escala de nvel de acesso de segurana 0-10 e UserB de
GroupB possui um escala de nvel de acesso de segurana de 5-15. Continuando o exemplo:
Planilha Math 001 tem Nvel de Acesso = 1
Consequentemente,
Somente UserA pode acessar a Planilha Math 001
Ambos os usurios podem acessar a Planilha Math 002
Somente UserB pode acessar a Planilha Math 003
IWS 20/06/2007

InduSoft Web Studio

Pgina 368
Nenhum usurio pode acessar a Planilha Math 004
Definindo Usurios
Clique no boto User Account para abrir o dilogo User Account. Pode-se utilizar esse dilogo para criar e
manter contas de usurio para sua Aplicao. (Os usurios definidos em sua aplicao para cada grupo
utilizando o dilogo Group Account.)
Nota:
Alternativamente, pode-se acessar o dilogo User Account da pasta Users localizada na
pasta Security no tab Database ou selecionando Insert User na barra de menu
principal.

Dilogo User Account
Utilize os recursos nesse dilogo como se segue:
combo-box User: Selecione de uma lista de usurios da aplicao.
combo-box Security Group: Selecione de uma lista de grupos da Aplicao.
Boto New: Abra o dilogo New User Account para criar um novo usurio.
Boto Delete: Deleta o usurio selecionado.
Boto Password: Abre um dilogo User Password para definir senhas do usurio.

Dilogo User Password
Especificando Usurios Guest
Aps iniciar o InduSoft Web Studio, um usurio estar logado como um usurio Guest (por padro).
Caso nehum dos outros usurios efetuem log on ou o usurio atual efetue log off, o InduSoft Web
Studio loga automaticamente o usurio Guest.
O grupo Guest possui privilgios padro. Os parmetros da instalao do grupo Guest permitem
que todas as tarefas sejam habilitadas por padro. Devido a isso, voc dever alterar esses
parmetros e configurar alguns poucos privilgios medida que sejam necessrias para o
procedimento de start-up.
IWS 20/06/2007

InduSoft Web Studio

Pgina 369
Logging On/Off
Aps definir os nomes do usurio e suas senhas, utilize a utilidade Logon (Project Logon) para logar
usurios em on e off.
Deforma alternativa, pode-se utilizar as funes de ativao de linguagem de Scripting do InduSoft Web
Studio LOGON( ) e LOGOFF( ) para logar ou deslogar usurios (on/off).

Dilogo Log On
Utilize os recursos desse dilogo como se segue:
Campo User Name: Insira o nome do usurio para efetuar log on.
Campo Password: Insira a senha do usurio.
Boto Log Off: Clique para efetuar log off do usurio atual.
Nota:
Quando um Logoff executado, o usurio Guest torna-se logado de forma automtica.

IWS 20/06/2007

InduSoft Web Studio

Pgina 370
Captulo 12: Testando e Corrigindo Erros em Sua Aplicao
Esse captulo explica como utilizar as diferentes ferramentas do IWS para testar e corrigir erros nas
aplicaes de seu projeto.
Testando sua Aplicao
Utilize os procedimentos a seguir para testar sua Aplicao:
Project Test Display: Ativa o modo de exibio, o qual permite a configurao da aplicao ao
mesmo tempo que visualiza dinmicos grficos online no ambiente de desenvolvimento. O modo
de exibio teste no habilita a utilizao Command, dinmicos Text I/O de entrada ou
execuo de planilhas.
Nota:
Utilizando a opo do menu Test Display o mesmo que utilizar o boto na
barra de ferramentas Execution Control.

Project Stop display test: Pra o modo de exibio teste.
Nota:
Utilizar a opo do menu Stop display test o mesmo que utilizar o boto na

Project Run Application: Inicia os mdulos de runtime especificados como Automatic no
dilogo Project Status (tab Execution Tasks).
Ao iniciar o mdulo Viewer, abre-se uma tela (s) que et sendo atualmente editada.
Caso voc no queira especificar nenhuma tarefa como Automatic, o InduSoft Web Studio iniciar as
tarefas Viewer e BGTask automaticamente ao executar Run Application.
Caso voc no esteja editando telas atualmente no ambiente de desenvolvimento, o mdulo Viewer abrir a
tela especificada no campo Startup screen no tab Runtime Desktop (dilogo Project Settings).
Nota:
Utilizar a opo do menu Run Application o mesmo que utilizar o boto na

C Ateno:
Run Application afeta a aplicao a partir da target station (configurada no dilogo
Execution Environment). Certifique-se de que a target station desejada esteja
configurada (local ou remota) antes de executar o comando Run Application.

Project Stop Application: Pra todas as tarefas de runtime.
C Caution:
Stop Application afeta a aplicao a partir da target station (configurada no dilogo
Execution Environment). Certifique-se de que a target station desejada esteja
IWS 20/06/2007

InduSoft Web Studio

Pgina 371
configurada (local ou remotamente) antes de executar o comando Stop Application.

Nota:
Utilizar a opo do menu Stop Application o mesmo que utilizar o boto na

Corrigindo Erros da Aplicao a partir do Database Spy
Notas:
A output window reposicionvel, significando que pode-se mov-la para outro local do
ambiente de desenvolvimento. Clique uma vez na barra de ttulo e arraste-a para o
novo local.. Solte o mouse para anexar ou reposicionar a janela para sua nova
localizao.
Para uma descrio da janela Database Spy e seus componente, reveja Utilizando o
cone Database Spy no Captulo 3: Trabalhando com o Ambiente de Desenvolvimento do
IWS.

O Database Spy uma ferramenta de correo de erros muito til, j que habilita:
Envio de valores para o tag databases e monitoramento de resultados
Executar diferentes funes e equaes

Amostra da Janela Database Spy
O Database Spy contm quarto tabs DB onde pode-se inserir grupos de tags, funes e/ou
expresses as quais voc deseja testar e corrigir erros.
Cada tab DB contm uma spreadsheet com os seguintes componentes
Name: Exibe o tagname e/ou funo a ser validada nessa linha.
Value: Exibe valores de retorno e resultados de equaes
Quality: Exibe uma validao da qualidade (Good ou Bad) do tag ou da origem da funo
Continuous: Exibe se o IWS est revalidando tags, funes e equaes continuamente.
A criao de diferentes grupos habilita o gerenciamento de mltiplas tarefas de teste/correo de
erros. Por exemplo, pode-se criar um conjunto de tags em DB1 para testar uma funo de receita, e
criar um outro grupo de tags em DB2 para testar a funo de tendncia.
IWS 20/06/2007

InduSoft Web Studio

Pgina 372
Para testar sua aplicao com a utilizao do Database Spy, siga o processo a seguir para
configurar a spreadsheet:
E Clique duas vezes em uma linha vazia na spreadsheet para abrir o dilogo Object Finder
Pode-se utilizar o dilogo Object Finder para adicionar tags, expresses ou funes para a coleo de dados
do processo. Pode-se utilizar o dilogo 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 funo, faa uma cpia da funo e utilize o disparador
Database Spy ao invs de rodar a aplicao vrias vezes no ambiente de desenvolvimento.
Nota:
Algumas funes, como report(), recipe() e math(), devem ser executadas como
Background Tasks durante o runtime para funcionarem de maneira apropriada.
Corrigindo Erros da Aplicao a partir da Janela Output
Utilize a output window(LogWin) (localizada prxima ao Database Spy) para visualizar mensagens de
correo 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 comunicao serial com um PLC.
Notas:
A output window reposicionvel, significando que pode-se mov-la para outro local do
ambiente de desenvolvimento. Clique uma vez na barra de ttulo e arraste-a para o
novo local.. Solte o boto do mouse par anexar ou reposicionar a janela para sua nova
localizao.
Veja o Captulo 3: Trabalhando com o Ambiente de Desenvolvimento do IWS para uma
descrio detalhada da janela Output.

IWS 20/06/2007

InduSoft Web Studio

Pgina 373
A output windowcontm os seguintes tabs:
tab Log: Semelhante em funo ao mdulo LogWin, embora fornea funcionalidade limitada
para reduo do tempo e memria utilizada junto ao ambiente de desenvolvimento. Esse tab
utilizao princpio first-in first-out (FIFO) para gerenciar o espao disponvel.
Clique com o boto direito na output windowe o menu pop-up aparecer:

Clique com o boto direito para exibir Options
Settings: Abre o dilogo Log Settings onde voc dever especificar opes e tags os quais voc deseja que
sejam procurados e logados pelo IWS para fins de correo de erros.

Dilogo Log Settings
Utilize os dois tabs desse dilogo para especificar o tipo de informao que voc deseja que
o IWS logue e exiba na janela Output.
* tab Log Options: Habilite ( ) os check-boxes para logar os seguintes eventos:
Comandos Field Read e Field Write
Comunicao Serial
OPC, TCP/IP
Recipes/Reports
IWS 20/06/2007

InduSoft Web Studio

Pgina 374
Abrir e fechar a exibio
Log-on e Log-out
Trace, Database, DDE Messages
Inserir data e hora
* tab Log Tags: Utilize o boto Add para abrir o dilogo Object Finder, o qual pode ser
utilizado para criar uma lista de tags a serem monitoradas pelo IWS. (Os passos para
utilizar o dilogo Object Finder so fornecidas em Corrigindo Erros da Aplicao a partir
doCorrigindo Erros da Aplicao a partir do Database Spy na pgina 371.) Utilize os
botes Remove ou Remove All para deletar nomes de tag da lista.
Sempre que uma ao especfica ocorre ou um valor de tag alterado, o IWS loga os resultados na janela
Outputatravs do driver, mdulos, etc que iniciaram a alterao.
Pause: Selecione (habilite) para parar o processo de coleo de dados temporariamente, e reselecionar
(desabilitar) para resumir a coleo 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 boto direito e selecione Copy do menu pop-up. Pode-se colar os resultados
no Notepad (ou em outra aplicao) e imprimir o relatrio a partir do NotePad.
Caso voc tenha configuraes estabelecidas (Utilizando o dilogo Log Settings) no ambiente de
desenvolvimento, essas configuraes sero transferidas para sua CE station, juntamente com a aplicao,
de forma que voc possa criar um log a partir da CE station. Pode-se alterar as configuraes a partir de
sua CE station, ou alterar as configuraes 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 aplicao
onde o tag est sendo utilizado. Os resultados aparecem nesse tab, fornecendo o caminho e o
nome do arquivo, coluna e linha na spreadsheet. Assim, caso algo altere-se no tag e produza
resultados inesperados ou incorretos, pode-se localizar todos os exemplos do tag para correo
de erros.
Notas:
O tab X-Ref no trabalha para Funes, somente tags, embora permita a procura de
ndices.
Veja tambm Utilizando o cone Object Finder, no Captulo 3: Trabalhando com o
Ambiente de Desenvolvimeto do IWS.
Utilizando o Mdulo LogWin (NT e CE)
Esse modulo fornece um histrico continuo de atividades e tags para correo de erros em grandes perodos
de tempo. Ele cria um arquivo no qual voc pode dump os resultados da coleo de dados, e esse arquivo
continua a crescer em tamanho at que voc pare o processo de logging (coleo de dados). Utilize o mdulo
LogWin (local e remoto) para gravar transaes DDE, OPC, e TCP/IP, ativar mdulos, traar tags, etc.
IWS 20/06/2007

InduSoft Web Studio

Pgina 375
Para iniciar LogWin, v para Project Status localmente ou selecione LogWin do menu Tools no
box CE.

Iniciando LogWin
Para corrigir erros em Web client, habilite Log selecionando Project Settings da barra de menu, e
depois selecionando o aba Web. Habilite o check-box Enable e digite path+filename na opo
FileName. Ao terminar, selecione OK.
IWS 20/06/2007

InduSoft Web Studio

Pgina 376

Corrigindo erros em Web Client

Utilizando Ferramentas Remotas
O InduSoft Web Studio oferece gerenciamento e configurao da aplicao online (download/upload,
comandos, diagnsticos do sistema e rede de trabalho, alm de coreo de erros). Pode-se configurar e
corrigir erros das aplicaes remotamente, utilizando um link TCP/IP.
Pode-se utilizar a barra de ferramentas Execution Control para executar e gerenciar uma aplicao
localmente ou a partir de um local remoto.

Barra de Ferramentas Execution Control
boto Test Display ( ): Permite rodar em modo teste de exibio, o qual permite a
configurao de uma aplicao enquanto visualize-se dinmicos grficos online no ambiente de
desenvolvimento.
boto Stop Test Display ( ): Permite parar de rodar o modo teste de exibio.
boto Run Application ( ): Permite iniciar quaisquer mdulos de runtime especificados como
Automatic.
boto Stop Application ( ): Permite parar todas as tarefas de runtime.

C Ateno:
Stop Application afeta a aplicao a partir da target station (configurada no dilogo
Execution Environment). Certifique-se de que a target station est configurada (local ou
remotamente) antes de executar Stop Application.
IWS 20/06/2007

InduSoft Web Studio

Pgina 377
boto Send project to target ( ): Permite enviar a aplicao para a target station remota.
boto Execution Environment ( ): Permite o gerenciamento de estaes de trabalho remotas.
Com esse boto, pode-se:
Conectar-se a uma estao remota
Enviar/atualizar arquivos do sistema (somente CE)
Enviar/atualizar arquivos da aplicao
Enviar arquivos
Importar arquivos para a Aplicao
Importar logs CE
Licenciar remotamente (somente CE)
Notas:
Para uma descrio da barra de ferramentas Execution Control, veja Captulo 7:
Configurando Telas e Grficos.
Para uma descrio para Configurar o Ambiente de Desenvolvimento, veja Captulo 14:
Gerenciando Aplicaes Remotamente.
Utilizando Database Spy Remoto
Selecione a opo do menu Tools Remote Database Spy para logar-se em um computador remoto
que esteja rodando a aplicao Database Spy, e monitorar a aplicao. Quando o dilogo Remote
Computer aparecer, insira o endereo Remote IP do computador.
Nota:
Nem todos os equipamentos podem suportar o Remote Database Spy.
Utilizando LogWin Remoto
Selecione a opo do menu Tools Remote LogWin para logar-se em um computador remoto que
esteja rodando o LogWin, e monitorar a Aplicao. Quando o dilogo Remote Computer aparecer,
insira o endereo Remote IP do computador.
Notas:
Nem todos os equipamentos podem suportar o Remote Database Spy.
Para um descrio detalhada de Gerenciando Aplicaos remotamente, veja
Captulo 14: Gerenciando Aplicaes Remotamente.

IWS 20/06/2007

InduSoft Web Studio

Pgina 378
Captulo 13: Configurando uma Web Solution
Esse Captulo explica como configurar e rodar uma aplicao Web Thin Client. Aps desenvolver e testar
uma aplicao em seu computador local, o InduSoft Web Studio capacita visualizar e rodar a aplicao em
um Web Browser padro (como Internet Explorer ou Netscape) de qualquer PC padro, laptop ou
equipamento mvel.
Voc pode:
Ler e registrar dados diretamente de um PLC ou um equipamento de campo inteligente.
Atualizar dados dinamicamente, baseando-se em valores de registro atuais lidos a partir do
PLC.
Fornecer interfaces IHM (como button e text input) para enviar comandos ou setpoints para o
PLC ou equipamento.
A figura a seguir ilustra o processo de transferir uma aplicao do ambiente de desenvolvimento do
IWS para o Web Thin Client (Browser).

Visualizando aplicaes em um Web Thin Client (Browser)
O computador Data Server (Rodando IWS ou CEView) coleta dados (como equipamentos de cho de fbrica)
e envia os dados para o Web Thin Client. Um mdulo TCP/IP Server (fornecido pelo IWS e/ou CEView)
requisitado para habilitar essa comunicao.
IWS 20/06/2007

InduSoft Web Studio

Pgina 379
Nota:
O mdulo TCP/IP utiliza a porta TCP #1234 por padro. Deve-se alterar a localizao
dessa porta (por exemplo, para previnir um conflito ou assuntos relacionados
segurana, como um firewall), veja Configurando os Parmetros do Tab Options no
Captulo 6: Criando e Configurando um Projeto para maiores intrues.

O computador Web Server contm as pginas .html da aplicao (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 pginas .html com a utilizao 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 documentao Microsoft para informaes sobre como instalar e
configurar um IIS Web Server.
Data Server e Web Server podem estar em um mesmo computador (no obrigatrio).
Deve-se certificar-se de que existam firewalls entre estaes 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 pginas .html a partir do computador Web Server, e requisita um
componente ActiveX chamado ISSymbol.ocx para processor as pginas .html junto ao Browser.
Nota:
Caso seu computador no tenha um componente ISSymbol.ocx j instalado, o Web
Thin Client efetuar o download e inicializar um componente ISSymbol.ocx a partir do
site da InduSoft na Web automaticamente.
O componente ISSymbol.ocx efetua downloads de telas e arquivos de banco de dados (<Screen>.SCC,
<Screen>.TAGL, <TAGI.BIN>, <CLASS.LST>) a partir do Web Server utilizando o protocolo HTTP sobre
TCP/IP.
O componente ISSymbol.ocx tambm avalia usurios que estejam tentando logar-se ao Web Thin Client.
Aps autorizar a entrada do usurio, o ISSymbol.ocx exibe a tela da aplicao e inicializa um mdulo
TCP/IP Client virtual para troca de dados com modulo TCP/IP Server do Servidor de Dados. Esse mdulo
TCP/IP Client virtual l todos os valores do TCP/IP Server.
Ao exibir a tela de sua aplicao no Browser, o Web Thin Client e o Data Server esto habilitados a trocar
valores de dados. Consequentemente, se cada tag da tela (configurado como um tag Server) alterar seu valor
em quaisquer dos equipamentos em runtime, o novo valor do tag sera enviado imediatamente e
automaticamente para todos os outros equipamentos. No 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 aplicao, os tags
para os quais os tags indiretos esto apontando devem ser configurados na mesma tela, ou o Web Thin
Client no poder receber os valores do tag a partir do Data Server.
O Web Thin Client executa funes e expresses configuradas na tela (como o dinmico Command).
Consequentemente, caso voc tenha funes que devam ser executadas somente no Server, deve-se
configurar as funes em uma planilha Math ou Scheduler do IWS.
O restante desse Captulo explicar como configurar suas aplicaes para um Web Thin Client.
IWS 20/06/2007

InduSoft Web Studio

Pgina 380
Antes de Comear
Antes que se possa rodar sua aplicao do IWS Aplicao em um Web Thin Client (Browser), deve-
se cumprir as seguintes tarefas:
Definir uma pasta de diretrio Home para suas pginas da Web.
Instalar e registrar o componente ISSymbol.ocx ActiveX.
Certificar-se de que o IIS Web Server esteja apontando para a pasta de diretrio Home , e de
que o NTWebServer.exe do IWS ou uma cpia deste esteja rodando na pasta de diretrio Home.
Nota:
A Microsoft fornece Web servers para todos seus sistemas operacionais.
Consulte sua documentao Microsoft para informaes sobre como instalar e
configurar um Web Server.

Verificar que o TCP/IP Server est rodando.
Configurar os tags da sua aplicao para Server caso voc queira visualizar os resultados
desses tags no Browser. (Reveja Compartilhando Tags comCompartilhando Tags com um Web
Thin Client no Captulo 5: Trabalhando com Tags.)
Seguem-se instrues para executar tais tarefas.
Definindo um Diretrio Home
Deve-se definir uma pasta de diretrio Home (somente uma por computador), na qual as pginas da
web sero armazenadas. A InduSoft recomenda a utilizao da subpasta \Web, localizada na pasta
da aplicao do projeto. Por exemplo
C:\Program Files\InduSoft Web Studio\Projects\<project_name>\Web
Nota:
Para habilitar a traduo para Web Thin Clients, deve-se copiar manualmente arquivos
de traduo (*.TRA) para a pasta \Web.

Instalando e Registrando ISSymbol.ocx
Para visualizar telas das aplicaes 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 no est instalado, o IWS
conecta-se automaticamente ao site da InduSoft na Web, efetuando o download e registrando o
componente.
Pode-se copiar ISSymbol.cab da subpasta do IWS \BIN e colar no diretrio
\<OSPath>\System32, na estao Web Thin Client station. Utilize o WinZip
para
desempacotar (extrair) os arquivos do ISSymbol.cab no diretrio \<OSPath>\System32 e
registrar o ISSymbol.ocx utilizando o comando regsvr32 ISSymbol.ocx.
O caminho recomendado para registrar o ISSymbol manualmente em um computador que no possua
acesso Internet seguindo o procedimento abaixo:
Copiar ISSymbolA.cab, ISSymbol.cab e ISSymbolReg.exe da subpasta \BIN do diretrio de
instalao do InduSoft Web Studio e colar esses arquivos em qualquer diretrio da estao Web
Thin Client.
Executar o programa ISSymbolReg.exe. Ele registrar o controle ISSymbol automaticamente.
IWS 20/06/2007

InduSoft Web Studio

Pgina 381

Nota:
Ao utilizar o parmetro /s (Silent), o ISSymbolReg.exe no exibe qualquer
mensagem de texto (por exemplo, ISSymbolReg.exe /s).
Ao utilizar o parmetro /u (Unregister), o ISSymbol no est registrado (por
exemplo, ISSymbolReg.exe /u).

Rodando o Web Server
Deve-se possuir um Web Server rodando e apontando para a pasta do diretrio Home (uma pasta
em seu computador onde voc armazenada pginas da Web). Pode-se utilizar o Windows IIS Web
Server ou uma cpia 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 padro similar ao
IIS, e o IWS prove um Web server semelhante ao NTWebServer.exe. Os passos para
configurao de ambos em CE so os mesmos para a configurao do Windows
NT/2000/XP (descritos nas sees que se seguem).

Configurando um IIS Web Server
Para configurar o IIS Web Server:
E Selecione Start Settings Control Panel Administrative Tools Internet Services
Manager.
E Quando a janela IIS aparecer, amplie as pastas no painel esqueda at que voc visualize a
pasta Default Web Site.
E Clique com o boto direito na pasta Default Web Site, selecione Properties do menu pop-up, e
aparecer o dilogo Default Web Site Properties.
IWS 20/06/2007

InduSoft Web Studio

Pgina 382
E Seleione o tab Home Directory e especifique o caminho do diretrio Home no campo de texto
Local Path (similar a figura que se segue):

Configurando o IIS Web Server
E Clique em OK para fechar o dilogo.
Configurando o IWS Web Server
Para colocar uma cpia do NTWebServer.exe do IWS em seu diretrio Home:
E Abra C:\Program Files\InduSoft Web Studio\Bin e localize o arquivo executvel
NTWebServer.exe.
E Copy o arquivo e cole na pasta designada como o diretrio Home para suas pginas da Web. Por
exemplo,
C:\Program Files\InduSoft Web Studio\Projects\<project name>\Web\NTWebServer.exe
IWS 20/06/2007

InduSoft Web Studio

Pgina 383
Rodando O TCP/IP Server
Para verificar que o TCP/IP Server est rodando em seu computador (ou no computador runtime):
E Selecione Project Status da barra de menu principal para abrir o dilogo Project Status
dialog.
E 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 boto "Start"
Para configurar o Server para iniciar automaticamente, clique no boto Startup. Quando o
dilogo Startup aparecer, selecione o radio buton Automatic e depois clique em OK .

Iniciando o TCP/IP Server Automaticamente
E Clique em OK para fechar o dilogo Project Status.
IWS 20/06/2007

InduSoft Web Studio

Pgina 384
Configurando a Aplicao
Salve a tela de sua aplicao em formato HTML, utilizando os passos a seguir:
E Amplie a pasta Screens no Workspace e clique duas vezes no boto Aplication para abrir a tela.

Abrindo a Tela da Aplicao
E Selecione File Save as HTML para salvar a tela (ou Save All as HTML para salvar mltiplas
telas abertas) em formato HTML.
O IWS salva automaticamente a tela (como um arquivo .html) em uma pasta Web Pages, a qual representa
a pasta /Web do diretrio de sua aplicao.

Nova Tela HTML

IWS 20/06/2007

InduSoft Web Studio

Pgina 385
E A seguir, selecione Project Settings da barra de menu principal e, quando aparecer o dilogo
Project Settings, selecione o tab Web.

Project Settings Tab Web
E Configure os parmetros que se seguem nesse tab:
text box Data Server IP: Digite o endereo IP da Server station que esteja rodando o IWS ou CEView.
A Web Thin Client station trocar dados online (valores de tags) com a Server station durante o
runtime.
Campo Send Period: Digite um valor para especificar a frequencia (em milissegundos) com que
Server e Web Thin Client stations trocaro os dados.
check-box Disable Remote Client Commands: Habilite esse box para prevenir um cliente remoto de
obter comandos para seu Server atravs do Web Thin Client.
check-box Enable ToolTips: Habilite esse box para visualizar Windows ToolTips nas telas na
aplicao no Web Thin Client (browser).
check-box Auto Screen Scaling: Habilite esse box caso voc deseje que todas as telas exibidas no
Browser sejam escalonadas automaticamente ao redimensionar a janela do Browser.
check-box Enable File Compression: Habilite esse box para comprimir os arquivos armazenados na
pasta \Web da aplicao do projeto.
Comprimir arquivos pode reduzir de forma significativa o tempo para efetuar downloads
particularmente ao utilizar uma conexo lenta entre Server e Web Thin Client.
IWS 20/06/2007

InduSoft Web Studio

Pgina 386
Boto IP Security: Clicar nesse boto abre o dilogo IP Security.

Dilogo IP Security
Utilize os parmetros nesse dilogo para controlar quais computadores tero acesso a essa
aplicao como Web Thin Clients.
Habilite o check-box Enable, e quando os parmetros do painel Edit tornarem-se ativos,
digite o endereo IP nos campos From e To para especificar a escala de endereos IP. Utilize
os botes Add e Remove para mover os endereos IP para a lista IP Address Range. O IWS
permite que os computadores listados nesse painel tenham acesso s aplicaes como Web
Thin Clients.
Log (check-box Enable e text field FileName): Habilite o check-box e digite um nome do
arquivo no campo de texto para gerar um arquivo de log na Web Thin Client station. Pode-
se utilizar esse arquivo de log para correo de erros.
Para habilitar o Virtual Keyboard para Web Thin Client stations, independentemente da
estao local, clique no check-box Virtual Keyboard. Quando esse box est habilitado, os
campos Default e Scale tornam-se ativos.
* Default: Selecione o teclado padro utilizado a ser utilizado na aplicao.
* Scale: Com essa opo, pode-se aumentar ou diminuir os teclados para que moldem-se
de forma apropriada ao tamanho da tela do painel alvo. Scale: 100% representa o
tamanho padro de cada Virtual Keyboard. A escala de opes variam de 25% a 400%,
embora voc tambm possa inserir uma escala constumizada.
E Aps configurar os parmetros no tab Web, clique em OK para fechar o dilogo Project Settings.
E Feche as telas no editor de telas (Window Close All).
E Selecione Tools Verify Aplicao a partir da barra de menu principal para atualizar as Web
Settings para as pginas da Web.
C IMPORTANTE!
Deve-se verificar uma aplicao sempre que os parmetros para Web da tela sejam
alterados no dilogo Project Settings (tab Web).
Verificar que todas as alteraes tenham sido aplicadas (ou reaplicadas) pgina
.html.

IWS 20/06/2007

InduSoft Web Studio

Pgina 387
Testando a Aplicao
Antes de comear, utilize essa breve lista de tarefas para certificar-se de que voc est pronto para testar
sua aplicao 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 diretrio Home ou que
uma cpia do NTWebServer.exe do IWS esteja rodando na pasta do diretrio Home.
Verifique se o TCP/IP Server est rodando.
Verifique se os tags da aplicao esto configurados para Server, caso voc deseje visualizar os
resultados desses tags no Browser. (Reveja Compartilhando Tgas com umCompartilhando Tags
com um Web Thin Client no Captulo 5: Trabalhando com Tags.)
Para testar sua aplicao baseada na Web, siga os passos a seguir:
E Clique no boto Run Application (na barra de menu principal do IWS) para executar a
aplicao localmente em sua Server station.
Verifique sua Task Bar do Windows, e certifique-se de que TCP/IP Server e Background Tasks estejam
rodando corretamente. Verifique se um ou mais drivers estejam rodando.

Verifique se TCP/IP e Background Tasks estejam Rodando
E Aps abrir a tela da aplicao, abra seu Browser da Internet (como Internet Explorer ou
Netscape) e digite o endereo URL (certificando-se de que o diretrio Home seja includo
corretamente) para abrir a tela <screen name>.html na Server station (por exemplo,
http://192.168.1.100/main.html).
E Quando o dilogo Log On aparecer no Browser, digite seu nome de log-on no text box User
Name, sua senha no text box Password e clique em OK para abrir a tela <screen name>.html.

Logando-se
Background Tasks
Drivers
IWS 20/06/2007

InduSoft Web Studio

Pgina 388
Notas:
Caso voc no tenha definido usurio na pasta de Security da Aplicao, O User
Name padro do IWS est configurado como Guest sem a necessidade da insero
de senha.
Caso voc tenha desabilitado qualquer requisito de segurana da sua aplicao, o
dilogo Log On no sera exibido.
Quando o dilogo Log On aparecer, indicar que seu TCP/IP Server est rodando de
forma satisfatria. Caso exista um problema com o TCP/IP Server, uma mensagem
de erro sera exibida.

Aps fechar o dilogo Log On, aparecer a tela a seguir na janela do Browser, indicando o status do
download.

Relatando Status do Download
IWS 20/06/2007

InduSoft Web Studio

Pgina 389
Quando o download estiver completo, a tela de sua aplicao ser exibida. Nesse ponto, o Web Thin
Client dever ler informaes a partir dos tags da tela (por exemplo, o relgio dever indicar a
contagem dos segundos).

main.html no Browser
IWS 20/06/2007

InduSoft Web Studio

Pgina 390
Captulo 14: Gerenciando Aplicaes Remotamente
Esse Captulo explica como fazer downloads de uma Aplicao do InduSoft Web Studio para sua estao de
trabalho de runtime e ento monitorar/gerenciar a aplicao remotamente, a partir de uma variedade de
equipamentos distintos.
Fazendo o Download da Aplicao
Aps configurar e testar uma aplicao localmente (em sua estao de trabalho de desenvolvimento), pode-
se fazer o download da Aplicao para uma estao de trabalho remota que esteja rodando o IWS em
plataforma Windows NT/2000/XP ou o CEView em um equipamento Windows CE.
Configurando a Target station
E Antes de comear, verifique que o Remote Agent (CEServer.exe) esteja rodando na target
station (remota).
Em uma plataforma Windows, o arquivo CEServer.exe est localizado na pasta \InduSoft Web
Studio\Redist\<CEVersion>\<Processor Type>\BIN (para NT, a localizao a pasta \BIN).
Em um equipamento Windows CE, o arquivo est localizado na pasta \<non-volatile>.
E Rode CEServer.exe na estao de trabalho alvo e quando o dilogo Remote Agent aparecer,
clique no boto Setup.

Dilogo Remote Agent
O dilogo Setup abre:

Dilogo Setup
E Utilize os parmetros desse dilogo para configurar a comunicao entre as estaes de
desenvolvimento e alvo:
IWS 20/06/2007

InduSoft Web Studio

Pgina 391
Serial Port: Habilite esse boto para estabelecer uma conexo a estao de desenvolvimento,
atravs de uma porta serial. Clique no boto de seta e selecione uma porta de comunicao a
partir da lista do combo-box.
Caso voc clicar no boto Advanced, o dilogo Serial Advanced Settings abrir.

Dilogo Serial Advanced Settings
Pode-se utilizar os parmetros desse dilogo para controlar o fluxo de dados entre as estaes alvo
e de desenvolvimento:
* Baud Rate: Clique no boto de seta para selecionar um baud rate pr-definido a
partir da lista do combo-box
* Control RTS: Habilite ( ) esse box para utilizar um controle Request to Send, onde o
IWS envia um sinal RS-232 da estao transmissora para a estao receptora,
requisitando permisso para a transmisso de dados.
* Control CTS: Habilite ( ) esse box para utilizar um controle Clear to Send, onde o IWS
envia um sinal RS-232 da estao receptora para a estao transmissora, indicando que
a estao receptora est pronta para aceitar os dados.
Ao terminar a configurao desses parmetros, clique em OK para fechar o dilogo Serial Advanced
Settings.
TCP/IP: Habilite esse boto para estabelecer uma conexo TCP/IP com a estao de
desenvolvimento.
Nota:
Por razes de performance do programa, recomendamos a utilizao de uma
conexo TCP/IP no lugar de uma conexo Serial Link.

E Ao terminar, clique em OK para fechar o dilogo Setup, mas deixe o programa Remote Agent
rodando na estao de trabalho remota.
Configurando a Estao de Desenvolvimento
Aps configurar a target station para o recebimento de dados, utilize os passos a seguir para
configurar a estao de desenvolvimento para enviar dados para a aplicao.
E Selecione Project Execution Environment da barra de menu principal (na estao de
desenvolvimento).
IWS 20/06/2007

InduSoft Web Studio

Pgina 392

Dilogo Execution Environment
Esse dilogo contm 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 Estao
* platform Retorna platafoma (sistema operacional + tipo de processo) da target station
aps conect-la.
* Install system files (ou Only newer files)
Aplicao: Utilize esse tab para especificar a aplicao, incluindo:
* Caminhos dos diretrios Local e Target
* Especifcar para Send (a Aplicao) to target station (ou Only newer files)
* Send file
* Run/Stop a Aplicao
* Rever Status da Aplicao
Import: Utilize esse tab para importar uma Aplicao, incluindo:
* Epecificar o caminho da aplicao To e From
* Get From Target
* Get Log File
Rever Status da Aplicao
CE License: Utilize esse tab para especificar License Settings e License Codes para uma licena
Windows CE, incluindo:
* Product Type
* Version
* Number of Web Thin Clients
* Site Code
* Site Key
E Selecione o tab Target e utilize as opes a seguir para especificar a target station a qual voc
ir conectar-se.
Local: Selecione esse boto caso voc ir rodar a aplicao na mesma estao na qual a
aplicao foi desenvolvida.
IWS 20/06/2007

InduSoft Web Studio

Pgina 393
Network IP: Selecione esse boto e digite o endereo IP da target station dentro do text box,
caso voc tenha especificado uma conexo TCP/IP quando configurou a target station.
Serial Port: Selecione esse boto e selecione uma porta da lista do combo-box caso voc tenha
especificado uma conexo Serial Port quando configurou a target station.
Microsoft ActiveSync: Selecione esse boto para conectar-se aos equipamentos nos quais
MS ActiveSync est habilitado.

Especifcando Tipo de Link e Endereo IP
E Clique no boto Connect para conectar-se estao remota.
Nota:
Caso a estao remota seja um equipamento WinCE, pode-se clicar no boto
Install System Files para fazer o download dos arquivos de runtime CEView para a
estao remota.

E Na janela Workspace, selecione o tab Application e clique no boto Send to Target para fazer o
download da aplicao para a estao remota.

Especificando Tipo de Link e Endereo IP

IWS 20/06/2007

InduSoft Web Studio

Pgina 394
C Ateno:
Ao enviar uma aplicao para a target station remota, as alteraes causam efeitos
online, ou seja, aps fazer o download dos arquivos da Aplicao para a target station, a
nova aplicao (s) substitui a antiga automaticamente mesmo que a aplicao esteja
rodando.
Alm disso, caso voc desabilite o check-box Only newer files no tab Aplication (no
dilogo Execution Environment), o IWS remover todos os arquivos do diretrio da
aplicao alvo antes de fazer o download de novos arquivos.

Nota:
Caso o download da aplicao for interrompido, o IWS requisitar confirmao, alm de
aconselh-lo que a aplicao poder no rodar de forma apropriada.
Utilizar a opo de menu Send app to target o mesmo que utilizar o boto Send app
to target na barra de ferramentas Execution Control.

Send file: Clique para alcanar o diretrio e selecionar um arquivo individual a ser enviado.
Stop button: Clique para parar a Aplicao.
E Aps fazer o download de todos os arquivos da aplicao, clique no boto Run para executar a
aplicao em uma estao de trabalho alvo remota.
IWS 20/06/2007

InduSoft Web Studio

Pgina 395
Monitorando/Gerenciando Aplicaes a partir de uma Estao Remota
Aps configurar e testar uma aplicao localmente (em sua estao de desenvolvimento),pode-se fazer o
download da Aplicao para uma estao remota em runtime que esteja rodando em Windows NT/2000/XP
ou CEView sob Windows CE.
E Antes de iniciar, verifique que Remote Agent (CEServer.exe) esteja rodando na target station
remota.
Nota:
O arquivo CEServer.exe est localizado no seguinte diretrio em computadores
com Windows
2000/XP (para NT, a localizao na pasta \BIN):
\InduSoft Web Studio\Redist\CEView\<Processor Type>\BIN
O arquivo deve estar localizado na pasta \<non-volatile> do equipamento WinCE.

E Aps efetuar o download de todos os arquivos da aplicao, clique no boto Run para executar
a aplicao na target station remota.
IWS 20/06/2007

InduSoft Web Studio

Pgina 396
Captulo 15: Linguagens de Script: IWS e VBScript
Trabalhando com com Linguagem de Script do IWS, Expresses e Funes
Essa seo explica como trabalhar com a linguagem de Script (Scripting Language), expresses e funes do
InduSoft Web Studio (IWS).
Utilizando Tags
Tags so variveis que podem receber os resultados das expresses especificadas em telas e planilhas
(como pontos de comunicao em equipamento de campo, resultados de clculos, pontos de alarme, etc).
Nota:
Recomendamos que voc leia e compreenda os conceitos discutidos no
Captulo 5: Trabalhando com Tags antes de ler esse captulo.
Especificando Tipos de Dados
Pode-se utilizar a Scripting Language do IWS em muitos locais, como:
Propriedades de objeto dinmicos
Lgicas de Telas
Planilhas Scheduler
Planilhas Math
Uma planilha Math possui duas colunas:
Tag Name: Nomes dos tags para o recebimento de resultados das expresses especificadas na coluna
Expression na mesma linha.
Expression: Expresses matemticas definidas pelo InduSoft Web Studio.
Por exemplo, Tag Name a, receber o resultado da Expresso (10*c)-5.

Exemple de Planilha Math
C IMPORTANTE!
No so feitas atribuies na coluna Expression. Se voc escrever A=2 nessa
coluna, o IWS ir comparar A com o nmero 2. O resultado inteiro dessa
expresso (Valor Boolean 0 se falso, e 1 se veradeiro) ser registrado ao tag na
coluna Tag Name.
O sistema no diferencia letras minsculas e maisculas.
Para adicionar comentrios a uma linha de expresso, utilize os caracteres //.

IWS 20/06/2007

InduSoft Web Studio

Pgina 397
So 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 utilizao de referenciais e apontadores.
Pode-se declarar um tag que est sendo utilizado com um apontador para outro tag de
duas formas:
Como um string (apontador para um tipo indefinido)
Como um apontador para um tipo especfico (recomendado)

Exemplo 2
Na figura anterior Valve_Fill_State uma varivel de um tipo de string apontador. A varivel
@pointer_to_integer uma apontadora para valores inteiros.
Notas:
A sintaxe @tag permite o acesso de um tag a outro tag por referncia.
Pode-se utilizar qualquer tag declarado como string como um tag indireto (apontador).

Operaes Aritimticas
O InduSoft Web Studio suporta todas as operaes aritimticas a seguir:
+ adio
- subtrao
* multiplicao
/ diviso
> maior que
< menor que
= igual
>= maior ou igual a
<= menor ou igual a
<> diferente de (desigual a)
IWS 20/06/2007

InduSoft Web Studio

Pgina 398
Notas:
Funes Math so calculadas da esquerda para a direita, de acordo com a ordem
especificada na formula por cada operador. Para alterar a ordem de avaliao, coloque
em parnteses a parte da formula a ser calculada primeiro. Por exemplo, a formula a
seguir igual a 11, pois a multiplicao calculada antes da adio. A formula
multiplica 2 por 3 e adiciona 5 ao resultado:
5+2*3
Em contraste, caso voc utilize parnteses para alterar a sintaxe, 5 e 2 so adicionados
juntos e depois multiplicados por 3, dando o valor 21:
(5+2)*3
Operaes Lgicas
O InduSoft Web Studio suporta todas as seguintes operaes Lgicas:
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 Funes
A funo tag names utilizada no IWS deve estar de acordo com a sintaxe que se segue:
num<Name>: Valor ou tag numrico
str<Name>: Tag String ou valor
tag<Name>: Nome do Tag
optNum<Name>: Tag Numrico 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 parmetro da funo do IWS.
O InduSoft Web Studio possui centenas de Funes prontas para serem utilizadas. Para uma lista completa
das funes disponveis, veja Apndice A: Funes do Studio.
IWS 20/06/2007

InduSoft Web Studio

Pgina 399
Exemplo de Funes:

Funes Execuo NT/2K/XP Win CE Web Client
False()
Sncrona
- - -
If()
Sncrona
- - -
True()
Sncrona
- - -
Format()
Sncrona
- - -
GetBit()
Sncrona
- - -
Max()
Sncrona
- - -
Min()
Sncrona
- - -
SendEmail()
Sncrona
- - -
Log()
Sncrona
- - -
Play()
Sncrona/Assncrona
- - -

C IMPORTANTE:
Pode-se utilizar a janela Database Spy para executar qualquer expresso
matemtica escrevendo a expresso no campo Tag Name e clicando no boto Toggle.
O valor de retorno da expresso ser exibido no campo Value.

IWS 20/06/2007

InduSoft Web Studio

Pgina 400
Viso Geral do VBScript
O Microsoft Visual Script Language (VBScript) uma linguagem de script simples, flexvel e padronizada
que permite a implementao de lgicas e algortimos junto a aplicao do IWS.
O IWS implementa Microsoft Visual Basic Scripting Edition 5.5 ou verses mais atualizadas. J que o IWS
hospeda o VBScript, o usurio pode tirar proveito de todos os recursos fornecidos por essa linguagem,
como:
Utilizar sintaxe, operadores e funes disponveis na linguagem
Criar novas variveis e Procedimentos (Funes e/ou Sub-rotinas)
Acessar propriedades, mtodos e/ou eventos a partir de objetos COM, incluindo controles
ActiveX
Executar as lgicas 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).

C Ateno:
Ao criar a imagem para o equipamento Microsoft Windows CE, o fabricante do hardware
dever habilitar o suporte para VBScript, de modo que o CEView possa executar os
scripts configurados na linguagem VBScript no equipamento. Caso voc no 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 documentao fornecer uma viso geral sobre a integrao do VBScript com o IWS. Alm
disso, esse pode ser utilizado com uma referncia rpida para a maioria dos recursos de linguagem mais
utilizados. Para uma descrio completa da linguagem, bem como suas interfaces e funes, consulte a
documentao da Microsoft. Na poca em que essa documentao foi escrita, voc poderia ler a
documentao sobre o VBScript em http://msdn.microsoft.com/library/default.asp?url=/library/en-
us/script56/html/vtorivbscript.asp.
VBScript no IWS
A tabela a seguir fornece um resumo das interfaces VBScript suportadas pelo IWS:
Interface
Scopo para
porcedimentos e
Variveis
Execuo Funcionalidade
Global Procedures Grficos e Tarefas - Declarao de
Procedimentos
Graphics Script Somente Interface de
script Grficos
Server (Viewer) + Web
Thin Clients
Declarao de
variveis
Declarao de
Procedimentos
Execuo
Screen Script Tela onde o script est
configurado
Thin Clients
Declarao de
Variveis
Declarao de
Procedimentos
Execuo
Command Dynamic Objeto onde o script
est configurado
Server (Viewer) +
Web Thin Clients
Declarao de
Variveis
IWS 20/06/2007

InduSoft Web Studio

Pgina 401
Execuo
ActiveX Events Objeto onde o script
est configurado
Thin Clients
Declarao de
Variveis
Execuo
Startup Script Todas pginas de Script
de Tarefas
Server (BGTask) Declarao de
Variveis
Declarao de
Porcedimentos
Execuo
Script Groups Somente Script de
Grupo
Server (BGTask) Declarao de
Variveis
Execuo

A figura a seguir ilustra o escopo de cada interface VBScript e a ordem que so escaneadas pelo IWS:

Graphic Module
(Viewer task or Web Thin Client control)
Global
Procedures
Global
Procedures
Graphics
Script
Graphics
Script
Screen A
Screen Script
Screen Script
Command
dynamic
Command
dynamic
ActiveX events
ActiveX events
Screen A
Screen Script
Screen Script
Command
dynamic
Command
dynamic
ActiveX events
ActiveX events
Screen B
Screen Script
Screen Script
Command
dynamic
Command
dynamic
ActiveX events
ActiveX events
Screen B
Screen Script
Screen Script
Command
dynamic
Command
dynamic
ActiveX events
ActiveX events
Screen N
Screen Script
Screen Script
Command
dynamic
Command
dynamic
ActiveX events
ActiveX events
Screen N
Screen Script
Screen Script
Command
dynamic
Command
dynamic
ActiveX events
ActiveX events
Background Task
(BGTask task)
Startup
Script
Startup
Script
Script Groups
Script 001
Script 001
Script 002
Script 002
Script N
Script N
Script Groups
Script 001
Script 001
Script 002
Script 002
Script N
Script N

A ilustrao mostra que os Procedimentos Globais so compartilhados por Graphic Module e Background
Task. Porm, as outras interfaces VBScript tambm so de Graphic Module ou Background Task, e no
compartilham variveis ou procedimentos entre elas, pois so independents umas das outras.

Nota:
Embora Graphic Scripts sejam executados pelo IWS antes de Screen Scripts, os
procedimentos e variveis declarados na interface Graphics Script NO esto
disponveis para qualquer interface de script configurada em telas. Deve-se utilizar
a interface Global Procedures para implementar procedimentos que devem estar
disponveis para todas as telas.

IWS 20/06/2007

InduSoft Web Studio

Pgina 402
Ao escrever seu cdigo em uma interface VBScript, pode-se acessar qualquer tag a partir do tag database do
IWS ou qualquer funo da linguagem de built-in do IWS aplicando-se o prefixo $ ao nome da funo/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 funo built-in Open() para abrir a tela "main"
Portanto, pode-se criar scripts utilizando as funes built-in do IWS, tags do tag database do IWS, Funes
VBScript, variveis VBScript, propriedades ActiveX, mtodos ou eventos, e qualquer outra interface
disponvel. Os tags do IWS so compartilhados por todos os mdulos do IWS, incluindo o Mdulo Graphic e
Background Task.
As interfaces VBScript a seguir esto disponveis 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 disponvel no produto. Pode-se declarar variveis locais junto a
cada procedimento declarado nessa interface (o escopo local junto a cada procedimento); porm,
no possvel declarar variveis globais nessa interface.
Os procedimentos implementados nessa interface no so executados pelo IWS, a menos que sejam
chamados a partir de alguma outra interface VBScript disponvel no produto. Portanto, essa
interface pode ser utilizada SOMENTE para declarar e implementar procedimentos a serem
chamados por outras interfaces.
Exemplo:
Option Explicit

'Procedimentos com escopo global podem ser implementadas aqui
'Variveis globais NO so suportadas nessa interface

Function MyAdd (number1, number2)
MyAdd = number1+number2
End Function

Sub MyMessage (message)
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 lgicas nos eventos a seguir, baseados em sub-
rotimas pr-configuradas:
Graphics_OnStart(): O cdigo configurado junto a essa sub-rotina e automaticamente
executada uma vez quando o graphic module iniciado. Essa interface til ao iniciar variveis
ou executar lgicas que devem ser implementadas ao iniciar a aplicao.
Graphics_WhileRunning(): O cdigo configurado junto a essa sub-rotina automaticamente
executada de forma contnua 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 cdigo configurado junto a essa sub-rotina executado uma vez logo que
o graphic module fechado.

C Ateno:
NO altere o nome das sub-rotimas pr-configuradas. Caso voc o faa, 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() mantm-se executando-se no Server enquanto a tarefa
Viewer estiver rodando. A sub-rotina Graphics_OnEnd() executada no Server logo que a tarefa
Viewer desligada.
No Web Thin Client (Web Browser):
O graphic module o controle ISSymbol.
A sub-rotina Graphics_OnStart() executada logo que a Web Thin Client station logada com
sucesso.
A sub-rotina Graphics_WhileRunning() mantm-se executando-se na Web Thin Client station
enquanto o controle ISSymbol est hospedado pelo Web Browser.
A sub-rotina Graphics_OnEnd() executada na Web Thin Client station logo que o Web
Browser desligado (ou quando o controle ISSymbol no mais hospedado pelo Web Browser).
IWS 20/06/2007

InduSoft Web Studio

Pgina 404
As variveis e procedimentos declarados nessa interface NO esto disponveis para qualquer
interface VBScript eles tm somente um escopo local.

Nota:
A execuo das sub-rotinas Graphic Script no server totalmente
independente da execuo de Web Thin Client stations.
Os procedimentos e/ou variveis criadas nessa interface possuem um escopo
local: podem ser acessados somente a partir da interface Graphic Script da
estao local onde esto sendo executadas.

Exemplo:
'Variveis 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 405
Graphic Module - Screen Script
Para editar a interface Graphics Script, clique com o boto direito na tela, e selecione a opo
Screen Script. Pode-se tambm selecionar View -> Screen Script do menu drop-down.

Essa interface pode ser utilizada para executar lgicas nos eventos a seguir, baseados em sub-
rotinas pr-configuradas:
Screen_OnOpen(): O cdigo junto a essa sub-rotina executado uma vez logo que sua tela seja
aberta.
Screen_WhileOpen():O cdigo junto a essa sub-rotina executado automaticamente de forma
continua enquanto sua tela seja executada. A taxa na qual essa sub-rotina chamada depende
da performance da plataforma onde a aplicao estiver rodando.
Screen_OnClose():O cdigo configurado junto a essa sub-rotina executado uma vez logo que a
tela fechada.
As variveis e procedimentos declarados nessa interface esto disponveis para as interfaces
VBScript da tela onde o Screen Script est configurado.

C Ateno:
NO altere o nome das sub-rotinas pr-configuradas. Caso voc o faa, o sistema sera
desabilitado para cham-las novamente.

Notas:
A execuo das sub-rotinas Screen Script no server totalmente independente da
execuo de Web Thin Client stations.
Os procedimentos e/ou variveis criadas nessa interface possuem escopo local:
podem ser acessados somente a partir de telas especficas onde esto sendo
implementados.

Exemplo:
Variveis disponveis nessa tela podem ser declaradas e inicializadas aqui
Dim Counter

'Procedures available on this screen can be implemented here
Function AreaCircle (radius)
IWS 20/06/2007

InduSoft Web Studio

Pgina 406
AreaCircle = Sqr(radius)*$Pi()
End Function

Sub CheckLoLimit (myValue, myLoLimit)
If myValue < myLoLimit Then
End If
End Sub

' Esse procedimento executado logo que a tela aberta
Sub Screen_OnOpen()
MsgBox("The screen was open!")
End Sub

' Esse procedimento executado continuamente enquanto essa tela est aberta
Sub Screen_WhileOpen()
If Counter<100 Then
Counter=Counter+1
Else
Counter=0
End If
$SimulationTag = Counter
End Sub

' Esse procedimento executado logo que a tela fechada
Sub Screen_OnClose()
MsgBox("The screen will be closed!")
End Sub
Graphic Module Dinmica Command
Para editar a interface da dinmica Command, siga os passos:
E Selecione o objeto.
E Clique no cone Command na barra de menu Mode.

E Clique com o boto direito no objeto.
O dilogo Object Properties para o dinmico Command ser aberto.

IWS 20/06/2007

InduSoft Web Studio

Pgina 407

E Clique no boto Config.
E Seleione VBScript como Type.

Utilize essa interface para executar lgicas quando o usurio clica no objeto onde o dinmico Command
est aplicado (durante o runtime) ou aperte o atalho (Tecla) associado dinmica Command.

Variveis declaradas nessa interface esto disponveis somente para essa interface (escopo local), ou seja,
no esto disponveis para qualquer outro objeto na aplicao. Voc no poder implementar
procedimentos nessa interface; porm, voc poder chamar procedimentos implementados em Global
Procedures ou na interface Screen Script para a mesma tela onde a dinmica Command est configurada.

Nota:
Maiores informaes sobre o dinmico Command esto disponveis no Captulo 3,
que descreve as dinmicas do editor de telas.

Exemplo:
'O script abaixo ser executado quando o usurio clicar no objeto
'onde a dinmica est configurada
$MyValue = InputBox("Please enter the new set-point", "Set-point")
Graphic Module - ActiveX Events
Para editar a interface ActiveX Events, selecione a opo Script do tab Events do objeto ActiveX
inserido na tela.
IWS 20/06/2007

InduSoft Web Studio

Pgina 408
E Clique no cone ActiveX Control na barra de ferramentas Mode.

O dilogo Insert ActiveX Control abrir.

E Selecione o ActiveX Control que voc deseja utilizar, e depois clique em OK.
E O objeto que simboliza o ActiveX Control selecionado ser exibido. Clique com o boto direito
nesse objeto para abrir o dilogo Object Properties.

E Clique no boto Configuration. O dilogo Configuration abrir. Clique no tab Events.

IWS 20/06/2007

InduSoft Web Studio

Pgina 409

E Clique no boto na coluna Script.

Utilize essa interface para executar lgicas quando um objeto ActiveX disparar um evento.
Variveis declaradas nessa interface esto disponveis somente para essa interface (escopo local), ou seja,
no esto disponveis para qualquer outro objeto na aplicao .
No possvel implementar procedimentos nessa interface, porm, pode-se chamar procedimentos
implementados em Global Procedures ou na interface Screen Script para a mesma tela onde o objeto
ActiveX est configurado.

Nota:
Maiores informaes sobre os Eventos ActiveX Events esto disponveis na seo
Utilizando a Barra de Ferramentas Active Objects do Captulo 7.

IWS 20/06/2007

InduSoft Web Studio

Pgina 410
Exemplo:
'O script abaixo ser executado quando Calendar Control ActiveX disparar seu evento "AfterUpdate"
$MyYear = CalendarControl1.Year
$MyMonth = CalendarControl1.Month
$MyDay = CalendarControl1.Day
Tarefa Background - Startup Script
Para editar a interface Startup Script, clique em seu cone na pasta Script, no tab Tasks do
Workspace:

O cdigo configurado nessa interface executado logo quando o mdulode tarefa Background
(BGTask) iniciado. Essa interface til para inicializao de variveis ou execuo de lgicas que
devem ser implementadas quando a aplicao for iniciada.
Pode-se declarar e iniciar variveis, e ainda implementar procedimentos. Porm, variveis ou
procedimentos declarados nessa interface estaro disponvesi SOMENTE para grupos de script da
tarefa Script No esto disponveis para qualquer interface VBScript do Graphic Module.
IWS 20/06/2007

InduSoft Web Studio

Pgina 411
Exemplo:
'Variveis disponveis para todos os grupos Script da tarefa Script podem ser declaradas e
inicializadas aqui

Dim MyVar, Counter
MyVar = 100

'Procedimentos disponveis para todos os grupos Script da tarefa Script podem ser implementadas
aqui

Function AreaEquTriangle ( base, high)
AreaEquTriangle = (base * high) / 2
End Function

Sub CheckLimits (myValue, myHiLimit, myLoLimit)
If (myValue > myHiLimit Or myValue < myLoLimit) Then
End If
End Sub

' O Cdigo configurado aqui executado logo que a tarefa Background inicializada

If $GetOS()=3 Then
MsgBox ("Welcome! This Aplicao is Rodando under Microsoft Windows CE operating
system.")
Else
MsgBox ("Welcome! This Aplicao Is Rodando under Microsoft Windows NT/2K/XP
operating system.")
End If
Tarefa Background Grupos Script
Para criar um novo grupo Script, clique com o boto direito na subpasta Script no tab Tasks do
Workspace. Selecione a opo Insert do menu pop-up:

IWS 20/06/2007

InduSoft Web Studio

Pgina 412

Para editar uma interface Script Group j existente, clique em seu cone na pasta Script no tab
Tasks do Workspace:

O cdigo configurado em cada Script Group executado pela tarefa Background. O IWS escanea os
Script Groups sequencialmente (baseado no nmero do grupo) e executa somente os grupos no
qual a condio configurada no campo Execution do Script Group TRUE (VERDADEIRA), isto ,
qualquer valor diferente de 0 (zero).

Nota:
Deve-se utilizar a sintaxe suportada pela linguagem built-in do IWS no campo
Execution de cada grupo Script. Somente o corpo do grupo Script suporta a
linguagem VBScript.

C Ateno:
Quando qualquer Script Group salvo durante o runtime (configurao on-line), a
interface Script de Startup ser executada novamente, e o valor atual das variveis
locais de qualque Script Group sero reiniciadas.

IWS 20/06/2007

InduSoft Web Studio

Pgina 413
Variveis declaradas em um grupo tm escopo local somente para aquele grupo especfico. Esses
no esto disponveis para qualquer outra interface VBScript. A partir do Script Group, pode-se
chamar todos os procedimentos implementados na interface Global Procedures ou na interface
Startup Script; porm, voc no poder implementar (declarar) procedimentos em Script Groups.
Exemplo:
'Variveis disponveis somente para esse grupo podem ser declaradas aqui

Dim myVar, myTest
myTest=1

'O cdigo configurado aqui executado enquanto a condio configurada no campo'Execution
TRUE

myVar = $FindFile("c:\*.txt")
If MyVar>0 Then
$TagNumOfFiles = myVar
End If
Referncia de Linguagem
Constantes
Constantes de Cor
Constante Valor Descrio
vbBlack &h00 Black
vbRed &hFF Red
vbGreen &hFF00 Green
vbYellow &hFFFF Yellow
vbBlue &hFF0000 Blue
vbMagenta &hFF00FF Magenta
vbCyan &hFFFF00 Cyan
vbWhite &hFFFFFF White

Constantes Comparativas
vbBinaryCompare 0 Executa uma comparao
binria
vbTextCompare 1 Executa uma comparao
textual

Data e Hora das Constantes
vbSunday 1 Domingo
vbMonday 2 Segunda-feira
vbTuesday 3 Tera-feira
IWS 20/06/2007

InduSoft Web Studio

Pgina 414
vbWednesday 4 Quarta-feira
vbThursday 5 Quinta-feira
vbFriday 6 Sexta-feira
vbSaturday 7 Sbado
vbUseSystemDayOfWeek 0 Utiliza o dia da semana
especificado nas
configuraes de seu sistema
para o primeiro dia da
semana.
vbFirstJan1 1 Utiliza a semana na qual
ser o dia 1 de janeiro
(padro).
vbFirstFourDays 2 Utiliza a primeira semana
que tenha ao menos quarto
dias no ano seguinte.
vbFirstFullWeek 3 Utiliza primeira semana
completa do ano.

Constantes de Formatos de Data
vbGeneralDate 0 Exibe data e/ou hora. Para
nmero reais, exibe uma data
e hora. Caso no haja parte
fracional, exibe somente uma
data. Caso no haja parte
inteira, exibe somente hora. A
exibio de Data e hora
determinada pelas
configuraes de seu sistema.
vbLongDate 1 Exibe uma data utilizando o
formato de dato longo,
especificado nas
configuraes regionais de
seu computador.
vbShortDate 2 Exibe uma data utilizando o
formato de data curto
especifcado nas
configuraes de seu
computador.
vbLongTime 3 Exibe uma data utilizando o
formato longo especificado
nas configuraes regionais
de seu computador.
vbShortTime 4 Exibe uma hora utilizando o
formato curto especificado
nas configuraes regionais
de seu computador.

IWS 20/06/2007

InduSoft Web Studio

Pgina 415
Constantes
vbObjectError -2147221504 Nmeros de erros definidos
pelo usurio devem ser
maiores que esse valor.

Constantes de Dilogos Botes e cones
vbOKOnly 0 Exibe somente o boto OK.
vbOKCancel 1 Exibe os botes OK e Cancel.
vbAbortRetryIgnore 2 Exibe os botes Abort, Retry,
e Ignore.
vbYesNoCancel 3 Exibe os botes Yes, No, e
Cancel.
vbYesNo 4 Exibe os botes Yes e No.
vbRetryCancel 5 Exibe os botes Retry e
Cancel.
vbCritical 16 Exibe o cone Critical
Message .
vbQuestion 32 Exibe o cone Warning
Query.
vbExclamation 48 Exibe o cone Warning
Message.
vbInformation 64 Exibe o cone Information
Message.
vbDefaultButton1 0 Primeiro boto o padro.
vbDefaultButton2 256 Segundo boto o padro.
vbDefaultButton3 512 Terceiro boto o padro.
vbDefaultButton4 768 Quarto boto o padro .
vbAplicaoModal 0 Aplicao modal. O usurio
dever responder o dilogo
antes de continuar
trabalhando na aplicao
atual.
vbSystemModal 4096 Sistema modal. Nos sistemas
Win32, essa constante
fornece um dilogo de
aplicao modal que
permanence sempre acima de
quaisquer outros programas
que estejam rodando.

Constantes de Dilogos Boto Selecionado
vbOK 1 Boto OK foi clicado.
vbCancel 2 Boto Cancel foi clicado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 416
vbAbort 3 Boto Abort foi clicado.
vbRetry 4 Boto Retry foi clicado.
vbIgnore 5 Boto Ignore foi clicado.
vbYes 6 Boto Yes foi clicado.
vbNo 7 Boto No foi clicado.

Constantes de String
vbCr Chr(13) Carriage Return (equivalente
tecla ENTER)
VbCrLf Chr(13) & Chr(10) Combinao Carriage return
linefeed
vbFormFeed Chr(12) Form feed; no usual em
Microsoft Windows
vbLf Chr(10) Line feed
vbNewLine Chr(13) & Chr(10) or Chr(10) Caracter de nova linha;
sempre que apropriado para
a plataforma
vbNullChar Chr(0) Caractere com o valor 0
vbNullString String having value 0 No o mesmo que o
comprimento de string 0 ("");
utilizado para chamar
procedimentos externos
vbTab Chr(9) Tab Horizontal
vbVerticalTab Chr(11) Tab Vertical; No usual em
Microsoft Windows

Constantes Tri-state
vbUseDefault -2 Utiliza padro de
configuraes regionais do
computador.
vbTrue -1 TRUE (VERDADEIRO)
vbFalse 0 FALSE (FALSO)

Constantes de Tipos de Variveis
vbEmpty 0 No inicializada (padro)
vbNull 1 Contm dados invlidos
vbInteger 2 Subtipo Integer
vbLong 3 Subtipo Long
vbSingle 4 Subtipo Single
vbDouble 5 Subtipo Double
vbCurrency 6 Subtipo Currency
IWS 20/06/2007

InduSoft Web Studio

Pgina 417
vbDate 7 Subtipo Date
vbString 8 Subtipo String
vbObject 9 Object
vbError 10 Subtipo Error
vbBoolean 11 Subtipo Boolean
vbVariant 12 Variante (utilizada somente
para arrays de variantes)
vbDataObject 13 Objeto para acesso de dados
vbDecimal 14 Subtipo Decimal
vbByte 17 Subtipo Byte
vbArray 8192 Array
Erros
Erros de runtime do VBScript
Nmero do Erro Descrio
429 Componente ActiveX no pode criar objeto
507 Ocorreu uma exceo
449 Argumento no opcional
17 No possvel executar a tarefa requisitada
430 Classe no suporta automao
506 Classe no definida
11 Diviso por zero
48 Erro ao carregar DLL
5020 Esperado ')' em expresso regular
5019 Esperado ']' em expresso regular
432 Nome do Arquivo ou nome de classe no encontrados
durante o processo de automao
92 No iniciado para loop
5008 Preenchimento ilegal
51 Erro interno
505 Referncia invlida ou no qualificada
481 Figura invlida
5 Procedimento de chamada ou argumento invlido
5021 Escala invlida em conjunto de caractere
94 Uso de Null invlido
448 Argumento nomeado no encontrado
447 Objeto no suporta localizao atual de configurao
445 Objeto no suporta essa ao
438 Objeto no suporta essa propriedade ou mtodo
451 Objeto no coleo
504 Objeto no seguro para criao
IWS 20/06/2007

InduSoft Web Studio

Pgina 418
503 Objeto no seguro para inicializao
502 Objeto no seguro para scripting
424 Objeto requisitado
91 Varivel de objeto no configurada
7 Fora da memria
28 Fora do espao permitido
14 Fora do espao da string
6 Fluxo elevado
35 Sub ou funo no definidos
9 Subscript for a de escala
5017 Erro de sintaxe em expresso regular
462 O servidor remoto no existe ou est indisponvel
10 Esse array est fixo ou temporariamente travado
13 Tipo mismatch
5018 Quantificador inesperado
500 Varivel indefinida
458 Varivel utiliza um tipo Automation no suportado
em VBScript
450 Nmero errado de argumentos ou preenchimento de
propriedade invlido

Erros de sintaxe do VBScript
Nmero do Erro Descrio
1052 No pode haver mltiplos
propriedade/mtodo em uma classe
1044 No pode utilizar parnteses ao chamar uma
Sub
1053 Class inicializadora ou finalizadora no possui
argumentos
1058 Especificao 'Default' pode estar somente em
Property Get
1057 Especificao 'Default' deve especificar
tambm 'Public'
1005 '(' Esperado
1006 ')' Esperado
1011 '=' Esperado
1021 'Case' Esperado
1047 'Class' Esperado
1025 Final da Demostrao Esperado
1014 'End' esperado
1023 Expresso Esperada
IWS 20/06/2007

InduSoft Web Studio

Pgina 419
1015 'Function' esperada
1010 Identificado esperado
1012 'IfEsperado
1046 'In' Esperado
1026 Constante inteira esperada
1049 Decalrao 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 Demonstrao esperada
1016 'Sub' Esperada
1017 'Then' ESperado
1013 'To' Esperado
1018 'Wend' Esperado
1027 'While' ou 'Until' Esperado
1028 Esperados 'While,' 'Until,'ou final da
demonstrao
1029 'With' Esperado
1030 Identificador muito comprido
1014 Caractere invlido
1039 Demonstrao 'exit' invlida
1040 Varivel de controle 'for' invlida
1013 Nmero invlido
1037 Uso invlido da tecla-chave 'Me'
1038 'loop' sem 'do'
1048 Deve ser definido dentro de um Class
1042 Deve ser a primeira demonstrao da linha
1041 Nome redefinido
1051 Nmero de argumentos deve ser consistente a
especificao de propriedades
1001 Fora da memria
1054 Propriedades Set ou Let devem ter ao menos
um argumento
1002 Erro de sintaxe
1055 'Next' Inesperado
1015 Constante string indeterminada
IWS 20/06/2007

InduSoft Web Studio

Pgina 420
Funes
Nomes da Funo
Abs Array Asc Atn
CBool CByte CCur CDate
CDbl Chr CInt CLng
Conversions Cos CreateObject CSng
CStr Date DateAdd DateDiff
DatePart DateSerial DateValue Day
Derived Math Escape Eval Exp
Filter 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 ScriptEngineBuildVersio
n
ScriptEngineMajorVersio
n
ScriptEngineMinorVersio
n
Second SetLocale Sgn
Sin Space Split Sqr
StrComp String StrReverse Tan
Time Timer TimeSerial TimeValue
TypeName UBound UCase Unescape
VarType Weekday WeekdayName Year

IWS 20/06/2007

InduSoft Web Studio

Pgina 421
Palavras-Chave
Palavras-chave
Palavra-chave Descrio
Empty A keyword (palavra-chave) Empty usada pra
indicar valor no inicializado de uma varivel. No
a mesma indicao de valor nulo (Null).
False False indica o valor 0.
Nothing Nothing usado no VBScript para desassociar uma
varivel object do object em si.
Null Null indica que a varivel no contm nenhum
dado. No a mesma indicao de valor vazio
(Empty).
True True indica o valor -1.
Mtodos
Mtodos
Mtodo Descrio
Clear Limpa todas as configuraes de propriedade do
objeto Err.
Execute Executa uma pesquisa de expresso regular contra
um string especificado.
Raise Gera um erro de run-time.
Replace Substitui textos encontrados em uma pesquisa de
expresso regular.
Test Executa uma pesquisa de expresso 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 correo de erros.
WriteLine Envia strings para o string de correo de erros,
seguido por um caractere newline.
Objetos e Colees
Objetos e Colees
Nome Descrio
Class Object O objeto criado com a utilizao da demonstrao
Class. Fornece acesso a eventos class.
Debug Object Um objeto intrnseco global que pode enviar sada
para um string de correo de erro, como Microsoft
Script Debugger.
Err Object Contm informaes sobre erros de run-time. Aceita
os mtodos Raise e Clear para gerar e limpar erros
de run-time.
Match Object Fornece acesso para propriedes read-only de uma
expresso regular Match.
IWS 20/06/2007

InduSoft Web Studio

Pgina 422
Matches Collection Coleo de objetos Match de expresso regular.
Regular Expression (RegExp) Object Fornece suporte simples para expresso regular.
SubMatches Collection Coleo de strings submatch de expresso regular.

IWS 20/06/2007

InduSoft Web Studio

Pgina 423
Operadores
Aritimtica
Smbolo Nome Descrio
^ Exponenciao
Aumenta o nmero para um
expoente.
- Negao
Encontra a diferena entre
dois nmeros ou indica o
valor negativo de uma
expresso numrica.
* Multiplicao Multiplica dois nmeros.
/ Diviso
Divide dois nmeros e
retorna um resultado
floating-point.
\ Diviso por inteiro
retorna um resultado inteiro.
Mod Mdulos aritimticos
retorna somente o
remanescente.
+ Adio Faz a soma de dois nmeros.
- Subtrao
Faz a diferena entre dois
nmeros ou indica o valor
negativo de uma expresso
numrica.
& Concatenao de strings
Concatenao de duas
expresses.

Comparao
Smbolo Nome Descrio
= Igualdade Comparao Verdadeira
caso a primeira expresso
seja igual a segunda.
<> Desigualdade Comparao Verdadeira
seja dierente da segunda.
< Menor que Comparao Verdadeira
seja menor que a segunda.
> Maior que Comparao Verdadeira
seja maior que a segunda.
<= Menor ou igual a Comparao Verdadeira
seja menor que a segunda.
>= Maior ou igual a Comparao Verdadeira
seja maior ou igual a
IWS 20/06/2007

InduSoft Web Studio

Pgina 424
segunda.
Is Equivalncia de objeto Compara duas variveis de
referncia do objeto.
Comparao Verdadeira
caso ambos os nomes de
objetos refriram-se ao mesmo
objeto.

Lgica
Simbolo Nome Descrio
Not Negao lgica Executa negao lgica em
uma expresso.
And Conjuno lgica Executa uma conjuno
lgica em duas expresses.
Or Disjuno lgica Executa uma disjuno lgica
em duas expresses.
Xor Excluso lgica Executa uma excluso lgica
em duas expresses.
Eqv Equivalncia lgica Executa uma equivalncia
Imp Implicao lgica Executa uma implicao

Indicao
Smbolo Nome Descrio
= Indicao Aplica um valor a uma
varivel ou propriedade.
Propriedades
Propriedades
Nome da Propriedade Descrio
Description Retorna ou configura uma string associada a
um erro.
FirstIndex Retorna a posio em uma string onde o
valor procurado ocorre.
Global Configura ou retorna valor Booleano que
indica se um padro deve combinar todas as
ocorrncias em uma string inteira de busca
ou em apenas na primeira.
HelpContext Configura ou retorna uma ID de contexto
para um Arquivo Help tpico.
HelpFile Configura ou retorna caminho
completamente qualificado para o Aquivo
Help.
IgnoreCase Configura ou retorna um valor Booleano que
IWS 20/06/2007

InduSoft Web Studio

Pgina 425
indica se uma pesquisa padro faz diferena
entre letras maisculas ou minsculas ou
no.
Length Configura ou retorna um valor Booleano que
indica se uma pesquisa padro faz diferena
entre letras maisculas ou minsculas ou
no.
Number Retorna ou configura um valor numrico
especificando um erro. Number a
propriedade padro Err do objeto.
Pattern Configura ou retorna a expresso regular
padro a ser pesquisada.
Source Retorna ou configura o nome do objeto ou
Aplicao que gerou o erro originalmente.
Value Retorna o valor ou texto de uma semelhana
encontrada em uma string de pesquisa.
Demonstraes
Demonstraes
Nome da demonstrao Descrio
Call Transfere controle para procedimento Sub ou
Function.
Class Declara o nome de uma classe, assim como
uma definio de varveis, propriedades,
mtodos que comprometem a classe.
Const Declara constantes para uso em lugar de
valores literais.
Dim Declara variveis e aloca espao de
armazenamento.
DoLoop Repete um bloco de Demonstraes enquanto
uma condio Verdadeira ou at a condio
tornar-se Verdadeira.
Erase Reinicializa os elementos de arrays fixed-size
e desloca espao de armazenamento de
dynamic-array.
Execute Executa uma ou mais Demonstraes
especificadas.
ExecuteGlobal Executa uma ou mais Demonstraes
especificadas em namespace global de um
script.
Exit Promove a sada de um bloco de Do...Loop,
For...Next, Funo ou cdigo Sub.
For EachNext Repete um grupo de Demonstraes para
cada elemento em uma array ou coleo.
ForNext Repete um grupo de Demonstraes em um
nmero de vezes especificado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 426
Function Declara o nome, argumentos e cdigo que
formam o corpo de um procedimento
Function.
IfThenElse Condicionalmente executa um grupo de
Demonstraes, dependendo do valor de uma
expresso.
Option Explicit Fora declarao explcita de todas as
variveis em um script.
Private Declara variveis particulares e aloca espao
de armazenamento em um bloco Class, uma
varivel particular.
Property Get Declara, em um bloco Class, o nome,
argumentos, e cdigo que formam o corpo do
procedimento Property que obtm (retorna) o
valor de uma propriedade.
Property Let Declara, em um bloco Class, o nome,
procedimento Property que preenche
(configura) o valor de uma propriedade.
Property Set Declara, em um bloco Class, o nome,
procedimento Property que configure uma
referncia a um objeto.
Public Declara variveis pblicas e aloca espao de
armazenamento. Declara, em um bolco
Class, uma varivel particular.
Ramdomize Inicializa o gerador random-number.
ReDim Declara variveis dynamic-array, e aloca ou
desaloca espao de armazenamento ao nvel
do procedimento.
Rem Inclui marcas de explicao em um programa
de Detalhamento Tcnico.
Select Executa uma Demonstrao de um grupo,
dependendo do valor de uma expresso.
Set Preenche uma referncia de objeto para uma
varivel ou propriedade, ou associa uma
referncia de procedimento a um evento.
Stop Suspende execuo.
Sub Declara o nome, argumentos e cdigos que
formam o corpo de um procedimento Sub.
While Executa uma srie de Demonstraes
conquanto que a condio dada seja
Verdadeira.
IWS 20/06/2007

InduSoft Web Studio

Pgina 427
Dicas e Truques
VBScript Editor - IntelliSense
IntelliSense fornece uma variedade de opes que tornam as referncias de linguagem simples e de
fcil acesso. Ao codificar, voc no 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 informao necessria, inserir elementos da linguagem diretamente ao cdigo, e at
mesmo fazer com que o IntelliSense complete a digitao para voc.
IntelliSense confere as seguintes opes:
List Members: Pode-se exibir uma lista de membros vlidos de tags class, campos de
qualquer tag, propriedades/mtodos de um objeto ActiveX object, ou funes da linguagem
built-in do IWS. Selecionar a partir da lista promove a insero do membro em seu cdigo.
Ao digitar o caractere $ em qualquer interface VBScript, uma list box abrir automaticamente com a lista de
todos os tags disponveis para a aplicao atual, assim como todas as Funes da linguagem built-in do
IWS.

Ao adotar o nome do tag classe seguido pelo caractere ponto (.) em qualquer interface VBScript, uma list
box abrir automaticamente com a lista de membros do tag class:

Ao digitar o nome de um tag seguido por caracteres hfem e maior que ( -> ) em qualquer interface VBScript,
uma list box abrir automaticamente com a lista de campos disponveis para esse tag:

IWS 20/06/2007

InduSoft Web Studio

Pgina 428

Os itens so exibidos em ordem alfabtica, 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

Funo built-in de linguagem do IWS

Ao digitar o nome de um controle ActiveX que esteja inserido na tela seguida pelo caractere ponto (.) em
qualquer interface VBScript da tela onde o objeto ActiveX object est inserido, uma list box abrir
automaticamente com uma lista de todas as propriedades e mtodos do objeto:

Os itens so exibidos em ordem alfabtica, e cada um possui um cone para identificar seu tipo principal,
como se segue:

cone Tipo

Propriedade do objeto ActiveX

Mtodo do objeto ActiveX

Parmetro Quick Info: A opo Quick Info exibe boxes pop-up com informaes sobre as
Funes de linguagem buit-in do IWS, as quais incluem todos os parmetros suportados
por essa funo, com aquele atualmente configurado em texto em negrito.
IWS 20/06/2007

InduSoft Web Studio

Pgina 429

Complete Word: Complete word finaliza um tag, membro, campo, funo ou nome de
propriedade/mtodo ActiveX uma vez que voc tenha inseridos caracteres suficientes para
que o termo no fique ambguo. Aps digitar as primeiras letras do nome, pode-se apertar
CTRL+SPACEBAR para que o nome seja completado automaticamente.
VBScript comparado a VBA
Enquanto VBScript e Visual Basic For Aplicattion (VBA) so similares e baseados no padro de
linguagem Visual Basic, existem algumas vantagens na utilizao do VBScript para usurios do
IWS:
VBScript suportado em sistema operacional Microsoft Windows CE, enquanto o VBA no
.
VBScript fornece scripting ativos para uma extensa variedade de ambientes, incluindo Web
client scripting em Microsoft Internet Explorer, o que evita operaes que possam
representar riscos para o usurio Web Thin Client, como acesso direto a arquivos locais.
VBScript foi projetado para um aprendizado simples e fcil, com alguns padres do VBA
modificados para o VBScript, tornando-o assim uma ferramenta mais direta. Por exemplo,
em VBScript o usurio no precisa se preocupar com o tipo de cada varivel ao declar-las,
pois o VBScript assume o tipo apropriado para cada valor automaticamente.
A tabela a seguir lista os recursos do VBScript no existentes em VBA.

Categoria Recurso/Palavra-chave
Declaraes Class
Eval
Mecelneas
Execute
Objetos RegExp
ScriptEngine
ScriptEngineBuildVersion Identificao do Script Engine
ScriptEngineMajorVersion

A tabela a seguir lista os recursos do VBA no existentes em VBScript.

Categoria Recurso omitido/Palavra-chave
Opo Base
Array Handling
Declarar arrays com delimitadores <> 0
Add, Count, Item, Remove
Collection
Acesso a colees utilizando o caractere !
#Const
Conditional Compilation
#If...Then...#Else
DoEvents
GoSub...Return, GoTo
On Error GoTo
Control Flow
On...GoSub, On...GoTo
IWS 20/06/2007

InduSoft Web Studio

Pgina 430
Line numbers, Line labels
CVar, CVDate
Conversion
Str, Val
Todos os tipos de dados intrinsic excetuam o
Variant
Data Types
Type...End Type
Date/Time Date statement, Time statement
DDE
LinkExecute, LinkPoke, LinkRequest,
LinkSend
Debug.Print
Debugging
End, Stop
Declare (for declaring DLLs)
Optional
ParamArray
Declaration
Static
Erl
Error Error Handling
Resume, Resume Next
File Input/Output All traditional Basic file I/O
Financial All financial Functions
Object Manipulation TypeOf
Clipboard
Objects
Collection
Operators Like
Deftype
Opo Base
Opo Compare
Options
Opo Private Module
Expresses contendo a keyword Is ou alguns
operadores de comparao
Select Case
Expresses contendo uma escala de valores
utilizando a palavra-chave To
Strings de comprimento fixo
LSet, RSet
Demonstrao Mid
Strings
StrConv
Using Objects Acesso a coleo utilizando !
Eventos de Tela
Alm de Screen Script, pode-se configurar lgicas com a utilizao da linguagem built-in do IWS
para os eventos On Open, While Open e On Close utilizados para a tela (veja Interface Screen Logic
IWS 20/06/2007

InduSoft Web Studio

Pgina 431
no dilogo Screen Attributes). Caso voc configure Screen Script (linguagem VBScript) e Screen
Logic (Linguagem Built-in do IWS), o respeitar a seguinte ordem de execuo:

Evento Ordem de execuo
Ao abrir a tela Sub-rotina Screen_OnOpen() da interface
Screen Script (Linguagem VBScript)
On Open da interface Screen Logic
(linguagem built-in do IWS)
Ao fechar a tela On Close da interface Screen Logic
(Linguagem Built-in do IWS)
Sub-rotina Screen_OnClose() da interface
Screen Script (linguagem VBScript)
Funes MsgBox() e InputBox()
A funes MsgBox() e InputBox() da linguagem VBScript permite a exibio de mensagens pop-up
durante o runtime. Tais Funes so sincrnicas. Quando uma delas executada, as instrues
remanescentes do cdigo no sero executadas antes que as mensagens pop-up iniciadas pelas
Funes sejam fechadas.
Nota:
O texto exibido nessas mensagens pop-up no so afetadas pela ferramenta
Translation do IWS, a menos que voc configure o texto explicitamente com a
utilizao da funo $Ext() da linguagem built-in do IWS.
Suporte para objetos ActiveX
Utilizando as interfaces VBScript para o Graphic module (Graphics Script, Screen Script, dinmico
Command e eventos ActiveX), pode-se utilizar a sintaxe abaixo para acesso a propriedades e
mtodos, diretamente, a partir de qualquer objeto ActiveX inserido na tela onde o objeto est
configurado.
O IWS ir preencher um nome nico para o objeto na tela, e voc poder utilizar a propriedade
Name (janela de dilogo Object Properties) para modificar esse nome.
Aps inserir um objeto ActiveX na tela, voc poder acessar propriedades e mtodos a partir desse
objeto em qualquer interface VBScript associada a esse tela. Utilize a sintaxe
<Object_Name>.<Properties_or_Method_Name>.
Exemplos:
//Acesso ao valor property Day a partir do objeto CalendarControl1 ActiveX
CalendarControl1.Day

//Dispara o mtodo AboutBox a partir do objeto CalendarControl1 ActiveX
CalendarControl1.AboutBox
Logical Operator NOT
O comportamento do Logical Operator NOT diferente em VBScript da linguagem built-in do IWS.
Em VBScript, o operador NO inverte os valores bits de qualquer vrivel. Quando utilizado para
tags Integer ou Real, o NOT operator resultar no complemento do valor do tag. A tabela abaixo
ilustra o comportamento do NOT para a sintaxe: result = NOT expression, onde o resultado o valor
recebido por um tag numrico (Integer ou Real) do IWS:
IWS 20/06/2007

InduSoft Web Studio

Pgina 432
Caso a expresso seja O resultado ser
-3 2
-2 1
-1 0
0 -1
1 -2
2 -3
3 -4

Nota:
Ao tentar registrar qualquer valor diferente de 0 em um tag Booleando IWS, esse
assumir o valor 1 (TRUE). Portanto, ao utilizar o NOT logical operator em VBScript
para um tag Boolean com valor 1, o operator tentar registrar o valor -2 para o tag
Boolean (veja a tabela anterior); o tag Boolean manter o valor 1.

Recomendamos a utilizao das sintaxes a seguir quando da utilizao do VBScript para inverter
tags a partir do IWS:
- Syntax 1: $Tag = Abs($Tag=0)
- Syntax 2: $Tag = $If($Tag=0,1,0)
Em contraste, o NOT operator inverte o valor de qualquer tag em linguagem built-in do IWS. Caso o
tag tenha o valor 0, o NOT operator retornar o valor 1 ao tag. Caso o tag tenha um valor diferente
de 0, o NOT operator retornar o valor 0 ao tag. A tabela abaixo ilustra o comportamento do NOT
operator para a sintaxe result= NOT expression, onde result o valor recebido por um tag numrico
(Integer, Real ou Boolean) do IWS:

Caso a expresso seja O resultado ser
0 1
<> 0 0
Verdadeiro e Falso
Em VBScript, True e False so 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 parmetro
BooleanTrueAboveZero da seo [Options] no arquivo <Aplicao>.APP.

Utilizando a configurao que se segue, os tags Booleanos assumem o valor 1
(TRUE) ao receberem qualquer valor diferente de 0:

[Options]
BooleanTrueAboveZero=0
IWS 20/06/2007

InduSoft Web Studio

Pgina 433

Utilizando a configurao 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 tambm suporta VBScript. O fabricante do hardware do equipamento Microsoft Windows
CE dever habilitar o hardware para que esse suporte o VBScript, de forma que o CEView seja
capaz de executar os scripts configurados na linguagem VBScript no equipamento.
A funes MsgBox() e InputBox() podem ser especificamente habilitadas/desabilitadas pelo
fabricante do hardware logo que a imagem para o equipamento Microsoft WindowsCE criada.
Caso voc no esteja certo de que a imagem carregada em seu equipamento suporte VBScript,
consulte o fabricante de seu hardware.
Escopo e Tempo de Vida de Variveis
Um escopo de variveis determinado por onde esse est declarado. Ao declarar um varivel junto
a um procedimento, somente cdigos com aquele procedimento especfico poder acessar ou alterar
o valor da varivel, pois possui escopo local e uma varivel procedimento-nvel (procedure-level
variable). Caso voc declare uma varivel for a de um procedimento, voc o tornar reconhecvel
para todos os procedimentos de seu script, o que uma varivel script-level, e possui um escopo
script-level.
O tempo de vida de uma varivel depende de seu tempo de existncia. O tempo de vida de uma
varivel script-level estende-se a partir do tempo que declarada at o momento em que o script
finalizado em runtime. Ao nvel de procedimento, uma varivel existe somente quando o
procedimento rodado. Quando o procedimento termina, a varivel destruda. Variveis locais
so ideais para espao de armazenamento temporrio quando o procedimento est sendo
executado. Pode-se possuir variveis locais de um mesmo nome em vrio procedimentos distintos,
pois cada um reconhecido somente pelo procedimento no qual est declarado.
Declarando Variveis
Uma varivel um marcador conveniente que refere-se a um local de memria do computador onde
voc poder armazenar informaes do programa que possam ser alteradas durante o tempo em
que sua script est rodando. Em VBScript, variveis so sempre um dos tipos fundamentais de
dados, Variant.
Declara-se variveis explicitamente em sua script utilizando a demonstrao Dim, Public e Private.
Por exemplo:
Dim DegreesFahrenheit
Declara-se mltiplas variveis separando-se cada nome da varivel com uma vrgula.
Por exemplo:
Dim Top, Bottom, Left, Right
Pode-se tambm declarer uma varivel implicitamente utilizando seu nome em sua script. Tal
atitude geralmente no de todo boa, pois voc poder digitar incorretamente o nome da varivel
em um ou mais locais, utilzando resultados inesperados quando sua script rodada. Por essa
razo, a demonstrao Option Explicit configurada por padro na interface Global Procedures
para requisitar declarao explcita de todas as variveis. A menos que voc delete essa
IWS 20/06/2007

InduSoft Web Studio

Pgina 434
demonstrao, ser necessrio declarar todas as variveis explicitamente; de outro modo, o
VBScript gerar erros durante o runtime, indicando que a varivel no existe.
Uma expresso deve ter a varivel no lado esquerdo e o valor que voc deseja assinar para a
varivel direita.
Por exemplo:
MyVar = 100
Criando Constantes
Uma constante um nome significativo que toma o lugar de um nmero ou string e nunca altera-
se. O VBScript define um nmero de constantes intrnsecas.
Cria-se constantes pr-definidas pelo usurio em VBScript utilizando a demonstrao Const.
Utilizando a constante Const, pode-se criar constantes string ou numrica com nomes
significantes, alm 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 so o meio mais bvio de
diferenciar valores de string de valores numricos. Representa-se Datas e Horas literais
enclausurando-as em sinais numricos (#).
Por exemplo:
Const CutoffDate = #6-1-97#
Caso voc deseje adotar um esquema de nomeao para diferenciar constantes de variveis, isso
poder evitar a tentativa de renomear valores constantes enquanto sua script estiver rodando. Por
exemplo, voc poder utilizar um prefixo "vb" or "con" nos nomes de suas constantes, ou nome-las
em letras maisculas. Diferenciar constantes de variveis elimina dvidas ao desenvolver scripts
mais complexos.
Precedncia de Operadores VBScript
VBScript possui uma alta escala de operadores, incluindo operadores aritimticos, de comparao,
concatenao e lgicas.
Quando vrios operadores ocorrem em uma expresso, cada parte validada e resolvida em uma
ordem pre-determinada e resolvida chamada operator precedence. Pode-se utilizar parnteses
para modificar a ordem de precedncia e forar algumas partes de uma expresso a ser validada
antes de outras. Operaes entre parnteses so sempre executadas antes daquelas que esto fora.
Dentro de parnteses, porm, a precedncia de operador padro mantida.
Quando expresses contm operadores de mais de uma categoria, operadores aritimticos so
avaliados primeiro, operadores de comparao so validados a seguir e operadores lgicos por
ltimo. Operadores de comparao tm todos o mesmo precedente; eles so validados da esquerda
para a direita na ordem em que aparecem. Operadores lgicos e aritimticos so validados na
seguinte ordem de precedncia.

Aritimtica Comparao Lgica
Negao (-) Igualdade (=) Not
Exponenciao (^) Desigualdade (<>) And
Multiplicao e diviso (*, /) Menor que (<) Or
Diviso por inteiro (\) Maior que (>) Xor
Mdulo aritimtico (Mod) Menor ou igual a (<=) Eqv
IWS 20/06/2007

InduSoft Web Studio

Pgina 435
Adio e subtrao (+, -) Maior ou igual a (>=) Imp
String de Concatenao (&) Is &

Quando multiplicao e diviso ocorrem conjuntamente em uma expresso, cada operador
avaliado como ocorre, a partir da esquerda para a direita. Da mesma forma, quando adio e
subtrao ocorrem conjuntamente em uma expresso, cada operador validado na ordem que
aparecem da esquerda para a direita.
O operador string de concatenao (&) no um operador aritimtico, mas em precedncia, esse
ocorre aps todos os operadores aritimticos e antes de operadores de comparao. O operador Is
um operador de comparao de referncia a um objeto, que no compara objetos ou seus valores, e
sim verifica somente para determinar se duas referncias de objeto referem-se ao mesmo objeto.
Utilizando Demonstraes Condicionais
Pode-se controlar o fluxo de sua script com demonstraes condicionais e loping de Demonstraes.
Utilizando Demonstraes condicionais, pode-se escrever cdigo VBScript que tome decises e
repita aes. As seguintes Demonstraes condicionais esto disponveis em VBScript:
If...Then...Else statement
Select Case statement
tomando decises Utilizando If...Then...Else
A demonstrao If...Then...Else utilizada para avaliar se a condio Verdadeira ou Falsa,
dependendo do resultado, para a especificao de uma ou mais Demonstraes a serem rodadas.
Geralmente, a condio uma expresso que utiliza um operador de comparao para comparar ou
valor ou varivel com outro. Para informaes sobre operadores de comparao, veja Operadores de
Comparao.
Demonstraes If...Then...Else podem ser colocadas conjuntamente em quantos nveis forem
necessrios.
Rodando Demonstraes Se uma Condio Verdadeira
Para rodar somente uma demonstrao quando uma condio Verdadeira, utilize a sintaxe linha-
nica para a demonstrao 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 cdigo, deve-se utilizar a sintaxe linha-mltipla (ou bloco).
Essa sintaxe inclui a demonstrao 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 436
Rodando Algumas Demonstraes Para Condio Verdadeira e Rodando Outras Para
Condio Falsa
Pode-se utilizar uma demonstrao If...Then...Else para definir dois blocos de demonstraes
executveis: um bloco para rodar caso a condio seja Verdadeira, e outro bloco para rodar caso a
condio 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 Vrias Alternativas
Uma variao da demonstrao If...Then...Else permite a escolha de vrias alternativas. Adicionar
clusulas ElseIf amplia a funcionalidade da demonstrao If...Then...Else, de forma que voc possa
controlar o fuxo do programa baseando-se em diferentes possibilidades. Por exemplo:
Sub ReportValue(value)
If value = 0 Then
MsgBox value
ElseIf value = 1 Then
MsgBox value
ElseIf value = 2 then
Msgbox value
Else
Msgbox "Value out of range!"
End If
Pode-se adicionar quantas clusulas ElseIf sejam necessrias para a obteno de escolhas
alternatives, embora o uso extensivo de clusulas ElseIf pode tronar-se exaustivo. A demonstrao
Select Case prov um mtodo mais eficaz para a escolha entre diferentes alternativas.
Tomando decises com Select Case
A estrutura Select Case fornece uma alternativa para o If...Then...ElseIf , selecionando a execuo
de um bloco de Demonstraes especfico entre mltiplos blocos de Demonstraes. Uma
demonstrao Select Case fornece capacibilidade semelhante demonstrao If...Then...Else, alm
de deixar o cdigo mais eficaz e com maior facilidade para leitura.
Uma estrutura Select Case trabalha com uma expresso nica de teste, validada uma vez na parte
superior da estrutura. O resultado da expresso ento comparado a valores para cada Case da
estrutura. Caso correspondam, o bloco de Demonstraes associados quele Case executado,
como no exemplo que se segue.
Select Case Document.Form1.CardType.Options(SelectedIndex).Text
IWS 20/06/2007

InduSoft Web Studio

Pgina 437
Case "MasterCard"
DisplayMCLogo
ValidateMCAccount
Case "Visa"
DisplayVisaLogo
ValidateVisaAccount
Case "American Express"
DisplayAMEXCOLogo
ValidateAMEXCOAccount
Case Else
DisplayUnknownImage
PromptAgain
End Select
Note que a estrutura Select Case valida uma expresso uma vez que esteja na parte superior da
estrutura. Em contraste, a estrutura If...Then...ElseIf pode validar uma expresso diferente para
cada demonstrao ElseIf. Pode-se substituir uma estrutura If...Then...ElseIf por Select Case
somente se cada demonstrao ElseIf validar a mesma expresso.
Executando em Loop Atravs do Cdigo
Executar em Loop permite rodar um grupo de Demonstraes repetidamente. Algumas execues
em loop repetem Demonstraes at uma condio ser Falsa; outras repetem Demonstraes at
um condio ser Verdadeira. Tambm existem execues em loop que repetem Demonstraes em
um nmero de vezes especfico.
As seguintes demonstraes em loop esto disponveis em VBScript:
Do...Loop: Executa em Loop enquanto ou at a condio ser Verdadeira
While...Wend: Executa em Loop enquanto a condio Verdadeira
For...Next: Utiliza um contador para rodar Demonstraes em um nmero especfico de vezes
Utilizando Execues Em Loop
Pode-se utilizar Demonstraes Do...Loop para rodar um bloco de Demonstraes em um nmero
infinito de vezes. As Demonstraes so repetidas enquanto uma condio Verdadeira e tambm
at que essa torne-se Verdadeira.
Repetindo Demonstraes Enquanto uma Condio Verdadeira
Utilize a palavra-chave While para verificar uma condio em uma demonstrao Do...Loop. Pode-se
verificar a condio antes de inserir o modo loop (como mostrado no exemplo ChkFirstWhile), ou
pode-se verific-la aps o modo loop ter sido rodado ao menos uma vez (como mostrado no exemplo
ChkLastWhile). No procedimento ChkFirstWhile, caso myNum esteja configurado como 9 ao invs
de 20, as Demonstraes do modo loop nunca sero rodadas. No procedimento ChkLastWhile, as
Demonstraes dentro do modo loop rodaro apenas uma vez, posto que a condio j Falsa.
Sub ChkFirstWhile()
Dim counter, myNum
counter = 0
myNum = 20
Do While myNum > 10
myNum = myNum - 1
IWS 20/06/2007

InduSoft Web Studio

Pgina 438
counter = counter + 1
Loop
MsgBox "The loop made " & counter & " repetitions."
End Sub

Sub ChkLastWhile()
Dim counter, myNum
counter = 0
myNum = 9
Do
myNum = myNum - 1
Loop While myNum > 10
End Sub
Repetindo uma Demonstrao at que a Condio Torne-se Verdadeira
Existem duas maneiras de utilizar a palavra-chave Until para verificar uma condio em uma
demonstrao Do...Loop. Pode-se verificar a condio antes de inserir o modo loop (como mostrado
no exemplo ChkFirstUntil), ou verific-la aps o modo loop ter sido rodado ao menos uma vez (como
mostrado no exemplo ChkLastUntil). O modo loop ocorrer, contanto que a condio seja Falsa.
Sub ChkFirstUntil()
Dim counter, myNum
counter = 0
myNum = 20
Do Until myNum = 10
myNum = myNum - 1
Loop
End Sub

Sub ChkLastUntil()
Dim counter, myNum
counter = 0
myNum = 1
Do
myNum = myNum + 1
Loop Until myNum = 10
End Sub
IWS 20/06/2007

InduSoft Web Studio

Pgina 439
Extraindo uma Demonstrao Do...Loop da Execuo Loop
Pode-se sair de Do...Loop utilizando a Demonstrao Exit Do. Geralmente deseja-se sair dessa
demonstrao somente em determinadas situaes, como quando deseja-se evitar um loop
interminvel. Por isso, deve-se utilizar a demonstrao Exit Do no bloco de demonstraes True de
uma demonstrao If...Then...Else. Caso a condio seja Falsa, o loop rodar normalmente.
No exemplo que se segue, myNum assinalado como um valor que cria um loop interminvel. A
Demonstrao If...Then...Else verifica esa condio, prevenindo repeties interminveis.
Sub ExitExemplo()
Dim counter, myNum
counter = 0
myNum = 9
Do Until myNum = 10
myNum = myNum - 1
If myNum < 10 Then Exit Do
Loop
End Sub
Utilizando While...Wend
A Demonstrao While...Wend fornecida em VBScript para usurios familiarizados com sua
utilizao. Entretanto, por causa da pouca flexibilidade While...Wend, recomendada a utilizao
do modo Do...Loop.
Utilizando For...Next
Pode-se utilizar Demonstraes For...Next para rodar um bloco de Demonstraes por um nmero
especfico de vezes. Para loops, utilize uma varivel de contagem, da qual o valor aumenta ou
diminui a cada repetio do loop.
O exemplo a seguir causa um procedimento chamado MyProc para execuo de 50 vezes. A
Demonstrao For especifica a varivel de contagem x, iniciando e finalizando valores. A
demonstrao Next incrementa a varivel 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 varivel de contagem, atravs do
valor especificado pelo usurio. No exemplo a seguir, a varivel 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 440
MsgBox "The total is " & total
End Sub
Para diminuir a varivel de contagem, utilize um valor Step negativo. Deve-se especificar um valor
final menor que o valor inicial. No exemplo a seguir, a varivel de contagem myNum diminuda
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 demonstrao Exit For, pode-se sair de qualquer demonstrao For...Next antes
que a varivel de contagem alcance seu valor final. Geralmente deseja-se sair do modo loop
somente em algumas situaes especficas, como quando na ocorrncia de um erro. Por isso, deve-
se utilizar a demonstrao Exit For no bloco de demonstrao True de uma demonstrao
If...Then...Else. Caso a demonstrao seja Falsa, o loop rodar normalmente.
Procedimentos em VBScript
Em VBScript, existem dois tipos de procedimentos: procedimento Sub e Function.
procedimentos Sub
Procedimento Sub uma srie de Demonstraes em VBScript (enclausurados por Demonstraes
Sub e End Sub) que executam aes, embora no retornem valores. Um procedimento Sub pode
pegar argumentos (constantes, variveis, ou expresses que passam quando o procedimento
solicitado). Caso um procedimento Sub no possuir argumentos, sua demonstrao Sub dever
incluir parnteses vazios ().
O procedimento Sub que se segue utiliza duas funes intrnsecas (built-in) do VBScript: MsgBox e
InputBox para prontificar um usurio sobre informaes. Depois, os resultados de um clculo so
baseados nessas informaes. O clculo executado em um procedimento Function criado com
VBScript. O procedimento Function ser exibido aps a discusso 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 srie de demonstraes em VBScript enclausuradas
pelas demonstraes Functione End Function. Um procedimento Function semelhante a um
procedimento Sub, embora tambm possa retornar um valor. Um procedimento Function pode
pegar argumentos (constantes, variveis ou expresses pasadas atravs de um procedimento de
solicitao). Caso um procedimento Function no tenha argumentos, sua demonstrao Function
dever incluir parnteses vazios. Function retorna um valor atravs do preechimento de um valor a
seu nome, em uma ou mais demonstraes do procedimento. O tipo de retorno de Function ser
sempre uma Variante.
IWS 20/06/2007

InduSoft Web Studio

Pgina 441
No exemplo que se segue, a funo Celsius calcula graus Celsius a partir de graus Fahrenheit.
Quando a funo solicitada a partir do procedimento Sub ConvertTemp, uma varivel contendo o
valor do argumento passada para a funo. O resultado do clculo retornado para o
procedimento de solicitao 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 utilizao 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 varivel vlido. Ao criar
um procedimento com a utilizao das demonstraes Sub ou Function, devero ser includos
parnteses aps o nome do procedimento. Quaisquer argumentos so colocados entre parnteses,
separados por vrgulas. Por exemplo, no exemplo que se segue, fDegrees o substituidor para o
valor a ser passado funo Celsius para converso.
Function Celsius(fDegrees)
Celsius = (fDegrees - 32) * 5 / 9
End Function
Para extrair dados de um procedimento, deve-se utilizar Function. Lembre-se de que um
procedimento Function pode retornar um valor, enquanto um procedimento Sub no pode.
Utilizando procedimentos Sub e Function em cdigo
O procedimento Function em seu cdigo deve ser sempre utilizado no lado direito de uma varivel
ou expresso assinalada. Por exemplo:
Temp = Celsius(fDegrees)
ou
MsgBox "The Celsius temperature is " & Celsius(fDegrees) & " degrees."
Para solicitar um procedimento Sub a partir de outro procedimento, digite o nome do procedimento
com valores para quaisquer argumentos solicitados, separados por vrgulas. A demonstrao Call
no requisitada, mas caso voc queira utiliza-la, deve-se colocar os argumentos entre parnteses.
O exemplo a seguir mostra duas solicitaes para o procedimento MyProc. Uma delas utiliza a
demonstrao Callno cdigo; a outra no. Ambas executam exatamente a mesma funo.
Call MyProc(firstarg, secondarg)
MyProc firstarg, secondarg
Note que os parnteses so omitidos na solicitao quando a demonstrao Call no utilizada.
IWS 20/06/2007

InduSoft Web Studio

Pgina 442
Captulo 16: Utilizando a Ferramenta/Editor de Traduo
Utilizando a Ferramenta de Traduo, pode-se traduzir qualquer texto da aplicao que esteja visvel
durante o runtime para diferentes linguagens (idiomas). As principais vantagens desse recurso so:
No necessrio recriar as telas, alarmes ou quaisquer outras interfaces de sua aplicao para traduz-la
para outro idioma. Todos os arquivos da aplicao permanecem em seu idioma original (e.x. English), e a
traduo 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
aplicao para qualquer idioma que requisite caracteres UNICODE (Japons, Chins, Coreano, etc.)
conquanto que voc selecione a fonte UNICODE para seu projeto.
A traduo para outros idiomas pode ser configurada em um arquivo CSV padro. Portanto, pode-se utilizar
o Translation Editor do IWS (Tools > Translation Editor) para registrar (escrever) textos traduzidos, ou
utilizar qualquer editor para arquivos CSV, como Microsoft Notepad ou Microsoft Excel, para criar o arquivo
com o texto traduzido.
Translation Tool traduz frases e pargrafos inteiros, ao invs de traduzir palavra por palavra, permitindo o
ajuste do texto traduzido de acordo com as regras gramaticais de cada idioma.
Pode-se configurar o idioma padro para traduo ao rodar a aplicao utilizando uma inteface Automatic
Translation, disponvel no tab Options do dilogo Project Settings (Project > Settings). Alm disso, pode-se
alterar o idioma durante o runtime (on-the-fly) utilizando a funo 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 vrios Web Thin Clients rodando simultaneamente, e cada um pode exibir
as telas em um idioma diferente.
IWS 20/06/2007

InduSoft Web Studio

Pgina 443
Configuraes do Projeto para Traduo Automtica
Ao configurar uma aplicao para suportar mais de um idioma, pode-se configurar os parmetros a seguir
no tab Options do dilogo Project Settings (menu Project > Settings):

Dilogo Project Settings Tab Options
Translation File Name: O arquivo de traduo configurado nesse campo ser carregado por padro logo ao
iniciar a Aplicao. Essa opo til para configurar o nome do arquivo de traduo padro ao iniciar a
aplicao. O usurio pode configurar diferentes idiomas durante o runtime, executando a funo
SetTranslationFile().
Habilite Translation: Quando essa opo est desabilitada (clear), a Ferramenta de Traduo est
desabilitada e o texto exibido somente como configurado nos arquivos originais da aplicao.
Ao apertar o boto Advanced, pode-se configurar os seguintes parmetros para a Ferramenta de Traduo:

Dilogo Advanced
* Startup Column Name: Pode- se criar um ar quivo CSV com traduo para mais de um
idioma. O texto no idioma original utilizado quando a aplicao foi criada est na
primeira coluna do arquivo CSV. Cada idioma adicionado a novas colunas. A primeira
linha do arquivo CSV indica o nome de cada coluna. Pode-se especificar nesse campo o
nome de cada coluna que dever ser utilizada, por padro, para traduzir a aplicao
IWS 20/06/2007

InduSoft Web Studio

Pgina 444
logo ao inici-la. Caso esse campo for deixado em branco, a aplicao ser iniciada com
seu idioma original. O usurio poder configurar um idioma diferente durante o runtime
executando a funo SetTranslationFile().
* Ignore space chars at the end and beginning of the text: Quando essa opo est
habilitada, o caractere espao no final e no incio de cada texto ignorado para a
traduo. Essa opo til para evitar entradas duplicadas na tabela de traduo
devido aos caracetres de espao configurados erroneamente ao criar os objetos ou
somente ajustar o alinhamento.
* Keep original text when translation is blank: Quando essa opo est habilitada, o texto
original ser mantido quando no houver um texto configurado para ser traduzido na
coluna atualmente destinada traduo da Aplicao. Caso essa opo esteja
desabilitada, o texto original ser omitido durante o runtime quando no houver textos
atualmente configurados para traduo da aplicao.
Configurando Object Properties para Objetos de Tela
Para habilitar a traduo de objetos de tela individuais, utilize o procedimento que se segue:
E Crie os objetos de texto e tela para sua aplicao utilizando a barra de ferramentas descrita em
Utilizando Objetos e Dinmicas o incio da pgina 185.
E Ao abrir os dilogos Object Properties para especificar os parmetros de cada objeto, verifique se
o check-box Extern translation est habilitado ( ).
Por exemplo, nessa figura Extern translation est habilitado para o objeto boto OPC:

Traduo Habilitada para o Boto OPC
IWS 20/06/2007

InduSoft Web Studio

Pgina 445
Translation Editor
O Translation Editor pode ser iniciado pela opo do menu Tools > Translation Editor:

Translation Tool
O arquivo especificado no campo Translation File Name a partir do tab Options do dilogo Project
Settings (Project > Settings) j estar aberto por padro. Pode-se abrir um arquivo diferente de
traduo a partir da opo File > Open no menu Translation Editor. Alm disso, pode-se criar um
novo arquivo de traduo com a opo File > New no menu do Translation Editor.
A primeira coluna reservada para o texto em seu idioma original, utilizado quando a aplicao foi
criada. Embora voc possa adicionar texto a essa coluna manualmente, tambm possvel importar
o texto de sua aplicao automaticamente para essa coluna executando-se o comando Import
String Application, disponvel no tab File do menu do Translation Editor.

= Dica:
Pode-se executar o comando File > Import String Application para atualizao da
planilha atual no Translation Editor quantas vezes forem necessrias. Sempre que esse
comando for executado, o texto disponvel na aplicao que ainda no foi includo na
planilha ser inserido prontamente. Porm, esse comando no remove textos de uma
planilha, apesar do modo como foi inserido na planilha (manual ou automaticamente).

Pode-se escrever a traduo para cada idioma diferente em colunas adicionais (que no seja na
primeira coluna). Tambm possvel utilizar as seguintes opes do menu Edit do Translation
Editor para configurar as colunas do arquivo para traduo:
Insert Column (atalho F9): Insere uma nova coluna no arquivo de traduo.
Rename Column (atalho F10): Permite a renomeao da coluna selecionada atualmente.
Insert Column (atalho F11): Deleta a coluna selecionada atualmente.

Aps editar o arquivo de traduo, pode-se utilizar as opes File > Save or File > Save As do menu
do Translation Editor para salvar as configuraes no arquivo de traduo (em formato CSV).
IWS 20/06/2007

InduSoft Web Studio

Pgina 446
O InduSoft Web Studio suporta arquivos de traduo em formato CSV. Assim, pode-se utilizar tanto
o Translation Editor como qualquer outro editor para arquivos CSV, como Microsoft Notepad ou
Microsoft Excel para a criao do arquivo de traduo. A primeira linha do arquivo CSV indica o
nome de cada coluna. As colunas so separadas pela utilizao de vrgulas (,).
Embora seja possvel criar mais de um arquivo de traduo, recomendvel que se mantenha a
traduo para todos os idiomas em um nico arquivo, pois dessa maneira torna-se mais fcil para
mant-los atualizados quando a aplicao modificada Pode-se atualizar o arquivo de traduo
utilizando o File > Import String Application apenas uma vez.

Notas:
Por diversas razes, o Translation Tool suporta arquivos de traduo com a extenso
TRA. Tais arquivos salvos com essa extenso utilizar o caractere barra (|) ao inves de
vrgulas (,) para a separao do texto entre as colunas.

Editando Planilhas
Para abrir a planilha a ser editada:
E Selecione File Open.
E Quando aparecer o dilogo Open, localize e selecione a planilha a qual voc deseja editar.
E Clique em OK para fechar o dilogo.
D Salvando Tempo de Digitao:
Aps digitar os termos na planilha, pode-se selecionar File Save As para salvar uma
cpia da planilha com um novo nome ou selecionar Window New Window para abrir
uma nova janela contendo uma planilha duplicada, que poder ser salva com um novo
nome. Assim, na nova planilha, voc poder manter os termos em uma coluna e
substitu-los em outra coluna.

Existem vrio meios para a edio 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:
E 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.
E Salve suas alteraes na planilha selecionando File Save or File Save As.
Nota:
Embora seja possvel salvar arquivos da planilha de traduo em qualquer diretrio,
recomendamos que os arquivos sejam salvos na pasta Web de seu projeto, tornando-os
disponveis para a utilizao de um Web Thin Client.

IWS 20/06/2007

InduSoft Web Studio

Pgina 447
Inserindo linhas
Caso voc deseje inserir um ou mais termos entre os termos j existentes na planilha, posicione o
cursor em uma clula, selecione Edit Insert Line, e o IWS ir inserir uma linha em branco acima
da clula j existente.
Por exemplo,

Inserindo um Linha
Copiando termos entre planilhas
O Translation Editor permite recortar ou copiar termos de uma planilha Translation e col-los em
uma outra planilha. Tambm possvel copiar os termos de um arquivo em Excel e cola-los em
uma planilha Translation.
Para copiar termos de uma planilha (ou arquivo) para outra, siga os passos a seguir:
E Abra ambas as planilhas.
E Localize o termo (s) que voc deseja copiar e selecione-o com o cursor.
E Pode-se selecionar mltiplos termos de uma coluna e copi-los em outra coluna.
E Copie o termo(s) selecionado Edit Copy, apertando Ctrl+C, ou clicando em ).
E Na segunda planilha, selecione a clula (s) onde voc deseja colocar os novos termos, e cole-os
selecionando Edit Paste, apertando Ctrl+V, ou clicando em ).
E Repita os passos anteriores at que todos os termos desejados tenham sido compartilhados
entre as planilhas.
E Salve suas alteraes.
Pesquisando a planilha
Caso sua planilha contenha vrios termos (pode-se inserir at termos), voc poder utilizar as
opes Edit Find or View View Line para efeturar a pesquisa dos termos desejados.
Selecionar Edit Find abre o dilogo Find:
Antes: Seleo de Temperature
Depois: Nova linha inserida acima de Temperture
IWS 20/06/2007

InduSoft Web Studio

Pgina 448

Dilogo Find
Digite um termo no text box Find What e especifique um ou mais dos seguintes parmetros
opcionais de pesquisa:
* Match whole word only: Habilite ( ) esse box para evitar que o IWS busque termos
inseridos em meio a outra palavra. Por exemplo, estando essa opo desabilitada, e
tentar procurar por e, o IWS encontrar operando, expandir, etc.
* Match case: Habilite ( ) esse box para pesquisar um termo utilizando a mesma
capitalizao digitada no text box Find What. Por exemplo, estando essa opo
desabilitada e tentar pesquisar por TankLevel, o IWS encontrar TANKLEVEL ou
tanklevel.
* Up e Down: Habilite esse boto para controlar a direo na qual o progroma dever
buscar pelo seu termo. A pesquisa ter seu incio a partir da linha atual. Por exemplo,
caso existam 345 linhas na planilha inteira e voc encontra-se na linha 325, o IWS
pesquisar somente 325 de 345.
Clique em Find Next para iniciar (e continuar) a pesquisa por um termo.
Utilize a opo View View Line para alcanar uma linha particular da planilha. Quando o
dilogo Line aparecer, digite o nmero da linha no campo Number e clique em OK.

Dilogo Line
Eestaurando padres
Aps 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 exibio.
Salvando suas planilhas
Para salvar seu trabalho aps a criao ou edio de uma planilha Translation, selecione File Save ou
File Save As da barra de menu de Translation Editor.
Executando as Funes de Traduo
Aps habilitar a traduo para a aplicao e objetos de tela, e criar/editar planilhas Translation, voc
poder executar as seguintes funes do IWS:
IWS 20/06/2007

InduSoft Web Studio

Pgina 449
SetTranslationFile(strFileName): Especifica o arquivo da planilha Translation e traduz todos os
textos habilitados da aplicao durante o runtime.
Ext(strText): Especifica um string do texto (no relacionado a um objeto de tela) a ser traduzido.
Por exemplo, o resultado de uma expresso a ser visualizada por um usurio final.
Pode-se executar ambas as funes de forma simultnea, e essas iro pesquisar a aplicao e alterar o
texto/objetos especificados para serem traduzidos para o novo idioma. Ambas as funes so suportadas
pelo Windows NT/2000/XP/CE e plataformas Web Thin Clients.
Nota:
Pode-se salvar arquivos de traduo em qualquer diretrio; porm, recomendamos que os
arquivos sejam salvos na pasta Web de seu projeto, de forma a poderem ser utilizados
por um Web Thin Client.
Por exemplo, caso seu idioma de desenvolvimento padro seja Ingls e voc deseja tornar
o arquivo disponvel para Web Thin Clients, pode-se alterar o nome padro 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 funo SetTranslationFile(strFileName) para traduzir todos os objetos de tela
habilitados dentro da aplicao.
Para executar essa funo,
E Crie dois botes (ou outro objeto de tela).
E Clique duas vezes em cada boto para abrir o dilogo Object Properties e especificar um nome
significativo para cada um deles (Por exemplo, English e Spanish).

Criando Dois Botes
E Clique no primeiro boto e aplique a propriedade Command ( ).
E Clique duas vezes no boto para abrir o dilogo Object Properties.
E Digite SetTranslationFile(strFileName) no campo Expression para substituir o nome do
arquivo de traduo entre a planilha dupla.
Por exemplo, SetTranslationFile(English.tra)

Configurando o Arquivo de Traduo
IWS 20/06/2007

InduSoft Web Studio

Pgina 450
Nota:
Caso voc salve as planilhas Translation na pasta Web de seu projeto (para tornar os
arquivos disponveis para Web Thin Clients), deve-se tambm digitar o caminho do
diretrio para o determinado arquivo. Por exemplo,
C:\Program Files\InduSoft Web Studio\<Project Name>\Web\<filename.tra>
ou digite (\web\<filename>.tra).

E Aplique a propriedade Command para o Segundo boto, e depois clique duas vezes no boto
para abrir o dilogo Object Properties.
E Digite SetTranslationFile(strFileName)no campo Expression para substituir o nome do
segundo arquivo de traduo entre a planilha dupla.
Por exemplo, SetTranslationFile(Spanish.tra)
A partir de agora, ao rodar a aplicao ( ) voc poder clicar nos botes para inverter entre os
dois idiomas, como mostrado nas telas que se seguem:

Traduzindo entre Ingls e Espanhol
Caso voc queira verificar que a traduo foi executada com sucesso, pode-se criar um tag (Por exemplo,
STATUS) e adicion-lo tela de sua aplicao. Quando voc rodar a aplicao, o novo tag ir retornar um
dos valores listados na tabela abaixo.

Valor de
Retorno
Descrio
0 Success
1 Invalid number of parameters
Clique no Boto Spanish
e os Objetos de Tela
sero Exibidos em
Espanhol
Clique no Boto English
e os Objetos de Tela
sero Exibidos Display
em Ingls
IWS 20/06/2007

InduSoft Web Studio

Pgina 451
2 Wrong parameter type
3 Translation file could not be found
or opened

Utilizando Ext(strText)
Pode-se utilizar a funo ext(strText) para traduzir strings de texto da aplicao, como os
resultados de um operao que voc deseja que seja exibida para um usurio final.
Para executar essa funo,
E Abra uma planilha no IWS (Por exemplo uma planilha Math), e digite um tag tipo string na
coluna Tag Name.
E Clique duas vezes em cada boto na tela para abrir o dilogo Object Properties e especificar um
nome significativo para cada um deles (Por exemplo, English e Spanish).
A funo ext(strText) retorna a traduo do texto utilizando a planilha ativa Translation.
Por exemplo,
Ext(Start) // Returned value in Spanish = Comience
Ext(Stop) // Returned value in Spanish = Pare
Ext(StrTag)
Fechando o Translation Editor
Para fechar o Translation Editor, selecione File Exit da barra de menu Translation Editor.
Caso voc j tenha salvo a planilha(s) aberta(s) Translation, o Translation Editor ser fechado
imediatamente.
Caso exista alteraes no salvas em planilha(s) Translation aberta(s), o IWS ir requisitar que
tais alteraes sejam salvas antes de finalizar a funo.
Clique em Yes para salvar as alteraes e feche a janela.
Clique em No para fechar a janela sem que as alteraes sejam salvas.
Clique em Cancel para manter a janela aberta e continuar o trabalho na planilha.
IWS 20/06/2007

InduSoft Web Studio

Pgina 452
Captulo 17: Interface Banco de Dados do IWS
Configurar uma interface de banco de dados com o IWS significa basicamente estabelecer links entre
tarefas do IWS (Alarms, Events ou Trends) para tabelas do banco de dados externo atravs de um Provedor
Especfico de Banco de Dados que suporte o banco de dados escolhido.
Cada histrico 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 fcil compreenso,
com tecnologias padro de MDAc (Microsoft Data Access Components), como OLE-DB (Object Linking
Embedded Database) e ODBC (Open Database Connectivity). Utilizando-se dessa capacidade, possvel
conectar-se a qualquer banco de dados compatvel a MDAC (veja Conformance Test Table para a lista de
banco de dados j testados pela InduSoft).
As tarefas a seguir suportam a interface de banco de dados :
Alarms: A aplicao pode salvar e/ou entregar mensagens de histricos de alarmes em um
banco de dados relacional.
Events: A aplicao pode salvar e/ou entregar mensagens de evento em um banco de dados
relacional.
Trends: A aplicao pode salvar e/ou entregar valores histricos de Trend em um banco de
dados relacional.
Viewer: Informaes do banco de dados podem ser exibidas tanto em formato tabela (Alarm e
objetos Grid) quanto em formato grfico (objeto Trend).
Web: Os itens listados abaixo j Esto disponveis na Interface do IWS da Web; assim, voc
poder desfrutar de uma aplicao que armazena/salva dados em um banco de dados
relacional, bem como t-la trabalhando por toda a Web.
Com a utilizao de sua prpria interface de banco de dados, o IWS pode facilmente tanto fornecer dados do
cho de fbrica 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 vlidos ADO.NET Provider, OLE DB Provider ou ODBC Driver. Porm, os testes de
compatibilidade foram executados junto aos seguintes bancos de dados:
Banco de
Dados
Verso ADO.NET Provider Verso do Grupo
Microsoft
SQL Server
2000
8.0 System.Data.SqlClient 1.0.5000.0
Microsoft
Access
2000
9.0.3821 SR-1 System.Data.OleDbClient 1.0.5000.0
Microsoft
Excel 2000
9.0.3821 SR-1 System.Data.OleDbClient 1.0.5000.0
Oracle 10g Release 1 for
Windows
System.Data.OracleClient 1.0.5000.0
Sybase Anywhere 9.0.1.1751 iAnywhere.Data.AsaClient 9.0.1.1751
MySQL 4.0.20a ByteFX.MySqlClient 0.7.6.15073

Tabela de Teste de Compatibilidade
IWS 20/06/2007

InduSoft Web Studio

Pgina 453
Nota:
Para informaes sobre como configurar um banco de dados especfico,
consulte os Apndices desse manual.

Conceitos Gerais
Essa seo descreve banco de dados e fornecedores, alm do modo como o IWS estabelece interface com
diferentes bancos de dados.
Banco de Dados Relacionais SQL
Um Banco de Dados SQL Relacional um conjunto de informaes armazenadas em tabelas com
campos e registros que suportam comandos SQL.
Cada banco de dados pode possuir uma ou mais tabelas, sendo que cada tabela composta por
campos (colunas) e registros (linhas). Tipicamente, os campos so pr-definidos e a aplicao
adiciona ou l um ou mais desse registros, de acordo com a condio apresentada.

Database DB1
Table X
Register 1
Register 2
Register 3
Field A Field B Field C
Table Y
Register 1
Register 2
Register 3
Field D Field E Field F
Database DB1
Table X
Register 1
Register 2
Register 3
Register 1
Register 2
Register 3
Table Y
Register 1
Register 2
Register 3
Register 1
Register 2
Register 3

O IWS utiliza Database Providers (ADO.NET) para estabelecer interface com Banco de Dados SQL
Relacionais. Database Providers so bibliotecas desenvolvidas para acesso a dados a partir de
diferentes bancos de dados atravs de comandos SQL. O ADO.NET Provider para um banco de
dados especfico pode ser suprimido por um sistema operacional ou por um fabricante de banco de
dados.
A figura a seguir ilustra como o IWS estabelece interface com diferentes bancos de dados
utilizando-se de Database Provider para cada banco de dados.

IWS 20/06/2007

InduSoft Web Studio

Pgina 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 atravs de um driver ODBC . Veja
Apndice do Banco de Dados A: Utilizando Banco de Dados ODBC para informaes sobre como
utilizar esse fornecedor. Tambm possvel que voc no possua um ADO.NET provider, embora
um OLE DB provider j esteja disponvel. 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 aplicaes
em um pacote Microsoft Office com a utilizao desse.

Nota:
importante notar que o IWS fornece a interface para ADO.NET Providers. Porm,
ADO.NET Providers e/ou ODBC Driver/OLE DB Provider tambm devero ser
supridos pelo sistema operacional ou pelo fabricante do banco de dados. Caso seu
string de conexo no referir-se a um ADO.NET Provider vlido, o OLE DB Provider
ser utilizado.

Embora a maioria das aplicaes tipicamente estabeleam um link para somente um tipo de banco
de dados, o IWS permite a flexibilidade para estabelecer um link de cada tarefa a um banco de
dados especfico suportado por um Database Provider. Alm disso, com a utilizao dessa
Arquitetura, voc no precisar se preocupar com caractersticas especficas 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 configuraes da aplicao em sua maioria so
uniformes, apesar do banco de dados especfico escolhido.

IWS 20/06/2007

InduSoft Web Studio

Pgina 455

Formato Histrico
As tarefas do IWS que podem gerar dados histricos (Alarms, Events e Trend) podem ser
configuradas para salvar dados tanto em arquivo histrico de formato de propriedade IWS quanto
em um Banco de Dados SQL Relacional externo. Pode-se escolher o formato de arquivo histrico
atravs do combo-box History Format disponvel para cada tarefa. A tabela a seguir mostra as
opes disponveis para cada tarefa:

Tarefa Formato
Histrico
Configuraes
Proprietary
File Format: Texto (UNICODE). O IWS utilize o caractere
barra vertical (|)para separar os campos.
Default Path: \<Aplication
Path>\Alarm\ALYYMMDD.ALH , onde:
YY = dois ltimos dgitos do ano
MM = Ms
DD = Dia.
Alarms
Database
Default Table Name: AlarmHistory
Proprietary
File Format: Texto (UNICODE). O IWS utilize o caractere
barra vertical (|) para separar os campos.
Default Path: \<Aplicatiuon
Path>\Alarm\EVYYDDMM.EVT , onde:
MM = Ms
DD = Dia.
Events
Database
Default Table Name: EventHistory
Proprietary
File Format: Binrio
Default Path: \<Aplication Path>\Hst\GGYYDDMM.HST
, onde:
GG = Nmero do grupoTrend r (em formato hexadecimal)
YY = Dois ltimo dgitos do ano
MM = Ms
DD = Dia.
Trend
Database
Default Table Name: TRENDGGG (GGG = Nmero da
Planilha Trend e.x. TREND001 para a Planilha Trend
001)

IWS 20/06/2007

InduSoft Web Studio

Pgina 456
Bancos de Dados Primrios e Secundrios
O IWS suporta sistemas redundantes. Portanto, ao configurar a interface de um banco de dados,
pode-se configurar o Banco de Dados Primrio e, opcionalmente, o Banco de Dados Secundrio.
Tais bancos de dados podem ser configurados nos seguintes modos:
Disabled: Nesse modo, o IWS salva dados somente no Banco de Dados Primrio. Caso o Banco
de Dados Primrio esteja indisponvel por qualquer razo, os dados no sero salvos em lugar
algum. Essa opo pode causar perda de dados caso o Banco de Dados Primrio no esteja
disponvel.
Redundant: Nesse modo, o IWS salva os dados tanto no Banco de Dados Primrio quanto no
Secundrio. Caso um deles esteja indisponvel, o IWS manter os dados salvos naquele
disponvel no momento. Quando o banco de dados antes indisponvel tornar-se disponvel
novamente, o IWS sincroniza ambos automaticamente.
Store and Forward: Nesse modo, o IWS salva dados somente no Banco de Dados Primrio. Caso
o Banco de Dados Primrio tornar-se indisponvel, o IWS salvar os dados no Banco de Dados
Secundrio. Quando o Banco de Dados Primrio tornar-se ativo novamente, o IWS mover os
dados do Banco de Dados Secundrio para o Banco de Dados Primrio.

Nota:
Os Bancos de Dados Prmrio e Secundrio podem ser de tipos diferentes.
Porm, devem possuir os mesmos campos.

Utilizando o Banco de Dados Secundrio, pode-se aumentar a realstica do sistema, alm de
utiliz-lo como um backup quando o Banco de Dados Primrio no estiver disponvel. Essa
Arquitetura particularmente til quando o Banco de Dados Primrio est localizado em uma
estao remota. Nesse caso, pode-se configurar um Banco de Dados Secundrio na estao
local para salvar dados temporariamente, caso o Banco de Dados Primrio no esteja disponvel
(durante uma falha na rede de trabalho, por exemplo).

IWS 20/06/2007

InduSoft Web Studio

Pgina 457
Banco de Dados Padro
Embora o IWS permita a configurao de um banco de dados para cada tarefa, tipicamente o
mesmo tipo de banco de dados (e.x. SQL Server, MS Access, Oracle, etc) utilizado por todas as
tarefas de um mesmo projeto. Portanto, de forma a economizer tempo ao configurar a aplicao, o
IWS permite a configurao do Default Database. Ao configurar cada tarefa, voc poder escolher a
opo de utilizar os parmetros configurados para o Default Database. Caso escolha esse mtodo,
no ser necessria a reconfigurao dos mesmos parmetros para cada tarefa, j que essas
compartilharo o mesmo banco de dados.
As configuraes para o Default Database podem ser efetuadas apertando o boto Configure no box
Default Database no tab Options do dilogo Project Settings.

Clicando nesse boto, aparecer a seguinte janela:

IWS 20/06/2007

InduSoft Web Studio

Pgina 458
Leia a seo Configurando Banco de Dados para informaes sobre os campos dessa janela.
Estabelecendo Link do Banco de Dados atravs de um DB Provider Remoto
Dependendo da Arquitetura de seu projeto, o ADO.NET Provider para Banco de Dados SQL
Relacional poder no estar disponvel nas mesmas estaes onde o IWS est rodando. Esse
cenrio especialemnte comum quando a aplicao est rodando em um sistema operacional
Windows CE (atualemnte, a maioria dos provedores no so suportados para sistema operacional
Windows CE). De maneira a resolver esse problema, a InduSoft projetou uma soluo flexvel,
permitindo que voc configure sistemas de distribuio, como ilustrado na figura a seguir:

A Aplicao est rodando na estao da aplicao do Studio Aplicao (onde o IWS e/ou CEView
Esto instalados). A aplicao pode comunicar-se com o Database Gateway do IWS (rodando em
um computador remoto) via TCP/IP. O Gateway implementa a interface com o Banco de Dados
atravs de um provedor disponvel no computador onde est rodando.
O Database Gateway do IWS no requer configuraes complexas. Basta copier os arquivos
STADOSvr.exe e StADOSrv.ini da subpasta \BIN sub-folder do IWS e cola-los em qualquer diretrio
do computador que esteja sendo utilizado como estao Gateway e executar o programa
STADOSvr.exe. Existem configuraes associadas ao Studio Database Gateway, mas essas no
devem ser alteradas, a menos em circunstncias especiais. Veja Studio Database Gateway para
informaes sobre como configurar pametros avanados do Studio Database Gateway.
= Dica:
O IWS Database Gateway um TCP/IP Server para a aplicao do IWS, e utiliza
TCP Port 3997 por padro. Pode-se especificar um nmero distinto para a porta
ao executar o programa STADOSvr.exe de acordo com a sintaxe a seguir:
STADOSvr.exe <Port Number> . Exemplo: STADOSvr 3998

IWS 20/06/2007

InduSoft Web Studio

Pgina 459
Configurando Parmetros dos Bancos de Dados
Para configurar uma interface do banco de dados com o IWS deve-se basicamente estabelecer links entre
tarefas do IWS (Alarms, Events ou Trends) para tabelas de banco de dados externos via um Provedor
especfico de Banco de Dados que suporte o banco de dados escolhido.
Cada histrico de tarefa (Alarm, Events ou Trend) pode ser configurado para salvar dados tanto para
arquivos de formato de propriedade do Studio ou para Banco de Dados SQL Relacionais externos. Ao
selecionar o Banco de Dados como Formaro de Propriedade, as configuraes da interface do banco de
dados podem ser efetuadas atravs das seguintes interfaces:

Tarefa Interface
Alarms
Selecione o menu Project Settings menu.
Selecione o tab Options no dilogo Project Settings.
Escolha o Banco de Dados no combo-box History Format.
Clique no Boto Alarm Database.
Configure os parmetros do banco de dados no dilogo Database.
Events
Selecione o menu Settings.
Selecione o tab Options no dilogo Project Settings.
Clique no boto Event Database.
Configure os parmetros do banco de dados no dilogo Database
Configuration.
Trend
Crie ou abra uma planilha Trend.
Clique no boto Database Configuration.
Configure os parmetros do banco de dados no dilogo Database
Configuration.

Nota:
Alarms e Events so salvos em formato de propriedade do IWS, e ambos so
salvos em Bancos de Dados Relacionais externos; porm, tambm podem ser
salvos em diferentes bancos de dados.
Cada planilha Trend pode ser configurada para salvar dados em formato de
propriedade do IWS ou em Banco de Dados SQL Relacional externo.

IWS 20/06/2007

InduSoft Web Studio

Pgina 460
Dilogo Database Configuration
O dilogo Database Configuration permite a configurao dos parmetros necessrios para
estabelecer um link entre o IWS e um Banco de Dados SQL Relacional externo.
A figura a seguir mostra o dilogo Database Configuration:

Dilogo Database Configuration

combo-box Database: Permite a seleo Primary ou Secondary. Em Primary, todas as
configuraes exibidas na janela Database Configuration sero aplicadas a interface do Banco
de Dados Primrio. Tambm aplicam-se a interface do banco de dados Secundrio. Pode-se
configurar o Banco de Dados Secundrio nos seguintes modos:
Disabled: Nesse modo, o IWS salva dados somente no Banco de Dados Primrio. Caso o Banco
de Dados Primrio esteja indisponvel por qualquer razo, os dados no sero salvos em
nenhum outro local. Essa opo pode causar perda de dados, caso o Banco de Dados Primrio
esteja indisponvel.
Redundant: Nesse modo, o IWS salva dados tanto no Banco de Dados Primrio quanto no
Secundrio. Caso um deles esteja indisponvel, o IWS mantm os dados salvos somente no
banco de dados disponvel no momento. Quando banco de dados indisponvel voltar a estar
disponvel, o IWS sincroniza ambos automaticamente.
Store and Forward: Nesse modo, o IWS salva dados no Banco de Dados Primrio somente. Caso
o Banco de Dados Primrio tornar-se indisponvel, o IWS salva os dados no Banco de Dados
Secundrio. Quando o Banco de Dados Primrio tornar-se disponvel novamente, o IWS move
os dados do Banco de Dados Secundrio para o Banco de Dados Primrio.
Utilizando o Banco de Dados Secundrio, pode-se aumentar a realstica do sistema e utilizar o
Banco de Dados Secundrio como um backup quando o Banco de Dados Primrio no est
disponvel. Essa Arquitetura particularmente til quando o Banco de Dados Primrio est
localizado em uma estao remota. Nesse caso, pode-se configurar um Banco de Dados
IWS 20/06/2007

InduSoft Web Studio

Pgina 461
Secundrio na estao local para salvar dados temporariamente caso o Banco de Dados
Primrio no estiver disponvel (durante uma falha na rede de trabalho, por exemplo).
check-box Use Aplication default: Quando esta opo est habilitada, o IWS utilize os
parmetros 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 parmetros 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 parmetros principais utilizados ao conectar-se ao banco de dados. Ao
invs de registrar o Connection string manualmente, pode-se apertar o boto do browse () e
selecionar o tipo de banco de dados a partir da janela Data Link Properties.

Nota:
A lista de Provedores de Banco de Dados exibidos na janela Data Link
Properties depender dos provedores instalados e disponveis no computador
onde voc est rodando o IWS. Consulte a documentao do sistema
operacional (na documentao do Banco de Dados) para maiores informaes
sobre as configuraes do Provedor para o banco de dados a ser utilizado.

Campo User name: Nome do usurio utilizado para conectar-se ao banco de dados. O nome do
usurio 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 indisponvel para conectar-se ao banco de dados por
qualquer razo, ele tentar uma nova conexo ao banco de dados automaticamente aps o
nmero de segundos configurados nesse campo.
IWS 20/06/2007

InduSoft Web Studio

Pgina 462
Boto Advanced: Aps apertar esse boto, voc obter acesso a algumas configuraes
costumizveis. Para a maioria das aplicaes, o valor padro no precisa ser modificado, e deve
ser mantido.

combo box Milliseconds: Pode-se configurar como os milissegundos sero salvos ao
configurar e salvar a data no banco de dados. Cada banco de dados salva a data em
formatos diferentes; Por exemplo, alguns bancos de dados no suportam milissegundos em
um campo Date. Esto disponveis as seguintes opes:
Default: Utiliza o formato pr-definido para o banco de dados atual. O banco de dados
previamente testado pela InduSoft j so configurados com a opo mais adequada. Ao
selecionar Default, o IWS utiliza os parmetros pr-configurados para o tipo de banco
de dados atual. Caso voc esteja utilizando um banco de dados que j tenha sido
previamente testado e configurado pela InduSoft, a opo Default tentar salvar os
milissegundos em um campo separado.
= Dica:
A opo padro para cada banco de dados est configurada no arquivo
StudioADO.ini, armazenado na subpasta \BIN do IWS. Veja Studio Database
Gateway para informaes sobre como configurar o arquivo StudioADO.ini.

Disable: No salva os milissegundos ao salvar a data no banco de dados.
Enable: Salva os milissegundos no mesmo campo onde a data foi salva.
salva em um campo (sem a preciso de milissegundos) e o nmero de milissegundos
salvo em uma coluna diferente. Essa opo indica onde voc deseja salvar timestamps
com a preciso de milissegundos, embora o banco de dados que voc est utilizando
no suporte milissegundos para os campos Date.
check-box Save time difference: Quando essa opo est habilitada (padro), o IWS salva a
Time Zone configurada no computador onde a aplicao est rodando para cada registro no
banco de dados. Essa opo deve ser habilitada para evitar problemas horrios a serem
salvos.
Database Gateway: Insira o Endereo Host Name/IP onde o Studio database gateway
estiver rodando. O nmero da Porta TCP tambm pode ser especificado, mas caso o padro
no estiver sendo utilizado, voc ter que configurar o Studio database gateway com a
mesma Porta TCP. Veja Studio Database Gateway para informaes sobre como
configurar parmetros avanados para o Studio ADO Gateway.
Disable Primary Key: Para alguns mdulos, o IWS tentar definir uma chave primria para
a tabela de modo a aumentar a velocidade de suas tarefas. Caso voc esteja utilizando um
IWS 20/06/2007

InduSoft Web Studio

Pgina 463
banco de dados que no suporte chaves primrias (e.x. Microsoft Excel), voc dever
habilitar esse campo.
painel Table: Essa rea permite a configurao de parmetros da Tabela onde os dados sero
salvos. Todas as terefas podem compartilhar de um mesmo banco de dados. Porm, cada tarefa
(planilhas Alarm, Events, Trend) devem estabelecer um link para a sua prpria Tabela. O
InduSoft No habilita configuraes invlidas nesse campo, portanto, voc dever certificar-se
de que a configurao adequada para o banco de dados que est sendo utilizado.
check-box Use default name: Quando essa opo est habilitada (padro), o IWS salva e/ou
entrega os dados em uma Tabela com o nome padro escrito no campo Name.
check-box Automatically create: Quando essa opo est habilitada (padro), o IWS cria uma
tabela com o nome escrito no campo Name automaticamente. Caso essa opo no esteja
habilitada, o IWS no criar a tabela automaticamente. Portanto, o programa no ser capaz de
salvar dados no banco de dados, a menos que voc tenha configurado uma tabela com o nome
configurado manualmente no campo Name do banco de dados.
Name: Especifica o nome da Tabela do banco de dados onde os dados histricos sero salvos.
boto Refresh: Caso o banco de dados configurado esteja atualmente disponvel, pode-se
apertar o boto Refresh para preencher o combo-box Name com o nome das tabelas atualmente
diposnveis no banco de dados. Desse modo, pode-se selecionar a tabela onde os dados
histricos sero salvos, ao invs 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 esto
disponveis:
check-box Status (output): O tag nesse campo receber um dos seguintes valores:
Valor Descrio
0 Desconectado do banco de dados. O banco de
dados no est disponvel ou sua configurao
est incorreta.
1 O banco de dados foi desconectado com sucesso.

Reload (output): Caso voc esteja utilizando colchetes em quaisquer campos de
configurao, voc dever especificar o tag de reload. Quando desejar reconectar-se ao
banco de dados utilizando os valores atualizados de seus tags, configure o tag nesse campo
como 1. O IWS atualizar a configurao ao tentar executar uma ao no banco de dados,
assim como configurar o tag de volta para zero quando tiver terminado.
Studio Database Gateway
O Studio Database Gateway um server TCP/IP que interage com banco de dados utilizando-se do
Microsoft .NET Framework 1.1 e pode rodar no mesmo computador em que est rodando a aplicao do IWS
ou em um computador distinto. O Database Gateway Host de Advanced Settings (veja Dilogo Dilogo
Database Configuration) especifica se o gateway rodar no computador local ou no. Caso voc esteja
utilizando o computador local, deve-se inserir localhost ou 127.0.0.1 no nome Host. No se preocupe com a
inicializao ou paradas no funcionamento do gateway, pois ambas sero executadas automaticamente
pelas tarefas do IWS. Por outro lado, ao rodar o gateway remotamente, voc precisar iniciar o gateway de
forma manual. Para isso, copie os arquivos StADOSvr.exe e StudioADO.ini da pasta BIN do IWS para o
computador remoto, e depois execute StADOSvr.exe.
O gateway pode ser inicializado mltiplas vezes para diferentes nmeros de Portas TCP/IP. O nmero de
porta padro 3997, e esse modificado especificando-se o nmero da porta desejado no prompt de
comando (e.x. StADOSvr 1111). Rodar StADOSvr, adicionar o seguinte cone barra de ferramentas:
IWS 20/06/2007

InduSoft Web Studio

Pgina 464

Clicando-se com o boto direito no cone da barra far com que apaream as seguintes opes:

A opo hide define se a janela de correo ser exibida ou no. Caso voc retire a seleo dessa opo, a
seguinte janela aparecer:

Qualquer falha que ocorra durante operaes com bancos de dados sero exibidas nessa janela e na janela
IWS LogWin. As mensagens so reportadas por excees geradas pelo Provedor ADO.NET. (Leia Resolvendo
Problemas do Banco de Dados para maiores informaes sobre mensagens de erros no mdulo Gateway.)
O Studio Database Gateway possui Advanced Settings que so configuradas no arquivo StADOSvr.ini. Caso
voc tenha problemas para estabelecer interfaces com um banco de dados especfico, provavelmente voc
necessitar de algumas dessas configuraes ou adicionar novos provedores para o arquivo. Esto
disponveis os seguintes parmetros:

IWS 20/06/2007

InduSoft Web Studio

Pgina 465
Parmetro Escala de Valores Descrio
SaveMSec
1 - Deasabilitar
2 - Habilitar
3 - Separar Coluna
Essa configurao especifica o
comportamento padro para o provedor ao
salvar milissegundos. O padro pode ser
alterado em Advanced Settings nos dilogos
Database Configuration Dialogs.
Assembly
Qualquer string que
contenha assembly .Net
Framework
Opo Assembly para todos os provedores,
a qual possui todas as classes requisitadas
para estabelecer interface com o banco de
dados. A maioria dos provedores esto
dentro da assembly System.Data.
ConnectionClass
Qualquer classe de
conexo dentro de
assembly
Connection Class um dos implementos
para a interface
System.Data.IDbConnection.
DataAdapterClass
Qualquer adaptador de
dados dentro de assembly
Data Adapter class utilizaa em operaes
onde so necessrios atualizaes para o
banco de dados. Deve ser compatvel com a
classe de conexo especificada, e deve
implementar o IDbDataAdapter.
CommandBuilderClass
Qualquer classe de
constructor de command
dentreo de assembly
Command Builder class responsvel por
atualizaes em bancos de dados. Deve ser
compatvel com a classe de conexo.
Provider Nome do provedor
Um dos parmetros na string de conexo
"Provider". O Studio ADO Gateway compara
o valor do string de conexo com o valor
para esse parmetro em cada provedor, e
define o masi apropriado para ser utilizado.
ColumnDelimiterPrefix
Qualquer caracterer ou
grupo de caracteres
Especifica um caractere que ser
substitudo antes de nomes de colunas em
demonstraes SQL
ColumnDelimiterSuffix
grupo de caracteres
substitudo aps nomes de colunas em
demonstraes SQL
TableDelimiterPrefix
grupo de caracteres
substitudo antes de nomes detabelas em
demonstraes SQL
TableDelimiterSuffix
grupo de caracteres
substitudo aps nomes detabelas em
demonstraes SQL
ValueString Qualquer String
Esse valor indica quais valores constants
so identificados em demonstraes SQL.
Para Microsoft SQL databases por exemplo,
o valor deve ser @Value, para marca da
pergunta ODBC (?)
IWS 20/06/2007

InduSoft Web Studio

Pgina 466
ValueStringPrefix Qualquer String
Esse valor indica um prefixo para ser
utilizado antes de valores. Valores Oracle
por exemplo requisitam um prefixo. As
demonstraes SQL utilizam identificadores
de valores utilizando-se de seus prefixos,
embora esses parmetros em Connection
class no utilizem o prefixo.
ValueAddNumber 0 ou 1
Indica se um nmero sequencial deve ser
adicionado ao ValueString para identificar o
parmetro ou no. Para Microsoft SQL
database, esse parmetro deve ter o valor 1,
pois os parmetros so identificados
utilizando-se @Value1, @Value2 ,
@ValueN. Para ODBC, esse parmetro deve
ser 0.
BoolType
Qualquer string
representando um tipo de
dados vlidos para o banco
de dados
Ao tentar criar colunas para armazenar
valores boolean, o tipo de dados
especificados nesse parmetro ser
utilizado. Deve-se certificar-se de que o tipo
de dados especificado capaz de salvar
valores Boolean.
IntegerType
Qualquer string
de dados
integer values, o tipo de valores especificado
nesse parmetro dever ser utilizado. Deve-
se certificar-se deque o tipo de valor
especificado capaz de armazenar valores
de 32 bit.
RealType
Qualquer string
de dados
Ao tentar criar colunas para armazenar real
values, o tipo de valores especificado nesse
parmetro dever ser utilizado. Deve-se
certificar-se deque o tipo de valor
especificado capaz de armazenar 64
valores reais.
StringType
Qualquer string
valor vlido para o banco
de dados
valors de string, o tipo de valores
especificados nesse parmetro ser
utilizado. Deve-se certificar-se de que o tipo
de dados especificado capaz de salvar o
nmero de caracteres que voc deseja
salvar em sua aplicao.
TimeStampType
Qualquer string
valor vlido para o banco
de dados
valores TimeStamp, o datatype especificado
nesse parmetro ser utilizado.
EnableTop 0 ou 1
Quando esse campo est configurado como
1, ADO substituir TOP na demonstrao
SQL para limitar a quantidade de registros
requisitados.
SingleConnection 0 ou 1
Quando esse campo est configurado como
1, ADO tarefasou computadores que
IWS 20/06/2007

InduSoft Web Studio

Pgina 467
estejam requisitando-o. A sincronizao
entre tarefas que sero executadas pelo
gateway no sero efetuadas se essa opo
estiver habiliutada, e no sero capazes de
serem executadas simultaneamente.
Uma chamada nica de seo [Providers] possui todos os parmetros. Os valores padres esto
especificados no incio do arquivo, com a utilizao do prefixo Default em cada parmetro como
mostrado a seguir:
[Providers]
DefaultSaveMSec=3
DefaultAssembly=System.Data
DefaultConnectionClass=System.Data.OleDb.OleDbConnection
DefaultDataAdapterClass=System.Data.OleDb.OleDbDataAdapter
DefaultCommandBuilderClass=System.Data.OleDb.OleDbCommandBuilder
DefaultValueString=@Value
DefaultValueAddNumber=1
DefaultBoolType=INTEGER
DefaultIntegerType=INTEGER
DefaultRealType=REAL
DefaultStringType=VARCHAR(255)
DefaultTimeStampType=DATETIME
DefaultSingleConnection=0
O item a seguir nesse arquivo lista a quantidade de provedores:
Count=5
Os provedores so identificados pelo parmetro Provider seguido pelo nmero. Ao conectar-se a
um banco de dados, o parmetro Provider no string de conexo comparado identificao do
provedor, de modo a determinar qual provedor ser utilizado. Caso no haja provedor com o valor
no string de conexo, todos os valores padro sero assumidos. Alm de sua identificao, cada
provedor pode possuir seu prprio valor para cada parmetro. Outra vez, caso nenhum valor esteja
especificado, o valor padro ser utilizado. Segue abaixo um exemplo com sete provedores:
Count=7
Provider1=MICROSOFT.JET.OLEDB
SaveMSec1=3
ColumnDelimiterPrefix1=[
ColumnDelimiterSuffix1=]
SingleConnection1=1

Provider2=SQLOLEDB
ConnectionClass2=System.Data.SqlClient.SqlConnection
DataAdapterClass2=System.Data.SqlClient.SqlDataAdapter
CommandBuilderClass2=System.Data.SqlClient.SqlCommandBuilder
TableDelimiterPrefix2=[
TableDelimiterSuffix2=]
RealType2=FLOAT
IWS 20/06/2007

InduSoft Web Studio

Pgina 468

Provider3=MSDASQL
ConnectionClass3=System.Data.Odbc.OdbcConnection
DataAdapterClass3=System.Data.Odbc.OdbcDataAdapter
CommandBuilderClass3=System.Data.Odbc.OdbcCommandBuilder
ValueString3=?
ValueAddNumber3=0
StringType3=VARCHAR(128)
EnableTop3=0

Provider4=ORAOLEDB
Assembly4=System.Data.OracleClient
ConnectionClass4=System.Data.OracleClient.OracleConnection
DataAdapterClass4=System.Data.OracleClient.OracleDataAdapter
CommandBuilderClass4=System.Data.OracleClient.OracleCommandBuilder
ValueString4=Value
ValueAddNumber4=1
ValueStringPrefix4=:
BoolType4=Number(1)
IntegerType4=Number(10)
RealType4=Number
TimeStampType4=TIMESTAMP(0)
EnableTop4=0

Provider5=ASAPROV
Assembly5=iAnywhere.Data.AsaClient
ConnectionClass5=iAnywhere.Data.AsaClient.AsaConnection
DataAdapterClass5=iAnywhere.Data.AsaClient.AsaDataAdapter
CommandBuilderClass5=iAnywhere.Data.AsaClient.AsaCommandBuilder
ValueString5=?
ValueAddNumber5=0
TableDelimiterPrefix5=[
TableDelimiterSuffix5=]

Provider6=MYSQLPROV
Assembly6=ByteFX.MySqlClient
ConnectionClass6=ByteFX.Data.MySqlClient.MySqlConnection
DataAdapterClass6=ByteFX.Data.MySqlClient.MySqlDataAdapter
CommandBuilderClass6=ByteFX.Data.MySqlClient.MySqlCommandBuilder
IWS 20/06/2007

InduSoft Web Studio

Pgina 469
ValueString6=@Value
ValueAddNumber6=1
EnableTop6=0

Provider7=MSDAORA
Assembly7=System.Data.OracleClient
ConnectionClass7=System.Data.OracleClient.OracleConnection
DataAdapterClass7=System.Data.OracleClient.OracleDataAdapter
CommandBuilderClass7=System.Data.OracleClient.OracleCommandBuilder
ValueString7=Value
ValueAddNumber7=1
ValueStringPrefix7=:
BoolType7=Number(1)
IntegerType7=Number(10)
RealType7=Number
TimeStampType7=TIMESTAMP(0)
EnableTop7=0

IWS Development Environment The Workspace Tasks Tab Alarms Folder

Alarm summary: Ao habilitar um arquivo histrico de alarme para um grupo, o IWS salva os
eventos de alarme ao banco de dados de histricos, de acordo com o Formato do Arquivo
configurado em Alarm History e Events. As informaes salvas no arquivo histrico esto descritas
na tabela a seguir.

Nome do Campo Tipo de
Dados
Marcaes
Version Integer
Esse campo criado somente quando o Formato de
Arquivo Proprietary. Verso atual: 003
Al_Start_Time TimeStamp
Timestamp indicando quando o alarme foi iniciado.
Quando o Formato de Arquivo Proprietary, o IWS
salva a data (MM/DD/YYYY) em um campo e a
Hora (HH:MM:SS.MSS) no prximo campo.
Al_Tag String Nome do Tag
Al_Message String Mensagem de alarme
Al_Ack Boolean
0: Indica que o alarme foi reconhecido ou no
requer reconhecimento
1: Indica que o alarme no foi reconhecido
Al_Active Boolean
0: Indica que o alarme no est ativo
1: Indica que o alarme est ativo
Al_Value Real Valor do Tag quando o evento de alarme ocorreu
Al_Group Integer Nmero do Grupo de Alarme
IWS 20/06/2007

InduSoft Web Studio

Pgina 470
Al_Priority Integer Nmero de Prioridade do alarme
Al_Selection String Valor de Saleo do Alarme
Al_Type Integer
1: HiHi
2: Hi(On)
4: Lo(Off)
8: LoLo
16: Rate(Change)
32: Deviation+
64: Deviation-
Al_Ack_Req Boolean
0: Requisita reconhecimento (Ack)
1: No requisita reconhecimento
Al_Norm_Time TimeStamp
Timestamp indicano quando o alarme foi
normalizado.
Quando o Formato de Arquivo Propriedade, o IWS
salva a Data (MM/DD/YYYY) em um campo e a
Al_Ack_Time TimeStamp
Timestamp indicando quando o alarme foi
reconhecido.
Quando o Formato de Arquivo Propriedade, o IWS
salva a Data (MM/DD/YYYY) em um campo e a
Al_User String
Usuio logado quando o evento de alarme ocorreu.
Esse campo existe somente para Verso >=1
Al_Comment String
Comentrio (opcional) digitado pelo operador
quando o alarme foi reconhecido. Esse campo
existe somente para Verso >=1
Al_User_Full String
Nome complete do usurio logado quando o evento
de alarme ocorreu. Esse campo existe somente para
Verso >=2
Al_Station String
Nome da estao (computador) onde o evento de
alarme ocorreu. Esse campo existe somente para
Verso >=2
Al_Previous_Tag_Value Real
Valor do Tag ocorrido antes do evento de alarme.
Esse campo existe somente para Verso >=3
Al_Deleted Boolean
0: Mensagem de alarme no foi deletada
1: Mensagem de alarme foi deletada
Esse campo criado somente quando o Formato de
Arquivo Database.
Al_Bias Integer
Diferena (em minutos) das colunas Time Stamp e
tempo GMT. Esse campo existe somente para
Verso >=3
IWS 20/06/2007

InduSoft Web Studio

Pgina 471
Al_Last_Update TimeStamp
Time Stamp quando o registro foi
criado/modificado. Esse campo utilizado para
sincronizar os bancos de dados ao utilizar o Banco
de Dados Secundrio alm do Banco de Dados
Primrio. Esse campo criado somente quando File
Format Database.

= Dica:
Ao salvar Alarmes Histricos (History Alarms) em um Banco de Dados SQL Relacional
(File Format = Database), pode-se costumizar o nome das colunas criadas em um
banco de dados, editando o arquivo <AplicaoName>.APP como se segue:
[Alarm]
Por exemplo:
[Alarm]
Message=Alarm_Message
Ack=Acknowledgment

IWS Development Environment The Workspace Database Tab Event Settings

Arquivos de log de Evento so salvos ao banco de dados histrico, de acordo com o File Format
configurado para Alarm History e Events. As informaes salvas no arquivo histrico esto
descritas na tabela a seguir.

Nome do
Campo
Tipo de
Dados
Marcas
Version Integer
criado somente quando o File Format Proprietary.
Verso atual: 002
Event_Type Integer
1: SECURITY SYSTEM
2: DISPLAY
3: RECIPE
4: REPORT
5: CUSTOM MESSAGES
6: SYSTEM WARNING
7: LOG TAGS
Event_Time TimeStamp
Timestamp indicando que o evento ocorreu.
Quando File Format Proprietary, o IWS salva Event Time
no seguinte formato: MM/DD/YYYY HH:MM:SS.MSS.
Event_Info String Nome do Tag
Value Real Valor do Tag quando o evento ocorreu
Source String Nome da tarefa que gerou o evento
User String Usurio logado quando o evento ocorreu.
IWS 20/06/2007

InduSoft Web Studio

Pgina 472
User_Full String Nome complete do usurio logado quando o evento ocorreu.
Message String Mensagem do evento
Station String Nome da estao (computador) onde o evento ocorreu.
Comment String
Comentrio (opcional) digitado pelo operador quando
ocorreu o evento. Esse campo existe somente para Verso
>=2
Previous_Value Real
Valor do Tag que ocorreu antes do evento. Esse campo
existe somente para Verso >=2
Deleted Boolean
0: Mensagem de evento no foi deletada
1: Mensagem de evento foi deletada
Esse campo criado somente quando File Format
Database.
Bias Integer
Diferena (em minutos) das colunas Time Stamp e hora
GMT. Esse campo existe somente para Verso >=2
campo utilizado para sincronizar os bancos de dados ao
utilizar oe Banco de Dados Secundrio alm do Banco de
Dados Primrio. Esse campo criado somente quando File
Format Database.

= Dica:
Ao salvar Events em um Banco de Dados SQL Relacional (File Format =
Database) pode-se costumizar o nome das colunas criadas no banco de dados,
editando o arquivo <AplicaoName>.APP como se segue:
[EventLogger]
Por exemplo:
[EventLogger]
Event_Info=Information
Message=Event_Message

IWS 20/06/2007

InduSoft Web Studio

Pgina 473

IWS Development Environment The Workspace Tasks Tab Trend Folder
painel Name of history files: Especifica os seguintes parmetros para definir o nome do arquivo
histrico . Pode-se gerar arquivos histricos de trend de duas formas: Por data ou batch (por
eventos).
check box Date (default): Clique (habilite) para gerar arquivos histricos baseados em data.
Utilize essa opo caso voc tenha um processo contnuo. Dependendo das opes
selecionadas no combo-box History Format, o IWS salva os dados histricos Trend em
arquivos binrios de propriedade ou em um Banco de Dados SQL Relacional. Os campos
salvos no Histrico Trend so descritos na tebela a seguir:

Field Name Data Type Remarks
Time_Stamp TimeStamp
TimeStamp (Data e Hora) quando os
dados foram salvos.
<Tag Name>
Integer ou Real
(dependendo do
tipo de tag)
O IWS will criar um campo (coluna) no
banco de dados para cada tag
configurado na planilha Trend.

IWS 20/06/2007

InduSoft Web Studio

Pgina 474
Resolvendo Problemas do Banco de Dados
A interface Database do IWS fornece ferramentas ponderosa que auxiliar na identificao dos problemas
de configurao com bancos de dados. Casso voc esteja tendo problemas na interface com um banco de
dados, deve-se primeiro habilitar as Mensagens do Banco de Dados na janela Log. Voc tambm 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 boto direito na janela (localizada geralmente no canto direito do ambiente de
desenvolvimento), e selecione Settings;

3. Na janela Settings Log Settings habilite a opo Database Messages;

Aps habilitar Database Messages, aparecer a janela Output relacionada a mensagens de erro do banco de
dados. A seo Database FAQ que se segue lista alguns dos erros comuns que voc ver na janela Output.
Database FAQ
questes gerais
Q: Eu configurei meu banco de dados, mas os mdulos Run-Time (Alarm, Trend e Events) no
Esto 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 sero seguidos por iformaes
adicionais, como o comando SQL sendo executado, a Connection String e o Nome da Tabela.
Mensagens de erro como as descritas acima, geralmente acontecero aps uma mensagem mais
detalhada. Por exemplo, caso sua tarefa Trend falhe para adicionar um registro no banco de
IWS 20/06/2007

InduSoft Web Studio

Pgina 475
dados, por um cabo est desconectado, deve-se primeiramente esperar o recebimento de um
erro na rede de trabalho; caso a tarefa tente adicionar mais registros antes do perodo
especificado no campo Retry (veja Dilogo Janela do Dilogo Database Configuration), ser
exibido somente Database: Error: Error to add new register[CMD_ADD]. Caso voc ache que
sua configurao est correta e queira corrigir o problema, reduza Retry. Aps ter efetuado tal
tarefa, voc poder ver informaes mais detalhadas.
Q: Eu configurei minha Connection String utilizando o browser e a janela Data Link Properties. Ao
clicar no boto Test, aparecer Test succeeded. Porm, ao rodar minha aplicao, a Database
Interface exibe mensagens de erro, e eu no consigo salvar dados.
A: A janela Data Link Properties utiliza OLE DB para fazer interface com o Banco de Dados. O
Banco de Dados do IWS utiliza ADO.NET; portanto, pode-se ter o provedor OLE DB em sua
mquina e perder o provedor ADO.NET. Isso tambm possvel quando um provedor ADO.NET
sendo utilizado e que no esteja listado no arquivo StADOSvr.ini. Leia Studio Database
Gateway para maiores informaes sobre como adicionar os provedores ADO.NET para o
arquivo StADOSvr.ini.
Q: Por que, ao atualizar informaes em uma linha no objeto Grid, mais de uma linha estaro
sendo atualizadas em meu banco de dados?
A: O objeto grid promove um comando de atualizao no banco de dados utilizando os valores de
todas as colunas para a linha especfica a qual voc est tentando atualizar. Caso voc tenha
linhas com valores duplicados, voc dever checar esse problema. Caso sua tabela tenha uma
chave primria ou qualquer outro campo nico que voc no queira exibir no objeto Grid, pode-
se adicion-lo a Columns, mas com Width especificado para 0. Tal procedimento corrigir o
problema.
Q: Por que eu preciso utilizar uma Column separada para armazenar os milissegundos em meu
banco de dados?
A: Alguns bancos de dados no suportam milissegundos no campo Time Stamp. A interface
Database do IWS, por padro, requisite outra coluna para o smilissegundos. Caso seu banco de
dados possa manusear milissegundos, ou caso voc no deseje gravar os milissegundos,
possvel alterar o comportamento padro em Advanced settings. Note que alguns bancos de
dados so capazes de armazenar milissegundos, embora possuam baixa preciso. Caso voc
misture bancos de dados diferentes, com diferentes precises em um modo redundante, voc
poder ter problemas de sincronizao.
Q: Minha aplicao funciona bem quando eu rodo em um mdulo emulation. Mas ao enviar para o
equipamento Windows CE, no possvel estabelecer comunicao com meu banco de dados.
A: Pode ser o caso em que seu equipamento Windows CE no tenha o .Net Framework ou no
tenha o provedor que voc esteja utilizando. Tente utilizar o gateway remotamente seguindo as
instrues de Estabelecendo Link do Banco de Dados atravs de um Provedor Estabelecendo
Link do Banco de Dados atravs de um DB ProviderRemoto.
Q: Por que eu estou recebendo a mensagem Error para criar uma classe de conexo ao tentar
criar classe de conexo quando tento conectar ao banco de dados?
A: O .Net Provider que voc est tentando utilizar no est instalado em sua mquina. Essa
mensagem de erro geralmente seguida pelo nome do provedor; Caso voc esteja utilizando o
banco de dados Sybase, por exemplo, a mensagem seguida por
[iAnywhere.Data.AsaClient.AsaConnection]. O Provedor iAnywhere.Data.AsaClient. Voc pode
verificar se o provedor est instalado em sua mquina. V para Control Panel->Administrative
Tools->Microsoft .Net Framework x.x Configuration. O provedor dever ser listado em Assembly
Cache.
IWS 20/06/2007

InduSoft Web Studio

Pgina 476
Q: E se eu tiver assembly do provedor (geralmente um arquivo .dll), mas no esteja listado no
Assembly Cache?
A: Caso seu assembly tenha um nome satisfatrio, 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 conexo com um banco de dados ORACLE, esse no se recupera. Eu recebo
a seguinte mensagem no logwin: Database: Error: ORA-03114: not connected to ORACLE.
Existe algum problema com a Interface do Banco de Dados do IWS?
A: O Provedor Oracle .Net possui um problema no gerenciamento no pool de conexo. Voc
necessitar da instalao de um QFE 830173. Mais informaes sobre esse problema podem
ser encontradas em http://support.microsoft.com/default.aspx?scid=kb;en-us;830173.
Q: Ao tentar acessar o banco de dados, eu recebo a seguinte mensagem de erro: ORA-00162:
external dbid length 19 is greater than maximum (16). O que eu devo fazer?
A: Na poca em que essa documentao foi escrita, houve um problema em um Provedor Oracle
.NET; o Server Name (SERVER/TNS) no deveria ultrapassar 16 caracteres. De modo a reparar
esse problema, deve-se tentar reduzir seu campo Server Name. Uma maneira de faze-lo
editando o arquivo \WINDOWS\system32\drivers\etc\hosts para adicionar uma entrada com
um server name menor. Por exemplo, o server name especificado por 192.168.89.98, possui 13
caracteres e deve ser reduzido para 3 adicionando-se a seguinte linha no arquivo:
192.168.89.98
Agora voc poder configurar os parmetros do Server Name utilizando ORA/TNS ao invs de
192.168.89.98/TNS.
MySQL
Q: Tentar acessar o banco de dados a partir de minha mquina local funciona de forma correta.
Mas quando eu movo minha aplicao para uma mquina remota, aparece: Access Denied.
A: Cada usurio 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 padro,
essa propriedade configurada para localhost. Assim, voc ser capaz de acessar somente o
banco de dados a partir de um computador local. Voc dever ler o manual MySQL para
maiores informaes sobre alteraes dessas configuraes.
Sybase
Q: Eu configurei meu banco de dados Sybase utilizando o boto do Browse. Ao clicar no boto de
teste, o teste efetuado, mas quando eu tento rodar minha aplicao, eu recebo o seguinte
erro: Database: Error: Parse error: DSN 'MyDatabase' does not exist. O que estou fazendo de
errado?
A: Leia o Apndice F Utilizando Sybase para maiores informaes sobre esse problema.
Q: Por que, ao tentar conectar-se ao banco de dados Sybase, eu recebo o erro Error to create
connection class [iAnywhere.Data.AsaClient.AsaConnection]?
A: Voc no possui o Provedor ADO.NET instalado em seu computador. O programa de
configurao do banco de dados tem uma opo para instalao do Provedor. Rode novamente
o programa de configurao e certifique-se de que voc verificou que aquela opo esteja
habilitada.
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 no 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 configurao SQL Server CE.
IWS 20/06/2007

InduSoft Web Studio

Pgina 478
Apndice do Banco de Dados A: Utilizando Banco de Dados ODBC
Quase todos os fornecedores de banco de dados fornecem uma interface ODBC que pode ser utilizada para
fazer interfaces. Os recursos do banco de dados fornecidos pelo IWS podem ser utilizados com drivers
ODBC atravs da interface ADO.NET para ODBC. De modo a utilizar essa capacidade, deve-se utilizar
Microsoft .NET Framework 1.1 ou verses mais recentes.

Nota:
Microsoft .NET Framework 1.1 est instalado automaticamente, iniciando com o IWS
v.6 Service Pack 3.

O Dilogo Database Configuration permite o fornecimento de strings de conexo que estabelecero conexo
com um ODBC DSN. O string de conexo pode ser construdo automaticamente clicando-se no boto do
Browse (). Quando aparecer a janela Data Link, voc dever selecionar a opo Microsoft OLE DB Provider
for ODBC Drivers como mostrado abaixo:

Clicar no boto Next far aparecer a seguinte janela:

IWS 20/06/2007

InduSoft Web Studio

Pgina 479

Selecione o DSN ao qual voc deseja conectar-se e clique em OK. Caso voc deseje especificar o nome do
usurio e a senha nessa janela, ao invs de espcificar no dilogo Database Configuration, lembre-se de
habilitar o checkbox Allow saving password.
Apndice do Banco de Dados B: Utilizando Microsoft SQL Server
A interface do Banco de Dados do IWS permite a entrega e armazenamento de informaes em banco de
dados Microsoft SQL Server relacionais. Voc dever seguir os passos abaixo para configurar o banco de
dados SQL Server:
1. Clique no boto Browse na janela Database Configuration Dialog. A janela a seguir ser
exibida:
IWS 20/06/2007

InduSoft Web Studio

Pgina 480

2. Selecione o Provedor Microsoft OLE para SQL Server, e clique em Next. A seguinte janela
ser exibida:

IWS 20/06/2007

InduSoft Web Studio

Pgina 481
3. Preencha os campos nessa janela com as informaes de seu banco de dados. Caso voc
no 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 configurao Connection String.
Seu string de conexo 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.

Apndice do Banco de Dados C: Utilizando Banco de Dados ORACLE
A Interface do Banco de Dados do IWS permite a entrega e armazenamento de informaes em banco de
dados relacionais ORACLE. Voc dever seguir os passos abaixo para configurar o banco de dados
ORACLE:
1. Clique no boto 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:
IWS 20/06/2007

InduSoft Web Studio

Pgina 482

3. Preencha os campos nessa janela com as informaes de seu banco de dados. Lembre-se de
habilitar o checkbox Allow saving password para que a senha seja salva quando a janela
Data Link Properties for fechada. As informaes 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

C Ateno:
Na poca em que essa documentao foi redigida, o campo Server Name no podia
ser configurado com mais de 16 letras. Caso mais de 16 fossem especificadas, voc
receberia o seguinte erro: ORA-00162: external dbid length 19 is greater than
maximum (16), onde 19 o nmero de letras em Server Name. Leia Resolvendo
Problemas do Banco de Dados para maiores solues para contornar esse
problema.

4. Clique em OK para finalizar a configurao Connection String.

Nota:
Tais procedimentos foram testados utilizando-se ORACLE 10g Release 1.

IWS 20/06/2007

InduSoft Web Studio

Pgina 483
Apndice do Banco de Dados D: Utilizando Banco de Dados de Acesso da
Microsoft
A interface do Banco de Dados do IWS permite a entrega e armazenamento de informaes em arquivos
Microsoft Access Database. Voc dever seguir os passos abaixo de modo a configurar um banco de dados
de acesso:
1. Clique no boto 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:
IWS 20/06/2007

InduSoft Web Studio

Pgina 484

3. Digite o nome ou selecione o banco de dados que voc deseja acessar.

C Ateno:
Bancos de dados como Microsoft Access no so capazes de manusear grandes
quantidades de dados de forma eficiente. Portanto, caso voc tente armazenar todos
seus dados histricos nesse tipo de banco de dados, a tarefa poder funcionar de
forma muito lenta, e voc poder no obter os resultados esperados. Caso voc
necessite armazenar uma grande quantidade de dados, recomendamos a utilizao
de formato de prioridade ou um banco de dados relacional potente, como Microsoft
SQL Server ou ORACLE. Microsoft Access recomendado como sendo um Banco de
Dados Secundrio, utilizando-se da opo Store and Forward, ou para trocar
informaes com software de terceiros.

Nota:
Tais procedimentos foram testados utilizando-se do Microsoft Access 2000
(9.0.3821).

Apndice 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 disponvel somente para Windows CE, e dever ser instalado em seu equipamento Windows
CE. Por esse provedor estar disponvel somente para Windows CE, voc dever inserir o Connection String
manualmente. Connection String dever possuir o seguinte formato:
Provider=SQLCE; Data Source = <Database Path>
IWS 20/06/2007

InduSoft Web Studio

Pgina 485
Exemplos:
1. Acessar um arquivo de banco de dados estvel 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}

C Ateno:
Bancos de Dados como SQL Server CE no so capazes de manusear grandes
quantidades de dados de forma eficiente. Portanto, caso voc tente armazenar todos
seus dados histricos nesse tipo de banco de dados, a tarefa poder funcionar de
forma muito lenta, e voc poder no obter os resultados esperados. Caso voc
necessite armazenar grandes quantidades de dados, recomendamos a utilizao de
formato de propriedade ou um banco de dados relacional potente, como Microsoft
SQL Server ou ORACLE. SQL Server CE recomendado como um Banco de Dados
Secundrio e a utilizao da opo Store and Forward recomendada para trocar
informaes com softwares de terceiros.

Apndice do Banco de Dados F: Utilizando Sybase
Ser necessrio instalar o provedor AsaClient em seu computador; os testes com o IWS foram executados
com a utilizao da Arquitetura explicada no tpico Estabelecendo Link de Banco de Dados atravs de um
Remote DB Provider.
Caso voc esteja utilizando o boto 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 criao de um ODBC DSN com o mesmo nome de Data Source (Test, nesse caso) de
modo a comunicar-se com o banco de dados. Caso DSN no seja criado, o seguinte erro ser exibido em
LogWin ao conectar-se ao banco de dados:
Database: Error: Parse error: DSN 'Test' does not exist
Para evitar ODBC DSN, pode-se inserir o string Connection manualmente, como mostrado no exemplo que
se segue:
Provider=ASAProv.90; DBF=C:\ Test.db

Note:
Tais procedimentos foram testados com a utilizao de Sybase Server Anywhere
9.0.1.1751.

Apndice do Banco de Dados G: Utilizando Microsoft Excel
A interface Database do IWS permite a entrega e armazenamento de informaes em arquivos Excel. O
principal objetivo do uso de banco de dados em Excel em virtude do objeto Grid. Os passos abaixo
mostram como configurar o objeto Grid para a entrega de dados a partir de um arquivo em Excel:
1. Insira um objeto Grid na tela;
2. Selecione Database no campo Data Source.
IWS 20/06/2007

InduSoft Web Studio

Pgina 486
3. Clique no boto Data. A seguinte janela aparecer:

4. Desabilite o check box Use Aplication default.
5. Clique o boto 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:
IWS 20/06/2007

InduSoft Web Studio

Pgina 487

7. Clique no boto 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.
IWS 20/06/2007

InduSoft Web Studio

Pgina 488

Nota:
O valor nesse campo dever ser alterado caso seja utilizada uma verso distinta do
Excel.

11. Clique em OK, e voc ter um string connection muito similar ao que se segue:
Provider=Microsoft.Jet.OLEDB.4.0; Data Source=C:\Book1.xls; Extended Properties="Excel
8.0"

D Dica:
Pode-se inserir um tag entre colchetes para especificar o arquivo em Excel que voc
deseja acessar. No exemplo abaixo, o tag TagExcelFile utilizado para indicar o arquivo
em Excel:
Provider=Microsoft.Jet.OLEDB.4.0; Data Source=C:\{TagExcelFile}.xls; Extended
Properties="Excel 8.0"

12. Especifque a planilha que voc deseja acessar no campo Table. O nome da planilha dever
possuir o sinal ($) em seu final, e dever estar entre ([]). A figura abaixo mostra a
configurao para acesso a planilhas chamadas Sheet1:
IWS 20/06/2007

InduSoft Web Studio

Pgina 489

D 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 informaes fornecidas por
Microsoft Knowledge Base Article 278973, e foram testados com a utilizao do
Microsoft Excel 2000 (9.0.3821).

Apndice do Banco de Dados H: Utilizando MySQL
A interface Database do IWS pode ser utilizada com banco de dados MySQL; porm, voc dever instalar o
.Net provider para obter seu acesso. O provedor requisitado pelo IWS ByteFX.MySqlClient. Na poca em
que esse documento foi redigido, este poderia ser adquirido a partir do site www.sourceforge.net.
O string connection dever possuir o seguinte formato:
Provider=MySqlProv; Data Source=MyDatabaseName; Location=192.168.23.200

Nota:
Caso voc tenha o OLE DB Provider para MySQL instalado em seu computador, pode-
se utilizar o boto do browse na janela Database Configuration Dialog para
construo do string connection.

IWS 20/06/2007

InduSoft Web Studio

Pgina 490
A conexo ByteFX.MySqlClient utiliza diferentes palavras-chave para Data Source e para os
parmetros Location no string de conexo. O exemplo acima passado para a classe de conexo no
seguinte formato:
Database=MyDatabaseName; Data Source=192.168.23.200

Nota:
Tais procedimentos foram testados com a utilizao de MySQL v4.0.20a e
ByteFX.MySqlClient v0.76.

IWS 20/06/2007

InduSoft Web Studio

Pgina 491
Captulo 18: Web Solution

O IWS permite a criao de telas que podem ser visualizadas em uma estao remota com a utilizao de
um browser regular web (ex. Internet Explorer). A estao onde o usurio poder visualizar a interface
grfica (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 estao servidor. Tambm, a aplicao (arquivos de telas, banco de dados
de tags, planilhas de configurao, etc) armazenada somente no servidor, ou seja, voc no precisar
instalar o IWS ou a aplicao em Web Thin Client station(s). Essa soluo promove um alto nvel de
flexibilidade, pois quaisquer computadores com um link fisicamente estabecido a server station (link
TCP/IP) pode obter acesso a telas grficas e dados histricos/online a partir do server, sem a necessidade
de instalao do IWS ou da aplicao em Web Thin Client station(s). Qualquer computador ou equipamento
(ex. PDAs potencializados com Windows CE) rodando Internet Explorer web browser v6.0 (ou verses mais
atuais) podem ser um Web Thin Client para uma aplicao do IWS. Alm disso, o IWS fornece um Sistema
de Segurana (Security System) sofisticado para a proibio do acesso de usurios no autorizados
aplicao.

Nota:
O nmero mximo de Web Thin Client stations conectadas simultaneamente ao
servidor depende das configuraes da licena instalada no servidor. O usurio no
precisa instalar qualquer licena em Web Thin Client stations.

A partir da Web Thin Client station, voc poder no somente visualizar dados do servidor como tambm
alterar set points e/ou enviar comandos para o servidor. Ao configurar a aplicao, voc poder desabilitar
(opcional) todos os comandos do Web Thin Client para a estao do servidor. Nesse caso, as Web Thin
Client stations podero ler os dados, mas no podero envi-los para o servidor.
Todas as tarefas de fundo (Math, Scheduler, etc) e tarefas de comunicao (Driver, OPC, DDE,
etc) so executadas somente na server station. O Web Thin Client capaz de carregar interfaces
grficas configuradas no servidor (telas com objetos e dinmicos) e exibir os valores online a
partir dos tags configurados no servidor, assim como os dados histricos (Alarm, Events e
dados histricos Trend).
IWS 20/06/2007

InduSoft Web Studio

Pgina 492
Camada de Controle ISSymbol
ISSymbol um componente projetado pela InduSoft que capacita a exibio de telas criadas com o o IWS no
browser da web, alm de trocar dados (valores de tags e dados histricos) com o mdulo TCP/IP server do
IWS. Na Web Thin Client station, o browser da web (ex. Internet Explorer) o local que acolhe o controle
ISSymbol.
ISSymbol funciona como uma camada de controle entre a aplicao do IWS e o browser da web
equivalente ao Java Virtual Machine para aplicaes baseadas em Java. Essa proximidade fornece um alto
nvel de segurana, pois o ISSymbol no permite a aplicao para acesso direto ao sistema operacional.
Quando o browser da web faz o download da pgina HTML especificada pelo usurio, esse verifica o registro
do controle ISSymbol no computador atualmente utilizado. Caso ele no encontre, o browser tentar efetuar
o download do registro a partir da URL especificada no dilogo Project Settings Web Advanced. O
browser da web no capaz de exibir telas a partir da aplicao do IWS, caso o controle ISSymbol no
esteja registrado de forma apropriada na Web Thin Client station.

C Ateno:
Certifique-se de que seu browser da web esteja habilitado a efetuar download
preenchidos nos controles ActiveX, de modo a efetuar o download do ISSymbol
automaticamente. Caso contrrio, voc precisar registrar o ISSymbol
manualmente na Web Thin Client station. Verifique a documentao de seu
browser da web a respeito de perguntas sobre configuraes de segurana para
estabelecer parmetros dessas configuraes.

Instalando o controle issymbol manualmente
Tambm pode-se instalar o controle ISSymbol manualmente na Web Thin Client station. O para
instalao 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 diretrio da Web Thin Client station. Certifique-se de que ambos os arquivos
estejam armazenados em um mesmo diretrio.
Rode ISSymbolReg.exe para registrar o controle ISSymbol na Web Thin Client station.
Windows 9x/ME:
Copie os arquivos ISSymbolReg.exe e ISSymbolA.cab da subpasta \BIN do Indusoft Web Studio
v6.1 e cole-os em qualquer diretrio da Web Thin Client station. Certifique-se de que ambos os
arquivos estejam armazenados em um mesmo diretrio.
Rode ISSymbolReg.exe para registrar o controle ISSymbol na Web Thin Client station.

C Ateno:
Windows 9x/ME no suporta caracteres UNICODE. Portanto, as fontes UNICODE
no sero exibidas de forma apropriada em Web Thin Clients Rodando sob
Windows 9x/ME.

Windows CE:
Copie os arquivos ISSymbolCE.ocx e IndHTTP.dll da subpasta \Redist\<OS Version>\<Processor
Type>\ do Indusoft Web Studio v6.1, e cole-os em qualquer diretrio 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)
IWS 20/06/2007

InduSoft Web Studio

Pgina 493
Salve as configuraes de registro para manter ISSymbolCE.ocx registrados ao reiniciar o
equipamento Windows CE.
Windows CE PocketPC:
Copie os arquivos RegSvrCE.exe, ISSymbolCE.ocx e ndHTTP.dll da subpasta \Redist\<OS
Version>\<Processor Type>\ do Indusoft Web Studio v6.1 e cole-os em qualquer diretrio da Web
Thin Client station. Certifique-se de que ambos os arquivos estejam armazenados no mesmo
diretrio.
Execute o programa RegSvrCE.exe no equipamento Web Thin Client. Para registrar
ISSymbolCE.ocx, faa o seguinte:
Selecione o arquivo \<ISSymbolPath>\ISSymbolCE.ocx
Selecione a opo Register
Clique no boto OK
Nota:
Internet Explorer no 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
Aps abrir o browser da web, deve-se digitar a URL para uma pgina da web disponvel na Web Server
station (ex. http://127.0.0.1/main.html) no campo Address. Nesse ponto, a Web Thin Client executa o
seguinte processo:
1. O browser da web faz downloads da pgina HTML da tela especificada.
2. O browser da web verifica o registro do controle ISSymbol no computador local. Caso ele no
encontr-lo, o browser tentar fazer o download do componente ISSymbol da URL configurada
na aplicao (configuraes alvas na pgina 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 comunicao com a server station, e o browser da web
ser utilizado somente como um hospedeiro para ISSymbol.
3. ISSymbol conecta-se ao servidor de dados. Configura-se o endereo IP do servidor de dados com
a janela de dilogo Project Settings Web. Essa configurao salva na pgina HTML.
4. ISSymbol induz uma janela na Web Thin Client, pedindo o User Name e Password. Os dados
inseridos esto encriptados e enviados para o servidor. A server station verifica a validade dos
dados e os direitos para abrir a tela de startup. Caso seja possvel, o processo continuar. Caso
contrrio, voc ser questionado com uma mensagem de erro indicando que User Name e/ou
Password so invlidos. Nesse caso, o processo no continuar.

Nota:
Passo 4 poder ser pasado caso o sistema de segurana esteja desabilitado
durante a configurao da aplicao.

5. ISSYmbol faz o download de arquivos necessrios para a exibio de telas especificadas pelo
usurio (arquivos de telas, banco de dados de tags, arquivos de traduo, etc).
6. ISSymbol conecta-se ao banco de dados e l valores dos tags que so exibidos na tela
especificada.
7. ISSymbol exibe a tela no browser da web e mantm a atualizao de objetos de acordo com
valores lidos a partir do servidor. Sempre que o valor de qualquer tag for exibido com alterao
nas telas abertas no servidor, o novo valor enviado para a Web Thin Client (e vice-versa).
IWS 20/06/2007

InduSoft Web Studio

Pgina 494
Portanto, no h pooling entre Web Thin Client e server station. Esse mtodo aumenta a
performance da comunicao e otimiza o trfico de dados na rede de trabalho.
Note que existem dois servidores nesse processo:
Web server (HTTP Server): Fornece os arquivos do server para Web Thin Client via protocolo
HTTP atravs de TCP/IP.
Data server (Mdulo Server TCP/IP do IWS): Fornece valores de tags e/ou dados histricos da
aplicao rodando no server para computador(es) Web Thin Client.
Embora ambos os servidores estejam geralmente rodando em um mesmo computador, o IWS
fornece a flexibilidade para rodar cada servidor em uma estao diferente quando necessrio. Veja
Arquiteturas Tpicas na Aplicao Baseada em Web para maiores informaes.
Configurando uma Aplicao Baseada na Web
Os passos principais para configurar uma aplicao baseada na web com o IWS so descritos abaixo:
1. Configure the web server: O servidor da web um driver HTTP server capaz de fornecer
arquivos para estaes remotas via protocolo HTTP por sobre TCP/IP. O IWS suporta qualquer
web server; porm, caso sua arquitetura necessite do Web Gateway projetado pela Indusoft, o
servidor da web dever ser IIS (Internet Information Services) da Microsoft.
Est rodando e preenchendo um diretrio prprio (web root). Geralmente, o diretrio home deve ser
configurado com o caminho para a subpasta \Web da aplicao. Consulte sua documentao do servidor
da web para maiores informaes sobre sua configurao.

Notas:
A InduSoft fornece um servidor da web para Windows NT/2K/XP
(NTWebServer.exe), armazenado na subpasta \BIN do IWS aps a instalao.
Mais do que isso, a InduSoft fornece um servidor da web para Windows CE
(CEWebServer.exe) que est armazenado na subpasta \Redist\<WinCE
version>\<Processor Type> do IWS aps a instalao. O diretrio home (web
root) para os servidores da web fornecidos pela InduSoft o mesmo de onde
eles so executados. Portanto, a InduSoft recomenda a efetuao de cpias
desses para a subpasta \Web de sua aplicao antes de rod-los.
NTWebServer e CEWebServer foram projetados primariamente para estes
simples e/ou demos. A InduSoft recomenda a utilizao de Web Servers
comerciais de terceiros, como IIS (Internet Information Services) da Microsoft
ou Apache (para Linux) em aplicaes de tempo real.

2. Configure os parmetros da Wwe na aplicao do IWS: Os parmetros da web para aplicao do
IWS so configurados na janela de dilogo Project Settings Web.
3. Salve as tela como HTML: As telas que devem estar disponveis para Web Thin Client stations
devem estar salvas como HTML. Para isso, abra a tela no ambiente de desenvolvimento e
execute o comando FileSave as HTML a partir do menu. Utilize a opo do menu FileSave
Screen Group as HTML para salvar grupos de tela (*.sg) como HTML e torn-las disponveis
para Web Thin Clients. Aps salvar qualquer tela como HTML, os arquivos da web para essa
tela so automaticamente atualizados sempre que salvos novamente (FileSave).

D Dica:
Caso voc deseje tornar todas as suas telas da aplicao disponveis para Web
Thin Client stations, execute FileSave All como opo de menu HTML.

IWS 20/06/2007

InduSoft Web Studio

Pgina 495
C Ateno:
Aps alterar qualquer configurao na janela de dilogo Project Settings e/ou em
Tags Database, deve-se executar o comando ToolsVerify Application para
atualizar arquivos da web com uma nova configurao.

4. Run the Application on the server: Certifique-se de que o mdulo TCP/IP Server esteja rodando
no servidor de dados. O mdulo TCP/IP Server est embutido no IWS, e automaticamente
executado sempre que voc rodar qualquer aplicao em sistemas operacionais Windows CE.
Para Windows NT/2K/XP, pode-se configurar o mdulo TCP/IP Server para ser executado
automaticamente quando a aplicao for iniciada, utilizando o dilogo Project
StatusExecution Tasks. O mdulo TCP/IP Server o servidor de dados para estaes Web
Thin Client remota(s).
5. Dependendo de sua Arquitetura, voc precisar rodar o Web Gateway projetado pela Indusoft
na estao web server.
Arquiteturas Tpicas
Essa seo descreve arquiteturas tpicas aplicadas para solues baseadas na web e fornece exemplos de
como configurar a aplicao do IWS para cada arquitetura.
As definies de alguns dos termos utilizados nessa seo esto descritas abaixo:
Web server: Software que implementa o protocolo (server) HTTP atravs de TCP/IP; ex. web
server do IIS da Microsoft.
Server station: Computador ou equipamento que est rodando o IWS e um web server. A
aplicao do IWS deve estar armazenada nesse computador.
Web server station: Computador ou equipamento que est rodando um web server. Os arquivos
da subpasta \Web da aplicao devem estar armazenados nesse computador.
Data server station: Computador ou equipamento que est rodando o IWS. A aplicao do IWS
deve estar armazenada nesse computador.
Essa seo no descreve todas as arquiteturas possveis, embora fornea os conceitos necessrios
para projetar e configurar diferentes cenrios baseados nas arquiteturas bsicas ilustradas abaixo.
Arquitetura 1: Web server e Web Thin Clients em uma mesma rede de trabalho
Server Station
TCP/IP
Web Thin Client
Studio Runtime + Application
Data Server (TCP/IP Server)
Web Server (HTTP Server)

Essa a arquitetura mais comum, assim como a mais facilmente configurvel. Nessa Arquitetura,
tanto o web server (ex. IIS) quanto o mdulo data server (TCP/IP server do IWS) esto rodando em
um mesmo computador (server station). O Web Thin Client conecta-se ao web server na server
station para efetuar o download do arquivo de tela HTML. A seguir, conecta-se ao data server para
trocar dados com o IWS.
Desde que ambos (Web Thin Client e server station) estejam conectados a uma mesma rede de
trabalho, o Web Thin Client poder acessar a server station diretamente atravs de seu endereo IP
(ou host name).
Exemplo de Configurao:
Esse exemplo baseado nas seguintes premissas:
Endereo IP da server station na rede de trabalho: 192.168.1.1
Diretrio Home do web server (server HTTP) na server station: subpasta \Web da aplicao
IWS 20/06/2007

InduSoft Web Studio

Pgina 496
Deve-se digitar o endereo 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) esto
diretamente conectados a mesma rede de trabalho intranet ou via uma
conexo dial-up. Caso o servidor esteja conectado a internet, deve-se
estabelecer um endereo IP Fix ao servidor na internet, e a aplicao dever
estar rodando nesse computador. Consulte seu Provedor ISP para maiores
informaes sobre como obter um endereo Fix IP para seu computador
servidor na internet.

IWS 20/06/2007

InduSoft Web Studio

Pgina 497
Arquitetura 2: Web server e Web Thin Client sem uma mesma rede de trabalho; web
server e data server em estaes diferentes

Web Server Station
TCP/IP
Web Thin Client
Files from the \Web
application sub-folder
Data Server Station

Essa Arquitetura especialmente til quando voc deseja isolar o web server (HTTP server) a partir
do data server (mdulo TCP/IP server do IWS). As razes mais comuns para a adoo dessa
arquitetura so:
Permite a utilizao de uma web server station padro compartilhada por vrias aplicaes na
companhia. Algumas companhias utilizam um computador como web server padro para todas
as aplicaes baseadas na web. Por razes fsicas ou de segurana, voc poder no querer
rodar a aplicao verdadeira nesse computador (ex. Este encontra-se longe da sala de controle.
Portanto, pode-se rodar o IWS e a aplicao em um outro computador (data server station) e
apenas copiar os arquivos da web da aplicao (arquivos da subpasta \Web da Aplicao) para
a web server station.
Hospeda pginas da Web em sites da Web. Caso voc deseje armazenar as pginas da web em
um site da web (ex. www.mycompany.com), pode-se enviar apenas arquivos da web da
aplicao (arquivos da subpasta \Web da Aplicao) para o site da web e utiliz-los como a web
server station. A Aplicao (e o IWS) mantm-se rodando em outro computador fisicamente
conectado a internet.
Habilita a utilizao de um web server baseado em Linux (ex. Apache). No ser necessrio
instalar o IWS na web server station; portanto, caso voc deseje utilizar um web server para
Linux, voc poder rod-lo na web server station e rodar o IWS na data server station.
Oculta o endereo IP (ou host name) da data server station de usurios na Web Thin Client
station. Nessa Arquitetura, o usurio dever digitar a URL da web server no browser da web
(no o endereo IP da data server station). Tal tarefa pode ser adotada por questes de
segurana.

Nota:
No necessrio que o IWS seja instalado na web server station. Os
componentes a seguir devem estar disponveis na web server station:
* Web server (ex. IIS da Microsoft)
* Arquivos da subpasta \Web da Aplicao

IWS 20/06/2007

InduSoft Web Studio

Pgina 498
D Dica:
Quando voc possui muitos data servers nas aplicaes de seu projeto, essa
arquitetura poder ser utilizada para compartilhar o mesmo web server para
todas as aplicaes. Por exemplo, pode-se estabelecer um link entre web server
e data servers atravs de um alternador, o que manter o trfego na rede de
trabalho, o que manter o trfego em redes de trabalho em crescimento,
enquanto Web Thin Clients esto efetuando download de arquivos da web server
station.

Nessa Arquitetura, tanto web server (ex. IIS) quanto data server (mdulo TCP/IP server do IWS)
esto rodando em computadores diferentes. Web Thin Client conecta-se a web server station para
efetuar download de arquivo de tela HTML. Em seguida, esse conecta-se a data server station para
trocar dados com o IWS.
Desde que Web Thin Client, web server e data server stations estejam conectados a mesma rede de
trabalho, o Web Thin Client poder acessar as server stations diretamente, atravs de seus
endereos IP (ou host names).
Endereo IP da web server station na rede de trabalho: 192.168.1.1
Endereo IP da data server station na rede de trabalho 192.168.1.2
Diretrio Home do web server (server HTTP) na server station: subpasta \Web da aplicao
Deve-se digitar o seguinte endereo 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
IWS 20/06/2007

InduSoft Web Studio

Pgina 499

Arquitetura 3: Servidores Redundantes e Web Thin Client stations na mesma rede de
trabalho

Server Station #1
TCP/IP
Web Thin Client
Server Station #2

Essa Arquitetura similar a Arquitetura 1, embora nessa arquitetura duas server stations com os
mesmos arquivos rodem a mesma aplicao em redundncia. O Web Thin Client conecta-se ao
servidor especificado pelo usurio no campo address do browser da web. Caso esse servidor ficar
indisponvel por qualquer razo (ex. Queda de energia), o Web Thin Client alterna-se para outra
estao servidora automaticamente.
Essa Arquitetura recomendada quando h necessidade de alto nvel de disponibilidade para
estaes Web Thin Client, ou seja, mesmo se a Server Station torne-se indisponvel, as estaes
Web Thin Client sero capazes de obter dados a partir de outra Server Station.
Exemplo de Configurao: Esse exemplo baseado nas seguintes premissas:
Endereo IP da server station #1 na rede de trabalho: 192.168.1.1
Endereo IP da server station #2 na rede de trabalho: 192.168.1.2
Diretrio Home do web server (HTTP server) na server station #1: subpasta \Web da aplicao,
armazenada na server station #1.
Diretrio Home do web server (HTTP server) na server station #2: subpasta \Web da aplicao,
armazenada na server station #2.
O usurio dever digitar o endereo 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 usurio dever digitar o endereo 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:

D Dica:
possvel configurar dois servidores de dados que compartilhem o mesmo web
server, aplicando os conceitos descritos nas Arquiteturas 2 e 3.

IWS 20/06/2007

InduSoft Web Studio

Pgina 500


Dilogo Advanced
IWS 20/06/2007

InduSoft Web Studio

Pgina 501
Arquitetura 4: Web server e Web Thin Clients em redes de trabalhos diferentes

Web Server Station
Web Thin Client
TCP/IP
(Intranet)
Data Server Station
Files from the \Web
application sub-folder
Web Tunneling Gateway

Essa Arquitetura usual quando Web Thin Clients esto conectados ao servidor via internet.
Geralmente, o computador servidor de dados (computador onde o IWS est rodando) no est
diretamente conectado internet. Nesse caso, o computador servidor de dados no possui um
endereo IP na internet, portanto no ser conectado diretamente atravs da internet. O Web
Tunneling Gateway (WTG), desenvolvido pela InduSoft, fornece as capacibilidades de roteamento
para a soluo desse problema.
O WTG dever estar instalado no computador com o Endereo Fix IP na internet (consulte seu
provedor ISP para maiores informaes sobre como obter um Endereo Fix IP para seu computador
na internet). Esse computador dever possuir o web server Microsoft IIS instalado e rodando. O
WTG uma extenso ISAPI para IIS.
Siga o procedimento abaixo para a instalao do WTG no computador web server:
Copie o arquivo WebGtw.exe da subpasta \BIN do IWS dentro de qualquer diretrio 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 informaes para mais de um data
server de forma simultnea.

Nota:
O computador conectado diretamente a internet (onde o WTG est rodando)
o web server para a aplicao; portanto, os arquivos da subpasta \Web da
aplicao devero ser armazenados nesse computador.

Endereo IP da web server station (internet): 200.0.0.1
Endereo IP da web server station (intranet): 192.168.1.1
Endereo IP da data server station na intranet: 192.168.1.2
IWS 20/06/2007

InduSoft Web Studio

Pgina 502
Diretrio Home do web server (HTTP server) na web server station: subpasta \Web da aplicao,
armazenada na web server station.
O usurio dever digitar o endereo 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:


IWS 20/06/2007

InduSoft Web Studio

Pgina 503

Janela de Dilogo Advanced

Nota:
Caso seu web server seja capaz de fornecer arquivos via HTTPS (SSL Secure
Socket Layer), voc poder selecionar essa opo na janela de dilogo
Advanced a partir da interface Project Settings Web.

D Dica:
O WTG encapsula o protocolo implementado pelo mdulo TCP/IP do IWS para
HTTP (ou HTTPS quando a opo SSL est selecionada). Dessa maneira, no
necessrio 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.

IWS 20/06/2007

InduSoft Web Studio

Pgina 504
Captulo 19: Correo de Problemas
Caso voc no encontre uma soluo para sua dvida, e nessecite de assistncia tcnica, existem alguns
fatores que voc precisa saber antes de entrar em contato com o Suporte Tcnico. Apesar de seu problema,
voc dever saber a seqncia de eventos que levam a descoberta do problema em questo, o qual dever
ser explicado da forma mais detalhada possvel, o que poder afetar drasticamente o tempo e procedimento
para a resoluo de seu problema. recomendado que voc esteja em frente ao seu computador para
melhores resultados sobre os problemas a serem resolvidos. Alm disso, recomenda-se ter em mos uma
caneta e um pedao de papel .
Antes de entrar em contato com o Suporte Tcnico
Existem algumas tentativas que voc dever executar antes de entrar em contato com o suporte tcnico:
Verificar a documentao
Verifique os arquivos Help de seu produto para maiores informaes a respeito de sua dificuldade. Help
pode ser encontrado na barra de menu da Aplicao. Para documentao online, incluindo Notas Publicdas
e downloads, entre no web site do IWS (www.InduSoft.com). Voc poder encontrar sua dvida particular
como um problema j previamente documentado.
Considerar alteraes recentes em seu sistema
Caso exista algo normalmente utilizado, leve em considerao assuntos que podem ter sido alterados. A
instalao de um novo software ou sistema gerais podem afetar a performance e funcionalidade
generalizada de outro software em seu sistema.
Tentar reproduzir o problema em um novo arquivo
Caso o problema no possa ser reproduzido em um novo arquivo, faa uma comparao entre o novo
arquivo e seu original para encontrar e eliminar as diferenas entre eles. Tal attitude auxiliar na resoluo
do problema encontrado.
Tentar reproduzir o problema em outra mquina
Caso o problema no ocorra em outra mquina, compare o que existe de diferente entre os dois sistemas.
Nesse caso, podem existir algo como conflitos de sistemas.
Caso voc no possa encontrar uma resposta para sua pergunta tcnica na documentao do produto ou
no sistema Help, nossos especialistas em Suporte Tcnico esto disponveis para assistncia a qualquer
cliente com a manuteno do produto atual.
Tente definir o problema antes de entrar em contato com o Suporte Tcnico, de forma que voc poder
repetir os passos que conduzem ao problema e identifica-lo de forma especfica, sobre quando e como o
problema ocorreu. O suporte representativo necessitar saber exatamente qual o problema, de modo a
promover auxlio. Esses passos nos ajudaro na descoberta rpida do problema, bem como resolve-lo o
mais rpido possvel.
Tenha as seguintes informaes disponveis:
Ambiente do Hardwarememria disponvel, tipo de processador, equipamento de sada
Ambiente do SoftwareSistema Operacional, verso do Windows, plataforma de rede de
trabalho
Nome do Produto, nmero da tag databasee nmero de registro do produto
Quantidade de memria instalada em seu sistema
Quantidade de espao em disco rgido em seu sistema
Resoluo da tela (tamanho da tela em pixels (por exemplo, 1024 por 768)
Profundidade da cor na tela (nmero de cores ou bits, por exemplo, 256 cores ou 8-bit)
IWS 20/06/2007

InduSoft Web Studio

Pgina 505
Fabricante do placa grfica, nome do modelo e nmero da tag databasedo driver
Fabricante da placa de som e nome do modelo
Uma lista de equipamentos externos conectados ao computador
Breve descrio do problema ou erro, e um texto especfico para cada mensagem de erro
Descrio dos passos a serem tomados para resoluo de problemas, por exemplo, em quantas
mquinas foram testadas e se o erro persiste em um novo arquivo
Passos para reproduzir o ocorrido, caso seja reproduzvel. Caso no o seja, poder ser mais um
erro de desenvolvimento do que um problema com o produto.
Caso seu problema ou questo no seja urgente, voc tem a opo de entrar em contato com o Suporte
Tcnico via email. Tais emails so verificados e respondidos diariamente (suporte@iwsdobrasil.com.br ).
Caso voc necessite de assistncia adicional para a utilizao do InduSoft Web Studio ou seu pacote de
servicos, os recursos esto disponveis por telefone:
IWS (011) 3849 2000
Publicaes relacionadas ao IWS:
InduSoft Web Studio Getting Started Guide: Projetado para usurios inexperientes com o
produto, essa publicao contm informaes sobre as funes bsicas do InduSoft Web
Studio. Tal publicao fornecida na pasta Documentation no CD-ROM do IWS ou no menu
Help localizado na barra de menu principal.

Utilizando o Menu Help
Technical Reference: Contm o arquivo Help.
User Guide: Abre o Manual do Usurio.
InduSoft Web Studio Technical Reference Manual: Descreve todos os recursos e ferramentas que
dizem respeito ao ambiente de desenvolvimento do IWS, alm de fornecer instrues detalhadas
para a utilizao do produto. Tal publicao fornecida na pasta Documentation no CD-ROM do
IWS ou no menu Help da barra de menu principal.
Drivers User Guides: Explica como configurar os drivers individuais do InduSoft, de acordo com
as caractersticas de seus prprios protocolos. Um guia do usurio personalizado est includo
a cada driver do InduSoft. Essas publicaes so fornecidas no subdiretrio DRV da pasta do
InduSoft Web Studio no CD-ROM do IWS ou no menu Help localizado na barra de menu
principal.
Visite o site da InduSoft na Web: www.InduSoft.com.
Verificando sua Aplicao
Da barra de menu, selecione Tools Verify Application para recompilar planilhas Math, lgicas de tela e
atualizar arquivos HTML atuais utilizando as configuraes no tabWeb (dilogo Project Settings). Tags no
banco de dados so remapeados para todas as planilhas e telas.
IWS 20/06/2007

InduSoft Web Studio

Pgina 506
necessrtio verificar seu aplicao caso voc delete/altere/reordeene quaisquer tags no tag database Tags
ou campos do tab Web Project Settings. Verificar se sua aplicao realinha todas as planilhas do driver e
telas ao estado atual de tag database.

Verificando a aplicao
D Dica:
Ao salvar uma tela ou planilha, o IWS inclui um apontador tag databasedo banco de
dados atual. Ao executar a aplicao, o IWS compara a tela ou planilha com o banco de
dados da aplicao atual e caso no exista coincidncia (mismatch), o IWS recompila as
expresses.
Para evitar a efetuao dessas tarefas durante o runtime da aplicao, recomendamos
rodar a funo Verify Application antes de efetuar o download e/ou finalizar uma
aplicao. Pode-se tambm utilizar essa funo ao converter uma aplicao para uma
nova tag databaseda aplicao.
Erros Comuns
Listados abaixo esto as respostas a perguntas feqentes sobre o InduSoft Web Studio.
Banco de Dados & Sistema de Segurana
O que fazer com a pasta Shared Tags armazenada?
A pasta Shared Tags armazena os tag importadosdo PC Based Control com link a aplicao do IWS. O PC
Based Control possui um link a aplicao do IWS a partir do wizard New Project.
Como fao para contar quantos tags esto configurados no banco de dados da aplicao?
Na barra de menu, selecione Project Status, e o tab Information para calcular a quantidade de tags
configurados na aplicao. Cada posio de array e cada membro de classe dos tags configurados no tag
database do IWS so contados.
IWS 20/06/2007

InduSoft Web Studio

Pgina 507
Como visualizar a lista de Usurios adcicionados durante o runtime em minha aplicao, criada
com a funo CreateUser()?
Execute o seguinte comando: <Studio Path>\BIN\Studio Manager.exe <Studio Path>\BIN\ExtUser.dll
(Por Exemplo: E:\Program Files\Studio\BIN\Studio Manager.exe E:\Program
Files\Studio\BIN\ExtUser.dll). Esse comando inicializar uma janela de dilogo. Pode-se visualizar os
usurios criados pela funo CreateUser() e criar ou deletar usurios.
Grficos
Como inserir e configurar um objeto ActiveX em uma aplicao do Studio?
Para inserir um objeto ActiveX na aplicao do IWS:
Selecione a opo de menu Insert ActiveX object ou aperte o boto ActiveX Control na barra de
ferramentas Active Objects.
Selecione o objeto ActiveX a ser inserido na aplicao a partir do list box, e aperte o boto OK. O
objeto ActiveX aparecer na tela. (Objetos ActiveX no registrados no estaro disponveis nesse list
box.)
Clique duas vezes no objeto ActiveX e assinale seu nome (insira um valor no campo Name). O
dinmico properties e a lista methods podem ser visualizados seleiconando o boto Methods. As
propriedaes estticas podem ser configuradas pelo boto Properties (uma descrio detalhada das
propriedades do objeto podem ser encontradas na documentao do componente, fornecida pelo
desenvolvedor do componente).
Existem trs funes 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 dilogo Methods do
objeto, com a sintaxe <Properties Name>(PropGet) (por exemplo, Color(PropGet)).
XSet(strName,strProperties,Value): Registra o valor <Value> para propriedades <strProperties>
do objeto <strName>. A lista de propriedades as quais podem ser configuradas ao objeto est no
dilogo Methods do objeto, com a sintaxe <Properties Name>(PropPut) (por exemplo, Color(PropPut)).
XRun(strName, strMethod, Parameter1, Parameter2, , ParameterN): Execute o mtodo
<strMethod> do objeto <strName>, de acordo com parmetros <Parameter1>, <Parameter2>, ,
<ParameterN>. A lista de mtodos disponveis no objeto est no dilogo Methods do objeto, com a
sintaxe <Method Name>(Method) (por exemplo, OpenFile(Method)).
D Dica:
Antes de inserir um componente ActiveX (geralmente um arquivo OCX) na
aplicao do IWS, certifique-se de que esse tenha sido registrado de maneira
apropriada no computador. possvel registrar um objeto ActiveX atravs do
IWS. Selecione a opo de menu Tools Register Controls, aperte o boto
Register e selecione o arquivo ActiveX (geralmente um arquivo OCX) que dever
ser registrado.

IWS 20/06/2007

InduSoft Web Studio

Pgina 508

Nota:
A quantidade de parmetros configurados na funo XRun() podem variar de 0 at
255 e depende de cada componente ActiveX. possvel utilizar tags para
configurar parmetros; porm, o tipo de tag deve estar de acordo com o tipo de
parmetro do componente (Boolean, integer, string ou real).

Como designar uma tela que abrir a cada vez que a aplicao for iniciada?
Abra a janela de dilogo Project Settings do menu Project Settings, selecione o tab Runtime Desktop, e
digite o nome da tela startup no campo Startup screen.
Como inserir uma figura de fundo na tela?
Clique com o boto direito na tela e selecione a opo Screen Attributes do menu pop-up. Habilite o check-
box Enable Background e escolha o formato da figura no combo-box prximo a esse nome. Copie o arquivo
da figura para a pasta \Screen da Aplicao e renomeie, com o mesmo nome da tela (arquivo
<ScreenName>.scr). Utilizando a opo Shared image, possvel copiar um arquivo bitmap para a pasta
\Screen e compartilhar essa figura com mais de uma tela. Nesse caso, necessrio digitar o nome bitmap
no campo Share image.
Tarefas
Como converter um Trend Histrico para um arquivo ASCII?
Para converter um arquivo History Trend para formato ASCII, copie o arquivo
"<StudioPath>\bin\hst2txt.exe" para o caminho "\<AplicaoPath>\hst\". De forma alternativa, pode-se
utilizar a funo HST2TXT em uma planilha Math para converter arquivos binrios para formato texto de
forma automtica, sem a necessidade de utilizar uma janela DOS.
Como trocar dados com FOX Pro atravs de um protocolo ODBC?
Ao trocar dados com o banco de dados FOX Pro, necessrio configurar o parmetro UseQuote=0 na seo
[ODBC] no arquivo <AplicaoName>.app.
Como configurar um campo DATE para uma interface ODBC com um Oracle package?
Configure as clulas 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 aplicao?
Startup: Execute uma planilha Math durante o startup criando uma planilha Math e preenchendo-a em seu
campo Execution coma expresso <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 invs de executar a funo ShutDown() diretamente, execute uma planilha Math e configure
a funo ShutDown() na ltima linha dessa planilha Math.
IWS 20/06/2007

InduSoft Web Studio

Pgina 509
Comunicao
Como configurar um alarme communication Error?
Configure um tag nos campos Write Status ou Read Status da planilha de driver e configure um alarme
sempre que esse tag for diferente de 0 (zero).
Como estabelecer comunicao com um PLC Siemens S7-200 sem utilizar um software Prodave?
PLC Siemens S7-200 possui uma Freeport que pode implementar qualquer protocolo via programao PLC.
Existe um software gratis para PLC distribudo pela Siemens que implementa o protocolo Modbus na
Freeport do PLC (para maiores informaes, contate o suporte da Siemens). Utilizando esse software no PLC
e no driver Modbus do Studio (MODBU) pode-se trocar informaes entre eles.
Como iniciar e parar drivers de comiunicao durante o runtime?
Existem trs funes disponveis para o manuseio da execuo dos drivers de comunicao durente o
runtime:
Iniciar todos os drivers configurados na aplicao:
Sintaxe: StartTask(Driver)
Por exemplo, StartTask(Driver)
Iniciar um driver especfico configurado na aplicao:
Sintaxe: WinExec(<StudioPath>\bin\StudioManager.exe+ +
<StudioPath>\bin\Driver.dll+ + <DriverName>)
Por exemplo, WinExec(Asc2Str(34)+C:\Program Files\InduSoft Web Studio\BIN\Studio
Manager.exe+Asc2Str(34)+ +Asc2Str(34)+ C:\Program Files\InduSoft Web
Studio\BIN\Driver.dll+ Asc2Str(34)+ +Asc2Str(34)+ MODBU+Asc2Str(34))
Nota:
A funo Asc2Str(34) utilizada para concatenar marcas de cotao para
caminhos onde existam grficos de espao.
Parar um driver especfico configurado na aplicao:
Sintaxe: EndTask(Driver<DriverName>)
Por exemplo, EndTask(DriverMODBU)
D Dica:
Pode-se iniciar ou parar outras tarefas utilizando as funes
StartTask(<TaskName>) e EndTask(<TaskName>).
Por exemplo, StartTaks(Viewer), Endtask(Viewer).

C Ateno:
Os drivers e tarefas no podem ser iniciados ou parados durante o runtime
quando o CEView estiver rodando (sob sistema operacional WinCE).

IWS 20/06/2007

InduSoft Web Studio

Pgina 510
O que so parmetros DDE Server do Studio?
O DDE Server do Studio e Parmetros NetDDE Server so exibidos na tabela abaixo:
Tipo de
Comm.
Aplicao Tpico 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 estaes de rede de trabalho.
Inicie o mdulo DDEServer do Studio (Project Status DDE Server)
Rode o Excel na estao remota
Abra uma planilha Excel e preencha as clulas as quais devero trocar dados com o Studio
utilizando a seguinte sintaxe: = '\\<computer name>\NDDE$'|
'UNISOFT$'!<tagname>
Por exemplo, ='\\PC\NDDE$'|'UNISOFT$'!second
Notas:
Ao rodar em Windows NT ou Windows2000, necessrio certificar-se de que os
servios Network DDE e Network DDE DSDM esteja iniciados. (Utilize o atalho
Services do Control Panel para iniciar tais servios).
Ao rodar em Windows 98, necessrio 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 especificao OPC v1.0a ou v2.0?
Studio OPC Client e mdulos OPC Server so compilantes com ambas as especificaes do OPC, v1.0a e
v2.0.
Resoluo de Erros Gerais
Quais sistemas operacionais so compatveis com Studio e CEView?
Veja a tabela abaixo. O smbolo significa que o Sistema Operacional No suportado e o smbolo
significa que o Sistema Operacional suportado.
Sistema Operacional Studio CEView
Nome Verso v2.x
v3.x
and
v4.1
v4.2 or
higher
v3.x V4.x V5.x
Windows XP Any - -
Windows
2000
Any - -
Windows NT
V4.0+SP4
or higher
- - -
Windows ME Any -
Windows 98 Any -
Windows 95 Any - -
IWS 20/06/2007

InduSoft Web Studio

Pgina 511
Sistema Operacional Studio CEView
Nome Verso v2.x
v3.x
and
v4.1
v4.2 or
higher
v3.x V4.x V5.x
V2.12 -
Windows CE
V3.x - - -
V4.0 -
V4.1 -
Windows
CE.net
V4.2 -

Como iniciar o IWS automaticamente quando o computador est ligado?
Crie um atalho para \<Studio Path>\bin\RunStartUp.exe na pasta Startup do grupo Programs
(\WINNT\Profiles\All Users\Start Menu\Programs\Startup\).
Coimo desabilitar Dr. Watson?
O procedimento para desabilitar, passo a passo, o Dr. Watson em Windows NT est descrito abaixo:
Execute o programa <WindowsPath>\RegEdit.exe (por exemplo, C:\WinNT\Regedit.exe)
Selecione o caminho HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\CurrentVersion\AeDebug
Configure o valor 0 (zero) para o parmetro Auto a partir do caminho selecionado.
Feche a janela Registry Editor.
C Ateno:
Ateno especial dever ser dada ao editar parmetros 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 Parmetros Order=<DateFormat> (por exemplo, DMY) e
Separator=<Separator> (por exemplo, / or .) da seo [International] do arquivo
\<StudioPath>\Local Settings\Aplicao Data\InduSoft Web Studio v6.1\Program Settings.ini.
Nota:
Voc precisar verificar sua aplicao para aplicar configuraes de data para
pginas da Web previamente salvas.
On-Line: Utilizar a funo SetDateFormat(<strSeparator>, <strDateFormat>). Por exemplo,
SetDateFormat(/,MDY).
Quais recursos No so suportados pelo CEView?
Os principais recursos No suportados pelo CEView so: DDE, NetDDE, ODBC, PasteLink, e um nmero de
funes.
IWS 20/06/2007

InduSoft Web Studio

Pgina 512
Quais so os principais passos para criar uma aplicao baseada na Web?
Siga o procedimento abaixo:
Desenvolva a Aplicao localmente. No utilize recursos No suportados por Web Thin Clients para
as telas que sero salvas em formato HTML.
Aps salvar a telas no formato padro (File Save), salve as telas que devero estar disponveis
para Web Thin Client em formato HTML pelo menu File Save as HTML.
Abra o dilogo Project Settings (menu Project Settings) e selecione o tab Web.
Configure o campo Data Server IP com o endereo IP da Server station (estao onde o IWS est
rodando).
Abra o dilogo Project Status (menu Project Status), selecione o tab Execution Tasks e configure
o mdulo TCP/IP Server como Startup=Automatic.
Abra o tag database da aplicao e configure a opo Server ao invs de Local na coluna Web Data
para todos os tags que devero trocar valores entre Server e Web Thin Client station.
Execute o programa Tools Verify Aplication para atualizar Project Settings em arquivos HTML.
Caso no haja Web Server rodando no computador, copie o programa NTWebServer.exe da pasta
\BIN do Studio para a raiz da web (por exemplo, \<AplicaoFolder>\Web) e execute-o. O caminho
onde esse programa Web Server executado ser a raiz da web da estao. O Web Server
necessrio para exporter dados (arquivos da web) em protocolo HTTP para Web Thin Clients.
Execute a Aplicao na Server station.
Utilizando um browser (por exemplo, Internet Explorer v4.1+SP1 ou tag databasemais atual) na
Web Thin Client station, digite o endereo URL para efetuar download da tela salva em formato
HTML (por exemplo, http://<ServerIPAddress>/ <ScreenName>.html).
Nota:
Web Thin Client requer um componente ActiveX (ISSymbol.ocx) para manusear
as telas na browser. Caso o Web Thin Client esteja conectado Internet, esse
componente baixado e registrado automaticamente. Do contrrio, necessrio
copi-lo para o diretrio \<OSPath>\System32 do Web Thin Client e registr-lo
pelo comando regsvr32 ISSymbol.ocx. Esse arquivo pode ser encontrado na
pasta \BIN do diretrio de instalao do IWS.

IWS 20/06/2007

InduSoft Web Studio

Pgina 513
Como enviar um email da aplicao do IWS?
Execute a funo CNFEMail(strSMTP,strFrom,strPOP3,strUser, strPassword,numTimeOut) para
configurar parmetros gerais utilizados para enviar emails. Aps executar essa funo uma vez,
os parmetros configurados so mantidos no sistema at que a aplicao seja fechada. Assim, a
maioria das aplicaes executam essa funo apenas uma vez, aps iniciarem a Aplicao;
Execute a funo SendEMail(strSubject,strMessage,strTO) e/ou SendEMailExt(strSubject,
strMessage,strTO,strCC,strBCC, strFile1,...,strFileN) a cada vez que uma mensagme de email
deva ser enviada. A principal diferena entre ambas as funes esto listadas na tabela abaixo:
Caracterstica SendEmail() function SendEmailExt() function
Execuo Sncrona Assncrona
Suporta texto do Assunto - -
Suporta texto da
Mensagem
- -
Suporta endereos TO - -
Suporta endereos CC -
Suporta endereos BCC -
Suporta arquivos
anexados
-

A tarefa de runtime (TCP/IP, OPC, DDE, ODBC, etc) no funciona.
Certifique-se de que a terefa de runtime est configurada para Automatic no tab Execution Tasks do dilogo
Project Status (Menu Project Status). Selecione as terefas de runtime que devero ser executadas (por
exemplo, TCP/IP Server), siga para o boto Startup e configure para Automatic.
O Browser do Web Thin Client no 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 dilogo
Project Status (menu Project Status). Selecione as tarefas de runtime que devero ser executadas (por
exemplo, TCP/IP Server), alcance o boto Startup e configure para Automatic.
O Browse do Web Thin Client inicializa uma mensagem de erro faltando ISSymbol.ocx e no exibe
a tela do Server.
Issymbol.ocx o objeto ActiveX do IWS utilizado pelo browser do Web Thin Client para visualizar pginas da
web. Caso o Web Thin Client esteja conectado Internet, o controle ISSymbol.ocx automaticamente
baixado e registrado na Web Thin Client station. Do contrrio, necessrio copiar para a pasta
\WinNT\System32 na Web Thin Client station e registrar manualmente. Uma vez registrado, seu browser
visualizar as pginas.
Nota:
Utilize o comando regsvr32 ISSymbol32.ocx para registrar o componente ActiveX
no Web Thin Client.
As telas so exibidas no Web Thin Client (Browser); porm, os dados (valores de tag) no so
lidos do Server.
Certifique-se de que o parmetro na coluna Web Data do tag database da aplicao esteja configurado para
Server ao invs de Local. Os tags configurados como Server mantm o mesmo valor em Server e Web Thin
Client (Browser). Os tags configurados como Local possuem valores independentes no Server e Web Thin
Client (Browser).
IWS 20/06/2007

InduSoft Web Studio

Pgina 514
C Ateno:
necessrio executar o programa Tools Verify Application aps modificar as
configuraes dos tags. Do contrrio, as alteraes no sero atualizadas em
arquivos da web.
As expresses On Up configuradas na dinmica Command no so executadas.
As expresses On Up da dinmica Command no so 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 expresso On Up executada mesmo se o mouse seja arrastado para fora da rea do
objeto antes de solt-lo.
O Histrico Trend no funciona aps adicionar ou remover tags na planilha Trend.
Quando um tag inserido ou removido DE uma planilha Trend, o formato dos arquivos histricos (*.hst)
modificado. O mesmo arquivo .hst no pode possuir dois formatos diferentes; do contrrio, os dados no
sero entregues a partir dele da maneira adequada pelo objeto Trend. Caso voc precise adicionar ou
remover tags de arquivos histricos, existem dois procedimentos vlidos: Criar uma nova planilha Trend ou
deletar os arquivos *.hst antigos.
O valor de tags indiretos (@<TagName> ) no est exibido na aplicao web thin client.
Quando a tela salva como HTML, o Studio salva um arquivo <ScreenName>.tagl na subpasta \WEB. Esse
arquivo possui uma lista de todos os tags configurados na tela (objetos e dinmicos). Quando uma tela
aberta no browser Web Thin Client, os tags listados em <ScreenName>.tagl so habilitados para
cominicao TCP/IP com a server station, o que promove uma cominicao optimizada entre a server
station e Web Thin Client stations.
Ao utilizar tags indiretos nesse modo (@<IndirectTag>), os tags apontados no trocaro dados com o Server,
a menos que tenham sido configurados na tela, ou seja, os tags que sero apontados na tela DEVEM ser
configurados em qualquer objeto da tela para habilitar a comunicao TCP/IP entre esses tags e a server
station.
D Dica:
Adicione um retngulo transparente (sem preenchimento e linha) no canto da tela.
Aplique a dinmica Command a esse retngulo e configure os tags (que podem ser
apontados por tags indiretos durante o runtime em Web Thin Client station) nos
campos Expression (mantenha os campos Tag Name em branco). Esses tags sero
adicionados ao arquivo <ScreenName>.TAGL e estaro disponveis para comunicao
TCP/IP com a Server station.

IWS 20/06/2007

InduSoft Web Studio

Pgina 515
Quais funcionalidades no so suportadas por plataformas Pocket PC (por exemplo, IPaq,
Cassiopeia, Jornada)?
Equipamentos WinCE Pocket PC no suportam algumas funcionalidades que so suportadas por
equipamentos WinCE da tag databaseWindows CE padro:
Funcionalidade No suportada por Equipamentos Pocket PC
DCOM (Distributed Component Object Model): Significa que todos os recursos
baseados em DCOM (por exemplo, Cominicao OPC remota) no so suportados por
equipamentos PocketPC.
Funo DialGetClienDica()no funciona para equipamentos Pocket PC

Como habilitar as opes Hibernate do Sistema Operacional aps instalar o IWS em um
Notebook?
Rode Registry Editor (<Start button>\Run\regedit).
Selecione o caminho a seguir para o Registry Editor:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\ Proteq\Parmetros
O parmetro IoPortAddress do caminho mencionado acima est configurado com valor
hexadecimal: 0x00000111. Configure esse parmetro com o endereo hexadecimal da porta
paralela LPT1 de seu Notebook (por exemplo, 0x00000378).
Feche a janela Registry Editor e reinicie o computador.
D Dica:
O endereo Hexadecimal da porta paralela LPT1 do Notebook pode ser obtida do
Control Panel (System\Hardware\Device Manager\Ports (COM & LPT)\Printer Port
(LPT1)\Properties\Resources). Pegue o endereo inicial de I/O Range. Geralmente
o endereo hexadecimal 0x00000378.

IWS 20/06/2007

InduSoft Web Studio

Pgina 516
Apndice A. Funes do InduSoft Web Studio
Esse Captulo contm tabelas e informaes descrevendo as diferentes funes disponveis para o InduSoft
Web Studio e CEView.

Funes Log Message Execuo NT/2K/XP Win CE Web Client
Trace
Sncrona - -

Funes Aritimticas Execuo NT/2K/XP Win CE Web Client
Abs()
Sncrona - - -
Div()
Sncrona - - -
Format()
Sncrona - - -
GetBit()
Sncrona - - -
Mod()
Sncrona - - -
Pow()
Sncrona - - -
ResetBit()
Sncrona - - -
Round()
Sncrona - - -
SetBit()
Sncrona - - -
SQRT()
Sncrona - - -
Swap16()
Sncrona - -
Swap32()
Sncrona - -
Trunc()
Sncrona - - -

Funes Estatsticas Execuo NT/2K/XP Win CE Web Client
Ave()
Sncrona - - -
Max()
Sncrona - - -
Min()
Sncrona - - -
Rand()
Sncrona - -

IWS 20/06/2007

InduSoft Web Studio

Pgina 517

Funes Logartimicas Execuo NT/2K/XP Win CE Web Client
Exp()
Sncrona
- - -
Log()
Sncrona
- - -
Log10()
Sncrona
- - -

Funes Lgicas Execuo NT/2K/XP Win CE Web Client
FalIf()
Sncrona
- - -
If()
Sncrona
- - -
True()
Sncrona
- - -

Funes String Execuo NT/2K/XP Win CE Web Client
Asc2Str()
Sncrona
- - -
CharToValue()
Sncrona
- - -
CharToValueW()
Sncrona
- - -
ClassMembersToStrVector()
Sncrona - - -
Ncopy
Sncrona
- - -
Num()
Sncrona
- - -
Str()
Sncrona
- - -
Str2Asc()
Sncrona
- - -
StrGetElement()
Sncrona
- - -
StrLeft()
Sncrona
- - -
StrLen()
Sncrona
- - -
StrLower()
Sncrona
- - -
StrRChr()
Sncrona
- - -
StrRight()
Sncrona
- - -
StrSetElement()
Sncrona
- - -
StrStr()
Sncrona
- - -
StrStrPos()
Sncrona
- - -
StrTrim()
Sncrona
- - -
IWS 20/06/2007

InduSoft Web Studio

Pgina 518
Funes String Execuo NT/2K/XP Win CE Web Client
StrTrimAll()
Sncrona
- - -
StrUpper()
Sncrona
- - -
ValueToChar()
Sncrona
- - -
ValueWToChar()
Sncrona
- - -

Funes Data & Hora Execuo NT/2K/XP Win CE Web Client
ClockGetDate()
Sncrona
- - -
ClockGetDayOfWeek()
Sncrona
- - -
ClockGetTime()
Sncrona
- - -
DateTime2Clock()
Sncrona
- - -
GetClock()
Sncrona
- - -
Hour2Clock()
Sncrona
- - -
SetSystemDate()
Sncrona
- - -
SetSystemTime()
Sncrona
- - -

Funes
Trigonomtricas
Execuo NT/2K/XP Win CE Web Client
Acos()
Sncrona
- - -
Asin()
Sncrona
- - -
Atan()
Sncrona
- - -
Cos()
Sncrona
- - -
Cot()
Sncrona
- - -
Pi()
Sncrona
- - -
Sin()
Sncrona
- - -
Tan()
Sncrona
- - -

Abrindo e Fechando
Funes do Windows
CloIf()
Assncrona
-
IWS 20/06/2007

InduSoft Web Studio

Pgina 519
Open()
Assncrona
- - -
OpenPrevious()
Assncrona
- - -

IWS 20/06/2007

InduSoft Web Studio

Pgina 520

Funes de Segurana Execuo NT/2K/XP Win CE Web Client
BlockUser()
Sncrona
- - -
CreateUser()
Sncrona
- - -
GetUserNames()
Sncrona
- -
GetUserState()
Sncrona
- - -
RemoveUser()
Sncrona
- - -
SetPassword()
Sncrona
- - -
UnblockUser()
Sncrona
- - -

Funes do Mdulo
Activity
AppActivate()
Assncrona
- - -
AppIsRodando()
Sncrona
- - -
AppPostMessage()
Sncrona
- - -
AppSendKeys()
Sncrona
-
CleanReadQueue()
Sncrona
-
CloseSplashWindow()
Sncrona
-
EndTask()
Assncrona
-
ExitWindows()
Assncrona
-
IsScreenOpen()
Sncrona
- -
IsTaskRodando()
Sncrona
-
IsViewerInFocus()
Sncrona
-
KeyPad()
Assncrona
- - -
LogOff()
Assncrona
- - -
LogOn()
Assncrona
- - -
Math()
Sncrona
- -
PostKey()
Sncrona
- - -
Recipe()
Sncrona
- -
Report()
Sncrona
- - -
IWS 20/06/2007

InduSoft Web Studio

Pgina 521
Funes do Mdulo
Activity
SendKeyObject()
Sncrona
-
SetAppPath()
Sncrona
-
SetKeyboardLanguage()
Sncrona
- - -
SetViewerInFocus()
Sncrona
-
SetViewerPos()
Sncrona
-
ShutDown()
Sncrona
- -
StartTask()
Assncrona
-
ViewerPostMessage()
Assncrona
- - -
Wait()
Sncrona
- - -
WinExec()
Assncrona
- - -
WinExecIsRunning()
Sncrona
- - -

Funes de Arquivo Execuo NT/2K/XP Win CE Web Client
DeleteOlderFiles()
Sncrona
- - -
DirCreate()
Sncrona
- -
DirDelete()
Sncrona
- -
DirLength()
Sncrona
- -
DirRename()
Sncrona
- -
FileCopy()
Sncrona
- - -
FileDelete()
Sncrona
- - -
FileLength()
Sncrona
- - -
FileRename()
Sncrona
- - -
FileWrite()
Sncrona
- - -
FindFile()
Sncrona
- - -
FindPath()
Sncrona
- - -
GetFileAttributes()
Sncrona
- - -
GetFileTime()
Sncrona
- - -
IWS 20/06/2007

InduSoft Web Studio

Pgina 522
GetLine()
Sncrona
- - -
Hst2Txt()
Assncrona
-
Hst2TxtIsRodando()
Sncrona
-
Print()
Assncrona
- -
RDFileN()
Sncrona
- - -

Funes Grficas Execuo NT/2K/XP Win CE Web Client
PrintSetup()
Assncrona
- - -
PrintWindow()
Assncrona
- -
RGBColor()
Sncrona
- - -
RGBComponent()
Sncrona
- - -

Funes de Traduo Execuo NT/2K/XP Win CE Web Client
Ext()
Sncrona
- - -
SetTranslationFile()
Sncrona
- - -

Funes Multimdia Execuo NT/2K/XP Win CE Web Client
Play()
Sncrona/Assncrona
- - -

Funes System Info. Execuo NT/2K/XP Win CE Web Client
DbVersion()
Sncrona
- - -
GetAppHorizontalResolution()
Sncrona
-
GetAppPath()
Sncrona
- -
GetAppVerticalResolution()
Sncrona
-
GetComputerIP()
Sncrona
- - -
GetComputerName()
Sncrona
- -
GetFreeMemoryCE(optnumType)
Sncrona
-
GetHardKeyModel()
Sncrona
-
GetHardKeySN()
Sncrona
-
GeDicaAll()
Sncrona
- - -
IWS 20/06/2007

InduSoft Web Studio

Pgina 523
Funes System Info. Execuo NT/2K/XP Win CE Web Client
GetMemoryCE(optnumType)
Sncrona
-
GetNetMACID()
Sncrona
- -
GetOS()
Sncrona
- - -
GetPrivateProfileString()
Sncrona
- - -
GetProductPath()
Sncrona
- - -
GetScrInfo()
Sncrona
- - -
GetServerHostName
Sncrona
-
GetTickCount()
Sncrona
- - -
InfoAppAlrDir()
Sncrona
- - -
InfoAppHSTDir()
Sncrona
- - -
InfoDiskFree()
Sncrona
- -
InfoResources()
Sncrona
- - -
IsActiveXReg()
Sncrona
-
KeyPad()
Assncrona
- - -
NoInputTime()
Sncrona
-
ProductVersion()
Sncrona
- - -
SaveAlarmFile()
Sncrona
- -
SetAppAlarmPath()
Sncrona
- -
SetAppHSTPath()
Sncrona
- - -
SetDataFormat()
Sncrona
- - -
SetWebConfig()
Sncrona
- -

Funes Loop Execuo NT/2K/XP Win CE Web Client
For() & Next
NA
- -

Funo Database
Access
ForceTagChange
NA
- -

Funes ODBC Execuo NT/2K/XP Win CE Web Client
IWS 20/06/2007

InduSoft Web Studio

Pgina 524
Funes ODBC Execuo NT/2K/XP Win CE Web Client
ODBCBeginTrans()
Sncrona
-
ODBCBindCol()
Sncrona
-
ODBCCanAppend()
Sncrona
-
ODBCCanTransact()
Sncrona
-
ODBCCanUpdate()
Sncrona
-
ODBCCloIf()
Sncrona
-
ODBCCommitTrans()
Sncrona
-
ODBCDelete()
Sncrona
-
ODBCExecuteSQL()
Sncrona
-
ODBCInsert()
Sncrona
-
ODBCIsBOF()
Sncrona
-
ODBCIsDeleted()
Sncrona
-
ODBCIsEOF()
Sncrona
-
ODBCIsFieldNull()
Sncrona
-
ODBCIsFieldNullable()
Sncrona
-
ODBCMove()
Sncrona
-
ODBCMoveFirst()
Sncrona
-
ODBCMoveLast()
Sncrona
-
ODBCMoveNext()
Sncrona
-
ODBCMovePrev()
Sncrona
-
ODBCOpen()
Sncrona
-
ODBCQuery()
Sncrona
-
ODBCRollback()
Sncrona
-
ODBCSetFieldNull()
Sncrona
-
ODBCSetFilter()
Sncrona
-
ODBCSetSort()
Sncrona
-
ODBCUnbindCol()
Sncrona
-
ODBCUpdate()
Sncrona
-
IWS 20/06/2007

InduSoft Web Studio

Pgina 525

Funes Email Execuo NT/2K/XP Win CE Web
Client
CNFEmail()
Sncrona
- - -
GetStatussendEmailExt()
Sncrona
- - -
SendEmail()
Sncrona
- - -
SendEmailExt()
Assncrona
- - -

Funes Dial-Up Execuo NT/2K/XP Win CE Web
Client
DialErro()
Sncrona
- -
DialGetClienDica()
Sncrona
- -
DialGetServerIP()
Sncrona
-
DialStatus()
Sncrona
- -
DialUp()
Assncrona
- -
DialUpToCE()
Assncrona
-
FindAllDevices()
Sncrona
- -
FindModem()
Sncrona
- -
HangUp()
Sncrona
- -
PhoneDialUp(strPhoneNumber,
OptStrModemName)
Assncrona
-
PhoneDisableListen(optStrModemName)
Sncrona
-
PhoneEnableListen(OptStrModemName)
Sncrona
-
PhoneHangUp(OptStrModemName)
Assncrona
-
PhoneStatus ("strStatus",
optStrModemName)
Sncrona
-

Funes ActiveX Execuo NT/2K/XP Win CE Web Client
XGet()
Assncrona
- - -
XRun()
Assncrona
- - -
XSet()
Assncrona
- - -

IWS 20/06/2007

InduSoft Web Studio

Pgina 526
Funes Event Logger Execuo NT/2K/XP Win CE Web Client
SendEvent()
Sncrona
- - -

Funes FTP Execuo NT/2K/XP Win CE Web Client
CNFFtp() Sncrona - - -
ftpGet() Assncrona - - -
ftpPut() Assncrona - - -
ftpStatus() Sncrona - - -

Funes Database Execuo NT/2K/XP Win CE Web Client
ForceTagChange()
Sncrona
- - -
SyncAlarm()
Assncrona
- -
SyncEvent()
Assncrona
- -
SyncTrend()
Assncrona
- -
SyncAlarmStatus()
Sncrona
- -
SyncEventStatus()
Sncrona
- -
SyncTrendStatus()
Sncrona
- -

IWS 20/06/2007

InduSoft Web Studio

Pgina 527
Prottipos e Descries de Funes
A funo Tags Name utilizada no IWS dever estar de acordo com a seguintes sintaxes:
num[Name]: Tag numrico ou valor
str[Name]: Tag string ou valor
tag[Name]: Nome do Tag
optNum[Name]: Tag numrico 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 parmetro da funo do IWS.
Nota:
Esses prottipos dependem de tags dinmicos utilizados para passer valores para
Funes; porm, pode-se inserir valores estticos nessas funes. Para substituir
valores estticos nessas funes. Para substituir tag string com strings de carater
esttico, insira o string entre aspas (por exemplo, insira ABCDEFG ao invs de
strTag). Pode-se tambm substituir nmeros estticos por tags numricos (por
exemplo, insira 45.6543 ao invs de numTag).

IWS 20/06/2007

InduSoft Web Studio

Pgina 528
Funes Log Message
Essa seo descreve a funo Log Message do IWS, Trace(strOutputMessage).
Trace(strOutputMessage)

Grupo Log Message
Execuo Sncrona
Windows NT/2K/XP Suportado
Windows CE Suportado
Web Thin Client No suportado

Descrio: Exibe os contedos de strOutputMessage na janela LogWin.
Parameter: Essa funo aceita o seguinte parmetro:
StrOutputMessage
Tag String contendo uma mensagem a ser exibida em
LogWin

Exemplos:
Nome do Tag Expresso
Trace( Starting Step 5 ) // Iniciar passo 5 exibe-se na janela LogWin.
Trace(Date) // Os contedos do tag Date exibe-se na janela LogWin.

Nota:
Essa funo til para correo de erros. Por exemplo, Caso voc deseje saber
quando o IWS estar executando um script math especfico.

D Dica:
Pode-se concatenar texto, expresses e valores de tag para compor o parmetro
strOutputMessage. Por exemplo,
Trace(The tag second has the value+second+ and the Internal Clock =
+GetTickCount( ))

IWS 20/06/2007

InduSoft Web Studio

Pgina 529
Funes Aritimticas
Essa seo descreve as seguintes funes Aritimticas 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 Aritimtica
Execuo Sncrona
Web Thin Client Suportado

Descrio: Executa a funo de valor Absoluto nos contedos do tag numValue.
Parmetros:
numValue Tag Integer ou Tag Real contendo o nmero do qual a funo pega o
valor absoluto.

Valores de Retorno: Resultado numrico para a funo de valor Absoluto.
Exemplos:
Nome
do Tag
Expresso
Tag ABS(-54.9788) // Valor de retorno = 54.9788
Tag ABS(numValue) // Valor de retorno = valor absoluto do nmero no tag
numValue.

IWS 20/06/2007

InduSoft Web Studio

Pgina 530
Div(numNumerator, numDenominator)

Grupo Aritimtica
Execuo Sncrona

Descrio: Divide o valor em numNumerator pelo valor de numDenominator e retorna somente
o nmero inteiro total, omitindo o restante.
Parmetros:
numNumerator Tag Integer ou Real contendo o numerador de uma funo.
numDenominator Tag Integer ou Real contendo o denominador de uma funo.

Valores de Retorno: Resultado numrico de uma funo como um inteiro.
Exemplos:
numValue Div(100, 8) // Retorna o valor 12.5
numValue Div(16, 4) // Retorna o valor 4
numValue Div(100,12.5) //Retorna o valor 8

D Dica:
Utilize a funo MOD( ) para obter o restante da diviso.

Format (strFlag, numValue)

Grupo Aritimtica
Execuo Sncrona

Descrio: Modifica o formato de um valor numrico, de acordo com o flag.
IWS 20/06/2007

InduSoft Web Studio

Pgina 531
Parmetros:
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 maiscula)
o: Octal
b: Binrio
f: Float
e: Notao cientfica (e em letra minscula)
E: Notao cientfica (E em letra maiscula)
g: Arredonda o valor (e em letra minscula, quando aplicvel)
G: Arredonda o valor (E em letra minscula, quando aplicvel)
s: String
c: caractere ASCII
h: Hora (hh:mm:ss)
m (Aplicvel para flags d, x, X, o, b, f, e, E, g, G, s, c, and h): Copnfigura o
nmero mnimo de caracteres de retorna pela funo, adicionando espaos em
branco esquerda do valor de retorno ou 0 (zero) (veja Exemplos).
n (Aplicvel para flags f, e, E, g, e G): Configura o nmero mnimo de
caracteres decimais para valores de retorno flutuantes retornados
pela funo.
numValue Valor numrico a ser formatado.

Valores de Retorno: Valor String formatado de acordo com os parmetros configurados em uma
funo.
Exemplos:
Tag Format("%d",12.34) // valor de retorno = 12
Tag Format("%04d",12.34) // valor de retorno = 0012
Tag Format("%4d",12.34) // valor de retorno = 12
Tag Format("%x",26) // valor de retorno = 1a
Tag Format("%04x",26) // valor de retorno = 001a
Tag Format("%4x",26) // valor de retorno = 1a
Tag Format("%X",26) // valor de retorno = 1A
Tag Format("%04X",26) // valor de retorno = 001A
Tag Format("%4X",26) // valor de retorno = 1A

IWS 20/06/2007

InduSoft Web Studio

Pgina 532

Tag Format("%o",16) // valor de retorno = 20
Tag Format("%04o",16) // valor de retorno = 0020
Tag Format("%4o",16) // valor de retorno = 20
Tag Format("%b",2) // valor de retorno = 10
Tag Format("%4b",2) // valor de retorno = 0010
Tag Format("%04b",2) // valor de retorno = 0010
Tag Format("%0.1f",12.34) // valor de retorno = 12.3
Tag Format("%e",12.34) // valor de retorno = 1.234000e+001
Tag Format("%0.1e",12.34) // valor de retorno = 1.2e+001
Tag Format("%E",12.34) // valor de retorno = 1.234000E+001
Tag Format("%0.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

IWS 20/06/2007

InduSoft Web Studio

Pgina 533

Tag Format("%0.1G",12.34) // valor de retorno = 1E+001
Tag Format("%0.2G",12.34) // valor de retorno = 12
Tag Format("%0.3G",12.34) // valor de retorno = 12.3
Tag Format("%s",12.34) // valor de retorno = 12
Tag Format("%04s",12.34) // valor de retorno = 0012
Tag Format("%4s",12.34) // valor de retorno = 12
Tag Format("%c",97) // valor de retorno = a
Tag Format("%4c",97) // valor de retorno = a
Tag Format("%04c",97) // valor de retorno = 000a
Tag Format("%h",30) // valor de retorno = 00:00:30

Nota:
A funo (strFlag, numValue) permite que os mesmo flags sigma o smbolo %
utilizado para a funo C padro printf( ); porm, pode-se formatar somente um
valor em cada clula.

D Dica:
A funo Format( ) ser especialmente til ao formatar o nmero de caracteres para
valores a serem impressos em relatrios. Tambm, voc dever utilizar essa funo
para converter o nmero de segundos no seguinte formato:
hh:mm:ss(strFlag =%h)
Os parmetros h e m so opcionais.

IWS 20/06/2007

InduSoft Web Studio

Pgina 534
GetBit(tagName, numBitNumber)

Grupo Aritimtica
Execuo Sncrona

Descrio: Isola um nico bit em um tag numrico
Parmetros:
tagName O nome de um Tag Integer onde o valor do bit pego.
numBitNumber Um tag numrico que suporta o nmero do bit a ser isolado.
(031)

Valores de Retorno: Retorna o valor numrico (0 ou 1) que corresponde ao valor do bit isolado.
Exemplos:
Tag GetBit(numSource, 4) //Caso o tag numSource contenha o valor 15,
essa funo dever retornar o valor 0.
Tag GetBit(numSource,1) //Caso o tag numSource contenha o valor 19,
essa funo dever retornar o valor 1.

D Dica:
Pode-se utilizar o campo Bit para ler/registrar valores de bits especficos em um tag
integer.
Por exemplo, insira Second->b0 para acessar LSB (Least Significant Bit do Segundo
Tag), e Second->b31 para acessar MSB (Most Significant Bit do Segundo tag).

IWS 20/06/2007

InduSoft Web Studio

Pgina 535
Mod(numNumerator, numDenominator)

Grupo Aritimtica
Execuo Sncrona

Descrio: Divide o valor de numNumerator pelo valor de numDenominiator somente, e retorna
o restante como um nmero real.
Parmetros:
numNumerator Tag Integer ou Real contendo o numerador de uma funo.
numDenominator Tag Integer ou Real contendo o numerador de uma funo.

Valores de Retorno: Retorna o restante da diviso de numNumerator por numDenominator.
Exemplos:
Tag Mod(50, 4) // Valor de retorno = 2
Tag Mod(16,4) // Valor de retorno = 0
Tag Mod(100, 8.2) // Valor de retorno = 1.600

Nota:
Utilize a funo DIV( ) para obter o valor inteiro da diviso.

Pow(numBase, numExponent)

Grupo Aritimtica
Execuo Sncrona

Descrio: Retorna o resultado de numBase para numExponent.
IWS 20/06/2007

InduSoft Web Studio

Pgina 536
Parmetros:
numBase Tag Integer ou Real contendo a base de uma funo.
numExponent Tag Integer ou Real contendo o Expoente de uma funo.

Valores de Retorno: Retorna o resultado de base para o expoente.
Exemplos:
Tag Pow(2, 3) // Valor de retorno = 8
Tag Pow(10,4) // Valor de retorno = 10000

ResetBit(tagName, numBitNumber)

Grupo Aritimtica
Execuo Sncrona

Descrio: Configura um bit nico em um tag numrico para 0.
Parmetros:
tagName Name de um Tag Integer onde o valor do bit ser reiniciado.
numBitNumber Tag numrico que suporta o nmero do bit a ser reiniciado.
(031)

Valores de Retorno:
0 Sem Erro
1 Parmetro invlido
2 Tag no existe

Exemplos:
Tag ResetBit(numSource, 4) //Caso o tag numSource contenha o valor
16, essa funo dever retornar o valor 0 e numSource dever suportar
o valor 0.
IWS 20/06/2007

InduSoft Web Studio

Pgina 537
Tag ResetBit(numSource,1) //Caso o tag numSource contenha o valor 19,
essa funo dever retornar o valor 0 and numSource dever suportar
o valor 17.

Nota:
Para inserir o nome do tag integer diretamente (ao invs da utilizao do parmetro
tagName) deve-se inserir o nome entre aspas duplas. Por exemplo,
SetBit(Second,1).

D Dica:
Pode-se utilizar o campo Bit para ler/registrar valores de bits especficos em um tag
integer. Por exemplo, insira Second->b0 para acessar LSB (Least Significant Bit do
Segundo tag), e Second->b31 para acessar MSB (Most Significant Bit do Segundo
tag).

Round(numValue)

Grupo Aritimtica
Execuo Sncrona

Descrio: Arredonda numValue para o inteiro mais prximo.
Parmetros:
numValue Um tag Real que suporta o valor a ser arredondado.

Valores de Retorno: Retorna o resultado inteiro da funo de arredondamento.
Exemplos:
Tag Round(345.87) // Valor de retorno = 346
Tag Round(65.323) // Valor de retorno = 65

SetBit(tagName, numBitNumber)

Grupo Aritimtica
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 538

Descrio: Configura um bit nico em um tag numrico para 1.
Parmetros:
tagName Nome de um tag Integer onde o valor do bit est configurado.
numBitNumber Tag numrico suportando o nmero do bit a ser configurado.
(031)
Valores de Retorno:
0 Sem Erro
1 Parmetro invlido
2 Tag no existe

Exemplos:
Tag GetBit(numSource, 4) //Caso o tag numSource contenha o valor 0,
o valor 16.
Tag GetBit(numSource,1) //Caso o tag numSource contenha o valor 17,
o valor 19.

Nota:
Para inserir o nome do tag integer diretamente (ao invs de utilizar o parmetro
tagName) deve-se inserir o nome entre aspas duplas. Por exemplo,
SetBit(Second,1).

D Dica:
Pode-se tambm utilizar o campo Bit para ler/registrar valores de bits especficos de
um tag integer. Por exemplo, insira Second->b0 para acessar LSB (Least Significant
Bit de um segundo tag), e Second->b31 para acessar MSB (Most Significant Bit do
Segundo tag).

SQRT(numValue)

Grupo Aritimtica
IWS 20/06/2007

InduSoft Web Studio

Pgina 539
Execuo Sncrona

Descrio: Obtm a raiz quadrada de numValue.
Parmetros:
NumValue Tag Integer ou Real a ser tirado a raiz quadrada.

Valores de Retorno: Retorna a raiz quadrada do valor no tag numValue.
Exemplos:
Tag SQRT(25) // Retorna o valor 5
Tag SQRT(67) // Retorna o valor 8.185353

Nota:
Caso numValue tenha um valor negativo, quando essa funo retorna o valor 0,
configura a qualidade do tag de retorno para BAD.

Swap16(numValue)

Grupo Aritimtica
Execuo Sncrona
Windows CE No suportado

Descrio: Inverte os dois bytes mais baixos de um tag.
Parmetros:
numValue Tag Integer que suporta o valor numrico de bytes a serem
invertidos.

Valores de Retorno: Retorna o valor numrico aps inverter os bytes.
Exemplos:

IWS 20/06/2007

InduSoft Web Studio

Pgina 540
Tag Swap16(16) // 16 = 0000000000010000 em Binrio.
Valor de retorno = 4096 = 0001000000000000 em Binrio.
Tag Swap16(43760) // 43760 = 1010010111110000 em Binrio.
Valor de retorno = 61610 = 1111000010100101 em Binrio.

Swap32(numValue)

Grupo Aritimtica
Execuo Sncrona

Descrio: Inverte duas palavras em um tag.
Parmetros:
numValue Tag Integer que suporta o valor numrico de palavras a serem
invertidas.

Valores de Retorno: Retorna o valor numrico aps inverter as palavras.
Exemplos:
Tag Swap32(16) // 16 = 00000000000000000000000000010000 em
Binrio.
Valor de retorno = 1048576 = 00000000000100000000000000000000
em Binrio.
Tag Swap32(246333120) // 286333120 =
1010101010101010101111111100000000 em Binrio. Valor de
retorno = -1094709586= 11111111000000001010101010101010 em
Binrio.

Trunc(numValue)

Grupo Aritimtica
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 541

Descrio: Trunca o valor de numValue.
Parmetros:
numValue Tag Real a ser truncada.

Valores de Retorno: Retorna a poro inteira do valor do nmero real de numValue.
Exemplos:
Tag Trunc(234.987) // Valor de retorno = 234
Tag Trunc(-3465.9) // Valor de retorno = -3465.9

IWS 20/06/2007

InduSoft Web Studio

Pgina 542
Funes Estatsticas
Essa seo descreve as seguintes funes Estatsticas 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 Estatstica
Execuo Sncrona

Descrio: Calcula o valor da mdia de um conjunto de nmeros.
Parmetros:
numValue (1N) Tag Integer ou Real contendo os nmeros para tirar as mdias.
tagArray Nome do tag array (Real ou Integer) contendo os valores dos
quais tirar as mdias.
numSample Tag Integer contendo o nmero de elementos array a serem
tirados a mdia.
optnumIgnore Tag Integer ou Real opcional contendo o valor a ser ignorado no
clculo da mdia.

Valores de Retorno: Retorna a mdia dos valores.
Exemplos:
Tag Avg(1,2.34,5,7,4,8,9.4) // Valor de retorno = 5.248571
Tag Avg(1, 5, -9, 0, 5, 3) // Valor de retorno = 0.833333
Tag Avg(tagArray[1],3) // Se tagArray[1]=10, tagArray[2]=20 and
tagArray[3]=60, o Valor de retorno = 30
IWS 20/06/2007

InduSoft Web Studio

Pgina 543
Tag Avg(tagArray[1],3,10) // Se tagArray[1]=10, tagArray[2]=20 and

Nota:
Essa funo possui dois formatos:
Caso o primeiro parmetro seja um Tag numrico ou valor, voc dever utilizar os
formatos
Avg(numValue1, numValue2, , numValueN).
Caso o primeiro parmetro 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 Estatstica
Execuo Sncrona

Descrio: Retorna o mximo valor a ser configurado.
Parmetros:
numValue (1N) Tag Integer ou Real contendo os nmeros a serem analisados.
tagArray Name do tag array (Real ou Integer) contendo os valores a
serem analisados.
analisados.
optnumIgnore Tag Integer ou Real contendo o valor a ser ignorado na anlise.

Valores de Retorno: Retorna o mximo valor a ser configurado.
Exemplos:
Tag Max(1,2.34,5,7,4,8,9.4) // Valor de retorno = 9.4
Tag Max(1, 5, -9, 0, 5, 3) // Valor de retorno = 5
IWS 20/06/2007

InduSoft Web Studio

Pgina 544
Tag Max(tagArray[1],3) // Se tagArray[1]=10, tagArray[2]=20 and
Tag Max(tagArray[1],3,10) // Se tagArray[1]=10, tagArray[2]=20 and

Nota:
formatos
Max(numValue1, numValue2, , numValueN).
voc dever utilizar os formatos Max(tagArray, numSample, optnumIgnore).

Min(numValue1, numValue2, , numValueN)
Min(tagArray, numSample, optnumIgnore)

Grupo Estatstica
Execuo Sncrona

Descrio: Retorna o valor mnimo de um conjunto de nmeros.
Parmetros:
numValue (1N) Tag Integer ou Real contendo os nmeros a serem analisados.
tagArray Nome de um tag array (Real ou Integer) contendo os valores a
serem analisados.
analisados.
optnumIgnore Tag Integer ou Real contendo um valor a ser ignorado na
anlise.

Valores de Retorno: Retorna o valor mnimo de um conjunto.
Exemplos:
Nome
do Tag
Expresso
Tag Min(1,2.34,5,7,4,8,9.4) // Valor de retorno = 1
IWS 20/06/2007

InduSoft Web Studio

Pgina 545
Tag Min(1, 5, -9, 0, 5, 3) // Valor de retorno = -9
Tag Min(tagArray[1],3) // Se tagArray[1]=10, tagArray[2]=20 e tagArray[3]=60,
o Valor de retorno = 10
Tag Min(tagArray[1],3,10) // Se tagArray[1]=10, tagArray[2]=20 e

Nota:
formatos
Min(numValue1, numValue2, , numValueN).
voc dever utilizar os formatos Min(tagArray, numSample, optnumIgnore).

Rand()

Grupo Estatstica
Execuo Sncrona

Descrio: Gera um nmero randomizado entre 0 e 1.
Valores de Retorno: Retorna um nmero real entre 0 e 1.
Exemplos:
Tag Rand() // Valor de retorno = ?, Onde: 0<?<1

IWS 20/06/2007

InduSoft Web Studio

Pgina 546
Funes Logartimicas
Essa seo descreve as seguintes funes Logartimicas do InduSoft Web Studio:
Exp(numValue)
Log(numValue)
Log10(numValue)
Exp(numValue)

Grupo Logartimico
Execuo Sncrona

Descrio: Calcula o valor de e (e = 2.718282) elevado a potncia de numValue
Parmetros:
NumValue Tag Integer ou Real contendo o expoente de e.

Valores de Retorno: Retorna o valor de e^(numValue).
Exemplos:
Tag Exp(1)// Valor de retorno = 2.718282
Tag Exp(5.25896) // Valor de retorno = 192.281415

Log(numValue)

Grupo Logartimico
Execuo Sncrona

Descrio: Calcula o log natural de numValue
Parmetros:
NumValue Tag Integer ou Real do qual retirado o log natural.

Valores de Retorno: Retorna o valor de ln(numValue).
IWS 20/06/2007

InduSoft Web Studio

Pgina 547
Exemplos:
Tag Log(2.718282)// Valor de retorno = 1
Tag Log(100) // Valor de retorno = 4.605170

Nota:
Caso numValue possui um valor negativo, essa funo retorna o valor 0 e configura
a qualidade do tag de retorno para BAD.

Log10(numValue)

Grupo Logartimico
Execuo Sncrona

Descrio: Calcula o log na base 10 de numValue.
Parmetros:
NumValue Tag Integer ou Real, do qual retirado o log na base 10.

Valores de Retorno: Retorna o valor de log10(numValue).
Exemplos:
Tag Log10(1000)// Valor de retorno = 3
Tag Log10(43.05) // Valor de retorno = 1.633973

Nota:
Caso numValue possua um valor negativo, essa funo retornar o valor 0 e
configurar a qualidade do tag de retorno para BAD.

IWS 20/06/2007

InduSoft Web Studio

Pgina 548
Funes Lgicas
Essa seo descreve as seguintes funes Lgicas do InduSoft Web Studio:
FalIf(numExpression)
If(numExpression, numThen, optnumElse)
True(numExpression)
FalIf(numExpression)

Grupo Lgico
Execuo Sncrona

Descrio: Determina se o contedo de numExpression Logicamente falso.
Parmetros:
numExpression Tag ou Expresso a ser utilizado em uma funo.

Valores de Retorno:
0 Caso tag ou Expresso no seja logicamente falsa.
1 Caso tag ou Expresso seja logicamente falsa.

Exemplos:
Tag FalIf(1)// Valor de retorno = 0
Tag FalIf(5 < 2) // Valor de retorno = 1

D Dica:
Essa funo ser especialmente til caso voc necessite retornar o valor 0 quando a
Expresso retorna qualquer valor diferente de 0.

IWS 20/06/2007

InduSoft Web Studio

Pgina 549
If(numExpression, numThen, optnumElse)

Grupo Lgico
Execuo Sncrona

Descrio: Determina se os contedos de numExpression so logicamente verdadeiros, e
retorna o valor de numThen ou optnumElse em concordncia.
Parmetros:
numExpression Tag ou Expresso utilizada como condio em uma funo.
numThen Tag ou Expresso utilizado caso a condio seja logicamente
verdadeira.
optnumElse Tag opcional ou Expresso utilizado caso a condio 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 no h
optnumElse em uma funo.

Exemplos:
Tag If(5>4,10, 6)// Valor de retorno = 10
Tag If(5<2, 0, 2) // Valor de retorno = 2
Tag If(3=9, 67) // No valor de retorno. (Tag retm valor anterior.)

D Dicas:
O argumento numThen pode ser uma outra funo, incluindo a funo If(). Portanto,
pode-se utilizar funes If() em cascata. Por exemplo, if(TagA>TagB,If(TagA<TagC,1,
2),3).
O parmetro numExpression pode ser uma combinao de demonstraes lgicas
(AND, OR, e NOT). Por exemplo, If(TagA>TagB AND TagA=10,1,0).

IWS 20/06/2007

InduSoft Web Studio

Pgina 550
True(numExpression)

Grupo Lgico
Execuo Sncrona

Descrio: Determina se os contedos de numExpression so logicamente verdadeiros.
Parmetros:
numExpression Tag ou Expresso a ser utilizado em uma funo.

Valores de Retorno:
0 Caso tag ou Expresso no seja logicamente verdadeira.
1 Caso tag ou Expresso seja logicamente verdadeira.

Exemplos:
Tag True(1)// Valor de retorno = 1
Tag True(5 < 2) // Valor de retorno = 0

D Dica:
Essa funo ser especialmente til caso voc necessite retornar o valor 1 quando a
expresso retorna um valor diferente de 0.

IWS 20/06/2007

InduSoft Web Studio

Pgina 551
Funes String
Essa seo descreve as seguintes funes 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)
IWS 20/06/2007

InduSoft Web Studio

Pgina 552
TABELAS ASCII
Caractere (0 - 127)
Cdigo Char Cdigo Char Cdigo Char Cdigo Char
0 32 [space] 64 @ 96 `
1 33 ! 65 A 97 a
2 34 " 66 B 98 b
3 35 # 67 C 99 c
4 36 $ 68 D 100 d
5 37 % 69 E 101 e
6 38 & 70 F 102 f
7 39 ' 71 G 103 g
8 ** 40 ( 72 H 104 h
9 ** 41 ) 73 I 105 i
10 ** 42 * 74 J 106 j
11 43 + 75 K 107 k
12 44 , 76 L 108 l
13 ** 45 - 77 M 109 m
14 46 . 78 N 110 n
15 47 / 79 O 111 o
16 48 0 80 P 112 p
17 49 1 81 Q 113 q
18 50 2 82 R 114 r
19 51 3 83 S 115 s
20 52 4 84 T 116 t
21 53 5 85 U 117 u
22 54 6 86 V 118 v
23 55 7 87 W 119 w
24 56 8 88 X 120 x
25 57 9 89 Y 121 y
26 58 : 90 Z 122 z
27 59 ; 91 [ 123 {
28 60 < 92 \ 124 |
29 61 = 93 ] 125 }
30 - 62 > 94 ^ 126 ~
31 63 ? 95 _ 127

Caractere (128 255)
Cdigo Char Cdigo Char Cdigo Char Cdigo Char
128 160 [space] 192 224
129 161 193 225
130 162 194 226
IWS 20/06/2007

InduSoft Web Studio

Pgina 553
131 163 195 227
132 164 196 228
133 165 197 229
134 166 198 230
135 167 199 231
136 168 200 232
137 169 201 233
138 170 202 234
139 171 203 235
140 172 204 236
141 173 205 237
142 174 206 238
143 175 207 239
144 176 208 240
145 ' 177 209 241
146 ' 178 210 242
147 " 179 211 243
148 " 180 212 244
149 181 213 245
150 182 214 246
151 183 215 247
152 184 216 248
153 185 217 249
154 186 218 250
155 187 219 251
156 188 220 252
157 189 221 253
158 190 222 254
159 191 223 255

Nota:
** Valores 8, 9, 10, e 13 convertem para backspace, tab, linefeed, e caracteres
carriage return, respectivamente. Eles no possuem representao grfica, embora
dependendo da aplicao, possam afetar o efeito visual do texto.
indica que No suportado na plataforma atual.

Asc2Str(numChar1, numChar2, , numCharN)

Grupo String
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 554

Descrio: Converte valores decimais para seus caracteres ASCII correspondentes.
Parmetros:
numChar (1-N) Tag ou Expresso contendo um valor decimal a ser convertido
para um caractere ASCII.

Valores de Retorno: Retorna uma string de caracteres ASCII correspondentes aos valores
decimais inseridos.
Exemplos:
Tag Asc2Str(67) // Valor de retorno = C
Tag Asc2Str(83, 116, 117, 100, 105, 111) // Valor de retorno = IWS

CharToValue(tagName, tagArray)

Grupo String
Execuo Sncrona

Descrio: Converte uma string para um array de valores inteiros (utilizando bytes).
Parmetros:
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: No h valores de retorno dessa funo.
Exemplos:
CharToValue( StrTag, Array[1]) // Se StrTag = IWS then Array[1]
ser configurado para
83 (S in ASCII), Array[2] to 116 (t in ASCII) e assim por diante.

IWS 20/06/2007

InduSoft Web Studio

Pgina 555
Nota:
No possvel utilizar essa funo para caracteres UNICODE, pois converte somente
o menor byte de caracteres UNICODE.

CharToValueW(tagName, tagArray)

Grupo String
Execuo Sncrona

Descrio: Converte uma string para uma array de valores inteiros (utilizando palavras ao invs
de bytes).
Parmetros:
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: No h valores de retorno dessa funo.
Exemplos:
Nome
do Tag
Expresso
CharToValue(StrTag, Array[1]) // Se StrTag = IWS o Array[1] ser
configurado para 29779 (St in ASCII), Array[2] to 25717 (ud in ASCII) e
assim por diante.

Nota:
Essa funo pode ser til ao converter caracteres UNICODE para cdigos.

ClassMembersToStrVector (strClassTag, numStartPos, numNumPos, strArrayTag,
optBooStartPosTarget)

Grupo String
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 556

Descrio: Transfere valores de tags class para tags array.
Parmetros:
strClassTag O valor da string contendo o nome do tag class.
numStartPos Posio inicial (ndice array) de strClassTag
numNumPos Nmero de posies (indices array) a serem transferidas de
strClassTag.
strArrayTag Valor da string contendo o tag array que receber os valores de
strClassTag.
optBooStartPosTarg
et
Posio inicial (ndice array) de strArrayTag. Se omitido, o valor
padro ser 1.

Valores de Retorno:
-6 Tamanho da Array de strClassTag no grande o
suficiente para numStartPos

-5 strClassTag no um Class Tag
-4 strClassTag no encontrado
-3 strArrayTag no encontrado
-2 Tipos de dados de parmetros invlidos
-1 Nmero invlido de parmetros
0 Transferido com sucesso
Exemplos:
Nome
do Tag
Expresso
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
IWS 20/06/2007

InduSoft Web Studio

Pgina 557
da array strArrayTag seja grande o suficiente para receber todos os valores de
strClassTag.

NCopy(strSource, numStartChar, numQtdChar)

Grupo String
Execuo Sncrona

Descrio: Copia uma seo definida de uma string maior.
Parmetros:
strSource Tag String contendo a string source.
numStartChar Tag Integer contendo um nmero correspondente ao primeiro
caractere a ser copiado.
numQtdChar Tag Integer contendo o nmero de caracteres a serem copiados.

Valores de Retorno: Retorna uma string que seja parte de uma string source (como definido por
uma funo).
Exemplos:
Tag Ncopy(IWS Tag database6.1, 7, 7) // Valor de retorno = Version
Tag Ncopy(Technical Reference Manual, 0, 9) // Valor de retorno =
Technical

Nota:
O primeiro caractere na string ser assinalado como 0.

Num(strValue)

Grupo String
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 558

Descrio: Converte uma string para real.
Parmetros:
StrValue Tag String contendo o nmero de caracteres a serem
convertidos para formato real.

Valores de Retorno: Retorna o nmero (formalmente em um formato string) em formato real.
Exemplos:
Tag Num(321654.987) // Valor de retorno = 321654.987
Tag Num(5.6589626246) // Valor de retorno = 5.6589626246

Nota:
A string real no pode utilizar caracteres diferentes de nmeros (09) e um ponto
decimal (.) ou o programa retornar o valor 0.0.

Str(numValue)

Grupo String
Execuo Sncrona

Descrio: Converte um nmero para uma string.
Parmetros:
numValue Integer ou tag real contendo um nmero a ser convertido para uma
string.

Valores de Retorno: Retorna a string, em um formato real.
Exemplos:
Tag Str(321654.987) // Valor de retorno = 321654.987
Tag Str(5.65896246) // Valor de retorno = 5.658962

IWS 20/06/2007

InduSoft Web Studio

Pgina 559
Str2Asc(strChar)

Grupo String
Execuo Sncrona

Descrio: Converte um caractere ASCII para seu cdigo ASCII correspondente.
Parmetros:
strChar Tag String contendo um caractere ASCII a ser convertido para cdigo
ASCII.

Valores de Retorno: Retorna um valor decimal a ser convertido ao caractere ASCII
correspondente inserido.
Exemplos:
Tag Str2Asc(C) // Valor de retorno = 67
Tag Str2Asc(o) // Valor de retorno = 111

StrGetElement(strSource, strDelimiter, numElementNumber)

Grupo String
Execuo Sncrona

Descrio: Obtm um elemento especfico de uma string source.
Parmetros:
strSource Tag String contendo uma string source.
strDelimiter Caractere utilizado como delimitador entre os elementos.
numElementNumber Nmero do elemento a ser retornado por uma funo. O
primeiro elemento possui o nmero 1. O Segundo possui o
nmero 2, e assim por diante.

Valores de Retorno: Retorna o elemento (Valor da string) entregue a partir de strSource.
IWS 20/06/2007

InduSoft Web Studio

Pgina 560
Exemplos:
Tag StrGetElement(a|b|c, |, 2) // Valor de retorno = b
Tag StrGetElement(a,b,c, ,, 3) // Valor de retorno = c
StrLeft(strSource, numQtdChar)

Grupo String
Execuo Sncrona

Descrio: Copia o primeiro caractere de uma string maior.
Parmetros:
strSource Tag String contendo uma string source.
numQtdChar Tag Integer contendo o nmero de caracteres a serem copiados.

Valores de Retorno: Retorna uma string contendo caracteres esquerda em uma string source.
Exemplos:
Tag StrLeft(IWS Tag database6.1, 8) // Valor de retorno = IWS v
Tag StrLeft (Technical Reference Manual, 9) // Valor de retorno =
Technical

StrLen(strSource)

Grupo String
Execuo Sncrona

Descrio: Determina o comprimento da string.
IWS 20/06/2007

InduSoft Web Studio

Pgina 561
Parmetros:
strSource Tag String contendo a string.

Valores de Retorno: Retorna um inteiro que o nmero de caracteres na string.
Exemplos:
Tag StrLen(IWS Tag database6.1) // Valor de retorno = 18
Tag StrLen(Technical Reference Manual) // Valor de retorno = 26

StrLower(strSource)

Grupo String
Execuo Sncrona

Descrio: Converte uma string para caracteres em letra minscula.
Parmetros:
strSource Tag String contendo a string a ser convertida.

Valores de Retorno: Retorna a string, onde todos os caracteres esto em letra minscula.
Exemplos:
Tag StrLower(IWS Tag database6.1) // Valor de retorno = IWS Tag
database6.1
Tag StrLower(Technical Reference Manual) // Valor de retorno =
technical reference manual

StrRChr(strSource, strChrSequence)

Grupo String
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 562

Descrio: Isola a ocorrncia final de uma seqncia de caracteres junto a uma string.
Parmetros:
StrSource Tag String contendo a string source.
StrCharSequence Tag String contendo a string de referncia.

Valores de Retorno: Retorna uma string de caracetres seguindo a ltima ocorrncia de um
caractere junto a uma string source.
Exemplos:
Tag StrRChr(IWS Tag database6.1, i) // Valor de retorno = ion 5.1
Tag StrRChr(Technical Reference Manual, a) // Valor de retorno =al

StrRight(strSource, numQtdChar)

Grupo String
Execuo Sncrona

Descrio: Copia o ultimo caractere em uma string maior.
Parmetros:
StrSource Tag String contendo a string source.
NumQtdChar Tag Integer contendo o nmero de caracteres a serem copiados.

Valores de Retorno: Retorna a string contendo o caractere direita para a string source.
Exemplos:
Tag StrRight(IWS Tag database6.1, 8) // Valor de retorno = sion 5.1
Tag StrRight(Technical Reference Manual, 9) // Valor de retorno = ce
Manual

IWS 20/06/2007

InduSoft Web Studio

Pgina 563
StrSetElement(strSource, strDelimiter, numElementNumber, strValue)

Grupo String
Execuo Sncrona

Descrio: Obtm um elemento especfico de uma string source.
Parmetros:
strDelimiter Caractere utilizado como delimitador entre os elementos.
numElementNumber Nmero do elemento onde o valor da string ser registrado por
uma funo. O primeiro elemento possui o nmero 1. O
Segundo possui o nmero 2, e assim por diante.
strValue Valor da string que ser registrada a numElementNumber do
tag string strSource.

Valores de Retorno: Retorna o valor da string atualizada a partir de strValue.
Exemplos:
Tag StrSetElement(StringTag,|, 2, abcd)
Tag StrSetElement(StringTag,,, 3, defg)
StrStr(strSource, strCharSequence)

Grupo String
Execuo Sncrona

Descrio: Isola a primeira ocorrncia de uma seqncia de caracteres junto a uma string.
Parmetros:
strCharSequence Tag String contendo a string de referncia.
IWS 20/06/2007

InduSoft Web Studio

Pgina 564

Valores de Retorno: Retorna a string de caracteres seguidos da primeira ocorrncia de um
caractere junto a uma string source.
Exemplos:
Tag StrStr(IWS Tag database6.1, i) // Valor de retorno = io Version
5.1
Tag StrStr(Technical Reference Manual, a) //
Valor de retorno =al Reference Manual

StrStrPos(strSource, strCharSequence)

Grupo String
Execuo Sncrona

Descrio: Encontra a primeira ocorrncia de um caractere junto a uma string.
Parmetros:
strCharSequence Tag String contendo a string de referncia.

Valores de Retorno: Retorna um inteiro correspondente a primeira ocorrncia de um caractere
junto a uma string source.
Exemplos:
Tag StrStrPos(IWS Tag database6.1, i) // Valor de retorno = 4
Tag StrStrPos(Technical Reference Manual, a) // Valor de retorno = 7

Nota:
O primeiro caractere na string assinalado com o valor 0.

StrTrim(strReference, numOptFlag)

Grupo String
IWS 20/06/2007

InduSoft Web Studio

Pgina 565
Execuo Sncrona

Descrio: Elimina espaos do incio e final de uma string
Parmetros:
strReference Um Tag String contendo a string source.
numOptFlag Um tag integer opcional.
If numOptFlag = 0, o IWS remove espaos do incio e fim da
string.
If numOptFlag = 1, o IWS remove espaos do incio da string.
If numOptFlag = 2, o IWS remove espaos somente do final da
string.

Valores de Retorno: Retorna uma string igual a strReferance menos os caracteres de espao
especificados.
Exemplos:
Tag StrTrim(IWS Tag database6.1 ) // Valor de retorno = IWS Tag
database6.1
Tag StrTrim(IWS Tag database6.1 , 0) // Valor de retorno = IWS Tag
database6.1
database6.1
database6.1

StrTrimAll(strReference, strOptTrimChar)

Grupo String
Execuo Sncrona

Descrio: Elimina um caractere especfico de uma string inteira.
IWS 20/06/2007

InduSoft Web Studio

Pgina 566
Parmetros:
strReference Um Tag String contendo a string source.
strOptTrimChar Caractere que ser removido da string. Caso o parmetro seja
omitido, o caractere espao ser removido da string por
padro.

Valores de Retorno: Retorna uma string igual a strReferance menos os caracteres removidos
por uma funo.
Exemplos:
Tag StrTrimAll(IWS Tag database6.1 ,) // Valor de retorno = IWS Tag
database6.1
Tag StrTrimAll(IWS Tag database6.1 , .) // Valor de retorno = IWS Tag
database6.1
StrUpper(strSource)

Grupo String
Execuo Sncrona

Descrio: Converte uma string para caracteres em letras minsculas.
Parmetros:
strSource Tag String contendo a string.

Valores de Retorno: Retorna a string com todos os caracteres em letra maiscula.
Exemplos:
Tag StrUpper(IWS Tag database6.1) // Valor de retorno = IWS Tag
database6.1
Tag StrUpper(Technical Reference Manual) // Valor de retorno =
TECHNICAL REFERENCE MANUAL

IWS 20/06/2007

InduSoft Web Studio

Pgina 567
ValueToChar(tagArray, numChars)

Grupo String
Execuo Sncrona

Descrio: Converte uma string para um array de valores inteiros (utilizando bytes).
Parmetros:
tagArray Nome do tag array contendo os valores ineiros de caracteres a serem
convertidos.
NumChars Tag Integer contendo o nmero de caracteres a serem convertidos.

Valores de Retorno: Retorna uma string com caracteres definidos por valores nos tags array.
Exemplos:
Tag ValueToChar(Array, 3) // If Array[0] = 65, Array[1] = 66, e Array[2] =
67 o valor de retorno ser ABC
Tag ValueToChar(Array[10], 3) // If Array[10] = 65, Array[11] = 66, and
Array[12] = 67 o valor de retorno ser ABC

Nota:
No possvel utilizar essa funo para caracteres UNICODE, pois esse converte
somente os bytes de caracteres UNICODE.

ValueWToChar(tagArray, numChars)

Grupo String
Execuo Sncrona

Descrio: Converte uma string para um array de valores inteiros (utilizando palavras).
IWS 20/06/2007

InduSoft Web Studio

Pgina 568
Parmetros:
tagArray Nome do tag array contendo valores interios de caracteres a serem
convertidos.
numChars Tag Integer contendo o nmero de caracteres a serem convertidos.

Valores de Retorno: Retorna uma string com caracteres definidos por valores em tag arrays.
Exemplos:
Tag ValueWToChar(Array, 3) // If Array[0] = 29779, Array[1] = 25717,
and Array[2] = 28521 o valor de retorno ser IWS

Nota:
Essa funo poder ser especialmente til ao converter caracteres UNICODE para
cdigos.

IWS 20/06/2007

InduSoft Web Studio

Pgina 569
Funes Data e Hora
Essa seo descreve as seguintes funes 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
Execuo Sncrona

Descrio: Calcula a data, baseando-se em quantos segundos se passaram desde as 19:00:00
EST 12/31/1969 (colocando na conta a zona de tempo atual do computador).
Parmetros:
numSeconds Tag Integer contendo o nmero de segundos passados desde 19:00:00
ETS 12/31/1969.

Valores de Retorno: Retorna a data calculada em formato string.
Exemplos:
Tag ClockGetDate(0)// Caso computador esteja em zona de hora central.
Valor de retorno = 12/31/1969
Tag ClockGetDate(1018886359) // Caso computador esteja em zona de
hora central.
Valor de retorno = 04/15/2002

Nota:
Essa funo faz a contagem na Zona de Tempo especificada no Control Panel do
computador local.

IWS 20/06/2007

InduSoft Web Studio

Pgina 570
ClockGetDayOfTheWeek(numSeconds)

Grupo Data e Hora
Execuo Sncrona

Descrio: Calcula o dia da semana, baseando-se em quantos segundos se passaram desde as
19:00:00 EST 12/31/1969 (contando a partir da Zona de Tempo atual do computador local).
Parmetros:
numSeconds Tag Integer contendo o nmero de segundos passados desde as
19:00:00 ETS 12/31/1969

Valores de Retorno: Retorna o dia da semana (calculado em formato inteiro) como se segue:
0 = Sunday
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday
Exemplos:
Tag ClockGetDayOftheWeek(0)// Caso o computador esteja na zona de
tempo Central.
Valor de retorno = 3
Tag ClockGetDate(1018886359) // Caso o computador esteja na zona de
tempo Central.

Nota:
computador local.

IWS 20/06/2007

InduSoft Web Studio

Pgina 571
ClockGetTime(numSeconds)

Grupo Data e Hora
Execuo Sncrona

Descrio: Calcula a hora, baseando-se em quantos segundos se passaram desde as 19:00:00
EST 12/31/1969 (colocando na conta a zona de tempo atual do computador).
Parmetros:
NumSeconds Tag Integer contendo o nmero de segundos passados desde as
19:00:00 ETS 12/31/1969.

Valores de Retorno: Retorna a hora calculada em formato string.
Exemplos:
Tag ClockGetTime(0) // Caso o computador esteja na zona de tempo
Central.
Valor de retorno = 18:00:00
Tag ClockGetTime(1018886359) // Caso o computador esteja na zona de
tempo Central.
Valor de retorno = 10:59:19

Nota:
computador local.

D Dica:
Para converter o nmero de segundos estritamente em formato HH:MM:SS, voc
dever utilizar a funo Format() ao invs da funo ClockGetTime().

DateTime2Clock(strDate, strTime)

Grupo Data e Hora
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 572

Descrio: Calcula quantos segundos se passaram desde as 19:00:00 EST 12/31/1969
(colocando na conta a zona de tempo atual do computador).
Parmetros:
StrDate Tag String contendo a data a ser utilizada no clculo.
StrTime Tag String contendo a hora a ser utilizada no clculo.

Valores de Retorno: Calcula quantos segundos se passaram desde as 19:00:00 EST
12/31/1969 (colocando na conta a zona de tempo atual do computador).
Exemplos:
Tag DateTime2Clock (12/31/1969, 18:00:00) // Caso o computador
esteja na zona de tempo Central. Valor de retorno = 0
Tag DateTime2Clock (04/15/2002, 10:59:19) // Caso o computador
esteja na zona de tempo Central. Valor de retorno = 01018886359

Nota:
computador local.

GetClock()

Grupo Data e Hora
Execuo Sncrona

Descrio: Calcula quantos segundos se passaram desde as 19:00:00 EST 12/31/1969 no
momento em que a funo rodou (colocando na conta a zona de tempo atual do computador).
Valores de Retorno: Retorna o nmero de segundos que se passaram desde 19:00:00 EST
12/31/1969 no momento em que a funo rodou.

IWS 20/06/2007

InduSoft Web Studio

Pgina 573
Exemplos:
Nome
do Tag
Expresso
Tag GetClock() // Se executado s 10:59:19 AM April 15
th
2002 CST. Valor de
retorno = 101886359
Tag GetClock() // Se executado s 00:00:00 January 1st 1970 GMT. Valor de
retorno = 0

Nota:
computador local.

Hour2Clock(strTime)

Grupo Data e Hora
Execuo Sncrona

Descrio: Converte a hora do formato HH:MM:SS em segundos.
Parmetros:
strTime Tag String contendo o nmero de horas, minutos e segundos em formato
HH:MM:SS.

Valores de Retorno: Retorna o nmero de segundos equivalentes ao total de horas, minutos e
segundos especificados.
Exemplos:
Tag Hour2Clock(01:00:00) // Valor de retorno = 3600
Tag Hour2Clock(10:01:01) // Valor de retorno = 36061

SetsystemDate(strDate)

Grupo Data e Hora
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 574

Descrio: Configura a data no relgio do Sistema Operacional.
Parmetros:
strDate Tag String contendo a data em formato MM/DD/YYYY no qual ser
configurado o relgio.

Valores de Retorno: No retorna valores.
Exemplos:
SetSystemDate(04/15/2002) // Configura o relgio do sistema para
April 15
th
2002.

SetSystemTime(strTime)

Grupo Data e Hora
Execuo Sncrona

Descrio: Configura a hora no relgio do Sistema Operacional.
Parmetros:
strTime Tag String contendo a hora em formato HH:MM:SS no qual o relgio
ser configurado.

Valores de Retorno: Sem valor de retorno.
Exemplos:
SetSystemTime(15:45:18) // Configura o relgio do sistema 3:45:18
PM.

IWS 20/06/2007

InduSoft Web Studio

Pgina 575
Funes Trigonomtricas
Essa seo descreve as seguintes funes trigonomricas do InduSoft Web Studio:
ACos(numValue)
ASin(numValue)
ATan(numValue)
Cos(numAngle)
Cot(numAngle)
Pi()
Sin(numAngle)
Tan(numAngle)
ACos(numValue)

Grupo Trigonomtrica
Execuo Sncrona

Descrio: Calcula o Arco Cosseno de um valor.
Parmetros:
NumValue Tag numrico do qual Arco Cosseno ser pego.

Valores de Retorno: Retorna Arco Cosseno de numValue em radianos.
Exemplos:
Tag ACos(1) // Valor de retorno = 0.000000
Tag ACos(0) // Valor de retorno = 1.570796

ASin(numValue)

Grupo Trigonomtrica
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 576

Descrio: Calcula Arco Seno de um valor.
Parmetros:
NumValue Tag numrico, do qual Arco Seno retirado.

Valores de Retorno: Retorna Arco Seno de numValue em radianos.
Exemplos:
Tag ASin(1) // Valor de retorno = 1.570796
Tag ASin(0) // Valor de retorno = 0.000000

ATan(numValue)

Grupo Trigonomtrica
Execuo Sncrona

Descrio: Calcula o Arco Tangente de um valor.
Parmetros:
NumValue Tag numrico, do qual o Arco Tangente ser retirado.

Valores de Retorno: Retorna o Arco Tangente de numValue em radianos.
Exemplos:

Tag ATan(1) // Valor de retorno = 0.785398
Tag ATan(0) // Valor de retorno = 1.570796

Cos(numAngle)

Grupo Trigonomtrica
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 577

Descrio: Calcula o Cosseno de um valor.
Parmetros:
NumAngle Tag numrico contendo o ngulo (em radianos) do qual calcular o
Cosseno.

Valores de Retorno: Retorna o Cosseno de numAngle.
Exemplos:
Tag Cos(1.570796) // Valor de retorno = 0.000000
Tag Cos(0) // Valor de retorno = 1.000000

Cot(numAngle)

Grupo Trigonomtrica
Execuo Sncrona

Descrio: Calcula a Cotangente de um valor.
Parmetros:
NumAngle Tag numrico contendo o ngulo (em radianos) do qual calcular a
Cotangente.

Valores de Retorno: Retorna a Cotangente de numAngle.
Exemplos:
Tag Cot(0.785398) // Valor de retorno = 1.000000
Tag Cot(0) // Valor de retorno = 0.00000

IWS 20/06/2007

InduSoft Web Studio

Pgina 578
Nota:
Embora, matematicamente, a tangente de Pi seja infinita, o IWS retorna somente o
maior nmero possvel.

Pi()

Grupo Trigonomtrica
Execuo Sncrona

Descrio: Calcula Pi.
Valores de Retorno: Retorna Pi.
Exemplos:
Tag Pi() // Valor de retorno = 3.141593

Nota:
Mesmo que a funo Pi() no tenha argumentos, voc dever incluir os parnteses,
ou o IWS procurar por um Nome do Tag Pi.

Sin(numAngle)

Grupo Trigonomtrica
Execuo Sncrona

Descrio: Calcula o Seno de um valor.
Parmetros:

NumAngle Tag numrico contendo o ngulo (em radianos) do qual calcular o
Seno.

Valores de Retorno: Retorna o Seno de numAngle.
IWS 20/06/2007

InduSoft Web Studio

Pgina 579
Exemplos:
Tag Sin(0) // Valor de retorno = 0.000000
Tag Sin(1.570796) // Valor de retorno = 1.000000

Tan(numAngle)

Grupo Trigonomtrica
Execuo Sncrona

Descrio: Calcula a Tangente de um valor.
Parmetros:
NumAngle Tag numrico contendo o ngulo (em radianos) do qual calcular a
Tangente.

Valores de Retorno: Retorna a Tangente de numAngle.
Exemplos:
Tag Tan(0) // Valor de retorno = 0.00000
Tag Tan(0.785398) // Valor de retorno = 1.00000

Nota:
Embora, matematicamente, a Tangente de Pi seja infinita, o IWS retorna somente
o maior nmero possvel.

IWS 20/06/2007

InduSoft Web Studio

Pgina 580
Abrindo e Fechando Janelas
Essa seo descreve as seguintes funes 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
Execuo Assncrona

Descrio: Fecha uma tela aberta.
Parmetros:
strScreen Tag String contendo o nome do tag screen a ser fechado.

Valores de Retorno: Sem valores de retorno.
Exemplos:
Close(main)
Close(alarms)

C Ateno:
Ao abrir uma tela utilizando Replace style, as telas fecham-se automaticamente com
atributos Replace e/ou Popup que so sobrepostos pela nova tela. Nesse caso, no
necessrio chamar a funo CLOSE(strScreen).

Open(strScreen, optnumX1, optnumY1, optnumX2, optnumY2)

Execuo Assncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 581

Descrio: Abre a tela especificada.
Parmetros:
strScreen Tag String contendo o nome do tag screen a ser aberto.
optnumX1 Tag Integer opcional contm a coordenada X para o canto superior
esquerdo da tela em pixels.
optnumY1 Tag Integer opcional contm a coordenada Y para o canto superior
optnumY2 Tag Integer opcional contm a coordenada X para o canto inferior direito
da tela em pixels.

Valores de Retorno:
0 Funo executada com sucesso.
1 Funo no foi executada com sucesso.

Exemplos:
Tag Open(main)
Tag Open(alarm, 50, 50, 690, 530)

C Ateno:
Alguns Servers da Web so sensveis a letras maisculas e minsculas. Caso voc
planejar converter suas telas para formato HTML, voc dever utilizar somente
letras minsculas para o nome da tela.

OpenPrevious(numOptionalX1 , numOptionalY1 , numOptionalX2 , numOptionalY2 )

Execuo Assncrona

Descrio: Reabre a ltima tela que foi fechada.
IWS 20/06/2007

InduSoft Web Studio

Pgina 582
Parmetros:

Valores de Retorno:
0 Funo no foi executada com sucesso
1 Funo executada com sucesso

Exemplos:
OpenPrevious()
OpenPrevious0,0,800,600()
IWS 20/06/2007

InduSoft Web Studio

Pgina 583
Funes de Segurana
Essa seo descreve as seguintes funes de Segurana 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 Segurana
Execuo Sncrona

Descrio: Utilizado para bloquear um usurio existente do Sistema de Segurana.
Parmetros:
StrUserName Tag String contendo o nome do tag user a ser bloqueado.

Valores de Retorno:
0 Usurio bloqueado com sucesso
1 Nmero invlido de parmetros
2 Tipo errado de parmetro
3 Usurio no existe
4 No possvel registrar os dados com sucesso

Exemplos:
Tag BlockUser(Bob)
Tag BlockUser(Albert)

IWS 20/06/2007

InduSoft Web Studio

Pgina 584
Nota:
No possvel utilizar essa funo para criar um nome do usurio que j est sendo
utilizado na Aplicao. Usurio criados com essa funo no esto exibidos na pasta
Security no ambiente de desenvolvimento, pois esto armazenados em um banco de
dados secundrio.

D Dica:
Pode-se utilizar o programa ExtUser.exe (localizado na pasta Bin) para gerenciar os
usurios nesse banco de dados secundrio.

CreateUser(strUserName, strGrupoName, strPassword, strOptUserFullName)

Grupo Segurana
Execuo Sncrona

Descrio: Cria um novo usurio.
Parmetros:
StrUserName Tag String contendo o nome do tag do usurio a ser criado.
StrGrupoName Tag String contendo o nome do tag Grupo ao qual o usurio
pertencer.
StrPassword Tag String contendo uma senha a ser configurada.
StrOptUserFullName Tag String contendo o nome completo do usurio. Esse
parmetro opcional.

Valores de Retorno:
0 Novo usurio criado com sucesso
2 Tipo errado de parmetros
3 Usurio j existe
4 Grupo no existe
5 No possvel registrar os dados com segurana
6 No possvel utilizar a funo CreateUser()

IWS 20/06/2007

InduSoft Web Studio

Pgina 585
Exemplos:
Tag CreateUser(Bob, Admin, Chocolate)
Tag CreateUser(Albert, Engineering, EMC2)

Nota:
No possvel utilizar essa funo para criar um nome de usurio que j esteja
sendo utilizado na Aplicao. Usurios criados com essa funo no so exibidos na
pasta Security do ambiente de desenvolvimento, pois esto armazenados em um
banco de dados secundrios.

D Dica:
Pode-se utilizar o programa ExtUser.exe (localizado na pasta Bin) para gerenciar os
usurios nesse banco de dados secundrio.

GetUserState(strUserName)

Grupo Segurana
Execuo Sncrona

Descrio: Utilize para visuzalizar o status atual de um usurio selecionado.
Parmetros:
StrUserName Tag String contendo o nome do tag do usurio.

Valores de Retorno:
0 Usurio est desbloqueado
1 Usurio est bloqueado
3 Usurio no existe
4 No possvel registrar dados com segurana

IWS 20/06/2007

InduSoft Web Studio

Pgina 586
Exemplos:
Tag GetUserState(Bob)
Tag GetUserState(Albert)

GetUserNames ( tagUsers , optnumUserType , opttagGrupos )

Grupo Segurana
Execuo Sncrona

Descrio:
Parmetros:
tagUsers Nome do tag array que receber usurios
optnumUserType 0- Retorna todos os usurios
1- Somente usurios criados durante o run-time
2- Somente usurios criados com a utilizao do ambiente
de desenvolvimento
opttagGrupos Nome do tag array que receber o Grupo para cada usurio
especfico

Valores de Retorno: Nmero de usurios ou um nmero negativo que pode ser um dos
seguintes:
-2 tagUsers est invlido
-3 optnumUserType est invlido
-4 opttagGrupos est invlido
-5 Erro, funo no pode ser chamada no web thin client

Natural number set: Nmero de usurios
Exemplos:
NumberOfUsers GetUserNames("UsersArray") //Entrega usurios, armazena seus
nomes no tag UsersArray tag e o Nmero de usurios no tag
IWS 20/06/2007

InduSoft Web Studio

Pgina 587
NumberOfUsers.
NumberOfUsers GetUserNames("UsersArray", 1) //Entrega todos os usurios
criados durante o run-time, armazena seus nomes no tag
UsersArray tag e o Nmero de usurios no tag NumberOfUsers.
NumberOfUsers GetUserNames("UsersArray", 2) // Entrega todos os usurios
criados durante o run-time, armazena seus nomes no tag
UsersArray tag e o Nmero de usurios no tag NumberOfUsers.
NumberOfUsers GetUserNames("UsersArray", 2, Grupos) //Entrega todos os
usurios criados no ambiente de desenvolvimento, armazena seus
nomes no tag UsersArray e o Nmero de usurios no tag
NumberOfUsers. O nome do grupo por usurio armazenado no
tag Groups.

RemoveUser(strUserName)

Grupo Segurana
Execuo Sncrona

Descrio: Remove um usurio do sistema.
Parmetros:
StrUserName Tag String contendo o nome do tag user a ser removido.

Valores de Retorno:
0 Usurio removido com sucesso
3 Usurio no existe

Exemplos:
Tag RemoveUser(Bob)
Tag RemoveUser(Albert)
IWS 20/06/2007

InduSoft Web Studio

Pgina 588

Nota:
Pode-se utilizar essa funo para remover somente aqueles usurios criados com a
utilizao da funo CreateUser().
SetPassword(strUserName, strOpcionalNewPassword)

Grupo Segurana
Execuo Sncrona

Descrio: Utilize para especificar uma nova senha de usurio.
Parmetros:
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 Usurio est bloqueado
3 Usurio no existe
5 Operao foi cancelada

Exemplos:
Tag SetPassword(Bob)
Tag SetPassword(Albert, anemarie)

Nota:
Caso voc omitir o parmetro strOpcionalNewPassword, a funo SetPassword()
iniciar um dilogo Insert a new password,de forma que o usurio possa configurar
uma nova senha.

IWS 20/06/2007

InduSoft Web Studio

Pgina 589
UnblockUser(strUserName)

Grupo Segurana
Execuo Sncrona

Descrio: Utilize para desbloquear um usurio bloqueado no sistema.
Parmetros:
StrUserName Tag String contendo o nome do tag user a ser desbloqueado.

Valores de Retorno:
0 Usurio desbloqueado com sucesso
3 Usurio no existe

Exemplos:
Tag UnblockUser(Bob)
Tag UnblockUser(Albert)

IWS 20/06/2007

InduSoft Web Studio

Pgina 590
Funes do Mdulo Atividade
Essa seo descreve as seguintes funes Atividade do InduSoft Web Studio:
AppActivate(strAppTitle, optnumActiv)
AppIsRodando(strAppTitle)
AppPostMessage(strAppTitle, numwParam, numlParam)
AppSendKeys(strKeys1, strKeys2, ..., strKeysN)
CleanReadQueue()
CloseSplashWindow()
EndTask(strTask)
ExitWindows(numExitCdigo)
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 Mdulo Atividade
Execuo Assncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 591

Descrio: Ativa uma aplicao j aberta.
Parmetros:
StrAppTitle Tag String contendo o nome do tag da Aplicao a ser ativado.
OptnumActive Tag opcional Integer contendo o integer que corresponde a uma
opo de ativao. Veja a documentao do Windows para
mais detalhes sobre essas opes.
0 = SW_HIDE
1 = SW_SHOWNORMAL
2 = SW_SHOWMINIMIZED
3 = SW_SHOWMAXIMIZED
4 = SW_SHOWNOACTIVATE
5 = SW_SHOW
6 = SW_MINIMIZE
7 = SW_SHOWMINNOACTIVATE
8 = SW_SHOWNA
9 = SW_RESTORE (Default)

Exemplos:
AppActivate(Microsoft Word test.doc, 5)

AppIsRodando(strAppTitle)

Execuo Sncrona

Descrio: Verifica se uma aplicao est aberta e rodando.
Parmetros:
strAppTitle Tag String contendo o nome do tag Aplicao.

Valores de Retorno:
1 Aplicao est rodando.
0 Aplicao no est rodando.

IWS 20/06/2007

InduSoft Web Studio

Pgina 592
Exemplos:
Tag AppIsRunning(Microsoft Word test.doc)

AppPostMessage(strAppTitle, numwParam, numlParam)

Execuo Sncrona

Descrio: Manda uma mensagem para a aplicao ativa.
Parmetros:
strAppTitle Tag String contendo o nome do tag da aplicao.
numwParam Tag Integer contendo um integer correspondendo a mensagem do
Windows wParam
numlParam Tag Integer contendo um integer correspondendo a mensagem do
Windows lParam

Exemplos:
Tag AppPostMessage(Microsoft Word test.doc, 3, 1)

AppSendKeys(strKeys1, strKeys2, ..., strKeysN)

Execuo Sncrona

Descrio: Envia comandos de teclado para a aplicao ativa.
Parmetros:
IWS 20/06/2007

InduSoft Web Studio

Pgina 593
StrKeys (1-N) Tags String contendo os comandos de teclado a serem
utilizados.

Exemplos:
AppSendKeys(S, t, u, d, i, o, <INSIRA>)
AppSendKeys(<Alt>F)

Nota:
Pode-se especificae <ALT>, <CTRL>, ou <SHIFT> no texto para enviar um cdigo
igual aos comandos de teclado Alt, Ctrl, ou Shift. Para enviar o caractere <
especifique << no texto.

CleanReadQueue()

Execuo Sncrona

Descrio: Remove todas as atividades de leitura do mdulo de comunicao.
Exemplos:
CleanReadQueue()

Nota:
Voc no poder utilizar essa funo em novas aplicaes, embora esta funo
ainda seja vlida para aplicaes construdas em verses mais recentes do InduSoft
Web Studio.

IWS 20/06/2007

InduSoft Web Studio

Pgina 594
CloseSplashWindow()

Execuo Sncrona

Descrio: Fecha a tela de som (splash) do IWS.
Exemplos:
CloseSplashWindow()

EndTask(strTask)

Execuo Assncrona

Descrio: Pra o mdulo do IWS que esteja rodando atualmente.
Parmetros:
strTask Tag String contendo o nome do tag task para parar (dever ser um dos
seguintes):
BGTASK: Background Tasks
VIEWER: Viewer
DBSPY: Database Spy
LOGWIN: LogWin
DRIVER <DriverName>: Driver
UNIDDECL: DDE client
UNINDDE: DDE server
UNIODBC: ODBC
TCPSERVER: TCP/IP Server
TCPCLIENT: TCP/IP Client
OPCCLIENT: OPC

IWS 20/06/2007

InduSoft Web Studio

Pgina 595
Exemplos:
EndTask(Viewer)

Nota:
Para fechar um driver, voc dever utilizar os formatos de Sintaxe que se seguem:
EndTask(Driver<DriverName>)
Onde <DriverName> o nome do arquivo driver do tag .dll. Por exemplo,
EndTask(DriverMODBU)

ExitWindows(numExitCdigo)

Execuo Assncrona

Descrio: Fecha a janela de um modo especfico.
Parmetros:
numExitCdigo Tag Integer contendo um nmero (02) especificando como sair
das Janelas.
0 = Reiniciar Windows
1 = Efetuar Log Off Windows
2 = Desligar Windows

Exemplos:
ExitWindows(1)

IWS 20/06/2007

InduSoft Web Studio

Pgina 596
IsScreenOpen(strScreen)

Execuo Sncrona

Descrio: Verifica se uma tela est aberta.
Parmetros:
strScreen Tag String contendo o nome do tag screen a ser verificado.

Valores de Retorno:
0 Tela no est aberta.
1 Tela est aberta.

Exemplos:
Tag IsScreenOpen(main)

IsTaskRodando(strTask)

Execuo Sncrona

Descrio: Verifica se a tarefa est rodando.
Parmetros:
strTask Tag String contendo o nome do tag task a ser verificado.

Valores de Retorno:
0 Tarefa no est rodando.
1 Tarefa est rodando.

IWS 20/06/2007

InduSoft Web Studio

Pgina 597
Exemplos:
Tag IsTaskRunning(viewer)

IsViewerInFocus()

Execuo Sncrona

Descrio: Verifica se o mdulo Viewer est em foco na tela.
Valores de Retorno:
0 Viewer no est em foco.
1 Viewer est em foco.

Exemplos:
Tag IsViewerInFocus()

KeyPad(TagName)

Execuo Assncrona

Descrio: Abre um dilogo Keypad para registro ao tag especificado.
Parmetros:
TagName O nome do tag ao qual o Keypad ser registrado.

IWS 20/06/2007

InduSoft Web Studio

Pgina 598
Valores de Retorno:
0 Sucesso
1 Usurio pressionou ESC para fechar keypad
2 Parmetro invlido

Exemplos:
Tag KeyPad(tagA)

LogOff( )

Execuo Assncrona

Descrio: Efetua log off do usurio atual e loga o usurio guest.
Exemplos:
LogOff()

Logon(optstrUser, optstrPassword)

Execuo Assncrona

Descrio: Loga um usurio especificado utilizando a senha especificada. Caso no seja
fornecido o usurio, um dilogo logon abrir.
IWS 20/06/2007

InduSoft Web Studio

Pgina 599
Parmetros:
optstrUser Tag opcional String contendo o nome do tag User a ser logado.
optstrPassword Tag opcional String contendo a senha do usurio a efetuar log
on.

Exemplos:
Logon()
Logon(Albert, EMC2)

Math(numWorksheet)

Execuo Sncrona

Descrio: Executa uma planilha math especificada.
Parmetros:
numWorksheet Tag numrico contendo o nmero de planilhas math a serem
especificadas.

Exemplos:
Math(6)

C Ateno:
Rodar uma planilha math de dentro de outro mdulo causar uma pausa no mdulo
at que a planilha math seja finalizada. Conseqentemente, essa funo dever ser
utilizada somente quando absolutamente necessrio, para evitar o decrscimo na
execuo de outros mdulos.

IWS 20/06/2007

InduSoft Web Studio

Pgina 600
PostKey(numKeydownOrKeyup, numwParam, numlParam)

Execuo Sncrona

Descrio: Envia teclas para a visualizao da tela.
Parmetros:
numKeydownOrKeyup Tag numrico contendo um 0 (para indicar um evento Key
down) ou 1
(para indicar um evento Key up).
numwParam Tag numrico contendo key Code a ser enviado.
numlParam Tag numrico contendo mensagem lParam.

Exemplos:
PostKey(0, 0x24, 0)

Recipe(strFunction)

Execuo Sncrona

Descrio: Ativa uma funo Recipe especificada.
Parmetros:
IWS 20/06/2007

InduSoft Web Studio

Pgina 601
strFunction String tag especificando a operao a ser executada e a folha da
receita a ser utilizada no formato [Operation]:[Recipe sheet].
Operaes:
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 numrico
2 Expresso no pode conter :
3 Comando anterior para : invlido
4 Tarefa no encontrada pelo sistema
5 Erro no disco

Exemplos:
Tag Recipe(Save:Recipe1)
Tag Recipe(Load:Recipe5)

C Ateno:
Deve-se estar rodando Background Task (tab Execution Tasks na janela Project
Status) para executar as Funes de receita.

Report( strFunction , optnumOrientation)

Execuo Sncrona

Descrio: Salva um relatrio em disco ou envia-o para a impressora.
Parmetros:
IWS 20/06/2007

InduSoft Web Studio

Pgina 602
strFunction String especificando a operao a ser executada e a folha de
relatrio a ser utilizada na sintaxe de formato [Operation]:[Report
worksheet] onde:
[Operation]:
Disk: Salva dados para o arquivo de dados.
Prn: Imprime dados diretamente para a impressora.
[Report worksheet]:
Nome do relatrio que deve ser salvo ao disco ou enviado para a
impressora (o nome do arquivo de relatrio deve incluir a extenso
.REP).
optnumOrientat
ion
Configura a orientao do papel, como se segue:
0 (padro) = Porta-retrato
1 = Paisagem
Essa configurao ignorada quando a Operao configurada no
parmetro strFunction diferente de Prn.

Nota:
O parmetro optnumOrientation No suportado ao rodar a aplicao sob sistema
operacional Windows CE.
Valores de Retorno:
0 Sucesso
1 strFunction configurado com um valor numrico (invlido)
2 Expresso no pode conter : (invlido)
3 Comando anterior ao : invlido
4 Tarefa no encontrada pelo sistema (Tarefa BG no est rodando)
5 Erro no disco (disco cheio, arquivo read-only no pode ser sobrescrito
ou caminho invlido)
Exemplos:
Report(Disk:Report1.rep)
Report(Prn:Report2.rep)
Report(Prn:Report3.rep, 1)

C Ateno:
Relatrios em formato RTF no so suportados sob Sistema Operacional Windows
CE.

IWS 20/06/2007

InduSoft Web Studio

Pgina 603
= Dica:
Task (Tarefa Background) dever estar rodando de modo a executar essa funo.
Do contrrio, a operao no ser executada e a funo retornar o valor 4,
indicando Erro.
SendKeyObject(numEvent, strMainKey, optnumShift, optnumCtrl, optnumAlt, optstrTargetScreen)

Execuo Sncrona

Descrio: Envia key codes para objetos nas telas abertas. Pode-se disparar dinmicas
"Command" a partir desses objetos utilizando-se essa funo.
Parmetros:
numEvent Tag numrico especificando o evento do cdigo da tecla,
como se segue:
0: On Down
1: While Down
2: On Up
Tag String contendo a tecla a ser enviada ao objeto. Os
seguintes tags so aceitos:
strMainKey
"F1" ... "F20"
"+ "
"-"
"/"
"*"
"HOME"
"END"
"INSERT"
"DELETE"
"DOWN"
"UP"
"LEFT"
"RIGHT"
"PAGEUP"
"PAGEDOWN"
"SPACE"
"RETURN"
"BACKSPACE"
"ESCAPE"
"A" ... "Z"
optnumShift Tag numrico Opcional, indicando se dever ser enviado
para Shift.
optnumCtrl Tag numrico Opcional, indicando se dever ser enviado
para Ctrl.
optnumAlt Tag numrico Opcional, indicando se dever ser enviado
para Alt.
optstrTargetScreen Tag String Opcional contendo a tela a receber o key Code.

IWS 20/06/2007

InduSoft Web Studio

Pgina 604
Exemplos:
SendKeyObject(0, R, 1, 0, 0, main)

Notas:
numEvent define como uma funo executa Expresses especificadas para On
Down, On While, ou On Up da dinmica Command do objeto.
O evento On While requer ateno especial. Cada vez que a funo SendKeyObject()
executada, o IWS executa as Expresses configuradas para a folha On While (a
partir da dinmica Command do objeto) apenas uma vez.
Os parmetros numShift, numCtrl, numAlt, e strTargetScreen so opcionais;
porm, caso voc configurar um deles, os outros tambm devero ser configurados.

SetAppPath(strPath)

Execuo Sncrona

Descrio: Configura o novo caminho da Aplicao. Aps ser executada, o IWS procura por
todos os arquivos de configurao (screens, alarms, trends, database, events) nesse novo
caminho.
Parmetros:
StrPath Tag String contendo o caminho do arquivo.

Valores de Retorno:
0 Falha na configurao do caminho.
1 Sucesso na configurao do caminho.

Exemplos:
SetAppPath(C:\ InduSoft Web Studio\)

IWS 20/06/2007

InduSoft Web Studio

Pgina 605
Nota:
Caso o computador esteja em rede de trabalho, pode-se utilizar a sintaxe //<IP
address ou host name>/<Path> para definir o local de um outro modo na rede de
trabalho.

SetKeyboardLanguage(strLanguage)

Execuo Sncrona

Descrio: Utilize essa funo para configurar o idioma dos Virtual Keyboards.
Parmetros:
StrLanguage Tag String com o idioma utilizado para virtual keyboards. As opes
disponveis atualmente so: EN (English, default), and GE
(German).

Valores de Retorno:
0 Sucesso
1 Erro

Exemplos:
Tag SetKeyboardLanguage(EN)
Tag SetKeyboardLanguage(TagLanguage)

SetViewerInFocus()

Execuo Sncrona

Descrio: Configura o foco para a tarefa Viewer.
IWS 20/06/2007

InduSoft Web Studio

Pgina 606
Exemplos:
SetViewerInFocus()

SetViewerPos(numLeft, numTop, optnumWidth, optnumHeight)

Execuo Sncrona

Descrio: Configura altura, comprimento e posio do Viewer.
Parmetros:
NumLeft Tag numrico especificando a posio no lado esquerdo do
Viewer em pixels.
NumTop Tag numrico especificando a posio do lado de cima do
Viewer em pixels.
OptnumWidth Tag numrico Opcional especificando a largura do Viewer em
pixels.
OptnumHeight Tag numrico Opcional contendo a altura do Viewer em pixels.

Valores de Retorno:
0 Erro
1 Sucesso

Exemplos:
Tag SetViewerPos(50, 50, 640, 480)

Nota:
Ao omitir os parmetros opcionais (numWidth e numHeight), o IWS obtm o
tamanho da janela do Viewer a partir da resoluo da aplicao.

IWS 20/06/2007

InduSoft Web Studio

Pgina 607
ShutDown()

Execuo Sncrona

Descrio: Desliga todos os mdulos ativos da aplicao.
Exemplos:
ShutDown()

C Ateno:
Ess funo no fecha o ambiente de desenvolvimento, Database Spy, ou LogWin.

StartTask(strTask)

Execuo Assncrona

Descrio: Inicia um mdulo do IWS que no est rodando atualmente.
IWS 20/06/2007

InduSoft Web Studio

Pgina 608
Parmetros:
StrTask Tag String contendo o nome do tag task para iniciar (deve ser uma das
seguintes tarefas):
BGTASK: Background Tasks
VIEWER: Viewer
DBSPY: Database Spy
LOGWIN: LogWin
DRIVER: Driver
UNIDDECL: DDE Client
UNINDDE: DDE Server
UNIODBC: ODBC
TCPSERVER: TCP/IP Server
TCPCLIENT: TCP/IP Client
OPCCLIENT: OPC

Exemplos:
EndTask(Viewer)

Nota:
A funo StartTask(Driver) inicia todos os drivers configurados na aplicao.
Para iniciar um driver especfico, voc dever utilizar a funo Winexec(). Por
exemplo,
Winexec(<IWS path>\BIN\Studio Manager.exe+ +<IWS Path>
\Bin\Driver.dll+ +<DriverName>)

IWS 20/06/2007

InduSoft Web Studio

Pgina 609
ViewerPostMessage(strScrTitle, numwParam, numlParam)

Execuo Assncrona

Descrio: Envia uma mensagem interna para o Viewer.
Parmetros:
strScrTitle Tag String contendo o nome do tag screen para o qual a mensagem
ser enviada.
numwParam Tag numrico contendo wParam da mensagem do Windows.
numlParam Tag numrico contendo lParam da mensagem do Windows.

Exemplos:
ViewerPostMessage(main, 3, 1)

Wait(numMillisec)

Execuo Sncrona

Descrio: Interrompe a execuo da planilha math por um nmero especificado de
milissegundos.
Parmetros:
NumMillisec Tag Integer contendo o nmero de milissegundos a esperar.

Exemplos:

IWS 20/06/2007

InduSoft Web Studio

Pgina 610
Wait(1000)

C Ateno:
Pode-se utilizar a funo Wait(numMillisec) somente em planilhas Math. Porm,
um risco utilizar essa funo em qualquer lugar de sua aplicao.
Wait(numMillisec) pausa a Aplicao, e qualquer informao de entrada para a
Aplicao durante a espera ser ignorada.

WinExec(strCommand, optnumState, optnumSync, opttagReturnOrHandle)

Execuo Assncrona / Assncrona

Descrio: Executa uma linha de comando do Windows.
Parmetros:
strCommand Tag String contendo a linha de comando a ser
executada.
optnumState Tag numrico opcional ou constante contendo um
inteiro que define o estado inicial de uma nova
aplicao:
0: Oculta a Aplicao e promove controle a uma
outra aplicao.
1: Ativa e exibe a aplicao (padro).
2: Ativa a Aplicao e a exibe como cone.
3: Ativa e maximiza uma aplicao.
4: Exibe a aplicao com seu tamanho mais
recente. A aplicao ainda est ativa.
7: Exibe a aplicao como um cone. A Aplicao
ainda est ativa.
IWS 20/06/2007

InduSoft Web Studio

Pgina 611
optnumSync Tag numrica opcional ou constante que especifica se
a funo executar sincronica ou
assincronicamente. Ao executar sincronicamente, a
funo retornar quando o executvel termin-la; Ao
executar assincronicamente, a funo retornar
imediatamente. Para verificar se um programa que
iniciou-se automaticamente foi finalizada, ser
necessrio utilizar o quarto parmetro e a funo
WinExecIsRunning.
0: Modo Assncrono.
1: Modo sincrnico.
Padro 0.
opttagReturnOrHandle Deve-se especificar uma string com o Nome do Tag
que receber o Cdigo de retorno (ao executar
sincronicamente) do arquivo executvel ou o
programa a ser manuseado pode ser utilizado na
funo WinExecIsRodunnig para determinar se a
executvel ainda est rodando.

Valores de Retorno:
0 Comando no foi executado com sucesso.
1 Comando foi executado com sucesso.

Exemplos:
Tag WinExec( "C:\WinNT\System32\Notapad.exe", 4 ) // Inicia o Notapad
e continua executando as prximas linhas no script
Tag WinExec( "C:\WinNT\System32\mspaint.exe" ) // Inicia MS Paint e
continua executando as prximas linhas no script
Tag WinExec( "C:\MyTasks.bat", 0, 1, result ) // Inicia um arquivo
batch, executa-o em modo oculto e continua a execuo nas prximas
linhas no script somente quando o batch finalize sua Execuo. O
resultado armazenado no tag integer result.
Tag WinExec( "C:\MyTasks.bat", 0, 0, handle ) // Inicia um arquivo
batch, executa-o em modo oculto e segue para a prxima linha do
script. O tag handle recebe um nmero que pode ser passado para a
funo WinExecIsRunning para determinar se o batch ainda est em
execuo ou no [WinExecIsRunning(handle)].

IWS 20/06/2007

InduSoft Web Studio

Pgina 612
WinExecIsRunning(numHandle, opttagReturn)

Execuo Sncrona

Descrio: Indica se um programa que foi iniciado pela funo WinExec() ainda est rodando.
Parmetros:
numHandle Nmero Handle armazenado no tag no parmetro WinExec
stroptReturnorHandle.
opttagReturn Tag que recebe o cdigo de retorno pelo programa executado
pela funo WinExec().

Valores de Retorno:
0 Executado com sucesso
-1 Parmetro invlido(s)
-2 Falha ao abrir o arquivo. O Disco est protegido ou o arquivo invlido.

Exemplos:
Tag WinExecIsRunning(numHandle)
Tag WinExecIsRunning(numHandle, return)

IWS 20/06/2007

InduSoft Web Studio

Pgina 613
Funes de Arquivo
Essa seo descreve as seguintes funes 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
Execuo Sncrona

Descrio: Apaga os arquivos no caminho (path) e com a mscara (mask) selecionada, que
forem mais antigos do que a data especificada.
Parmetros:
StrPath Tag String contendo o caminho dos arquivos a serem deletados.
StrMask Tag String contendo a mask dos arquivos a serem deletados.
StrDate Tag String contendo a data cut-of (limite). Qualquer arquivo mais
antigo que essa data ser deletado.

Valores de Retorno: Retorna o nmero de arquivos deletados.
IWS 20/06/2007

InduSoft Web Studio

Pgina 614
Exemplos:
Tag DeleteOlderFiles(C:\ IWS\Aplication\HST\, *.hst, 04/12/2002)

Nota:
Deve-se configurar o terceiro parmetro (StrDate) utilizando o formato para a data
especificado para a Aplicao (como MDY ou DMY) com o separador apropriado
( /,:, ., etc.)

DirCreate(strDirectory, optBooFullPath)

Grupo Arquivo
Execuo Sncrona

Descrio: Cria o diretrio especificado.
Parmetros:
strDirectory Tag string ou valor contendo o nome e o caminho do arquivo do
diretrio a ser criado.
optBooEmptyOnly flag opcional. Se omitido ou parmetro com valor igual a 0, o diretrio
ser criado somente se todos os diretrios anteriores existirem. Caso o
parmetro possua valor diferente de 0, o caminho completo
especificado no parmetro strDirectory ser criado.

Valores de Retorno:
-1 Parmetros invlidos
0 Falha ao criar o diretrio (e.x. Drive no existe.)
1 Diretrio criado com sucesso.

Exemplos:
Tag DirCreate(C:\Studio\Temp) // A pasta Temp foi criada no caminho
C:\Studio (somente se o caminho C:\Studio j exista).
Tag DirCreate(C:\Studio\Temp,1) // O caminho completo
C:\Studio\Temp foi criado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 615

Nota:
Quando essa funo executada a partir de Web Thin Client station, o diretrio
verificado na server station (mas no em Web Thin Client).

DirDelete(strDirectory, optBooEmptyOnly)

Grupo Arquivo
Execuo Sncrona

Descrio: Deleta o diretrio especificado.
Parmetros:
strDirectory Tag string ou valor contendo o nome e o caminho do arquivo do
diretrio a ser deletado.
optBooEmptyOnly Flag opcional. Se omitido ou se o parmetro possui o valor 0, o
diretrio ser deletado somente se estiver vazio.

Valores de Retorno:
-2 Tentativa de deletar um diretrio no vazio quando tal ao no
permitida (optBooEmptyOnly <> 0)
0 Falha ao deletar o diretrio (e.x. Diretrio no existe.)
1 Diretrio deletado com sucesso.

Exemplos:
Tag DirDelete(C:\Studio\Temp) // A pasta Temp de C:\Studio foi
deletada.
Tag DirDelete (C:\Studio\Temp,1) // A pasta Temp de C:\Studio ser
deletada somente se estiver vazia.

IWS 20/06/2007

InduSoft Web Studio

Pgina 616
Nota:
Quando essa funo executada a partir de Web Thin Client station, o diretrio
verificado na server station (mas no em Web Thin Client).

D Dica:
Essa funo suporta wildcard (* and ?).

DirLength(strPath)

Grupo Arquivo
Execuo Sncrona

Descrio: Retorna o tamanho de um diretrio especificado.
Parmetros:
strPath Tag string ou valor contendo o caminho do diretrio a ser verificado.

Valores de Retorno:
-2 Diretrio no existe.
>=0 Tamanho (em bytes) dos arquivos e subpastas do diretrio

Exemplos:
Tag DirLength(C:\Studio) // Retorna o tamanho (em bytes) de todos os
arquivos e subpastas de C:\Studio.

C Ateno:
Essa funo sncrona, e pode levar alguns segundos para retornar o valor correto;
deve ser utilizada com ateno.

IWS 20/06/2007

InduSoft Web Studio

Pgina 617
Nota:
Quando essa funo executada a partir de uma Web Thin Client station, o
diretrio verificado na server station (mas no em Web Thin Client).

DirRename(strPath, strDirectoryFrom, strDirectoryTo)

Grupo Arquivo
Execuo Sncrona

Descrio: Renomeia diretrios.
Parmetros:
strPath Tag string ou valor contendo o caminho do diretrio a ser renomeado.
strDirectoryFrom Tag string ou valor contendo o nome original do diretrio a ser
renomeado.
strDirectoryTo Tag string ou valor contendo o nome do alvo utilizado para renomear o
diretrio original.

Valores de Retorno:
0 Falha ao renomear o diretrio (e.x. strDirectoryFrom no existe.)
1 Diretrio renomeado com sucesso.

Exemplos:
Tag DirRename(C:\Studio\,Temp, New) // A pasta Temp da pasta
C:\Studio\ est renomeada como New.
Tag DirDelete (C:\Studio\Temp,1) // A pasta Temp da pasta C:\Studio
ser deletada somente se estiver vazia.

Nota:
Quando essa funo executada a partir de uma Web Thin Client station, o
diretrio renomeado na server station (mas no em Web Thin Client).

IWS 20/06/2007

InduSoft Web Studio

Pgina 618
D Dica:
Essa funo suporta wildcard (* and ?).

FileCopy (strSourceFile, strTargetFile, optnumTimeOut)

Grupo Arquivo
Execuo Sncrona

Descrio: Copia o arquivo(s) configurado no parmetro strSourceFile para o arquivo/caminho
configurado no parmetro strTargetFile.
Parmetros:
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 numrico contendo um inteiro para configurar o timeout
para a operao.

Valores de Retorno:
-1 Timeout expirou.
0 Falha ao copiar o arquivo(s).
1 Arquivo(s) copiado com sucesso.

Exemplos:
Tag FileCopy(C:\ IWS\Aplication\HST\*.hst, C:\Temp\Hst\, 1000)
Tag FileCopy(C:\ IWS\Aplication\ropert.txt,
C:\Temp\Tuesday_Report.txt, 500)

IWS 20/06/2007

InduSoft Web Studio

Pgina 619
C Ateno:
Essa funo originalmente sncrona (por exemplo, o scan no continua at que a
funo finalize o procedimento de cpia). Conseqentemente, utilizar essa funo
para conexes de rede de trabalho lentas poder causar problemas.
Caso voc utilizar o parmetro optnumTimeOut, a funo retornar o valor 1 aps o
timeout especificado, e o scan continuar, e o procedimento de cpia no ser
cancelado. Um processo interno ser criado para finalizar o procedimento de cpia.

FileDelete(strFile)

Grupo Arquivo
Execuo Sncrona

Descrio: Deleta o arquivo especificado.
Parmetros:
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:
Tag FileDelete(C:\ IWS\readme.txt)

FileLength (strFile)

Grupo Arquivo
Execuo Sncrona

Descrio: Retorna o tamanho de um arquivo
IWS 20/06/2007

InduSoft Web Studio

Pgina 620
Parmetros:
strFile Tag String contendo o nome e o caminho do arquivo.

Valores de Retorno: Retorna o tamanho em bytes do arquivo especificado.
Exemplos:
Tag FileLength( "C:\readme.txt" )

FileRename(strOldName, strNewName)

Grupo Arquivo
Execuo Sncrona

Descrio: Renomeia o arquivo especificado.
Parmetros:
strOldName Tag String contendo o caminho e nome do arquivo.
strNewName Tag String contendo o caminho e o novo nome do arquivo.

Exemplos:
FileRename(C:\readme.txt, C:\pleasereadme.txt)

FileWrite(strFileName, strWriteText, numoptAppend)

Grupo Arquivo
Execuo Sncrona

Descrio: Registra uma string ASCII para um arquivo especificado. Caso o arquivo no exista,
a funo criar o arquivo.
IWS 20/06/2007

InduSoft Web Studio

Pgina 621
Parmetros:
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 parmetro ou especificar zero (0), a funo
substitui os contedos do arquivo existente com o texto
especificado para strWriteText.
Caso voc especifique um valor diferente de zero (1, 2, 3, ), a
funo adiciona o novo texto especificado utilizando
strWriteText como uma nova linha para o arquivo.

Valores de Retorno:
0 Executado com sucesso
-1 Parmetro invlido(s)
-2 Falha ao abrir o arquivo. O Disco est protegido ou o nome do arquivo est invlido.
Exemplos:
Tag FileWrite(c:\test.txt, This is a test)
Tag FileWrite(TagFileName, TagText)
Tag FileWrite(TagFileName, TagText, 1)
FindFile(strFile, "opttagFilesFound", optnumTimeOut)

Grupo Arquivo
Execuo Sncrona

Descrio: Procura por um arquivo
Parmetros:
strFile Tag string contm a coordenada mask do arquivo a ser
pesquisado.
opttagFilesFound Tag string array Opcional recebe caminho e nome de cada
arquivo encontrado.
optnumTimeOut Tag numrico Opcional contm um inteiro para configurar
o timeout em milissegundos para essa funo.

IWS 20/06/2007

InduSoft Web Studio

Pgina 622
Valores de Retorno:
-1 Timeout
0 Arquivos no encontrados
N Nmero de arquivos encontrados

Exemplos:
Tag FindFile(*.txt)
Tag FindFile(*.doc, StringArray, 1000)

C Ateno:
Essa funo originalmente sncrona (por exemplo, o scan no continua at que a
funo finalize o procedimento de cpia). Conseqentemente, utilizar essa funo
para conexes de rede de trabalho lentas poder causar problemas.
Caso voc utilizar o parmetro optnumTimeOut, a funo retorna o valor 1 aps o
timeout especificado e o scan continuar.

FindPath(strPathName)

Grupo Arquivo
Execuo Sncrona

Descrio: Verifica a existncia do diretrio.
Parmetros:
strPathName Tag String contendo o caminho do arquivo a ser pesquisado.

Valores de Retorno:
0 Caminho no encontrado
1 Caminho encontrado

Exemplos:
IWS 20/06/2007

InduSoft Web Studio

Pgina 623
Tag FindPath(C:\WINNT\)

GetFileAttributes(strFile)

Grupo Arquivo
Execuo Sncrona

Descrio: L os atributos de um arquivo especificado.
Parmetros:
strFile Tag string, contendo o arquivo do qual os atributos sero lidos.

Valores de Retorno:
-1 Erro
1 Somente Leitura
2 Oculto
4 Sistema
16 Diretrio
32 Arquivo
128 Normal
256 Temporrio

Exemplos:
Tag GetFileAttributes(C:\readme.txt)

GetFileTime(strFileName, numFormat)

Grupo Arquivo
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 624

Descrio: L a data e hora da ltima modificao do arquivo.
Parmetros:
strFileName Tag String contendo o nome do arquivo a ser lido.
numFormat Tag numrico, que especifica o formato dos dados de retorno
especificados.
0: Retorna a Data e Hora do arquivo.
1: Retorna somente a data do arquivo.
2: Retorna somente a hora do arquivo.

Valores de Retorno: Retorna a data e hora da ltima modificao do arquivo.
Exemplos:
Tag GetFileTime(C:\readme.txt)

GetLine(strFileName, strSeqChar, "tagStore", optnumCase, "optOveflowTag")

Grupo Arquivo
Execuo Sncrona

Descrio: Pesquisa uma seqncia de caracteres (string) em um arquivo ASCII e armazena (em
um Tag string) os contedos de toda uma linha na qual a seqncia de caracteres foi
encontrada.
Parmetros:
StrFileName Tag String contendo o caminho e o nome do arquivo a ser
pesquisado.
strSeqChar Tag String contendo a seqncia de caracteres a serem
pesquisados.
tagStore Nome do Tag string que recebe a linha toda de caracteres dos
quais a seqncia foi encontrada.
IWS 20/06/2007

InduSoft Web Studio

Pgina 625
OptnumCase Tag numrico Opcional especificando se a pesquisa sensvel a
letras maisculas e minsculas.
0: No sensvel a letras maisculas e minsculas
1: Sensvel a letras maisculas e minsculas
OptOverflowTag Nome de um Tag numrico opcional que recebe o resultado de
uma verificao de sobrefluxo.
0: OK
1: sobrefluxo

IWS 20/06/2007

InduSoft Web Studio

Pgina 626
Valores de Retorno:
N Quantidade de linhas nas quais a seqncia foi encontrada no arquivo
alvo ASCII.
0 String no encontrado no arquivo alvo ASCII
-1 Arquivo ASCII no encontrado
-2 Parmetro strFileName Invlido
-3 Parmetro strSeqChar invlido
-4 Parmetro strStoreTag invlido
-5 Parmetro numOptCase invlido
-6 Parmetro optnumOverflowTag invlido

Exemplos:
Tag GetLine(C:\TechRef v51.doc, IWS Tag database6.1, "ReturnLine")
Tag GetLine(C:\readme.txt, Antes de instalar o IWS, "ReturnedLine", 0,
"Overflow")

Nota:
Essa funo pesquisa somente a primeira ocorrncia da string no arquivo ASCII.

HST2TXT(strStartDate, strStartTime, numDuration, numGrupoNumber, optstrTargetFile,
optstrSeparator, optnumMilliseconds, optstrFormat)

Grupo Arquivo
Execuo Assncrona

Descrio: Exporta informaes do arquivo(s) histrico trend binrio de propriedade (*.hst) para
um arquivo texto (*.txt).
IWS 20/06/2007

InduSoft Web Studio

Pgina 627
Parmetros:
StrStartDate Tag String contendo a data de incio dos dados.
StrStartTime Tag String contendo a hora de incio dos dados.
NumDuration Tag numrico contendo a durao dos dados em horas.
NumGrupoNumber Tag numrico contendo Nmero do grupo Trend.
optstrTargetFile Tag String opcional contendo o caminho e nome do arquivo
a ser registrado. Se omitido, a funo cria um arquivo com o
mesmo nome de propriedade do arquivo, mas utilizando a
extenso TXT.
optstrSeparator Tag String opcional contendo os caracteres para separao
de dados para o arquivo. Se omitido, a funo utiliza o
caractere TAB (\t) para separar os valores no arquivo texto.
optnumMilliseconds Tag numrica opcional. Caso esse parmetro seja falso (0), o
arquivo texto criado no exibir milissegundos no
timestamp de cada amostra de histrico.
optstrFormat Tag string, o qual especifica a ordem de Ms (M), Dia (D), e
Ano (Y) para formato time-stamp exportado para o arquivo
texto:
DMY: Day, Month, Year
MDY: Month, Day, Year
YMD: Year, Month, Day
Se omitido, a funo utiliza o formato DMY para o
timestamp no arquivo texto.

Valores de Retorno:
-2 Funes Dll no encontradas
-1 IndHst.dll no encontrado
0 Funo foi executada com sucesso
1 Erro. Execuo prvia de HST2TXT ainda no foi completada

Exemplos:
Tag HST2TXT(04/12/2002, 13:45:50, 5.5, 1)
Tag HST2TXT( "04/14/2002", "06:30:00", 0.1, 3, "C:\Studio\data.txt", "\" )
Tag HST2TXT( "04/14/2002", "06:30:00", 0.1, 3, "C:\Studio\data.csv", "," ,
IWS 20/06/2007

InduSoft Web Studio

Pgina 628
MDY )

D Dica:
Ao utilizar o caractere vrgula (,) como optstrSeparator, a funo cria um arquivo no
formato CSV (Comma Separated Values), uma ferramenta til para exportao de
dados histricos Trend de formato binrio de propriedade para um arquivo que
pode ser aberto com o Microsoft Excel.
HST2TXTIsRodando()

Grupo Arquivo
Execuo Sncrona

Descrio: Retorna o status da funo HST2TXT().
Valores de Retorno:
0 HST2TXT ainda est rodando.
-1 Processo Last conVersion foi executado de maneira apropriada.
-2 Reservado.
-3 Arquivo no encontrado. No existem arquivos histricos no intervalo
de tempo configurado para o grupo especificado.
-4 No possvel abrir o arquivo HST.
-5 No possvel abrir/criar o arquivo ASCII.
-6 No possvel ler informaes do arquivo HST
-7 Tipo de arquivo invlido.
-8 No possvel ler informaes do cabealho (Header) do arquivo HST.
-9 Nmero do tag invlido nas informaes do cabealho (Header) (0 >
nTags > 250)
-10 No possvel criar o arquivo Header (.hdr)
-20 IndHst.dll no encontrado.
-30 No possvel acessar a funo dll.

IWS 20/06/2007

InduSoft Web Studio

Pgina 629
Exemplos:
Tag HST2TXT()

Print( strFilePath , optnumOrientation)

Grupo Arquivo
Execuo Assncrona

Descrio: Imprime um arquivo texto.
Parmetros:
strFilePath Caminho e nome do arquivo texto a ser impresso.
optnumOrientation Configura a orientao do papel, como se segue:
0 (padro) = Porta- retrato
1 = Paisagem

Nota:
O Parmetro optnumOrientation No suportado quando a aplicao est rodando
sob sistema operacional Windows CE.

Exemplos:
Print(C:\ReadMe.txt)
Print(C:\ReadMe.txt, 1)
Print(TagFileName, 0)

Nota:
Essa funo pode ser utilizada para imprimir somente contedos de arquivos textos.
Informaes em quaisquer outros formatos (e.x. figuras, Arquivos Binrios, etc.) no
podem ser impressas com essa funo.

IWS 20/06/2007

InduSoft Web Studio

Pgina 630
RDFileN("tagSelecioneedFile", strSearchPath, strMask, numChangeDir)

Grupo Arquivo
Execuo Sncrona

Descrio: Inicializa uma janela File Browser que permite a seleo de um arquivo.
Parmetros:
tagSelecioneedFile Nome do Tag string que recebe o nome e caminho de um
arquivo selecionado(s).
StrSearchPath Tag String contendo o caminho do arquivo a ser
pesquisado.
StrMask Tag String contendo o mask utilizado para filtrar os
arquivos.
NumCahngeDir Tag numrico contendo 0 para desabilitar alterao de
diretrios.

Valores de Retorno:
0 Sucesso
1 Um dos parmetros no uma string
2 Parmetro 1 contm um Nome do Tag invlido
3 A operao foi cancelada pelo usurio

Exemplos:
Tag RDFileN("FileName", C:\ IWS\, *.doc, 1)

IWS 20/06/2007

InduSoft Web Studio

Pgina 631
Funes Grficas
Essa seo descreve as seguintes funes Grficas do InduSoft Web Studio:
PrintSetup()
PrintWindow(strScreenName , optnumOrientation)
RGBColor ( numRed, numGreen, numBlue )
RGBComponent ( numColor , numComponent )
PrintSetup()

Grupo Telas Grficas Printint
Execuo Assncrona

Descrio: Abre o dilogo de configurao padro do Sistema Operacional, onde a impressora
pode ser selecionada e configurada.
Exemplos:
Tag PrintSetup()

PrintWindow(strScreenName , optnumOrientation)

Grupo Grfico
Execuo Assncrona

Descrio: Imprime um screenshot da tela da aplicao.
Parmetros:
strScreenName Tag String contendo o nome do tag screen o qual deseja-se
imprimir. Caso esse parmetro esteja omitido, a tela aberta
atualmente ser impressa. Esse parmetro deve ser omitido ao
executar essa funo sob sistema operacional WinCE.
IWS 20/06/2007

InduSoft Web Studio

Pgina 632
optnumOrientation Configura a orientao do papel, como se segue:
0 (padro) = Porta- retrato
1 = Paisagem

Nota:
O parmetro optnumOrientation No suportado quando a aplicao est rodando
sob sistema operacional Windows CE.
Exemplos:
PrintWindow()
PrintWindow(Main, 1)
Print(TagScreenName, 0)

Nota:
Pode-se utilizar a funo PrintWindow() para imprimir relatrios em formato grfico,
incluindo qualquer objeto, como Trends, bitmaps, etc.

RGBColor ( numRed, numGreen, numBlue )

Grupo Grfico
Execuo Sncrona

Descrio: Retorna o nmero da cor definida por cdigos RGB (Red, Green e Blue).
Parmetros:
numRed Cdigo Vermelho do cdigo RGB
numGreen Cdigo Verde do cdigo RGB
numBlue Cdigo Azul do cdigo RGB

Valores de Retorno: Essa funoi retorna o nmero da cor definida pelos cdigos RGB (Red,
Green and Blue).
IWS 20/06/2007

InduSoft Web Studio

Pgina 633
Exemplos:
TagColor RGBColor(51,153,102) // Essa funo retorna o valor 13434828, o
qual a cor do cdigo para Sea Green.
TagColor RGBColor(TagRed,TagGreen,TagBlue) // Essa funo retorna o cdigo
da cor dos valores RGB configurados nos tags TagRed, TagGreen and
TagBlue, respectivamente.

D Dica:
Veja a lista de valores de Cdigos e Cores RGB para a maioria das cores utilizadas em
IWS Development Environment -> Standard Interfaces -> Color Interface secton.

RGBComponent ( numColor , numComponent )

Grupo Grfico
Execuo Sncrona

Descrio: Retorna o cdigo de um dos componentes RGB a partir do cdigo de cores
estabelecido.
Parmetros:
numColor Cdigo de cores a partir do qual um valor do compoente ser
extrado.
numComponent Especifica qual componente RGB ser extrado da cor (0=Red ;
1=Green; 2=Blue)

Valores de Retorno: Essa funo retorna o cdigo de um dos componentes RGB a partir do
cdigo de cores apresentado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 634
Exemplos:
TagRed RGBColor(13434828,0) // Essa funo retorna o valor 51, o qual o
componente Red do cdigo de cores 13434828 (Sea Green).
TagGreen RGBColor(13434828,1) // Essa funo retorna o valor 153, o qual
componente Green do cdigo de cores 13434828 (Sea Green).
TagBlue RGBColor(13434828,2) // Essa funo retorna o valor 102, o qual
componente Blue do cdigo de cores 13434828 (Sea Green).
TagComponen
t
RGBColor(TagCode, TagComponent) // Essa funo retorna o valor do
cdigo de cores e components especificados pelos tags TagCode e
TagComponent, respectivamente.

D Dica:
Veja a lista de cdigos RGB e valores de cores para a maioria das cores utilizadas,
no captulo Inteface de cores.

IWS 20/06/2007

InduSoft Web Studio

Pgina 635
Funes de Traduo
Essa seo descreve as seguintes funes de Traduo do InduSoft Web Studio:
Ext(strText)
SetTranslationFile(strFileName)
Ext(strText)

Grupo Traduo
Execuo Sncrona

Descrio: Traduz texto especificado.
Parmetros:
srtText Tag String contendo o texto a ser traduzido.

Valores de Retorno: Retorna a traduo do texto, utilizando-se do arquivo de traduo ativo.
Exemplos:
Tag Ext(Start) // Valor de retorno caso traduzindo para Portugus =
Iniciar
Tag Ext(Stop) // Valor de retorno caso traduzindo para Alemo =
Anschlag

SetTranslationFile(strFileName)

Grupo Traduo
Execuo Sncrona

Descrio: Configura o arquivo de traduo ativo, e traduz todos os textos habilitados junto a
aplicao.
Parmetros:
strFileName Tag String contendo o nome de um arquivo de traduo.
IWS 20/06/2007

InduSoft Web Studio

Pgina 636
optStrColumnName Tag string ou valor contendo o nome do tag column do
arquivo de traduo, o qual dever ser utilizado para
traduzir os textos na aplicao. Quando omitido, a segunda
coluna do arquivo de traduo ser utilizada por padro.

Valores de Retorno:
0 Sucesso.
1 Nmero invlido de parmetros.
2 Tipo errado de parmetro.
3 Arquivo de traduo no pde ser encontrado ou aberto.

Exemplos:
Tag SetTranslationFile(Portuguese.tra)
Tag SetTranslationFile(German.tra)
Tag
SetTranslationFile( "Mytranslation.csv" , Portuguese )
Tag SetTranslationFile( "Mytranslation.csv" , German )

Nota:
Deve-se habilitar a opo Translation a partir do dilogo Project Settings para que
essa funo possa funcionar.

C Ateno:
Deve-se possuir um arquivo de traduo na utilidade Translation File.

IWS 20/06/2007

InduSoft Web Studio

Pgina 637
Funes Multimdia
Essa seo descreve a funo Multimdia do InduSoft Web Studio Multimedia: Play(strFileName).
Play(strFileName, numOptSncrona)

Grupo Multimdia
Execuo Sncrona/Assncrona

Descrio: Roda um arquivo .WAV especificado.
Parmetros:
strFileName Tag String contendo .WAV a ser traduzido.
numOptSncrona Tag numrico que controla se uma funo ser executada
sncrona ou assincronicamente.
Onde:
Especificar 0 (padro) ou no especificar parmetros
habilita a funo a executar de forma assncrona.
Especificar 1 habilita a funo para execuo Sncrona.

Exemplos:
Play(C:\Sounds\Wav\alarm.wav)

Nota:
Para que essa funo funcione em Web Thin Client, o arquivo alvo .WAV dever
estar localizado no mesmo caminho do arquivo na estao remota.

IWS 20/06/2007

InduSoft Web Studio

Pgina 638
Funes Informaes do Sistema
Essa seo descreve as seguintes funes de Informaes do Sistema do InduSoft Web Studio:
DbVersion()
GetAppHorizontalResolution( )
GetAppPath()
GetAppVerticalResolution( )
GetComputerIP( )
GetComputerName( )
GetHardKeyModel( )
GetHardkeySN( )
GeDicaAll(tagArrayIP, optRefresh)
GetNetMACID( )
GetProductPath( )
GetOS( )
GetPrivateProfileString(strSeo, 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.
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 639

Descrio: Retorna o nmero da Tag databasedo banco de dados da aplicao atual.
Valores de Retorno: Retorna a Tag databasedo banco de dados em formato numrico.
Exemplos:
Tag DbVersion()

GetAppHorizontalResolution( )

Grupo System Info.
Execuo Sncrona

Descrio: Obtm a resoluo horizontal da tela, a partir do arquivo .APP, seo [Info].
Valores de Retorno: Retorna o valor [Info, embora no teste a configurao do Windows.
Exemplos:
Tag GetAppHorizontalResolution( ) // Valor de retorno = 640
Tag GetAppHorizontalResolution( ) // Valor de retorno = 800

GetAppVerticalResolution( )

Grupo System Info.
Execuo Sncrona

Descrio: Obtm a resoluo vertical da tela a partir do arquivo .APP, seo [Info].
Valores de Retorno: Retorna [Info]value, embora no teste a configurao do Windows.
IWS 20/06/2007

InduSoft Web Studio

Pgina 640
Exemplos:
Tag GetAppVerticalResolution( ) // Valor de retorno = 480
Tag GetAppVerticalResolution( ) // Valor de retorno = 600

GetComputerIP( )

Grupo System Info.
Execuo Sncrona

Descrio: Retorna o primeiro Endereo IP da estao local.
Valores de Retorno: Retorna o primeiro Endereo IP da estao local como uma string.
Exemplos:
Tag GetComputerIP() // Valor de retorno = 192.168.0.1
Tag GetComputerIP() // Valor de retorno = 248.12.2.78

GetComputerName( )

Grupo System Info.
Execuo Sncrona

Descrio: Retorna o nome do computador local.
Valores de Retorno: Retorna o nome do computador local como uma string.
IWS 20/06/2007

InduSoft Web Studio

Pgina 641
Exemplos:
Tag GetComputerName() // Valor de retorno = Terminal53
Tag GetComputerName() // Valor de retorno = BobsComputer


Grupo System Info.
Execuo Sncrona
Windows NT/2K/XP No suportado

Descrio: Retorna a quantidade de memria livre disponvel em um equipamento Windows CE.
Parmetros:
optnumType Tag numrico Opcional que especifica qual o tipo de memria
livre que o IWS dever entregar a partir de um equipamento
Windows CE, Onde:
0: Programa com memria total disponvel

Valores de Retorno:
>0 Tamanho da memria livre (em bytes).
-1 Arquivo Coredll.dll no encontrado.
-2 Funo GetFreeMemoryCE no encontrada.
-3 Parmetro opcional invlido.
-4 Tipo de memria no disponvel.

Exemplos:
Tag GetFreeMemoryCE(opt2)

GetHardKeyModel()

Grupo System Info.
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 642

Descrio: 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:
Tag GetHardKeyModel() // Valor de retorno = Interface Local
Tag GetHardKeyModel() // Valor de retorno = Server Advanced

C Ateno:
Deve-se instalar o hardkey antes de executar essa funo ou a funo no ser
executada de maneira apropriada.

GetHardkeySN( )

Grupo System Info.
Execuo Sncrona

Descrio: Retorna o nmero serial do hardkey.
Valores de Retorno:
Hardkey located: Retorna uma string com o nmero serial do hardkey.
Hardkey not installed or not found: Retorna a 0.
Exemplos:
Tag GetHardkeySN() // Valor de retorno = 120.745
Tag GetHardkeySN() // Valor de retorno = 224.941

IWS 20/06/2007

InduSoft Web Studio

Pgina 643
C Ateno:
Deve-se instalar o hardkey antes de executar essa funo ou a funo no ser
executada de maneira apropriada.

GeDicaAll(tagArrayIP, optRefresh)

Grupo System Info.
Execuo Sncrona

Descrio: Retorna o nmero dos endereos IP assinalados para a estao local e armazena os
Endereos IP em um tag string array.
Parmetros:
tagArrayIP Nome do tag string array que recebe o endereo IP encontrado.
optRefresh Tag opcional que dispara uma funo de atualizao dessa
funo, caso voc utilize-a em uma dinmica de text I/O. Cada
vez que esse tag altera seu valor, o IWS atualizar a funo.

Valores de Retorno:
N Nmero do Endereo IP encontrado
-2 Tipo de parmetro invlido

Exemplos:
Tag GeDicaAll(TagArrayIP) // Valor de retorno = 1
Tag GeDicaAll(TagArrayIP, second) // Valor de retorno = 2


Grupo System Info.
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 644

Descrio: Retorna a memria total disponvel em um equipamento Windows CE.
Parmetros:
optnumType Tag numrico Opcional que especifica qual tipo de mmoria o
IWS poder entregar a partir de um equipamento Windows CE,
como se segue.
0: Memria total do programa
1: Armazenamento total de memria
2: Memria Total

Valores de Retorno:
>0 Tamanho da memria em bytes.
-1 Arquivo Coredll.dll no encontrado.
-2 Funo GetMemoryCE no encontrada.
-3 Parmetro opcional invlido.

Exemplos:
Tag GetMemoryCE(opt1)

GetNetMACID(strOptMACID, strOptAdapterName )

Grupo System Info.
Execuo Sncrona

Descrio: Obtm o nico cdigo MAC ID do adaptador(es) de rede de trabalho instalados
atualmente.
Parmetros:
strOptMACID Nome de um Tag String, que recebe MAD ID do adaptador da
rede de trabalho. Caso exista mais de um adaptador de rede de
trabalho instalado atualmente na estao, o usurio poder
configurar um tag string array nesse parmetro, de modo que
cada posio de array recebe o MAC ID de um adaptador da
rede de trabalho.
IWS 20/06/2007

InduSoft Web Studio

Pgina 645
strOptAdapterName Nome de um Tag String, que recebe o nome do tag network
adapter. Caso exista mais de um adaptador de rede de trabalho
instalado atualmente na estao, o usurio poder configurar
um tag string de array nesse parmetro, de modo que cada
posio de array recebe o nome do adaptador de uma rede de
trabalho. Esse parmetro opcional.

Valores de Retorno:
>0 Nmeros de adaptadores de rede de trabalho encontrados.
0 Adaptadores de rede de trabalho no encontrados.
-1 Nmero invlido de parmetros.
-2 Um dos parmetros no do tipo string.
-3 Tag configurado em strOptMACID no existe.
-4 Tag configurado em strOptAdapterName no existe.

Exemplos:
NumNIC GetNetMACID(MACIDTag)
NumNIC GetNetMACID(MACIDTag, AdapterName)
NumNIC GetNetMACID(MACIDTag[1], AdapterName[1])

GetProductPath( )

Grupo System Info.
Execuo Sncrona

Descrio: Retorna o caminho para o diretrio do IWS.
Valores de Retorno: Retorna o caminho do diretrio do IWS como uma string.
Exemplos:
Tag GetProductPath() // Valor de retorno = C:\Program Files\ IWS 51\

IWS 20/06/2007

InduSoft Web Studio

Pgina 646
GetOS( )

Grupo System Info.
Execuo Sncrona

Descrio: 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:
Tag GetOS() //Valor de retorno = 2

GetPrivateProfileString(strSeo, strName, strDefault, strFileName)

Grupo System Info.
Execuo Sncrona

Descrio: L um parmetro especificado de um arquivo .INI utilizando o formato padro .INI.
IWS 20/06/2007

InduSoft Web Studio

Pgina 647
Parmetros:
strSeo Tag String contendo o nome da seo a ser lida.
strName Tag String contendo o nome do parmetro a ser lido.
strDefault Tag String contendo a configurao padro para esse parmetro.
Caso parmetro no encontrado no arquivo .ini, a funo retornar a
configurao padro.
StrFileName Tag String contendo o caminho e o nome do arquivo .ini a ser lido.

Valores de Retorno: Retorna o valor do parmetro especificado.
Exemplos:
Tag GetPrivateProfileString( boot loader, timeout, 50, C:\boot.ini) //

GetScrInfo()

Grupo System Info.
Execuo Sncrona

Descrio: Fornece informaes sobre a tela (*.scr) a partir da Aplicao.
Parmetros:
strScreenName: Nome da tela para a qual a informao requisitada.
strInfoData: Nome do tag que receber as informaes entregues por uma funo. O valor desses dados
especificado pelo parmetro optstrInfoType.
optstrInfoType: Tipo de informaes da tela fornecidas por uma funo:

optstrInfoType
value
Descrio
0 (padro) Registra as seguintes coordenadas para cada posio consecutiva do
tag array configurado no parmetro strInfoData: TOP, LEFT,
BOTTOM e RIGHT.
1 Registra a coordenada TOP para o tag configurado no parmetro
strInfoData..
2 Registra a coordenada LEFT para o tag configurado no parmetro
strInfoData..
3 Registra a coordenada BOTTOM para o tag configurado no
parmetro strInfoData..
IWS 20/06/2007

InduSoft Web Studio

Pgina 648
4 Registra a coordenada RIGHT para o tag configurado no parmetro
strInfoData.

Valores de Retorno:
Value Descrio
0 Sucesso
-1 Primeiro e segundo parmetros so diferentes do tipo STRING.
-2 Erro na alocao de memria
-3 optstrInfoType zero, mas o tag strInfoData no um tag array.
-4 Tag invlido configurado no parmetro strInfoData.

Exemplos:
TagErroCdigo Tag GetScrInfo( "main" , TagXY[0] ) // Retorna as coordenadas
TOP, LEFT, BOTTOM e RIGHT das telas MAINS.SCR em quatro
posies iniciais de Tag array XY.
TagErroCdigo Tag GetScrInfo( "main" , TagXY , 3 ) // Retorna a coordenada
BOTTOM da tela MAINS.SCR spara o TagXY.
GetServerHostName()

Grupo System Info.
Execuo Sncrona

Descrio:
Parmetros: Nenhum
Valores de Retorno: Nome do Server host para ISSymbol e 127.0.0.1 para outros.
Exemplos:
Nome
do Tag
Expresso
GetServerHostName()

IWS 20/06/2007

InduSoft Web Studio

Pgina 649
GetTickCount( )

Grupo System Info.
Execuo Sncrona

Descrio: Retorna o valor atual da contagem do relgio.
Valores de Retorno: Retorna um inteiro com os milissegundos contados pelo relgio para cada
inicializao dos sistema operacional.
Exemplos:
Tag GetTickCount // Valor de retorno = 9400907

InfoAppAlrDir( )

Grupo System Info.
Execuo Sncrona

Descrio: Retorna o diretrio Alarm para a Aplicao atual.
Valores de Retorno: Retorna o diretrio Alarm o diretrio da Aplicao atual como uma string.
Exemplos:
Tag InfoAppAlrDir() // Valor de retorno = C:\DemoApp\alarm\
Tag InfoAppAlrDir() // Valor de retorno = C:\ IWS\Projects\App\alarm\

GetAppPath()

Grupo System Info.
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 650

Descrio: Retorna o diretrio da Aplicao atual.
Valores de Retorno: Retorna o diretrio da Aplicao atual como uma string.
Exemplos:
Tag GetAppPath() // Valor de retorno = C:\DemoApp\
Tag GetAppPath() // Valor de retorno = C:\Studio\Projects\App\

Nota:
Essa funo dever retornar o caminho atual da aplicao, incluindo \ no final do
caminho.

InfoAppHstDir( )

Grupo System Info.
Execuo Sncrona

Descrio: Retorna o diretrio History para a aplicao atual.
Valores de Retorno: Retorna o diretrio History para a aplicao atual como uma string.
Exemplos:
Tag InfoAppAlrDir() // Valor de retorno = C:\DemoApp\HST\
Tag InfoAppAlrDir() // Valor de retorno = C:\ IWS\Projects\App\HST\

InfoDiskFree(strDisk)

Grupo System Info.
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 651

Descrio: Retorna espao disponvel em disco.
Parmetros:
strDisk Tag String contendo o nome do tag disk a ser verificado.

Valores de Retorno: Retorna espao livre (em bytes) no disco.
Exemplos:
Tag InfoDiskFree( C ) // Valor de retorno = 2803804605.000000

InfoResources(numSelecione)

Grupo System Info.
Execuo Sncrona

Descrio: Retorna as origens disponveis do Windows.
Parmetros:
numSelecione Tag Integer contendo a origem a ser examinada.
0: Funes do sistema (%)
1: Funes GDI (%)
2: Funes USER (%)
3: Memria (em bytes)

Exemplos:
Tag InfoResources( 0 ) // Valor de retorno = 76.000000

IWS 20/06/2007

InduSoft Web Studio

Pgina 652
Nota:
A nica seleo vlida em uma estao Windows NT/2000/XP 3. Selecionar 02
retorna somente 0.000000.

IsActiveXReg(numType, strProgIDorFileName)

Grupo System Info.
Execuo Sncrona

Descrio: Determina se um controle ActiveX est registrado.
Parmetros:
NumType Tag numrico especificando um formato para o tag
strProgIDorFileNAme.
0: Verificar pelo ID do Programa
1: Veriicar pelo Nome do Arquivo
strProgIDorFileName Tag String contendo ID do Programa ou Nome do Arquivo
do Controle ActiveX.

Valores de Retorno:
0 ActiveX est registrado.
1 ActiveX no est registrado.

Exemplos:
Tag IsActiveXReg(0, ISSYMBOL.ISSymbolCtrl.1) // Valor de retorno = 0
Tag IsActiveXReg(1, C:\winNT\system32\MediaPlayer.ocx) // Valor de
retorno = 1

KeyPad(TagName, strOptKeyboardType, booOptIsPassword)

Grupo System Info.
Execuo Assncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 653

Descrio: Abre o dilogo Virtual Keyboard para registro ao tag especificado.
Parmetros:
TagName O nome do tag ao qual o Virtual Keyboard ser registrado.
strOptKeyboardType Nome do Virtual Keyboard que ser inicializado. Caso esse
parmetro esteja omitido, o Virtual Keyboard padro ser
inicializado.
booOptIsPassword Caso esse parmetro esteja configurado com qualquer valor
diferente de 0 (zero), os caracteres digitados no Virtual
Keyboard aparecero como*. Essa opo til quando
usurio digita uma senha.

Valores de Retorno: Retorna a hora (em segundos) desde a ltima ao do keyboard.
Exemplos:
Tag NoInputTime()

Nota:
No pode-se implementar essa funo diretamente de um objeto texto I/O.

NoInputTime(optUpdateTrigger)

Grupo System Info.
Execuo Sncrona

Descrio: Retorna o tempo que se passou desde a ltima ao do teclado.
Parmetros:
optUpdateTrigger Tag opcional que dispara uma atualizao quando essa funo
utilizada em um propriedade de texto I/O. Cada vez que o
valor desse tag altera-se, o IWS dispara a funo.

Valores de Retorno: Retorna a hora (em segundos) desde a ltima ao do Teclado.

IWS 20/06/2007

InduSoft Web Studio

Pgina 654

Exemplos:
Tag NoInputTime()

Nota:
No pode-se implementar essa funo diretamente de um objeto de texto I/O.

ProductVersion( )

Grupo System Info.
Execuo Sncrona

Descrio: Retorna o nmero da tag databasedo IWS.
Valores de Retorno:
0 Sucesso
1 Erro

Exemplos:
Tag KeyPad(tagA)
Tag KeyPad(tagA, EnhKeypad)
Tag KeyPad(tagA, EnhKeypad, 1)

SaveAlarmFile(numType, optRemotePath)

Grupo System Info.
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 655

Descrio: Utilize essa funo para habilitar/desabilitar o recurso para salvamento de
histricos de alarme e para configurar o caminho onde os arquivos histricos de alarme devem
ser manuseados.
Parmetros:
NumType Tag contendo o nmero e a operao, como se segue:
0 Desabilita o salvamento de arquivo de alarme para o disco
local.
1 Habilita o salvamento de arquivo de alarme para o disco
local.
2 Habilita o salvamento do arquivo de alarme para o disco local
e para o caminho remoto especificado no parmetro
OptRemotePath.
OptRemotePath Tag contendo o nome do tag do computador remoto onde o arquivo
de alarme ser salvo simultaneamente ao caminho do computador
local quando numType = 2.

Valores de Retorno:
0 Sucesso
1 Segundo parmetro no uma string.
2 Segundo parmetro est faltando.

Exemplos:
Tag SaveAlarmFile(0)
Tag SaveAlarmFile(1)
Tag SaveAlarmFile(2, Z:\Apps\AppDemo)

SetAppAlarmPath(strPath)

Grupo System Info.
Execuo Sncrona

IWS 20/06/2007

InduSoft Web Studio

Pgina 656
Descrio: Configura o caminho para Alarm para a Aplicao atual.
Parmetros:
strPath Tag String contendo o novo caminho para Alarm para a aplicao atual.

Exemplos:
SetAppAlarmPath(C:\ IWS\Alarm\)

SetAppHSTPath(strPath)

Grupo System Info.
Execuo Sncrona

Descrio: Configura o caminho para History para a aplicao atual.
Parmetros:
strPath Tag String contendo o novo caminho History para a aplicao atual.

Exemplos:
SetAppHstPath(C:\ IWS\History\)

SetDateFormat(strSeparator, strFomat)

Grupo System Info.
Execuo Sncrona

Descrio: Configura o formato e separador para a string date.

IWS 20/06/2007

InduSoft Web Studio

Pgina 657
Parmetros:
strSeparator Tag String contendoo caractere separador para a string date.
strFormat Tag string, que especifica a ordem de Ms (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 Parmetro invlido

Exemplos:
Tag SetDateFormat( /, MDY) // Date = 04/18/2002
Tag SetDateFormat( :, MYD) // Date = 04:2002:18

SetWebConfig( strServerIP, strOptBackupURL, strOptPath, numOptHostPort,
strOptSecondaryServerIP, numOptProtocolFlag, numOptGtwPort, strOptGtwIP,
strOptSecondaryGtwIP, strOptISSymbolURL )

Grupo System Info.
Execuo Sncrona

Descrio: Configura os parmetros da web para a aplicao atual. Configura o server
secundrio para dados e as configuraes URL secundrias para a web solution. Os parmetros
configurados em uma funo so atualizados em arquivos HTML da Aplicao.
Parmetros:
strServerIP Endereo IP do Data Server. Endereo IP (ou
hostname) do computador onde o mdulo TCP
Server do IWS est rodando.
strOptBackupURL Alternativa URL Opcional para as web pages da
aplicao. O Web Thin Client procurar por web
pages nessa URL e se no encontr-los no mesmo
URL registrado no campo Address do browser da
IWS 20/06/2007

InduSoft Web Studio

Pgina 658
web.
strOptPath Caminho Opcional onde as web pages que devero
ser atualizadas esto armazenadas.
numOptHostPort Nmero da Porta TCP Opcional que o Web Thin
Client dever utilizar para trocar dados com o
mdulo TCP Server do IWS.
strOptSecondaryServerIP Endereo IP do data server alternativo e Opcional.
O Web Thin Client tentar conectar-se ao mdulo
Server TCP do IWS nesse Endereo IP e no ser
capaz de conectar-se ao mdulo TCP Server module
rodando no Endereo IP especificado no parmetro
strServerIP.
numOptProtocolFlag Opcional - Ao utilizar a opo Web Tunneling
Gateway, esse parmetro especifica se o Web Thin
Client utilizar HTTP para troca de dados com o
Web Server ou HTTPS (SSL Secure Socket Layer).
Caso esse flag possua o valor 0, o Web Thin Client
utilizar HTTP. Caso esse flag possua valor 1, o
Web Thin Client utilizar HTTPS (SSL).
numOptWebPort Nmero de Porta TCP Opcional que o Web Thin
Client dever utilizar para trocar dados com o Web
Server ao utilizar o Web Tunneling Gateway.
strOptGtwIP Endereo IP Opcional (ou hostname) do computador
onde o Web Tunneling Gateway est rodando.
strOptSecondaryGtwIP Endereo 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 Endereo IP se no for
capaz de conectar-se ao Web Tunneling Gateway
rodando no endereo IP especificado no parmetro
strOptGtwIP.
strOptISSymbolURL URL Opcional de onde a tag databaseatualizada de
ISSymbol ((Controle ActiveX) deve ser baixada caso
no seja propriamente registrada na Web Thin
Client station.

Valores de Retorno:
0 Sem Erro
2 Endereo IP do Server invlido
3 URL invlida
IWS 20/06/2007

InduSoft Web Studio

Pgina 659
4 Caminho opcional invlido
5 Web pages no encontradas

Exemplos:
Tag SetWebConfig( "192.168.1.28" )
Tag SetWebConfig( "192.168.1.28", "http://192.168.1.28" )
Tag SetWebConfig(GetComputerIP(), "http://"+GetComputerIP() )
Tag SetWebConfig( "192.168.1.28", "http://192.168.1.28/",
"c:\MyWebPages\" )
Tag SetWebConfig( "192.168.1.28", "http://192.168.1.28/",
"c:\MyWebPages\", 1234 )
Tag SetWebConfig ( "192.168.1.28", "http://200.0.0.10/",
"c:\MyWebPages\", 1234, 192.168.1.29, 0, 80, 200.0.0.1,
200.0.0.10, http://200.0.0.10/MyISSymbol/ )

Nota:
Pode-se utilizar tags ou Expresses como argumentos dessa funo. Portanto,
pode-se utilizar essa funo para configurar os parmetros da WEB
automaticamente durante o runtime, de acordo com as configuraes da rede de
trabalho de cada projeto (IP address, Web Server URL, etc).
Somente o primeiro parmetro dessa funo mandatrio (strServerIP). Os outros
parmetros so opcionais. Os Parmetros que no so configurados em uma
funo assumem os valores padro configurados na janela Project Settings
Web do ambiente de desenvolvimento.
Os seguintes parmetros devem ser omitidos, a menos que voc utilize o Web
Tunneling Gateway: numOptProtocolFlag, numOptGtwPort, strOptGtwIP,
strOptSecondaryGtwIP, strOptISSymbolURL.

IWS 20/06/2007

InduSoft Web Studio

Pgina 660
Funo Loop
Essa funo descreve a funo Loop do InduSoft Web Studio:
For(numInitialValue, numFinalValue, numStep) & Next
For(numInitialValue, numFinalValue, numStep) & Next

Grupo. Loop
Execuo N/A
Web Thin Client N/A

Descrio: Implementa um loop For junto a um script. A seo do script afetada pelo Loop For
comea com a funo For() e termina com a notao Next. A notao Next direciona o script
para a funo For() anterior.
Parmetros:
numInitialValue Tag numrico contendo o passo inicial (incremento) do Loop
For.
numFinalValue Tag numrico contendo o passo final (incremento) do Loop For.
NumStep Tag numrico contendo o passo (incremento) do Loop For.

Valores de Retorno: Retorna o passo no qual o loop est rodando atualmente.
Exemplos:
Tag For( 1, 5, 1)
Next

Nota:
Deve-se compartilhar muitas funes For() com uma notao Next . Como mostrado
no exemplo, deve-se colocar a notao Next no campo do tag do script math.

IWS 20/06/2007

InduSoft Web Studio

Pgina 661
Funo Database Access
Essa seo descreve a Funo Database Access do InduSoft Web Studio, ForceTagChange(strTagName,
numValue).
ForceTagChange(strTagName, numValue)

Grupo Database
Execuo Sncrona

Descrio: Fora o banco de dados a registrar um valor para um tag e atuar como se fosse uma
alterao do tag, mesmo se o novo valor seja igual ao valor antigo.
Parmetros:
strTagName Tag String contendo o nome do tag alvo que ser forado a aceitar o
novo valor.
numValue Tag contendo o novo valor a ser registrado no tag alvo.

Exemplos:
ForceTagChange( TagA, 5 )

IWS 20/06/2007

InduSoft Web Studio

Pgina 662
Funes ODBC
Essa seo descreve as seguintes Funes 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
Execuo Sncrona

Descrio: Inicia uma transao com a origem de dados de conexo.
IWS 20/06/2007

InduSoft Web Studio

Pgina 663
Parmetros:
numHandler Tag Integer contendo o manuseador retornado pela funo
ODBCOpen().

Valores de Retorno:
0 Sucesso
1 Manuseador invlido
2 Banco de Dados no aberto
3 Erro ao comear transao

Exemplos:
Tag ODBCBeginTrans( 5 )

ODBCBindCol(numHandler, strColName, strColType, strTagName)

Grupo ODBC
Execuo Sncrona

Descrio: Retm uma coluna para um tag. Cada vez que voc finalize a reteno de colunas, a
funo ODBCQuery ser solicitada.
Parmetros:
ODBCOpen().
strColName Tag String contendo o nome da coluna do banco de dados.
strColType Tag String contendo a clusula SQL do tipo de dados (uma das que se
seguem):
SQL_BIT
SQL_TINYINT
SQL_LONGVARCHAR
SQL_CHAR
SQL_VARCHAR
SQL_DECIMAL
SQL_NUMERIC
SQL_DATE
SQL_TIME
SQL_TIMESTAMP
SQL_DOUBLE
SQL_REAL
SQL_SMALLINT
SQL_INTEGER
IWS 20/06/2007

InduSoft Web Studio

Pgina 664
strTagName Tag String contendoo nome do tag a ser retido na coluna.

Valores de Retorno:
0 Sucesso
2 Tipo de parmetro invlido
3 Um dos parmetros possui uma string vazia
4 ColType contm um tipo invlido

Exemplos:
Tag ODBCBindCol( 5, OrderDate, SQL_DATE, Order_Date )

ODBCCanAppend(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Retorna se o banco de dados permitir a adio de novos registros.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Banco de Dados no permite novos registros
Non-Zero Banco de Dados permite novos registros

Exemplos:
Tag ODBCCanAppend( 5 )

IWS 20/06/2007

InduSoft Web Studio

Pgina 665
ODBCCanTransact(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Retorna se o banco de dados permite transaes.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Banco de dados no permite transaes.
Non-Zero Banco de dados permite transaes.

Exemplos:
Tag ODBCCanTransact( 2 )

ODBCCanUpdate(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Retorna se o banco de dados pode ser atualizado.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Banco de dados no permite atualizaes.
IWS 20/06/2007

InduSoft Web Studio

Pgina 666
Non-Zero Banco de dados permite atualizaes.

Exemplos:
Tag ODBCCanUpdate( 6 )

ODBCClose(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Fecha uma conexo ao banco de dados.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Sucesso

Exemplos:
Tag ODBCClose( 5 )

ODBCCommitTrans(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Encerra uma transao. Solicite essa funo aps completar transaes.
IWS 20/06/2007

InduSoft Web Studio

Pgina 667
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Sucesso
3 Erro ao cometer transao

Exemplos:
Tag ODBCCommitTrans( 1)

ODBCDelete(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Deleta o registro atual. Aps uma deleo com sucesso. Voc dever explicitar um
das seguintes funes Move para mover os registros deletados.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Sucesso
3 Deleta erro

IWS 20/06/2007

InduSoft Web Studio

Pgina 668
Exemplos:
Tag ODBCDelete( 5 )

ODBCExecuteSQL(numHandler, strSqlCommand)

Grupo ODBC
Execuo Sncrona

Descrio: Executa um comando SQL diretamente. A funo ODBCExecuteSQL no retorna
registros de dados.
Parmetros:
ODBCOpen().
strSqlCommand Tag String especificando um comando SQL vlido.

Valores de Retorno:
0 Sucesso
3 Parmetro invlido
4 Erro na execuo do comando SQL

Exemplos:
Tag ODBCExecuteSQL( 3, )
Tag ODBCExecuteSQL( 4, )

ODBCInsert(numHandler)

Grupo ODBC
IWS 20/06/2007

InduSoft Web Studio

Pgina 669
Execuo Sncrona

Descrio: Insere um novo registro ao banco de dados. O InduSoft utiliza os valores dos tags
em negrito na funo ODBCBindCol para criar o novo registro.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Sucesso
3 Inserir erro

Exemplos:
Tag ODBCInsert( 7 )

ODBCIsBOF(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Retorna se voc esteve acima do primeiro registro do conjunto de registros. (Solicite
essa funo antes de rolar de registro para registro.)
Tambm pode-se utilizar a funo ODBCIsBOF com ODBCIsEOF para determinar se o conjunto de
registros contm quaisquer registros ou se est vazio. Imediatamente aps solicitar ODBCQuery, e
caso o conjunto de registros no contiver registros, ODBCIsBOF retorna um valor diferente de zero.
Ao abrir um conjunto de registros com, ao menos um registro, o primeiro registro ser o registro
atual, e ODBCIsBOF retornar zero (0). Caso o primeiro registro seja o registro atual, e voc
solicitar ODBCMovePrev, a funo ODBCIsBOF subseqentemente retornar o valor zero.
Parmetros:
IWS 20/06/2007

InduSoft Web Studio

Pgina 670
ODBCOpen().

Valores de Retorno:
0 Registro encontrado
Non-Zero Conjunto de registros no contm registros ou voc rolou acima do
primeiro registro

Exemplos:

ODBCIsDeleted(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Relata se o registro atual foi deletado. Caso voc role para um registro e
ODBCIsDeleted retorna um valor diferente de zero, voc dever rolar para outro registro antes
de poder executar quaisquer operaes.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Conjunto de registros no est posicionado ou um registro foi deletado.
Non-Zero Conjunto de registros est posicionado em um registro deletado.

Exemplos:
Tag ODBCIsDeleted( 8 )

Tag ODBCIsBOF( 1 )
IWS 20/06/2007

InduSoft Web Studio

Pgina 671
ODBCIsEOF(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Relata se voc esteve acima do primeiro registro do conjunto de registros. (Solicite
essa funo antes de rolar de registro para registro.)
Tambm pode-se utilizar a funo ODBCIsEOF para determinar se conjunto de registros contm
algum registro ou se est vazio. Imediatamente aps solicitar ODBCQuery (e se o conjunto de
registros no contiver registros), ODBCIsEOF retornar um valor diferente de zero. Ao abrir um
conjunto de registros com ao menos um registro, o primeiro registro o atual e ODBCIsEOF
retornar zero (0). Caso o ltimo registro seja o registro atual quando voc solicitar ODBCMoveNext,
ODBCIsEOF subseqentemente retornar zero.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Registro encontrado.
Non-Zero Conjunto de registros no contm registros ou voc rolou opostamente,
antes do ltimo registro.

Exemplos:
Tag ODBCIsEOF( 5 )

ODBCIsFieldNULL(numHandler, strColName)

Grupo ODBC
Execuo Sncrona

Descrio: Relata se um campo especificado em um conjunto de registros foi transmitido como
Null.

IWS 20/06/2007

InduSoft Web Studio

Pgina 672
Parmetros:
ODBCOpen().
strColName Tag String contendo o nome da coluna.

Valores de Retorno:
0 O campo especificado no transmitido como Null.
Non-Zero O campo especificado transmitido como Null.

Exemplos:
Tag ODBCIsFieldNULL( 7, CustomerName)
Tag ODBCIsFieldNULL( 3, CompanyName)

ODBCIsFieldNullable(numHandler, strColName)

Grupo ODBC
Execuo Sncrona

Descrio: Relata se um campo especificado nullable (pode ser configurado para um valor
Null).
Parmetros:
NumHandler Tag Integer contendo o manuseador retornado pela funo
ODBCOpen().

Valores de Retorno:
0 O campo especificado no transmitido como Nullable.
Non-Zero O campo especificado transmitido como Nullable.

Exemplos:
Tag ODBCIsFieldNullable( 1, Price)
IWS 20/06/2007

InduSoft Web Studio

Pgina 673
Tag ODBCIsFieldNullable( 1, Model)

ODBCMove(numHandler, numOffset)

Grupo ODBC
Execuo Sncrona

Descrio: Move o apontador do registro atual junto a um conjunto de registros, para frente e
para trs. Caso voc passe um valor de 0 para Offset, ODBCMove atualizar o registro atual.
Parmetros:
ODBCOpen().
numOffset Tag Integer contendo o nmero de linhas para mover para frente e para
trs.
Valores positivos movem para frente, em direo ao final do conjunto
de registros.
Valores negativos movem para trs, em direo ao comeo do
conjunto de registros.

Valores de Retorno:
0 Sucesso
3 Mover erro

Exemplos:
Tag ODBCMove(2, 3)
Tag ODBCMove(8, 2)

ODBCMoveFirst(numHandler)

Grupo ODBC
IWS 20/06/2007

InduSoft Web Studio

Pgina 674
Execuo Sncrona

Descrio: Move o primeiro registro junto ao conjunto de registros.
Parmetros:
NumHandler Tag Integer contendo o manuseador retornado pela funo
ODBCOpen().

Valores de Retorno:
0 Sucesso
3 Mover erro

Exemplos:
Tag ODBCMoveFirst(4)

ODBCMoveLast(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Move o ltimo registro junto ao conjunto de registros.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Sucesso
IWS 20/06/2007

InduSoft Web Studio

Pgina 675
3 Mover erro

Exemplos:
Tag ODBCMoveLast(7)

ODBCMoveNext(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Move o prximo registro junto ao conjunto de registros.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Sucesso
3 Fim do conjunto de registros pesquisados
4 Mover erro

Exemplos:
Tag ODBCMoveNext(9)

ODBCMovePrev(numHandler)

Grupo ODBC
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 676

Descrio: Move para o prximo registro junto ao conjunto de registros.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Sucesso
3 Comeo do conjunto de registros alcanados
4 Mover erro

Exemplos:
Tag ODBCMovePrev(2)

ODBCOpen(strDsn, strUser, strPassw, strTable, strFilter, strSort)

Grupo ODBC
Execuo Sncrona

Descrio: Abre uma conexo para o banco de dados.
Essa funo retorna um manuseador a ser utilizado em solicitaes subseqentes para Funes ODBC.
Aps solicitor essa funo, ainda nenhum registro foi lido do banco de dados. Voc dever encerrar as
colunas e chamar a funo ODBCQuery para que ocorra a entrega do primeiro registro.
Parmetros:
strDsn Tag String contendo o Nome do Data Source.
strUser Tag String contendo o Nome do Usurio.
strPassw Tag String contendo a Senha.
IWS 20/06/2007

InduSoft Web Studio

Pgina 677
strTable Tag String contendo o nome da tabela do Banco de Dados.
strFilter Tag String contendo a clusula do SQL: WHERE.
strSort Tag String contendo a clusula SQL: ORDER BY.

Valores de Retorno:
N Se sucesso, retorna o manuseador para identificao do banco de
dados
-1 Parmetro invlido
-2 DSN ou TableName contm uma string vazia

Exemplos:
Tag ODBCOpen(MyDSNFile, Alex, , Table1, Name='Mayer', Name
ASC)
Tag ODBCOpen(DSNFileName, Robert, Robot, Table1, , )

Nota:
Essa funo no abre o banco de dados sozinha, simplesmente cria um manuseador
para a manipulao do banco de dados. Para abrir o banco de dados, deve-se
encerrar as colunas e chamar a funo ODBCQuery.

ODBCQuery(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Entrega o primeiro registro aps a abertura e encerramento da coluna. Caso voc
modificar o encerramento da coluna ou o filtro e sort, voc dever chamar essa funo
novamente.
Parmetros:
ODBCOpen().

IWS 20/06/2007

InduSoft Web Studio

Pgina 678
Valores de Retorno:
0 Sucesso
2 Sem colunas em negrito
3 No possvel abrir o banco de dados
4 No possvel reiniciar o banco de dados
5 Perguntar sobre Erro

Exemplos:
Tag ODBCQuery(6)

ODBCROllback(numHandler)

Grupo ODBC
Execuo Sncrona

Descrio: Reverte as alteraes feitas durante a transao.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Sucesso
3 Erro ao voltar para a transao

Exemplos:
Tag ODBCROllback( 4)

IWS 20/06/2007

InduSoft Web Studio

Pgina 679
ODBCSetFieldNull(numHandler, strColName, numValue)

Grupo ODBC
Execuo Sncrona

Descrio: Direciona um membro de dados de campo no conjunto de registros como Null
(especificamente no tendo valor ou como non-Null.
Parmetros:
ODBCOpen().
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
3 Parmetro invlido
4 Nome da coluna invlido

Exemplos:
Tag ODBCSetFieldNull(2, Price, 1)
Tag ODBCSetFieldNull(4, CompanyName, 0)

ODBCSetFilter(numHandler, strFilter)

Grupo ODBC
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 680

Descrio: Retm os registros selecionados pelo IWS.
Essa funo poder ser til para a seleo de um subconjunto de registros, como "all salespersons based in
California" ("state = CA"). Lembre-se de solicitar ODBCQuery aps chamar essa funo.
Parmetros:
ODBCOpen().
strFilter Tag String contendo a clusula SQL: WHERE.

Valores de Retorno:
0 Sucesso
2 Parmetro invlido

Exemplos:
Tag ODBCSetFilter(3, Name='Morgan')

ODBCSetSort(numHandler, strSort)

Grupo ODBC
Execuo Sncrona

Descrio: Registros especificados selecionados pelo IWS.
Pode-se utilizar esse recurso para especificar os registros em uma ou mais colunas. Lembre-se de
solicitar ODBCQuery aps chamar essa funo.
Parmetros:
ODBCOpen().
strSort Tag String contendo a clusula SQL: ORDER BY.

Valores de Retorno:
0 Sucesso
IWS 20/06/2007

InduSoft Web Studio

Pgina 681

Exemplos:
Tag ODBCSetSort(5,"Name DESC")

ODBCUnbindCol(numHandler, strColName)

Grupo ODBC
Execuo Sncrona

Descrio: Desmembra uma coluna de um tag.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Sucesso
3 Coluna sem limites

Exemplos:
Tag ODBCUnbindCol(7, Name)

ODBCUpdate(numHandler)

Grupo ODBC
IWS 20/06/2007

InduSoft Web Studio

Pgina 682
Execuo Sncrona

Descrio: Atualiza o registro atual. O IWS utiliza os valores de tags bound pela funo
ODBCBindCol para atualizar o registro atual.
Parmetros:
ODBCOpen().

Valores de Retorno:
0 Sucesso
3 Erro na atualizao

Exemplos:

Tag ODBCUpdate(1)

IWS 20/06/2007

InduSoft Web Studio

Pgina 683
Funes Mail
Essa seo descreve as seguintes Funes 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
Execuo Sncrona

Descrio: Configura Parmetros Simple Mail Transfer Protocol (SMTP). Deve-se configurar
esses Parmetros e executar essa funo antes de enviar email com o IWS (e.x. pela funo
SendEmail(),SendEmailExt(), Interface Alarm Email interface, etc.).
Parmetros:
strSMTP Tag String contendo o nome do Server SMTP ou Endereo
IP.
Para aplicaes em CEView, deve-se especificarO Endereo
IP para SMTP IP ao invs do nome do server.
strFrom Tag String contendo o endereo do remetente. Esse
endereo dever ser um endereo de email vlido para o
Server POP3.
strPOP3 Tag String contendoo nome do Server POP3.
strUser Tag String contendo o nome da conta do usurio remetente
para o Server POP3.
strPassword Tag String contendo a senha da conta do usurio para o
Server POP3.
optnumTimeOut Tag Numrico opcional contendo o limite de timeout limit
(em segundos) utilizado ao enviar mensagens. Caso
nenhuma resposta seja recebida do Server aps esse
perodo de tempo, a operao ser abortada
automaticamente.
IWS 20/06/2007

InduSoft Web Studio

Pgina 684
optAuthType
Tag Numrico opcional contendo o Tipo de Autenticao
SMTP:
0 (padro) = Server SMTP no requisita autenticao
1 = Server SMTP requisita auteticao
optstrSMTPUser Tag opcional String contendo o Nome do Usurio utilizado
para logar no Server SMTP quando esse requer
autenticao. Caso esse parmetro seja omitido a o tipo
optAuthType esteja configurado para 1, o valor configurado
para strUser ser automaticamente utilizado como
optstrSMTPUser.
optstrSMTPPassword Tag opcional String contendo a Senha utilizada para logar
no Server SMTP quando esse requer autenticao. Caso
esse parmetro seja omitido a o tipo optAuthType esteja
configurado para 1, o valor configurado para strPassword
tambm ser automaticamente utilizado como
optstrSMTPPassword.

Valores de Retorno:
0 Sucesso
1 Formato invlido para parmetro 1 (strSMTP)
2 Formato invlido para parmetro 2 (strFrom)
3 Formato invlido para parmetro 3 (strPOP3)
4 Formato invlido para parmetro 4 (strUser)
5 Formato invlido para parmetro 5 (strPassword)
6 Formato invlido para parmetro 6 (optnumTimeOut)
7 Quantidade errada de Parmetros
8 Erro na obteno de Endereo IP host (invalid POP3 server)
9 Erro na conexo POP3 server
10 Erro no envio de nome do usurio
11 Erro no envio de senha
12 Server SMTP no suporta modo de autenticao Login\Password
13 Nome do usurio SMTP invlido
14 Falha na autenticao (Usurio e/ou senha invlidos)

IWS 20/06/2007

InduSoft Web Studio

Pgina 685

Exemplos:
Tag CnfEmail ( "smtp.Studio.com", "Robert@Studio.com", "pop.Studio.com",
"RobertH", "Shades556",100)
Tag CnfEmail( "smtp.Studio.com", "Robert@Studio.com", "pop.Studio.com",
"RobertH", "Shades556", 5 ,1)
Tag CnfEmail( "smtp.Studio.com", "Robert@Studio.com", "pop.Studio.com",
"RobertH", "Shades556", 5 , 1 , JohnS , abcd1234 )

GetStatusSendEMailExt(optTagName)

Grupo Mail
Execuo Sncrona

Descrio: Retorna o status do ltimo email enviado na funo SendEmailExt().
Parmetros:
OptTagName Tag opcional que faz com que a funo a ser atualizada retorne seu
valor. Esse parmetro opcional, mas voc dever utilize-lo quando
configurar essa funo para qualquer dinmico de tela (como Text I/O,
Position, etc).

Valores de Retorno:
-2 Verso incorreta da biblioteca INDMail.DLL.
-1 A biblioteca INDMail.DLL est corrompida.
0 Funo SendEmailExt()no est sendo executada.
1 Ainda enviando o ltimo email. No pode-se executar uma funo
SendEmailExt().
2 ltimo email foi enviado com sucesso. Pode-se executar a funo
SendEmailExt() novamente.
3 Houve um Erro no envio do ltimo email. Execute a funo
SendEmailExt()novamente.

IWS 20/06/2007

InduSoft Web Studio

Pgina 686

Exemplos:
Tag GetStatusSendEMailExt(second)
Tag GetStatusSendEMailExt()

SendEMail(strSubject, strMessage, strTO)

Grupo Mail
Execuo Sncrona

Descrio: Manda mensagens de email. Antes de executar essa funo, deve-se configurar
alguns Parmetros utilizando a funo CnfEmail()
Parmetros:
strSubject Tag String contendo o assunto do email.
strMessage Tag String contendo a mensagem do email (at 255 caracteres).
strTo Tag String contendo o endereo do destinatrio (target).

Valores de Retorno:
0 Sucesso
1 Formato invlido para parmetro 1 (strSubject)
2 Formato invlido para parmetro 1 (strMessage)
3 Formato invlido para parmetro 3 (strTo)
4 Quantidade errada de Parmetros
5 Erro ao iniciar Socket
6 Erro na obteno do Endereo host IP (server SMTP invlido)
7 Erro na conexo ao server SMTP
8 Erro no envio do comando HELO (inicializao)
9 Erro no envio do comando MAIL (enviando endereo FROM)
10 Erro no envio do comando RCPT (enviando endereo TO)
IWS 20/06/2007

InduSoft Web Studio

Pgina 687
11 Erro no envio de DATA (enviando mensagem)

Exemplos:
Tag SendEMail( Subject, Message, Wrogers@pnd.net)

SendEMailExt(strSubject, strMessage, strTO, strCC, strBCC, strFile1, ..., strFileN)

Grupo Mail
Execuo Assncrona

Descrio: Envia mensagens de email com arquivos anexados. Antes de iniciar essa funo,
voc dever configurar alguns parmetros utilizando a funo CnfEmail().
Parmetros:
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 endereo do destinatrio.
strCC Tag String contendo os endereos dos destinatrios a serem
CCed.
strBCC Tag String contendo os endereos dos destinatrios a serem
BCCed.
strFile (1-N) Tags String, cada uma contendo o nome e caminho do arquivo
para enviar um email.

Valores de Retorno:
-4 Alguns dos arquivos anexados no foram encontrados.
-3 Nmero errado de parmetros (so requisitados ao menos trs
parmetros).
-2 A verso da biblioteca INDMail.DLL est incorreta.
-1 A biblioteca INDMail.DLL est corrompida.
0 Sucesso
1 No possvel executar a funo porque o ltimo email ainda no foi
IWS 20/06/2007

InduSoft Web Studio

Pgina 688
enviado.
2 Erro interno

Exemplos:
Tag SendEMailExt(Subject, Message, Sam@universe.com, , ,
C:\Projects\report.txt)
Tag SendEMailExt(Subject, Message, David@Ohio.net,
Ted@Austin.com, Bart@Springfield.gov, C:\TechRef51.doc)

Notas:
Deve-se configurar os parmetros Subject, strMessage, e strTO.Todos os outros
parmetros so opcionais.
Pode-se utilizar um valor nulo para a string ("") para strTO, strCC, ou parmetros
strBCC caso voc no esteja utilizando-os.
Pode-se assinar mais de um destinatrio nos parmetros strTO, strCC, ou strBCC
utilizando ponto e vrgula (;) para compartilhar endereos.

IWS 20/06/2007

InduSoft Web Studio

Pgina 689
Funes Dial-Up
Essa seo descreve as seguintes funes 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)
PhoneStatus ("strStatus", optStrModemName)
DialError(numType, strPhonebookEntryOrModem, optErro, optRefresh)

Grupo Dial-Up
Execuo Sncrona

Descrio: Retorna os cdigos do erro referentes a cada conexo.
Parmetros:
numType Tag numrico especificando o tag o contedo do
tag strPhonebookEntryorModem.
0: Phonebook
1: Modem Name
2: Direct Connection Name
strPhonebookEntryOrModem Tag String contendo um Phonebook Name, Modem
Name, ou Direct Connection Name utilizado para
estabelecer a conexo O tag numType especifica
quais desses mtodos sero utilizados.
optErro Tag String opcional contendo o nome do tag string
recebendo a Mensagem de Erro.
IWS 20/06/2007

InduSoft Web Studio

Pgina 690
optRefresh Tag opcional, que faz com que a funo de
atualizao retorne seu valor. Esse parmetros
opcional, embora voc dever utilize-lo ao
configurar essa funo para qualquer dinmico de
tela (como Text I/O, Position, etc).

Valores de Retorno:
0 OK
-1 Erro: INDRas.DLL no encontrado.
-2 Erro: INDRas.DLL danificado.
-3 Erro: nmero invlido de parmetros (mnimo=2).
-4 Valor invlido para o parmetro numType (0 ou 1).
-5 PhoneBook ou Modem no existem.
600 Uma operao est pendente.
601 A porta manuseadora no existe.
602 A porta j est aberta.
603 Buffer do Caller pequeno demais.
604 Informaes de especificao erradas.
605 No possvel configurar as informaes da porta.
606 A porta no est conectada
607 O evento invlido
608 O equipamento no existe.
609 O tipo de equipamento no existe.
610 O buffer est invlido.
611 A rota no est disponvel.
612 A rota no est alocada.
613 Compresso especificada invlida.
614 Sem buffers.
615 A porta no foi encontrada.
616 Uma requisio Assncrona est pendente.
617 A porta ou equipamento j est desconectando.
618 A porta no est aberta.
IWS 20/06/2007

InduSoft Web Studio

Pgina 691
619 A porta est desconectada.
620 No existem endpoints.
621 No possvel abrir o arquivo phone book.
622 No possvel carregar o arquivo phone book.
623 No possvel encontrar a entrada do phone book.
624 No possvel registrar o arquivo phone book.
625 Informao invlida encontrada no arquivo phone book.
626 No possvel carregar uma string.
627 No possvel encontrar a chave.
628 A porta estava desconectada.
629 O link de dados foi finalizado pela mquina remota.
630 A porta foi desconectada devido a falha no hardware.
631 A porta foi desconectada pelo usurio.
632 O tamanho da estrutura est incorreto.
633 A porta j est em uso ou no est configurada para Remote Access
dial out.
634 No possvel registrar seu computador em uma rede de trabalho
remota.
635 Erro desconhecido.
636 O equipamento errado est anexado porta.
637 A string no pode ser convertida.
638 A requisio possui timed out.
639 No h net Assncrona disponvel.
640 Ocorreu um erro NetBIOS.
641 O server no pode alocar NetBIOS necessrias para suportar o cliente.
642 Um de seus nomes NetBIOS j est registrado na rede de trabalho
remota.
643 Falha em um adaptador na rede de trabalho do server.
644 Voc no receber mensagens pop-ups de redes de trabalho.
645 Erro interno na autenticao.
IWS 20/06/2007

InduSoft Web Studio

Pgina 692
646 No permitido efetuar log on dessa conta a essa hora do dia.
647 A conta est desabilitada.
648 A senha expirou.
649 A conta no possui permisso Remote Access.
650 O server Remote Access no est respondendo.
651 Seu modem (ou outro equipamento de conexo) relatou um Erro.
652 Resposta no reconhecida do equipamento.
653 Um macro requisitado pelo equipamento no foi encontrado na seo
do arquivo .INF do equipamento.
654 Um comando ou resposta na seo do arquivo .INF refere-se a um
macro indefinido.
655 <message macro no encontrado seo do arquivo .INF do
equipamento.
656 <defaultoff macro seo do arquivo .INF do equipamento contm um
macro indefinido.
657 O arquivo .INF do equipamento no pde ser aberto.
658 O nome do equipamento no arquivo .INF ou .INI media muito
extenso.
659 O arquivo media .INI refere-se a um nome do equipamento
desconhecido.
660 O arquivo .INF do equipamento no contm respostas para o comando.
661 O arquivo .INF do equipamento falta um comando.
662 Tentativa de configurar um macro no listado na seo do arquivo .INF
do equipamento.
663 O arquivo media .INI refere-se a um tipo de equipamento
Desconhecido.
664 No possvel alocar memria.
665 A porta no est configurada para Remote Access.
666 Seu modem (ou outro equipamento de conexo) no est funcionando.
667 No possvel ler o arquivo media.INI.
668 A conexo caiu.
669 O parmetro utilizado no arquivo media .INI est invlido.
IWS 20/06/2007

InduSoft Web Studio

Pgina 693
670 No possvel ler o nome da seo do arquivo media .INI.
671 No possvel ler o tipo de equipamento no arquivo media.INI.
672 No possvel ler o nome do equipamento no arquivo media.INI.
673 No possvel ler o uso do arquivo media .INI.
674 No possvel ler a taxa de conexo mxima BPS do arquivo media
.INI.
675 No possvel ler a taxa de carrier mxima BPSdo arquivo media .INI.
676 A linha est ocupada.
677 Uma pessoa respondeu ao invs de um modem.
678 No h resposta.
679 No possvel detectar carrier.
680 No 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 usurio e/ou senha est invlido no
domnio.
692 Falha no Hardware na porta ou equipamento anexado.
693 ERRO_NOT_BINRIO_MACRO
694 ERRO_DCB_NOT_FOUND
695 ERRO_STATE_MACHINES_NOT_STARTED
696 ERRO_STATE_MACHINES_ALREADY_STARTED
697 ERRO_PARTIAL_RESPONSE_LOOPING
IWS 20/06/2007

InduSoft Web Studio

Pgina 694
698 Uma keyname de resposta no arquivo .INF do equipamento no est no
formato esperado.
699 A resposta do equipamento causou overfluxo em buffer.
700 O comando ampliado no arquivo .INF do equipamento est muito
extenso.
701 O equipamento moveu para uma taxa BPS No suportada pelo driver
COM.
702 Resposta do equipamento recebida quando no esperado.
703 A Aplicao no permite interao do usurio com requisies de
conexo para ser completada com sucesso
704 ERRO_BAD_CALLBACK_NUMBER
705 ERRO_INVALID_AUTH_STATE
706 ERRO_WRITING_INITBPS
707 Indicao de diagnstico X.25 .
708 A conta expirou.
709 Erro ao carregar a senha no domnio. A senha pode ser muito curta ou
confunde-se com a senha do usurio anterior.
710 Erros Serial overrun foram detectados ao estabelecer comunicao com
seu modem.
711 Inicializao RasMan falhou ao verificar o log do evento.
712 Porta Biplex inicializando: Wait a few seconds and redial.
713 Linhas ativas ISDN no disponveis.
714 Canais ISDN disponveis para fazer uma ligao.
715 Ocorreram muitos erros por causa de da qualidade pobre da linha
telefnica.
716 A configurao IP para Remote Access IP inutilizvel.
717 No h endereos IP disponveis em static pool de endereos IP para
Remote Access.
718 Timed out esperando por uma resposta vlida do remote PPP peer.
719 PPP terminalizado por uma mquina remota.
720 Protocolos de controle PPP no configurados.
721 Remote PPP peer no est respondendo.
IWS 20/06/2007

InduSoft Web Studio

Pgina 695
722 PPP packet est invlido.
723 O nmero de telefone incluindo prefixo e sufixo est muito extenso.
724 O protocolo IPX no pode efetuar dial-out na porta, pois a mquina
um roteador IPX.
725 O proptocolo IPX no pode efetuar dial-in na porta, pois o roteador IPX
no est instalado
726 O protocolo IPX no pode ser utilizado para efeturar dial-out em mais
de uma porta ao mesmo tempo.
727 No possvel acessar TCPCFG.DLL.
728 No possvel encontrar um adaptador em negrito IP para Remote
Access.
729 SLIP No pode ser utilizado a menos que o protocolo IP esteja
instalado.
730 Registro do computador no est completo.
731 O protocolo no est configurado.
732 A negociao PPP no est convergindo.
733 O protocolo de controle PPP para esse protocolo de rede de trabalho
no est disponvel no server.
734 O link do protocolo de controle PPP finalizou.
735 O endereo requisitado foi rejeitado pelo server.
736 O computador remoto finalizou o protocolo de controle.
737 Loopback detectado.
738 O server no assinalou nenhum endereo.
739 O protocolo de autenticao requisitado pelo server remoto no pode
utilizar a senha Redial encriptada do Windows NT, inserindo a senha
explicitamente.
740 ConfiguraoTAPI invlida.
741 O computador local no suporta o tipo de encriptao requisitada.
742 O computador remoto no suporta o tipo de encriptao requisitada.
743 O computador remoto requer encriptao.
744 No possvel utilizar o nmero da rede de trabalho IPX assinalado
pela verificao do log de evento.
745 ERRO_INVALID_SMM
IWS 20/06/2007

InduSoft Web Studio

Pgina 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 Nmero de callback invlido. Somente os caracteres 0 a 9, T, P, W, (,), -
, @, e space so permitidos no nmero.
752 Um erro de sintaxe foi encontrado ao processar um script.
753 A conexo no pde ser desconectada, pois foi criada pelo Router
Multi-Protocol.

Exemplos:
Tag DialError(0, Office DialUp)
Tag DialError(1, USRobotics_SportsterFaxModem, StatusMessage,
second)
Tag DialError(2, DirectDial, DialupErro)

DialGetClienDica(numType, strPhoneBookOrDevice, tagClienDica, optRefresh)

Grupo Dial-Up
Execuo Sncrona

Descrio: Obtm o endereo IP para a Client station RAS de uma conexo Dial-Up. Deve-se
executar essa funo na Client station RAS (no na Server station RAS) ou a funo no
funcionar de maneira adequada.
Parmetros:
numType Tag Numrico especificando o contedo do tag
strPhonebookEntryorModem.
0: Phonebook Name
1: Modem Name
IWS 20/06/2007

InduSoft Web Studio

Pgina 697
strPhonebookEntryOrModem Tag String contendo Phonebook Name, Modem
efetuar a conexo. O tag numType especifica qual
desses mtodos ser utilizado.
tagClienDica Nome do tag string que receber o endereo IP.
optRefresh Tag opcional que faz com que a funo atualize seu
valor de retorno. Esse parmetro opcional, mas
voc dever utiliza-lo ao configurar essa funo
para qualquer dinmico de tela (como Text I/O,
Position, etc).

Valores de Retorno:
-5 Funo GetClienTip no encontrada em IndRAS.DLL.
-4 Tipo invlido (0: Phonebook, 1: Modem, 2: Direct Connection)
-2 Funo DialStatus no encontrada em IndRAS.DLL
-1 IndRAS.DLL no foi carregado
N N: Cdigo do status retornado pela funo DialStatus()

Exemplos:
Tag DialGetClineTip(0, Office DialUp, ClienTipTag)
Tag DialError(1, USRobotics_SportsterFaxModem, ClienTipAddress,
second )
Tag DialError(2, DirectDial, IPAdd)

DialGetServerIP(numType, strPhoneBookOrDevice, "tagServerIP", optRefresh)

Grupo Dial-Up
Execuo Sncrona

Descrio: Obtm o endereo IP para a Client station RAS de uma conexo Dial-Up. Deve-se
executar essa funo na Client station RAS (no na Server station RAS) ou a funo no
funcionar de maneira adequada.
IWS 20/06/2007

InduSoft Web Studio

Pgina 698
Parmetros:
0: Phonebook Name
1: Modem Name
tagServerIP Nome do Tag string que recebe o endereo IP.
voc dever utiliza-lo ao configurar essa funo
para qualquer dinmico de tela (como Text I/O,
Position, etc).

Valores de Retorno:
-5 Funo GetServerIP no encontrada em IndRAS.DLL.
-4 Tipo invlido (0: Phonebook, 1: Modem, 2: Direct Connection)
-2 Funo DialStatus no encontrada em IndRAS.DLL
-1 IndRAS.DLL no foi carregada
N N: Cdigo do Status retornado pela funo DialStatus()

Exemplos:
Tag DialGetClineTip( 0, Office DialUp, ClienTipTag )
Tag DialError( 1, USRobotics_SportsterFaxModem, ClienTipAddress,
second )
Tag DialError( 2, DirectDial, IPAdd)

IWS 20/06/2007

InduSoft Web Studio

Pgina 699
DialStatus(numType, strPhonebookEntryOrModem,
optStatus, optRefresh)

Grupo Dial-Up
Execuo Sncrona

Descrio: Retorna o status de cada conexo
Parmetros:
NumType Tag Numrico especificando o contedo do tag
0: Phonebook Name
1: Modem Name
optStatus Nome do Tag string que recebe o endereo IP.
voc dever utiliza-lo ao configurar essa funo para
qualquer dinmico de tela (como Text I/O, Position,
etc).

Valores de Retorno:
-5 PhoneBook ou modem no existem
-4 Valor invlido para o parmetro numType (0 ou 1)
-3 Erro: nmero invlido de parmetros (mnimo = 2);
-2 Erro: INDRAS.DLL danificado
-1 Erro: INDRAS.DLL no encontrado
0 Abrindo a porta...
1 Porta foi aberta com sucesso.
2 Conectando ao equipamento
IWS 20/06/2007

InduSoft Web Studio

Pgina 700
3 O equipamento foi conectado com sucesso
4 Todos os equipamentos na cadeia de equipamentos foram
conectados com sucesso.
5 Verificando o nome do usurio e senha
6 Ocorreu um evento de autenticao.
7 Outra validao requisitada na tentativa com um novo usurio.
8 Server requisitou um nmero callback.
9 O cliente requisitou alterao de senha
10 Registrando seu computador na rede de trabalho...
11 A fase de clculo link-speed est inciando...
12 Uma requisitao de autenticao est sendo reconhecida.
13 Reautenticao (aps callback) est sendo iniciada.
14 O cliente completou a autenticao com sucesso.
15 A linha fala sobre como desconectar-se de callback.
16 Atraso no envio do tempo de modem para reincio de callback.
17 Esperando por chamadas do server.
18 Informaes do resultado da projeo disponveis.
19 Autenticao do usurio est sendo inicializada ou reenviada.
20 Cliente foi chamado novamente e est para resumir
autenticao.
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.

IWS 20/06/2007

InduSoft Web Studio

Pgina 701
Exemplos:
Tag DialError(0, Office DialUp)
Tag DialError(1, USRobotics_SportsterFaxModem, StatusMessage,
second)
Tag DialError(2, DirectDial, DialupErro)

DialUp(numType, strPhonebookEntryOrModem, strUserName, strPassword, optstrDomain,
strPhoneNumber)

Grupo Dial-Up
Execuo Assncrona

Descrio: Dispara uma conexo dial-up
Parmetros:
numType Tag Numrico especificando o contudo do tag
0: Phonebook Name
1: Modem Name
strUserName Tag String contendo o Username a ser utilizado
para log on.
strPassword Tag String contendo Password a ser utilizado para
log on.
optstrDomain Tag opcional String contendo o nome do domnio
para especificar quando efetuar log on.
strPhoneNumber Tag String contendo o nmero do telefone a ser
discado (utilizado somente quando o parmetro
numType=1).

IWS 20/06/2007

InduSoft Web Studio

Pgina 702
Nota para usurios do Windows NT/2000:
Devido a limitaes no API da Microsoft, a funo DialUp() poder no ser capaz de
criar phonebooks temporarios em Windows NT/2000.
Para lidar com esse problema:
1. Configure DialUp() utilizando o parmetro Modem Name ao invs de
Phonebook Name.
2. Crie um phonebook manualmente no Control Panel e salve-o como IWS
Temporary 1.
IWS utilizar o phonebook IWS Temporary 1 com os parmetros configurados com
a utilizao da funo DialUp() (user name, password, domain, e telephone). Pode-
se, ento, alterar esses parmetros durante o runtime.

Valores de Retorno:
0 OK: discagem iniciada
-3 Erro: nmero invlido de parmetros (mnimo=5)
-4 Valor invlido para o parmetro numType (0 or 1)
-5 Valor invlido para o parmetro strPhonebookEntryOrModem (string)
-6 PhoneBook ou Modem no existem
-7 PhoneBook ou Modem esto em uso;
-8 Depende do parmetro numType:
If numType = 0: No pde ler propriedades de PhoneBook.
If numType = 1: Mais de 1000 conexes esto habilitadas ao mesmo
tempo.
-9 Incapaz de criar um PhoneBook temporrio.

Exemplos:
Nome do
Tag
Expresso
Tag DialUp(0, OfficeDialup, Guest, Password)
Tag DialUp(1, USRobotics_SportsterFaxModem, HR12378, HRPass,
15125554321)
Tag DialUp(2, DirectDial, Rberton, MyPassword, 156.48.25.0)

IWS 20/06/2007

InduSoft Web Studio

Pgina 703
Nota:
O Server RAS do sistema operacional executa a discagem para computadores em
Windows NT/2000/XP de forma automtica.

DialUpToCE(numModem, strDialPhone, strMyNumber, strUser, strPassword, optstrDomain,
optAutoDial, optAutoClose)

Grupo Dial-Up
Execuo Assncrona

Descrio: Executa o programa DialUpToCE, o qual envia as informaes necessrias para
CERasSvr.exe retornar para o computador em Windows NT/2000/XP.
Parmetros:
numModem Tag Numrico contendo o nmero do modem utilizado para
discagem para o computador WinCE.
strDialPhone Tag Numrico contendo o nmero do telefone da estao
remota do WinCE.
strMyNumber Tag Numrico contendo o nmero do telefone da estao
remota do WinCE. CERasSvr.exe ligar de volta para o
nmero desse telefone.
strUser Tag String contendo o nome do usurio a ser enviado para a
estao remota do WinCE. CERasSvr.exe utilizar esse nome
para conectar-se ao computador Windows NT/2000/XP aps
retornar a ligao.
strPassword Tag String contendo a senha a ser utilizada pela estao
remota WinCE. CERasSvr.exe utilizar essa senha para
conectar-se ao computador Windows NT/2000/XP aps
retornar a ligao.
optstrDomain Tag opcional String contendo o nome do domnio a ser
especificado ao efetuar log on.
optAutoDial Tag opcional, o qual pode ser configurado para:
1: Disparar a conexo DialupToCE automaticamente
quando a funo executada
0: Requisitar confirmao antes de disparar a conexo
DialupToCE automaticamente quando a funo executada
IWS 20/06/2007

InduSoft Web Studio

Pgina 704
optAutoClose Tag opcional, o qual pode ser configurado para:
1: Fechar o dilogo DialUpToCE automaticamente aps discar
para a estao remota do WinCE
0: Deixar o dilogo DialUpToCE aberto

Valores de Retorno:
0 Falha, incapaz de discar DialUpToCE.
1 Sucesso, DialUpToCE executado.

Exemplos:
Tag DialUpToCE(0,12344321,98765432, Administrator,MyPass)
Tag DialUpToCE(0,12344321,98765432,
Administrator,MyPass,,1,1)

Nota:
O programa DialUpToCE foi desenvolvido para discagem para uma estao remota
WinCE. O Windows CE v3.00 no fornece um Server RAS, de maneira que voc
dever estar rodando o programa CERasSvr.exe no equipamento WinCE para
responder a uma chamada, e ligar novamente para um computador com Windows
NT/2000/XP com a utilizao dos parmetros enviados pela funo DialUpToCE().
Deve-se configurar o servio RAS Server no computador Windows NT/2000/XP
para retorno de chamada de um equipamento WinCE e configurando tambm a
conexo TCP/IP.

FindAllDevices(tagArray)

Grupo Dial-Up
Execuo Sncrona

Descrio: Retorna a lista de todos os modems disponveis e interfaces de conexo direta (COM
ports) na estao local.
Parmetros:
tagArray Nome de um tag de array string recebendo a lista de modems
disponveis e interfaces de conexo direta.

IWS 20/06/2007

InduSoft Web Studio

Pgina 705
Valores de Retorno: Retorna o nmero de modems e/ou interfaces encontradas.
Exemplos:
Tag FindAllDevices(SerialConnections[1])

FindModem("tagArray")

Grupo Dial-Up
Execuo Sncrona

Descrio: Retorna a lista de todos os modems disponveis na local station.
Parmetros:
tagArray Nome de um tag de array string recebendo a lista de modems
diponveis.

Valores de Retorno: Retorna o nmero de modems encontrados.
Exemplos:
Tag FindModem(Modems[1])

D Dica:
Pode-se utilizar a funo FindModem() para obter o nome da interface serial para
uma conexo dial-up via modem, e utilizar essa informao para preencher o
parmetro strPhonebookEntryOrModem para as funes DialError(), DialStatus(),
DialUp(), e HangUp().

HangUp(numType, strPhonebookEntryOrModem)

Grupo Dial-Up
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 706

Descrio: Finaliza uma conexo dial-up.
Parmetros:
0: Phonebook Name
1: Modem Name

Valores de Retorno: Essa funo retorna os seguintes valores:
0 OK.
-3 Valor invlido para o parmetro numType (0 ou 1)
-4 PhoneBook ou modem no existem
-5 Modems configurados no existentes

Exemplos:
Tag HangUp(0, OfficeDialup)
Tag HangUp(1, USRobotics_SportsterFaxModem)
Tag HangUp(2, DirectDial, Rberton, MyPassword)

PhoneDialUp(strPhoneNumber, OptStrModemName)

Grupo Dial-Up
Execuo Assncrona

IWS 20/06/2007

InduSoft Web Studio

Pgina 707
Descrio: Disca para um nmero de telefone utilizando TAPI (Telephony Aplication Program
Interface).
Parmetros:
strPhoneNumber Nmero do telefone ao qual a funo ligar.
OptStrModemName Nome do modem utilizado para discar. Caso voc no
especifique um modem, o IWS utilizar p primeiro modem
encontrado no Sistema Operacional.

0 OK (disdcagem disparada)
-3 Biblioteca INDTAPI.DLL no encontrada
-4 Funo PhoneDialUp() no suportada pela biblioteca atual
INDTAPI.DLL

Exemplos:
PhoneDialUp (512-123-4567)
PhoneDialUp (StringPhoneNumberTag)
PhoneDialUp (StringPhoneNumberTag, StringModemNameTag)


Grupo Dial-Up
Execuo Sncrona

Descrio: Desabilita o IWS de responder ao modem para chamadas a receber.
Parmetros:
especifique um modem, o IWS utilizar p primeiro modem

IWS 20/06/2007

InduSoft Web Studio

Pgina 708
1 OK (pra a resposta para chamadas a serem recebidas)
-2 Funo PhoneDisableListen() No suportada pela biblioteca atual
INDTAPI.DLL

Exemplos:
PhoneDisableListen ()
PhoneDisableListen (Hayes Compatible Modem on COM1)
PhoneDisableListen (StringModemNameTag)


Grupo Dial-Up
Execuo Sncrona

Descrio: Habilita o IWS de responder ao modem para chamadas a receber.
Parmetros:
especifique um modem, o IWS utilizar o primeiro modem

1 OK (respondendo chamadas a receber)
0 Erro na execuo da funo PhoneEnableListen()
-2 Funo PhoneEnableListen() No suportada pela biblioteca
atual INDTAPI.DLL

Exemplos:
PhoneEnableListen ()
IWS 20/06/2007

InduSoft Web Studio

Pgina 709
PhoneEnableListen (Hayes Compatible Modem on COM1)
PhoneEnableListen (StringModemNameTag)


Grupo Dial-Up
Execuo Assncrona

Descrio: Finaliza uma conexo dial-up disparada com a funo PhoneDialUp().
Parmetros:

1 OK (a conexo discada foi modificada)
-2 Funo PhoneHangUp()No suportada pela biblioteca atual
INDTAPI.DLL

Exemplos:
PhoneHangUp()
PhoneHangUp (Hayes Compatible Modem on COM1)
PhoneHangUp (StringModemNameTag)

PhoneStatus ("strStatus", optStrModemName)

Grupo Dial-Up
Execuo Sncrona
IWS 20/06/2007

InduSoft Web Studio

Pgina 710

Descrio: Verifica o status das conexes atuais.
Parmetros:
strStatus Nome do tag que receber o texto de descrio do status
optStrModemName Nome do modem utilizado para discar. Caso voc no

0 Ready to make a call
1 Call was shut down
2 Line Ringing
3 Dial Tone
4 Dialing Call
5 Call is Proceeding
6 Ring Back
7 Line is Busy
8 Line is Idle
9 Disconnected

Exemplos:
Tag Status
Code
PhoneStatus (String Tag Status)
Tag Status
Code
PhoneStatus (String Tag Status, Hayes Compatible Modem on
COM1)
Tag Status
Code
PhoneStatus (String Tag Status, StringModemNameTag)

IWS 20/06/2007

InduSoft Web Studio

Pgina 711
Funes ActiveX
Essa seo descreve as seguintes funes 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
Execuo Assncrona

Descrio: Executa (PropGet) no objeto ActiveX especificado.
Parmetros:
strName Tag String contendo o nico nome de dados ao objeto ActiveX
alvo.
strProperties Tag String contendo o mtodo especfico a ser utilizado.

Valores de Retorno: Retorna o valor da propriedade como relatada pelo objeto ActiveX.
Exemplos:
Tag XGet(ActXRec, Color)

XRun(strName, strMethod, Parameter1, Parameter2, , ParameterN)

Grupo ActiveX
Execuo Assncrona

Descrio: Executa (Method) no objeto ActiveX especificado.
IWS 20/06/2007

InduSoft Web Studio

Pgina 712
Parmetros:
strName Tag String contendo o nico nome de dados ao objeto ActiveX
alvo.
strMethod Tag String contendo o mtodo especfico a ser utilizado.
Parameter (1-N) Tag de vrios tipos contendo dados requisitados por (Method)
para rodar.

Valores de Retorno: Retorna o resultado (Method) como reportado pelo objeto ActiveX (nem
todos os mtodos retornam resultados).
Exemplos:
Tag XRun(ActXCir, XPos, 12, 4.6, 0.2, 1)

Nota:
O nmero de parmetros pode ser configurado na funo XRun(). Podem variar de
0 a 255 e depende de cada componente ActiveX. Pode-se utilizar tags para
configurar os parmetros, mas os tipos de tags devero corresponder aos tipos dos
parmetros do componente (Boolean, Integer, String, ou Real).

XSet(strName, strProperties, Value)

Grupo ActiveX
Execuo Assncrona

Descrio: Executa (PropPut) no objeto ActiveX especificado.
Parmetros:
strName Tag String contendo o nico nome dados ao objeto ActiveX
alvo.
strProperties Tag String contendo o mtodo especfico a ser utilizado.
Value Tag of any type contendo o valor a ser colocado no objeto
ActiveX


IWS 20/06/2007

InduSoft Web Studio

Pgina 713
Exemplos:
Tag XSet(ActXDisplay, Display, Status Normal)

IWS 20/06/2007

InduSoft Web Studio

Pgina 714
Event Logger Funes
Essa seo descreve a Funo Event Logger do InduSoft Web Studio: SendEvent(strEvent).
SendEvent(strEvent, optBooFlag, optStrComment)

Grupo Event Logger
Execuo Sncrona

Descrio: Utilize para enviar um evento para o arquivo Event Log.
Essa funo possui uma opo que permite a criao de um comentrio. Quando essa opo est
habilitada, o usurio requisitado a inserir um comentrio aps a execuo da funo SendEvent().
Tal comentrio ser salvo no arquivo Event Logger.
Parmetros:
strEvent String value ou tag contendo o texto a ser salvo no arquivo
Event Log.
optBooFlag Se omitido ou igual a 0 (zero), o evento no possui um
comentrio. Do contrrio, existir um comentrio associado
ao evento.
optStrComment String de valor do tag contendo o texto do comentrio para o
evento salvo no banco de dados. Se omitido, o usurio
receber um dilogo padro onde o comentrio poder ser
digitado.

Valores de Retorno:
0 Sucesso
1 Logger de Evento est desabilitado no dilogo Event Settings.
2 Logger de Evento est habilitado, mas Custom Messages est
desabilitado no dilogo Event Settings.
Exemplos:
Tag SendEvent(Valve Open) // Salva a mensagem de evento.
Tag SendEvent(Valve Open Oven No. + OvenID) // Salva a mensagem de
evento concatenada ao valor do tag OvenID
Tag SendEvent(Valve Open, 1) // Exibe um dilogo onde o operador
IWS 20/06/2007

InduSoft Web Studio

Pgina 715
poder digitar seus comentrios.
Tag SendEvent(Valve Open, 1, TagComment) // Salva a mensagem de
evento com comentrio configurado no tag TagComment.

C Ateno:
Essa funo Sncrona. Portanto, a execuo dessa funo finaliza-se somente
aps os dados do evento (incluindo o comentrio, caso exista) estarem salvos no
arquivo do banco de dados. recomendado que voc no configure essa funo em
tarefas background (e.x. Math e Scheduler), a menos que voc no planeje utilizar o
comentrio ou configur-lo diretamente (digitando a partir do dilogo) na funo.

IWS 20/06/2007

InduSoft Web Studio

Pgina 716

Funes FTP
Essa seo descreve as seguintes funes 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
Execuo Sncrona

Descrio: Configura parmetros FTP (File Transfer Protocol). Deve-se configurar esses
parmetros e executar essa funo antes de transferor arquivos com funes FtpGet ou FtpPut.
Parmetros:
strServer Nome do server FTP
strUser
Nome do usurio
Padro Anonymous.
strPwn
Senha do usurio
Padro blank.
numPassiveMode
0 Modo passivo desabilitado
1 Modo passivo habilitado
Padro 0.
numPort
Nmero da Porta TCP/IP
Padro 21.

Valores de Retorno:
0 Sucesso
-2 Nome do server invlido
-3 Nome do usurio invlido

IWS 20/06/2007

InduSoft Web Studio

Pgina 717
Nota:
Essa funo no tenta estabelecer uma conexo com o Server FTP, mas deve ser
chamada antes de utilizar outra funo FTP.

Exemplos:
Tag CNFFtp(ftp.mycompany.com, admin, 12345, 1) // Configura o
server ftp utilizando o modo passive

ftpGet (strRemoteFile , strLocalFile , numOverWrite , numTransferType)

Grupo FTP
Execuo Assncrona

Descrio: Essa funo entrega um arquivo a partir do server FTP e armazena-o sob o nome do
arquivo especificado, criando um novo arquivo local. Antes de executar essa funo, deve-se
configurar alguns parmetros utilizando CNFFtp. Essa funo executada assincronicamente;
Portanto, voc precisar chamar FtpStatus de modo a determinar se a transferncia foi
completada com sucesso.
Parmetros:
strRemoteFile
Nome qualificado completo do arquivo remoto (e.x.
/Folder/File.extension)
Note que alguns servers FTP so sensveis a letras maisculas e
minsculas, de maneira que voc ter que inserir a capitalizao
correta.
strLocalFile
Nome qualificado completo do arquivo local (e.x.
C:\file.extension)
numOverWrite
0 Erro se o Arquivo Local j existe
1 Sobreposto
Padro 0.
numTransferType
0 Desconhecido
1 ASCII
2 Binrio
Padro 0.

IWS 20/06/2007

InduSoft Web Studio

Pgina 718
Valores de Retorno:
1 Falha ao criar fileira FTP
0 Sucesso
-2 Erro no sistema desconhecido
-3 Arquivo remoto invlido
-4 Arquivo local invlido
-5 Tipoo de transferncia invlida

Exemplos:
Tag FtpGet(\Reports\040303.txt, C:\Report.txt) // Entrega o arquivo
040303 da pasta Reports no Server FTP e armazena-o no arquivo
C:\Report.txt

ftpPut (strLocalFile , strRemoteFile, numTransferType)

Grupo FTP
Execuo Assncrona

Descrio: Essa funo armazena um arquivo no server FTP. Antes de executar essa funo,
voc dever configurar alguns parmetros utilizando CNFFtp. Essa funo executada
assincronicamente, portanto, voc precisar solicitar FtpStatus de modo a determinar se a
transferncia foi executada com sucesso.
Parmetros:
strLocalFile
Nome qualificado completo do arquivo local (e.x.
C:\file.extension)
strRemoteFile
Nome qualificado completo do arquivo remoto (e.x.
/Folder/File.extension)
Note que alguns servers FTP so sensveis a letras
maisculas e minsculas, de maneira que voc ter que
inserir a capitalizao correta
optnumTransferType
0 Desconhecido
1 ASCII
2 Binrio
Padro 0.

IWS 20/06/2007

InduSoft Web Studio

Pgina 719
Valores de Retorno:
1 Falha ao criar fileira FTP
0 Sucesso
-1 Nmero invlido de Parmetros
-2 Erro no sistema desconhecido
-3 Arquivo remoto invlido
-4 Arquivo local invlido
-5 Tipo de transferncia invlida

Exemplos:
Tag FtpPut(C:\Report.txt, \Reports\040303.txt) // Entrega o arquivo
C:\Report.txt com o nome 040303.txt na pasta Reports no Server
FTP.

ftpStatus ( strStatusTag )

Grupo FTP
Execuo Sncrona

Descrio: Essa funo retorna o status atual de uma transao iniciada com FtpGet or FtpPut.
O valor de retorno indica o status como descrito abaixo.
Parmetros:
strStatusTag String com descrio de satus.

Valores de Retorno:
1 Transao executada com sucesso
2 Resolvendo nome
3 Nome resolvido
4 Conectando ao server
5 Conectado ao server
6 Fechando conexo
7 Conexo fechada
8 Enviando requisio
9 Requisio enviada
10 Recebendo resposta
IWS 20/06/2007

InduSoft Web Studio

Pgina 720
11 Resposta recebida intermediria
12 Resposta recebida
13 Requisio completada
0 Nenhuma transao est sendo executada.
-2 Descrio opttagErro invlida
-6 Erro na abertura da conexo (veja string status para detalhes)
-7 Erro no estabelecimento da conexo (veja string status para detalhes)
-8 Erro no recebimento do arquivo (veja string status para detalhes)
-9 Transferncia em pendncia

Exemplos:
Tag FtpStatus( StatusDescrio ) // Entrega o status da transfrncia
atual. O cdigo de retorno armazenado no tag StatusCode e a
Descrio no tag StatusDescrption.

IWS 20/06/2007

InduSoft Web Studio

Pgina 721
Funes do Banco de Dados
Essa seo descreve as funes 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
Execuo Assncrona

Descrio: Sincroniza o banco de dados alarm [Event, Trend].
Parmetros:
strStartDate String com a data de incio. Caso esse parmetro no
esteja especificado, a data atual utilizada.
strOptionalEndDate String com a data final. Caso esse parmetro no esteja
especificado as funes utilizam a mesma data de
incio.

Valores de Retorno:
1 Falha ao iniciar sincronizao; o banco de dados provavelmente est
sendo sincronizado.
0 Sucesso
-1 Nmero do grupo invlido
-2 O formato no est configurado para Database.
-4 Data de incio especificada invlida.
-5 Data final especificada invlida.
-6 Data de incio maior que data final.

IWS 20/06/2007

InduSoft Web Studio

Pgina 722
Exemplos:
Tag SyncAlarm() //Sincroniza o banco de dados utilizando a data atual
Tag SyncAlarm(10/20/2004) //Sincroniza o banco de dados somente
para o dia 10/20/2004
Tag SyncAlarm(10/20/2004, 10/28/2004) //Sincroniza o banco de
dados de 10/20/2004 at 10/28/2004

SyncEvent( strOptionalStartDate, strOptionalEndDate)

Grupo Database
Execuo Assncrona

Parmetros:
strOptionalStartDate String com a data de incio. Caso esse parmetro no
especificado as funes utilizam a mesma data de incio.

Valores de Retorno:
sendo sincronizado.
0 Sucesso

IWS 20/06/2007

InduSoft Web Studio

Pgina 723

Exemplos:
Tag SyncEvent() //Sincroniza o banco de dados utilizando a data atual
Tag SyncEvent(10/20/2004) //Sincroniza o banco de dados somente
para o dia 10/20/2004
Tag SyncEvent(10/20/2004, 10/28/2004) //Sincroniza o banco de
dados de 10/20/2004 para 10/28/2004

SyncTrend(numGrupo, strOptionalStartDate, strOptionalEndDate)

Grupo Database
Execuo Assncrona

Parmetros:
numGrupo Nmero do grupo Trend
strOptionalStartDate String com a data de incio. Caso esse parmetro no
especificado as funes utilizam a mesma data de
incio.

Valores de Retorno:
sendo sincronizado.
0 Sucesso
IWS 20/06/2007

InduSoft Web Studio

Pgina 724

Exemplos:
Tag SyncTrend(1) //Sincroniza o grupo 1 do banco de dados utilizando a
data atual
Tag SyncTrend(1, 10/20/2004) //Sincroniza o grupo 1 do banco de
dado somente para o dia 10/20/2004
Tag SyncTrend(10/20/2004, 10/28/2004) //Sincroniza o grupo 1 do
banco de dados de 10/20/2004 a 10/28/2004

SyncAlarmStatus( )

Grupo Database
Execuo Sncrona

Descrio: Retorna o status de sincronizao.

Valores de Retorno:
3 Sincronizao finalizada.
2 Falha na sincronizao
1 Ainda sincronizando
0 Sincronizao no est sendo executada.

Exemplos:
Tag SyncAlarmStatus()

IWS 20/06/2007

InduSoft Web Studio

Pgina 725
SyncEventStatus( )

Grupo Database
Execuo Sncrona


Valores de Retorno:
3 Sincronizao finalizada.

Exemplos:
Tag SyncEventStatus()

SyncTrendStatus(numGrupo)

Grupo Database
Execuo Sncrona

Parmetros:
numGrupo Nmero do grupo Trend

Valores de Retorno:
3 Sincronizao finalizada.. volume
IWS 20/06/2007

InduSoft Web Studio

Pgina 726

Exemplos:
Tag SyncTrendStatus(1)

Histrico de Revises

Reviso Autor Data Comentrios
A Bruno Cervantes 14 de maro de 2007 Reviso portugus
B Bruno Cervantes 20 de junho de 2007 Formato IWS

Manual Portugues ISW V6.1sp2-727pag

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Manual Portugues ISW V6.1sp2-727pag

Caricato da

Copyright:

Formati disponibili

InduSoft Web Studio v6.

Web Studio. Essa publicao prove informaes e instrues

Pentium IV-compatvel ou mais

(necessrio para visualizar os documentos da

(para retirar do zip os arquivos comprimidos).

da Microsoft para fazer

Potrebbero piacerti anche