Jira — Projekt verknüpfen und Zeit tracken

Verknüpfe ein docket-Projekt mit einem Jira-Projekt, lege fest, wo die Zeit liegt, und überleg es dir sicher noch einmal anders.

Sobald die Verbindung eingerichtet ist, verknüpft ein Project Manager jedes docket-Projekt mit seinem Jira-Gegenstück.

Das Projekt verknüpfen

Öffne das Projekt, gehe zu Settings und such das Jira-Panel.
Wähle die connection (die Jira-Site).
Suche das Jira project, das du spiegeln willst, und wähle es aus.
Klicke auf Link project.

docket importiert nun die Issues des Projekts im Hintergrund (bei großen Projekten kann das einen Moment dauern). Danach gilt:

Der Tickets-Tab zeigt die Jira-Issues (schreibgeschützt, mit ihrem Jira-Key).
Die Tabs Boards und Roadmap verschwinden — diese Planung liegt jetzt in Jira.

Time-Sync-Einstellungen (festlegen, wo die Zeit liegt)

Wenn du ein Projekt verknüpfst — und jederzeit danach unter Project → Settings → Jira — steuerst du diese Schalter:

Push time booked in docket to Jira (standardmäßig an). Diese Einstellung entscheidet, ob die Zeit auch in Jira landet. Schaltest du sie aus, bleibt die Zeit, die du in docket auf diesen Tickets trackst, nur in docket — nichts wird ins Jira-Worklog geschrieben. Schaltest du sie an, wird jede Buchung auf das passende Jira-Issue übertragen (als die Person, die gebucht hat).
Show time logged directly in Jira (standardmäßig an) — holt Worklogs, die in Jira erfasst wurden, schreibgeschützt nach docket und zeigt sie als eigene Übersicht („Time logged in Jira“) unter Project → Controlling → Timetrackings: wer wie viel gebucht hat, bei zugeordneten Nutzern mit Umsatz. Diese Zeit zählt nicht in Budgets, Reports, Umsatz oder Rechnungen – sie dient zur Orientierung.
Turn it into real docket time entries for mapped users (standardmäßig aus, nur sichtbar, solange der Schalter darüber an ist) — für Teammitglieder, deren Jira-Account einem docket-User zugeordnet ist und die einen Service hinterlegt haben, werden neu importierte Jira-Worklogs zu echten docket-Zeiteinträgen: Sie zählen in Budgets, Reports und Umsatz genau so, als wären sie in docket gebucht worden, bewertet mit dem Service des Users und auf 15-Minuten-Schritte gerundet. Zeit von nicht zugeordneten Personen bleibt schreibgeschützt. Nach der Umwandlung ist docket die Source of Truth — bearbeite oder lösche den Eintrag in docket, nicht in Jira (ein Löschen in Jira entfernt den umgewandelten Eintrag in docket, Änderungen in Jira werden aber ignoriert). Der Schalter betrifft nur Zeit, die nach dem Aktivieren importiert wird.

Also ja: Du kannst in docket auf Jira-Tickets Zeit tracken, ohne dass sie in Jira auftaucht — lass einfach „Push time booked in docket to Jira“ ausgeschaltet.

Einstellungen später ändern

Du kannst jeden der beiden Schalter jederzeit unter Project → Settings → Jira umlegen. Das passiert dann:

Push ausschalten: Künftige Buchungen werden nicht mehr nach Jira synchronisiert. Zeit, die du schon übertragen hast, bleibt in Jira — Ausschalten löscht sie nicht rückwirkend (dafür gibt es „Remove docket time from Jira“, siehe unten).
Push einschalten: Neue Buchungen werden ab dann automatisch synchronisiert. Um auch frühere docket-Einträge zu senden, die nie übertragen wurden, klicke auf „Sync existing docket time to Jira now“ — das ist ein vollständiger Abgleich, der jeden docket-Eintrag dieses Projekts überträgt, der noch nicht in Jira ist.
„Remove docket time from Jira“ (nur für Admins): Löscht jedes Worklog, das docket für dieses Projekt nach Jira übertragen hat. Deine docket-Zeiteinträge bleiben unberührt — nur die Kopien in Jira werden entfernt. Nutze das, wenn du dich entscheidest, dass die Zeit doch nicht in Jira liegen soll.
- Hinweis zu Core-Jira: docket kann ein Worklog nur als dessen ursprünglicher Autor löschen. Einträge von Personen, die keinen verbundenen Jira-Token mehr haben, lassen sich daher nicht automatisch entfernen und werden stattdessen markiert. (Bei Tempo gilt diese Einschränkung nicht — das Entfernen klappt für alle über den Tempo-Token der Verbindung.)

Tempo verhält sich bei allem oben Genannten wie Core-Jira (Push, Catch-up-Sync und Entfernen).

Tägliche Nutzung

Ein Jira-Ticket finden: Öffne den Tickets-Tab des Projekts oder wähle es in der Ticket-Auswahl der Zeiterfassung aus (such nach seinem Jira-Key).
Zeit buchen: Tracke Zeit genau so wie auf jedem docket-Ticket.
Den Sync prüfen: Jeder Zeiteintrag auf einem Jira-Ticket zeigt ein kleines Badge —
- Synced to Jira ✓ — erfolgreich übertragen.
- Syncing… — läuft gerade.
- Jira sync failed — klicke auf Retry (siehe Troubleshooting).
- Not in Jira — connect your Jira account — du hast deinen Jira-Account noch nicht verbunden; mach Teil 2 der Einrichtung und klicke dann auf Retry.
In Jira öffnen: Klicke auf das Jira-Key-Badge eines gespiegelten Tickets, um direkt zum Issue zu springen.

Zuweisungen, Status, Fälligkeitsdaten und Prioritäten kommen immer aus Jira — änderst du sie in Jira, werden sie beim nächsten Sync (nach ein paar Minuten) in docket aktualisiert. Ein gespiegeltes Ticket kannst du in docket nicht bearbeiten; du kannst nur Zeit darauf buchen.

Ein Projekt auf Jira umstellen, nachdem du schon Zeit getrackt hast

Kommt oft vor: Ein Projekt läuft eine Weile als normales docket-Projekt — du hast Tickets angelegt und Zeit darauf gebucht — und dann entscheidest du dich, es mit Jira zu verknüpfen. Nichts geht verloren, und nichts wird überschrieben. So läuft es genau ab:

Deine bestehenden docket-Tickets und die gesamte darauf getrackte Zeit bleiben erhalten. Das Verknüpfen fügt die importierten Jira-Issues nur als neue Tickets hinzu; deine ursprünglichen docket-Tickets werden weder angefasst noch gelöscht.
Das Projekt enthält dann beides: deine alten docket-Tickets und die importierten Jira-Tickets, nebeneinander. Neue Arbeit wird auf den Jira-Tickets getrackt.
Weil der Tickets-Tab jetzt Jira öffnet, durchstöberst du die alten docket-Tickets in diesem Tab nicht mehr. Sie sind aber weiterhin vollständig im Projekt: Ihre Zeit zählt weiter im Budget, Controlling und in den Reports, und du kannst sie in der Zeiterfassung weiterhin über Name/Nummer auswählen, um diese Einträge anzusehen oder zu bearbeiten.
Die Zeit, die du auf den alten docket-Tickets gebucht hast, wird nicht nach Jira gesendet — diese Tickets haben kein Jira-Gegenstück, es gibt also nichts, wohin man sie übertragen könnte. Nur Zeit auf den importierten Jira-Tickets wird synchronisiert. (Der Button „Sync existing docket time to Jira“ erfasst ebenfalls nur die Jira-Tickets.)
Anders überlegt? Unlink das Projekt (Project → Settings → Jira → Unlink): Die Tabs Tickets, Boards und Roadmap kommen zurück. Gespiegelte Jira-Tickets mit gebuchter Zeit bleiben bestehen (mit unveränderter Zeit); gespiegelte Tickets, auf die du nie etwas gebucht hast, werden wieder entfernt — sie existierten nur wegen der Verknüpfung.

Kurz: Mitten im Projekt umzustellen ist sicher. Deine Historie bleibt für Reportings in docket; ab dem Umstieg wird neue Zeit auf Jira-Tickets getrackt.

Falsches Jira-Projekt verknüpft — oder Wechsel auf ein anderes

Es gibt bewusst keinen „Projekt ändern“-Button: Du machst Unlink und verknüpfst dann das richtige Projekt. docket ist so gebaut, dass das in beide Richtungen sicher ist:

Wenn du es sofort bemerkst (noch keine Zeit gebucht): Mach einfach Unlink. Alle importierten Tickets sind leer und werden daher automatisch wieder entfernt — das Projekt ist genau wie vorher, und du kannst sofort das richtige Jira-Projekt verknüpfen.

Wenn auf den Tickets des falschen Projekts schon Zeit gebucht wurde: Mach Unlink und verknüpfe das richtige Projekt. Dann gilt:

Tickets mit gebuchter Zeit bleiben in docket — Stunden, Budget und Controlling ändern sich nicht. Sie werden vom täglichen Check geschlossen (und verlassen so die Workload-Ansicht) und werden zu eingefrorener Historie.
Neue Zeit, die auf diesen alten Tickets gebucht wird, bleibt nur in docket — sie wird nie in das zuvor verknüpfte Jira-Projekt übertragen.
Zeit, die du auf den Tickets des neuen Projekts haben willst: Verschiebe sie. Gehe zu Timetracking → Reports, wähle die Einträge aus und ändere mit Move Projekt und Ticket. Die Jira-Seite zieht automatisch nach: Das Worklog wird am alten Jira-Issue entfernt und — wenn Push an ist — am neuen angelegt.
Worklogs, die docket bereits ins falsche Jira-Projekt übertragen hat, verschwinden nicht von selbst. Wenn sie dort nicht bleiben sollen, klicke auf „Remove docket time from Jira“, bevor du Unlink machst — nach dem Unlink kann docket dieses Jira-Projekt nicht mehr aufräumen.

Tickets, die in einem anderen Projekt „festhängen“: Wenn das Jira-Projekt, das du verknüpfst, bereits in einem anderen docket-Projekt mit gebuchter Zeit gespiegelt wird (zum Beispiel nach dem Umzug einer Jira-Integration von einem docket-Projekt in ein anderes), zeigt docket eine Warnung — sowohl beim Auswählen des Projekts als auch danach im Settings-Panel. Diese Tickets werden nie automatisch verschoben, weil sonst ihre Stunden und ihr Umsatz unbemerkt das Projekt wechseln würden. Verschiebe ihre Zeiteinträge über Timetracking → Reports → Move (oder lass sie, wo sie sind); Tickets ohne verbleibende Zeit wechseln danach innerhalb eines Tages automatisch ins neu verknüpfte Projekt.

Weiter geht's: wie sich der Sync verhält und was du tust, wenn etwas komisch aussieht.