Jira Integration (Beta)

Die Jira‑Integration erlaubt es, Ihre Projektarbeit in Jira mit der Zeiterfassung in timr zu verbinden. 

Wenn Ihre Teams ihre Arbeitsorganisation in Jira abbilden, aber ihre Arbeitszeiten und Budgetplanung in timr erledigen, vermeidet die Integration doppelten Aufwand: Jira‑Issues werden automatisch als Aufgaben in timr angelegt. Sie können für jedes Projekt definieren, welche Issue‑Typen und Status synchronisiert werden sollen und wie die Aufgaben in timr aussehen (buchbar, verrechenbar usw.). Die Synchronisation erfolgt dabei nur in eine Richtung, Zeiten oder Budgets werden derzeit nicht nach Jira zurückgeschrieben.

Funktionen im Überblick

• Automatischer Import von Jira‑Issues: Die Integration erstellt für jedes synchronisierte Issue eine Aufgabe in timr. Sie haben jederzeit den Überblick über alle Tickets und können Zeiten direkt auf die entsprechende Aufgabe buchen.
• Individuelle Sync‑Regeln: Definieren Sie, aus welchem Projekt in Jira Sie Issues importieren möchten, welchen Status die Tickets haben müssen und welche Issue‑Typen berücksichtigt werden. Dadurch sehen Sie in timr nur die Aufgaben, an denen gerade gearbeitet wird.
• Anpassbare Aufgaben‑Eigenschaften: Legen Sie fest, ob die erzeugten Aufgaben buchbar oder verrechenbar sind oder ob für eine Buchung eine Notiz erforderlich ist. Diese Einstellungen können global oder pro Issue‑Typ definiert werden.
• Flexible Konfigurationen pro Projekt: Sie können mehrere Konfigurationen anlegen, um unterschiedliche Jira‑Projekte mit verschiedenen Regeln zu verknüpfen. Änderungen an der Konfiguration lassen sich jederzeit vornehmen.
• Aufgabe direkt aus Jira starten: Öffnen Sie ein Jira‑Issue und starten Sie die Zeiterfassung mit einem Klick, ohne timr separat öffnen zu müssen. Das timr‑Panel in der rechten Sidebar zeigt die verknüpfte Aufgabe an und öffnet den Task‑Dialog direkt in einem neuen Tab.
• One‑way‑Sync: Aktuell werden nur Issues aus Jira nach timr synchronisiert. Budgets und gebuchte Zeiten werden noch nicht nach Jira übertragen – diese Funktionen sind auf der Roadmap.
  
   

Inhaltsverzeichnis

1. Einrichtung der Integration

2. Konfiguration eines Projekts

2.1. Einfacher Modus
2.2. Erweiterter Modus

3. Synchronisation starten

4. Konfiguration bearbeiten oder löschen

5. Aufgabe direkt aus Jira starten

6. Einschränkungen und Ausblick

 

1. Einrichtung der Integration 

Schritt 1: Integration freischalten

Falls die Integrationsfunktion noch nicht freigeschaltet ist, wenden Sie sich zunächst an den timr‑Support. Nur Administratoren können Integrationen hinzufügen.
 

Schritt 2: Integration in timr hinzufügen

1. Melden Sie sich als Administrator in timr an und öffnen Sie unter Verwaltung → Einstellungen → Integrationen die Integrationsübersicht.

   

2. Klicken Sie auf „Hinzufügen“ und wählen Sie Jira Integration aus. Das System öffnet ein neues Browser‑Tab, in dem die timr‑App im Atlassian Marketplace angezeigt wird.
   

Schritt 3: timr‑App in Jira installieren

Auf der Marketplace‑Seite der timr‑App klicken Sie oben rechts auf „Install via Atlassian Marketplace“. Die Installation läuft im Hintergrund.

Schritt 4: Verbindung zwischen timr und Jira herstellen

1. Öffnen Sie in Jira das Zahnrad‑Menü rechts oben und wählen Sie „Marketplace‑Apps“.

   

2. Unter Apps verwalten finden Sie den Eintrag „timr Konfiguration“. Wählen Sie ihn aus und klicken Sie auf „Connect“.

   

3. Geben Sie Ihren timr‑Identifier und die Zugangsdaten ein, um Ihr timr‑Konto mit Jira zu verbinden. Nach dem Speichern ist die Verbindung hergestellt.
    

Schritt 5: Erste Synchronisation vorbereiten

Nach der Installation und Verbindung steht die Integration bereit. Sie können jetzt Konfigurationen für einzelne Jira‑Projekte anlegen. Sobald die erste Konfiguration gespeichert wird, wird die Synchronisation automatisch gestartet (siehe Abschnitt 3. Synchronisation starten).
 

2. Konfiguration eines Projekts

Die Konfigurationen bestimmen, welche Issues aus einem Jira‑Projekt als Aufgaben in timr angelegt werden und wie diese Aufgaben aussehen. Sie können mehrere Konfigurationen anlegen – zum Beispiel, um verschiedene Projekte oder Teams unterschiedlich zu synchronisieren. 

Um eine neue Konfiguration zu erstellen, klicken Sie in der timr Konfiguration in Jira auf „Konfiguration hinzufügen“:

Gehen Sie dann wie folgt vor:

1. Projekt wählen: Bestimmen Sie das Jira‑Projekt, aus dem die Issues importiert werden sollen.
2. timr‑Aufgabe zuordnen: Wählen Sie eine bestehende Aufgabe in timr, unter der die synchronisierten Issues als Unteraufgaben angelegt werden. Diese Aufgabe dient als Sammelpunkt für alle Tickets des Projekts.
   
3. Status filtern: Legen Sie fest, bei welchen Status ein Issue synchronisiert werden soll (z. B. „In Arbeit“, „To Do“ oder „Code Review“). Aufgaben in timr erscheinen nur, wenn das entsprechende Ticket in Jira einen der ausgewählten Stati hat. Sobald ein Issue in Jira auf „Backlog“ oder „Done“ wechselt, wird die dazugehörige Aufgabe in timr ausgeblendet.
   
4. Modus auswählen: Entscheiden Sie sich für den einfachen Modus oder den erweiterten Modus (siehe unten).
   
    

2.1. Einfacher Modus

Im einfachen Modus werden alle Issue‑Typen eines Projekts synchronisiert. Sie definieren nur einmal, wie die Aufgaben in timr angelegt werden sollen:

Aufgaben‑Eigenschaften
Entscheiden Sie, ob Aufgaben buchbar und/oder verrechenbar sein sollen und ob für eine Buchung eine Notiz erforderlich ist. Diese Einstellungen gelten für alle Issue‑Typen.

Mit dieser Variante importieren Sie schnell und unkompliziert alle Tickets aus dem gewählten Projekt.

Abschließend klicken Sie auf „Vorschau anzeigen“, um eine Zusammenfassung Ihrer Konfiguration zu sehen. Wenn alles stimmt, speichern Sie die Konfiguration. 

Hinweis: Die Konfiguration kann erst gespeichert werden, nachdem eine Aufgabe gewählt wurde.
 

2.2. Erweiterter Modus

Im erweiterten Modus steuern Sie granular, welche Issue‑Typen synchronisiert werden, welche Aufgaben‑Eigenschaften diese erhalten und ob einzelne Jira‑Komponenten eigene Synchronisationsregeln bekommen.

• Alle oder spezifische Issue‑Typen: Wählen Sie zunächst, ob grundsätzlich alle Issue‑Typen synchronisiert werden sollen oder nur bestimmte.
  
   
• Globale Einstellungen: Wenn Sie alle Typen synchronisieren, legen Sie global fest, ob die Aufgaben buchbar, verrechenbar oder mit Notizpflicht angelegt werden sollen. Diese globalen Einstellungen greifen für alle Typen, für die Sie keine abweichenden Regeln definieren.
  
   
• Spezielle Regeln: Für einzelne Issue‑Typen können Sie gesonderte Einstellungen vornehmen, z. B. „Bug‑Tickets sollen nicht verrechenbar sein“. Solche Ausnahmen überschreiben die globalen Einstellungen.
  

Abschließend klicken Sie auf „Vorschau anzeigen“, um eine Zusammenfassung Ihrer Konfiguration zu sehen. Wenn alles stimmt, speichern Sie die Konfiguration.

Hinweis: Die Konfiguration kann erst gespeichert werden, nachdem eine Aufgabe gewählt wurde.
 

3. Synchronisation starten

Die Synchronisation läuft automatisch beim Speichern der Konfiguration. 

Der erste Import kann je nach Anzahl der Issues einige Minuten dauern. timr legt für jedes synchronisierte Issue eine Aufgabe an und zeigt diese unter der von Ihnen gewählten timr‑Aufgabe an.

Nach Abschluss können Ihre Mitarbeitenden Zeiten auf diese Aufgaben buchen. Sobald ein Issue den gewählten Status verliert (z. B. auf „Done“ gesetzt wird), verschwindet die Aufgabe automatisch aus der timr‑Ansicht.

Für einen manuellen Sync gehen Sie wie folgt vor:

1. Wechseln Sie zurück zu timr und öffnen Sie Verwaltung → Einstellungen → Integrationen.
2. Klicken Sie bei der Jira‑Integration auf „Manuelle Synchronisierung von Jira-Aufgaben“.

4. Konfiguration bearbeiten oder löschen

Die Verwaltung der Konfigurationen erfolgt ausschließlich in Jira:

• Bearbeiten: Öffnen Sie in Jira die timr Konfiguration. Dort können Sie vorhandene Konfigurationen bearbeiten, etwa ein anderes Projekt wählen, die Statusfilter anpassen oder die Aufgaben‑Eigenschaften ändern.
  
   
• Neue Konfiguration hinzufügen: Klicken Sie auf „Konfiguration hinzufügen“, um weitere Projekte zu synchronisieren.
  
   
• Löschen: Sie können nicht mehr benötigte Konfigurationen entfernen. Dadurch werden keine Aufgaben gelöscht, sondern die Synchronisation wird beendet.

Sobald Änderungen an den Konfigurationen gespeichert werden, wird auch in timr die Projektstruktur aktualisiert.
 

5. Aufgabe direkt aus Jira starten

timr zeigt in jedem Jira‑Issue ein Panel in der rechten Sidebar an, über das Sie die verknüpfte timr‑Aufgabe direkt öffnen können.

Öffnen Sie ein Jira‑Issue, das mit einer timr‑Aufgabe verknüpft ist. In der rechten Sidebar finden Sie das Panel timr – Zeiterfassung mit dem Button Aufgabe starten. Ein Klick öffnet den timr‑Task‑Dialog in einem neuen Browser‑Tab, wo Sie die Zeit wie gewohnt starten oder wechseln können.

Das Panel zeigt je nach Zustand folgende Information an:

• Task wird geladen – die Verknüpfung wird abgerufen
• Task gefunden – der Button Aufgabe starten ist aktiv
• Task nicht gefunden – das Issue ist noch nicht mit einer timr‑Aufgabe verknüpft, z. B. weil es die konfigurierten Sync‑Bedingungen noch nicht erfüllt

Hinweis: Das Panel muss beim ersten Aufruf einmalig aufgeklappt werden. Jira merkt sich diese Einstellung und zeigt es bei allen weiteren Issues automatisch geöffnet an.
 

6. Einschränkungen und Ausblick

• One‑Way‑Synchronisation: Derzeit werden ausschließlich Issues aus Jira nach timr übertragen. Buchungen, Notizen und Budgets in timr gehen nicht zurück an Jira.
• Budget‑Sync: Das in Jira hinterlegte „Estimated Time“ wird noch nicht als Budget nach timr synchronisiert. Diese Funktion steht auf der Roadmap.
• Scope der Synchronisation: Neben dem Titel und dem Issue‑Typ werden keine weiteren Felder aus Jira übernommen. Labels, Kommentare oder Anhänge werden nicht importiert.

Diese Punkte können sich mit zukünftigen Versionen der Integration ändern. Wir halten Sie auf dem Laufenden und freuen uns über Ihr Feedback zu gewünschten Erweiterungen.