01. VISÃO GERAL
O painel de Gestão à Vista contempla inicialmente diversos monitores padrões que têm como objetivo proporcionar rápido acesso às informações pertinentes sobre determinados processos ou locais de seu ambiente produtivo, abrangendo escopos do PCP, Estoque, GFE e Qualidade. Entretanto, existe a necessidade de também contemplar consultas personalizadas, tanto em tabelas específicas dos clientes como novas abordagens nas próprias tabelas padrões.
Esta rotina consiste no primeiro passo para a criação e manutenção destes Monitores Exclusivos, que podem ser incorporados às Visões dos usuários no painel de Gestão à Vista, da mesma forma que os monitores padrões. Nela é realizada 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.
Em seguida, é necessário que seja realizada a codificação da classe ADVPL que será responsável por extrair os dados necessários para a apresentação, seguindo os padrões e utilizando as ferramentas descritas no documento Gestão à Vista - Monitores Exclusivos - Documentação Técnica.
Com objetivo de facilitar ainda mais o entendimento dos Monitores Exclusivos, consulte também o documento Gestão à Vista - Monitores Exclusivos - Criando Seu Primeiro Monitor, que demonstra todo o processo de criação, desde seu cadastro até a codificação da classe ADVPL e posterior inclusão do novo monitor nas visões.
02. REQUISITOS
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).
Local sugerido: menu Atualizações, sub-menu Gestão à Vista, item Gestão à vista - Monitores Exclusivos.
Maiores detalhes em Gestão à Vista.
03. TELA DE LISTAGEM
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. |
| Abre a tela de edição, posicionada no monitor exclusivo selecionado. |
| Após confirmação, 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. |
04. TELA DE INCLUSÃO/EDIÇÃO
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. |
| Confirma a inclusão ou alteração do monitor exclusivo, persistindo os dados no banco. |
| Exibido na parte inferior da tela após a inclusão de um monitor, este ícone dá acesso à interface para manutenção dos filtros do monitor exclusivo. |
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. |
Quando um monitor exclusivo já estiver sido incluído em alguma Visão e algum usuário editar seu cadastro, será exibida uma mensagem de alerta indicando que qualquer alteração pode ocasionar problemas de compatibilidade.
Exemplo: Alteração/exclusão de um ou mais filtros, alteração nas Opções de Visualização ou no nome da API de Negócio, etc.
05. TELA DE INCLUSÃO E ALTERAÇÃO DE FILTROS
Esta janela auxilia na manutenção dos filtros de um monitor exclusivo, 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 |
|---|---|
| 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. |
| Muda a interface para o modo de adição, que permite incluir um novo filtro. |
| Muda a interface para o modo de edição para um filtro já existente. |
| 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. |
Configurações avançadas (opcionais)
Cada tipo de filtro possui algumas opções de configurações opcionais que permitem customizar sua aparência e funcionamento.
| Campo | Tipo de filtro | Descrição |
|---|---|---|
| Estilos HTML/CSS | Todos | Permite estilizar o campo de filtro utilizando propriedades nativas do HTML e CSS (verificar exemplos em W3Schools). |
| Classes CSS/PO-UI | Todos | Permite estilizar o campo de filtro utilizando classes nativas do PO-UI e CSS (verificar exemplos em PO-UI). Exemplo: Definir o tamanho (largura) do filtro, seu espaçamento entre os demais, margem e padding. Deve-se informar as classes uma ao lado da outra, apenas separando-as com um espaço: po-sm-12 po-md-6 po-lg-3 po-pt-2 |
| Escolher ícone | Texto e Numérico | Permite selecionar o ícone que será exibido no canto esquerdo do campo. |
| Tamanho máximo (caracteres) | Texto | Delimita o número máximo de caracteres que poderá ser informado pelo usuário nesse campo. |
| Tamanho | Numérico | Delimita a quantidade de casas inteiras que poderão ser informadas pelo usuário nesse campo. Se for definido como 5, o usuário poderá informar um número máximo de 99.999. |
| Decimais | Numérico | Delimita a quantidade de casas decimais que poderão ser informadas pelo usuário nesse campo.
|
| Valor sugerido | Texto e Numérico | Texto que aparecerá como sugestão dentro do campo antes do usuário preencher algum valor. Pode ser usado para auxiliar o usuário exibindo o formato esperado do campo, ex: um de telefone pode ter um valor sugerido de (99) 9 9999-9999. |
| Valor inicial selecionado | Seleção e Multi-Seleção | Permite definir qual opção (ou quais opções) que virá selecionada por padrão para os filtros com tipo Seleção ou Multi-Seleção. Antes de poder escolher, é necessário cadastrar as opções. |
06. TABELAS UTILIZADAS
- HZE - Monitor
- HZF - Monitor x Propriedade
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas