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 Projektmanager jedes docket-Projekt mit seinem Jira-Projekt.

Das Projekt verknüpfen

Öffne im Projekt Einstellungen und such das Jira-Panel.
Wähle die Verbindung (die Jira-Site) und such das Jira-Projekt unter Jira-Projekte suchen.
Wähle, was gespiegelt wird:
- Das ganze Jira-Projekt: alle Issues, der Normalfall.
- Nur einige Epics: wenn ein Jira-Projekt mehrere deiner Projekte als Epics enthält. docket spiegelt die gewählten Epics mit ihren Stories, Tasks und Sub-Tasks, sonst nichts. Andere docket-Projekte können die übrigen Epics desselben Jira-Projekts nehmen, aber jedes Epic gehört zu genau einem docket-Projekt. Den Scope kannst du später im selben Panel ändern: Neue Epics werden geholt, die Tickets eines entfernten Epics behalten ihre Zeit und werden vom täglichen Check geschlossen.
Klicke auf Projekt verknüpfen.

docket importiert die Issues im Hintergrund (bei großen Projekten dauert das einen Moment). Wie der Ticketbereich danach aussieht, bestimmt die Einstellung Ticketbereich im Jira-Panel. Du kannst sie jederzeit umschalten:

Jira ersetzt ihn (Standard): Der Tickets-Tab öffnet das Jira-Projekt, die Tabs Boards und Roadmap verschwinden, weil die Planung jetzt in Jira liegt. Zeit buchst du auf die Jira-Issues (schreibgeschützt, mit ihrem Jira-Key).
Jira ergänzt ihn: docket-eigene Tickets, Boards und Roadmap bleiben, und die Jira-Issues stehen unter den docket-Tickets im Abschnitt Aus Jira. Wähle das, wenn ein Teil des Teams ohne Jira-Zugang arbeitet und auf docket-Tickets bucht. Ein Jira-Ticket zeigt, was Jira dazu sagt, und einen Link nach Jira; in docket erfasst du darauf nur Zeit. Boards und Roadmap enthalten nur docket-eigene Tickets, denn die Jira-Tickets werden in Jira geplant.

Time-Sync-Einstellungen

Diese Schalter setzt du beim Verknüpfen und jederzeit danach unter Projekt → Einstellungen → Jira:

Zeit, die in docket gebucht wird, ins Jira-Worklog übertragen (standardmäßig an) entscheidet, ob die Zeit auch in Jira landet. An: Jede Buchung wird auf das passende Jira-Issue übertragen, als die Person, die gebucht hat. Aus: Zeit auf diesen Tickets bleibt nur in docket, ins Jira-Worklog wird nichts geschrieben.
Direkt in Jira erfasste Zeit anzeigen (standardmäßig an) holt Worklogs, die in Jira erfasst wurden, schreibgeschützt nach docket und zeigt sie als „In Jira erfasste Zeit“ unter Projekt → Controlling → Zeiteinträge: wer wie viel gebucht hat, bei zugeordneten Nutzern mit Umsatz. Diese Zeit zählt nicht in Budgets, Reports, Umsatz oder Rechnungen.
Als echte docket-Zeiteinträge für zugeordnete Personen übernehmen (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 eine Leistung hinterlegt haben, werden neu importierte Jira-Worklogs zu echten docket-Zeiteinträgen. Sie zählen in Budgets, Reports und Umsatz wie in docket gebuchte Zeit, bewertet mit der Leistung 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 also in docket: Ein Löschen in Jira entfernt den umgewandelten Eintrag, Änderungen in Jira werden ignoriert. Umgewandelt wird nur Zeit, die nach dem Einschalten importiert wird.

Einstellungen später ändern

Push ausschalten: Künftige Buchungen werden nicht mehr synchronisiert. Schon übertragene Zeit bleibt in Jira; entfernen kannst du sie mit docket-Zeit aus Jira entfernen (unten).
Push einschalten: Neue Buchungen werden ab dann synchronisiert. Vorhandene docket-Zeit jetzt mit Jira synchronisieren überträgt zusätzlich jeden früheren docket-Eintrag dieses Projekts, der noch nicht in Jira ist.
docket-Zeit aus Jira entfernen (nur Admins) löscht jedes Worklog, das docket für dieses Projekt nach Jira übertragen hat. Deine docket-Zeiteinträge bleiben unberührt.
- Bei Core-Jira kann docket 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 klappt das Entfernen für alle über den Tempo-Token der Verbindung.

Ansonsten verhält sich Tempo hier wie Core-Jira (Push, Catch-up-Sync und Entfernen).

Tägliche Nutzung

Ein Jira-Ticket finden: im Tickets-Tab des Projekts oder in der Ticket-Auswahl der Zeiterfassung über seinen Jira-Key.
Zeit buchen wie auf jedem docket-Ticket. Jeder Eintrag auf einem Jira-Ticket zeigt seinen Sync-Status:
- Mit Jira synchronisiert ✓: übertragen.
- Wird mit Jira synchronisiert…: läuft gerade.
- Jira-Sync fehlgeschlagen: Klicke auf Erneut versuchen (siehe Troubleshooting).
- Nicht in Jira — verbinde dein Jira-Konto: Mach Teil 2 der Einrichtung, danach gehen die Einträge von selbst nach Jira.
In Jira öffnen: Klicke auf das Jira-Key-Badge eines gespiegelten Tickets.

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

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

Verknüpfst du ein Projekt, das schon docket-Tickets und gebuchte Zeit hat, geht nichts verloren und nichts wird überschrieben:

Deine docket-Tickets und ihre gesamte Zeit bleiben. Das Verknüpfen fügt die Jira-Issues nur als neue Tickets hinzu. Neue Arbeit trackst du dann auf den Jira-Tickets.
Mit Jira ersetzt ihn öffnet der Tickets-Tab Jira, die alten docket-Tickets siehst du dort also nicht mehr. Sie gehören aber weiter zum Projekt: Ihre Zeit zählt weiter in Budget, Controlling und Reports, und in der Zeiterfassung kannst du sie weiterhin über Name/Nummer auswählen, um diese Einträge anzusehen oder zu bearbeiten.
Zeit auf den alten docket-Tickets wird nicht nach Jira gesendet, weil sie kein Jira-Gegenstück haben. Auch Vorhandene docket-Zeit jetzt mit Jira synchronisieren erfasst nur die Jira-Tickets.
Rückgängig machst du das mit Verknüpfung lösen (Projekt → Einstellungen → Jira → Verknüpfung lösen). Die Tabs Tickets, Boards und Roadmap kommen zurück, und docket fragt, was mit den Jira-Tickets in docket passiert:
- Jira-Tickets mit gebuchter Zeit behalten (Standard): Sie bleiben samt ihrer Zeit. Tickets ohne Zeit werden entfernt, sie existierten nur wegen der Verknüpfung.
- Alle Jira-Tickets aus docket entfernen: Jedes gespiegelte Jira-Ticket wird aus docket gelöscht, samt seiner Zeiteinträge und importierten Jira-Worklogs. Der Dialog nennt, wie viele Einträge und Stunden das sind. Gedacht für eine Fehlverknüpfung, deren Zeit du nicht behalten willst.

Beides betrifft nur docket. Bereits übertragene Zeit bleibt in Jira. Um sie dort zu entfernen, nutze docket-Zeit aus Jira entfernen, bevor du die Verknüpfung löst.

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

Einen „Projekt ändern“-Button gibt es bewusst nicht: Du klickst auf Verknüpfung lösen und verknüpfst dann das richtige Projekt.

Noch keine Zeit gebucht: Lös einfach die Verknüpfung. Die importierten Tickets sind leer und werden automatisch entfernt, du kannst also sofort das richtige Jira-Projekt verknüpfen.

Auf den Tickets des falschen Projekts wurde schon Zeit gebucht: Lös die Verknüpfung und verknüpfe das richtige Projekt. Dann gilt:

Tickets mit gebuchter Zeit bleiben in docket; Stunden, Budget und Controlling ändern sich nicht. Der tägliche Check schließt sie (sie verlassen also die Auslastung), danach sind sie eingefrorene Historie.
Neue Zeit auf diesen alten Tickets bleibt nur in docket. Sie wird nie in das zuvor verknüpfte Jira-Projekt übertragen.
Soll Zeit auf die Tickets des neuen Projekts, wähle die Einträge unter Zeiterfassung → Berichte aus und ändere mit Verschieben Projekt und Ticket. Jira zieht automatisch nach: Das Worklog wird am alten Jira-Issue entfernt und, wenn Push an ist, am neuen angelegt.
Worklogs, die docket schon ins falsche Jira-Projekt übertragen hat, bleiben dort. Sollen sie weg, klicke auf docket-Zeit aus Jira entfernen, bevor du die Verknüpfung löst. Danach kann docket dieses Jira-Projekt nicht mehr aufräumen.

Tickets, die in einem anderen Projekt „festhängen“: Wird das Jira-Projekt, das du verknüpfst, schon in einem anderen docket-Projekt mit gebuchter Zeit gespiegelt (zum Beispiel nach dem Umzug einer Jira-Integration von einem docket-Projekt in ein anderes), zeigt docket eine Warnung, beim Auswählen des Projekts und danach in den Einstellungen. Diese Tickets werden nie automatisch verschoben, weil sonst ihre Stunden und ihr Umsatz unbemerkt das Projekt wechseln würden. Verschiebe ihre Zeiteinträge über Zeiterfassung → Berichte → Verschieben 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.