Jira-Sync & Troubleshooting

Wie oft docket mit Jira synchronisiert, warum Zeit nie doppelt übertragen wird, wie Issue-Typen und Status ankommen und was tun, wenn etwas nicht stimmt.

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

Wie oft synchronisiert docket mit Jira?

docket fragt Jira nach Zeitplan ab, statt auf eine Meldung von Jira zu warten:

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 (in docket geschlossen, getrackte Zeit bleibt)
Erstimport beim Verknüpfen eines Projekts	sofort im Hintergrund (bei großen Projekten dauert es etwas)

Zeit, die du in docket buchst, geht sofort nach Jira, unabhängig von diesem Zeitplan. Sobald du einen Zeiteintrag auf einem Jira-Ticket speicherst, bearbeitest oder löschst, aktualisiert docket das Jira-Worklog direkt. Ist Jira kurz nicht erreichbar, versucht docket es automatisch erneut.

Kann ich versehentlich dieselbe Zeit doppelt übertragen?

Nein. Jeder docket-Zeiteintrag ist über eine gespeicherte ID mit genau einem Jira-Worklog verbunden. Die erste Übertragung legt das Worklog an. Jede weitere (eine Bearbeitung, Vorhandene docket-Zeit jetzt mit Jira synchronisieren, ein Doppelklick, ein automatischer Retry) aktualisiert dasselbe Worklog. Du kannst den Sync-Button also beliebig oft drücken.

Eintrag in docket bearbeiten oder löschen: Das Jira-Worklog wird mit aktualisiert bzw. gelöscht.
Von docket übertragenes Worklog in Jira bearbeiten: docket übernimmt die Änderung nicht. Für in docket gebuchte Zeit ist docket die Source of Truth, deine nächste Bearbeitung in docket überschreibt die Jira-Seite wieder.
Nur in Jira erfasste Zeit importiert docket schreibgeschützt, und Änderungen daran in Jira kommen in docket sehr wohl an.

Was ist mit Leuten, die in Jira Zeit erfassen, aber keinen docket-Account haben?

Ihre Worklogs kommen trotzdem an. Was damit passiert, hängt von der Einstellung Jira-Autoren ohne docket-Account der Verbindung ab (Administration → Integrationen → die Verbindung):

An (Standard), mit gewählter Leistung: Kommt das erste Worklog eines solchen Jira-Accounts an, legt docket einen Platzhalter-Nutzer an und bucht die Zeit darauf. Sie zählt dann in Budgets, Controlling und Reports, zum Leistungssatz des Platzhalters. Platzhalter können sich nicht anmelden, belegen keinen Sitz und stehen getrennt vom Team unter Administration → Nutzer → Jira-Platzhalter. Dort kann ein Admin:
- die Leistung ändern, zu der die Zeit eines Platzhalters abgerechnet wird (z. B. unterschiedliche Sätze für eine externe Agentur und einen Freelancer);
- Worklogs konvertieren, die importiert wurden, bevor es den Platzhalter gab (bis dahin sind sie Nur-Lese-Zeilen, und docket konvertiert sie nie von selbst);
- den Platzhalter mit einem echten Nutzer zusammenführen, sobald die Person einen docket-Account hat. Zeit, Ticket-Zuweisungen und Jira-Zuordnung wandern mit, der Platzhalter verschwindet.
Aus, oder keine Leistung gewählt: Die Worklogs bleiben Nur-Lese-Zeilen. Du siehst sie pro Autor im Controlling des Projekts unter Zeiteinträge, aber ohne Satz und außerhalb von Budgets und Reports.

Die Zeit eines Platzhalters wird nur in Projekten konvertiert, deren Verknüpfung Convert Jira worklogs aktiviert hat.

Wie erscheinen Epics, Stories und Sub-Tasks?

Jedes als eigenes docket-Ticket, Sub-Tasks unter ihrem Parent. Jedes Jira-Issue im Scope (Epic, Story, Task, Bug oder Sub-Task) wird als ein docket-Ticket gespiegelt. Zeit landet also genau dort, wo sie in Jira erfasst wurde: auf einem Sub-Task, auf seinem Parent oder auf beiden. Doppelt gezählt wird nichts.

Ein Sub-Task steht im Jira-Abschnitt des Tickets-Tabs direkt unter seinem Parent, in der Ticket-Auswahl der Zeiterfassung als ABC-12 › ABC-15. Seine Ticketseite verlinkt den Parent. Die Seite des Parents listet seine Sub-Tasks und die Zeit inkl. Sub-Tasks (die Summe, die auch Jira zeigt).
Sub-Tasks zählen nicht zu den offenen/geschlossenen Tickets eines Projekts (Punkte auf dem Dashboard, Projektliste). Ihre Zeit zählt ganz normal.
Die Ticketseite zeigt den Jira-Issue-Typ. Epics und jede Gruppierung über Parent → Sub-Task hinaus bleiben in Jira. Bei einem Epic-Scope (siehe Verknüpfung) wird das Epic selbst mitgespiegelt, damit darauf erfasste Zeit einen Platz hat.

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 bei jedem anderen Status offen. Schließt du ein Issue in Jira oder öffnest es wieder, zieht das docket-Ticket beim nächsten Sync nach (innerhalb weniger Minuten).

Gespiegelte Tickets sind in docket schreibgeschützt. Von docket aus fügst du nur getrackte Zeit hinzu; Status und alles andere bearbeitest du in Jira.

Auch geschlossene Issues werden importiert. Der erste Sync holt das ganze Jira-Projekt, erledigte Issues kommen also als geschlossene Tickets an, und die darauf erfasste Zeit bleibt in den Reports von docket sichtbar.
Die Auslastung ignoriert geschlossene Tickets. Die Heatmap und die Zahlen zu „assigned tickets“ zählen nur offene Tickets.
Auf ein geschlossenes Ticket kannst du weiter Zeit buchen. Es bleibt in der Zeiterfassung auswählbar, und das Schließen eines Issues entfernt dessen Zeit nie aus Budget, Controlling oder Reports.
Ein Issue, das aus dem Jira-Projekt gelöscht oder herausverschoben wird (nicht nur geschlossen), schließt der tägliche Check auch in docket, die Zeit bleibt erhalten.

Troubleshooting

Symptom	Was es bedeutet / was zu tun ist
Verbindung zeigt Anmeldung fehlgeschlagen	E-Mail oder Token des Service-Accounts sind falsch oder haben keinen Zugriff mehr. Ein Admin bearbeitet die Verbindung, gibt den Token neu ein und testet die Verbindung erneut.
Ein Zeiteintrag zeigt Nicht in Jira — verbinde dein Jira-Konto	Du hast deinen Jira-Account noch nicht verbunden. Der Link führt zu deinen Einstellungen (siehe Teil 2 der Einrichtung). Sobald du verbunden bist, gehen wartende Einträge von selbst nach Jira.
Ein Zeiteintrag zeigt Nicht in Jira — dein Jira-Konto ist noch nicht zugeordnet	Die Verbindung bucht über Tempo, das Zeit in deinem Namen bucht. Deshalb muss ein Admin deinen Jira-Account zuordnen (Administration → Integrationen → die Verbindung → Nutzerzuordnung). Danach gehen wartende Einträge von selbst nach Jira.
Ein Zeiteintrag zeigt Jira-Sync fehlgeschlagen	Meist ein kurzer Jira-Aussetzer oder eine geänderte Berechtigung. Klicke auf Erneut versuchen. 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 das 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 um Zugriff.
Ein Jira-Ticket erscheint nicht in docket	Neue Issues kommen innerhalb weniger Minuten an. 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 der Verbindung darf die Issues des Projekts nicht sehen, und Jira antwortet dann mit einer leeren Liste statt mit einem Fehler. Unter Projekt → Einstellungen → 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 oder sofort mit Tickets jetzt aus Jira synchronisieren auf dieser Einstellungsseite.
Die Tabs Boards / Roadmap sind verschwunden	Gewollt: Im Projekt steht der Ticketbereich auf Jira ersetzt ihn, die Planung läuft also in Jira. Stell den Ticketbereich auf Jira ergänzt ihn (Projekt → Einstellungen → Jira), um docket-eigene Tickets, Boards und Roadmap neben den Jira-Tickets zu behalten, oder heb die Verknüpfung auf (Verknüpfung lösen).
Ich habe ein Projekt entknüpft. Sind Daten verloren?	Nein. Alle getrackte Zeit und jedes gespiegelte Ticket mit gebuchter 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 genauso entknüpft, und die aus Jira importierten Stunden bleiben im Controlling. Verbindest du dieselbe Jira-Site erneut, werden sie übernommen statt doppelt importiert.
Ich habe das falsche Jira-Projekt verknüpft	Heb die Verknüpfung auf (Verknüpfung lösen) 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	Wähle unter Zeiterfassung → Berichte die Einträge aus und nutze Verschieben. Bei Jira-gespiegelten Tickets zieht das Worklog mit um (am alten Issue entfernt, am neuen angelegt).

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