Jira — Sync-Verhalten & Troubleshooting

Wie oft docket synchronisiert, warum Zeit nicht doppelt übertragen werden kann, wie Issue-Typen und Status behandelt werden und was du tust, wenn etwas komisch aussieht.

Was docket von allein tut, sobald ein Projekt verknüpft ist — und was du prüfen solltest, wenn ein Ticket oder ein Zeiteintrag nicht stimmt.

Wie oft synchronisiert docket mit Jira?

docket hält sich selbst aktuell, indem es Jira nach Zeitplan abfragt (es verlässt sich nicht darauf, dass Jira Bescheid gibt):

Was	Wie oft
Neue & geänderte Jira-Tickets (Titel, Status, Assignee, Fälligkeitsdatum, Priorität)	ca. alle 5 Minuten
Direkt in Jira erfasste Zeit (wird nach docket importiert)	ca. alle 5 Minuten
Gelöschte oder aus dem Jira-Projekt verschobene Tickets	einmal pro Tag (sie werden dann in docket geschlossen, getrackte Zeit bleibt erhalten)
Erstimport beim Verknüpfen eines Projekts	sofort im Hintergrund (bei großen Projekten kann es etwas dauern)

Das Übertragen deiner docket-Zeit nach Jira folgt nicht diesem Zeitplan — es passiert sofort. In dem Moment, in dem du einen Zeiteintrag auf einem Jira-Ticket speicherst, bearbeitest oder löschst, synchronisiert docket diese einzelne Änderung direkt ins Jira-Worklog (und versucht es automatisch erneut, falls Jira kurz nicht erreichbar ist).

Also: Daten zum Stöbern (Tickets, Zuweisungen, Zeit auf Jira-Seite) aktualisieren sich innerhalb weniger Minuten; deine eigenen Zeitbuchungen erscheinen fast sofort in Jira.

Kann ich versehentlich dieselbe Zeit doppelt übertragen?

Nein. Jeder docket-Zeiteintrag ist über eine gespeicherte ID mit genau einem Jira-Worklog gekoppelt:

Beim ersten Übertragen eines Eintrags legt docket ein Worklog in Jira an und merkt sich dessen ID.
Jede weitere Übertragung (du bearbeitest den Eintrag, du klickst auf „Sync existing docket time to Jira now“, du klickst zweimal, ein automatischer Retry läuft) aktualisiert dasselbe Worklog — es entsteht nie ein zweites. Den Sync-Button mehrfach zu drücken ist unbedenklich.

Wenn du einen Zeiteintrag in docket bearbeitest: Die Änderung wird ins selbe Jira-Worklog übertragen (aktualisiert, nicht dupliziert). Löschst du ihn in docket, wird auch das Worklog in Jira gelöscht.

Wenn du ein von docket übertragenes Worklog direkt in Jira bearbeitest: docket übernimmt diese Änderung nicht zurück — bei in docket gebuchter Zeit ist docket die Source of Truth, und deine nächste Bearbeitung in docket würde die Jira-Seite wieder überschreiben. (Zeit, die nur in Jira erfasst wurde, ist anders: docket importiert sie schreibgeschützt, und Änderungen daran in Jira aktualisieren sehr wohl, was docket anzeigt.)

Wie erscheinen Epics, Stories und Sub-Tasks?

Alle auf einer flachen Ebene, jeweils als einzelnes docket-Ticket. Jedes Jira-Issue im verknüpften Projekt — Epic, Story, Task, Bug oder Sub-Task — wird als ein gewöhnliches docket-Ticket gespiegelt. docket bildet die Hierarchie von Jira nicht nach: Es gibt keine Parent-/Child-Verschachtelung, keine Epic-Gruppierung, und der Jira-Issue-Typ wird in docket nicht angezeigt. Unterscheide sie über den Jira-Key (z. B. ABC-123) und öffne das Ticket in Jira, wenn du seinen Typ, Parent oder Epic brauchst. (Planung und Struktur liegen in Jira — docket braucht jedes Issue nur als etwas, worauf du Zeit buchen und wozu du Reports erstellen kannst.)

Und was ist mit offenen und geschlossenen (erledigten) Issues?

Jira bestimmt den Status, docket folgt. Ein gespiegeltes Ticket ist:

in docket geschlossen, wenn sein Jira-Issue in einer Done-Statuskategorie ist, und
offen bei allem anderen (To Do, In Progress und jeder andere nicht erledigte Status).

Da Jira bei verknüpften Projekten die Source of Truth ist, gilt das nur in eine Richtung: Schließt oder öffnest du ein Issue in Jira wieder, zieht das docket-Ticket beim nächsten Sync nach (innerhalb weniger Minuten). Den Status setzt du nicht in docket — gespiegelte Tickets sind dort schreibgeschützt.

Ein paar praktische Hinweise:

Offene und geschlossene Issues werden importiert. Der erste Sync holt das ganze Jira-Projekt, bereits erledigte Issues kommen also auch als geschlossene Tickets an — nützlich, denn Zeit, die darauf erfasst wurde, bleibt in den Reports von docket sichtbar.
Geschlossene Issues bleiben aus der Workload-Ansicht draußen. Die Workload-Heatmap und die Zahlen zu „assigned tickets“ zählen nur offene Tickets, damit erledigte Arbeit sie nicht zumüllt.
Auf ein geschlossenes Ticket kannst du weiterhin Zeit buchen — z. B. wenn du Zeit erst nach dem Schließen eines Issues erfasst. Es bleibt in der Zeiterfassung auswählbar, und das Schließen eines Issues entfernt dessen getrackte Zeit nie aus Budget, Controlling oder Reports von docket.
Ein Issue, das aus dem Jira-Projekt gelöscht oder herausverschoben wird (nicht nur geschlossen), wird vom täglichen Check erkannt und in docket geschlossen — wieder mit erhaltener Zeit.

Troubleshooting

Symptom	Was es bedeutet / was zu tun ist
Verbindung zeigt auth failed	E-Mail/Token des Service-Accounts sind falsch oder haben keinen Zugriff mehr. Admin: Verbindung mit Edit bearbeiten, Token neu eingeben und erneut Test ausführen.
Ein Zeiteintrag zeigt Not in Jira — connect your Jira account	Du hast deinen Jira-Account nicht verbunden. Der Link führt zu deinen Einstellungen; siehe Teil 2 der Einrichtung. Sobald du verbunden bist, gehen deine wartenden Einträge von selbst nach Jira.
Ein Zeiteintrag zeigt Not in Jira — your Jira account isn't mapped yet	Die Verbindung bucht über Tempo, das Zeit für dich bucht – deshalb muss ein Admin deinen Jira-Account zuordnen (Administration → Integrations → die Verbindung → User mapping). Danach gehen die wartenden Einträge von selbst nach Jira.
Ein Zeiteintrag zeigt Jira sync failed	Meist ein vorübergehender Jira-Aussetzer oder eine geänderte Berechtigung. Klicke auf Retry. Schlägt es weiter fehl, prüfe in deinen Profileinstellungen, ob deine Jira-Verbindung für diese Site noch ✓ zeigt und ob du in Jira Zugriff auf dieses Projekt hast.
Mein Token zeigt ✗ bei einer Site	Dein Atlassian-Account kommt an diese Site nicht heran, oder du nutzt dort einen anderen Account. Hinterlege einen Token, der auf diese Verbindung beschränkt ist, oder bitte den Admin, Zugriff zu gewähren.
Ein Jira-Ticket erscheint nicht in docket	Neue Issues werden innerhalb weniger Minuten synchronisiert. Erscheint es nie, prüfe, ob das Issue im verknüpften Jira-Projekt liegt und das Verbindungs-Badge grün ist.
Ein verknüpftes Projekt zeigt gar keine Jira-Tickets	Der Jira-Account, mit dem die Verbindung arbeitet, darf die Issues des Projekts nicht sehen – Jira antwortet dann mit einer leeren Liste statt mit einem Fehler. Unter Project → Settings → Jira steht das rot. Füge den Account in Jira dem Projekt hinzu (Project settings → Access, z. B. bei team-managed Projekten) oder gib ihm die Berechtigung Browse projects; die Tickets kommen mit dem nächsten Sync, innerhalb weniger Minuten – oder sofort mit Sync tickets from Jira now auf dieser Einstellungsseite.
Die Tabs Boards / Roadmap sind verschwunden	Gewollt — das Projekt ist mit Jira verknüpft, die Planung läuft also in Jira. Mach Unlink beim Projekt (Project → Settings → Jira → Unlink), um sie zurückzubekommen.
Ich habe ein Projekt entknüpft — sind Daten verloren?	Nein. Gespiegelte Tickets mit gebuchter Zeit und alle getrackte Zeit bleiben erhalten; nur leere gespiegelte Tickets (keine Zeit gebucht, nichts importiert) werden entfernt. Der Sync stoppt.
Ich habe die Jira-Verbindung gelöscht — sind Daten verloren?	Nein. Jedes verknüpfte Projekt wird auf dieselbe Weise entknüpft, und die aus Jira importierten Stunden bleiben im Controlling. Verbinde dieselbe Jira-Site erneut, dann werden sie übernommen, statt doppelt importiert zu werden.
Ich habe das falsche Jira-Projekt verknüpft	Mach Unlink und verknüpfe das richtige — leere importierte Tickets werden automatisch aufgeräumt. Wurde schon Zeit gebucht, siehe falsches Jira-Projekt verknüpft.
Ein Zeiteintrag wurde auf das falsche Projekt/Ticket gebucht	Gehe zu Timetracking → Reports, wähle die Einträge aus und nutze Move. Bei Jira-gespiegelten Tickets zieht das übertragene Worklog mit um (am alten Issue entfernt, am neuen angelegt).

Gut zu wissen

Ändert das Bearbeiten eines Tickets in docket etwas in Jira? Gespiegelte Jira-Tickets sind in docket schreibgeschützt. Das Einzige, was du von docket aus hinzufügst, ist getrackte Zeit. Alles andere bearbeitest du in Jira.

Du kommst nicht weiter? Starte noch einmal beim Überblick oder wirf einen Blick in die Einrichtung der Verbindung.