Ir para o conteúdo principal

15.0 Cadastrando e visualizando



1. Quando usar

  • Criar quadros personalizados com base em dados do banco (consultas SQL).

  • Controlar visualmente indicadores como totais, progresso, prioridades e cores.

  • Acompanhar documentos (cotações, pedidos, notas, etc.) de forma ágil.

  • Usar filtros dinâmicos que tornam a consulta mais flexível.

2. Como acessar

  1. No CRM One, abra o menu Ferramentas.
  2. Clique em Configuração de Kanban.
Menu Ferramentas → Configuração de Kanban
Menu: Ferramentas → Configuração de Kanban.

image.png
Menu: Configuração de Kanban -> Adicionar Novo

3. Configurando o Kanban

image.png

  • Nome do Menu: Defina o nome que aparecerá no menu do CRM One para acessar esse Kanban.

  • Local Consulta: Escolha em qual módulo/menu dentro do CRM One o Kanban será exibido.

  • Consulta Ativa: Indica se a consulta do Kanban está habilitada. Apenas consultas ativas aparecem no sistema.

  • Autorização de Usuários: Permite restringir quais usuários terão acesso a esse Kanban.

  • Contagem de Cards: Define se será exibida a contagem no topo da coluna do Kanban:
  • Soma do Valor 1: Soma dos valores atribuídos à coluna Valor1 (ex.: total das cotações).

    image.png


  • Soma do Valor 2: Soma dos valores atribuídos à coluna Valor2 (ex.: total de pedidos gerados).

    image.png


  • Diferença entre valor 1 e valor 2: Calcula a diferença entre os dois indicadores.

    image.png


  • Testar Consulta: Executa a query configurada e mostra se há falhas de sintaxe.

Dica: use Valor1 e Valor2 para números relevantes como totais financeirosquantidades ou metas. Assim, os usuários já enxergam indicadores sem precisar abrir cada card.



3.1 Aliases úteis (mapeamento esperado)

  • Agrupador / CorAgrupador → nome e cor do agrupamento/coluna.
  • TituloObservacaoResponsavelPrioridadeCorPrioridadeClassificacaoCorClassificacao.
  • Data1Data2Data3 → datas de referência do card.
  • Valor1Valor2Valor3 → usados nos indicadores e/ou no card (na opção B, Valor3 pode ser negativo).
  • Progresso → percentual (0–100) para barra de progresso do card.
  • CampoUsuario1CampoUsuario2 → informações adicionais livres.
  • CorDoCard → cor do card (ex.: por progresso).
  • IdDocTipoObjeto → vínculo com o documento/objeto do CRM (para navegação).

4. Filtros disponíveis no Kanban

Os filtros podem ser adicionados direto na query SQL usando a sintaxe especial do CRM One. Eles permitem que o usuário selecione datas, textos ou opções antes de carregar o Kanban.


Filtros de Data

Formato:

'{[Data1CRMOne][Descrição do filtro]}'
  • O sistema substitui pelo valor escolhido pelo usuário.

  • Podem ser usados em intervalos (ex.: Data Inicial e Data Final).

👉 Exemplo:


WHERE OQ."DocDate" BETWEEN '{[Data1CRMOne][Data Inicial]}' AND '{[Data2CRMOne][Data Final]}'

Filtros de Texto Livre

Formato:

'{[TextoLivre1CRMOne][Descrição do filtro]}'
  • Usuário digita livremente.

  • Pode ser usado para busca por nome, código ou qualquer string.

👉 Exemplo:


WHERE OCRD."CardName" = '{[TextoLivre1CRMOne][Digite o nome do cliente]}'

Filtros de Seleção (Checkbox ou Combobox)

Formato:

'{[Texto1CRMOne][Descrição do filtro][Query de opções][Tipo de filtro]}'
  • A query precisa retornar duas colunas:

    1. Valor usado no SQL.

    2. Texto exibido ao usuário.

  • Tipo: Combobox (escolha única) ou Checkbox (múltiplas escolhas).

👉 Exemplo:


WHERE T1."Usage" IN ('{[Texto1CRMOne][Selecione as utilizações][SELECT ID, Usage FROM OUSG][Checkbox]}'

Com esses filtros, o mesmo Kanban pode servir para múltiplos cenários, sem precisar criar várias consultas diferentes.

Interatividade com os Cards

Cada card gerado pelo Kanban não é apenas um resumo visual, ele também é interativo:

  • Seta para a direita (→)
    Ao clicar, o sistema abre diretamente o documento relacionado ao card (exemplo: Cotação, Pedido de Venda, Nota Fiscal etc.), com base no IdDoc e no TipoObjeto definidos na query.

    image.png

  • Setas para esquerda e direita (↔ flip)
    Ao clicar nas setas de flip, o card vira, exibindo informações complementares que não aparecem na frente.

    • Isso é útil para mostrar detalhes adicionais como observações, campos de usuário, status internos, entre outros.


    image.png

    image.png



Depois de entendermos como funcionam os campos e a lógica da criação do kanban, agora, basta acessar o caminho ao qual você definiu na criação e visualiza-lo:

image.png