Opgeslagen filters als databron
De data van een rapport komt uit opgeslagen Jira-filters. Je voegt elk filter één keer toe, geeft het een naam en koppelt componenten aan die naam.
Opgeslagen filters zijn in deze versie de enige databron. Er is geen vrij in te voeren JQL, geen REST-, SQL- of CSV-bron en geen connector van derden.
Een bron toevoegen
In de rapporteditor toont Databron toevoegen de opgeslagen filters die Jira aan jou laat zien. Kies er een en geef het een lokale weergavenaam — "Support-backlog", "Engineering-escalaties" — die je terugziet in de bronkiezer van de designer.
Je kunt ook rechtstreeks een numeriek opgeslagen-filter-ID typen. Is Jira onbereikbaar, dan zegt de kiezer dat in plaats van de editor te blokkeren.
Een rapport kan tot 8 databronnen bevatten. Namen moeten uniek zijn.
Exportelier bewaart een filter-ID, geen query
Dit is het belangrijkste om over rapporten te begrijpen.
Wanneer je een opgeslagen filter toevoegt, bewaart Exportelier het numerieke ID en jouw weergavenaam. Meer niet. Niet bewaard worden:
- de JQL van het filter — die wordt nooit gelezen, gekopieerd, gelogd of samengesteld;
- de resultaten van het filter — er wordt nergens een momentopname van issues bewaard.
Bij het exporteren bouwt Exportelier precies één strikt numeriek predicaat,
filter = 12345, en vraagt Jira om het antwoord van nu.
Daaruit volgen drie dingen, alle drie bewust:
- Het rapport volgt het filter. Bewerk het opgeslagen filter in Jira en de volgende export weerspiegelt dat. In Exportelier valt niets te hersynchroniseren.
- De Jira-deelregels van het filter gelden automatisch. Exportelier wordt nooit een omweg eromheen.
- Er is geen verouderde kopie die kan uitlekken. Een rapport houdt een verwijzing vast, geen data.
Omdat de verwijzing live is, verandert het bewerken van een breed gedeeld opgeslagen filter elk rapport dat eraan gekoppeld is — ook rapporten van andere beheerders.
Elke export draait als jou
Exportelier leest Jira als de persoon die de export startte, nooit als de app en nooit als degene die het rapport bouwde.
Twee mensen kunnen dus hetzelfde rapport op dezelfde dag exporteren en terecht verschillende documenten krijgen. Elk ziet precies de issues die de eigen Jira-rechten toestaan — niet meer en niet minder. Dat is correct gedrag, geen fout: het alternatief zou een app zijn die mensen data laat zien die Jira hun weigert.
De sitebeheerder die het rapport bouwt ziet de filters die hij mag zien. Dat verbreedt nooit wat iemand anders krijgt.
Twee bronnen, één filter, één zoekopdracht
Wijzen twee databronnen naar hetzelfde opgeslagen filter, dan wordt Jira één keer bevraagd en gaat het resultaat naar beide. De velden die de componenten werkelijk nodig hebben worden over het hele rapport verzameld en samen opgevraagd, in plaats van "alles" op te halen of per component te bevragen.
Je kunt hetzelfde filter dus twee keer onder verschillende namen toevoegen — voor verschillende componenten — zonder er dubbel voor te betalen.
Preflight: wat de export zal aantreffen
Voordat een export start, controleert Exportelier elke bron en meldt een van deze statussen:
| Status | Betekenis | Blokkeert de export? |
|---|---|---|
| Klaar | Het filter is gelezen en vond issues. | Nee |
| Leeg | Het filter komt op dit moment met geen enkel issue overeen. | Nee — een leeg rapport is een waarheidsgetrouw antwoord. |
| Niet beschikbaar | Het filter is niet voor jou beschikbaar. | Ja |
| Beperkt door rate limiting | Jira beperkt aanvragen; probeer het zo weer. | Tijdelijk |
| Fout | Het filter kon niet worden gecontroleerd. | Tijdelijk |
De preflight toont ook een geschat aantal issues per bron en waarschuwt wanneer een bron bij de limiet per bron wordt afgekapt.
Waarom "niet beschikbaar" niet "verwijderd" zegt
Jira antwoordt met 404 zowel voor een filter dat niet meer bestaat als voor
een filter dat bestaat maar niet met jou is gedeeld. Via de API zijn die twee niet
te onderscheiden, dus Exportelier gokt niet. Een verwijdering claimen die het niet
kan bewijzen zou mensen naar het verkeerde probleem sturen; de melding noemt beide
mogelijkheden en stelt voor een sitebeheerder om het filter te vragen.
Een niet-beschikbare bron stopt de export
Een rapport met een ontbrekende bron wordt niet geëxporteerd. De taak mislukt en noemt de bron. Dat is een bewuste keuze: een rapport waarin stilletjes een van de databronnen ontbreekt is materieel onjuist en niet te onderscheiden van een volledig rapport.
Limieten die voor bronnen gelden
- 8 databronnen per rapport, en hooguit 8 verschillende filterzoekopdrachten.
- 500 issues per bron, en 2.000 unieke issues in het hele rapport.
- 2 gelijktijdige Jira-zoekopdrachten — rapporten zijn achtergrondtaken, geen interactieve leesacties, en delen het Jira-ratebudget van de site.
Wanneer een limiet data afkapt, zegt het uiteindelijke document dat, per bron. Zie de limietenreferentie.