01. DADOS GERAIS
Produto: | TOTVS Framework
|
---|---|
Linha de Produto: | Linha Logix |
Segmento: | Tecnologia |
Módulo: |
Framework (Linha Logix) - Tecnologia
|
Função: | Integração via EAI Fake (Utilizado pra desenvolvimento de integração com outro produto) |
País: | Brasil |
Ticket: | |
Requisito/Story/Issue (informe o requisito relacionado) : | DFWKLOGIX-1630 |
02. SITUAÇÃO/REQUISITO
Durante a fase de desenvolvimento de uma nova integração EAI, é comum o uso de um utilitário que denominamos EAI Fake, que simula qualquer outro produto, não havendo necessidade de existir uma instalação do produto de destino, no entanto é necessário ter todas informações e formatos das mensagens XML de retorno das integrações, com base nos adapters utilizados para integração.
Após registrar um aplicativo, fazendo uso do WSDL EAI Fake do appserver local e ativando uma rota de integração via Adapter de cadastro de itens (Adapter ADP10001 utilizado para a transação "Item") via programa EAI10000 (Central de configuração e monitoramento de mensagens do EAI), ao tentar realizar o cadastro de um novo item via MAN10021 (Cadastro de itens), a integração via EAI Fake gera falhas e na análise do arquivo de LOG é possível identificar que ocorreu falha no Parser do XML retornado pelo WebServices EAI Fake. Com esta falha o cadastro do item é cancelado, pois a integração é do tipo síncrona.
03. SOLUÇÃO
Ajustes em algumas classes e funções de integração do EAI para melhorar o tratamento de falhas de processamento, registrando também um maior volume de mensagens de LOG de acompanhamento de processamento no arquivo de LOG do AppServer, quando o modo DEBUG do EAI estiver ativo.
A falha de parser UTF-8 no WebServices EAI Fake foi ajustado, bem como o envio de mensagens do EAI Logix para outro aplicativo externo que são enviadas no formato UTF-8, após aplicar as regras de formatação do conteúdo da mensagem que é indicado no cadastro do aplicativo externo.
Foi criada a nova função _ADVPL_isUTF8Encoded que visa identificar quando um conteúdo de texto está formatado ou não no encode UTF-8. Esta função passou a ser utilizada nas funções _ADVPL_LOG_decodeUTF8 e _ADVPL_LOG_encodeUTF8 para evitar que um conteúdo de texto tenha ajuste de encode de forma indevida.
04. DEMAIS INFORMAÇÕES
Para simular um ambiente de desenvolvimento para testes de integração com outro produto que não tenha uma instalação disponível, você pode fazer uso de uma funcionalidade chamada de EAI Fake.
Acesse o link 1 - EAI Fake para mais informações.
Informações e exempllos das funções alteradas e nova função envolvendo encode UTF-8 estão disponíveis nos seguintes links:
Disponível a partir do pacote oficial 12.1.2503 ou Framework Fix 12.1.2411(fix01)IMPORTANTE!
05. ASSUNTOS RELACIONADOS
- Não se aplica.