snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 3s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -0,0 +1,275 @@
---
title: Configurações do Gráfico
description: Configure seus gráficos para exibir os dados exatamente como você precisa.
---
import { ChartIcon } from '/snippets/chart-icon.mdx';
## Acessando as configurações do gráfico
1. Clique no botão **Editar** no canto superior direito do seu painel
<img src="/images/user-guide/dashboard/dashboard-edit.png" alt="Modo de edição" />
2. O painel entra no modo de edição
3. Clique em qualquer widget para selecioná-lo
4. O painel de configurações é aberto à direita
As configurações são organizadas em seções:
* **Dados**: Quais dados obter e como filtrá-los
* **Eixo X**: Como agrupar e ordenar categorias (gráficos de barras/linhas)
* **Eixo Y**: O que medir e como exibir (gráficos de barras/linhas)
* **Estilo**: Cores, rótulos e opções visuais
<Note>
Algumas configurações só aparecem quando outras estão configuradas. Por exemplo, **Granularidade de data** só aparece quando você seleciona um campo de data.
</Note>
---
## Configurações de Dados
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="database" />Fonte </span>
Escolha de qual objeto extrair os dados.
1. Clique em **Fonte**
2. Selecione um objeto (Oportunidades, Pessoas, Empresas, etc.)
Todos os seus objetos padrão e personalizados estão disponíveis. Alterar a fonte redefine outras configurações, pois as opções de campo dependem do objeto selecionado.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-source.png" alt="Fonte" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filter" />Filtro </span>
Limite quais registros são incluídos no gráfico.
1. Clique em **Filtrar**
2. O construtor de filtros é aberto
3. Clique em **+ Adicionar filtro**
4. Selecione um campo, condição e valor
5. Adicione mais filtros conforme necessário
Os filtros funcionam da mesma forma que nas visualizações de tabela. Use-os para focar em segmentos específicos dos seus dados.
**Exemplo**: Filtre oportunidades em que a Etapa seja igual a "Ganha" para mostrar apenas negócios fechados.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-filters.png" alt="Filtro" />
<Tip>
Para campos de data, experimente **É relativo** para criar filtros dinâmicos como "Últimos 7 dias" ou "Este mês" que são atualizados automaticamente.
</Tip>
<Tip>
Filtros avançados são suportados—adicione várias regras de filtro e combine-as com a lógica **E** ou **Ou**.
</Tip>
---
## Configurações do Eixo X
Essas configurações controlam o eixo horizontal dos gráficos de barras e de linhas—geralmente como seus dados são agrupados em categorias.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-x" />Dados em exibição </span>
Selecione o campo pelo qual agrupar seus dados. Isso determina as categorias exibidas no eixo X.
**Exemplo**: Selecione "Etapa" para ver os dados agrupados pela etapa do pipeline, ou "Data de criação" para ver os dados ao longo do tempo.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-data-on-display.png" alt="Dados em exibição" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />Granularidade de data </span>
Ao agrupar por um campo de data, escolha o período de tempo para o agrupamento.
| Opção | Agrupa dados por | Exemplo de saída |
| -------------------- | ------------------------ | ------------------------------------------------------------------ |
| **Dia** | Cada dia do calendário | 1º de jan., 2 de jan., 3 de jan.... |
| **Semana** | Semanas do calendário | Semana 1, Semana 2, Semana 3... |
| **Mês** | Meses do calendário | janeiro, fevereiro, março... |
| **Trimestre** | Trimestres fiscais | T1, T2, T3, T4 |
| **Ano** | Anos do calendário | 2023, 2024, 2025 |
| **Dia da semana** | Dia da semana (agregado) | segunda-feira, terça-feira... (todas as segundas-feiras agregadas) |
| **Mês do ano** | Mês (agregado) | janeiro, fevereiro... (todos os janeiros agregados) |
| **Trimestre do ano** | Trimestre (agregado) | T1, T2, T3, T4 (todos os T1 agregados) |
As opções "de semana/ano" agregam ao longo de todo o tempo. Use **Dia da semana** para ver qual dia da semana normalmente tem mais negócios. Use **Mês** para ver tendências mês a mês.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />Ordenar por </span>
Controle a ordem das categorias no eixo X.
* **Posição** – Usa a ordem definida nas configurações do seu campo Select
* **Alfabética** – De A a Z (ou cronológica para datas)
* **Por valor** – Ordenado pela métrica (do maior para o menor ou vice-versa)
* **Manual** – Arraste para definir sua própria ordem
<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-sort.png" alt="Ordenar por" />
**Dica**: Para etapas do pipeline, use **Posição** para mostrar as etapas na ordem do seu processo de vendas (Lead → Qualificado → Proposta → Ganha).
<Note>
As opções exibidas dependem do tipo do seu campo. Campos Select têm todas as opções; campos de data e de texto exibem menos.
</Note>
<Tip>
Com a ordenação **Manual**, arraste as categorias para criar uma ordem personalizada—perfeito para destacar segmentos específicos ou contar uma história com seus dados.
</Tip>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="eye-off" />Omitir valores zero </span>
Oculte categorias que têm zero ou nenhum dado.
* **Ativado**: Categorias sem registros são ocultadas
* **Desativado**: Todas as categorias são exibidas, mesmo que vazias
Use isso para limpar gráficos com dados esparsos.
---
## Configurações do Eixo Y
Essas configurações controlam o que você está medindo e como isso é exibido.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-y" />Dados em exibição </span>
Selecione o campo e a operação para calcular sua métrica.
* **Contagens** – Contar todos, Contar vazios, Contar não vazios, Contar valores únicos
* **Matemática** – Soma, Média, Mín., Máx. (campos numéricos)
* **Percentuais** – Percentual vazio, Percentual não vazio
Campos booleanos adicionam Contar verdadeiro/falso. Gráficos agregados com campos de data exibem Mais antigo/Mais recente.
**Exemplo**: Selecione "Valor" com Soma para ver o valor total de negócios por categoria, ou Contar todos para ver o número de negócios.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-data-on-display.png" alt="Dados em exibição" />
<Note>
As opções exibidas dependem do seu campo e do tipo de gráfico. Se você não vir uma operação esperada, verifique o tipo do seu campo.
</Note>
### Razão
Para campos Select, Multi-select ou Booleanos, você pode calcular o percentual de um valor específico.
1. Selecione um campo Select, Multi-select ou Booleano
2. Ativar **Proporção**
3. Escolha a opção a ser medida
**Exemplo**: Mostrar negócios "Ganho" como porcentagem de todas as oportunidades. Se você tiver 10 Ganhos de um total de 50, o gráfico mostrará 20%.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filters" />Agrupar por </span>
Adicione uma segunda dimensão para criar várias séries (múltiplas barras ou linhas).
1. Defina primeiro o campo do eixo X
2. Clique em **Agrupar por**
3. Selecione um segundo campo
**Exemplo**: Agrupe os negócios por Etapa (Eixo X) E por Responsável (Agrupar por) para ver, lado a lado, a distribuição do pipeline de cada pessoa.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-group-by.png" alt="Agrupar por" />
Quando Agrupar por estiver definido, você verá várias cores em seu gráfico e uma legenda aparecerá.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />Granularidade de data </span>
Quando Agrupar por for um campo de data, escolha o período de tempo (mesmas opções do eixo X).
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />Ordenar por </span>
Quando **Agrupar por** estiver definido, controle a ordem das séries agrupadas (por exemplo, qual barra do responsável aparece primeiro em cada categoria).
Mesmas opções da ordenação do eixo X—Posição, Alfabética e Manual—exceto que **a ordenação baseada em valor não está disponível** para o agrupamento secundário.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="chart-bar-popular" />Acumulado </span>
Mostre totais acumulados em vez de valores individuais.
* **Desativado**: Cada barra/ponto mostra seu próprio valor
* **Ativado**: Cada barra/ponto mostra a soma de todos os valores anteriores mais o seu próprio
**Exemplo**: janeiro = 10, fevereiro = 15
* Acumulado desativado: Mostra 10 e 15
* Acumulado ativado: Mostra 10 e 25 (10 + 15)
Use o acumulado para acompanhar o progresso em direção a uma meta ao longo do tempo.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-cumulative.png" alt="Acumulado" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="math-min" />Faixa mínima / <ChartIcon icon="math-max" />Faixa máxima </span>
Defina valores mínimos e máximos fixos para o eixo Y.
* Deixe em branco para dimensionamento automático
* Insira um número para fixar o limite
**Quando usar:**
* Defina Mín. como 0 para comparações visuais precisas
* Defina ambos para escalas consistentes em vários gráficos
* Foque em um intervalo de valores específico definindo ambos
---
## Configurações de Estilo
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="color-swatch" />Cores </span>
Defina o esquema de cores do seu gráfico. Escolha entre uma variedade de paletas de cores.
<Note>
Ao agrupar por um campo Select, o gráfico usa automaticamente as cores definidas para cada opção nas configurações do seu campo.
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="gizmo" />Nome do eixo </span>
Escolha quais rótulos de eixo mostrar: **Nenhum**, **Eixo X**, **Eixo Y** ou **Ambos** (somente gráficos de barras e de linhas).
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="stack-2" />Barras empilhadas / Linhas empilhadas </span>
Quando Agrupar por estiver definido, escolha como várias séries serão exibidas.
* **Desativado (Agrupadas)**: As séries aparecem lado a lado. Use ao comparar valores exatos entre grupos.
* **Ativado (Empilhadas)**: As séries são empilhadas umas sobre as outras. Use ao mostrar composição—como as partes compõem o todo.
**Exemplo**: Negócios por etapa, agrupados por responsável
* Agrupadas: Veja os números exatos de cada responsável lado a lado
* Empilhadas: Veja o total de negócios por etapa, com a contribuição de cada responsável empilhada
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="badge-2k" />Rótulos de dados </span>
Mostre valores diretamente nos elementos do gráfico (barras, pontos, fatias).
* **Ativado**: Os valores aparecem no gráfico
* **Desativado**: Nenhum valor exibido (visual mais limpo)
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="text-caption" />Legenda </span>
Mostrar ou ocultar a legenda (só aparece quando Agrupar por está definido).
* **Ativado**: A legenda mostra o que cada cor representa
* **Desativado**: Nenhuma legenda exibida
<Tip>
**Passe o mouse** sobre um item da legenda para destacar esse grupo. **Clique** para ocultá-lo temporariamente do gráfico.
</Tip>
---
## Notas específicas do gráfico
### Gráficos de pizza
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="chart-pie" size={16} /></span> **Cada fatia representa** – Defina como as fatias são agrupadas
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="eye-off" size={16} /></span> **Ocultar categoria vazia** – Remover fatias de valor zero
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="number-123" size={16} /></span> **Mostrar valor no centro** – Exibir o valor agregado (soma, média, contagem etc.)
### Gráficos agregados
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-left" size={16} /></span> **Prefixo** – Adicionar texto antes do número (por exemplo, `$`)
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-right" size={16} /></span> **Sufixo** – Adicionar texto após o número (por exemplo, `%`)