Datenpunkte für Zielfortschritt und Meilensteine

Geben Sie Startwert, aktuellen Wert, Zielwert und die gewünschten Meilenstein-Prozentsätze an. Das Ergebnis enthält den tatsächlichen Fortschritt, eine für Diagramme begrenzte Position, erreichte Meilensteine, den nächsten noch offenen Meilenstein und eine sortierte Punktreihe. Die Berechnung eignet sich sowohl für steigende Ziele als auch für Kennzahlen, die sinken sollen, etwa Fehlerzahlen, Ausgaben oder Antwortzeiten.

Definieren Sie das Ziel mit einem eindeutigen Ausgangspunkt

Für einen aussagekräftigen Fortschrittswert werden drei Werte benötigt, nicht nur Ist- und Zielwert. Der Startwert legt null Prozent fest, der Zielwert hundert Prozent und der aktuelle Wert zeigt den gegenwärtigen Stand. Dieser Unterschied ist entscheidend, wenn eine Aufgabe nicht bei null beginnt. Soll beispielsweise ein Wert von 20 auf 100 steigen, liegt die Hälfte des Weges bei 60; der Fortschritt beträgt nicht einfach sechzig Prozent, nur weil der aktuelle Wert 60 lautet. Übermitteln Sie die Werte als Zahlen und mindestens einen Meilenstein zwischen null und hundert Prozent. Die Reihenfolge der Meilensteine ist beliebig, doppelte Prozentsätze werden zusammengefasst, sodass das Diagramm eine saubere aufsteigende Reihe erhält. Start- und Zielwert müssen verschieden sein, da ein Bereich ohne Länge keinen sinnvollen Fortschrittsquotienten besitzt. Sind beide gleich, liefert die Funktion einen typisierten Eingabefehler statt Unendlich, eines willkürlichen Prozentsatzes oder scheinbar gültiger Diagrammdaten. Pro Anfrage werden höchstens hundert Meilenstein-Einträge verarbeitet. Das begrenzt Laufzeit und Ausgabe und reicht zugleich für sehr detaillierte Pläne aus.

Deuten Sie steigende und fallende Ziele einheitlich

Dieselbe Formel deckt beide Richtungen ab: Der Fortschritt ist die seit dem Start zurückgelegte Strecke geteilt durch die gesamte Strecke vom Start zum Ziel. Liegt der Zielwert höher, kennzeichnet das Ergebnis das Ziel als steigend. Liegt er niedriger, wird es als fallend gekennzeichnet; eine Verringerung von 100 Vorfällen auf den Zielwert 20 zählt damit als Fortschritt und nicht als negatives Ergebnis. Der ausgegebene Fortschrittswert wird bewusst nicht begrenzt. Ein Wert unter null zeigt eine Verschlechterung über den Ausgangspunkt hinaus, während ein Wert über hundert eine Übererfüllung dokumentiert. Für die Darstellung werden chart_progress_percentage und chart_percentage des aktuellen Punkts getrennt auf den Bereich von null bis hundert begrenzt. Die Entscheidung, ob ein Meilenstein erreicht wurde, beruht auf dem tatsächlichen unbegrenzten Fortschritt. Jeder normalisierte Meilenstein enthält Prozentsatz, den zugehörigen Wert auf der Zielstrecke und seinen Status. Zusätzlich nennt die Ausgabe Anzahl und Prozentsätze der erreichten Meilensteine sowie den nächsten offenen Meilenstein. Sind alle erreicht, wird dieses optionale Feld weggelassen und nicht als null zurückgegeben.

Übernehmen Sie die Punkte in Diagramme und Statusansichten

Das Array chart_points liefert einen sortierten Startpunkt, je einen Punkt für jeden normalisierten Meilenstein und einen Zielpunkt. Jeder Datensatz enthält Art, Prozentsatz, Wert und Erreichungsstatus und eignet sich deshalb für Liniendiagramme, Fortschrittsleisten, Zeitmarken und barrierearme Textzusammenfassungen. Das Objekt current_point bewahrt den tatsächlichen Istwert und den ungekürzten Fortschritt und stellt zusätzlich die begrenzte Diagrammkoordinate bereit. Dadurch kann ein Dashboard den Marker bei Rückstand oder Übererfüllung sicher am Rand darstellen und zugleich den ehrlichen Wert in einer Beschriftung oder einem Tooltip nennen. Verwenden Sie reached_milestone_percentages für Abzeichen, Erfolgsmeldungen oder Audit-Ereignisse und next_milestone für den nächsten Schritt, ohne das Array erneut durchsuchen zu müssen. Die Berechnung ist deterministisch und nutzt weder Netzwerk noch Uhrzeit, gespeicherten Zustand oder Zufall; identische Eingaben erzeugen identische Ausgaben. Für interaktive Planung läuft sie kostenlos im Browser. Beim automatischen Erstellen von Berichten, Aktualisieren von Dashboards oder Verarbeiten von Zieldatensätzen können Sie die API für $0.002 pro Anfrage aufrufen.