CONTEÚDO
- Visão Geral
- Exemplo de utilização
- Tela de listagem
- Outras Ações / Ações relacionadas
- Principais Campos e Parâmetros
- Outras Ações / Ações relacionadas
- Tela de inclusão/edição
- Outras Ações / Ações relacionadas
- Principais Campos e Parâmetros
- Tela de inclusão e alteração de filtros
- Configurações avançadas
- Tabelas utilizadas
01. VISÃO GERAL
A funcionalidade de Monitores Exclusivos oferece a capacidade de criar e gerenciar monitores personalizados, que podem ser incorporados às visualizações dos usuários no painel de Gestão à Vista. 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.
Atenção!
Os monitores exclusivos estão disponíveis a partir dos patches 12.1.2311.2, 12.1.2307.8 e 12.1.2301.16.
02. EXEMPLO DE UTILIZAÇÃO
Imagine que você tenha uma tabela específica em seu ambiente, contendo dados essenciais que são extraídos diariamente no formato de relatório. Com a funcionalidade de Monitores Exclusivos , é possível criar uma representação visual em formato de gráfico, permitindo o acompanhamento em tempo real da situação com base nesses dados.
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. |
| Editar | Abre a tela de edição, posicionada no monitor selecionado. |
| Excluir | Apaga o monitor 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. |
| Agrupador | Tag que indica à qual agrupamento o monitor pertence. |
| Tipo | Tags que exibem os tipos suportados pelo monitor, podendo ser Texto ou Gráfico. |
| API negócio | Caminho relativo da API responsável por gerar os dados do monitor. |
| Objetivo | Texto que descreve os objetivos e características do monitor. |
04. TELA DE INCLUSÃO/EDIÇÃO
Esta tela permite incluir ou alterar um monitor já existente, assim como adicionar filtros aos monitores.
Outras Ações / Ações relacionadas
| Campo | Descrição |
|---|---|
| Cancelar | Interrompe o processo de inclusão ou edição de um monitor e volta para a listagem. |
| Salvar | Confirma a inclusão ou alteração do monitor, persistindo os dados no banco. |
| Gerar exemplo | Cria um esboço de API de negócio, contendo os métodos necessários conforme parametrização do monitor que está sendo editado. Exemplo, se for selecionado o tipo Gráfico como opção de visualização, a API será gerada já implementando o método pi-get-monitor-data-chart. Os filtros existentes para o monitor são considerados, e a API resultante já conta com variáveis preparadas para receber os valores informados pelo usuário para cada filtro. Importante Funcionalidade existente apenas para o produto Datasul, a partir dos patches 12.1.2407.8, 12.1.2403.14 e 12.1.2411.2. Esse botão só ficará disponível no modo de edição. |
| Validar | Executa testes sobre a API informada no campo API de Negócio para verificar se ela possui os métodos necessários para o correto funcionamento do monitor. Importante Funcionalidade existente apenas para o produto Datasul. Esse botão só ficará disponível no modo de edição. |
| Filtros | Abre a interface para cadastrar os filtros do monitor. |
Principais Campos e Parâmetros
| Campo | Descrição |
|---|---|
| Código | Campo interno que determina o código do monitor, que o diferenciará dos demais. Precisa ser único. |
| Rascunho? | Se assinalado, o monitor não irá aparecer para os demais usuários no painel do Gestão à Vista. Somente o usuário que cadastrou o monitor terá acesso à ele. Essa opção é útil para evitar que um monitor que ainda está sendo desenvolvido ou testado seja utilizado indevidamente. |
| Título | Título padrão do monitor. |
| Agrupador | Indica à qual agrupamento o monitor 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. |
| Opções de visualização | Determina quais modos de apresentação de dados o monitor 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, gauge, linhas e rosca. |
| API de negócio | Caminho relativo da API responsável por gerar os dados do monitor. Essa API precisará ser desenvolvida pelo usuário seguindo a documentação técnica. |
05. TELA DE INCLUSÃO E ALTERAÇÃO DE FILTROS
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 no método de query 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 ou Lookup (Zoom de pesquisa). |
| 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. |
| Filtro Opcional? | Determina se o usuário poderá ou não deixar esse filtro em branco quando estiver parametrizando o monitor. |
Opções de seleção | Disponível para filtros do tipo 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: Campo de seleção de Prioridade, onde as opções são:
Se o usuário selecionar a opção Alta, será enviado no campo correspondente o valor 3. |
Tabela principal | Disponível para filtros do tipo Zoom (pesquisa). Define qual a tabela será utilizada para a busca dos dados que aparecerão no zoom. |
Chave primária | Disponível para filtros do tipo Zoom (pesquisa). Campo que será utilizado como chave única dos registros da tabela selecionada como principal para o zoom. Algumas considerações:
|
Campo de descrição | Disponível para filtros do tipo Zoom (pesquisa). Campo que será utilizado como descrição dos registros da consulta. Ele será exibido em uma coluna chamada Descrição na tela de zoom, e também ao lado do código no campo do filtro. |
Informamos a tabela item, com o campo it-codigo como chave primária e desc-item como descrição:
Resultado no painel do Gestão à Vista:
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.
Estilos CSS/HTML
Disponível para todos os tipos de filtro.
Permite estilizar o campo de filtro utilizando propriedades nativas do HTML e CSS. Exemplo: Alterar a cor da borda ou do fundo do componente. Deve-se informar no formato chave : valor, por exemplo: Se quiser que o fundo do componente fique na cor vermelha, informar background-color no campo de Propriedade, red no campo de valor e clicar em adicionar.
Classes CSS/PO-UI
Disponível para todos os tipos de filtro.
Permite estilizar o campo de filtro utilizando classes nativas do PO-UI e CSS. 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. Exemplo: po-sm-12 po-md-6 po-lg-3 po-pt-2
Ajuda do campo
Disponível para todos os tipos de filtro.
Texto que aparecerá abaixo do campo do filtro. Serve para auxiliar o usuário a compreender melhor o objetivo daquele filtro ou como preenche-lo corretamente.
Ícone
Disponível para filtros do tipo Texto e Numérico.
Permite selecionar o ícone que será exibido no canto esquerdo do campo.
Tamanho máximo (caracteres)
Disponível para filtros do tipo Texto.
Delimita o número máximo de caracteres que poderá ser informado pelo usuário nesse campo. Exemplo: Filtro de estabelecimento, que no sistema comporta apenas 5 casas.
Casas de milhar
Disponível para filtros do tipo Numérico.
Delimita a quantidade de casas de milhar 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.
Casas decimais
Disponível para filtros do tipo Numérico.
Delimita a quantidade de casas decimais que poderão ser informadas pelo usuário nesse campo. Observações:
- O valor máximo permitido é 15;
- A soma total das casas de milhar com as casas decimais limita-se à 16;
Valor sugerido
Disponível para filtros do tipo Numérico e Texto.
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
Disponível para filtros do tipo Seleção.
Permite definir qual a opção que virá selecionada por padrão para os filtros com tipo Seleção. Antes de poder escolher, é necessário cadastrar as opções.
Colunas exibidas
Disponível para filtros do tipo Zoom (pesquisa).
Determina quais colunas serão mostradas na tela de zoom. É possível escolher quantos campos da tabela forem necessários. As colunas de Código e Descrição são obrigatórias, e serão incluídas automaticamente caso forem apagadas.
Utilizando o exemplo anterior da tabela item, podemos incluir algumas colunas adicionais:
Seleção múltipla?
Disponível para filtros do tipo Zoom (pesquisa).
Define se o usuário poderá selecionar mais de um resultado no programa de pesquisa.
05. TABELAS UTILIZADAS
Monitor, monitor-propriedade,
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas