4.10 - Aba Interaction: clique, ação e sequência
Aba Interaction — clique, ação e sequência
A aba Interaction (Interação) controla o que acontece quando o usuário clica num card do dashboard. É a "ponte" entre o boardkit e o resto do Odoo. Veja nos prints abaixo.
Os 4 campos da aba
A aba mais simples do formulário, mas essencial para a experiência do usuário:
| Campo | O que faz | Padrão |
|---|---|---|
show_records |
Se marcado, clicar no card abre a lista de registros que geraram o número. | True |
action_id |
Substitui o comportamento padrão — abre uma ação customizada (ex.: dashboard específico, relatório). | vazio |
sequence |
Ordem do card dentro do dashboard (menor = primeiro). | 10 |
description |
Texto curto que aparece como tooltip ao passar o mouse sobre o card. | vazio |
Print 1 — aba Interação padrão de um tile (Open Opportunities):
Note que Mostrar registros está marcado por padrão — clicar no tile "14" abre a lista de 14 oportunidades.
show_records — o clique padrão
É o campo mais importante. Quando True (padrão), o clique faz o óbvio: abre a lista filtrada de registros.
show_records = True
Clicar no card abre uma view de lista do model_id com o filtro do item aplicado.
Quando usar: 95% dos casos — é o que o usuário espera.
show_records = False
O card fica só visual — não responde ao clique (a menos que action_id esteja configurado).
Quando usar: KPIs puramente informativos ("sistema processando", "última sincronização").
action_id — ação personalizada
Permite substituir o clique padrão por uma ação específica do Odoo (lista, form, dashboard, relatório, URL).
Domínio automático
O dropdown de action_id mostra apenas ações do mesmo modelo do item — [('res_model', '=', model_name)]. Você não consegue acidentalmente abrir um dashboard de outro modelo.
3 usos comuns de action_id
Lista filtrada
Abre uma lista pré-filtrada específica (não a padrão).
Ex.: Oportunidades com prazo esta semana — substitui a lista padrão.
Outro dashboard
Abre um dashboard diferente do boardkit (drill entre dashboards).
Ex.: clique em "Total de Clientes" → vai para o dashboard de CRM detalhado.
Relatório
Abre um relatório específico (PDF, Excel).
Ex.: clique em "Faturamento" → relatório financeiro consolidado.
action_id tem prioridade sobre show_records
Se action_id está preenchido, ele substitui o show_records. Você pode deixar show_records=True ou False — tanto faz, o que vale é o action_id.
sequence — ordem dos cards
Define a posição do card no dashboard. Importante: este sequence é independente do sequence dos slides do e-learning.
Como funciona na prática
- O dashboard ordena todos os cards por
sequencecrescente. - Cards com
sequence=10aparecem primeiro (canto superior esquerdo). - Você pode usar intervalos (
10, 20, 30...) para deixar espaço para inserir depois. - Empate? O boardkit desempata por ID do item.
Dica: organize os cards por importância — KPIs críticos primeiro, métricas auxiliares depois.
description — tooltip explicativo
Um texto curto (1-2 linhas) que aparece quando o usuário passa o mouse sobre o card. Serve para explicar o que está sendo contado ou dar contexto.
Boas práticas
- 1 linha, até 80 caracteres
- Explique a fonte dos dados ("Baseado em vendas confirmadas")
- Dê contexto ("Última atualização há 5 minutos")
- Avise sobre limitações ("Não inclui pedidos cancelados")
Evite
- Textos longos (vira parágrafo)
- Repetir o nome do card ("Total de X = Total de X")
- Jargão técnico sem explicar
- Deixar vazio (perde uma oportunidade de clareza)
Exemplos de tooltips que funcionam
- "Contatos com e-mail válido. Atualizado a cada 15 minutos."
- "Vendas ganhas nos últimos 30 dias. Exclui devoluções."
- "Tickets abertos atribuídos a mim. Base: helpdesk.ticket."
- "Meta: 50. Atualizado em tempo real conforme pedidos são confirmados."
Diferença: List vs Interaction
São conceitos diferentes que confundem:
item_type=list (4.6)
O tipo do item — o card renderiza como uma tabela agregada.
Ex.: "Latest Contacts" é uma lista de contatos, não um número.
show_records / action_id (4.10)
A ação do clique — o que acontece quando o usuário interage.
Ex.: clicar no tile abre a lista (mesmo que o item seja um tile).
Capítulo 4 completo!
Você agora domina todas as 7 abas do formulário de item: Value, Chart, List, Drill Down, Domain, Appearance e Interaction.
Próximo passo: Capítulo 5 — Reorganização do Dashboard, onde você aprende a arrastar, redimensionar e salvar o layout dos cards.
Parabéns — você dominou o formulário de item completo! Vamos para a Reorganização do Dashboard, onde você ajusta o layout visual.
Detalhe da aba Interaction: 4 campos (show_records, action_id, sequence, description), comportamento padrão do clique, 3 usos comuns de action_id, boas práticas de tooltip e diferença entre List e Interaction.
Por enquanto não há comentários.