Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
outlinetrue

...

Die Funktionalität

Die JiraTroi-JIRA-Integration in TROI ermöglicht die Übernahme der in Jira erfassten Arbeitsprotokolle in die TROI-Stundenerfassung. 

D.h. in TROI werden automatisch Stundenbuchungen auf die entsprechenden Kalkulationsposition in zugehörige TROI Projekte erstellt.

Dieser Vorgang wird durch das Übertragen der Werte aus Jira nach TROI ausgeführt.

Die Synchronisierung erfolgt dabei in festgelegten Zeit-Intervallen.

Ebenso werden in diesem Schritt die Restaufwandschätzungen aus Jira in die entsprechenden Stundenbuchungen und zugehörige TROI-Projekte übernommen.

Dabei müssen in Jira die Verknüpfungen zu TROI Kalkulationspositionen vorgenommen werden, auf die dann die Arbeitsprotokolle übertragen werden. 

TROI unterstützt hierbei die Übertragung der Arbeitsprotokolle aus einzelnen Jira Issues und auch aus Jira-Issues inkl. Unteraufgaben.

Der Workflow weicht hier leicht ab, je nachdem, ob Jira bei Ihnen selbst gehostet wird oder Sie ein Atlassian Cloud Hosting verwenden, bei welchem Sie derzeit das Jira PlugIn nicht nutzen können. 

In TROI gibt es bei Verwendung der Jira Schnittstelle einen zusätzlichen Reiter Jira  in TROI Projekten. Dort wird links das TROI Projekt hierarchisch dargestellt 

Es erfolgt eine Zusammenrechnung aller Jira Issues pro Kalkulationsposition (sofern mehrere Jira Issues mit derselben Position verknüpft sind) sowie die Aufrechnung / Gesamtsumme auf Projekt-Levelbietet im Wesentlichen die folgenden Funktionalitäten:

Verwalten von JIRA Vorgängen und Unteraufgaben direkt aus TROI im "JIRA"-Tab

Projektmanager können ohne Wechsel der Applikation direkt aus Troi heraus Vorgänge und Unteraufgaben anlegen, ändern oder löschen und deren Status überwachen.

Innerhalb der TROI-Software gibt es einen speziellen JIRA-Reiter für Projekte, die die JIRA-Schnittstelle nutzen. In diesem Bereich wird das TROI-Projekt hierarchisch dargestellt.

Für die Zusammenfassung der Daten erfolgt eine Aggregation aller JIRA-Issues pro Kalkulationsposition, sofern mehrere JIRA-Issues mit derselben Position verknüpft sind. Darüber hinaus wird eine Gesamtsumme auf Projektebene berechnet, was eine vereinfachte Kontrolle und Überwachung des Projektfortschritts ermöglicht.

Übergabe des in JIRA erfassten Arbeitsprotokolls an die Troi-Stundenerfassung

Die TROI-JIRA-Integration bietet eine Funktionalität zur Übertragung der in JIRA erfassten Arbeitsprotokolle in die TROI-Stundenerfassung. Diese Funktion erzeugt automatisch Stundenbuchungen für die korrespondierenden Kalkulationspositionen in den zugehörigen TROI-Projekten.

Da das JIRA-Arbeitsprotokoll automatisch an die Troi-Stundenerfassung übergeben wird, entfällt auch hier ein Wechsel der Applikation. Die für die Bearbeitung der Vorgänge zuständigen Mitarbeiter können sich auf ihre eigentliche Arbeit, das Lösen von Problemen, konzentrieren. Ihre erfassten Stunden stehen unmittelbar dem Troi-Projektmanagement zur Verfügung.

TROI unterstützt hierbei sowohl die Übertragung von Arbeitsprotokollen aus einzelnen JIRA-Issues als auch aus JIRA-Issues inklusive Unteraufgaben.

Dieser Prozess der Datensynchronisation erfolgt periodisch, basierend auf voreingestellten Zeitintervallen. 

Übergabe der in JIRA ermittelten Restaufwandsschätzungen an TROI

Ebenso werden im Rahmen dieser Synchronisation die in JIRA ermittelten Restaufwandsschätzungen in die zugehörigen Stundenbuchungen und TROI-Projekte integriert.


 

Abb.: Jira-Tab in TROI-Projekten

...

Für die Einrichtung der Jira Schnittstelle wird sowohl in TROI als auch in Jira JIRA eine administrative Anpassung benötigt.
Unter System →  Systemeinstellungen Unter System →  Systemeinstellungen → Reiter Jira-Integration  muss muss in TROI die Jira JIRA Konfiguration hinterlegt werden:


Abb.: Konfiguration von Jira in TROI

...

  • Server-URL: Bitte geben Sie hier die Server-URL der JIRA-Instanz an
    • incl. http bzw. https
  • Benutzername: Bitte geben Sie hier den Benutzernamen des JIRA-Benutzers an
  • Benutzerpasswort: Bitte geben Sie hier das Passwort des JIRA-Benutzers an
    • Für die Authentifizierung bei JIRA-Cloud wird ein API-Token statt Passwort benötigt. Dieses Token wird als Benutzerpasswort-Passwort in den TROI-EInstellungen eingetragen.

  • Name des Jira-Feldes für die Referenz zur Kalkulationsposition: Bitte geben Sie hier den Namen des CustomFields ein, welches Sie später in JIRA erstellen und zur Eingabe der zu verknüpfenden ID's zu TROI Kalkulationspositionen verwenden.
  • Formatierungs-Zeichenfolge für den Kommentar: %2$s // %1$s 
    • %1$s = Kommentar, %2$s = Ticket-Nummer (Beispiel: '%1$s (%2$s)')
  • JIRA-PlugIn installiert: Bitte die Checkbox aktivieren, sofern das Jira-PlugIn verwendet wird


...

Die Verbindung von JIRA zu TROI

Die Verknüpfung von Troi-Projekten und Jira-Projekten ermöglicht es, Informationen und Daten zwischen beiden Systemen auszutauschen. Die Verknüpfung erfolgt über den Jira-Projektschlüssel, der in den erweiterten Projekteinstellungen in Troi eingetragen wird.  Um weiteren Datentransfer der Stunden zu ermöglichen, ist es notwendig, in JIRA die Verbindungen zu den TROI

...

Der verwendete Jira-Benutzer muss mindestens Leserechte für die entsprechenden Jira-Projekte haben.

Wesentlich ist ebenso, das für den Jira-Benutzer dieselbe E-Mail Adresse hinterlegt ist, wie in TROI.

Um die Verknüpfung von Jira-Kalkulationspositionen herzustellen. Um die Verknüpfung zwischen Jira-Vorgängen und Troi-Kalkulationspositionen herzustellen, wird in Jira ein „benutzerdefiniertes Feld“ verwendet. Dieses Feld kann je nach Hosting-Option von Jira auf verschiedene Weise erstellt werden. Bei einer "on demand"-Version (bei Atlassian gehostet) verwenden Sie ein einfaches Textfeld. Bei einer "self-hosted"-Version (Kunde hat eigenen Server für Jira) können Sie das Troi Jira-Plugin installieren und einen neuen Feldtyp verwenden.

Der in der Integration eingesetzte JIRA-Benutzer muss Lesezugriffsrechte für die zugehörigen Jira-Projekte besitzen. Dies stellt sicher, dass alle relevanten Informationen aus Jira abgerufen und in Troi verarbeitet werden können.

Zur eindeutigen Identifizierung der Benutzer zwischen beiden Systemen muss die E-Mail-Adresse des Jira-Benutzers mit der in TROI registrierten E-Mail-Adresse übereinstimmen.

Die Assoziation von JIRA-Issues zu TROI-Kalkulationspositionen herzustellen wird in Jira ein "benutzerdefiniertes Feld“ verwendet. Bei Bedarf wird durch die Nutzung eines "benutzerdefinierten Feldes" in Jira erreicht. Dieses Feld dient als zentraler Verknüpfungspunkt für die Übertragung relevanter Daten zwischen den beiden Systemen.

Falls erforderlich, kann der in Jira erfasste dokumentierte Kommentar durch die Hinzufügung der Jira-Issue-Nummer ergänzt werden. Dies bietet eine zusätzliche Methode zur Nachverfolgung und Identifizierung spezifischer Datenpunkte zwischen Jira und TROI.



...

Installation

...

vom Jira-PlugIn (Optional)

Das Jira-PlugIn laden Sie bitte unter folgender Adresse herunter (Kompatibel mit Jira 7.13.0 - 8.22.0) → https://dist.TROI.software/Jira/Jira-plugin-1.3.zip

...