Die Funktionalität
Die 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örigen Troi Projekten erstellt.
Dieser Vorgang wird durch das Übertragen der Werte aus JIRA nach Troi ausgeführt.
Ebenso werden in diesem Schritt die Restaufwandsschä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
(Projekt > Unterprojekte sowie Kalkulationspositionen) sowie (sofern vorhanden) die verknüpften JIRA Issues. Rechts werden die Werte der JIRA Issues angezeigt
(Initialer Schätzwert, erfaßte Arbeitszeit und verbleibende Zeit/Restaufwandsschätzung). Der initiale Schätzwert sowie die erfaßte Arbeitszeit werden prozentual berechnet
und in Form eines Fortschritts-Balkens dargestellt - eine Ansatz für visuelles Projekt-Controlling.
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-Level.
Die Einrichtung der JIRA Umgebung in Troi
Für die Einrichtung der Jira Schnittstelle wird sowohl in Troi als auch in Jira eine administrative Anpassung benötigt.
Unter dem Menüpunkt System → Systemeinstellungen → JIRA-Integration muss in Troi die JIRA Konfiguration hinterlegt werden:
- Server-URL: Bitte geben Sie hier die Server-URL der JIRA Instanz an
- Benutzername: Bitte geben Sie hier den Benutzernamen des JIRA Benutzers an
- Benutzerpasswort: Bitte geben Sie hier das Passwort des JIRA Benutzers an
- 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
- JIRA-PlugIn installiert: Bitte die Checkbox aktivieren, sofern das JIRA-PlugIn verwendet wird
Der verwendete Jira-Benutzer muss mindestens Leserechte für die entsprechenden Jira-Projekte haben. Um die Verknüpfung von Jira-Vorgängen zu Troi-Kalkulationspositionen herzustellen wird in Jira ein „benutzerdefiniertes Feld“ verwendet.
Der Name dieses Feldes muss hier hinterlegt werden. Bei Bedarf kann der in Jira erfasste Kommentar durch die Jira-Vorgangsnummer ergänzt werden. Wenn Sie das Jira-Plugin installiert haben, bitte dies hier kennzeichnen.
In diesem Fall können bestimmte Aufgaben optimiert abgearbeitet werden.
Installation von Jira-Plugin (Optional):
Das Jira-PlugIn laden Sie bitte unter folgender Adresse herunter → https://dv01.troi.de/install/jira-plugin/jira-plugin-1.1.zip
Das Plugin wird mit einer Konfigurationsdatei konfiguriert. Dazu erstellen Sie die Datei "troi.properties“ im Verzeichnis "/target/jira/home“ (Standard: /var/atlassian/application-data/jira) mit folgendem Inhalt:
#Troi - Jira - Integration troi.cp_id_field_name= troi.troi_url=https://<TROI-SERVER>/<TROI-Installation> troi.troi_user_name=<TROI-Benutzer> troi.troi_user_password_md5=<TROI-Kennwort in MD5> troi.max_cache_age_in_seconds=3600
Navigieren Sie zu „Administration > Vorgänge/Issues > Benutzerdefinierte Felder/Custom Fields“ und klicken Sie auf „Benutzerdefiniertes Feld hinzufügen/Add Custom Field“.
Bei „on demand“ Version (bei Atlassian gehostet):
Wenn Sie Jira in der „on demand“ Version verwenden kann das Troi Jira-Plugin leider nicht installiert werden. Verwenden Sie in diesem Fall ein einfaches Textfeld „Textfeld (einzeilig/Text Field (single line).
Bei „self hosted“ Version:
Wenn Sie Jira selbst hosten, können Sie das Troi Jira-Plugin installieren und haben dann im Bereich „Erweitert/Advanced“ den neuen Feldtyp „Calculation position selection field“ zur Verfügung.
Benennen Sie es entsprechend
Konfigurieren Sie die Screens, in denen das Feld sichtbar sein soll
Wenn Sie nun einen neuen Vorgang anlegen, steht Ihnen das Feld zur Verfügung. Geben Sie bitte die Troi K-Nummer ein, die Sie von Ihrem Troi-Projektleiter genannt bekommen.
Sollten Sie das Plugin installiert haben, können Sie nun die Kalkulationspositionen des Troi Projektes auswählen
Damit Sie ein Projekt in Troi für die Synchronisierung freigeben, muss in den erweiterten Projekteinstellungen der Jira Schlüssel hinterlegt sein.
