Jira Integration: Einleitung und Verwendung (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-Ticket und starten Sie die Zeiterfassung mit einem Klick, ohne timr separat öffnen zu müssen.
   

Inhaltsverzeichnis

1. Einrichtung der Integration

2. Konfiguration eines Projekts

3. Synchronisation starten

4. Konfiguration bearbeiten oder löschen

5. Aufgabe direkt aus Jira starten

6. Einschränkungen und Ausblick

 

1. Einrichtung der Integration 

Voraussetzungen:

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

Schritt 1: 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 2: 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 3: 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 4: 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 Konfiguration bestimmt, welche Vorgänge aus einem Jira-Projekt als Aufgaben in timr angelegt werden und wie diese Aufgaben aussehen. Konfigurationen verwalten Sie in Jira, in der timr Konfiguration. Pro Projekt legen Sie eine eigene Konfiguration an und wählen dabei zwischen einem einfachen und einem erweiterten Modus.

• Einfacher Modus: Eine Standardkonfiguration für das gesamte Projekt — ohne Unterscheidung nach Komponenten oder Vorgangstypen.
• Erweiterter Modus: Unterschiedliche Regeln pro Komponente und/oder pro Vorgangstyp.

Eine ausführliche Beschreibung aller Bereiche des Konfigurationsdialogs, einschließlich der Komponenten-Optionen und der Vorgangstyp-Regeln, finden Sie im Artikel „Jira-Integration: Der Konfigurationsdialog im Überblick".
 

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.
• Umfang 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.
 

7. Häufige Fragen

Werden bestehende Buchungen gelöscht, wenn ein Vorgang ausgeblendet wird?
Nein. Verliert ein Vorgang den konfigurierten Status und wird die zugehörige Aufgabe ausgeblendet, bleiben bereits gebuchte Zeiten erhalten.

Kann ich mehrere Jira-Projekte gleichzeitig anbinden?
Ja. Sie können beliebig viele Konfigurationen anlegen und jedes Projekt mit eigenen Regeln synchronisieren.

Wo lege ich fest, ob eine Aufgabe buchbar oder verrechenbar ist?
Diese Eigenschaften bestimmen Sie im Konfigurationsdialog — global für das gesamte Projekt oder pro Vorgangstyp.