Leia as perguntas frequentes
Novo
Suporte do Bitrix24
Inscrição e autorização
Como Começar?
Feed
Messenger
Página inicial: Vibe
Calendário
Bitrix24 Drive
E-mail
Grupos de trabalho
Tarefas e Projetos
CRM
CoPilot - IA no Bitrix24
Contact Center
Telefonia
CRM + Loja On-line
Sales Center (beta)
Análise CRM (beta)
Sales Intelligence (beta)
Criador de BI
Automação
Marketing
Bitrix24.Sites
Loja On-line (beta)
Gerenciamento do inventário
Empresa
Assinatura eletrônica para RH
Assinatura eletrônica
Base de conhecimento
Videoconferências em HD
Processos de negócio
Market (Aplicativos)
Assinatura
Enterprise
Configurações
Meu perfil
Aplicativo desktop
Bitrix24 On-premise
Questões Gerais
Novidades do Helpdesk (arquivo)

Suporte Bitrix24

Usar modelos Jinja Templates no Criador de BI

Jinja Templates é uma linguagem especial para criação de templates. Ela permite escrever consultas SQL dinâmicas que mudam dependendo das condições especificadas. Use modelos em conjuntos de dados virtuais do Criador de BI. Por exemplo, adicione um intervalo de datas dinâmico que solicitará dados apenas para um período selecionado.

Neste artigo, mostraremos como adicionar um modelo Jinja a um conjunto de dados virtual e consideraremos as principais variáveis para modelos.


Criar um conjunto de dados virtual

Abra o Criador de BI e vá para SQL > SQL Lab. Escreva uma consulta SQL à direita e salve-a como um novo conjunto de dados.
Criar um gráfico baseado em um conjunto de dados virtual

1 Usamos uma consulta SQL para obter dados sobre negócios e gerentes de 2023

Editar um conjunto de dados virtual

Para adicionar um modelo, abra a guia Datasets (Conjuntos de dados), selecione um conjunto de dados virtual e clique em Edit.

Edite sua consulta SQL e adicione o modelo Jinja:

 WHERE {% if from_dttm is not none %} date_create >= from_iso8601_timestamp('{{ from_dttm }}') AND {% endif %} {% if to_dttm is not none %} date_create < from_iso8601_timestamp('{{ to_dttm }}') AND {% endif %} true; 
  • {%if from_dttm is not none %} - verifica se há uma data de início para filtragem.
  • date_create >= from_iso8601_timestamp('{{ from_dttm }}') AND - filtra os dados para incluir registros com a data de criação a partir da data de início especificada.
  • {%endif %} - conclui a verificação da data de início.
  • {%if to_dttm is not none %} - verifica se há uma data de término para filtragem.
  • date_create < from_iso860i_timestamp('{{ to_dttm }}') AND - filtra os dados para incluir registros com a data de criação anterior à data de término especificada.
  • {%endif %} - conclui a verificação da data de término.
  • true - suporta a operação da consulta se nenhuma data for especificada.

As variáveis de modelo tornam a consulta mais dinâmica. Você pode alterar o intervalo de tempo do conjunto de dados usando um filtro. Basta colocar valores diferentes em from_dttm e to_dttm sem editar o resto da consulta.

Lista de variáveis ​​para modelos Jinja

Variável Descrição
portal_url Mostra o endereço da conta na qual o Criador de BI foi aberto. Por exemplo, você pode adicionar a linha SELECT '{{portal_url()}}' as string à consulta para ver no relatório de qual conta o Criador de BI é aberto.
columns Define as colunas para agrupar os dados em uma consulta
filter Especifica os filtros aplicados aos dados
from_dttm e to_dttm Define o intervalo de tempo da amostragem de dados
groupby Repete a função columns, agrupando dados por colunas especificadas
metrics Inclui funções agregadas, como soma ou média
row_limit e row_offset Limita o número de linhas no resultado de uma consulta e o deslocamento do início da seleção
table_columns Lista as colunas disponíveis no conjunto de dados
time_column e time_grain Define a coluna de tempo e o intervalo de agregação de dados

Verificar como o modelo funciona

Clique no conjunto de dados e crie um gráfico para testar sua consulta. Selecione o modo de consulta Raw Records, mova as métricas para o bloco Columns, defina o filtro e clique em Create chart (Criar gráfico).

Para ver como o modelo funciona na sua consulta, clique no botão de três pontos (...) > View query (Ver consulta).

5 Um período dinâmico é aplicado ao gráfico, solicitando dados apenas para um período selecionado

Destaques

  • Jinja Templates é uma linguagem especial para criação de templates. Você pode usá-la para escrever consultas SQL dinâmicas que mudam dependendo das condições especificadas.
  • Para adicionar um modelo Jinja, edite a consulta SQL em um conjunto de dados novo ou existente.
Essa informação foi útil?
Assistência de Especialistas em Integração
Não é o que estou procurando
Texto complexo e incompreensível
Informações estão desatualizadas
Explicação muito breve, preciso de mais informações
Não gosto de como esta ferramenta funciona
Ir ao Bitrix24
Não tem uma conta? Crie grátis