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:

  1. Navega até à página de Gráficos
  2. Encontra o gráfico que queres modificar
  3. Clica no botão Editar (ícone do lápis)
  4. Abre a secção Opções Avançadas
  5. Altera a definição "Frequência de Atualização"
  6. 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:

  1. A frequência de atualização configurada para o gráfico
  2. Quando o gráfico foi atualizado pela última vez
  3. 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