Saved-Filter-Datenquellen
Die Daten eines Reports stammen aus Jira-Saved-Filters. Sie fügen jeden Filter einmal hinzu, geben ihm einen Namen und binden Komponenten an diesen Namen.
Saved Filters sind in dieser Version die einzige Datenquelle. Es gibt kein frei eingegebenes JQL, keine REST-, SQL- oder CSV-Quelle und keinen Drittanbieter-Connector.
Eine Quelle hinzufügen
Im Report-Editor listet Datenquelle hinzufügen die Saved Filters auf, die Jira Ihnen zeigt. Wählen Sie einen aus und geben Sie ihm einen lokalen Anzeigenamen — „Support-Backlog", „Engineering-Eskalationen" —, den Sie später in der Quellenauswahl des Designers sehen.
Sie können auch eine numerische Saved-Filter-ID direkt eingeben. Ist Jira nicht erreichbar, sagt die Auswahl das, statt den Editor zu blockieren.
Ein Report kann bis zu 8 Datenquellen enthalten. Namen müssen eindeutig sein.
Exportelier speichert eine Filter-ID, keine Abfrage
Das ist das Wichtigste, was Sie über Reports wissen müssen.
Wenn Sie einen Saved Filter hinzufügen, speichert Exportelier seine numerische ID und Ihren Anzeigenamen. Mehr nicht. Nicht gespeichert werden:
- das JQL des Filters — es wird nie gelesen, kopiert, protokolliert oder zusammengesetzt;
- die Ergebnisse des Filters — es wird kein Abbild der Vorgänge abgelegt.
Zur Exportzeit bildet Exportelier genau ein streng numerisches Prädikat,
filter = 12345, und fragt Jira nach der Antwort von jetzt.
Daraus folgen drei Dinge, alle beabsichtigt:
- Der Report folgt dem Filter. Ändern Sie den Saved Filter in Jira, spiegelt der nächste Export das wider. In Exportelier ist nichts nachzuziehen.
- Die Jira-Freigabe des Filters gilt automatisch. Exportelier wird nie zum Seitenkanal daran vorbei.
- Es gibt keine veraltete Kopie, die entweichen könnte. Ein Report hält eine Referenz, keine Daten.
Weil die Referenz live ist, verändert das Bearbeiten eines breit geteilten Saved Filters jeden daran gebundenen Report — auch Reports anderer Admins.
Jeder Export läuft als Sie
Exportelier liest Jira als die Person, die den Export gestartet hat, nie als App und nie als die Person, die den Report gebaut hat.
Zwei Personen können denselben Report am selben Tag exportieren und berechtigterweise unterschiedliche Dokumente erhalten. Jede sieht genau die Vorgänge, die ihre eigenen Jira-Berechtigungen erlauben — nicht mehr und nicht weniger. Das ist korrektes Verhalten, kein Fehler: Die Alternative wäre eine App, die Menschen Daten zeigt, die Jira ihnen verweigert.
Ein Site-Admin, der den Report baut, sieht die Filter, die er sehen darf. Das erweitert nie, was jemand anderes bekommt.
Zwei Quellen, ein Filter, eine Suche
Zeigen zwei Datenquellen auf denselben Saved Filter, wird Jira einmal abgefragt und das Ergebnis an beide gegeben. Die Felder, die die Komponenten tatsächlich brauchen, werden über den ganzen Report gesammelt und gemeinsam angefordert — statt „alle Felder" oder einer Abfrage pro Komponente.
Sie können denselben Filter also unter zwei Namen für unterschiedliche Komponenten führen, ohne doppelt dafür zu zahlen.
Preflight: was der Export finden wird
Bevor ein Export startet, prüft Exportelier jede Quelle und meldet eines davon:
| Status | Bedeutung | Blockiert den Export? |
|---|---|---|
| Bereit | Der Filter wurde gelesen und traf Vorgänge. | Nein |
| Leer | Der Filter trifft derzeit keine Vorgänge. | Nein — ein leerer Report ist eine wahrheitsgemäße Antwort. |
| Nicht verfügbar | Der Filter ist für Sie nicht verfügbar. | Ja |
| Rate-limitiert | Jira drosselt Anfragen; kurz später erneut versuchen. | Vorübergehend |
| Fehler | Der Filter konnte nicht geprüft werden. | Vorübergehend |
Der Preflight zeigt außerdem eine ungefähre Vorgangszahl pro Quelle und warnt, wenn eine Quelle am Limit pro Quelle abgeschnitten wird.
Warum „nicht verfügbar" nicht „gelöscht" sagt
Jira antwortet mit 404 sowohl für einen Filter, den es nicht mehr gibt, als
auch für einen, den es gibt, der aber nicht mit Ihnen geteilt ist. Über die
API lassen sich die beiden Fälle nicht unterscheiden, also rät Exportelier
nicht. Eine Löschung zu behaupten, die es nicht belegen kann, schickt Menschen
auf die Suche nach dem falschen Problem; die Meldung nennt beide Möglichkeiten
und schlägt vor, einen Site-Admin um die Freigabe zu bitten.
Eine nicht verfügbare Quelle stoppt den Export
Ein Report mit fehlender Quelle wird nicht exportiert. Der Job scheitert und benennt die Quelle. Das ist eine bewusste Entscheidung: Ein Report, dem stillschweigend eine Datenquelle fehlt, ist inhaltlich falsch und von einem vollständigen nicht zu unterscheiden.
Limits für Quellen
- 8 Datenquellen pro Report und höchstens 8 verschiedene Filter-Suchen.
- 500 Vorgänge pro Quelle und 2.000 eindeutige Vorgänge im ganzen Report.
- 2 Jira-Suchen laufen gleichzeitig — Reports sind Hintergrund-Jobs, keine interaktiven Lesevorgänge, und teilen sich das Jira-Rate-Budget der Site.
Wenn ein Limit Daten abschneidet, sagt das fertige Dokument es, pro Quelle. Siehe die Limits-Referenz.