Azure DevOps
Azure DevOps-Unterstützung — Arbeitselementtypen, Zielfelder und die Unterschiede zu Jira.
Die Azure DevOps-Unterstützung ist vollständig integriert. Dasselbe Template-Modell wie bei Jira kommt zum Einsatz, mit einigen zusätzlichen Steuerungsmöglichkeiten für ADO-spezifische Features wie Zielfeld-Auswahl und Editor-Format.
Arbeitselementtypen
Azure DevOps verwendet Arbeitselementtypen (Work Item Types) anstelle von Jira-Vorgangstypen. Die Standardtypen sind User Story, Bug, Task, Epic, Feature und Issue — in realen Instanzen sind jedoch benutzerdefinierte Typen weit verbreitet.
Im Template-Editor wird das Feld Vorgangstyp zu Arbeitselementtyp, wenn Sie die Plattform auf „Azure DevOps” setzen.
Zielfeld
Anders als bei Jira haben Azure DevOps-Arbeitselemente mehrere Langtextfelder, nicht nur eine einzelne Beschreibung. Der Template-Editor zeigt ein Zielfeld-Dropdown mit bekannten Feldern:
- Description — die Standard-Beschreibung des Arbeitselements.
- Repro Steps — nur bei Bug-Arbeitselementen.
- Acceptance Criteria — User Story, Feature, Epic.
- System Info — System-/Umgebungsinformationen.
Ein gängiges Muster: Erstellen Sie ein Bug-Template, das auf Repro Steps abzielt, und ein separates User-Story-Template, das auf Acceptance Criteria abzielt.
Benutzerdefinierte Felder
Das Dropdown bietet auch eine Custom-Option. Wähle sie aus und gib das aria-label eines beliebigen Editor-Feldes im Work-Item-Formular ein. Die Erweiterung ordnet Zielfelder über das aria-label-Attribut zu, sodass jedes Textfeld, das ADO rendert — einschließlich Felder aus benutzerdefinierten Prozessvorlagen — als Ziel verwendet werden kann.
Tipp: Um das aria-label eines Feldes zu finden, klicke mit der rechten Maustaste auf den Editor in Azure DevOps, wähle Untersuchen und suche das
aria-label-Attribut am<div contenteditable>oder<textarea>-Element.
Format
Jedes Azure DevOps-Template hat einen Format-Schalter, der festlegt, wie der Template-Inhalt gespeichert und verfasst wird:
- Markdown (Standard für neue ADO-Templates) — öffnet einen dedizierten Markdown-Editor auf der Optionsseite mit einer Formatierungsleiste (Fett, Kursiv, Überschriften, Listen, Code, Links) und einem Live-Vorschau-Tab.
- HTML — verwendet denselben Rich-Text-Editor (TipTap) wie Jira-Cloud-Templates.
Das auf der Optionsseite gewählte Format muss nicht mit dem Editor-Typ auf der Live-Azure-DevOps-Seite übereinstimmen. Die Erweiterung konvertiert automatisch beim Einfügen:
- Markdown-Template → RoosterJS-Editor: wird über
markdownToHtml()in HTML umgewandelt. - HTML-Template → Markdown-Textbereich: wird über
htmlToMarkdown()in Markdown umgewandelt. - Übereinstimmende Formate: werden unverändert eingefügt.
Das bedeutet, du kannst in dem Format verfassen, das dir am besten liegt — der Inhalt wird korrekt dargestellt, unabhängig davon, welchen Editor ADO anzeigt.
Zwei Editoren in Azure DevOps
Azure DevOps-Seiten können je nach Projekteinstellungen und Feldkonfiguration zwei verschiedene Editor-Typen anzeigen:
- RoosterJS — ein von Microsoft gepflegter Rich-Text-Editor (
contenteditable). Dies ist der traditionelle Standard. - Markdown-Textbereich — ein einfaches
<textarea>für GitHub-Flavored Markdown, das verwendet wird, wenn ein Projekt oder Feld für Markdown-Rendering konfiguriert ist.
Die Erweiterung erkennt beide Editor-Typen automatisch und fügt Templates in den jeweils vorhandenen ein. Schnellzugriff-Buttons und Dropdowns werden in die passende Symbolleiste platziert (die RoosterJS-Befehlsleiste oder die Markdown-Symbolleiste).
Projektschlüssel
Azure DevOps-„Projekte” lassen sich direkt auf das projects-Feld der Erweiterung übertragen. Verwenden Sie den Projektnamen so, wie er in der URL erscheint, z. B. MyTeamProject.
DOM-Kontexte
Azure DevOps rendert dasselbe Formular in drei verschiedenen Containern:
- Ganzseitige Arbeitselementansicht — unter
/_workitems/edit/<id> - Seitenpanel — am häufigsten beim Erstellen
- Modales Overlay — Schnellerstellung
Der Adapter der Erweiterung handhabt alle drei, indem er auf aria-label-Attribute (z. B. aria-label="Description") selektiert, anstatt sich auf Container-Klassen zu verlassen.
Bekannte Einschränkungen
- Boards- / Sprint-Planungsansichten werden nicht unterstützt — Templates erscheinen nur im Arbeitselementformular.