Epic Progress for Confluence — Dokumentation
Fortschrittsbalken auf Confluence-Seiten: live aus Jira-Epics, Projekten, Releases und Filtern, anhand von Seitenlabels oder manuell eingestellt.
Schnellstart
- Ein Confluence-Administrator installiert die App einmal aus dem Atlassian Marketplace.
- Für die Jira-Makros verbindet ein Website-Administrator Jira in Atlassian Administration: Apps → Epic Progress for Confluence → connect to Jira. Progress Bar und Page Progress funktionieren ohne diese Verbindung.
- Bearbeite eine Seite, gib /progress ein und wähle eines der fünf Makros.
- Fülle die mit * gekennzeichneten Felder aus, prüfe die Live-Vorschau und klicke auf Save (Speichern) und veröffentliche die Seite.
- Leser ohne Jira-Zugriff? Aktiviere Publish a snapshot for people without Jira access (Momentaufnahme für Personen ohne Jira-Zugriff veröffentlichen) in den Makroeinstellungen, veröffentliche die Seite und klicke auf Publish snapshot (Momentaufnahme veröffentlichen) unter dem Makro (Details).
Auf dieser Seite
Funktionsweise
Epic Progress for Confluence ergänzt Confluence-Seiten um fünf Makros . Drei zeigen Live-Fortschritt aus Jira, zwei funktionieren ohne Jira.
| Makro | Anzeige | Quelle |
|---|---|---|
| Epic Progress | Ein Epic: wie viele seiner Vorgänge erledigt sind | Jira |
| Jira Progress | Ein Projekt, Release (Fix Version), gespeicherter Filter oder eine JQL-Suche | Jira |
| Progress List | Mehrere Epics als Liste von Fortschrittsbalken mit Gesamtzeile | Jira |
| Page Progress | Wie viele Seiten ein Label tragen, beispielsweise approved | Kein Jira erforderlich |
| Progress Bar | Ein manuell eingestellter Balken | Kein Jira erforderlich |
So zählen die Jira-Makros
- Farben wie in Jira. Jeder Vorgang zählt anhand der Statuskategorie seines Status: Grün ist erledigt, Blau in Bearbeitung, Grau offen. So entsprechen die Zahlen Jiras Fortschrittsanzeige. Rot und Gelb hängen nicht vom Prozentwert ab: Auch 30 % können völlig im Plan sein.
- Jeder Prozentwert mit Grundlage: „50 % · 4 of 8 work items done“ (4 von 8 Vorgängen erledigt) und die Legende „4 done · 2 in progress · 2 to do“ (4 erledigt · 2 in Bearbeitung · 2 offen). Gegebenenfalls ergänzt das Makro „1 flagged“ (1 markiert) und „3 work items without estimate“ (3 Vorgänge ohne Schätzung).
- Vorgänge oder Story Points. Work items (Vorgänge) zählt jeden Vorgang einmal (empfohlen). Story Points addiert die Schätzwerte, sodass eine große Story mehr wiegt als eine kleine. Sowohl „Story Points“ (vom Unternehmen verwaltete Projekte) als auch „Story point estimate“ (vom Team verwaltete Projekte) funktionieren.
- Fußzeile. „Live from Jira · as of 14:05“: Zeitpunkt der Jira-Abfrage mit deinen Berechtigungen. Öffnest du die Seite innerhalb von 5 Minuten erneut, zeigt die App dieselben Werte ohne erneute Jira-Anfrage, damit häufig besuchte Seiten schneller laden. Die Zeit bleibt die der Abfrage; ein Hinweis beim Darüberfahren erklärt dies. Refresh (Aktualisieren) liest Jira sofort erneut; Open in Jira (In Jira öffnen) öffnet genau diese Vorgänge in der Jira-Suche.
Rundung und sehr große Suchergebnisse
- Ehrliche Zahlen. 100 % nur, wenn alles erledigt ist (199 von 200 sind 99 %). Ist etwas erledigt, aber weniger als 1 %, erscheint „<1 %“ statt 0 %.
- Sehr große Suchergebnisse. Bei großen Suchen liefert Jira eine ungefähre Anzahl. Das Makro zeigt dann „about …“ (ungefähr …) und nie 100 %, solange Jira offene Vorgänge zählt.
Einrichtung
Installiere die App, verbinde Jira für die Jira-Makros und füge anschließend ein Makro zu einer Seite hinzu.
1. App in Confluence installieren
Ein Confluence-Administrator installiert Epic Progress for Confluence einmal aus dem Atlassian Marketplace. Die App wird in Confluence installiert, nicht in Jira. Direkt danach bietet Confluence die Seite Get started (Erste Schritte) der App an, also die Administratorseite: Sie zeigt den Jira-Verbindungsstatus und die nächsten Schritte.
2. Jira verbinden (optional)
Epic Progress, Jira Progress und Progress List lesen Jira. Ein Website-Administrator verbindet die App mit Jira in Atlassian Administration: Apps → Epic Progress for Confluence → connect to Jira. Jira und Confluence müssen auf derselben Website liegen. Bis dahin funktionieren Progress Bar und Page Progress bereits; die Jira-Makros zeigen einen kurzen Hinweis zur noch fehlenden Verbindung.
3. Makro zur Seite hinzufügen
- Bearbeite eine Seite und gib /progress ein (oder einen Makronamen, beispielsweise /epic).
- Wähle eines der fünf Makros. Der Einstellungsdialog öffnet sich.
- Fülle die mit * gekennzeichneten Felder aus. Die Vorschau zeigt das Makro mit Live-Daten.
- Klicke auf Save (Speichern) und veröffentliche dann die Seite.
Zum späteren Ändern bearbeite die Seite, wähle das Makro und klicke auf das Stiftsymbol.
„Allow access“: einmal pro Person
Beim ersten Öffnen einer Seite mit einem Makro zeigt Confluence stattdessen: einen Hinweis, dass die App in deinem Namen Zugriff auf Atlassian-Apps benötigt, mit der Schaltfläche Allow access (Zugriff erlauben) .
- Das ist Atlassians Standardzustimmung für Apps, die Daten mit den Berechtigungen der nutzenden Person lesen: Die App liest Jira und Confluence unter deinem Konto mit deinen Berechtigungen.
- Jede Person bestätigt dies einmal. Danach laden die Makros wie gewohnt.
- Das gilt auch für Leser, die nur eine veröffentlichte Momentaufnahme sehen: Confluence fragt vor jedem erstmaligen Anzeigen eines App-Makros, auch wenn dieses anschließend keine Jira-Anfrage stellt.
- Die Zustimmung ändert nichts in Jira oder Confluence. Die App hat keinen Schreibzugriff.
Die fünf Makros
Alle fünf haben das gleiche Aussehen und denselben Einstellungsdialog. Jede Einstellung hat im Dialog selbst eine kurze Erklärung (das (?) -Symbol), deshalb sind die Einstellungstabellen unten eingeklappt.
Epic Progress Jira
Live-Fortschritt eines Jira-Epics anhand seiner Vorgangsstatus: Epic-Schlüssel als Link, Name, Balken, „4 of 8 work items done“ (4 von 8 Vorgängen erledigt) und Legende. Gezählt werden die direkt untergeordneten Vorgänge wie bei Jiras Fortschrittsanzeige für untergeordnete Vorgänge.
Einstellungen für Epic Progress
| Einstellung | Funktionsweise |
|---|---|
| Epic * | Gib einen Teil des Namens oder Schlüssels ein (zum Beispiel PL-42) oder füge einen Epic-Link ein. Das Makro zählt die direkt untergeordneten Vorgänge wie Jiras eigene Fortschrittsanzeige. |
| Also find other work items (Auch andere Vorgänge finden) | Lässt die Suche auch andere übergeordnete Vorgänge finden, beispielsweise eine Initiative oder eine Story mit Unteraufgaben. |
| Count by (Zählen nach) | Work items (Vorgänge) (empfohlen) oder Story Points. Vorgänge ohne Schätzung werden gesondert angezeigt. |
| Title (Titel) | Optional. Leer: Name des Epics. |
| Status und Fälligkeitsdatum des Epics | Zeigt Epic-Status und Fälligkeitsdatum. Beim Darüberfahren erscheint „in 12 days“ (in 12 Tagen) oder „4 days ago“ (vor 4 Tagen). Ein überschrittenes Datum wird rot („Overdue“), solange das Epic nicht erledigt ist. |
| Schaltfläche zur Liste offener Vorgänge | „Show 8 open work items“ öffnet bis zu 25 offene Vorgänge mit Schlüssel, Titel, Status und zugewiesener Person samt „Show all in Jira“ (Alle in Jira anzeigen). |
| Publish a snapshot for people without Jira access (Momentaufnahme für Personen ohne Jira-Zugriff veröffentlichen) | Siehe Momentaufnahmen. |
Jira Progress Jira
Live-Fortschritt eines Jira-Projekts, eines Releases (Fix Version), eines gespeicherten Filters oder einer JQL-Suche . Der Name verlinkt Projekt, Releaseseite oder Filter; eine JQL-Suche zeigt die Abfrage selbst. Releases zeigen Released (Veröffentlicht) oder Unreleased (Unveröffentlicht) und das Veröffentlichungsdatum. Bei unveröffentlichten Releases wird es nach Überschreiten rot.
Unteraufgaben werden bei Projekten und Releases standardmäßig ausgelassen, damit Story und Unteraufgaben nicht doppelt zählen. Bei Filtern und JQL werden sie mitgezählt, damit die Zahl genau dem Filter entspricht.
Einstellungen für Jira Progress
| Einstellung | Funktionsweise |
|---|---|
| What to count (Was gezählt wird) | A project (Ein Projekt), A release (fix version) (Ein Release), A saved filter (Ein gespeicherter Filter) oder A JQL search (for experts) (Eine JQL-Suche für Fortgeschrittene). |
| Project * (Projekt) | Alle Vorgänge dieses Projekts werden gezählt. |
| Project of the release * und Release * (Projekt des Releases und Release) | Zuerst das Projekt, dann eines seiner Releases. Unveröffentlichte Versionen stehen zuerst. |
| Saved filter * (Gespeicherter Filter) | Deine markierten Filter stehen zuerst; suche per Eingabe nach allen zugänglichen Filtern. Leser benötigen Jira-Zugriff auf den Filter, sonst meldet das Makro die fehlende Freigabe. |
| JQL * | Jede in Jira gültige JQL bis zu 2.000 Zeichen. Jeder Leser führt sie mit eigenen Jira-Berechtigungen aus. Sortierung (ORDER BY) wird ignoriert. Tipp: Erstelle die Suche zuerst in Jira und kopiere die JQL hierher. |
| Leave out sub-tasks (Unteraufgaben auslassen) | Für Projekte und Releases standardmäßig an (sonst zählen Story und Unteraufgaben einzeln), für Filter und JQL aus, damit die Zahl exakt dem Filter entspricht. |
| Count by (Zählen nach) | Work items (Vorgänge) oder Story Points. Story Points funktionieren für bis zu 2.000 Vorgänge. |
| Title (Titel) | Optional. Leer: Name von Projekt, Release oder Filter. |
| Schaltfläche zur Liste offener Vorgänge | Wie bei Epic Progress. |
| Publish a snapshot for people without Jira access (Momentaufnahme für Personen ohne Jira-Zugriff veröffentlichen) | Siehe Momentaufnahmen. |
Progress List Jira
Mehrere Epics als Fortschrittsliste für Roadmaps und Statusseiten. Jede Zeile zeigt Epic-Name als Link und Schlüssel, Balken, erledigten Anteil („4/8“ oder „19/34 pts“), Status und Fälligkeit. Wähle Epics selbst, alle Epics eines Projekts, untergeordnete Vorgänge oder eine JQL-Suche.
Einstellungen und Grenzen für Progress List
| Einstellung | Funktionsweise |
|---|---|
| Which epics (Welche Epics) | Epics I choose (Selbst gewählte Epics) (bis zu 20 in der Reihenfolge des Hinzufügens), All epics of a project (Alle Epics eines Projekts) (in Jiras Rangfolge), The children of a work item (Untergeordnete Vorgänge) (zum Beispiel Epics einer Initiative) oder Work items from a JQL search (Vorgänge einer JQL-Suche) (jeder Treffer wird eine Zeile, gezählt werden seine untergeordneten Vorgänge, die JQL-Reihenfolge bleibt erhalten). |
| Include epics that are already done (Bereits erledigte Epics einbeziehen) | Für All epics of a project (Alle Epics eines Projekts) und The children of a work item (Untergeordnete Vorgänge). |
| Count by (Zählen nach) | Work items (Vorgänge) oder Story Points. |
| Title (Titel) | Optional, wird über der Liste gezeigt. |
| Order (Reihenfolge) | As chosen (or in Jira’s order) (Wie gewählt oder Jiras Rangfolge), Least progress first (Geringster Fortschritt zuerst) (Epics mit Handlungsbedarf oben) oder Earliest due date first (Früheste Fälligkeit zuerst). |
| Gesamtzeile unter der Liste | „Overall 61 % · 8 of 13 work items done“ (Gesamt 61 % · 8 von 13 erledigt) mit eigenem Balken und „Open the list in Jira“ (Liste in Jira öffnen). |
| Publish a snapshot for people without Jira access (Momentaufnahme für Personen ohne Jira-Zugriff veröffentlichen) | Siehe Momentaufnahmen. |
Eine Liste zeigt bis zu 20 Zeilen. Weitere Treffer werden gemeldet; grenze die Auswahl ein oder öffne die Liste in Jira. Eine unzugängliche Zeile meldet „Not found, or you cannot see it in Jira“; andere Zeilen und Gesamtzeile bleiben. Epics liegen eine Ebene über Stories, auch nach Umbenennung, etwa zu „Feature“.
Page Progress Kein Jira erforderlich
Wie viele Seiten ein Label tragen, etwa wie viele Handbuchseiten approved sind: „75 % · 3 of 4 pages labelled “approved”“ (3 von 4 Seiten mit Label „approved“). Für Leser unzugängliche Seiten werden nicht gezählt.
Einstellungen für Page Progress
| Einstellung | Funktionsweise |
|---|---|
| Which pages (Welche Seiten) | Pages below this page (Untergeordnete Seiten) (alle Ebenen), All pages in this space (Alle Seiten dieses Bereichs) oder All pages in another space (Alle Seiten eines anderen Bereichs) (nur zugängliche Bereiche werden aufgelistet). |
| „Done“ label * (Label für erledigte Seiten) | Eine Seite zählt als erledigt, wenn sie dieses Label trägt. Confluence-Labels sind kleingeschrieben ohne Leerzeichen; „Approved“ zählt daher Seiten mit dem Label approved. |
| Only count pages with this label (Nur Seiten mit diesem Label zählen) | Optional, zum Beispiel doc, um Besprechungsnotizen auszuschließen. Leer: Alle Seiten der Auswahl zählen. |
| Title (Titel) | Optional. Leer: Pages labelled „approved“ (Seiten mit Label „approved“). |
| Schaltfläche zur Liste der Seiten ohne das Label | „Show 1 page without “approved”“ listet diese Seiten als Links. |
Ergänze Labels unten auf der Seite oder über das Symbol im Seitenkopf. Neue Labels erscheinen manchmal erst nach einigen Sekunden in der Confluence-Suche; klicke auf Refresh.
Progress Bar Kein Jira erforderlich
Ein manuell gesetzter Fortschrittsbalken für Arbeit außerhalb von Jira: Migration, Personalplanung, Checkliste. Du wählst die Statusfarbe; der Balken leitet sie nicht aus der Zahl ab.
Einstellungen für Progress Bar
| Einstellung | Funktionsweise |
|---|---|
| Progress (Fortschritt) | As a percentage (Als Prozentwert) (0 bis 100, Dezimalstellen erlaubt; der Balken zeigt ganze Prozent) oder As steps (Als Schritte), etwa 3 von 5 Meilensteinen (Steps done (Erledigte Schritte) und Total steps (Schritte insgesamt)). |
| Title (Titel) | Optional, erscheint über dem Balken. |
| Status colour (Statusfarbe) | Automatic (Automatisch) (blau, bei 100 % grün), Im Plan (grün), At risk (Gefährdet) (gelb), Off track (Außer Plan) (rot) oder Neutral (blau, ohne Statusbeschriftung). Du bestimmst den Status; der Balken leitet ihn nicht aus der Zahl ab. |
| Note under the bar (Notiz unter dem Balken) | Optional, etwa „Nächster Meilenstein: Beta am 15. November“. |
| Show when the value was last changed (Letzte Änderung anzeigen) | „Updated 4 Oct 2026“ (Aktualisiert am 4. Oktober 2026). Das Datum ändert sich nur mit dem Wert und zeigt die Aktualität. |
Der Einstellungsdialog
Jedes Makro hat einen Einstellungsdialog. Er öffnet sich beim Hinzufügen; später bearbeitest du die Seite, wählst das Makro und klickst auf das Stiftsymbol.
- Jedes Feld hat ein (?) -Symbol mit Kurzinfo und darunter einen Hinweis. Pflichtfelder sind gekennzeichnet mit *.
- Suchauswahlfelder finden Epics, Projekte, Releases, Filter und Bereiche nach Namen. Bei Epics kannst du auch einen Vorgangslink einfügen.
- Save (Speichern) prüft zuerst die Einstellungen und nennt fehlende Felder; der Dialog bleibt offen.
- Vorschau zeigt das Makro genau wie später auf der Seite, mit Live-Daten gemäß deinen Berechtigungen. Nach dem Speichern veröffentlichst du die Seite, damit Leser die Änderung sehen.
Momentaufnahmen für Leser ohne Jira-Zugriff
Epic Progress, Jira Progress und Progress List können eine datierte Momentaufnahme für Personen ohne Jira-Zugriff zeigen, etwa Führungskräfte oder Beteiligte, die nur Confluence lesen. Ein Seitenbearbeiter mit Jira-Zugriff veröffentlicht sie per Klick; Besuche von Bearbeitern halten die Zahlen aktuell.
Momentaufnahme veröffentlichen
- Bearbeite die Seite, öffne die Makroeinstellungen und aktiviere Publish a snapshot for people without Jira access (Momentaufnahme für Personen ohne Jira-Zugriff veröffentlichen) (Abschnitt Momentaufnahmen für Leser ohne Jira-Zugriff).
- Wähle What the snapshot shows (Inhalt der Momentaufnahme): Progress only (Nur Fortschritt) (empfohlen) oder Progress and work items (Fortschritt und Vorgänge).
- Lasse Keep the snapshot up to date when page editors open the page (at most every 15 minutes) (Beim Öffnen durch Seitenbearbeiter aktuell halten, höchstens alle 15 Minuten) aktiviert oder deaktiviere es, um die Momentaufnahme unverändert zu behalten, bis jemand auf Update snapshot (Momentaufnahme aktualisieren).
- Speichere und veröffentliche die Seite.
- Klicke unter dem Makro auf Publish snapshot (Momentaufnahme veröffentlichen).
Leser sehen dann den Balken mit „Snapshot · Datum und Uhrzeit · published“ (veröffentlicht) oder nach Aktualisierung durch einen Bearbeiterbesuch „… · updated automatically“ (automatisch aktualisiert). Nach 14 Tagen wird die Zeile gelb und nennt das Alter, etwa „18 days old“ (18 Tage alt). Momentaufnahmen funktionieren auf Seiten, nicht in Blogbeiträgen oder Vorlagen.
Warum braucht die Veröffentlichung einen Klick und wann erfolgt die automatische Aktualisierung?
Epic Progress for Confluence liest Jira mit den Berechtigungen des Seitenbetrachters. Ohne Jira-Zugriff gäbe es deshalb keine Zahlen. Eine Momentaufnahme schließt diese Lücke: Wer die Seite bearbeiten und Jira-Vorgänge sehen darf, entscheidet per Klick, die aktuellen Zahlen auf der Seite zu teilen. Das entspricht dem Kopieren der Zahlen auf die Seite, nur datiert und löschbar.
Danach halten Seitenbearbeiter sie aktuell: Öffnet jemand von ihnen die Seite und ist die Momentaufnahme älter als 15 Minuten, liest die App mit dessen Berechtigungen neue Jira-Werte. Das Lesen einer Momentaufnahme stellt nie eine Jira-Anfrage; View live (Live-Ansicht) liest Jira mit den Berechtigungen des Lesers. Die App liest nie mit eigenem Konto oder im Namen einer abwesenden Person, entsprechend Atlassians Vorgaben (Forge-Modell geteilter Verantwortung).
Details der automatischen Aktualisierung
- Die Seite wartet nicht darauf: Die gespeicherte Momentaufnahme erscheint sofort, die neuen Zahlen kurz danach.
- Automatische Aktualisierungen erneuern nur die veröffentlichten Zahlen. Neue Epics, Vorgänge oder Namen erscheinen erst nach manueller Aktualisierung durch einen Bearbeiter; bis dahin bleiben auch die Epics einer Liste gleich.
- Bei neuen Jira-Epics oder Vorgängen sehen Bearbeiter „New epics or work items in Jira since this snapshot. Update it to show them.“ (Neue Epics oder Vorgänge seit dieser Momentaufnahme; zum Anzeigen aktualisieren). Ist ein Epic gelöscht oder für den Bearbeiter unzugänglich, lautet der Hinweis „An epic or work item in this snapshot can't be read in Jira anymore. Update the snapshot to refresh it.“ (Vorgang nicht mehr lesbar; Momentaufnahme aktualisieren).
- Schlägt eine Jira-Anfrage während der Aktualisierung fehl, bleibt die Momentaufnahme erhalten. Pro Makro läuft nur eine Aktualisierung zugleich; Löschung hat immer Vorrang: Während einer laufenden Automatik gelöschte Momentaufnahmen bleiben gelöscht.
- Neue Zahlen erreichen Leser nur über Bearbeiter mit eigenem Jira-Zugriff. Ohne deren Besuch bleibt die Momentaufnahme unverändert. Das Datum zeigt die Aktualität; nach 14 Tagen erscheint das Alter in Gelb.
- Soll die Momentaufnahme bis zum Klick auf Update snapshot (Momentaufnahme aktualisieren) unverändert bleiben, deaktiviere Keep the snapshot up to date when page editors open the page (Beim Öffnen durch Seitenbearbeiter aktuell halten) in den Makroeinstellungen.
Wer darf Momentaufnahmen veröffentlichen, aktualisieren oder löschen?
Personen mit Bearbeitungsrechten für die Seite. Veröffentlichen und Aktualisieren benötigen zusätzlich Zugriff auf die Jira-Vorgänge, da die App mit deren Berechtigungen liest. Die Automatik arbeitet ebenso und nur beim Öffnen durch solche Personen. Bearbeiter finden Update snapshot (Momentaufnahme aktualisieren) und Remove snapshot (Momentaufnahme entfernen) nach dem Klick auf View live (Live-Ansicht).
Können Live-Werte nicht geladen werden, etwa nach Verlust des Jira-Zugriffs, bleibt Remove snapshot (Momentaufnahme entfernen) verfügbar: Entfernen benötigt nur Seitenbearbeitungsrechte, weder Jira-Zugriff noch aktives Abonnement. Confluence-Administratoren können Momentaufnahmen websiteweit abschalten: Confluence settings → Epic Progress for Confluence → Allow published snapshots (Veröffentlichte Momentaufnahmen erlauben) (siehe Administratorseite).
Wer sieht was?
- Alle Seitenleser sehen die Momentaufnahme mit Datum, Uhrzeit und Kennzeichnung „published“ oder „updated automatically“. Confluence bestimmt den Seitenzugriff; die App prüft ihn vor jeder Anzeige erneut mit den Leserberechtigungen. Bei entzogenem Seitenzugriff erscheint ein neutraler Hinweis.
- View live (Live-Ansicht) zeigt aktuelle Zahlen mit den eigenen Jira-Berechtigungen für Leser mit Vorgangszugriff. Back to the snapshot (Zurück zur Momentaufnahme) zeigt die Seite wie für andere Leser. Ohne Jira-Zugriff bleibt die Momentaufnahme mit „Live numbers need access to Jira“ (Live-Werte benötigen Jira-Zugriff) erhalten.
- Nur ein Bearbeiterbesuch kann die Momentaufnahme aktualisieren, höchstens alle 15 Minuten und mit dessen Jira-Berechtigungen. Ohne Jira-Zugriff bleibt sie unverändert.
- Wie alle anderen beantworten Momentaufnahmeleser zuerst die einmalige „Allow access“ (Zugriff erlauben) -Abfrage.
- Die Makros sind für lizenzierte Nutzer deiner Confluence-Website. Gäste und anonyme Besucher öffentlicher Seiten sehen die App-Makros einschließlich Momentaufnahmen nicht.
Was enthält eine Momentaufnahme?
Du wählst dies in den Einstellungen jedes Makros:
- Progress only (Nur Fortschritt) (Standard): Prozentwert und Anzahlen mit Schlüssel und Name des gemessenen Inhalts: Epic, Projekt, Release, gespeicherter Filter oder Epics einer Liste. Eine JQL-Suche hat keinen Namen; ihr Text wird nie gespeichert.
- Progress and work items (Fortschritt und Vorgänge): zusätzlich Status, Fälligkeiten, Veröffentlichungsdatum und bis zu 25 offene Vorgänge mit Schlüssel, Titel und Status.
Momentaufnahmen enthalten keine Personenfelder: weder zugewiesene Personen noch Konto-IDs, auch nicht die der veröffentlichenden Person, und nie JQL-Text. Titel und Namen werden so übernommen, wie dein Team sie in Jira schrieb. Nach Änderungen der Makroeinstellungen bleibt die alte Momentaufnahme bis zur erneuten Veröffentlichung verborgen.
Warum keine Konto-IDs und was ist mit Namen in Titeln?
Konto-IDs im App-Speicher würden Meldepflichten nach Atlassians Datenschutzregeln auslösen (Datenschutzleitfaden für App-Entwickler); Momentaufnahmen speichern keine. Enthält ein Epic-Titel oder Release-Name einen Personennamen, etwa „Interview mit Anna Müller“, zeigt die Momentaufnahme ihn. Die veröffentlichende Person entscheidet über die Freigabe wie beim Kopieren von Zahlen auf die Seite; Bearbeiter können die Momentaufnahme jederzeit löschen.
Wo werden die Daten gespeichert und wie gelöscht?
Im App-Speicher in Atlassians Cloud (Forge-Speicher), nicht auf der Seite. Momentaufnahmen sind deshalb weder Teil des Seitenverlaufs noch werden sie mit der Seite kopiert. Forge-Speicher bleibt am Datenresidenz-Standort deiner Confluence-Website.
Wann eine Momentaufnahme gelöscht wird
- Bei Veröffentlichung einer neueren, die die alte ersetzt.
- Ein Bearbeiter klickt auf Remove snapshot (Momentaufnahme entfernen) (sofortige Löschung).
- Die Seite landet im Papierkorb oder wird gelöscht: Die tägliche Bereinigung löscht Momentaufnahmen innerhalb von 24 Stunden. Bei vorheriger Wiederherstellung bleiben sie erhalten; sonst veröffentliche erneut.
- Ein Bearbeiter öffnet die veröffentlichte Seite mit deaktivierter Option Momentaufnahme veröffentlichen in den Makroeinstellungen: Abschalten bedeutet Entfernen (nicht während der Seitenbearbeitung).
- Ein Administrator sperrt den App-Zugriff auf die Seite mit einer App-Zugriffsregel: Die tägliche Bereinigung löscht Momentaufnahmen innerhalb von 24 Stunden.
- Das Makro wurde 120 Tage nicht geöffnet, etwa nach Entfernung oder weil die Seite nicht mehr gelesen wird (einschließlich Zugriffsbeschränkungen, die die App selbst ausschließen): Die tägliche Bereinigung löscht die Momentaufnahme. Dafür speichert die App pro Makro nur den Tag des letzten Öffnens, keine Person.
Nach Deinstallation hält Atlassian den App-Speicher einschließlich Momentaufnahmen 28 Tage vor und löscht ihn danach. Innerhalb von 21 Tagen kannst du uns um Wiederherstellung in einer neuen Installation bitten (Datenlebenszyklus für Forge-gehosteten Speicher).
Berechtigungen: wer was sieht
Die App liest Jira und Confluence als Person, die die Seite ansieht, nie mit einem geteilten App-Konto, und hat in beiden Systemen keinen Schreibzugriff.
| Aktion | Wer |
|---|---|
| App installieren | Ein Confluence-Administrator, einmal aus dem Atlassian Marketplace. |
| Jira verbinden | Ein Website-Administrator, in Atlassian Administration. Jira muss auf derselben Website liegen. |
| Makro hinzufügen oder ändern | Jeder mit dem Recht, die Seite zu bearbeiten. |
| Live-Werte sehen | Jeder Leser mit eigenen Berechtigungen. Jira und Confluence wenden diese an, einschließlich Vorgangssicherheit und Seitenbeschränkungen. Ohne Vorgangszugriff erscheint nur ein kurzer Hinweis, nie Zahlen oder Namen. Gesehene Daten werden nur für denselben Leser 5 Minuten vorgehalten (siehe Fußzeile); niemand anderes sieht sie. |
| Momentaufnahme veröffentlichen oder aktualisieren | Seitenbearbeiter, die die Jira-Vorgänge sehen dürfen. |
| Momentaufnahme entfernen | Seitenbearbeiter, auch ohne Jira-Zugriff oder aktives Abonnement. |
| Momentaufnahme ansehen | Alle Seitenleser (lizenzierte Nutzer deiner Confluence-Website). |
| Momentaufnahmen websiteweit abschalten | Ein Confluence-Administrator, auf der Administratorseite. Die App prüft mit Confluence unter dem Konto dieser Person deren Confluence-Administratorrolle. |
Das eigene App-Konto wird nur für zwei Ja/Nein-Fragen verwendet: auf der Administratorseite zur Jira-Verbindung und bei der täglichen Bereinigung zum Fortbestehen einer Seite mit Momentaufnahme. Keine davon zeigt Nutzern Jira- oder Confluence-Daten. Details: Sicherheitsrichtlinie (EN).
Administratorseite
Öffne in Confluence Einstellungen und wähle Epic Progress for Confluence in der linken Navigation. Dieselbe Seite ist nach der Installation die Get started (Erste Schritte) -Seite der App.
- Jira-Verbindung: Connected (Verbunden) oder Not connected (Nicht verbunden) mit Verbindungsschritten.
- Abonnement: Trial (Testphase) (mit Enddatum), Active (Aktiv) oder Not active (Nicht aktiv).
- Wer was sieht: die obigen Berechtigungsregeln in zwei Sätzen.
- Veröffentlichte Momentaufnahmen: der Schalter Allow published snapshots (Veröffentlichte Momentaufnahmen erlauben), standardmäßig an. Nur Confluence-Administratoren dürfen ändern; die App prüft dies jedes Mal mit Confluence unter dem Konto der ändernden Person.
- Die fünf Makros, jeweils gekennzeichnet als Jira oder Kein Jira erforderlich.
Check again (Erneut prüfen) neben Einrichtung prüft Abonnement und Jira-Verbindung erneut.
Wirkung von ausgeschaltetem „Allow published snapshots“
Momentaufnahmen sind websiteweit verborgen und werden weder veröffentlicht noch automatisch aktualisiert. Makros zeigen Live-Werte bei Jira-Zugriff, sonst einen Hinweis. Bestehende Momentaufnahmen bleiben erhalten (bis ein Bearbeiter sie entfernt, die Bereinigung sie mit der Seite löscht oder das Makro 120 Tage nicht geöffnet wird) und erscheinen beim erneuten Einschalten wieder.
Momentaufnahmen und App-Daten löschen
Die App speichert sehr wenig, vollständig in Atlassians Forge-Speicher. Die Makroeinstellungen (etwa Epic-Auswahl, JQL-Suche, Titel oder Notiz) gehören zur Seite. Confluence speichert sie wie andere Seiteninhalte; sie sind an Makro oder Seite gebunden und folgen dem Seitenverlauf.
Gespeicherte App-Daten und Löschfristen
| Daten | Löschung |
|---|---|
| Veröffentlichte Momentaufnahmen | Sofort bei Ersatz durch eine neuere Momentaufnahme, Entfernung durch einen Bearbeiter oder Öffnen der veröffentlichten Seite durch einen Bearbeiter mit deaktivierter Momentaufnahme. Durch tägliche Bereinigung innerhalb von 24 Stunden nach Papierkorb oder Seitenlöschung (vorher wiederhergestellte Seiten behalten sie) oder App-Zugriffssperre; außerdem nach 120 Tagen ohne Makroaufruf. |
| Notizen zur Automatik: Zeitpunkt der letzten Prüfung und ein einminütiger Anspruch während der Aktualisierung (zufällige ID, Zeit und nach Entfernung eine Löschmarkierung; keine Person) | Zusammen mit der Momentaufnahme; übrig gebliebene Ansprüche löscht die tägliche Bereinigung. |
| Notiz „Zuletzt geöffnet“ eines Makros mit Momentaufnahme (nur Datum, keine Person) | Mit der Momentaufnahme oder durch tägliche Bereinigung, sobald das Makro keine Momentaufnahme mehr hat. |
| Administratorschalter „Allow published snapshots“ | 28 Tage nach App-Deinstallation. |
| Kurzer Ansichtszwischenspeicher: Live-Makroinhalt eines Lesers (Anzahlen, Schlüssel, Namen, Status, Daten und Abfragezeit, kein JQL-Text), unter einem gesalzenen Einweg-Hash der Konto-ID gespeichert, nie unter der ID selbst | Nach 5 Minuten durch Forge-Speicher selbst: Atlassian entfernt abgelaufene Einträge im Hintergrund; die App zeigt nie Einträge über 5 Minuten Alter. Refresh (Aktualisieren) ersetzt ihn sofort. |
| Zufälliger Installationsschlüssel nur für diesen Hash (in Forges verschlüsseltem Geheimnisspeicher; keine personenbezogenen Daten) | 28 Tage nach App-Deinstallation. |
| Anonyme tägliche Nutzungszähler | Nach 8 Tagen. |
| IDs der Story-Point-Felder der Website (Zwischenspeicher) | Im Gebrauch alle 6 Stunden erneuert; 28 Tage nach App-Deinstallation gelöscht. |
Nach Deinstallation hält Atlassian sämtliche App-Daten einschließlich Momentaufnahmen 28 Tage vor und löscht sie anschließend nach seinen Aufbewahrungsregeln. Innerhalb von 21 Tagen kannst du uns um Wiederherstellung in einer neuen Installation bitten. Details: Datenschutzerklärung.
PDF- und Word-Export
PDF- und Word-Exporte sowie der Seitenverlauf zeigen jedes Makro als Text mit denselben Zahlen wie auf der Seite; Progress List als Tabelle mit Gesamtzeile. Sie werden live gelesen unter dem Konto der exportierenden Person mit deren Berechtigungen. Ein Export nutzt nie ein App-Konto und enthält nie eine Momentaufnahme. Ohne vorherige Zustimmung zu „Allow access“ (Zugriff erlauben) zeigt der Export eine neutrale Zeile statt Zahlen: Öffne einmal die Seite, erlaube Zugriff und exportiere erneut.
Häufige Fragen und Meldungen
Kurze Antworten auf häufige Fragen, danach App-Meldungen mit Abhilfe.
Brauchen Leser Jira-Zugriff?
Für Live-Werte ja: Jeder Leser sieht die Zahlen, die seine eigenen Jira-Berechtigungen erlauben. Für Leser ohne Jira-Zugriff kann ein Seitenbearbeiter eine datierte Momentaufnahme veröffentlichen, die alle Leser der Seite sehen. Progress Bar und Page Progress benötigen überhaupt kein Jira.
Warum bittet Confluence um „Allow access“?
Forge-Apps, die mit den Berechtigungen der nutzenden Person lesen, benötigen einmal deren Zustimmung. Beim ersten Öffnen einer Seite mit einem Makro bittet Confluence um Zugriff. Das gilt auch für Leser, die nur eine veröffentlichte Momentaufnahme sehen. Die Zustimmung ändert nichts in Jira oder Confluence.
Warum weicht die Zahl von meiner Jira-Suche ab?
Epic Progress zählt die Vorgänge direkt unter dem Epic. Jira Progress lässt bei Projekten und Releases Unteraufgaben aus, sofern du nicht folgende Option deaktivierst: Leave out sub-tasks (Unteraufgaben auslassen). Jeder Leser sieht zudem nur in Jira erlaubte Vorgänge.
Warum 99 %, obwohl fast alles erledigt ist?
100 % bedeutet, dass jeder Vorgang erledigt ist. Ein offener Vorgang von 200 ergibt 99 %.
Können Confluence-Gäste oder anonyme Besucher die Makros sehen?
Nein. Forge-Apps laufen für lizenzierte Nutzer einer Website, sofern sie nicht für Gäste und anonyme Besucher eingerichtet sind. Diese App ist dafür nicht eingerichtet.
Welche Jira-Projekte funktionieren?
Vom Unternehmen und vom Team verwaltete Projekte einschließlich ihrer Story-Point-Felder. Epics werden anhand ihrer Hierarchieebene erkannt, auch nach einer Umbenennung auf deiner Website.
Jede App-Meldung nennt Ereignis, Ursache und Abhilfe.
Meldungen und Abhilfe
„Live numbers need access to Jira“ (Live-Werte benötigen Jira-Zugriff)
Du hast auf View live (Live-Ansicht) geklickt, aber dein Konto hat auf dieser Website keinen Jira-Zugriff. Die Seite zeigt weiter die veröffentlichte Momentaufnahme. Bitte bei Bedarf deinen Jira-Administrator um Zugriff.
„This progress comes from Jira, which you cannot open“ (Fortschritt stammt aus Jira, auf das du keinen Zugriff hast)
Dein Konto hat auf dieser Website keinen Jira-Zugriff. Bitte deinen Jira-Administrator um Zugriff oder einen Seitenbearbeiter, eine Momentaufnahme zu veröffentlichen.
„Epic Progress for Confluence is not connected to Jira yet“ (Noch nicht mit Jira verbunden)
Die App ist in Confluence installiert, kann Jira aber noch nicht lesen. Ein Website-Administrator verbindet sie in Atlassian Administration: Apps → Epic Progress for Confluence → connect to Jira (Details). Progress Bar und Page Progress funktionieren bereits.
„Epic Progress cannot find the work item …“ (Vorgang nicht gefunden)
Vorgang, Projekt, Release, Filter oder Bereich existiert nicht oder ist für dich unzugänglich. Prüfe die Makroeinstellungen (Stiftsymbol bei Seitenbearbeitung) oder bitte deinen Jira-Administrator um Zugriff. Bei gespeicherten Filtern bitte den Eigentümer um Freigabe.
„Jira cannot run the search of this …“ (Jira kann diese Suche nicht ausführen)
Die JQL ist ungültig. Das Makro zeigt Jiras Erklärung (zum Beispiel „Field 'x' does not exist“). Korrigiere die JQL in den Makroeinstellungen und teste sie zuerst in Jira.
„Too many work items for story points“ (Zu viele Vorgänge für Story Points)
Story Points werden pro Vorgang addiert; die Suche liefert mehr als 2.000. Grenze die Suche ein oder zähle stattdessen Vorgänge.
„Epic Progress for Confluence: the subscription is not active“ (Abonnement nicht aktiv)
Testphase oder Abonnement sind beendet. Ein Confluence-Administrator kann sie unter Settings → Apps → Manage apps starten oder erneuern.
„The snapshot was published for other macro settings and is not shown“ (Momentaufnahme für andere Makroeinstellungen veröffentlicht; wird nicht angezeigt)
Die Makroeinstellungen wurden nach Veröffentlichung geändert. Ein Bearbeiter mit Zugriff auf die Jira-Vorgänge veröffentlicht die Momentaufnahme erneut.
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/epic-progress-for-confluence-issues
Supportseite: häufige Fragen und benötigte Angaben für eine Fehlermeldung
Rechtliches: Datenschutzerklärung · Nutzungsbedingungen (EN) · Sicherheitsrichtlinie (EN)
Atlassian, Confluence und Jira sind Marken von Atlassian. Epic Progress for Confluence ist eine unabhängige App von Janek Behrens, die nicht von Atlassian erstellt oder unterstützt wird; die Produktnamen nennen lediglich die kompatiblen Produkte.