Pular para o conteúdo principal

Gerenciar Parâmetros

O Gerenciar Parâmetros é uma funcionalidade que permite criar e configurar parâmetros dinâmicos para seus painéis, tornando-os mais flexíveis e interativos.

parametros

O que são Parâmetros?​

Os parâmetros são valores configuráveis que podem ser alterados pelo usuário para filtrar, personalizar ou controlar o comportamento do painel sem precisar modificar sua estrutura básica.

Principais Benefícios​

  • Flexibilidade: Permite personalização sem alterar a estrutura do painel
  • Interatividade: Usuários podem ajustar visualizações em tempo real
  • Reutilização: Um painel pode servir múltiplos contextos através de parâmetros
  • Eficiência: Reduz a necessidade de criar múltiplos painéis similares

Como Criar um Parâmetro​

01. Clique no botão Criar Parâmetros na barra de ferramentas superior. Você será direcionado para a tela de configuração de parâmetros:

parametro

Tipos de Parâmetros Disponíveis​

parametro

Parâmetro Fixo​

Características:

  • Valores que não mudam durante o uso do painel
  • Definidos uma única vez na configuração
  • Não aparecem como controles visuais para o usuário

Ideais para:

  • Configurações do sistema
  • Constantes matemáticas
  • Dados de referência
  • Informações da empresa

Exemplos:

  • Nome da empresa: "Minha Empresa Ltda"
  • Taxa fixa: "0.15"
  • Versão do sistema: "2.1.0"
  • Moeda padrão: "BRL"

Parâmetro Dinâmico​

Características:

  • Valores que o usuário pode alterar durante o uso
  • Aparecem como controles interativos no painel
  • Atualizam a visualização em tempo real

Ideais para:

  • Filtros de data e período
  • Seleção de regiões ou filiais
  • Status de processos
  • Categorias de produtos

Exemplos:

  • Filtro de período: Seletor de mês/ano
  • Região: Lista suspensa com opções
  • Status: Botões de múltipla escolha
  • Valor mínimo: Campo numérico

Configurando um Parâmetro​

parametro

Informações Básicas​

1

Nome (Key): é o identificador único do parâmetro no sistema. Funciona como uma chave que será usada internamente para referenciar este parâmetro em regras, fórmulas e integrações.

2

Valor: é o conteúdo atual do parâmetro - aquilo que será efetivamente usado nos processamentos. Para parâmetros fixos, é um valor constante definido uma única vez. Para parâmetros dinâmicos, é o valor inicial que pode ser alterado pelo usuário durante o uso do painel.

3

Tipo: define a natureza do parâmetro e como ele se comportará no sistema. Fixo para valores que não mudam durante o uso (configurações, constantes). Dinâmico para valores que o usuário pode alterar através de controles interativos no painel.

4

Ações: processos automatizados que podem usar os valores dos parâmetros para executar operações específicas.

5

Adicionar Parâmetro: Adiciona mais parâmetros conforme as configurações que o usuário queira.

6

Preview JSON: mostra uma visualização técnica de como os parâmetros criados estão estruturados internamente no sistema.

Configurações para Parâmetros Dinâmicos​

Controle Visual:

  • Define como o usuário vai interagir com o parâmetro
  • Opções: campo de texto, lista suspensa, seletor de data, etc.

Opções:

  • Para parâmetros de lista, defina todas as opções disponíveis
  • Formato: valor|texto_exibido
  • Exemplo: SP|São Paulo, RJ|Rio de Janeiro, MG|Minas Gerais

Valor Padrão:

  • Valor inicial quando o painel carrega
  • Importante para garantir uma visualização inicial coerente

Validação:

  • Defina regras de validação quando necessário
  • Exemplos: valores mínimos/máximos, formatos obrigatórios

Parâmetro Especial: Competência​

O sistema possui um parâmetro automático de competência que oferece funcionalidades avançadas:

Características Especiais​

Criação Automática:

  • Sistema cria automaticamente um seletor de mês/ano
  • Interface otimizada para navegação temporal
  • Valores pré-formatados para facilitar uso

Integração Avançada:

  • Integra automaticamente com filtros de data do painel
  • Permite navegação temporal dos dados
  • Sincroniza entre painéis relacionados

Funcionalidades:

  • Seleção rápida de mês/ano
  • Navegação com botões anterior/próximo
  • Formatação automática de datas
  • Validação de períodos

Como os Parâmetros Funcionam no Painel​

Interface do Usuário​

Visualização:

  • Parâmetros dinâmicos aparecem como controles visuais no topo do painel
  • Interface organizada e intuitiva
  • Agrupamento lógico de parâmetros relacionados

Interação:

  • Usuários podem alterar valores em tempo real
  • Mudanças afetam imediatamente a visualização dos dados
  • Feedback visual durante atualizações

Persistência:

  • Sistema lembra última configuração do usuário
  • Valores mantidos entre sessões
  • Sincronização entre abas do navegador

Integração com Regras​

Utilização em Automação:

  • Parâmetros podem ser utilizados em regras de automação
  • Permitem execução de ações contextuais baseadas nos valores selecionados
  • Habilitam botões de ação que usam os parâmetros como entrada

Condições Dinâmicas:

  • Regras podem reagir a mudanças de parâmetros
  • Validações baseadas em combinações de valores
  • Execução condicional de processos

Exemplos Práticos​

Painel de Vendas​

Configuração:

Parâmetro: competencia
Tipo: Competência (automático)
Título: "Período de Análise"

Parâmetro: regiao
Tipo: Dinâmico
Título: "Região"
Opções: "norte|Norte, sul|Sul, sudeste|Sudeste, nordeste|Nordeste"
Valor Padrão: "sudeste"

Parâmetro: vendedor
Tipo: Dinâmico  
Título: "Vendedor"
Controle: Campo de texto com autocomplete

Funcionamento:

  • Usuário seleciona mês/ano na competência
  • Escolhe região na lista suspensa
  • Digite nome do vendedor (com sugestões)