A extensão “Utilitary apps wizard” lista, configura e executa aplicativos utilitários em modo de engenharia (aplicativos de configuração). Estes aplicativos normalmente são criados especificamente para um projeto em particular que necessite uma funcionalidade customizada não disponível no Action.Net.

Pré-requisitos

Estes são os pré-requisitos atuais para a utilização da extensão:

Action.Net versão 9.2.14 ou superior;
Aplicativos utilitários precisam estar armazenados na pasta “Extensions\Import\Utils” (comumente instalada em “C:\Program Files (x86)\SPIN\Action.NET\an-9.2\Extensions\Import\Utils”);
Os aplicativos utilitários devem ser executáveis (“.exe”); e
Junto ao aplicativo utilitário, deve ser inserido um arquivo XML de configuração, com o nome iniciando pelo prefixo “T.Eng.Extensions.Import.Utils” (ex.: “T.Eng.Extensions.Import.Utils.AppUtilitario1.xml”). Os arquivos xml precisam estar no formato especificado no item a seguir.

Formato do arquivo XML

O arquivo XML de configuração deve obedecer o formato a seguir:

Onde:

Identity refere-se ao nome do aplicativo utilitário. Este nome será mostrado na coluna “Identidade” do grid de chamada de utilitários da extensão.

Description é uma breve descrição da funcionalidade do aplicativo.

AssemblyPath refere-se ao caminho completo do arquivo do aplicativo. É pelo AssemblyPath que a extensão faz a chamada para a execução do utilitário. Caso este item esteja incorreto, uma mensagem de erro será mostrada na extensão.

Arguments refere-se aos argumentos que necessitam ser passados a um utilitário para a sua execução. Existem aplicativos que necessitam receber parâmetros para sua correta execução.

Importação passo a passo

Executando o importador

A extensão Utilitary apps wizard pode ser acessada junto às demais extensões na seção “Run → Extensions → Import”.

Utilitary apps wizard

O grid de configuração e chamada de aplicativos utilitários é apresentado.

Grid de configuração e chamada de utilitários

Assim que a extensão é carregada, ela executa uma busca na pasta “Extensions\Import\Utils” (comumente instalada em “C:\Program Files (x86)\SPIN\Action.NET\an-9.2\Extensions\Import\Utils”) pelos arquivos XML de configuração. A extensão faz a leitura dos arquivos e apresenta as configurações no grid.

Caso seja necessário fazer um novo carregamento dos arquivos da pasta, pode-se utilizar o botão “Atualizar” (“Refresh”).

Configuração de utilitários

A coluna “Argumentos” é a única coluna configurável do grid. Nela é possível passar os argumentos necessários a um utilitário, caso o mesmo necessite.

Os parâmetros podem ser passados em dois formatos diferentes: nome e valor separados por ponto e vírgula (“;”) ou nome e valor utilizando a barra de parâmetros (“/”).

Exemplos:

param1=true; param2=10
/param1=true /param2=10

Atenção: Independente do formato escolhido, a extensão irá chamar o aplicativo utilitário passando os parâmetros utilizando a barra de parâmetros (“/”).

As configurações dos parâmetros são salvas em dois momentos:

Ao clicar o botão “Abrir” (“Open”) de um utilitário - Neste caso, apenas as configurações do utilitário aberto são salvas; e
Ao clicar o botão “Ok” para fechar a extensão - Salva as configurações dos utilitários com configurações alteradas.

Executando um utilitário

Para executar um utilitário, basta clicar no botão “Abrir” (“Open”) referente ao utilitário. Somente é possível abrir um utilitário por vez.

Nesta página: