Report-Builder
Die meisten Exporte in Exportelier gehen von etwas aus, das Sie gerade ansehen — einem Vorgang, einem Board, einem Sprint. Ein Report funktioniert umgekehrt: Er ist ein gespeichertes Objekt, das seine eigenen Daten benennt. Sie bauen ihn einmal, und jeder, der ihn exportieren darf, erhält die aktuellen Zahlen.
Ein Report besteht aus genau zwei Dingen:
- Einer Vorlage — eine normale Designer-Vorlage. Es gibt keine separate „Report-Vorlage" und keinen zweiten Designer.
- Einer oder mehreren benannten Datenquellen — jeweils ein Jira-Saved Filter.
Komponenten in der Vorlage werden dann namentlich an eine Quelle gebunden, so dass ein einzelner Report „Support-Backlog" und „Engineering-Eskalationen" im selben Dokument zeigen kann.
Special Reports: gespeicherte Berichte im Tab Dashboard.
Ausgangspunkt Jira-Dashboard
Sie können einen Report von Grund auf bauen — Filter wählen, Report-Komponenten platzieren, jede binden — oder von einem Jira-Dashboard ausgehen, das Sie bereits haben.
Aus einem Jira-Dashboard importieren liest die Konfiguration des Dashboards und baut daraus einen gewöhnlichen Report. Importiert wird, was ein Gadget anzeigen soll, nicht ein Bild davon — und das Ergebnis bleibt danach nicht synchron: Die Filterdaten bleiben live, Layout und Konfiguration ändern sich nur, wenn Sie ausdrücklich erneut importieren.
Wo Reports leben
Reports haben eine eigene Seite im Export Center, neben Ihren Export-Views. Die Liste zeigt Name, Beschreibung, Anzahl der Datenquellen, Vorlage, Scope, letzte Änderung und ob der Report für den Export verfügbar ist.
Jeder, der Exportelier nutzen kann, sieht die Liste. Was Sie dort tun können, hängt von Ihrer Rolle ab.
Wer darf was
| Aktion | Site-Admin | Jeder authentifizierte Jira-Benutzer |
|---|---|---|
| Report-Liste sehen | ✅ | ✅ |
| Einen aktivierten Report exportieren | ✅ | ✅ |
| Report anlegen, bearbeiten, duplizieren, löschen | ✅ | — |
| Report-Designer öffnen | ✅ | — |
| Datenquellen hinzufügen oder ändern | ✅ | — |
Administrative Aktionen sind für Nicht-Admins nicht bloß ausgeblendet — der Server lehnt sie ab, ein direkter API-Aufruf hilft also nicht.
Ein Site-Admin kann einen Report aus jedem Filter bauen, den er sieht. Das gewährt niemandem sonst Zugriff darauf. Jeder Export liest Jira erneut als die exportierende Person — siehe benutzerabhängige Ergebnisse.
Einen Report bauen
Der Report-Editor hat vier Teile, in der Reihenfolge ihrer Verwendung:
- Report-Details — Name, Beschreibung, Scope und ob der Report für den Export aktiviert ist.
- Datenquellen — jeden Saved Filter hinzufügen und ihm einen Namen geben, der in Ihrer Organisation Sinn ergibt. Siehe Saved-Filter-Datenquellen.
- Designer — der gewohnte visuelle Designer. Jede Datenkomponente erhält eine Quellenauswahl mit Ihren benannten Quellen.
- Vorschau und Export — Bindung prüfen, dann exportieren.
Ein Report lässt sich nicht speichern, solange eine Komponente keine gültige Datenquelle hat. Der Editor benennt die betroffenen Komponenten, statt sie stillschweigend an die erste beste Quelle zu binden.
Eine Quelle, die keine Komponente nutzt, ist erlaubt — Sie möchten vielleicht eine Bindung vorbereiten — aber der Editor sagt es, und der fertige Export ebenfalls.
Mit der gebündelten Vorlage starten
Neuer Report aus Dashboard Report Standard ist der schnellste Einstieg. Er kopiert die gebündelte System-Vorlage in eine bearbeitbare, fragt nach mindestens einem Saved Filter und fragt dann, welche Datenquelle jedes der drei Standard-Diagramme speist.
Bei einem einzigen Filter wird diese Antwort für Sie vorbelegt. Bei mehreren wird nichts geraten: Der Report kann erst angelegt werden, wenn jedes Diagramm zugeordnet ist — denn ein falsch gebundenes Diagramm erzeugt einen Report, der richtig aussieht und es nicht ist.
Die gebündelte System-Vorlage selbst wird nie verändert.
Einen Report exportieren
Report-Exporte laufen immer im Hintergrund, weil das Lesen mehrerer Filter und das Rendern eines Dokuments nicht in eine interaktive Anfrage passt.
Bevor der Job startet, prüft ein Preflight jede Datenquelle und zeigt, was er gefunden hat — bereit, leer oder nicht verfügbar, mit Vorgangsschätzung und einem Hinweis, wenn eine Quelle das Limit pro Quelle erreicht. Danach wählen Sie PDF, Word (DOCX) oder Markdown und starten den Export.
Während des Laufs sehen Sie ehrliche Phasen — Planung, Jira-Filter lesen, Rendern, Download vorbereiten — und können jederzeit abbrechen. Report-Exporte erscheinen zusammen mit gewöhnlichen Exporten unter Aktive Exporte, jeweils mit dem Report-Namen beschriftet, und eine Liste Ihre letzten Report-Exporte lässt Sie einen Job nach dem Schließen des Dialogs wieder öffnen.
Das fertige Dokument berichtet, was es tatsächlich enthielt: wie viele Vorgänge jede Quelle beigetragen hat, wo ein Limit gekürzt hat, und welche Quellen der Report definiert, aber keine Komponente nutzt.
Ist einer der Saved Filter des Reports für Sie nicht verfügbar, scheitert der Export und benennt diese Quelle. Er rendert nicht stillschweigend einen kleineren Report — ein Dokument, dem eine Datenquelle fehlt, sieht genauso aus wie ein vollständiges.
Limits
Reports haben eigene Obergrenzen — Datenquellen pro Report, Vorgänge pro Quelle, Zeilen pro Tabelle und so weiter. Jede davon wird serverseitig erzwungen und im Output genannt, wenn sie tatsächlich etwas abschneidet. Siehe die Limits-Referenz.