SCLN212, Bloco D, Sala 101

Braslia DF | CEP: 70.865-540

+55 61 3340-8486
contato@spinengenharia.com.
br
www.spinegenhria.com.br

Action.NET

Manual de Atualizao de verso do SCADA

Action.NET verso 2012 para a verso 2014

Manual de Referncia

March, 20166

Manual de Atualizao de verso do SCADA

Action.NET 2012 para a 2014

Manual de Referncia

Maro, 2016

Copyright2016
Spin Engenharia de Automao Ltda.
Todos os Direitos Reservados

Nenhuma parte deste documento pode ser reproduzida, copiada, fotocopiada, distribuda ou
alterada sem a prvia e expressa autorizao da Spin Engenharia de Automao Ltda.

NOTA

Action.NET marca registrada da

Spin Engenharia de Automao Ltda.

Todas as outras marcas e nomes de produtos so marcas registradas de seus

respectivos proprietrios e/ou empresas.

Em diferentes partes deste documento, a empresa poder fazer meno tanto de

seu nome comercial Spin como Spin Engenharia de Automao Ltda.

Em virtude do contnuo desenvolvimento de seus produtos, a informao contida

neste documento est sujeita a alteraes e/ou modificaes sem prvia
notificao. A Spin no se considera responsvel por erros de digitao ou
interpretao das informaes aqui contidas; e/ou por danos e prejuzos
causados / gerados a terceiros. O contedo desta publicao poder ser alterado
a qualquer momento sem que exista a obrigao de notificar qualquer parte
envolvida; isto no implicar, em nenhuma hiptese, em alteraes,
reclamaes, ou extenso de garantia.

Cuidado! Indica que o usurio dever proceder exatamente como descrito

neste manual, sob pena de danificar ou configurar errado o equipamento.

Dica. Indica informaes teis e rpidas para soluo de pequenos problemas.

Perigo! Indica que o usurio dever proceder exatamente como descrito neste
manual, sob risco de choque ou descarga eltrica.

Sumrio

1.
2.
3.
4.

INTRODUO............................................................2
PROCEDIMENTOS DE PR - IMPORTAO....................5
PROCEDIMENTOS DE IMPORTAO............................9
PROCEDIMENTOS PS-IMPORTAO........................11

1. INTRODUO
Para entendimento da nomenclatura utilizada no Manual de Atualizao de
verso do SCADA Action.NET 2012 para a 2014, o projeto referido como
exportador, se refere ao projeto que se queira atualizar, o projeto referido como
importador, se refere ao projeto DefaultNewProject.
Para a criao deste manual foi utilizado como teste, o projeto QGE-ICR.proj,
todos os exemplos citados nesse manual so referentes a este teste.
No caso ento temos:

Projeto exportador: QGE-ICR.

Projeto importador: DefaultNewProject.

Devem ser verificados os Pr requisitos bsicos estabelecidos para a

atualizao:

Instalar a verso Action.NET 2014.

NOTA: Ao instalar o Action.NET 2014 verificar se o mesmo se encontra na ltima

verso homologada pela equipe de desenvolvimento da Spin Engenharia. O link
para
acesso
a
ltima
verso:
http://sdcmst:8181/tfs/ActionNet/SPIN.ActionNet.Binaries/_versionControl

Possuir
instalado
a
verso
Microsoft
.NET
Framework
https://www.microsoft.com/pt-br/download/details.aspx?id=42642

4.5.2:

NOTA: Ao instalar o Action.NET 2014.33 o mesmo deve instalar o .NET

Framework 4.5.2, mais e nescessario acessar a lista de programas instalados em
seu computador e conferir se este programa encontra-se instalado.

Colocar o projeto: DefaultNewProject na pasta de projetos Action.NET,

pois a importao da base atualizada e feita para dentro deste projeto.

NOTA: O Projeto DefaultNewProject, prprio e atual da verso, encontra no

diretrio, C:\Program Files (x86)\SPIN\Action.NET\an-2014.2.
Ao verificar incrementar, se nescessario os pr-requisitos, abra o programa de
um clique com o boto direito sobre o projeto ao qual se queira efetuar o
upgrade (Figura 1).

Figura 1. Tela inicial do Action.NET, com indicao de upgrade do projeto.

Ao clicar em Upgrade Project o software ira indicar a verso atual do projeto e

perguntar se o usurio deseja realmente realizar o upgrade da verso.
NOTA: Ao realizar o upgrade, automaticamente ser realizado um backup do
projeto na verso anterior a atualizao.
Ao confirmar o upgrade, o passo da atualizao ser indicado na tela (Figura 2).

Figura 2. Tela de indicao que o upgrade est sendo realizado.

No final do upgrade o software indicara a verso que o projeto foi atualizado,

assim como o diretrio onde o backup do mesmo foi salvo. Confirmando,
3

automaticamente, o projeto ser aberto. Em seguida, imediatamente deve ser

realizado um Build do projeto (Figura 3).

Figura 3. Tela de processo do build.

Aps a realizao do build pode-se proceder com as configuraes para a

realizao da importao.

2. PROCEDIMENTOS DE PR - IMPORTAO
Para a importao do projeto inicialmente deve-se proceder com algumas
configuraes, a fim de evitar erros na importao.
Estes possveis erros foram constatados pela equipe de desenvolvimento da Spin
Engenharia. Foi verificado que o projeto que recebe a importao tende a manter
seus parmetros com nomes iguais.
Por exemplo: Uma Tela com o nome no projeto exportador de Tela1 e no projeto
importador tambm com o nome de Tela1, ser mantida aps a importao a
Tela1 do projeto importador.

2.1. CONFIGURAO DO PROJETO EXPORTADOR

Define-se como projeto exportador, o que enviar sua base de dados para a
aplicao DefaultNewProject.
V em Edit -> Tags -> Templates -> (indicaes na Figura 4), busque os
templates
(User
Custom
Type):
AN_FilterCommon
e
AN_TrendWindowCrt e renomeie (Rename) para AN_FilterCommon_xxx
e AN_TrendWindowCrt_xxx.

Figura 4. Indicao dos passos de acesso aos templates.

Em Draw busque a tela: AN_MainPage, salve uma segunda tela com o nome de
AN_MainPage2 (Figura 5). Para salvar esta nova tela, clique no cone

Figura 5. Indicao dos passos de salvamento de outra tela.

2.2.CONFIGURAO DO PROJETO IMPORTADOR

Define-se como projeto importador, o prprio projeto DefaultNewProject.
Em Edit -> Displays (Figura 6), busque as telas AN_Command e
AN_Impedimento

renomeias
para
AN_Command_xxx
e
AN_Impedimento_xxx

Figura 6. Indicao dos passos de renomeao de telas.

Outro passo que se deve tomar clicar no cone superior indicado na figura 7, no
campo Allow duplicated Tags on, marcar as opes: Historian Tables e
Device Points.
6

Figura 7. Indicao de configurao de duplicao.

No campo Info -> Settings (Figura 8), faa a configurao dos campos,
conforme especificado no projeto exportador. No projeto testes, est indicado
conforme est na Figura 9.

Figura 8. Indicao dos passos de acesso ao Settings.

Figura 9. Configurao dos campos do Settings.

3. PROCEDIMENTOS DE IMPORTAO
Para iniciar a importao, v ao projeto importador (DefaultNewProject), nos
campos Run -> Extensions -> selecione o item Project/Component e aps
aperte o boto Execute, conforme indicado na Figura 10.

Figura 10. Indicao dos passos de acesso ao Settings.

Ao clicar, uma tela aberta (Figura 11), no campo Project acesse o projeto ao
qual se deseja importar (projeto exportador), atravs do Select Project
posteriormente aberto, ter certeza de que este realmente o projeto exportador,
clique em Abrir e em seguida em ok.

Figura 11. Acesso ao projeto exportador.

Aps ser aberta uma tela que mostra o progresso de importao do projeto
(Figura 12).

Figura 12. Tela de progresso da Importao.

No final da importao aparecer uma tela contendo informaes referentes ao

diretrio onde se encontra o log contendo as informaes da importao, como
tambm a solicitao de realizao de um build do projeto.

10

4. PROCEDIMENTOS PS-IMPORTAO
Aps importar, alguns procedimentos devem ser realizados a fim de corrigir erros
detectados pelo Build ou tampar lacunas deixadas pela importao.

4.1. ERROS DETECTADOS PELO BUILD

Ao final da importao deve-se realizar o salvamento de todas as telas utilizadas
na aplicao. Na prpria lista de mensagem do build mostra as telas as quais
possuem possveis erros.
V em cada uma dessas telas e salve-as.
Para isso basta entrar em Draw, fazer uma pequena alterao na tela, apenas
para que o boto de salvar se habilite.

Figura 13. Salvamento de telas.

Logo aps, realize o Build da aplicao especificado na tela aps a importao.

Importante marcar todos os campos especificados na figura 14.

11

Figura 14. Build do projeto importado.

Aps a execuo do build dever ser realizada a anlise minuciosa dos erros por
ele apontado. Os erros so apontados com um X no campo BuildStatus
(Figuar 15).

Figura 15. Tela de apontamentos de erros aps o Build.

12

No exemplo deste manual, projeto QGE ICR, os erros e suas devidas solues
so apontadas na tabela abaixo:
ERROS

SOLUES

Class.AN_ Tags

Comentar o script

Class.AN_ Language **

Deve-se
trocar
Dictionary
do
Localization

Class.AN_ QGE_AEGS_ON

Comentar o script

Class.AN_ TAGS_Client

Comentar o script

Task.ClientTagsLoad

Comentar o script

AN_FilterTags

Comentar o script

MENU_GERAL

Apenas de um salvar no script

UNF_GERAL

Apenas de um salvar no script

COI_GERADOR_DIESEL

Apenas de um salvar no script

COI_SISTEMA

Apenas de um salvar no script

MENU_TAI

Apenas de um salvar no script

MENU_ICI

Apenas de um salvar no script

COI_ELETRICA

Apenas de um salvar no script

MENU_PREDIAL

Apenas de um salvar no script

MENU_COI

Apenas de um salvar no script

COI_SNMP_REDE

Apenas de um salvar no script

COI_SNMP_UPS

Apenas de um salvar no script

COI_LAYOUT_SALAS

Apenas de um salvar no script

TAI_SISTEMA

Apenas de um salvar no script

MAPA_EOLs

Apenas de um salvar no script

COI_SISTEMA1

Apenas de um salvar no script

o
parmetro
cdigo,
por

13

ICI_SISTEMA

Apenas de um salvar no script

MENU_SE

Apenas de um salvar no script

ANTrendPensSelect

Comentar o script

COI_SISTEMA_AR

Apenas de um salvar no script

COI_SISTEMA_AR_SO

Apenas de um salvar no script

COI_SISTEMA_AR_SM

Apenas de um salvar no script

QG_DESL_TRANS

Comentar o script

ICI_SISTEMA_SBT

Apenas de um salvar no script

TAI_SISTEMA_PEC

Apenas de um salvar no script

AMO_SISTEMA

Apenas de um salvar no script

MAP_AMO

Apenas de um salvar no script

AN_MainPage2

Apenas de um salvar no script

** Apenas troque o script atual pelo que est no ANEXO 1.

NOTA: Para comentar um script utilize os caracteres ( /* )no incio do script e o caractere (
*/ ) no final. Por exemplo:
/* Private void () {
Int x = 2 */

Pode-se levar como considerao referentes aos erros levantados no Build, so

relacionados com as Spin.Tools.dll abolidas nesta nova verso 2014, apenas o
Script.Class.AN_Language (ANEXO 1) que se refere a um novo parmetro adotado
que foge regra.
Este novo parmetro, gera os erros relatados nos Displays, por isso deve-se
proceder inicialmente com a correo do Script.Class.AN_Language antes de
efetuar a correo dos Displays. Fazendo isso eles apenas necessitaram de uma
atualizao.
Na mesma tela vemos uma outra indicao de erro, referente as Expressions do
projeto. V neste campo, e delete todas as Expressions cadastradas (Figura 16).
14

Figura 16. Indicao de erros nas expresses.

No projeto exportador, v em Edit -> Scripts -> Expressions, e selecione

todas usando Ctrl+A, depois de um Ctrl+C. No projeto importador, v em Edit
-> Scripts -> Expressions, e de um Ctrl+V, colando todas as expresses do
projeto. Logo aps, deve-se compilar as expresses, apenas clicando no campo
indicado na figura 17.

Figura 17. Acesso as Expressions e compilao das mesmas.

Ao clicar em Compile, uma tela ser aberta, mostrando o progresso da

compilao (Figura 18).

15

Figura 18. Progresso da Compilao.

4.2. CORREOES DE LACUNAS DA IMPORTAO

Estas lacunas so bugs da importao do projeto, que sero repassadas ao
desenvolvimento da Spin Engenharia para eventuais analise e correes.

4.2.1. TAGS
Nestes campos de configurao deve-se apenas efetuar a correes nos nveis do
projeto. A importao faz com que os nveis se misturem.
No projeto importador v em Edit -> Tags -> Assets, faa a configurao
manualmente conforme a configurao original, visto no projeto exportador. No
projeto teste (QGE ICI) a configurao deve ficar conforme a figura abaixo:

16

Figura 19. Assets da aplicao.

NOTA: O ideal refazer os nveis da aplicao, ao invs de tentar reajusta-los. O

nvel que no permitir ser deletado, deve ser renomeado. Aps criar os nveis,
devemos corrigir a configurao deles nos objetos. V em Edit -> Tags ->
Objects, faa a configurao do campo Level conforme configurado no projeto
exportador.

4.2.2. SECURITY
A importao no traz os campos cadastrados nas tabelas Users e Permissions.
No projeto exportador, v em Edit -> Security -> Users, selecione todos
campos usando Ctrl+A, depois de um Ctrl+C. No projeto importador, v em
Edit -> Security -> Users, e de um Ctrl+V, colando todas os usurios do
projeto.

17

Figura 20. Campo dos tipos de usurios.

Os usurios que forem repetidos ficaram com seus nomes acrescentados a

expresso _Copy1, estes deveram ser mantidos na nova aplicao, e deve ser
deletar os originais (figura 25), aps deve-se apagar a expresso _Copy1 do
nome.

Figura 21. Comparao de Usurios cadastrados.

No projeto importador, v em Edit -> Security -> Permissions configure-o,

conforme o projeto exportador. No projeto teste (QGE ICR) a configurao deve
ser conforme a figura abaixo, e deve ser realizada manualmente:

18

Figura 22. Permisses de usurios cadastradas na aplicao.

4.2.3. DEVICES
Outro procedimento que deve ser realizado, se refere a configurao dos
devices, especificamente as tabelas points e accesstypes. Na tabela points,
foi constatado que no a importao de pontos, onder suas tags apresentam o
mesmo TagName, e o AccessType no importado.
No projeto exportador, v em Edit -> Devices -> Points, selecione todas
usando Ctrl+A, depois de um Ctrl+C. No projeto importador, v em Edit ->
Devices -> Points, de um Ctrl+V, colando todos os pontos do projeto.

Figura 23. Tabela points.

19

NOTA: Para verificar se o nmero de pontos de comunicao est correto, v em

Info -> Project -> Version, verifique o nmero de pontos de comunicao do
projeto exportador, aps colar os pontos no projeto importador, os mesmos
deveram ter o mesmo nmero de pontos de comunicao.

Figura 24. Informaes do projeto

Os AccessType devem ser configurados conforme o projeto exportador. Nele v

em Edit -> Devices -> AccessType, e selecione todas usando Ctrl+A, depois
de um Ctrl+C. No projeto importado, v em Edit -> Devices -> AccessType, e
de um Ctrl+V, colando todas as accesstype do projeto.

Figura 25. AccessType do projeto analisado.

20

4.2.3. ALARMS
No campo, Edit -> Alarms -> Groups, devemos analisar se a configurao est
correta conforme projeto exportador.

Figura 26. Grupos de alarmes cadastrados.

No campo, Edit -> Alarms -> Items, devemos realizar uma comparao de
pontos cadastrados como alarmes e eventos entre o projeto exportado e o
importado, para isso vamos usar um Excel e a funo PROCV.
NOTA: Caso no saiba utilizar o comando Excel PROCV assista ao tutorial:
https://www.youtube.com/watch?v=XNhkqlhhpns).
Caso o alarme items do projeto importador seja menor que o exportador,
selecione todos os alarmes usando Ctrl+A, depois de um Ctrl+C. No projeto
importador, v em Edit -> Alarms -> Items, e de um Ctrl+V, colando todas os
alarmes itens do projeto.

4.2.4. DATASETS
Devemos realizar a configurao da tabela DBs conforme projeto exportador.
Verificou-se que a configurao do projeto importador mantida para os Nomes
iguais. Na aplicao teste (QGE ICR), as tabelas principais AlarmHistorian e
TagHistorian tidas como principais, esto apontando para o banco de dados
Tatsoft, devendo ser apontado para o SQL Server (Figura 27).

21

Figura 27. Configurao aps importao do Dataset.

No projeto importador, v em Edit -> Datasets -> DBs, renomeie os campos

AlarmHistorian e TagHistorian com a expresso _x. Aps no projeto
exportador, selecione cada um individualmente, de um Ctrl+C, e no projeto
importador de um Ctrl+V.
Ainda em Dataset v em Edit -> Datasets -> Queries, faa
parmetros da tabela, devendo estas, estarem em comum com
exportador.
No
projeto
teste
(QGE-ICR),
QueryHistoricMeasuresQuery estava apontado para o banco de

a anlise dos
os do projeto
o
campo
dados antigo.

4.2.5. SCRIPTS
Os scripts j foram corrigidos logo aps a realizao do build decorrente da
importao.

4.2.6. DISPLAYS
Devemos inicialmente realizar os ajustes dos tamanhos das telas caso
nescessite.
No projeto teste (QGE-ICR) as telas utilizadas na aplicao tinham como padro o
tamanho 1530 x 945, e o Projeto DefaultNewProject tem como tamanho padro
1680 x 830.
As telas da aplicao que deve ser ajustada para o tamanho do projeto so:
22

AN_
AN_
AN_
AN_
AN_
AN_
AN_

AlarmSummary.
EventsSummary.
HistoricEventsSummary.
HistoricMeasureQuery.
TagsSummary.
TrendsScreen.
About.

A tela AN_ Footer deve ter o tamanho 1680 x 25.

Aps estes ajustes, devemos ajustar os Layouts. No projeto importador, v em
Edit -> Displays -> Layouts, em Layout busque por Startup especifique a
configurao de telas conforme figura abaixo:

Figura 28. Configurao do layout das telas.

Logo aps, v em Edit -> Displays -> Displays configure conforme a figura
23.

23

Figura 29. Configurar Display clientes da aplicao.

Figura 30. Configurao dos clientes displays.

Aps estas configuraes, devemos inserir novos scripts em determinadas telas.

Estes scripts servem para tornar a funcionalidade Ribbom (responsvel pelas
funcionalidades das telas de Alarmes e Eventos), mais otimizada.
Estes scripts sero inseridos nas chamadas das telas onde no se deseja que as
funcionalidades Ribbom apaream, geralmente nos menus.

24

Inicialmente deve-se fazer a chamada da nova classe criada:

using SPIN.ActionNet.Enums;
using SPIN.ActionNet.View.ViewModel;
Se desejar chamar mais de uma tela com o mesmo boto, deve-se utilizar o
parmetro, _viewModel.OpenDisplay() ;, neste campo, ser recebido o
nome da tela, e o ndice de chamada, pois cada tela diferente ser aberta em um
ndice (Figura 31).
Na aplicao analisada, temos como exemplo na tela MENU_GERAL:
public
void
View_Open(object
System.Windows.Input.InputEventArgs e)
{
RibbonViewModel
_viewModel
@Script.Class.Header.GetViewModel();
_viewModel.OpenDisplay("MENU_ICI", 2);
_viewModel.OpenDisplay("MAP_ICI2", 3);
}

sender,
=

Figura 31. ndice dos displays.

Para menu que abre apenas uma tela, sem necessitar de distinguir em ndices,
devemos usar o comando _viewModel.OpenDisplayCommand.Execute(),
neste campo ser recebido apenas o nome da tela que se deseja abrir.
Na aplicao analisada, temos como exemplo na tela MENU_ICI:
public
void
unifilar_ICR
System.Windows.Input.InputEventArgs e)
{

(object

sender,

25

RibbonViewModel
_viewModel
@Script.Class.Header.GetViewModel();
_viewModel.OpenDisplayCommand.Execute("UNF_ICI_230");
}

Neste exemplo, o boto UNIFILAR ICR abre apenas a tela UNF_ICI_230.

4.2.7. CONSIDERAES FINAIS

Ao realizar todas as configuraes, por fim devemos configurar o campo
responsvel pela Redundncia da aplicao, que no importada.
Na aplicao teste (QGE-ICR) a configurao correta, se encontra na figura
abaixo:

Figura 32. Configurao da Redundncia QGE_ICR.

26

Faa a verificao das References do projeto. V em Run -> Build ->

References, nescessario que as referncias estejam conforme figura abaixo, e
seja feita suas devidas verificaes, clicando no campo Verify References:

Figura 33. Configurao das referncias.

Ao seguir com estes ltimos procedimentos, realize um Build do projeto.

27

ANEXO 1
O cdigo que dever ser inserido para o novo parmetro utilizado na linguagem
das telas :
public void SetLanguage()
{
switch (@Tag.AN_intLanguage.Value)
{
//case 0:
//@Client.Dictionary="Portugues";
//break;
case 1:
@Client.Localization="Ingles";
break;
default:
@Client.Localization="";
break;
}
}

28