Dati per grafici di avanzamento e traguardi

Indichi il valore iniziale, l’ultimo valore, il valore obiettivo e le percentuali dei traguardi da visualizzare. Il risultato riporta l’avanzamento reale, una posizione limitata adatta al grafico, i traguardi raggiunti, il prossimo traguardo quando presente e una serie ordinata di punti. Il calcolo funziona sia per obiettivi crescenti sia per indicatori che devono diminuire, come difetti, spese o tempi di risposta.

Definisca l’obiettivo con un punto di partenza esplicito

Una percentuale di avanzamento utile richiede tre valori, non soltanto il valore attuale e quello obiettivo. Il valore iniziale stabilisce lo zero per cento, l’obiettivo stabilisce il cento per cento e il valore attuale mostra la situazione più recente. Questa distinzione è importante quando il lavoro parte da una base diversa da zero. Per esempio, aumentando un punteggio da 20 a 100, il punto intermedio è 60; non equivale a un avanzamento del sessanta per cento ricavato direttamente dal punteggio. Invii i valori come numeri e specifichi almeno una percentuale di traguardo compresa tra zero e cento. I traguardi possono essere forniti in qualsiasi ordine e le percentuali ripetute vengono consolidate, così il grafico riceve una serie crescente e pulita. L’obiettivo deve essere diverso dal valore iniziale, perché un intervallo nullo non ha un rapporto di avanzamento significativo. Se coincidono, la capacità restituisce un errore di input tipizzato anziché infinito, una percentuale arbitraria o dati solo apparentemente validi. Ogni richiesta accetta fino a cento elementi, mantenendo limitati elaborazione e risultato senza penalizzare piani dettagliati.

Interpreti allo stesso modo obiettivi crescenti e decrescenti

La stessa formula gestisce entrambe le direzioni: l’avanzamento è la distanza percorsa dal punto iniziale divisa per l’intera distanza tra inizio e obiettivo. Se l’obiettivo è maggiore, il risultato identifica un percorso crescente. Se è minore, identifica un percorso decrescente; passare da 100 incidenti verso un obiettivo di 20 rappresenta quindi un progresso, non un valore negativo. La percentuale restituita non viene volutamente limitata. Un valore sotto zero segnala un arretramento oltre la posizione iniziale, mentre un valore sopra cento registra il superamento dell’obiettivo. Per la presentazione, chart_progress_percentage e chart_percentage del punto corrente sono invece limitati tra zero e cento. La verifica dei traguardi utilizza il progresso reale non limitato. Ogni traguardo normalizzato comprende percentuale, valore corrispondente lungo il percorso e indicatore di raggiungimento. Il risultato include inoltre il numero e le percentuali dei traguardi raggiunti, più il prossimo traguardo se ne resta uno. Quando sono tutti raggiunti, il campo facoltativo viene omesso anziché restituito come null.

Inserisca i punti nei grafici e nelle viste di stato

L’array chart_points fornisce un punto iniziale ordinato, un punto per ogni traguardo normalizzato e un punto obiettivo. Ogni record contiene tipo, percentuale, valore e stato di raggiungimento, quindi può alimentare grafici a linee, barre di avanzamento, marcatori temporali e riepiloghi testuali accessibili. L’oggetto current_point conserva il valore corrente e l’avanzamento effettivo, offrendo anche la coordinata limitata per il grafico. Questa separazione consente di collocare il marcatore in modo sicuro sul bordo quando l’obiettivo è in ritardo o superato, mostrando comunque il dato reale in un’etichetta o in un suggerimento. Utilizzi reached_milestone_percentages per badge, celebrazioni o eventi di audit e next_milestone per descrivere il passaggio successivo senza esaminare di nuovo l’array. Il calcolo è deterministico e non usa rete, tempo, stato memorizzato o casualità: input uguali producono sempre lo stesso output. Può eseguirlo gratuitamente nel browser durante la pianificazione oppure chiamare l’API al costo di $0.002 per richiesta quando genera report, aggiorna dashboard o elabora obiettivi in un flusso automatizzato.