Tela de diagnóstico de ambiente - HTML.Diagnostic

ÍNDICE

1. Visão Geral
2. Testes realizados
   1. Testes de Serviços
      1. DATASUL REST
      2. TOTVS REST
      3. ExecBO
   2. Teste de Acentuação
   3. Teste de caracteres especiais
   4. Teste numérico
3. Informações do servidor AppServer
   1. Ambiente
   2. Propath
   3. Bancos

01. VISÃO GERAL

A tela de diagnóstico de ambientes tem por objetivo identificar e ajudar na correção dos principais problemas relacionados a parametrização do framework do produto, necessário para a execução das demais rotinas HTML, Mobile e de integrações externas que utilizam o AppServer.

Sua utilização é bastante simples, necessitando apenas um clique no botão Validar para dar início aos testes. Os resultados são exibidos de forma intuitiva e o resumo dos testes, assim como qualquer mensagem de erro que porventura tenha ocorrido, pode ser consultado ao clicar nos botões de detalhe.

02. TESTES REALIZADOS

Esta aplicação realiza uma série de testes nas principais funcionalidades básicas utilizadas pelas diversas telas HTML e Apps existentes no produto Datasul. Não há regra de negócio envolvida nesses testes, o único objetivo é verificar se o ambiente possui o necessário para executar os demais programas do ERP. Portanto, caso ocorra alguma mensagem de erro durante o diagnóstico, muito provavelmente todas as outras telas que utilizam a mesma tecnologia que apresentou erro também não irão funcionar, indicando que a origem do problema está na parametrização do ambiente e não na rotina de negócio em si.

Para iniciar o processo, basta clicar no botão Validar. Todos os testes serão executados em sequencia, e os resultados podem ser visualizados após a finalização do último. Se um teste foi concluído com sucesso, será exibido um check verde abaixo dele. Caso contrário, um X vermelho. O detalhamento pode ser consultado na opção de mesmo nome, localizada abaixo de cada teste.

02.a Testes de Serviços

• DATASUL REST - O objetivo desta funcionalidade consiste em permitir a execução de procedures (regras de negócio) via REST. Essa forma de comunicação é utilizada por Apps e telas HTML. Nesse teste, a tela de diagnóstico envia uma requisição do tipo DATASUL REST para uma API especialmente preparada para recebê-la. Se essa mensagem chegar ao destino corretamente, a API irá responder com um OK e devolverá a requisição. Se durante todo esse processo não ocorrer nenhum erro, o teste será concluído com sucesso.
  
  

• TOTVS REST - É uma revisão do Datasul REST. O objetivo desta funcionalidade consiste em permitir a execução de procedures (regras de negócio) via REST. Essa forma de comunicação é utilizada por Apps e telas HTML (incluindo PO UI). De forma semelhante ao que acontece no teste do DATASUL REST, aqui também será enviada uma requisição para uma API, porém seguindo o novo padrão de mensagem TOTVS REST. Se a requisição retornar com um OK da API, a configuração do ambiente está correta.
  
  

• ExecBO - O ExecBO permite a execução de procedures (regras de negócio) em programas Progress (BO – Business Object) no Datasul através de aplicações web, por exemplo o Fluig. A tela de diagnóstico envia um comando utilizando a arquitetura padrão do ExecBO, imitando uma aplicação real, e aguarda o resultado positivo na resposta. 

02.b Testes de Acentuação

Aqui, a aplicação testa se o Encoding do JAVA para acentuação está configurado corretamente. A tela envia para a API a frase "Ação+Propósito" com encoding UTF-8 e verifica se no destino ela permaneceu inalterada. Se o ambiente não estiver parametrizado corretamente, a frase ficará distorcida (Ex: AþÒo+Prop¾sito). Caso ocorra algum problema nessa função, sugerimos verificar se os parâmetros de inicialização do JAVA do ambiente estão conforme o modelo: -Dsun.jnu.encoding=UTF-8 -Dfile.encoding=UTF-8.

02.c Testes de Caracteres especiais

Nesse teste, a tela envia o conjunto de caracteres "@;/#,$'%" para a API e verifica se no destino o conjunto é o mesmo. De forma semelhante ao teste te acentuação, se ocorrer algum problema nos caracteres especiais, sugerimos verificar os parâmetros de encoding do Java.

02.d Teste Numérico

Aqui, a tela de diagnóstico envia o numeral "1.5" para a API e testa se ele permaneceu inalterado no destino. Se o ambiente estiver no formato incorreto, o número se tornará "1,5'. Essa configuração é realizada nos parâmetros de inicialização do Progress/AppServer.

03. Informações do servidor AppServer

Esta sessão mostra informações relevantes acerca do servidor AppServer utilizado pelo DATASUL. Pode ser utilizada para consulta rápida dos dados e também como material de envio ao Suporte através do botão Imprimir, que gera um PDF contendo todas as informações exibidas aqui.

03.a Ambiente

03.b Propath

Esta sessão exibe o propath utilizado pelo AppServer. Útil para verificar onde devem ser aplicadas as liberações especiais para testes, ou se os caminhos informados estão corretos.

03.c Bancos

Informações técnicas a respeito dos bancos conectados ao AppServer. Permite verificar os parâmetros de conexão e a determinar se há algum problema relacionado à ALIAS ou unificação.