Données de graphique pour la progression et les jalons

Indiquez la valeur initiale, la dernière valeur, la cible et les pourcentages des jalons à afficher. Le résultat fournit la progression réelle, une position bornée adaptée au graphique, les jalons atteints, le prochain jalon s’il en reste un et une série ordonnée de points. Le calcul convient aussi bien aux objectifs à la hausse qu’aux indicateurs qui doivent baisser, comme les défauts, les dépenses ou le délai de réponse.

Définissez l’objectif avec un point de départ explicite

Un pourcentage de progression pertinent nécessite trois valeurs, et non uniquement une valeur actuelle et une cible. La valeur initiale définit zéro pour cent, la cible définit cent pour cent et la valeur actuelle indique la situation du moment. Cette distinction est essentielle lorsque le travail commence sur une référence non nulle. Par exemple, pour faire passer un score de 20 à 100, la moitié du parcours se situe à 60; il ne s’agit pas d’une progression de soixante pour cent calculée directement sur le score. Envoyez ces valeurs sous forme de nombres et fournissez au moins un pourcentage de jalon compris entre zéro et cent. Les jalons peuvent être transmis dans n’importe quel ordre; les pourcentages répétés sont regroupés afin de produire une série ascendante propre. La cible doit être différente du départ, car un intervalle nul ne permet pas de calculer un rapport de progression valable. Si les deux sont égaux, la capacité renvoie une erreur de saisie typée au lieu d’un résultat infini ou arbitraire. Une requête accepte jusqu’à cent éléments de jalon, ce qui borne l’exécution tout en couvrant des plans détaillés.

Interprétez uniformément les objectifs croissants et décroissants

La même formule gère les deux directions: la progression correspond à la distance parcourue depuis le départ, divisée par la distance totale entre le départ et la cible. Si la cible est supérieure, le résultat signale un objectif croissant. Si elle est inférieure, il signale un objectif décroissant; passer de 100 incidents vers une cible de 20 constitue donc un progrès et non une valeur négative. Le pourcentage de progression renvoyé n’est volontairement pas borné. Une valeur inférieure à zéro révèle une régression au-delà du point de départ, tandis qu’une valeur supérieure à cent enregistre un dépassement de la cible. Pour l’affichage, chart_progress_percentage et le champ chart_percentage du point actuel restent limités entre zéro et cent. Le statut des jalons repose sur la progression réelle non bornée. Chaque jalon normalisé contient son pourcentage, la valeur correspondante sur le parcours et un indicateur d’atteinte. La sortie donne aussi le nombre et les pourcentages des jalons atteints, ainsi que le prochain jalon lorsqu’il en reste. Une fois tous les jalons atteints, ce champ facultatif est omis plutôt que défini sur null.

Alimentez vos graphiques et vues de suivi

Le tableau chart_points fournit un point de départ ordonné, un point pour chaque jalon normalisé et un point cible. Chaque enregistrement comporte un type, un pourcentage, une valeur et un état d’atteinte; il peut ainsi alimenter une courbe, une piste de progression, des repères chronologiques ou un résumé textuel accessible. L’objet current_point conserve la valeur actuelle et la progression réelle tout en proposant la coordonnée bornée du graphique. Cette séparation permet de placer le marqueur à une extrémité lorsque l’objectif est en retard ou dépassé, sans masquer la valeur exacte dans une étiquette ou une infobulle. Utilisez reached_milestone_percentages pour les badges, célébrations ou événements d’audit, et next_milestone pour annoncer la prochaine étape sans reparcourir la liste. Le calcul est déterministe et n’utilise ni réseau, ni heure, ni état enregistré, ni hasard: une même entrée produit toujours la même sortie. Vous pouvez l’exécuter gratuitement dans le navigateur pour planifier, ou appeler l’API pour $0.002 par requête lors de la création de rapports, de la mise à jour de tableaux de bord ou du traitement automatisé d’objectifs.