Histórico da Página
...
Características do Requisito
...
Linha de Produto: | RM |
Segmento: | FRAMEWORK |
Módulo: | EAI 2.0 |
Descrição
Efetuar a migração dos dados cadastrados nas tabelas de integração do EAI 1.0 para as tabelas do EAI 2.0.
Definições importantes
É importante que um backup da base seja feito antes da execução desse processo;.
Modelo de Solução
...
Abaixo será descrito as regras de negócio do conversor.
...
Informações | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Todas as integrações, com exceção das integrações inativas, aparecerão na grid. O usuário deverá selecionar uma ou várias integrações a serem convertidas para o novo modelo de EAI. Botão "Atualizar SourceApplication manualmente": Ao clicar nesse botão, aparecerá uma janela para o usuário informar o "Sistema Integrado" para ser pesquisado e o "SourceApplication" para ser atualizado dentre as integrações selecionadas.O preenchimento desse campos é obrigatório.
Botão "Atualizar SourceApplication automaticamente": Ao clicar nesse botão, o processo enviará uma mensagem de Whois para cada endereço de webServices cadastrado nas integrações selecionadas. O processo fará uma leitura na resposta dessa mensagem e buscará a informação de "SourceApplication". O valor desse atributo será usado para preencher o campo "SourceApplication" da tabela GEAIApp. Opção "Importar fila de mensagens com erro": Com essa opção marcada, todas as mensagens (síncronas e assíncronas) que não foram executadas com sucesso, serão serão migradas para as novas tabelas de mensagens (GEAIMensagem / GEAIRotaMensagem / GEAIExecRotaMensagem); Opção "Data Início das mensagens": Somente as mensagens com data de inclusão maior ou igual que o informado serão migradas.
|
Mapeamento de Informações (EAI 1.0 / 2.0)
...
Aplicativos
Tabela/Coluna EAI 1.0 | Tabela/Coluna EAI 2.0 | Regras |
GEAIAPP.ID | auto incremento |
GEAIAPP.SOURCEAPPLICATION | O valor de SourceApplication será recuperado pela busca do atributo "SourceApplication" da resposta da mensagem de Whois. A mensagem de whois será enviada para cada endereço de webServices cadastrado nas integrações a serem convertidas. | |
HCINTEGRACAO.SISTEMAINTEGRADO | GEAIAPP.CODDPRODUTO |
GEAIAPP.NOME | Concatenação dos campos HCIntegracao.SISTEMAINTEGRADO + "-" + SOURCEAPPLICATION O valor de SourceApplication será recuperado pela busca do atributo "SourceApplication" da resposta da mensagem de Whois. |
GEAIAPP.DESCRICAO | Concatenação dos campos HCIntegracao.SISTEMAINTEGRADO + "-" + SOURCEAPPLICATION O valor de SourceApplication será recuperado pela busca do atributo "SourceApplication" da resposta da mensagem de Whois | |
HCINTEGRACAO.WSURL | GEAIAPP.URLWSDLEXTERNO |
HCINTEGRACAO.WSUSUARIO | GEAIAPP.USRWSDLEXTERNO |
HCINTEGRACAO.WSSENHA | GEAIAPP.PASSWSDLEXTERNO |
HCINTEGRACAO.RMCOLIGADAONPROTHEUS | GEAIAPP.RMCOLIGADAONPROTHEUS |
...
Aviso | ||
---|---|---|
| ||
Não poderá existir mais de um aplicativo com o mesmo "SourceApplication" / "CodProduto". |
...
Transação
Tabela/Coluna EAI 1.0 | Tabela/Coluna EAI 2.0 | Regras |
---|
GEAITRANSACAO.ID | Auto incremento | |
HCTRANSFORMACAO.TRANSACTIONID | GEAITRANSACAO.TRANSACAO |
HCTRANSFORMACAO.DESCRICAO
GEAITRANSACAO.DESCRICAO
GEAITRANSACAO.MODOSUPORTADO | 1 - Envio 2 - Recebimento |
XSLTENTREDA diferente |
de vazio 3 - Ambos |
XSLTSAIDA diferente |
de vazio |
XSLTENTREDA diferente |
de vazio |
GEAITRANSACAO.SYNCASYNCENVIO | Será gravado o valor "0 - Sincrono". |
GEAITRANSACAO.PERMITERECASYNC | Será gravado o valor "0 - Não permite" |
GEAITRANSACAO.EXECVIAJOB | Esse campo definirá se as mensagens de envio (nas transações em questão) serão executadas via Job ou imediatamente na chamada do método. Esse campo foi criado para resolver a situação do "falso assíncrono". Algumas mensagens são enviadas para o EAI 1.0 com o tipo de entrega assíncrono. |
Porém, essas mensagens , no momento de execução pelo Job, são enviadas para outro aplicativo com o tipo entrega "sincrono". Abaixo serão listadas essas transações com esse comportamento: |
Transação / Versão
Tabela/Coluna EAI 1.0 | Tabela/Coluna EAI 2.0 | Regras |
---|---|---|
HCMAPAINTEGRACAO.VERSAOMENSAGEM | GEAITRANSACAOVERSAO.VERSAO |
HCMAPAINTEGRACAO.ENTIDADE | GEAITRANSACAOVERSAO.IDTRANSACAO |
O campo identificação da transação será buscado da tabela GEAITransacao |
Transação / Aplicativo (rotas)
Tabela/Coluna EAI 1.0 | Tabela/Coluna EAI 2.0 | Regras |
---|---|---|
HCMAPAINTEGRACAO.IDINTEGRACAO | GEAITRANSACAOAPP.IDAPP |
O identificador do App será buscado da tabela GEAIApp |
HCMAPAINTEGRACAO.ENTIDADE | GEAITRANSACAOAPP.IDTRANSACAO |
O campo identificação da transação será buscado da tabela GEAITransacao |
HCMAPAINTEGRACAO.VERSAOMENSAGEM | GEAITRANSACAOAPP.IDTRANSACAO |
GEAITRANSACAOAPP.IDSOURCECODE | Identificador do código fonte (GSourceCode) |
GEAITRANSACAOAPP.INCLUIMENSAGEMORIGINAL | Será gravado o valor 1. Por default, a mensagem original sempre será incluída na mensagem de resposta |
GEAITRANSACAOAPP.MODOHABILITADO | O valor será copiado da transação (GEAITRANSACAO.MODOSUPORTADO) |
...
Aviso | ||
---|---|---|
| ||
Não será permitido o mapeamento entre um aplicativo e uma transação em versões diferentes. |
...
...
Os códigos fontes cadastrados na tabela GSourceCode e mapeados na tabela "HCMapaTransacao.Extensions" não serão migrados para tabela GEAITransacaoApp.IdSourceCode. No EAI 2.0 esse campo será usado exclusivamente para armazenar códigos customizados feitos pelo cliente/customização. |
...
|
...
Pacote de instalação
...
Tabela/Coluna EAI 1.0 | Tabela/Coluna EAI 2.0 | Regras |
---|---|---|
HCINTEGRACAO.NOMEINTEGRACAO | GEAIPACOTEINSTALADO.NOMEPACOTE |
...
HCINTEGRACAO.NOMEREDUZIDO | GEAIPACOTEINSTALADO.NOMEREDUZIDO |
...
...
GEAIPACOTEINSTALADO.ID | Novo Guid | |
HCINTEGRACAO.SISTEMAINTEGRADO | GEAIPACOTEINSTALADO.APPID | O valor do campo "SistemaIntegrado" será usado para buscar o AppId da tabela GEAIApp |
...
De/Para
...
Tabela/Coluna EAI 1.0 | Tabela/Coluna EAI 2.0 | Regras |
---|---|---|
HCINTEGRACAOID.TABELARM | GEAIDEPARA.TABELARM |
...
HCINTEGRACAOID.IDNOMERM | GEAIDEPARA.CAMPOSRM |
...
HCINTEGRACAOID.IDVALORRM | GEAIDEPARA.VALORRM |
...
HCINTEGRACAOID.SISTEMAINTEGRADO | GEAIDEPARA.IDAPP |
...
HCINTEGRACAOID.IDENTIDADE | GEAIDEPARA.TRANSACAO |
...
HCINTEGRACAOID.IDINTEGRACAO | GEAIDEPARA.VALOREXTERNO |
...
...
Mensagem
Tabela/Coluna EAI 1.0 | Tabela/Coluna EAI 2.0 | Regras |
---|---|---|
HCFILAMENSAGEM.UUID | GEAIMENSAGEM.UUID |
...
HCFILAMENSAGEM.TIPOENTREGA | GEAIMENSAGEM.TIPOENTREGA |
...
HCFILAMENSAGEM.ENTRADASAIDA | GEAIMENSAGEM.ENTRADASAIDA |
...
HCFILAMENSAGEM.EVENTOMENSAGEM | GEAIMENSAGEM.EVENTO |
...
HCFILAMENSAGEM.TIPOMENSAGEM | GEAIMENSAGEM.TIPO |
...
HCFILAMENSAGEM.TRANSACTIONID | GEAIMENSAGEM.IDTRANSACAO |
...
HCFILAMENSAGEM.MENSAGEMORIGINAL | GEAIMENSAGEM.XMLORIGINAL |
...
HCFILAMENSAGEM.STATUSPROCESSAMENTO |
...
Essa coluna foi descontinuada |
...
HCFILAMENSAGEM.VERSAOMENSAGEM |
...
A versão da mensagem foi criada na tabela de Rotas |
...
HCFILAMENSAGEM.DATAINCLUSAO | GEAIMENSAGEM.DATAMSGORIGINAL |
...
HCFILAMENSAGEM.IDINTEGRACAO |
...
Essa coluna foi descontinuada | |
HCFILAMENSAGEM.CODCOLIGADA |
...
Essa coluna foi descontinuada | ||
HCFILAMENSAGEM.CODFILIAL |
...
Essa coluna foi descontinuada | ||
HCFILAMENSAGEM..CODUSUARIO |
...
Essa coluna foi descontinuada | ||
HCFILAMENSAGEM.MENSAGEMRECIBO |
...
Essa coluna foi descontinuada | |
HCFILAMENSAGEM.NOMEPRODUTO |
...
Essa coluna foi descontinuada |
Rotas da Mensagens
...
Tabela/Coluna EAI 1.0 | Tabela/Coluna EAI 2.0 | Regras |
---|---|---|
HCFILAMENSAGEM.VERSAOMENSAGEM | GEAIROTAMENSAGEM. |
...
VERSAO | ||
HCFILAMENSAGEM.IDINTEGRACAO | GEAIROTAMENSAGEM.IDAPP | Nessa coluna será grava não mais o identificador do pacote de integração, mas sim o aplicativo |
...
Execução da rota da Mensagem
...
Tabela/Coluna EAI 1.0 | Tabela/Coluna EAI 2.0 | Regras |
---|---|---|
HCFILAEXECUCAO.DATAEXECUCAO | GEAIEXECROTAMENS.DATAEXECUCAO |
...
HCFILAEXECUCAO.MENSAGEMTRANSFORAMDA | GEAIEXECROTAMENS.XMLMENSTRANSFORMADA |
...
HCFILAEXECUCAO.CODIGOEXECUCAO | GEAIEXECROTAMENS.CODIGOEXECUCAO |
...
HCFILAEXECUCAO.STATUSEXECUCAO | GEAIEXECROTAMENS.STATUSEXECUCAO |
...
HCFILAEXECUCAO.MENSAGEMEXECUCAO | GEAIEXECROTAMENS.MENSAGEMEXECUCAO |
...
HCFILAEXECUCAO.UUID |
...
Essa coluna foi descontinuada | |
HCFILAEXECUCAO.SEQUENCIA |
...
Essa coluna foi descontinuada | |
HCFILAEXECUCAO.MENSAGEMRESPOSTA |
...
Essa coluna foi descontinuada | |
HCFILAEXECUCAO.TIPOEXECUCAO |
...
Essa coluna foi descontinuada |
Migração das mensagens
- Todas as mensagens executadas com erros, síncronas ou assíncronas, serão migradas para a nova tabela de mensagens;
- Mensagens assíncronas, com menos de 5 tentativas de execução, será criado um job responsável em executá-las;
- Mensagens de envio "assíncronas" serão tratadas como "falso assíncrono", ou seja, elas serão migradas como "síncronas" mais processadas pelo Job;
- Segue abaixo a lista de transações contempladas pelo recurso de falso assíncrono:
DEVICEEQUIPMENTAPPOINTMENT
DEVICETASKSAPPOINTMENT
DEVICETRANSPORTCYCLEAPPOINTMENT
LABORDEVICETASKSAPPOINTMENT
...
...