Velocity Chart for Jira — Dokumentation

Sprint-Velocity auf jedem Jira-Dashboard, mit deiner eigenen Definition of Done.

Schnellstart

  1. Installiere Velocity Chart aus dem Atlassian Marketplace.
  2. Öffne ein Jira-Dashboard → Add gadget (Gadget hinzufügen) → suche nach Velocity Chart → Add (Hinzufügen).
  3. Klicke beim Gadget auf Stiftsymbol / Edit, wähle ein Scrum-Board mit mindestens einem abgeschlossenen Sprint und klicke auf Save (Speichern).
  4. Optional (Pro): Wähle die als erledigt zählenden Status, die Schätzmethode und bis zu vier Boards. Klicke auf die Balken eines Sprints, um dessen Vorgänge zu sehen.
Auf dieser Seite
  1. Übersicht
  2. Gadget hinzufügen
  3. Einstellungen
  4. So wird Velocity berechnet
  5. Sprintdetails
  6. Wer welche Zahlen sieht
  7. Mehrere Boards
  8. Export
  9. Kostenlos und Pro im Vergleich
  10. Häufige Fragen und Fehlerbehebung
  11. Support

Übersicht

Velocity Chart ergänzt ein Jira-Dashboard um ein Sprint-Velocity-Diagramm als Gadget. Für jeden abgeschlossenen Sprint eines Scrum-Boards zeigt es geplante (grau) und abgeschlossene (grün) Arbeit, eine gestrichelte Durchschnittslinie und in Pro das Say/Do-Verhältnis.

  • Funktioniert mit Scrum-Boards in vom Unternehmen und vom Team verwalteten Projekten.
  • Du bestimmst, welche Status als erledigt zählen (Pro).
  • Schätze anhand von Story Points, Vorgangsanzahl oder einem eigenen Zahlenfeld (Pro).
  • Klicke auf einen Sprint, um die Vorgänge hinter seinen Balken zu sehen (Pro).
  • Bis zu vier Boards in einem Gadget sowie CSV- und SVG-Export (Pro).
  • Jeder sieht nur Vorgänge, die er in Jira öffnen darf.
Velocity-Chart-Gadget auf einem Jira-Dashboard: zehn abgeschlossene Sprints mit Balken für geplante und abgeschlossene Arbeit, einer gestrichelten Durchschnittslinie bei 26,3 Punkten und einem Say/Do-Verhältnis von 81 %

Gadget hinzufügen

Das Gadget benötigt ein Scrum-Board mit mindestens einem abgeschlossenen Sprint.

  1. Installiere Velocity Chart for Jira aus dem Marketplace (Get it now (Jetzt installieren) → deine Jira-Website).
  2. Öffne ein Jira Dashboard → Add gadget (Gadget hinzufügen) → suche nach Velocity Chart → Add (Hinzufügen).
  3. Klicke beim Gadget auf Stiftsymbol / Edit , wähle ein Scrum-Board und klicke auf Save (Speichern).

Bedeutung der beiden Balken: So wird Velocity berechnet.

Welche Boards werden aufgelistet?
  • Scrum-Boards in vom Unternehmen und vom Team verwalteten Projekten, die du in Jira ansehen darfst; die Auswahl liest die ersten 200 Boards der Website. Vom Team verwaltete Boards tragen die Kennzeichnung „team-managed“.
  • Bei mehr als 7 Boards filtert ein Suchfeld nach Boardname, Projektname oder Projektschlüssel. Ausgewählte Boards bleiben während der Suche sichtbar.
  • Klassische Kanban-Boards haben keine Sprints und werden nicht aufgelistet. Ein vom Team verwaltetes Kanban-Board kann erscheinen, zeigt aber keine abgeschlossenen Sprints.
  • Neue Boards erscheinen sofort; die Auswahl wird nicht zwischengespeichert.

Einstellungen

Alle Einstellungen liegen in der Edit-Ansicht des Gadgets. Ohne Pro übernimmt das Gadget die Einstellungen des Boards.

EinstellungFunktionsweise
BoardsDas darzustellende Scrum-Board. PRO Wähle bis zu 4 Boards zum Vergleich.
Sprints to show (Anzuzeigende Sprints)Anzahl der jüngsten abgeschlossenen Sprints (Standard 7). Kostenlos: 1–7, Pro: 1–20.
Sprint labels (Sprintbeschriftung)Full name (Vollständiger Name) oder Numbers only (Nur Zahlen) (die erste Zahl im Sprintnamen). Lange Namen werden an der Achse gekürzt; mit der Maus über der Beschriftung siehst du den vollständigen Namen.
Estimation (Schätzmethode) PROStory Points (board default) (Standard des Boards), Issue count (Vorgangsanzahl) oder Custom numeric field (Eigenes Zahlenfeld).
Count as „Done“ (Als erledigt zählen) PRODie Status, die als abgeschlossen zählen.
Include sub-tasks (Unteraufgaben einbeziehen) PROStandardmäßig aus. Aktiviere diese Option, um auch Unteraufgaben zu zählen.

Deine Definition of Done PRO

Deine Definition of Done legt fest, was als abgeschlossen zählt. Wähle die Status, die dein Team als erledigt betrachtet, zum Beispiel Ready for release (Bereit zur Veröffentlichung) neben Done (Erledigt). Jeder Status zeigt seine Statuskategorie in Klammern.

  • Vorab ausgewählt sind die Status der Done-Spalte deines Boards. Solange du die Auswahl beibehältst, zählen genau diese Status, wie in Jiras Velocity-Bericht.
  • Nach einer Änderung zählen genau die ausgewählten Status.
Liste Count as Done mit Ready for release zusätzlich zum Status Done und das resultierende Diagramm mit höherer durchschnittlicher Velocity und höherem Say/Do-Verhältnis
Vorher und nachher: dasselbe Board mit zwei Definitionen

Nur Done (oben: 26,3 Punkte, 81 % Say/Do) und Done plus Ready for release (Bereit zur Veröffentlichung) (unten: 29,4 Punkte, 90 % Say/Do).

Dasselbe Board zweimal dargestellt: nur Done (Durchschnitt 26,3 Punkte, 81 % Say/Do) sowie Done und Ready for release (Durchschnitt 29,4 Punkte, 90 % Say/Do)

Estimation (Schätzmethode) PRO

Story Points verwendet das Schätzfeld des Boards und weicht bei leerem Wert auf das Standardfeld Story Points aus. Fließt eine solche Ersatzschätzung in die Zählung ein, nennt ein Hinweis unter dem Diagramm beide Felder und die Sprints, da Jiras Velocity-Bericht diese Vorgänge mit 0 zählt. Issue count (Vorgangsanzahl) zählt jeden Vorgang als 1. Custom numeric field (Eigenes Zahlenfeld) lässt dich ein anderes benutzerdefiniertes Zahlenfeld wählen.

Weitere Informationen zu Schätzungen und Unteraufgaben
  • Vorgänge ohne Wert zählen als 0, außer bei Issue count (Vorgangsanzahl).
  • Ohne Pro verwendet das Gadget die Boardeinstellung: dessen Schätzfeld oder die Vorgangsanzahl, falls das Board danach schätzt.
  • Unteraufgaben werden ausgelassen, sofern du nicht folgende Option aktivierst: Include sub-tasks (Unteraufgaben einbeziehen).
Gadget-Einstellungen: Sprints to show auf 10, Sprint labels auf Full name und die Estimation-Optionen Story Points (board default), Issue count und Custom numeric field

So wird Velocity berechnet

Jeder abgeschlossene Sprint hat zwei Balken. Grau zeigt die zu Beginn übernommene Arbeit, Grün die beim Sprintabschluss erledigte Arbeit.

  • Committed (Geplant) (grau): Schätzwerte der Vorgänge, die beim Start im Sprint waren und noch nicht erledigt waren, mit der damaligen Schätzung. Die App liest dies aus Sprint-, Status- und Schätzverlauf jedes Vorgangs. Später hinzugefügte Vorgänge zählen hier nicht.
  • Completed (Abgeschlossen) (grün): Schätzwerte der Sprintvorgänge, die einen Done-Status hatten, als der Sprint abgeschlossen wurde, gemäß deiner Auswahl Count as „Done“ und mit der Schätzung beim Abschluss. Die App liest den Statusverlauf jedes Vorgangs, wie Jiras eigener Velocity-Bericht.
  • Avg velocity (Durchschnittliche Velocity) (gestrichelte Linie): die durchschnittliche Velocity, also der Mittelwert der grünen Balken aller angezeigten Sprints.
  • Say/Do (Pro): abgeschlossen ÷ geplant pro Sprint. Neben dem Boardnamen steht der Durchschnitt aller Sprints mit geplanter Arbeit; Einzelwerte je Sprint stehen im CSV-Export.

Übernommene Vorgänge zählen einmal als abgeschlossen. Ein unerledigter Vorgang, der in den nächsten Sprint übernommen und dort abgeschlossen wird, zählt in beiden Sprints als geplant, aber nur im Sprint seiner Fertigstellung als abgeschlossen. Jira behält abgeschlossene Sprints im Sprint-Feld; die App prüft den Status zum jeweiligen Sprintabschluss. Auch ein danach wieder geöffneter Vorgang zählt im Sprint, in dem er erledigt war.

Beim Hinzufügen bereits erledigte Vorgänge zählen nirgends. War ein Vorgang beim Sprintstart oder späteren Hinzufügen erledigt und wurde bis zum Sprintabschluss nicht erneut abgeschlossen, zählt er in keinem Balken, wie in Jiras Velocity-Bericht. Die Sprintdetails führen ihn unter „Completed outside of this sprint“ (Außerhalb dieses Sprints abgeschlossen) auf. Wird ein beim Hinzufügen erledigter Vorgang wieder geöffnet und vor dem Abschluss erneut erledigt, zählt er nur als abgeschlossen.

Die Zahlen können dennoch von Jiras Velocity-Bericht abweichen, etwa bei vor Abschluss entfernten Vorgängen (Jira zählt sie als geplant, die App sieht sie nicht), anderen Done-Status, leeren Schätzfeldern des Boards oder Sicherheitsstufen, die Vorgänge vor der App verbergen (Details unten).

Weitere Details und Grenzen
  • Nach dem Start hinzugefügte Vorgänge zählen als Completed, wenn sie erledigt sind, aber nicht als Committed. Say/Do kann daher über 100 % liegen. Das gilt auch für direkt im laufenden Sprint erstellte Vorgänge und für vor Beginn entfernte, später erneut hinzugefügte Vorgänge. Innerhalb einer Sekunde nach dem Start hinzugefügte Vorgänge zählen noch als geplant.
  • Vor dem Abschluss aus dem Sprint entfernte Vorgänge zählen überhaupt nicht. Committed fällt daher niedriger aus, wenn der Umfang während des Sprints reduziert wurde. Jiras Bericht zählt sie als geplant; darin besteht ein Unterschied.
  • „Done“ bedeutet beim Start, Hinzufügen und Abschluss dasselbe: deine ausgewählten Count as „Done“-Status (Pro), andernfalls die Done-Spalte des Boards.
  • Spätere Schätzänderungen schreiben vergangene Sprints nicht um: Committed nutzt den Wert vom Sprintbeginn, Completed den vom Abschluss. Liefert Jira den vollständigen Verlauf nicht rechtzeitig, verwendet das Diagramm aktuelle Werte und meldet „could not read the full sprint history“ (vollständiger Sprintverlauf konnte nicht gelesen werden); klicke auf Refresh (Aktualisieren).
  • Bei Sprints mehrerer Boards zählt jedes Board nur die Vorgänge seines eigenen gespeicherten Filters. Liefert Jira nach einem erneuten Versuch keine Boardkonfiguration, zeigt das Diagramm einen Fehler samt Ursache statt eines ungefilterten Diagramms.
  • Die jüngsten Sprints werden nach Abschlussdatum aus allen abgeschlossenen Sprints des Boards gewählt. Kann die Liste nicht vollständig gelesen werden, zeigt das Diagramm einen Fehler statt älterer Sprints.
  • Pro Sprint werden bis zu 200 Vorgänge gelesen.
  • Ergebnisse werden bis zu 5 Minuten zwischengespeichert; Refresh (Aktualisieren) berechnet sofort neu. Deine Berechtigungen werden bei jedem Laden geprüft, auch bei Zahlen aus dem Zwischenspeicher (wer welche Zahlen sieht).

Sprintdetails PRO

Klicke auf die Balken eines Sprints, um dessen Vorgänge zu sehen. Unter dem Diagramm öffnet sich eine Liste; schließe sie durch erneutes Klicken, über ✕ oder mit Esc .

Sprint 51 im Diagramm ausgewählt, samt Details: 33 geplante und 26 abgeschlossene Punkte, neun Vorgänge. Sechs waren beim Sprintabschluss erledigt, einer davon erst nach dem Start hinzugefügt; drei waren nicht erledigt, einer davon ist inzwischen abgeschlossen.

Für jeden gezählten Vorgang zeigt die Liste:

  • Schlüssel und Titel, zum Vorgang verlinkt (öffnet einen neuen Tab).
  • Schätzwerte für die Balken: „At start“ zählt zu Committed, „At close“ zu Completed, zum Beispiel „At start: 1 pt · At close: 3 pts“ bei einer Änderung im Sprint („–“ bedeutet keine Schätzung und zählt als 0). Bei Issue count (Vorgangsanzahl) zählt jeder Vorgang 1.
  • Committed (Geplant) , wenn er zu Beginn im Sprint und noch nicht erledigt war, oder Added later (Später hinzugefügt) , wenn er nach Beginn hinzukam (auch bei Erstellung im laufenden Sprint): Dann gehört er nicht zum grauen Balken.
  • Ein Hinweis, wenn der Vorgang beim Hinzufügen bereits erledigt war: „Completed before it was in the sprint — not counted, same as Jira“ (vor Sprintzugehörigkeit erledigt, zählt wie in Jira nicht), „Done again during the sprint (was done at start)“ (im Sprint erneut erledigt, zählt nur zu Completed) oder „Was done when the sprint started, reopened later“ (bei Beginn erledigt, später wieder geöffnet; zählt in keinem Balken, da beim Abschluss offen).
  • Status beim Sprintabschluss. Ein ✓ markiert die als erledigt zählenden Status; diese Vorgänge bilden den grünen Balken. Bei späterer Statusänderung, etwa nach Übernahme und Fertigstellung im nächsten Sprint, erscheint der aktuelle Status als „now …“ (jetzt …).
  • Sub-task (Unteraufgabe), wenn Include sub-tasks (Unteraufgaben einbeziehen) aktiviert ist.

Die Vorgänge sind nach „Done when the sprint closed“ (bei Sprintabschluss erledigt), „Not done when the sprint closed“ (bei Sprintabschluss unerledigt) und „Completed outside of this sprint“ (vor Zugehörigkeit erledigt, in keinem Balken) gruppiert. Die Gesamtwerte oben entsprechen den Balken. Issues CSV (Vorgänge als CSV) lädt die Liste dieses Sprints herunter.

Tastatur, kleine Gadgets und kostenlose Nutzung
  • Tastatur: Wechsle mit Tab zum Diagramm, mit Pfeiltasten zwischen Sprints, öffne mit Enter oder Space und schließe mit Esc. Bewege die Maus über einen Balken oder eine Listenbeschriftung für eine Erklärung.
  • In schmalen Gadgets und Widgets stehen die Details jedes Vorgangs unter dessen Titel; lange Listen scrollen innerhalb des Bereichs.
  • Die Liste öffnet sich ohne erneute Jira-Anfrage; nur die Titel werden beim Öffnen geladen. Falls das fehlschlägt, bleibt die Liste vollständig und Retry (Erneut versuchen) lädt die Titel erneut.
  • Ohne aktives Abonnement zeigt ein Klick auf einen Sprint dessen Gesamtwerte und den Hinweis, dass die Details zu Pro gehören.

Wer welche Zahlen sieht

Velocity Chart zeigt jedem nur die in Jira erlaubten Daten, wie Jiras eigenes Velocity-Diagramm.

  • Das Board: Du benötigst die Berechtigung zum Ansehen des Boardprojekts. Andernfalls meldet das Gadget „You do not have permission to view this board“.
  • Die Vorgänge: Ein Sprint kann Vorgänge anderer Projekte enthalten (gemäß Boardfilter) und Vorgänge mit einer Sicherheitsstufe. Nur in Jira zugängliche Vorgänge zählen zu den Balken und erscheinen in den Sprintdetails. Fehlen welche, nennt eine dezente Zeile die Anzahl, etwa „2 issues hidden — you don't have permission to view them; their points are not counted.“ (2 Vorgänge verborgen; fehlende Berechtigung; Punkte nicht gezählt). Die Maus über der Zeile zeigt Ursache und Abhilfe. Vorgänge und Punktwerte werden nie genannt. Die Sprintdetails zeigen denselben Hinweis für ihren Sprint.
  • Für die App unzugängliche Vorgänge: Ein Vorgang, dessen Sicherheitsstufe die Projektrolle atlassian-addons-project-access nicht einschließt, ist vor Velocity Chart selbst verborgen und zählt für niemanden. Eine zweite dezente Zeile nennt zugriffsberechtigten Personen die Anzahl, etwa „3 issues in these sprints are hidden from Velocity Chart by an issue security level, so they are not counted.“ (3 Vorgänge durch Sicherheitsstufe vor Velocity Chart verborgen und nicht gezählt). Mit der Maus darüber siehst du die Abhilfe (siehe Funktionsweise unten).
  • Geteilte Dashboards: Zwei Personen können deshalb auf demselben Dashboard andere Zahlen sehen, etwa wenn ein Beteiligter nur eines der Boardprojekte ansehen darf.
Funktionsweise
  • Die App liest den Sprint als App, fragt dann bei jedem Laden Jira nach deinen Vorgangsberechtigungen (Projektberechtigung und Sicherheitsstufe) und addiert nur erlaubte Vorgänge. Die Antwort wird nie zwischengespeichert.
  • Der 5-Minuten-Zwischenspeicher enthält Board-Sprintdaten für alle (Vorgangs-IDs, Schlüssel, Schätzungen, Status, keine Titel oder Personen); vor der Anzeige werden sie für jeden Betrachter gefiltert.
  • Der Hinweis zu verborgenen Vorgängen zählt jeden Vorgang einmal, auch bei Übernahme in den nächsten Sprint; die Sprintdetails zählen ihn in jedem zugehörigen Sprint.
  • Ein Vorgang, dessen Sicherheitsstufe Velocity Chart nicht einschließt (Jira führt installierte Apps unter der Projektrolle atlassian-addons-project-access), kann von der App überhaupt nicht gelesen werden und zählt für niemanden, auch nicht für zugriffsberechtigte Personen. Die Balken können daher niedriger als in Jiras Velocity-Bericht sein. Der Hinweis nennt nur die Anzahl in den angezeigten Sprints, nie die Vorgänge. Ein Jira-Administrator kann die Rolle zur Sicherheitsstufe hinzufügen (Project settings → Issue security); benötigt die App Projektzugriff, muss die Rolle auch Browse Projects erhalten.
  • Die Zählung erfolgt bei jedem Laden unter deinem Konto: eine Jira-Suche über die angezeigten Sprints (nur Vorgangs-IDs und Typen) und nur bei Vorgängen, die im Zwischenspeicher fehlen, dieselbe Suche als App. Sie gehört allein dir, wird nie zwischengespeichert oder dauerhaft gespeichert und verändert keine Zahlen. Antwortet Jira nicht rechtzeitig, entfällt die Zeile ohne Fehler.
  • Nach Berechtigungs- oder Sicherheitsänderungen durch einen Jira-Administrator benötigt Jira manchmal einige Minuten zur Übernahme überall, auch im eigenen Velocity-Bericht. Lade das Dashboard danach neu.
  • Antwortet Jira auf die Berechtigungsprüfung nicht rechtzeitig, zählt das Diagramm nur geprüfte Vorgänge und meldet „Velocity Chart could not check issue permissions; numbers may be incomplete“. Klicke auf Refresh (Aktualisieren) nach einem Moment.

Mehrere Boards PRO

Wähle bis zu vier Scrum-Boards, um Teams in einem Dashboardbereich zu vergleichen. Jedes Board erhält sein eigenes Diagramm, seinen Durchschnitt und Say/Do-Wert, bei gleicher Schätzmethode und Definition of Done.

Konfigurationsformular mit drei ausgewählten Boards, darunter ein vom Team verwaltetes Board, und das Gadget mit einem Diagramm samt eigener durchschnittlicher Velocity und Say/Do pro Board
Gut zu wissen
  • Count as „Done“ (Als erledigt zählen) listet die Status des zuerst gewählten Boards auf; die gewählten Namen gelten für alle Boards.
  • Bei Wahl eines fünften Boards wird das zuerst ausgewählte Board in der Liste abgewählt.
  • Velocity hängt von der Schätzskala jedes Teams ab. Verwende sie zum Beobachten von Trends, nicht zur Rangfolge von Teams.
  • Ohne aktives Abonnement zeigt ein Gadget mit mehreren Boards nur das erste.

Export PRO

Zwei Schaltflächen unter dem Diagramm speichern die Zahlen und Bilder.

  • Export CSV (CSV exportieren) lädt velocity.csv herunter, eine CSV-Datei mit Board, Sprint, geplanter Arbeit, abgeschlossener Arbeit und Say/Do in % für jeden angezeigten Sprint aller Gadget-Boards (UTF-8).
  • Download SVG (SVG herunterladen) speichert jedes Boarddiagramm als SVG-Bild mit weißem Hintergrund für Präsentationen und Berichte.
  • Issues CSV (Vorgänge als CSV) in den Sprintdetails lädt die Vorgangsliste eines Sprints herunter: Vorgang, Titel, Schätzung bei Beginn und Abschluss, geplant, bei Abschluss erledigt, damaliger und aktueller Status, Unteraufgabe und Zählhinweis. „Committed“ und „Done when the sprint closed“ beschreiben die Balkenzählung; der Zählhinweis erklärt ausgelassene oder nur als abgeschlossen zählende Vorgänge. Bei Issue count (Vorgangsanzahl) werden die Schätzspalten durch eine einzige Spalte „Counts“ ersetzt. Wenn du Spaltenpositionen oder -namen zum Einlesen nutzt, prüfe deinen Import: Ältere Exporte hatten nur eine Spalte „Estimate“ und keinen Zählhinweis.
Schaltflächen Export CSV und Download SVG unter einem Diagramm sowie die exportierte velocity.csv mit Spalten für Board, Sprint, geplante und abgeschlossene Arbeit und Say/Do

Kostenlos und Pro im Vergleich

Es gibt einen Tarif: Die App ist kostenlos für bis zu 10 Nutzer, größere Teams erhalten eine kostenlose Testphase. Pro-Funktionen sind während eines aktiven Abonnements einschließlich Testphase verfügbar. Preise pro Nutzer stehen im Marketplace-Eintrag.

Ohne aktives Abonnement, etwa nach der Testphase, läuft das Gadget im reduzierten kostenlosen Modus weiter: ein Board, bis zu 7 Sprints, Schätzmethode und Done-Spalte des Boards. Pro-Funktionen kehren mit einem aktiven Abonnement zurück.

Kostenlose und Pro-Funktionen im Vergleich
FunktionKostenlosPro
Velocity-Diagramm für ein Board mit Durchschnittslinie✓✓
Scrum-Boards in vom Unternehmen und vom Team verwalteten Projekten✓✓
Sprintbeschriftung (vollständiger Name / Zahlen)✓✓
Angezeigte Sprintsbis zu 7bis zu 20
Konfigurierbare Definition of DoneDone-Spalte des Boards✓
Schätzmodus (Vorgangsanzahl / eigenes Feld)Boardstandard✓
Include sub-tasks (Unteraufgaben einbeziehen)—✓
Say/Do-Verhältnis—✓
Sprintdetails (Vorgänge hinter jedem Balken)—✓
Bis zu 4 Boards in einem Gadget—✓
CSV- und SVG-Export, Vorgangsliste pro Sprint—✓
Nur Vorgänge mit deinem Jira-Zugriff werden gezählt✓✓

Häufige Fragen und Fehlerbehebung

Öffne eine Frage, um die Antwort zu sehen.

Die Meldung lautet „No closed sprints on this board yet“ (Noch keine abgeschlossenen Sprints auf diesem Board).

Das Board hat noch keinen abgeschlossenen Sprint. Starte und beende einen Sprint oder wähle ein Board mit abgeschlossenen Sprints. Klassische Kanban-Boards haben keine Sprints und werden nicht aufgelistet.

Die Balken sind leer oder zeigen null.

Deine Vorgänge werden in einem anderen Feld als dem Boardstandard geschätzt. Öffne die Edit-Ansicht des Gadgets, gehe zu Estimation und wähle das tatsächlich verwendete Feld (zum Beispiel Story point estimate) oder wechsle zu Issue count (Vorgangsanzahl). Estimation, Done-Status und der Umgang mit Unteraufgaben sind Pro-Einstellungen.

Ein Board fehlt in der Auswahl.

Es werden nur Scrum-Boards in vom Unternehmen und vom Team verwalteten Projekten aufgelistet, die du ansehen darfst, aus den ersten 200 Boards der Website. Klassische Kanban-Boards fehlen, weil sie keine Sprints haben. Neue Boards erscheinen sofort.

Die Meldung lautet „You do not have permission to view this board“ (Du darfst dieses Board nicht ansehen).

Das Gadget zeigt nur Boards, deren Projekt du in Jira ansehen darfst. Bitte deinen Jira-Administrator um Zugriff auf das Projekt des Boards. Die Meldung kann auch bei einem zugänglichen Board erscheinen, wenn Jira die Prüfung nicht beantwortet hat, etwa bei einer kurzen Störung. Lade das Dashboard nach einigen Minuten neu; die App prüft dann erneut.

Ein Kollege sieht auf demselben Dashboard andere Zahlen.

Jeder sieht nur in Jira zugängliche Vorgänge. Enthält ein Sprint Projektvorgänge oder Vorgänge mit Sicherheitsstufe, die einer von euch nicht öffnen darf, fehlen sie für diese Person, wie in Jiras Velocity-Diagramm. Die Zeile „N issues hidden“ unter dem Diagramm zeigt das an. Siehe wer welche Zahlen sieht.

Die Meldung lautet „Velocity Chart could not check issue permissions; numbers may be incomplete“ (Vorgangsberechtigungen konnten nicht geprüft werden; Zahlen können unvollständig sein).

Jira hat die Berechtigungsprüfung nicht rechtzeitig beantwortet, meist wegen einer kurzen Anfragebegrenzung oder Störung. Das Diagramm zählt nur erfolgreich geprüfte Vorgänge und zeigt keine unerlaubten Daten; die Zahlen können niedriger sein. Klicke auf Refresh (Aktualisieren) nach einem Moment. Falls das wiederholt passiert, bitte deinen Jira-Administrator zu prüfen, ob Velocity Chart installiert ist und Jira-Zugriff hat.

Ein Hinweis unter dem Diagramm sagt, dass Schätzungen aus einem anderen Feld stammen.

Das Schätzfeld des Boards ist bei einigen Vorgängen der angezeigten Sprints leer. Velocity Chart verwendet dafür das Standardfeld Story Points. Jiras eigener Velocity-Bericht zählt diese Vorgänge mit 0, daher können deine Balken höher sein. Der Hinweis nennt beide Felder und die betroffenen Sprints. Um Jira zu entsprechen, fülle das Boardfeld oder stelle das Board auf das Schätzfeld deines Teams um. Der Hinweis erscheint nur, wenn eine solche Schätzung tatsächlich mitgezählt wird.

Die Meldung lautet „N issues in these sprints are hidden from Velocity Chart by an issue security level“ (N Vorgänge dieser Sprints sind durch eine Sicherheitsstufe vor Velocity Chart verborgen).

Velocity Chart liest Sprints als App. Jira verbirgt Vorgänge, deren Sicherheitsstufe die Projektrolle atlassian-addons-project-access nicht einschließt, die Jira für installierte Apps verwendet. Diese Vorgänge zählen für niemanden, sodass die Balken niedriger als in Jiras Velocity-Bericht sein können. Nur zugriffsberechtigte Personen sehen den Hinweis mit der Anzahl, nie die Vorgänge selbst. Ein Jira-Administrator kann die Rolle zur Sicherheitsstufe hinzufügen (Project settings → Issue security). Braucht die App Projektzugriff, benötigt die Rolle auch Browse Projects. Jira braucht zum Übernehmen der Änderung manchmal einige Minuten.

Die Meldung lautet „Velocity Chart could not read the configuration of this board“ (Boardkonfiguration konnte nicht gelesen werden).

Jira hat die Boardkonfiguration nicht geliefert (die Meldung nennt den HTTP-Status), meist wegen einer kurzen Anfragebegrenzung oder Störung. Die App benötigt sie für den gespeicherten Boardfilter und zeigt einen Fehler statt eines Diagramms, das fremde Boardvorgänge enthalten könnte. Ein erneuter Versuch ist bereits erfolgt. Klicke auf Refresh (Aktualisieren) nach einer Minute und prüfe, ob das Board in Jira geöffnet werden kann. Eine ähnliche Meldung betrifft einen fehlenden gespeicherten Boardfilter: Prüfe in den Boardeinstellungen, ob er noch existiert.

Die Meldung lautet „Could not read sprints“ oder „Could not read the issues of … sprints“ (Sprints beziehungsweise deren Vorgänge konnten nicht gelesen werden).

Jira hat die Anfrage nicht beantwortet, meist wegen einer kurzen Anfragebegrenzung oder Störung. Solche Ergebnisse werden nicht zwischengespeichert. Klicke auf Refresh (Aktualisieren) oder lade das Dashboard nach einer Minute neu.

Die Zahlen wirken veraltet.

Ergebnisse werden bis zu fünf Minuten zwischengespeichert. Klicke auf Refresh (Aktualisieren) im Gadget, um sofort neu zu berechnen.

Zählt ein übernommener Vorgang in beiden Sprints?

Nur als geplante Arbeit. Als abgeschlossen zählen Vorgänge, die beim Sprintabschluss erledigt waren, wie in Jiras Velocity-Bericht. Ein unerledigter übernommener Vorgang zählt nur im Sprint seiner Fertigstellung als abgeschlossen. Ein schon beim Hinzufügen erledigter Vorgang zählt in keinem Balken.

Die Zahlen unterscheiden sich von Jiras Velocity-Bericht.

Velocity Chart verwendet dieselben Zählregeln: Geplant ist die beim Start vorhandene, damals unerledigte Arbeit; abgeschlossen ist die beim Sprintabschluss erledigte Arbeit, mit den Schätzungen beider Zeitpunkte. Unterschiede bleiben bei eigenen Done-Status oder Schätzfeldern (Pro), vor Abschluss entfernten Vorgängen (Jira zählt sie als geplant, die App sieht sie nicht), leeren Board-Schätzfeldern (Jira zählt 0, die App nutzt Story Points) sowie Sicherheitsstufen, die Vorgänge vor der App verbergen (siehe oben).

Was ist der Unterschied zu Jiras integriertem Velocity-Bericht?

Jiras Bericht liegt unter Reports im Board und verwendet dessen Done-Spalte und Schätzeinstellung. Velocity Chart ist ein Dashboard-Gadget: Du wählst Done-Status und Schätzmethode, kannst bis zu vier Boards darstellen, über einen Sprint die Vorgänge hinter den Balken öffnen und erhältst das durchschnittliche Verhältnis erledigter zu geplanter Arbeit sowie CSV-/SVG-Export (Pro).

Unterstützt Velocity Chart vom Team verwaltete Projekte?

Ja. Vom Team verwaltete Scrum-Boards erscheinen mit „team-managed“ in der Boardauswahl und verwenden dieselbe Berechnung wie vom Unternehmen verwaltete Boards.

Ändert die App meine Jira-Vorgänge?

Nein. Velocity Chart hat ausschließlich Lesezugriff und fordert keine Schreibberechtigungen an. Es liest nur Sprintdaten für das Diagramm und hält sie kurzzeitig in Atlassian Forge Storage vor (Vorgangs-IDs, Schlüssel, Schätzungen und Status; keine Titel oder Personen). Siehe die Datenschutzerklärung und die Sicherheitsrichtlinie (EN).

Support

Fragen, Fehler oder Funktionswünsche? Wir antworten üblicherweise innerhalb von 1–2 Werktagen (Montag bis Freitag).

E-Mail: support@janekbehrens.de
Fehlermeldungen und Funktionswünsche: github.com/janekbehrens/velocity-chart-for-jira-issues
Supportseite: häufige Fragen und benötigte Angaben für eine Fehlermeldung
Rechtliches: Datenschutzerklärung · Nutzungsbedingungen (EN) · Sicherheitsrichtlinie (EN)