Jira Cloud

Jira Cloud verwendet ProseMirror als Rich-Text-Editor — eine andere Technologie als der ältere Editor von Jira Server. Die Erweiterung behandelt Cloud anders, um dem Rechnung zu tragen.

Domain-Erkennung

Die Erweiterung verwendet einen zweistufigen Ansatz, um Jira Cloud zu erkennen:

1. URL-Prüfung — wenn der Hostname atlassian.net enthält, wird er sofort als Cloud behandelt.
2. API-Probe — bei benutzerdefinierten Domains (z. B. jira.yourcompany.com) ruft die Erweiterung /rest/api/latest/serverInfo auf und prüft, ob deploymentType den Wert "Cloud" hat.

In beiden Fällen wird das Ergebnis pro Hostname in chrome.storage.local zwischengespeichert, sodass nachfolgende Besuche den Erkennungsschritt vollständig überspringen. Das bedeutet, dass benutzerdefinierte Cloud-Domains sofort funktionieren — solange die Domain in Ihren erlaubten Domains enthalten ist.

Wo die Benutzeroberfläche erscheint

Die gleichen drei Einfügepunkte sind verfügbar — Toolbar-Buttons, Dropdown und Rechtsklick-Menü — sie werden jedoch erst injiziert, nachdem ProseMirror das Rendering abgeschlossen hat. Beim ersten Besuch eines Tickets kann es zu einer kurzen Verzögerung von 100–200 ms kommen.

Wie das Einfügen funktioniert

Die Erweiterung schreibt das HTML Ihres Templates direkt in den contenteditable-Bereich von ProseMirror. ProseMirror parst und rendert das HTML dann gemäß seinem eigenen Schema. Dies ist ein robuster Ansatz — er funktioniert über Jira-Cloud-Updates hinweg, ohne auf interne Atlassian-APIs angewiesen zu sein — bedeutet aber, dass ProseMirror entscheidet, was beibehalten und was verworfen wird.

Die gängigsten Formatierungen überstehen den Roundtrip problemlos:

• Überschriften (H1 → H6)
• Fett, kursiv, unterstrichen, durchgestrichen
• Aufzählungs- und nummerierte Listen
• Tabellen
• Links
• Codeblöcke

Cloud-exklusive Templates

Sie können ein Template so konfigurieren, dass es nur in Jira Cloud angezeigt wird, indem Sie dessen Plattform im Editor auf „Jira Cloud” setzen. Dies ist nützlich, wenn Sie Markup haben, das nur in Cloud sinnvoll ist (z. B. bestimmte benutzerdefinierte Felder).

Kommentare und Detailansicht-Popups

Cloud rendert Kommentarfelder und Popup-Detailansichten als separate ProseMirror-Instanzen. Die Erweiterung injiziert in alle davon — Kommentar-Templates müssen jedoch den Vorgangstyp Comment haben, damit die automatische Zuordnung funktioniert.

Unterschiede im Editor, die Sie kennen sollten

Der Template-Editor auf der Optionsseite zeigt eine ungefähre Vorschau — die tatsächliche Darstellung in Jira Cloud kann leicht abweichen.

Der Template-Editor (TipTap) und der Editor von Jira Cloud (ProseMirror) sind beide Rich-Text-Editoren, unterstützen aber nicht exakt denselben Funktionsumfang. Inhalte, die in einem Editor gut aussehen, können im anderen anders dargestellt werden — oder gar nicht. Dies liegt in der unterschiedlichen HTML-Verarbeitung beider Editoren begründet und lässt sich nicht vollständig vermeiden.

Was zuverlässig funktioniert: Überschriften, Fett/Kursiv/Unterstrichen, Listen, Tabellen, Links und Codeblöcke. Darüber hinaus sollten Sie folgende Unterschiede beachten:

• Jira Cloud Emoticon-Bilder (die eingebauten Emojis aus Jiras Auswahl) bleiben erhalten, wenn sie in den Template-Editor eingefügt werden. Benutzerdefinierte Emoji-Bilder aus anderen Quellen überstehen den Roundtrip möglicherweise nicht.
• Atlassian Smart Links in Templates werden beim Einfügen zu einfachen Links umgewandelt.
• @-Erwähnungen sind Jira-interne Objekte und können in einem Template nicht abgebildet werden.
• Medienanhänge (in Jira hochgeladene Bilder) werden in Templates nicht unterstützt.

Tipp: Wenn nach dem Einfügen eines Templates etwas nicht richtig aussieht, vereinfachen Sie die Formatierung. Beschränken Sie sich auf die oben genannten Grundlagen, und das Ergebnis wird in beiden Editoren konsistent sein.