Frequência de Atualização de Gráficos
O Dashboard.PT permite-te controlar com que frequência os pontos de dados podem ser adicionados aos teus gráficos. Esta funcionalidade ajuda a evitar a sobrecarga de dados e garante intervalos de atualização consistentes nas tuas visualizações.
Opções de Frequência Disponíveis
| Opção | Descrição | Melhor Para |
|---|---|---|
| always | Os dados podem ser adicionados a qualquer momento (predefinição) | Monitorização em tempo real, fluxos de dados contínuos |
| daily | Os dados só podem ser adicionados uma vez por período de 24 horas | KPIs diários, métricas de negócio regulares |
| weekly | Os dados só podem ser adicionados uma vez por período de 7 dias | Relatórios semanais, acompanhamento do progresso de projetos |
| yearly | Os dados só podem ser adicionados uma vez por período de 365 dias | Relatórios anuais, estatísticas de variação lenta |
Definir a Frequência de Atualização
Podes definir a frequência de atualização de duas formas:
1. Ao Criar um Novo Gráfico
No formulário de criação do gráfico, vais encontrar a definição "Frequência de Atualização" na secção Opções Avançadas. Basta selecionar a frequência de atualização que preferes no menu suspenso.
2. Ao Editar um Gráfico Existente
Também podes alterar a frequência de atualização de um gráfico existente:
- Navega até à página de Gráficos
- Encontra o gráfico que queres modificar
- Clica no botão Editar (ícone do lápis)
- Abre a secção Opções Avançadas
- Altera a definição "Frequência de Atualização"
- Guarda as alterações
Implementação Técnica
Nos bastidores, a frequência de atualização é guardada no JSON de configuração do gráfico como:
{
"theme": "dark",
"title": "Average Delivery Times",
"xAxis": {
"type": "linear",
"title": "Date"
},
"yAxis": {
"max": 700,
"min": 600,
"title": "Days"
},
"colors": [],
"legend": true,
"animation": true,
"customOptions": "{}",
"updateFrequency": "daily"
}
Quando tentas adicionar pontos de dados a um gráfico, o sistema verifica:
- A frequência de atualização configurada para o gráfico
- Quando o gráfico foi atualizado pela última vez
- Se passou tempo suficiente com base na definição de frequência
Resposta da API
Se tentares atualizar um gráfico com demasiada frequência através da API, vais receber um erro:
HTTP/1.1 429 Too Many Requests
Content-Type: application/json
{
"status": "error",
"message": "Update not allowed based on frequency setting (daily)"
}
Casos Especiais
- Eliminar Dados: Quando eliminas todos os pontos de dados de um gráfico, o temporizador da frequência de atualização é reiniciado, permitindo-te adicionar novos dados de imediato, independentemente da definição de frequência.
- Definição Predefinida: Se o campo updateFrequency não for especificado, o sistema assume "always" por predefinição, permitindo atualizações a qualquer momento.
- Gráficos Novos: Quando um gráfico é criado pela primeira vez, a primeira atualização é sempre permitida.
Nota
Os limites de frequência de atualização aplicam-se às chamadas da API e às atualizações da interface web. Para atualizações urgentes, podes eliminar primeiro os pontos de dados existentes, o que reinicia o temporizador.
Quer experimentar? O plano gratuito não tem limite de tempo.
Criar conta gratuita