Como usar o Construtor de Relatórios v2 — guia básico

Quando usar

• Você quer criar relatórios customizados na versão v2 do Construtor (com pivot, joins, PoP)
• Você precisa de filtros avançados (entre consultas, múltiplas condições)
• Você quer usar IA para gerar consultas e visualizações

Pré-requisitos

• Estar logado como supervisor, CX Engineer ou administrador

Sobre este artigo

Bem-vindo à FAQ do Novo Construtor de Relatórios (v2). Este guia cobre desde a seleção de campos e criação de filtros até recursos avançados como tabelas dinâmicas (pivot), joins entre tabelas, análises período a período (PoP) e controles dinâmicos.

Primeiros passos

Seleção de campos

O que são dimensões e medidas?

• Dimensões — agrupamentos da consulta (data, classe, tipo, etc.)

• Medidas — agregações sobre essas dimensões (soma, contagem, média, etc.)

Exemplo: para consultar o total de tickets por dia, selecione uma dimensão de data e uma medida de contagem de tickets.

Como pesquisar campos mais facilmente

Use a caixa de busca acima do seletor de campos. Por padrão, busca em campos e tabelas. Você pode refinar com:

• Em uso — apenas campos selecionados ou filtrados na consulta atual

• Tipo de campo — booleano, número, etc.

• Tópico — limita aos campos de tópicos selecionados

• Rótulo — filtra por presença ou ausência

• Descrições — filtra por presença ou ausência

Operadores avançados de busca

Ações avançadas em um campo

Ao passar o mouse e clicar nos três pontos (ou clicar com o botão direito), você acessa:

• Pivotamento

• Agregações

• Filtros

• Definição de chave primária

• Ocultação do campo

• Criação de duração (para timestamps)

Filtros

Cada dimensão pode ser usada como filtro. Diferentes opções aparecem para datas, números e textos.

Múltiplos valores

Separe os valores por vírgula: [pão, queijo]. Se o valor contiver vírgula, escape com \: São Paulo\, SP.

Filtros de data

Você pode usar:

• Datas absolutas — 2022, 2023-01-01, 2021-Q4

• Datas relativas — após 7 dias completos atrás, 1 ano atrás

• Intervalos flexíveis — formato [início][duração]

Exemplos

# Primeiros 10 dias de 2023
[2023-01-01][10 days]

# 100 dias atrás por 10 dias
[100 complete days ago][10 days]

# 1 hora atrás por 2000 milissegundos
[1 hour ago][2000 milliseconds]

Unidades de tempo aceitas

Filtrar uma aba pelos resultados de outra

Com duas ou mais abas abertas, você pode usar resultados de uma como filtro dinâmico em outra.

1. Crie uma aba com a definição do subconjunto que servirá de filtro

2. Em outra aba, localize a dimensão correspondente

3. Clique nos três pontos da dimensão e selecione Filtrar → É de outra consulta

4. Escolha a aba e a dimensão de referência

Múltiplas condições no mesmo campo

Filtre por múltiplas condições (ex: data nos últimos 30 dias OU nula) clicando em Adicionar condição no modal de filtro. Em seguida, escolha se todas ou qualquer uma das condições devem ser aplicadas.

Pivot (tabela dinâmica)

Como criar

Clique com o botão direito em qualquer campo no seletor e escolha Pivot.

Achatar pivot (Flatten pivot)

Transforma colunas do pivot em medidas filtradas individuais. Você pode criar um agrupamento "Outros" durante o processo. Após achatar, as novas medidas aparecem sob os campos da consulta e o campo pivotado deixa de estar ativo.

Limites do pivot

Totais por linha

Em Opções, ative Totais de Linha. Adiciona uma coluna de total à direita. Disponível apenas em consultas com pelo menos um pivot.

Agrupar medidas

Em Opções, ative Agrupar Medidas no Pivot. Organiza as medidas juntas dentro de cada grupo.

Preencher células nulas

Clique com o botão direito na tabela e selecione Preencher Células Ausentes na Grade para substituir nulos por zero. Útil ao usar SUMIFS sobre tabelas pivotadas.

Campos personalizados e agregações

Como criar

Use o botão + no seletor de campos ou o menu de clique direito sobre um campo.

Agregações rápidas

Clique com o botão direito em um campo e selecione Agregações.

Recurso de Duração

Disponível em campos de timestamp — cria um campo que calcula a diferença de tempo entre dois timestamps em intervalos configuráveis.

Tabela de resultados

Limite de linhas

Por padrão, 1.000 linhas. Pode ser ajustado dinamicamente até 50.000 linhas com paginação. Afeta apenas a exibição — não as linhas processadas no banco.

Selecionar células

• Clique em uma célula para selecioná-la

• Clique e arraste para selecionar uma região

• Shift + clique para selecionar um intervalo

• Cmd/Ctrl + clique para adicionar/remover

• Clique no número da linha → seleciona a linha inteira

• Clique no cabeçalho da coluna → seleciona a coluna inteira

• Cmd/Ctrl + A → seleciona tudo

• Escape ou clique fora → limpa a seleção

Copiar dados

Selecione e pressione Ctrl+C (Windows) ou Cmd+C (Mac). Os dados vêm em formato separado por tabulação (compatível com Excel e Google Sheets). Com Cmd/Ctrl+A, os cabeçalhos das colunas são incluídos.

Editar células de cálculo

Pressione Enter ou dê duplo clique na célula. Para salvar: Enter. Para cancelar: Escape. Shift + clique insere uma referência de intervalo na fórmula.

Reordenar colunas

Arraste o cabeçalho para a posição desejada.

Opções de exibição

Em Opções:

• Largura das colunas (auto ou manual)

• Texto do cabeçalho (recortado ou com quebra de linha)

• Exibir nome da visão acima do cabeçalho

• Ativar totais de coluna

• Ativar totais de linha (apenas pivots)

• Transpor linhas e colunas

• Agrupar medidas em pivots

Totais de coluna

Ao ativar Totais de Coluna, uma linha de total aparece no rodapé. Clique com o botão direito no total para personalizar (trocar de soma para média, por exemplo).

Download dos resultados

Clique em Aba → Download ou no ícone de download.

• Formato: CSV, XLSX ou JSON

• Aplicar formatação de dados — preserva formatação de números e datas

• Limite de linhas — limite atual, todos os possíveis, ou um valor personalizado

Ordenação por múltiplos campos

Ordene o primeiro campo normalmente. Depois, segure Shift ao clicar nos campos seguintes para adicionar ordenações secundárias.

Análise Período a Período (PoP)

O que é

Técnica de business intelligence que compara métricas de um período recente com o mesmo período no passado (este mês vs. mês anterior).

Como ativar

No seletor de campos, clique nos três pontos de uma dimensão de data e selecione Período a Período. Dois seletores aparecem acima da tabela: um para o período atual e outro para o de comparação.

Acima do painel de resultados, dois menus suspensos: selecione o período atual no primeiro e o de comparação no segundo. Por padrão, opções de comparação são baseadas em intervalos relevantes — você pode personalizar.

Personalizar períodos de comparação

Os períodos têm opções padrão, mas você pode personalizar livremente. Os parâmetros exatos ficam visíveis no ícone de informações na tabela.

Preenchimento de dados ausentes

Como preencher linhas ausentes

Clique com o botão direito na dimensão e selecione Preencher Linhas Ausentes.

Tipos de campos suportados

• Datas com intervalo definido

• Campos de enumeração (bins e grupos definidos no modelo de dados)

Observações

• Para a versão clássica do construtor: Como usar o Construtor de Relatórios (Report Builder)

• Para conhecer as tabelas e colunas disponíveis: Explicação das colunas do Report Builder

• Para usar relatórios padrões em vez de customizar: Visão geral dos relatórios padrões do Cloud Chat

• Para extrair dados via API: Como extrair dados em lote via API (Data Extract API)