ER_PCREQ-8449_Processamento_arquivo_configuração_EAI

Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

Processar os dados relativos às configurações de EAI que foram importadas a partir do arquivo XML. Esta funcionalidade é dependente da importação de arquivos de configuração, que foi descrita no documento ER_PCREQ-8448_Importação_arquivo_configurações_EAI.

Definição da Regra de Negócio

O processamento das configurações se dará a partir dos dados contidos nas tabelas temporárias de elementos e atributos, as quais foram preenchidas a partir do arquivo de configuração do EAI.

O processo iniciará verificando se o ambiente de destino já possui configurações de EAI. Caso não possua, as configurações importadas serão assumidas sem questionar o usuário. Se existir configuração no ambiente, será exibida ao usuário uma tela (ver Protótipos de Tela) onde o mesmo deverá informar o seguinte:

• Se as configurações existentes serão sobrepostas pelas novas configurações ou se ambas serão combinadas (mescladas);
• Se as configurações existentes serão salvas em arquivo antes do processamento. Esta opção chamará a rotina de exportação de configurações, cujo comportamento está descrito no documento ER_PCREQ-8447_Exportação_configurações_EAI;
• Se as mensagens existentes no ambiente serão eliminadas antes do processamento. Esta opção eliminará inclusive mensagens pendentes na fila.
• Se as mensagens existentes serão salvas em arquivos antes da eliminação. O local onde os arquivos serão gravados será exibido logo abaixo desta opção.
  

Quando o usuário optar por mesclar as duas configurações, as seguintes ações serão tomadas:

• O nome do aplicativo hospedeiro existente será mantido.
• As transações do aplicativo hospedeiro existente que coincidirem com as transações do aplicativo hospedeiro importado serão mantidas.
• As transações do aplicativo hospedeiro importado que não existirem no aplicativo hospedeiro de destino serão acrescentadas.
• Os aplicativos externos cujo nome coincidir com algum aplicativo externo importado serão mantidos.
• Os aplicativos externos importados que não existirem no ambiente de destino serão acrescentados.
• As transações dos aplicativos externos que já existirem no ambiente de destino serão mantidas.
• As transações dos aplicativos externos que não existirem serão acrescentadas.
• As rotas já existentes serão mantidas.
• As novas rotas serão acrescentadas.
  
• As informações de "de-para" que já existirem serão mantidas.
• As novas informações de "de-para" serão acrescentadas.

Quando a opção do usuário for assumir as configurações importadas, os dados de configuração existentes serão removidos, a saber:

• Dados do aplicativo hospedeiro e suas transações.
• Dados dos aplicativos externos e suas transações.
• Dados de "de-para".

Em relação às mensagens existentes no ambiente, caso a opção seja por removê-las, as mensagens serão exportadas para arquivos no formato UNL antes da remoção. O diretório de destino dos arquivos de dados será o indicado pela propriedade STARTPATH do arquivo TotvsAppServer.ini. Neste diretório será criada uma pasta cujo nome terá o seguinte formato: msg-eai-<nome_aplicativo_interno>.

Ao final do processamento, deve-se emitir um relatório em arquivo contendo as seguintes informações (ver exemplo na seção Protótipo de Tela):

• Data e hora de inicio do processamento.
• Resposta do usuário ao questionamento sobre backup das configurações de EAI.
• Local e nome do arquivo de backup das configurações de EAI, caso usuário tenha escolhido o backup.
• Resposta do usuário ao questionamento sobre eliminação das mensagens.
• Resposta do usuário ao questionamento sobre backup das mensagens.
• Local dos arquivos de backup das mensagens, caso tenha escolhido o backup das mesmas.
• Resposta do usuário ao questionamento sobre a forma de processamento das configurações.
• Nome do aplicativo interno após o processamento.
• Quantidade e nome das transações incluídas para o aplicativo interno.
  
• Quantidade e nome dos aplicativos externos incluídos.
• Quantidade e nome das transações incluídas com os novos aplicativos externos.
  
• Quantidade e nome das transações incluídas para os aplicativos externos existentes.
• Quantidade de rotas incluídas.
• Quantidade de informações de "de-para" incluídas
• Data e hora de término do processamento.

O arquivo do relatório será gravado no diretório indicado pela propriedade STARTPATH do arquivo TotvsAppServer.ini.

Protótipo de Tela

Protótipo 01 - Tela de opções de processamento das configurações de EAI

Protótipo 02 - Relatório de processamento das configurações de EAI

Processamento das configurações de EAI
======================================
Data/hora de inicio....: 99/99/9999 - HH:MM:SS
Realizar backup?.......: SIM / NÃO
Local e nome do arquivo.......: c:\totvs\logix\logix_data\backup_config.xml.
Eliminar mensagens?...........: SIM / NÃO
Backup das mensagens?.........: SIM / NÃO
Local do backup das mensagens.: c:\totvs\logix\logix_data\msg-eai-host-app\
Forma de processamento........: Assumir configurações importadas, descartando as atuais / Combinar com as configurações atuais
Aplicativo hospedeiro.........: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
    Novas transações                                             Versão
    -------------------------------------------------------------------
    XXXXXXXXXXXXXXXXXXXXXX                                        9.999
    XXXXXXXXXXXXXXXXXXXXXX                                        9.999
    XXXXXXXXXXXXXXXXXXXXXX                                        9.999
TOTAL: 99999 transações
Novos Aplicativos Externos
--------------------------
Aplicativo            
---------------------------------------------
XXXXXXXXXXXXXXXXXXXXXXX
    Transações                                                   Versão
    -------------------------------------------------------------------
    XXXXXXXXXXXXX                                                 9.999
    XXXXXXXXXXXXXX                                                9.999
    XXXXXXXXXXXX                                                  9.999
    XXXXXXXXXXXX                                                  9.999
Aplicativo            
---------------------------------------------
XXXXXXXXXXXXXXXXXXXXXXX
    Transações                                                   Versão
    -------------------------------------------------------------------
    XXXXXXXXXXXXX                                                 9.999
    XXXXXXXXXXXXXX                                                9.999
    TOTAL: 999999 aplicativos, 999999 transações
Novas Transações em Aplicativos Existentes
------------------------------------------
Aplicativo            
--------------------- 
XXXXXXXXXXXXX
    Transações
    --------------------------------------------------------------
    XXXXXXXXXXXXX
    XXXXXXXXXX            
    XXXXXXXXXXX
    TOTAL: 999999 aplicativos, 999999 transações
 
Novas rotas..................................: 999999
Novas informações de "de-para" (Internal IDs): 999999
Data/hora de término.........................: 99/99/9999 - HH:MM:SS