As informações atuais é a tela de inicialização da central de diagnóstico, onde de forma centralizada, permite o controle e supervisão do seu ambiente Protheus. Esta interface intuitiva oferece uma visão detalhada do ambiente do sistema, desde as informações importantes do usuário até a análise do dicionário de dados.

Nesta tela, você terá acesso a detalhes essenciais, como:

• Informações do usuário
• Versão do sistema
• Versões dos artefatos do Protheus
• Configuração do ambiente
• Análise do dicionário de dados
• Recursos disponíveis
  • Menu funcional
  • Painel Online
  • Navegador integrado

Veja abaixo as exemplo da tela inicial da Central:

Descrição das informações relevantes em 'Informações atuais':

Parâmetros da rotina 

A aba de parâmetros é uma funcionalidade de fornecer aos usuários uma visão completa e detalhada dos parâmetros associados a rotinas posicionada. Essa aba oferece um panorama sobre como quais parâmetros podem afetar diretamente o funcionamento de tal rotina, permitindo consulta e manutenção dos parâmetros para atender às necessidades operacionais. 

Quais parâmetros será listados na tabela? 

Será listados todos os parâmetros contidos no fonte da rotina selecionada em questão, caso esse fonte acionar outras funções contidas em outros fontes, também serão listados os parâmetros dessas funções de outros fontes. Então será listados todos os parâmetros em todos os níveis que podem interferir o funcionamento da rotina.

Ações disponíveis na tela de parâmetros.

• Filtro

Visão Geral

O filtro de parâmetros é uma funcionalidade que permite aos usuários refinar a exibição de parâmetros em rotinas com quantidades elevadas de informações. Esse filtro oferece a capacidade de filtrar parâmetros com base em diferentes critérios, incluindo módulo, rotina e parâmetros específicos. Ao usar essa funcionalidade, os usuários podem focar nas informações relevantes e tornar a navegação pela tabela de parâmetros mais eficiente.

Acesso ao Filtro de Parâmetros

Para acessar o filtro de parâmetros, siga as etapas abaixo:

1. 1. 1. Navegue até a seção de "Parâmetros da rotina" em "Informações atuais".
      2. No topo da tabela de parâmetros, localize o botão e clique nele.

Comportamento do Filtro

Quando você aciona o filtro de programa (rotina), ele terá prioridade sobre o filtro de módulo. Isso significa que, se um filtro de programa for aplicado, ele irá sobrepor o filtro de módulo, ignorando-o temporariamente. Essa abordagem flexível permite que você ajuste os filtros conforme necessário para obter os resultados desejados.

Contador de Opções no Filtro

Ao adicionar mais opções de filtragem, o contador de opções será atualizado para refletir o número de filtros ativos. Isso fornece uma visão clara das opções de filtragem atualmente em uso, ajudando você a entender quais critérios estão afetando a exibição dos parâmetros.

Funcionamento do Filtro

Ao acionar o filtro de parâmetros, uma slide de opções de filtro será exibida, permitindo a configuração de critérios de filtragem. Os seguintes aspectos podem ser filtrados:

• • Módulo: Permite filtrar os parâmetros com base no módulo ao qual estão associados. Selecione um módulo específico para exibir apenas os parâmetros relacionados a esse módulo.

• • Programa (Rotina): Permite filtrar os parâmetros com base na programa (rotina) em que são usados. Ao selecionar uma rotina, apenas os parâmetros associados a essa rotina serão exibidos.

• • Parâmetros: Permite filtrar os parâmetros pelo código do parâmetro. Apenas os parâmetros que correspondem aos critérios de pesquisa serão mostrados.

• Detalhamento do parâmetro

Visão Geral

A funcionalidade de detalhamento de parâmetros permite aos usuários obter informações específicas sobre um determinado parâmetro no sistema. Ao clicar no nome de um parâmetro, um slide será aberto na tela, exibindo detalhes do parâmetros, como programas, módulos e a data a partir da qual o parâmetro é acionado pelo código-fonte.

Acesso ao Detalhamento de Parâmetros

Para acessar o detalhamento de parâmetros, siga estas etapas:

1. 1. Navegue até a seção de "Parâmetros de rotina" no sistema.
   2. Localize e identifique o parâmetro do qual deseja obter mais informações.
   3. Clique sobre o nome do parâmetro.

Detalhes Exibidos

Ao clicar no nome do parâmetro, a tela de detalhamento será aberta, exibindo as seguintes informações:

• • Nome do parâmetro: O nome do parâmetro selecionado.
  • Programas relacionados: Uma lista de programas no sistema que utilizam esse parâmetro. Isso ajuda a compreender o impacto de alterações no parâmetro.
  • Data de ativação: A partir de qual data o código-fonte do sistema começou a acionar este parâmetro. 
  • Módulos associados: Uma visão geral dos módulos nos quais o parâmetro é usado. Isso ajuda a entender as áreas do sistema que podem ser afetadas por mudanças neste parâmetro.

• Edição do conteúdo do parâmetro.

Visão Geral

A funcionalidade de edição de conteúdo na tabela de parâmetros permite que os usuários do grupo administrador realizem alterações nos dados dos parâmetros existentes. Essa capacidade de edição oferece flexibilidade na manutenção e ajuste das informações contidas na tabela, garantindo que as configurações permaneçam atualizadas e precisas ao longo do tempo.

Realizando a Edição

Uma vez autenticado como um usuário do grupo administrador e tendo localizado o parâmetro desejado, siga as etapas abaixo para editar o conteúdo:

1. 1. Clique na célula 'Editar' correspondente ao parâmetro que você deseja editar.
   2. Será aberto o modal onde demonstrará o detalhes do parâmetro selecionado.
   3. Faça as alterações necessárias.

Salvar as Alterações

Após concluir a edição do conteúdo do parâmetro, é importante salvar as alterações para que elas sejam registradas no sistema. Para salvar as modificações, siga estas etapas:

1. 1. Após fazer as alterações, clique no botão 'Aplicar'.
   2. Uma mensagem de confirmação será exibida, solicitando que você confirme a alteração.
   3. Clique em "Salvar" para confirmar as alterações ou em "Cancelar" para descartá-las.

Pontos de entrada

A aba de ponto de entrada é uma funcionalidade de fornecer aos usuários uma visão completa e detalhada dos pontos de entrada da rotina posicionada. Essa aba oferece um panorama sobre como quais pontos de entrada podem afetar diretamente o funcionamento de tal rotina, permitindo consulta e manutenção dos pontos de entrada para atender às necessidades operacionais. Este documento tem como objetivo guiar os usuários através do uso eficaz da aba de pontos de entrada, detalhando os recursos disponíveis e suas capacidades.

Quais são os pontos de entradas que será listado na tabela? 

Serão listados todos os pontos de entradas contidos no fonte da rotina selecionada em questão, caso esse fonte acionar outras funções contidas em outros fontes, também serão listados os pontos de entradas dessas funções de outros fontes. Então será listados todos os pontos em todos os níveis que podem interferir o funcionamento da rotina.

Colunas na Tabela

A tabela de pontos de entrada apresenta os seguintes detalhes em cada linha:

• Ponto de Entrada: O nome do ponto de entrada, por exemplo, "A012BRWT".
• Descrição: Uma breve descrição contido na documentação do ponto de entrada. Caso não houver descrição o ponto de entrada não possui documentação referênciada.
• Status: O estado atual do ponto de entrada, que pode ser um dos seguintes:

  • Inexistente: O ponto de entrada ainda não foi implementado.

  • Compilado: O ponto de entrada foi compilado e está disponível para uso.

  • Desativado: O ponto de entrada foi desativado.

• Ação: Ações disponíveis para cada ponto de entrada, dependendo do seu status:

  • Desativar: Desativa um ponto de entrada que está ativo.

  • Ativar: Ativa um ponto de entrada que foi desativado.

• Documento: Links ou informações relacionadas a documentos relevantes associados ao ponto de entrada no TDN, como documentação de referência ou guias de utilização.

Ações disponíveis na tela de pontos de entrada.

• Filtro

Visão Geral

O filtro de pontos de entradas é uma funcionalidade que permite aos usuários refinar a exibição de pontos de entrada em rotinas com quantidades elevadas de informações. Esse filtro oferece a capacidade de filtrar pontos de entrada com base em diferentes critérios, incluindo módulo, rotina e pontos de entradas específicos. Ao usar essa funcionalidade, os usuários podem focar nas informações relevantes e tornar a navegação pela tabela mais eficiente.

Acesso ao Filtro de ponto de entrada.

Para acessar o filtro, siga as etapas abaixo:

1. 1. 1. Navegue até a seção de "Pontos de entrada" em "Informações atuais".
      2. No topo da tabela de parâmetros, localize o botão e clique nele.

Comportamento do Filtro

Quando você aciona o filtro de programa (rotina), ele terá prioridade sobre o filtro de módulo. Isso significa que, se um filtro de programa for aplicado, ele irá sobrepor o filtro de módulo, ignorando-o temporariamente. Essa abordagem flexível permite que você ajuste os filtros conforme necessário para obter os resultados desejados.

Contador de Opções no Filtro

Ao adicionar mais opções de filtragem, o contador de opções será atualizado para refletir o número de filtros ativos. Isso fornece uma visão clara das opções de filtragem atualmente em uso, ajudando você a entender quais critérios estão afetando a exibição dos parâmetros.

Funcionamento do Filtro

Ao acionar o filtro de pontos de entrada, uma slide de opções de filtro será exibida, permitindo a configuração de critérios de filtragem. Os seguintes aspectos podem ser filtrados:

• • Módulo: Permite filtrar os pontos de entrada com base no módulo ao qual estão associados. Selecione um módulo específico para exibir apenas os pontos de entrada relacionados a esse módulo.

• • Programa (Rotina): Permite filtrar os pontos de entrada com base na programa (rotina) em que são usados. Ao selecionar uma rotina, apenas os parâmetros associados a essa rotina serão exibidos.

• • Parâmetros: Permite filtrar os parâmetros pelo código do ponto de entrada. Apenas os pontos de entrada que correspondem aos critérios de pesquisa serão mostrados.

• Detalhamento do ponto de entrada

Visão Geral

A funcionalidade de detalhamento dos pontos permite aos usuários obter informações específicas sobre um determinado ponto de entrada no sistema. Ao clicar no nome de um ponto de entrada, um slide será aberto na tela, exibindo detalhes, como programas, módulos e a data de a partir de quando é acionado pelo código-fonte.

Acesso ao Detalhamento de pontos de entrada

Para acessar o detalhamento de pontos de entrada, siga estas etapas:

1. 1. Navegue até a seção de "Pontos de entrada" no sistema.
   2. Localize e identifique o ponto de entrada do qual deseja obter mais informações.
   3. Clique no nome do ponto de entrada.

Detalhes Exibidos

Ao clicar no nome do ponto de entrada, a tela de detalhamento será aberta, exibindo as seguintes informações:

• • Nome do ponto de entrada: O nome do ponto selecionado.
  • Programas relacionados: Uma lista de programas no sistema que utilizam esse ponto de entrada. Isso ajuda a compreender o impacto do ponto de entrada.
  • Data de ativação: A partir de qual data o código-fonte do sistema começou a acionar este ponto de entrada. 
  • Módulos associados: Uma visão geral dos módulos nos quais o pontos de entrada é usado. Isso ajuda a entender as áreas do sistema que podem ser afetadas por mudanças neste parâmetro.

A rotina de Diagnóstico de Dicionários permite fazer uma verificação na base em busca de possíveis erros que podem causar problemas ou impedir a correta execução de rotinas de atualização, como o UPDDISTR por exemplo. Utilizando a rotina de Diagnóstico, é possível identificar problemas de integridade para uma tabela específica em sua base de dados, que podem ocasionar erros em sua rotina.

Obs. 1: esta rotina apenas exibe uma listagem dos problemas encontrados. Qualquer correção deve ser feita manualmente pelo administrador do sistema.

Obs. 2: disponível a partir da LIB versão 20230109 com dicionário no banco de dados.

Para utilização desse App no Protheus, é necessário ativar as seguintes linhas no arquivo appserver.ini:

Maiores detalhes sobre a configuração para execução de Apps no Protheus:
https://tdn.totvs.com/display/tec/WebApp+-+Configurando+nativamente+o+Application+Server+como+servidor+Web
https://tdn.totvs.com/display/public/framework/FwCallApp+-+Abrindo+aplicativos+Web+no+Protheus

Tela principal

Na tela principal, conforme exemplificado na imagem abaixo, temos os seguintes itens:

Image Modified

OPERAÇÃO

Caixa de seleção para escolher qual operação de dicionários será executada no diagnóstico. Pode ser marcada mais de uma caixinha de operação para executar. As opções que estão disponíveis para diagnóstico são:

- Integridade SX3 (campos) x SXG (grupo de campos): indica problemas de cadastro entre a tabela SX3 e a tabela SXG, como por exemplo, grupos de campos indicados em um campo na SX3, mas que não existe de fato cadastrado na SXG.

- Integridade SX1 (perguntas) x SXG (grupo de campos): indica problemas de cadastro entre a tabela SX1 e a tabela SXG, como por exemplo, um grupo de campos indicado em uma pergunta, mas que não existe de fato cadastrado na SXG.

- Integridade SX3 x tabela física: faz a busca por diferenças entre campos na tabela SX3 e os campos que estão nas tabelas físicas criadas. Por exemplo, pode detectar que um campo está cadastrado na SX3 como pertencente a tabela SA1, mas esse campo não existir de fato na SA1. Ou ao contrário, o campo existir na tabela SA1, mas não estar cadastrado na SX3.

- Integridade SX3 (campos) x SIX (índices): indica divergências entre campos e índices, como por exemplo campos que aparecem listados em índices, mas que não existem de fato cadastrados na SX3.

- Integridade SIX (índices) x tabela física: faz a busca por diferenças entre índices na tabela SIX e os índices que estão nas tabelas físicas criadas. Por exemplo, pode detectar que um índice está cadastrado na SIX como pertencente a tabela SA1, mas esse índice não existir de fato na SA1. Ou ao contrário, o índice existir na tabela SA1, mas não estar cadastrado na SIX.

DICIONÁRIO DE:

Indica o dicionário inicial da busca. Habilitado quando pelo menos uma operação envolver os dicionários SX3 ou SIX. Opções de busca:
- Digitar diretamente o código da tabela que deseja utilizar como parâmetro inicial da busca (por exemplo, SA1)
- Digitar apenas a letra A, para iniciar da primeira tabela disponível
- Utilizar a lupa para obter uma listagem das tabelas disponíveis

Obs.: diretamente no campo, você pode digitar o código de qualquer tabela existente no Protheus, mas se utilizar a lupa, somente serão listadas as tabelas que já tenham sido criadas fisicamente no banco de dados.

DICIONÁRIO ATÉ:

Indica o dicionário final da busca. Habilitado quando pelo menos uma operação envolver os dicionários SX3 ou SIX. Opções de busca:
- Digitar diretamente o código da tabela que deseja utilizar como parâmetro final da busca (por exemplo, SA6)
- Digitar apenas as letras ZZZ, para terminar na última tabela disponível
- Utilizar a lupa para obter uma listagem das tabelas disponíveis

Obs.: diretamente no campo, você pode digitar o código de qualquer tabela existente no Protheus, mas se utilizar a lupa, somente serão listadas as tabelas que já tenham sido criadas fisicamente no banco de dados.

PERGUNTA DE:

Indica a pergunta inicial da busca. Habilitado quando a operação envolver o dicionário SX1. Opções de busca:
- Digitar diretamente o código da pergunta que deseja utilizar como parâmetro inicial da busca (por exemplo, ACC010)
- Digitar apenas a letra A, para iniciar da primeira pergunta disponível
- Utilizar a lupa para obter uma listagem das perguntas disponíveis

PERGUNTA ATÉ:

Indica a pergunta final da busca. Habilitado quando a operação envolver o dicionário SX1. Opções de busca:
- Digitar diretamente o código da pergunta que deseja utilizar como parâmetro final da busca (por exemplo, FINR917)
- Digitar apenas as letras ZZZZZZZZZZ, para terminar na última pergunta disponível
- Utilizar a lupa para obter uma listagem das perguntas disponíveis

BOTÃO PROCESSAR:

Após configurar qual(is) dicionário(s) e parâmetros deseja executar, clique no botão Processar para iniciar o processamento das informações.

Tela de Resultado de Diagnóstico

Nesta tela são apresentados os resultados baseados na busca feita com os parâmetros selecionados. Temos aqui os seguintes itens:

Image Modified

COLUNAS - OPERAÇÃO, CHAVE, DESCRIÇÃO E RESULTADO:

Apresentam as informações dos resultados da busca efetuada.

BOTÃO CARREGAR MAIS RESULTADOS:

Se o texto estiver na cor cinza, indica que todos os resultados já estão carregados na tela. Mas se o texto estiver azul, indica que o botão está disponível para ser clicado e existem mais resultados para carregar na tela, devido a grande quantidade de resultados obtidos.

CAIXA DE PESQUISAR:

Permite digitar uma string (completa ou parcial de um texto), e procura em todas as colunas. Por exemplo, na imagem acima, eu posso digitar na busca apenas a palavra "Teste", e a pesquisa vai trazer resultados contendo os campos A1_TESTE, A2_TESTE2 e A6_TESTE2 (imagem abaixo).

Obs.: Devido a necessidade de pesquisar em todos os resultados, se houverem mais dados do que os que cabem na tela, ao pesquisar será automaticamente acionado o botão de Carregar mais resultados até que todos estejam carregados, para que a busca seja feita corretamente. Sendo assim, se cancelar a pesquisa (clicando no X que aparece na etiqueta de Pesquisa rápida ou limpando a caixa de pesquisa e clicando na Lupa), todos os resultados já vão estar carregados na tela, não sendo mais necessário clicar no botão Carregar mais resultados.

BUSCA AVANÇADA:

Semelhante ao botão Pesquisar, porém com a possibilidade de combinar colunas (Operação, Chave, Descrição ou Resultado) para trazer um resultado mais preciso. Por exemplo, na imagem acima, a pesquisa por "Teste" trouxe os resultados que tem os campos A1_TESTE, A2_TESTE2 e A6_TESTE2. Mas se for colocado na Busca avançada, a Chave "SA2" e a Descrição "Teste", o resultado será apenas o registro que tem a tabela SA2, campo A2_TESTE2 (imagens abaixo).

Obs.: Para limpar os filtros, clique no X ao lado de cada filtro na tela de Resultado, ou clique em Remover todos.

BOTÃO EXPORTAR:

Permite fazer a exportação dos resultados para uma planilha. Ao clicar no botão Exportar, o aviso abaixo será exibido:

Se escolher a opção Grid, apenas os dados que estão carregados na tela até o momento serão exportados para a planilha. Se tiver feito um filtro, por exemplo, irá exibir os resultados do filtro. Se for selecionada a opção TODOS, serão exportados para a tabela todos os resultados da busca efetuada mediante os parâmetros. Esta opção pode demorar um pouco mais pois precisa terminar de carregar todos os resultados antes de fazer a exportação.