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.

Campo

Descrição

UserName

Digite um nome de usuário válido para acessar o aplicativo.

Password

Digite a senha que corresponde ao nome do usuário.

Project Server

Somente leitura. Exibe o endereço IP ou nome do computador onde o projeto está baseado conforme a configuração na aba Server.

Port

Somente leitura. Exibe a porta usada pelo aplicativo para o acesso. Para o Teste, usa 3201. Para o Startup, ele usa 3101. Estas portas devem ser abertas no servidor.

Startup Computer

Somente leitura. Mostra se o servidor configurado esta no computador local ou em um computador remoto.

Execution Path

Permite mudar o caminho de execução padrão, que é o local do arquivo do projeto.

Module Information

Execute a ferramenta Módulo de Informação.

Property Watch

Execute a ferramenta Proprierty Watch.

Trace Window

Execute a ferramenta TraceWindow.

Run Modules

Selecione quais Módulos executar durante a execução do projeto.

Status

O campo mostra o status atual em execução e o status conectado ou desconectado.A figura mostra os botões nesta ordem:

• Clique em Try to Connect para se conectar ao aplicativo em execução. Necessário para que as alterações feitas ao projeto sejam aplicadas imediatamente para o execução de teste ou de Startup.

• Clique em Disconnect se você não quiser que as alterações feitas no projeto sejam aplicadas imediatamente para a execução em modo Test ou Startup

• Clique em Stop para interromper a execução da aplicação.

  Image Removed

Enabled

Selecione para permitir que as alterações feitas ao projeto sejam onlineaplicadas imediatamente em tempo de execução de Test ou configuration Startup. Deve também estar conectado ao projeto em execução
(ver definição de Status acima). Todas as alterações devem ser salvas antes que elas apareçam nas telas em tempo real.

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

Image Removed

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.

Image Removed

Watch - Tags, Estados e Propriedades

Running the Application

You can test the application in one of the following ways:

• Using Run> Test - Allows you to run the project in safe mode by activating the application with some protected features. Historical data, alarms, and events are written to temporary files so that they do not affect production logs, and communication modules cannot write data to IEDs.

• Using Run> Startup - Allows you to run the project in full operation, without the need to build the project.

You can run the project using both Test and StartUp at the same time.
For information on how to use the available diagnostic tools, see "Using Diagnostic Tools"

To test the application:

1. Follow one of the following options:

   • Go to Run> Test.

   • Go to Run> Startup.

2. Enter or select the information as needed.

• Click Run Test OR Run Startup to start running.

Tools for diagnosis

Once you have started running a project you can, using the Startup window, select some diagnostic tools, which show the windows:

• PropertyWatch (Watch)

• TraceWindow

• ModuleInformation (Info).

You can also start the diagnostic tools, as explained above, on the
Run-Test and Run-StartUp by pressing the left mouse button on the icons of the
diagnostic tools. If the menus are enabled for the Screens you can also access the Tools menu at run time.

Image Added

Info - Information from Modules

The Info - Module Information window contains information about the operation of the modules. For example, when choosing a Device module and a specific channel, you have a lot of information about how the communication channel works.
A very important point is the Read Information Groups because it provides information about the virtual read groups, the execution time of each item, the amount of reads and reads that failed, and also reports on the code and date/time of the last error.
For problem investigation, the following steps should typically be followed when using the Information Module:

1. Go to "Read Groups Information" to check the number of successes and failures in communication in order to quickly identify the communication blocks.

2. If you have a systematic error in all blocks, or status codes with negative values, this typically means that you cannot access the remote device. Make sure the node address is correct.

3. If you have either block with systematic error, check the tags and addresses related to the block. Use TraceWindow with Devices information to collect information about these communication errors.

4. For some protocols, such as OPC, dropped items will show wrong addresses in the configuration.

When running the application in test mode in The Enterprise Model, keep in mind that in this mode, only reads are performed from field devices, even if you have a setting to write to the field.
It is very useful to run the application with ONLINE CONFIGURATION enabled, so you don't have to stop/start the Device module when modifying the configuration. You can modify the PLC addresses in Points, AccessTypes, and most of the application and see in real time the results in execution. You can use Startup-Window or Propertywatch to start and stop only one module, such as Devices, instead of restarting the entire execution system.

Image Added

Watch - Tags, States and Properties

Property Watch is a diagnostic tool used for accessing real-time attributes and internal system tag properties for reading or writing. Simply type the name of the object property in the column and get its value in the Value column.

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

Image Removed

Image Removed

Construindo e Empacotando Projetos

Image Removed

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.

Image Removed

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.

On the right side, we have properties of the selected object.
tag creation. These properties include value, timestamp, and quality.
The Action.NET uses for Quality coding the qualities defined by the OPC Data Specification.
See the main quality codes at "OPC DA Quality Codes"

Trace Window

The Trace window is the tool that reports system messages in a DataGrid (table) interface. When activating the module devices in the Settings button, we have information about the status of reads, writes, unsolicited, TX (send) and RX (received) frames.

Image Added

When you click the Settings in a configuration window appears where you can select which types of messages and modules, which will be shown in the datagrid of trace. This data that appears can also be saved to files for more thorough analysis. You can also set up an ObjectName tag by clicking the Add. Then a window appears with a menu to select objects to include in monitoring.

Image Added

Building and Packaging Projects

Image Added

The "build" function starts by pressing the Build in the desktop sub-menu panel Run, run, run. The desktop shown below appears for the function control. Build serves to recompile all project screens and scriptobjects for final verification of possible errors before project placement into production.
A thorough scan of the application logic is performed while preparing the files for the final production version. This operation is not required during project development, as all modifications are automatically and transparently compiled in the background while edits are made.
The workspace has two tabs with informational tables, not changeable. These are the build activity reports.
Messages - That shows the current status of each script and screen with information about potential errors or alerts about logic. If you do not perform a full Build, the BuildStatus column in this report shows any warnings or errors encountered during the background build process.
Double-click a line with a red X to go to the source code where is the line that generated this notice or error. The warnings are informative and do not serve for the script to run. Errors prevent the execution of the specified script, but do not affect the entire application. If a script or monitor has a notice, it will still run.

Image Added

History - Shows the list of BUILD runs made in this project, informing several details about each of these runs, such as date, error occurrence, product version, user who ran, and others.
References - It is a third tab that should be used for recording References to external or user code files used by the Scripts defined and used in the project.

Building projects

Periodically, you should run a full build ( Build):

• When you've made a lot of changes and you want a full validation and recompile of the entire project.

• When you want to assign a build number to a version.

• When you want to "package" the database. When the build is run, the system creates a backup of the current project file. If you want to save the project as it was before this build, rename the backup file.

• When you are preparing to make a publication, that is, create a read-only application for runtime, in a production environment.

To create the production application by Build:

1. Go to Run> Build> Messages.

2. If you want to "package" the database, select the "Pack database after build" option.

   • Packaging significantly reduces the size of the project file. The system creates a file with the backup extension, which is the database before packaging. Typically, you will want to package the database each time you run a build.

3. If you want to save all screens, select the option "Verify Symbols and Save all displays"

   • Be sure to use this option if you have made changes to the symbol library. This option applies to all modifications to the symbol library throughout the project.

   • The "include debug information" option should be selected if you want information to be debugged for scripts after Build.

4. Click the button 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.

Image Removed

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.

Image Removed

Coluna

Descrição

Identity

Somente leitura- O nome da DLL escolhida na janela de procura de arquivos

Domain

Selecione o domínio para o uso da referência:

• Server - DLL será utilizada por scripts no servidor

• Client - DLL será utilizada por scripts nas máquinas clientes

• ServerAndClient - DLL será utilizada em ambos os domínios

Description

Digite uma descrição da referência

Path:

Somente leitura - Mostra o caminho completo onde se encontra a DLL à qual se fez esta referência.

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.

References to external codes

In the tab References from the menu Build you can create references to external DLLs or check existing references.

Image Added

To create a reference to an external DLL:

1. Go to Run>Build>References.

2. Click the button Add DLL reference. The common MS-Windows window will be shown for selecting a file.

3. Navigate to where the DLL you want to reference is and click on it.

4. The Reference definition window shown below then appears. Enter or select the information as needed.

Image Added

To check existing references:

1. Go to Run>Build>References.

2. Click the button Verify References.

   • All external DLLs already referred to in existing scripts in the project will be shown in the DataGrid.

Project Version Control

This section presents the features in Action.NET for project versioning.

Control of configuration changes

The Action.NET implements several ways to help you keep track of project configuration changes:

• All configuration tables have for each record, the DateCreated, and the DateModified information.

• Or Run-Build-history logs and shows all build commands executed for the project. A project backup for each state can be available according to the user's settings.

• Or Info> Track> Tables shows all configuration tables, listing the number of rows each and whether they have changed since the last Build and the last Publish.

• Or Info> Track> Changes shows all project objects that have been modified. To enable or disable this functionality, you must be logged in as an application administrator. By default, object tracking is only activated after a Publish (publish) project, but you can activate at any time, regardless of whether or not you use the publish feature.

• In Info > Track > Releases - The list of all versions of publications made is displayed. The list shows the version, date of publication, the "build" number, and the user who performed the publication. Product, name, family, and other versions are also shown.

Publishing the Project

Publish (publish) the project creates a read-only version of the project, which can be placed in the final production environment without the risk of being changed.
IT IS NOT necessary to publish the project to install it in a final production environment. In scenarios where you still intend to have continuous changes to the project already in the field, it is simpler to place the main project file, TPROJ, directly on the production computer.
The benefits of publishing are that the system creates a compressed, read-only version of the project file. The created file has the same name as the project file, includes a published version number, and uses the TRUN extension.
Typical scenarios for command execution Publish are as follows:

• You want to deploy a read-only version of the project, for example, to comply with certified and regulated environments.

• You want to use the automatic version numbering system. The result of the publication is a TENG file. It also contains a version number, with a larger digit (1.0) and a smaller one (0.1) as part of the file name. In addition Info> Track helps manage published files, including the current Build number of the project.

• You want smaller project file size and faster loading of it at start-up, for example on machines, OEM and embedded systems. The TRUN file can be up to 5 to 10 times smaller than the TPROJ file.

• You want to protect the project from modifications.

To publish the project:

1. Go to Run> Build> Messages.

2. Select the desired build settings and click Build.

3. Go to Run> Publish.

   • The settings fields of the current project show the read-only status of the project.

4. Select the Publishing Settings you want.

5. Click Publish.

Runtime Information Objects

There are names of some runtime objects that provide information about project execution.
The namespace Info is the primary location for the runtime state. The main objects in the namespace that are:
Info.Project: Information about the project that is running
Info.License: license information
Info.Module: Information and start/stop command for modules
Info.Trace (): Displays a message in TraceWindow
Info.TestMode: Shows If The Project Is Running in Test Mode The Namespace Server has information about the server computer.
The namespace Client information about each client computer. running a graphical interface.
For the full programming reference on runtime objects, see http:// www.spinengenharia.com.br/help/an-2016/runtime/index.html.