Campo
Descrição
O ícone 
, exibido na parte inferior da tela após a inclusão de um monitor, abre a interface para manutenção dos filtros do monitor exclusivo.
A rotina permite a criação/manutenção de monitores personalizados, que podem ser incorporados às Visões dos usuários no painel de Gestão à Vista, da mesma forma que os monitores padrões. Estes Monitores Exclusivos podem ser utilizados para contemplar consultas tanto em tabelas específicas do cliente, como nas próprias tabelas padrões.
Essa ferramenta permite a definição de diversos elementos, como nome, filtros, tipo (texto ou gráfico) e outras características específicas dos monitores, proporcionando uma experiência de personalização completa.
A rotina foi desenvolvida no framework PO-UI e utiliza APIs REST para realizar a busca dos dados no Protheus. Dessa forma, é necessário que algumas configurações adicionais sejam feitas no ambiente Protheus. Verifique as configurações necessárias na página Pré-requisitos / Configuração.
Esta rotina está disponível a partir da release 12.1.2410, com possibilidade de implantação nas releases 12.1.2210 e 12.1.2310 através da atualização do pacote da expedição de contínua a partir de janeiro/2024 em Pacotes de Atualização - PCP - P12, incluindo pacote de dicionário. Sem a aplicação deste pacote, a tentativa de executar a rotina PCPMCUSTOM resultará em erro indicando o dicionário de dados desatualizado. Fazer inclusão no menu da rotina PCPMCUSTOM (função Protheus). Maiores detalhes em Gestão à Vista. |
Na tela de listagem, são exibidos todos os monitores exclusivos cadastrados. É possível pesquisar um monitor através de seu título ou objetivo.
Outras Ações / Ações relacionadas
Ação | Descrição |
|---|---|
| Adicionar | Redireciona para a tela de inclusão de um novo monitor exclusivo. |
| Editar | Abre a tela de edição, posicionada no monitor exclusivo selecionado. |
| Excluir | Apaga o monitor exclusivo selecionado e todos os seus relacionamentos (visões e filtros) |
Principais Campos e Parâmetros
Campo | Descrição |
|---|---|
| Título | Título padrão informado para o monitor exclusivo. |
| Agrupador | Tag que indica à qual agrupamento o monitor exclusivo pertence. |
| Tipo | Tags que exibem os tipos suportados pelo monitor exclusivo, podendo ser Texto e/ou Gráfico. |
| API negócio | Nome da classe ADVPL que conterá os métodos padrões para a busca de dados, detalhes e validação de filtros do monitor exclusivo. |
| Objetivo | Texto que descreve os objetivos e características do monitor exclusivo. |
Esta tela permite incluir ou alterar um monitor exclusivo já existente, assim como adicionar, editar ou excluir seus filtros.
Outras Ações / Ações relacionadas
Campo | Descrição |
|---|---|
| Cancelar | Interrompe o processo de inclusão ou edição de um monitor exclusivo e volta para a listagem. |
| Salvar | Confirma a inclusão ou alteração do monitor exclusivo, persistindo os dados no banco. |
| Filtros | O ícone |
Principais Campos e Parâmetros
Campo | Descrição |
|---|---|
| Título | Título padrão do monitor exclusivo, através do qual será identificado no momento da inclusão em uma Visão. |
| Agrupador | Indica à qual agrupamento o monitor exclusivo pertence. Durante a inclusão do monitor em uma Visão no Gestão à Vista, os monitores são separados conforme seu agrupador, para facilitar sua localização. Exemplo de agrupadores: Chão de Fábrica, Produção, Custos etc. |
| Objetivo | Texto que descreve os objetivos e características do monitor exclusivo. |
| Opções de visualização | Determina quais modos de apresentação de dados o monitor exclusivo irá suportar, podendo ser Texto, Gráfico ou ambos. |
| Opções de Gráficos | Se for selecionada a opção de apresentação Gráfico, esse campo permite escolher quais os tipos de Gráfico serão suportados: Pizza, Barras, Colunas, Rosca, Linhas ou Velocímetro (Gauge). |
| API de negócio | Nome da classe ADVPL que conterá os métodos padrões para a busca de dados, detalhes e validação de filtros. Essa classe estará num fonte .PRW e precisará ser desenvolvida pelo usuário seguindo a documentação técnica. |
| Rascunho? | Se assinalado, o monitor não aparecerá para os demais usuários no painel do Gestão à Vista, exceto para o próprio usuário que cadastrou o monitor exclusivo. Essa opção é útil para evitar que um monitor que ainda está sendo desenvolvido ou testado seja utilizado indevidamente. |
Esta janela auxilia na manutenção dos filtros de um monitor, permitindo flexibilidade nas parametrizações das consultas de acordo com a necessidade. Esses filtros ficarão disponíveis para o preenchimento do usuário e serão disponibilizados nos métodos padrões da API de negócio.
Outras Ações / Ações relacionadas
Ação | Descrição |
|---|---|
| Alterar ordenação | Permite que o usuário escolha a ordem em que os filtros aparecerão para o usuário. Ao clicar no botão, basta segurar e arrastar os cards dos filtros para a posição desejada. |
| + Adicionar | Muda a interface para o modo de adição, que permite incluir um novo filtro. |
| Editar | Muda a interface para o modo de edição para um filtro já existente. |
| Excluir | Após confirmação, apaga o filtro selecionado. |
Principais Campos e Parâmetros
Dependendo do tipo do filtro selecionado, os campos disponíveis irão mudar. Essas informações são obrigatórias para o funcionamento do filtro, portanto é necessário preencher todas.
Campo | Descrição | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Tipo | Tipo do filtro, que determina o formato e a apresentação do filtro para o usuário. Pode ser: Texto, Numérico, Data, Seleção, Multi-Seleção ou Lookup (Zoom). | ||||||||||||||
| Título | Título do filtro. É o texto que aparecerá acima do filtro quando este estiver sendo visualizado. | ||||||||||||||
| Propriedade | Código único do filtro, para diferenciá-lo dos demais. É através do valor desse campo que a API de negócio irá localizar e buscar o valor informado no filtro pelo usuário. | ||||||||||||||
Opções de seleção | Disponível para filtros do tipo Seleção e Multi-Seleção. Define quais as opções que poderão ser escolhidas pelo usuário ao utilizar o filtro. O título é o nome que aparecerá na lista no momento da seleção, enquanto o valor é o que será enviado para a API. Exemplo: Caso seja criado um filtro para a situação das OPs, as opções seriam:
Se o usuário selecionar a opção Ociosa, será enviado no campo correspondente o valor 4. | ||||||||||||||
Seleção múltipla? | Disponível para filtros do tipo Lookup (Zoom). Indica se é permitido selecionar mais de um item na lista de registros deste filtro. | ||||||||||||||
Tabela genérica? | Disponível para filtros do tipo Lookup (Zoom). Indica se a origem dos dados deste filtro será alguma Tabela Genérica (SX5), criada a partir do Configurador. | ||||||||||||||
Tabela principal | Disponível para filtros do tipo Lookup (Zoom). Define qual a tabela será utilizada para a busca dos dados que aparecerão no zoom. Caso a origem dos dados deste filtro seja uma Tabela Genérica (SX5), será informada a chave que identifica esta tabela (ex.: 01, 02, 03, etc.) | ||||||||||||||
Chave primária | Disponível para filtros do tipo Lookup (Zoom). Campo que será utilizado como chave única dos registros da tabela selecionada como principal para o zoom.
| ||||||||||||||
Campo de descrição | Disponível para filtros do tipo Lookup (Zoom). Campo que será utilizado como descrição dos registros da consulta. Ele será exibido em uma coluna chamada Descrição na tela de zoom. |