Wie Autofill funktioniert
Der Zuordnungsalgorithmus — warum ein Story-Template automatisch eingefügt wird, wenn du ein Story-Ticket erstellst, und wie du das Verhalten steuerst.
Autofill ist die Hauptfunktion: Öffne einen Jira-Dialog zum Erstellen eines Issues, die Erweiterung findet das passende Template, und deine Beschreibung ist automatisch ausgefüllt. Kein Klicken, kein Kopieren und Einfügen.
Die Regeln
Wenn du ein Ticket öffnest, durchsucht die Erweiterung deine Templates und wendet das erste Template an, das alle folgenden Kriterien erfüllt:
- Projekt stimmt überein — das Projekte-Feld des Templates ist leer (was es universell macht) oder enthält den aktuellen Projektschlüssel.
- Issue-Typ stimmt überein — der
issueTypedes Templates stimmt mit dem im Dialog ausgewählten Issue-Typ überein (Groß-/Kleinschreibung wird ignoriert). - Plattform stimmt überein — die
platformdes Templates istall(der Standardwert) oder entspricht der aktuellen Plattform (Jira Server, Jira Cloud, Azure DevOps).
Wenn mehrere Templates passen, gewinnt das erste in der Liste. Deshalb ist die Reihenfolge wichtig — siehe Templates → Umsortieren.
Projektspezifische Überschreibungen
Ein gängiges Muster ist ein universelles Bug-Template (Projekte-Feld leer gelassen), das für ein bestimmtes Projekt mit anderen Anforderungen überschrieben wird:
| Reihenfolge | Name | Projekte | Issue-Typ |
|---|---|---|---|
| 1 | Bug — ABC-Projekt | ABC | Bug |
| 2 | Bug — generisch | (leer) | Bug |
Da ABC zuerst kommt und zutrifft, wenn du dich im ABC-Projekt befindest, gewinnt es. In jedem anderen Projekt greift das generische Template mit leerem Projekte-Feld.
Issue-Typ-Erkennung
Die Erweiterung liest den Issue-Typ aus dem Typ-Selektor des Erstellungsdialogs. Das funktioniert sowohl auf Jira Server (wo es ein <select>-Element ist) als auch auf Jira Cloud (wo es ein benutzerdefiniertes Dropdown ist, das als Button dargestellt wird).
Wenn du den Issue-Typ änderst, nachdem ein Template eingefügt wurde, führt die Erweiterung die Zuordnung erneut durch und ersetzt die Beschreibung mit dem passenden Template — aber nur, wenn die Beschreibung noch nicht manuell bearbeitet wurde (damit deine Arbeit nicht überschrieben wird).
Vorhandenen Inhalt beibehalten
Wenn du ein bestehendes Ticket bearbeitest und ein Template manuell einfügst, überschreibt die Erweiterung nicht. Sie hängt den Template-Inhalt an den vorhandenen Text an.
Tipp: Du kannst dieses Verhalten unter Einstellungen im Abschnitt “Vorhandenen Inhalt ersetzen” ändern.
Optionen pro Template
Jedes Template hat drei “Erscheint in”-Optionen:
- Schnellzugriff-Dropdown — das Dropdown in der Toolbar von Jira.
- Schnellzugriff-Buttons — die Button-Leiste über dem Beschreibungsfeld.
- Rechtsklick-Kontextmenü — das Kontextmenü des Browsers beim Rechtsklick auf das Beschreibungsfeld.
Deaktiviere einzelne Optionen pro Template, wenn es an dieser Stelle nicht angezeigt werden soll. Autofill ignoriert diese Optionen — es versucht immer zu füllen, unabhängig davon, in welchen Menüs das Template erscheint.
Wenn Autofill nicht auslöst
Drei häufige Gründe:
- Kein Template passt. Prüfe, ob du ein Template hast, dessen Projekte-Feld entweder leer ist (was auf alle Projekte passt) oder deinen Projektschlüssel enthält, und dessen Issue-Typ mit dem im Formular ausgewählten übereinstimmt.
- Die Seite hat das Formular noch nicht geladen. Die Erweiterung wartet per MutationObserver auf das Erscheinen des Formulars, aber bei langsamen Verbindungen kann der erste Render verpasst werden. Lade die Seite neu.
- Die Plattform wird nicht unterstützt. Trello und Asana haben grundlegende Unterstützung; die Azure-DevOps-Unterstützung wird noch ausgerollt — siehe Azure DevOps.