Mit Templates arbeiten
Templates erstellen, duplizieren, umsortieren, bearbeiten und löschen. Plus die Bedeutung jedes einzelnen Feldes.
Templates sind das Herzstück der Erweiterung. Jedes Template ist ein Textbaustein (oder Rich Content), den du ticketübergreifend wiederverwenden kannst. Dieses Kapitel behandelt alles, was du damit tun kannst.
Aufbau eines Templates
Jedes Template hat folgende Felder:
| Feld | Bedeutung |
|---|---|
| Name | Das Label, das in Dropdowns, Buttons und im Kontextmenü angezeigt wird. Halte es kurz. |
| Issue-Typ | Der Jira-Issue-Typ oder Azure-DevOps-Work-Item-Typ, auf den das Template abzielt (z. B. Bug, Story, Task). Wird für die Autofill-Zuordnung verwendet. |
| Projekte | Kommaseparierte Projektschlüssel (z. B. ABC, BCS). Leer lassen, damit das Template für jedes Projekt gilt. |
| Plattform | Eine von: Alle, Jira Server, Jira Cloud, Azure DevOps. Ermöglicht plattformspezifische Templates. |
| Zielfeld (nur Azure DevOps) | Das Work-Item-Feld, in das eingefügt wird. Ein Dropdown bietet bekannte Felder (Description, Repro Steps, Acceptance Criteria, System Info) sowie eine Custom-Option für beliebige Felder, die per aria-label zugeordnet werden. Siehe Azure DevOps. |
| Format (nur Azure DevOps) | Markdown oder HTML. Bestimmt, welcher Editor auf der Optionsseite geöffnet wird und wie der Inhalt gespeichert wird. Die Erweiterung konvertiert beim Einfügen automatisch zwischen den Formaten. Siehe Azure DevOps. |
| Inhalt | Der eigentliche Template-Text (Rich Text + Tabellen oder Wiki-Markup). |
| Schnellzugriff-Optionen | Ob das Template im Dropdown / in der Button-Leiste / im Kontextmenü erscheint. |
Templates erstellen
Drei Wege:
- Neues Template hinzufügen am Ende der Liste — starte mit einem leeren Template.
- Duplizieren eines vorhandenen Templates — klicke auf das Kopier-Symbol auf einer Karte. Nützlich, um ein bestehendes Template als Ausgangspunkt zu verwenden.
- Importieren aus einer JSON-Datei oder einer geteilten URL — siehe Import / Export.
Der Editor
Klicke auf eine beliebige Template-Karte (Name oder Badges-Bereich), um sie zur Bearbeitung zu öffnen. Alternativ kannst du das Stift-Symbol in der Aktionsleiste der Karte verwenden.
Der Editor ist aufgeteilt in Name und Metadaten oben sowie einen Rich-Text-Bereich darunter.
Die Editor-Komponente hängt von Plattform und Format ab:
- Jira Cloud / ADO (HTML) — der TipTap-Rich-Text-Editor mit Tabellen, Links, Überschriften, Listen und Formatierungen.
- Jira Server — wechsle in den Wiki-Modus, um Legacy-Wiki-Markup direkt zu verfassen. Im rechten Bereich wird eine Live-HTML-Vorschau angezeigt, die gängige Makros wie
{panel},{code},{quote}und{noformat}unterstützt. - ADO (Markdown) — ein dedizierter Markdown-Editor mit einer Formatierungsleiste (Fett, Kursiv, Überschriften, Listen, Code, Links) und einem Bearbeiten/Vorschau-Schalter.
Hinweis: Alle drei Editoren zeigen eine ungefähre Darstellung. Die Ausgabe im Live-System (Jira, Azure DevOps) kann leicht abweichen.
Umsortieren, Duplizieren, Löschen
- Nach oben / Nach unten-Buttons sortieren Templates innerhalb ihres Projekt-Tabs um. Die Reihenfolge ist wichtig, da Autofill den ersten Treffer verwendet, wenn mehrere Templates passen.
- Duplizieren kopiert das gesamte Template (einschließlich Inhalt und Schnellzugriff-Optionen) unter einem neuen Namen mit dem Zusatz ” (Kopie)”.
- Löschen entfernt das Template. Ein Rückgängig-Toast erscheint für ca. 10 Sekunden — klicke darauf, um das Template wiederherzustellen.
Suche
Die Suchleiste über der Liste filtert Templates nach Name, Inhalt und Issue-Typ. Die Suche durchsucht alle Projekt-Tabs gleichzeitig.
Projekt-Tabs
Ein Alle-Tab wird immer zuerst angezeigt und listet jedes Template auf — einschließlich der universellen (bei denen das Projekte-Feld leer ist). Darüber hinaus wird jeder eindeutige Projektschlüssel aus deinen Templates zu einem eigenen Tab.
Beim Klick auf einen Projekt-Tab wird die Liste auf Templates gefiltert, die explizit dieses Projekt als Ziel haben. Universelle Templates erscheinen nur unter Alle, nicht unter jedem einzelnen Projekt-Tab. So bleiben die Projekt-Tabs auf projektspezifische Anpassungen fokussiert, anstatt überall die universellen Templates zu wiederholen.
Speichern
Das Speichern erfolgt automatisch mit einer Verzögerung von 250 ms — es gibt keinen Speichern-Button. Ein kleiner Toast erscheint unten rechts nach jedem erfolgreichen Speichervorgang.
Du kannst das Speichern mit Strg+S (Cmd+S auf macOS) erzwingen. Das ist nützlich, wenn du eine explizite Bestätigung möchtest, dass die letzte Änderung gespeichert wurde.
Rückgängig
Die Erweiterung hält die letzten 20 Snapshots deiner Template-Liste im Speicher. Strg+Z macht die letzte destruktive Änderung rückgängig (Löschen, Umsortieren, Bearbeiten). Nutze es bedenkenlos — das Speichern läuft weiterhin, aber der vorherige Zustand kann wiederhergestellt werden.
Tipp: Rückgängig deckt nur Änderungen an der Template-Liste ab. Änderungen an den Einstellungen können nicht über die Tastatur rückgängig gemacht werden, aber du kannst sie manuell zurückändern.