Executando a Aplicação

Você pode testar a aplicação em um dos seguintes modos:

• Usando Run> Test - Permite que você execute o projeto em modo de segurança, ativando o aplicativo com algumas características protegidas. Os dados históricos, alarmes e eventos são gravados para arquivos temporários para que não afetem os registos de produção, e os módulos de comunicação não podem escrever dados nos IEDs.

• Usando Run> Startup - Permite você executar o projeto em pleno funcionamento, sem a necessitar fazer o "Build" do projeto.

Você pode executar o projeto usando ambos Test e StartUp ao mesmo tempo.
Para obter informações sobre como utilizar as ferramentas de diagnóstico disponíveis, consulte "Ativando as Ferramentas de Diagnóstico"

Para testar o aplicativo:

1. Siga uma das seguintes opções:

   • Vá para Run> Test.

   • Vá para Run> Startup.

2. Digite ou selecione as informações, conforme necessário.

• Clique em Run Test or Run Startup para iniciar a execução.

Ferramentas para diagnose

Depois de iniciada a execução de um projeto você pode, utilizando a Startup window, selecionar algumas ferramentas de diagnose, que mostram as janelas:

• PropertyWatch (Watch)

• TraceWindow (Trace)

• ModuleInformation (Info).

Você também pode iniciar as ferramentas de diagnóstico, como explicado acima, nas páginas
Run-Test e Run-StartUp pressionando o botão esquerdo do mouse sobre os ícones das
ferramentas de diagnóstico. Se os menus estão habilitados para as Telas você também pode acessar o menu Ferramentas em tempo de execução.

Info - Informação dos módulos

A janela Info - Module Information contém informações sobre o funcionamento dos módulos. Por exemplo ao escolher um módulo de Device e um canal específico, tem-se várias informações sobre o funcionamento do canal de comunicação.
Um ponto muito importante é o Ler Grupos de Informação, pois fornece informações sobre os grupos virtuais de leitura, tempo de execução de cada item, quantidade de leituras e leituras que falharam, e também relatórios sobre o código e data / hora do último erro.
Para a investigação de problemas, os seguintes passos tipicamente devem ser seguidos quando se utiliza o Módulo de Informação:

1. Vá para "Read Groups Information", para verificar os números de sucessos e falhas na comunicação, a fim de identificar rapidamente os blocos de comunicação.

2. Se você tem um erro sistemático em todos os blocos, ou códigos de status com valores negativos, normalmente isso significa que você não pode acessar o dispositivo remoto. Verifique se o endereço do nó está correto.

3. Se você tem um ou outro bloco com erro sistemático, verifique as tags e endereços relacionados com o bloco. Use o TraceWindow com informações de Devices para coletar informações sobre esses erros de comunicação.

4. Para alguns protocolos, como OPC, os itens descartados vão mostrar endereços errados na configuração.

Ao executar o aplicativo no modo teste no Modelo Enterprise, tenha em mente que neste modo, somente são executadas leituras a partir de dispositivos de campo, mesmo que você tenha uma configuração para escrever para o campo.
É muito útil executar o aplicativo com ONLINE CONFIGURATION habilitada, para que não seja preciso parar/iniciar o módulo Device ao modificar a configuração. Você pode modificar os endereços PLC em Points, os AccessTypes e a maior parte da aplicação e ver em tempo real os resultados na execução. Você pode usar o Startup-Window ou o Propertywatch para iniciar e parar apenas um módulo, como os Devices, em vez de reiniciar todo o sistema de execução.

Watch - Tags, Estados e Propriedades

O Property Watch é uma ferramenta de diagnóstico usado para o acesso de atributos em tempo real e propriedades de Tags internas do sistema para leitura ou escrita. Basta digitar o nome da propriedade do objeto na coluna e obtém-se o seu valor na coluna Valor.

Ex: Tag.Coils, Device.Channel.Modbus.Status. No lado direito, temos propriedades do objeto selecionado.
criação de tags. Entre essas propriedades estão valor, timestamp e qualidade.
O Action.NET usa para codificação de Qualidade as qualidades definidas pela Especificação de Dados OPC.
Veja os códigos de qualidade principais em "Códigos de Qualidade OPC DA"

Janela de Trace

A janela de Trace (rastreamento) é a ferramenta que informa as mensagens do sistema em uma interface do tipo DataGrid (tabela). Ao ativar os dispositivos do módulo no botão Configurações, temos informações sobre o estado de leituras, escritas, não solicitados, quadros TX (envio) e RX (recebido).

Quando se clica no botão Settings na aparece uma janela de configuração onde se pode selecionar quais tipos de mensagens e módulos, que serão mostrados no DataGrid de trace. Estes dados que aparecem podem também ser salvos em arquivos para uma análise mais completa. Também é possível configurar um tag em ObjectName clicando no botão Add. Ai aparece uma janela com um menu para selecionar objetos para incluir no monitoramento.

Construindo e Empacotando Projetos

A função de "build" é iniciada pressionando-se o ícone Build no painel sub-menu do ambiente de trabalho Run. Aparece a área de trabalho mostrada abaixo, para o controle da função. Build serve para recompilar todos os objetos telas e scripts do projeto para verificação final quanto a possíveis erros antes da colocação do projeto para a produção.
É feita uma verificação completa da lógica da aplicação durante a preparação dos arquivos para a versão final de produção. Esta operação não é necessária durante o desenvolvimento do projeto, já que todas as modificações são automaticamente e transparentemente sendo compiladas em "background" enquanto as edições são feitas.
A área de trabalho tem duas abas com tabelas informativas, não alteráveis. São os relatórios da atividade de Build.
Messages - Que mostra o status corrente de cada script e tela com informação sobre erros potenciais ou alertas sobre a lógica.Se você não executar um "Build" completo, a coluna BuildStatus neste relatório, mostra quaisquer avisos ou erros encontrados durante o processo de compilação em background.
Dê um duplo clique em uma linha com um X vermelho para ir para o código fonte onde está a linha que gerou este aviso ou erro. Os avisos são informativos e não servem para que o script seja executado. Erros impederm a execução do script especificado, mas não afetam a aplicação inteira. Se um script ou monitor tem um aviso, ele ainda será executado.

History - Mostra a lista de execuções de BUILD feitas neste projeto, informando vários detalhes sobre cada uma destas execuções, como data, ocorrência de erros, versão do produto, usuário que executou, e outras.
References - É uma terceira aba que deve ser utilizada para o registro de Referências à arquivos de código externos ou do próprio usuário utilizados pelos scripts definidos e utilizados no projeto.

Building projetos

Periodicamente, você deve executar uma compilação completa (Build):

• Quando você fez muitas mudanças e você quer uma validação completa e recompilação de todo o projeto.

• Quando você deseja atribuir um número de compilação para uma versão.

• Quando você quer "empacotar" o banco de dados. Quando o "build" é executado, o sistema cria um backup do arquivo de projeto atual. Se você deseja salvar o projeto como ele era antes desta compilação, renomeie o arquivo de backup.

• Quando você está se preparando para fazer uma publicação, ou seja, criar uma aplicação somente leitura para tempo de execução, em ambiente de produção.

Para criar o aplicativo de produção pelo Build:

1. Vá para Run> Build> Messages.

2. Se você desejar "empacotar" o banco de dados, selecione a opção "Pack database after build" (empacote o banco de dados após a execução do Build).

   • O empacotamento, reduz significativamente o tamanho do arquivo de projeto. O sistema cria um arquivo com a extensão de backup, que é o banco de dados antes do empacotamento. Normalmente, você vai querer empacotar o banco de dados cada vez que você executar uma compilação.

3. Se você quiser salvar todas as telas, selecione a opção "Verify Symbols and Save all displays"

   • Certifique-se de usar esta opção se você tiver feito alterações para a biblioteca de símbolos. Esta opção se aplica a todas as modificações na biblioteca de símbolos ao longo do projeto.

   • A opção "include debug information" deverá ser selecionada se você desejar que após o Build ainda exista informação para a depuração de scripts.

4. Clique no botão Build.

Referências à códigos externos

Na aba References do menu Build pode-se criar referências a DLLs externas ou verificar referências já existentes.

Para criar uma referência à uma DLL externa:

1. Vá para Run>Build>References.

2. Clique no botão Add DLL reference. Será mostrada a janela comum de MS- Windows para a seleção de um arquivo.

3. Navegue até onde está a DLL que você quer fazer a referência e clique sobre ela.

4. Aparece então a janela de definição de Referência mostrada abaixo. Digite ou selecione as informações, conforme necessário.

Para verificar referências existentes:

1. Vá para Run>Build>References.

2. Clique no botão Verify References.

   • Serão mostradas no DataGrid todas as DLL externas já referidas nos scripts existentes no projeto.

Controle de Versão de Projetos

Nesta secção são apresentadas as funcionalidades existentes no Action.NET para o controle de versões do projeto.

Controle das alterações de configuração

O Action.NET implementa várias maneiras de ajudá-lo a manter o controle das mudanças de configuração do projeto:

• Todas as tabelas de configuração tem para cada registro, a DateCreated e as informações DateModified.

• O Run-Build-History registra e mostra todos os comandos BUILD executados para o projeto. Um backup do projeto para cada estado pode ficar disponível de acordo com as configurações do usuário.

• O Info> Track> Tables mostra todas as tabelas de configuração, listando o número de linhas de cada uma e se foram alteradas desde a ultimo Build e o ultimo Publish.

• O Info> Track> Changes mostra todos os objetos do projeto que foram modificados. Para ativar ou desativar esta funcionalidade, você deve estar logado como administrador do aplicativo. Por default, o rastreamento de objetos só é ativado depois de uma operação de Publish (publicar) do projeto, mas você pode ativar a qualquer momento, independentemente de utilizar ou não o recurso de publicar.

• Em Info > Track > Releases - É apresentada a lista de todas as versões de publicações realizadas. A lista apresenta a versão, data da publicação, o numero de "build" e o usuário que executou a publicação.Também são mostrados as versões de produto, nome, familia e outras.

Publicando o Projeto

Publish (publicar) o projeto cria uma versão somente leitura do projeto, que poderá ser colocada no ambiente final de produção sem o risco de puder ser alterada.
NÃO é necessário publicar o projeto para instalá-lo em um ambiente final de produção. Em cenários em que você pretende ainda ter mudanças contínuas no projeto já em campo, é mais simples colocar o arquivo do projeto principal, TPROJ, diretamente no computador de produção.
Os benefícios da publicação são os de o sistema criar uma versão compactada e somente leitura do arquivo de projeto. O arquivo criado tem o mesmo nome do arquivo de projeto, inclui um número da versão publicada e usa a extensão TRUN.
Os cenários típicos para a execução de comando Publish são as seguintes:

• Você quer implantar uma versão somente leitura do projeto, por exemplo, para estar em conformidade com ambientes certificados e regulamentados.

• Você quer usar o sistema de numeração de versão automática. O resultado da publicação é um arquivo TENG. Que também contém um número da versão, com um digito maior (1.0) e um menor(0.1) como parte do nome do arquivo. Além disso, Info> Track ajuda a gerenciar os arquivos publicados, incluindo o numero de Build atual do projeto.

• Você quer menor tamanho do arquivo do projeto e carregamento mais rápido do mesmo na partida, por exemplo, em máquinas, OEM e sistemas embarcados. O arquivo TRUN pode ser de até 5 a 10 vezes menor do que o arquivo do tipo TPROJ.

• Você quer proteger o projeto de modificações.

Para publicar o projeto:

1. Vá para Run> Build> Messages.

2. Selecione as configurações de compilação desejada e clique em Build.

3. Vá para Run> Publish.

   • Os campos de configurações do projeto atual mostram o status de somente leitura do projeto.

4. Selecione as Configurações de publicação que você deseja.

5. Clique Publish.

Objetos runtime Information

Há nomes de alguns objetos de tempo de execução que fornecem informações sobre a execução do projeto.
O namespace Info é o principal local para o estado do tempo de execução. Os principais objetos no namespace que são:
Info.Project: informações sobre o projeto que está sendo executado
Info.License: informações sobre a licença
Info.Module: Informação e comando start / stop para os Módulos
Info.Trace (): exibe uma mensagem no TraceWindow
Info.TestMode: mostra se o projeto está sendo executado em modo de teste O namespace Server tem informações sobre o computador servidor.
O namespace Client tem informações sobre cada computador cliente. executando uma interface gráfica.
Para a referência de programação completa em objetos de tempo de execução, Veja http:// www.spinengenharia.com.br/help/an-2016/runtime/index.html.