Test und Problembehebung - Jira Cloud
Die Integration testen
Nimm einen Fehler mit geringer Bedeutung aus einem Testprojekt und erstelle daraus ein Ticket. Prüfe in Jira den Vorgangstyp (er sollte nahe an „Bug" liegen, nicht Epic oder Subtask sein), den Inhalt der Beschreibung sowie, ob Zuweisung und Startstatus mit der Projektkonfiguration übereinstimmen. Um die Rücksynchronisation zu prüfen, schalte dieses Ticket in Jira von Hand auf einen Status der Kategorie Done und warte bis zu fünf Minuten - der Fehlerstatus in DockRay sollte ohne dein Zutun auf gelöst wechseln.
Typische Probleme
Das Ticket bekommt einen unerwarteten Vorgangstyp
DockRay muss den Typ „Fehler" unabhängig von der Sprache Jiras erkennen - Jira Cloud übersetzt Typnamen in die Sprache des Kontos, und die Typliste beginnt mit dem Epic. Deshalb verwirft die Integration zuerst Subtasks und alles auf Epic- oder Initiative-Ebene und sucht erst danach unter dem Übrigbleibenden nach einem Namen nahe „Bug", dann nach „Task". Hat das Vorgangstyp-Schema eines Jira-Projekts keins von beiden, wird das Ticket trotzdem kein Epic - es bekommt den ersten verfügbaren Typ auf normaler Arbeitsebene, manchmal etwas wie „Story". Lösung: dem Jira-Projekt einen zum Fehler passenden Vorgangstyp hinzufügen.
Der Jira-Projektschlüssel wird abgelehnt
Der Schlüssel muss mit einem Großbuchstaben beginnen und darf nur aus Großbuchstaben, Ziffern und Unterstrich bestehen. Ein Schlüssel in Kleinbuchstaben oder mit Leerzeichen, Bindestrich oder anderem Sonderzeichen wird abgelehnt - das ist keine übereifrige Validierung, sondern Schutz davor, die Anfrage aus dem vorgesehenen API-Endpunkt hinauszuführen.
Der Fehlerstatus kehrt nicht sofort ins Panel zurück
So ist es gedacht. Die Statussynchronisation ist periodisch, nicht sofort - dynamische Webhooks von Jira Cloud erfordern eine registrierte OAuth-/Connect-App, die sich nicht allein mit dem API-Token des Kunden einrichten lässt. Der Befehl thor:sync-jira fragt verknüpfte Tickets alle fünf Minuten ab, eine Verzögerung von bis zu fünf Minuten ist also normal, keine Störung.
Die Verbindung endet mit einem Authentifizierungsfehler
Prüfe, ob E-Mail-Adresse und API-Token zum selben Atlassian-Konto gehören, ob das Token in den Atlassian-Einstellungen widerrufen wurde und ob die Instanzadresse wirklich in der Domain *.atlassian.net liegt - jede andere Adresse weist die Integration ab, bevor sie überhaupt einen Verbindungsversuch unternimmt.
Die Integration funktioniert nach einer Änderung der Projekteinstellungen nicht mehr
Das passiert nach dem Umschalten eines Projekts von eigenen Zugangsdaten auf die Vererbung vom Konto, wenn in der Zwischenzeit auch die Verbindung auf Kontoebene verschwunden ist. Prüfe beide Ebenen nacheinander: die Projektkonfiguration und die Kontokonfiguration - ein Projekt ohne beide hat keine Quelle für Zugangsdaten.
Es funktioniert weiterhin nicht
Arbeite die Checkliste zur Fehlerbehebung durch, und wenn das nicht hilft, schreib uns. Nenne den Projektnamen, die Version der Integration und ungefähr die Uhrzeit des Tests: das verkürzt den Weg zur Antwort.