Assets Gadgets for Jira — die komplette Anleitung

Jede Einstellung erklärt — globale Zugriffsmodi, das My-Assets-Portal in JSM und alle zehn Dashboard-Gadgets (AQL Counter, Pie, Donut, Bar, Stacked Bar, Date vs Date, Tabellen). Inklusive Best Practices und Troubleshooting-Tabelle.

Überblick

Dies ist die vollständige Anleitung für Assets Gadgets for Jira (Dashboards & Reporting) — eine Forge-App für Jira Cloud. Sie liefert Dashboard-Gadgets für Jira-Assets-Daten (AQL) sowie die My Assets-Ansicht im Jira-Service-Management-Portal.

• Jira-Dashboard — Counter, Charts und Tabellen, gesteuert über AQL.
• JSM-Portal — My Assets für Endnutzer (schreibgeschützt).
• App-Administration — globaler Zugriffsmodus, Portal-Tabellen und Performance-Limits.

1. Globale Einstellungen

Admin-Einstellungen öffnen

Jira → Einstellungen → Apps → Apps verwalten → Assets Gadgets for Jira Dashboards & Reporting → Konfigurieren

Die Seite heißt Access Permissions Settings und hat drei Tabs:

1. Data Display Mode
2. My Assets (Portal)
3. Performance

1.1. Data Display Mode

Steuert, wie Dashboard-Gadgets die Assets-API aufrufen:

Nach dem Umstellen die Dashboard-Seiten neu laden. Die Konfigurationsdialoge der Gadgets zeigen den aktiven Modus und einen Link zu diesen Einstellungen.

Data-Display-Mode-Einstellungen

HINWEIS: Portal-Tabellen nutzen ihre eigene AQL und Gruppenregeln auf dem Tab My Assets (Portal). Der Data Display Mode gilt für Dashboard-Gadgets.

1.2. My Assets (Portal)

Wie die im Portal angezeigten My Assets-Tabellen konfiguriert werden, steht unten unter 2.2. Administratoren.

1.3. Performance

2. My Assets (JSM-Portal)

2.1. Endnutzer

My Assets öffnen

Im JSM-Portal: Nutzermenü (Avatar) → My Assets. Die Ansicht öffnet sich im Vollbild.

My Assets im Portal-Nutzermenü

Tab „Overview"

• Total Assets — Summe der Gesamtwerte aller konfigurierten Tabellen (überlappende AQL kann dasselbe Objekt mehrfach zählen).
• Bis zu 3 optionale AQL-KPI-Counter (vom Admin definiert).
• Suche — filtert geladene Zeilen clientseitig.
• Zeilen-Vorschauen je Tabelle und View all, um den jeweiligen Tab zu öffnen.

My Assets — Overview-Tab

Tabellen-Tabs

Jede konfigurierte Results-Tabelle ist ein Tab. Die Tab-Reihenfolge entspricht der Admin-Liste.

In einem Tabellen-Tab:

• KPI-Leiste: Total objects für die Tabellen-AQL plus optionale Counter (mit optionaler Farb-/Schwellenwert-Formatierung).
• Optionales Verteilungs-Chart (Donut nach Attribut).
• Umschalter Table / Cards (gleicher Modus für alle Tabs der Sitzung).
• Klick auf Zeile oder Karte öffnet das Detail-Panel.

Tabellen-Tabs

Table-Modus

• Spalten und Reihenfolge legt der Admin fest.
• Statuswerte werden als Lozenge mit Spaltenlabel dargestellt.
• Objektschlüssel und Referenzfelder sind, wo zutreffend, Links.
• Die Suche filtert bereits geladene Zeilen des Tabs oder der Overview.

Table-Modus

Cards-Modus

• Kartenkopf: Objektname und -schlüssel (Titel bis zu zwei Zeilen, vollständiger Name im Tooltip).
• Kartenkörper: bis zu drei nicht-leere Attribute in Spaltenreihenfolge; Status als Lozenge.
• URL-Attribute erscheinen als Link (vollständige URL im Tooltip).
• View details öffnet das Detail-Panel.

Cards-Modus

Detail-Panel

• Quick actions — nur für Nutzer mit Objekt-Leserecht.
• Summary — Attribute in zweispaltigem Layout.
• Your reported tickets — mit dem Objekt verknüpfte JSM-Tickets, sofern vorhanden.
• Related assets — verknüpfte Assets-Objekte.
• Asset timeline — Ereignisse aus den Timeline-Regeln des Admins.

Endnutzer können AQL, Spalten oder Filter nicht ändern.

Detail-Panel

Datenumfang

Jede Tabelle nutzt eigene AQL. Pro-Nutzer-Filter verwenden typischerweise currentUser() oder {{currentUser}}. Geteilte AQL ohne Nutzerfilter liefert für jeden Portal-Nutzer dieselben Zeilen.

2.2. Administratoren

Globale Einstellungen → My Assets (Portal)

Struktur

• Overview KPI — bis zu 3 AQL-Counter für den Overview-Tab.
• Results tables — bis zu 10 Tabellen; Zeilen ziehen, um die Tab-Reihenfolge im Portal festzulegen.
• Timeline rules — Regeln auf Portal-Ebene, wo konfiguriert.

My Assets (Portal) — Admin-Konfiguration

Tabelle hinzufügen oder bearbeiten

1. Add table oder Edit in einer Zeile öffnen.
2. Im Dialog die folgenden Felder setzen → Apply changes.
3. Save My Assets settings im Panel, um zu speichern.

Jede Tabelle braucht vor dem Speichern eine nicht-leere AQL und mindestens eine Spalte.

Dialog zum Hinzufügen/Bearbeiten einer Tabelle

Spaltenauswahl

3. Dashboard-Gadgets

Auf Jira-Dashboards stehen zehn Gadget-Typen zur Verfügung:

1. AQL Counter
2. Pie Chart
3. Donut Chart
4. Bar Chart
5. Horizontal Bar Chart
6. Stacked Bar Chart
7. Horizontal Stacked Bar Chart
8. Assets Table
9. Results Table
10. Date vs Date Chart

3.1. Gadget hinzufügen

1. Dashboard → Add gadget → nach Assets Gadgets suchen.
2. Typ wählen → Add → konfigurieren → Save oder Save & Close.

ACHTUNG: Verwende in AQL möglichst Schema-/Typ-IDs, z. B. "objectSchemaId" = 6 and "objectTypeId" = 32. Für Typ-Bäume: objectType in objectTypeAndChildren("Employees").

3.2. Gemeinsame Gadget-Oberfläche

Datenkopf (Charts und Tabellen, die Objekte laden)

1. Total objects matching AQL (optional) — Anzahl aller Objekte, die der Gadget-AQL entsprechen.
2. Scope — z. B. „Chart based on X of Y matching items" oder „Table based on…".
3. AQL Query (optional) — AQL-Text und gewählte Attribute.

Konfigurationsoptionen (wo zutreffend)

Die Konfiguration zeigt den aktuellen Data Display Mode und einen Link zu den globalen Einstellungen.

Nur Pie und Donut

• Group items smaller than (%) — 0–10 %, Schritt 0,5; 0 deaktiviert die Other-Gruppierung.
• Show Other breakdown — Button, der eine Tabelle der Objekte im Other-Topf aufklappt (Name, Count, %).

Chart-Attribute

Gruppierungsattribute: Status, Select, Date, Boolean, User, Object, Group, Project.

Limits

• Globale Obergrenze: Max items per gadget in den Performance-Einstellungen.
• Limited — Ergebnis durch Gadget- oder globales Limit gekappt.
• Partial — nicht alle Chunks geladen (Zeitbudget, Fehler, Rate-Limits). Show truncation info aktivieren, um dies anzuzeigen.

3.3. AQL Counter

Zeigt eine oder mehrere numerische Zahlen aus AQL.

Jeder Count lädt unabhängig; ein Fehler in einem Count blockiert die anderen nicht.

AQL-Counter-Gadget

AQL-Counter-Konfiguration

Highlight-Einstellungen

3.4. Pie Chart

Verteilung von Objekten über ein Attribut, dargestellt als proportionale Segmente. Einstellungen: AQL, Gruppierungsattribut, Other-Schwellenwert, gemeinsame Kopfoptionen, Number of Results.

Pie Chart

Pie-Chart-Konfiguration

3.5. Donut Chart

Wie das Pie Chart, aber mit hohlem Zentrum, das die Gesamtsumme zeigt. Praktisch, wenn man Teil-zu-Ganzes-Verteilung und Gesamtzahl in einer Ansicht braucht.

Donut Chart

Donut-Chart-Konfiguration

3.6. Bar Charts

Anzahl je Attributwert als Balken. Vier Varianten teilen dieselbe Konfiguration:

• Bar Chart — senkrechte Balken, einer je Attributwert.
• Horizontal Bar Chart — dasselbe, gedreht für lange Labels.
• Stacked Bar Chart — jeder Balken nach einem zweiten Attribut aufgeteilt (Stack-by).
• Horizontal Stacked Bar Chart — gestapelt, gedreht.

Einstellungen: AQL, Gruppierungsattribut (plus Stack-by-Attribut bei gestapelten Varianten), gemeinsame Kopfoptionen, Number of Results.

Bar Chart

Stacked Bar Chart

Horizontal Bar Chart

Horizontal Stacked Bar Chart

Bar-Charts-Konfiguration

3.7. Assets Table

Tabelle von Attributwerten mit Anzahl und Prozentwert.

Einstellungen: AQL, Attribut, gemeinsame Kopfoptionen, Number of Results. Keine Summenzeile im Fuß.

Assets Table

Assets-Table-Konfiguration

3.8. Results Table

Tabelle von Objekten mit ausgewählten Spalten. Schlüssel- und Referenzspalten sind Links.

Einstellungen: AQL, Spalten, Show AQL Query, Show Total objects matching AQL, Show Table total, Show truncation info, Number of Results.

Show Table total: Fußzeile mit der Bezeichnung Total; summiert numerische Spalten über die geladenen Zeilen; andere Spalten zeigen „-".

Results Table

Results-Table-Konfiguration

3.9. Date vs Date Chart

Zeitreihe aus einem oder zwei Datumsattributen der Objekte, die der AQL entsprechen.

Einstellungen: AQL Query, First Date Attribute, Second Date Attribute (optional), Aggregation Period (Tage / Wochen / Monate), Time Range, Time Range Number, gemeinsame Kopfoptionen, Number of Results.

Date vs Date Chart

Date-vs-Date-Konfiguration

INFO: AQL-Dokumentation: Use Assets Query Language (AQL) · How to use AQL

4. Best Practices

• AQL selektiv halten, um Ladezeit und API-Nutzung zu senken.
• Show AQL Query beim Testen nutzen; auf Produktiv-Dashboards ausschalten.
• Pie/Donut: bei vielen kleinen Segmenten einen Other-Schwellenwert > 0 setzen.
• Results Table: nur benötigte Spalten wählen; Show Table total nur für numerische Summen aktivieren.
• AQL Counter: bei maximal 10 Counts bleiben; jede AQL-Abfrage schnell halten.
• My Assets: persönliche Daten mit currentUser() oder {{currentUser}} filtern; Tabellen bei Bedarf über Visible to groups einschränken.
• Respect Permissions aktiviert lassen, außer alle Nutzer sollen uneingeschränkte Dashboard-Daten sehen.
• Performance anpassen, wenn Timeouts oder Rate-Limits auftreten.

5. Troubleshooting

6. Support

Fragen oder ein Feature-Wunsch? Erreiche uns über die Marketplace-Support-Seite.

FAQ