01. DADOS GERAIS
Produto: | TOTVS Manufatura
|
---|---|
Linha de Produto: | Linha Logix |
Segmento: | Tecnologia |
Módulo: | Administração Logix - Framework |
Função: | Comunicação HTTP REST |
País: | Brasil |
Ticket: | 11187613 |
Requisito/Story/Issue (informe o requisito relacionado) : | DFWKTOOLS-4766 |
02. SITUAÇÃO/REQUISITO
Na ocorrência de alguma exceção de uma API através do acionamento de uma função 4GL durante uma requisição HTTP REST, o retorno da requisição não reportava de forma clara o problema e através do LOG do AppServer também fica difícil identificar o problema.
03. SOLUÇÃO
Foram realizadas algumas melhorias em relação ao tratamento de erros nas execuções de funções a partir das requisições HTTP REST, fazendo o devido retorno com melhor detalhamento da falha, bem como registro de mensagens de LOG no AppServer para facilitar a identificação da origem do problema.
04. DEMAIS INFORMAÇÕES
Ativação de chaves para geração de LOG em requisições HTTP REST
Para ativar a geração de mensagens de LOG no AppServer durante o processamento de requisições HTTP REST, com objetivo de facilitar a identificação de problemas através de um nível mais detalhado de informações, pode-se ativar algumas chaves no AppServer e Profile Logix, sendo:
- No arquivo INI do AppServer, ativar as seguintes chaves na seção do ambiente utilizado pela requisição HTTP REST, sendo este identificado pelo conteúdo da chave ENVIRONMENT na seção HTTPJOB. Na seção deste ENVIRONMENT indicado, é preciso ativar as chaves abaixo para registrar mensagens de LOG de toda comunicação HTTP REST recebida pelo AppServer:
FWTRACELOG=1
FWLOGMSG_DEBUG=1
- No arquivo de Profile Logix utilizado no mesmo ambiente das requisições HTTP REST, ative a geração de outro conjunto de mensagens de LOG gerenciadas pela camada de funcionalidades Framework Logix através das chaves a seguir:
logix.debug=1
logix.source.debug=1
Com a ativação destas chaves todo detalhamento das informações recebidas pelo AppServer nas requisições HTTP REST serão devidamente registrados com mensagens de DEBUG no arquivo de LOG do AppServer, sendo alguns dados como:
- STATUS
- Horário
- Tempo de execução
- Método da requisição
- Informações das seções HEADER e BODY
- URL de requisição
Observação
Caso surja algum problema relacionado a formatação de conteúdos em JSON, é possível também ativar a chave de profile logix.json.debug=1, onde no arquivo de LOG do AppServer serão registradas informações de conversões de dados no formato JSON. Neste caso as mensagens no LOG do AppServer serão precedidas da TAG [JSON].
Disponível a partir do pacote oficial 12.1.33 ou Framework Fix 12.1.32.(fix01)IMPORTANTE!
05. ASSUNTOS RELACIONADOS