Cruzando Fontes e Relacionamentos
Esta é a etapa em que o dashboard deixa de ser apenas um leitor de uma tabela isolada e passa a funcionar como uma ferramenta de análise integrada. Em vez de olhar somente para abastecimentos, somente para veículos ou somente para motoristas, você passa a combinar assuntos diferentes em um mesmo contexto de decisão.
1. União x Cruzamento
O sistema trabalha com dois modos principais de combinação de fontes.
União (Empilhar)
Use União (Empilhar) quando as fontes representam o mesmo tipo de linha e podem ser colocadas uma embaixo da outra.
Exemplo: abastecimentos de janeiro + abastecimentos de fevereiro.
Objetivo: formar uma base maior e contínua.
2. Quando o cruzamento faz sentido
O cruzamento costuma ser útil em cenários como estes:
- descobrir o modelo e a categoria do veículo em cada abastecimento
- relacionar notas de manutenção com dados cadastrais do veículo
- unir uma tabela operacional com uma tabela de responsáveis, centros de custo ou filiais
- consolidar uma análise em que o gestor precisa enxergar custos e contexto no mesmo gráfico
3. Como configurar
Selecione as fontes
Na seção Fontes de Dados, marque pelo menos duas fontes que contenham dados reais.
Mude o modo
Na seção Cruzamento (Join/Merge), altere o campo Modo para “Cruzamento (Merge)”.
Adicione um relacionamento
Clique em “+ Adicionar relacionamento”.
Dê um nome claro
No campo “Nome da entidade gerada”, use um nome que explique o resultado. Exemplos:
abastecimentos_com_veiculosmanutencoes_com_fornecedorescustos_operacionais_consolidados
Escolha as entidades
Defina Entidade A e Entidade B.
Mapeie as chaves
Adicione pelo menos um par de campos equivalentes, como:
placacomplacaid_veiculocomid_veiculocodigo_filialcomcodigo_filial
Defina a entidade final do painel
Ao fim da seção, escolha a Entidade final do painel. Esse passo diz aos widgets qual resultado deve ser usado como base principal.

4. Saúde dos relacionamentos
O dashboard possui um bloco chamado “Saúde dos relacionamentos”. Ele resume a qualidade da configuração criada.
Status prontos
Significa que o relacionamento possui chaves configuradas e gerou linhas aproveitáveis.
Status inválidos
Em geral significa que faltou pelo menos um mapeamento ou que a configuração não produz resultado válido.
Status circulares
Indica tentativa de formar um ciclo entre entidades, algo que torna a leitura confusa e pode inviabilizar o resultado final.
Regra prática: se você não conseguir explicar em uma frase simples “como a tabela A encontra a tabela B”, ainda não é o momento de configurar o merge.
5. Casos reais de uso
Abastecimento + Veículo
Cenário: a diretoria quer saber qual modelo de veículo consome mais combustível.
Fonte A: abastecimentos.
Fonte B: cadastro de veículos.
Chave: placa.
Resultado: o gráfico pode agrupar por modelo e somar valor abastecido.
6. Erros mais comuns
- cruzar tabelas sem uma chave confiável
- usar campos parecidos no nome, mas com significados diferentes
- relacionar uma tabela vazia com outra tabela populada
- esquecer de escolher a Entidade final do painel
- usar merge quando o problema era apenas empilhar períodos semelhantes
7. Como validar que funcionou
Depois de concluir o relacionamento:
- clique em um widget
- abra a lateral direita
- confira a lista de campos disponíveis
Se o cruzamento deu certo, a lista de campos do widget passará a exibir atributos vindos de mais de uma fonte. Em cenários com múltiplas fontes, alguns campos podem aparecer com prefixos do tipo “dataset :: campo”, justamente para evitar ambiguidades.
O próximo passo natural é enriquecer ainda mais essa base com processamento vertical e campos calculados.