Histórico da Página
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 ExclusivosA 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 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.
...
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çãoVisualizaçã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ócioNegó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. |
| Aviso |
|---|
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. |
05. TELA DE INCLUSÃO E ALTERAÇÃO DE FILTROS
...
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 |
| Informações |
|---|
Disponível para todos os tipos de filtro. |
...
| 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