...
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:
Konfiguration von JIRA in Troi
- 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. Wesentlich ist ebenso, das für den JIRA-Benutzer dieselbe E-Mail Adresse hinterlegt ist, wie in Troi.
Um die Verknüpfung von Jira-Issues zu Troi-Kalkulationspositionen herzustellen wird in Jira ein "benutzerdefiniertes Feld“ verwendet.
Bei Bedarf kann der in Jira erfasste Kommentar durch die Jira-Issue Nmmer ergänzt 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 mittels einer Konfigurationsdatei konfiguriert. Dazu erstellen Sie die Datei "troi.properties“ im Verzeichnis "/target/jira/home“ (Standard: /var/atlassian/application-data/jira) mit folgendem Inhalt:
| Code Block | ||||
|---|---|---|---|---|
| ||||
#Troi - Jira - Integration troi.cp_id_field_name= Hier bitte den exakten Namen des benutzerdefinierten Feldes eingeben troi.troi_url=Hier bitte die URL Ihrer Troi Installation eingeben z.B. https://kundenname.troi.de troi.troi_user_name=Hier bitte den Troi Benutzernamen eingeben troi.troi_user_password_md5=Hier bitte das Kennwort, welches für den o.g. Benutzer in Troi hinterlegt ist, (als MD5 Hash) eingeben. Bspw. hier können Sie Ihr Passwort in einen MD5 Hash konvertieren > http://www.md5-generator.de/ troi.max_cache_age_in_seconds=3600 |
Navigieren Sie zu „Administration > Vorgängedazu zu "Administration → Vorgänge/Issues > Benutzerdefinierte → Benutzerdefinierte Felder/Custom Fields“ und klicken Sie auf „Benutzerdefiniertes Feld hinzufügen/Add Custom Field“.
...
Benutzerdefiniertes Feld in JIRA hinzufügen
Wenn Sie JIRA in der Atlassian Cloud hosten
Wenn Sie Jira in der „on demand“ Version verwenden "Atlassian Cloud" hosten, kann das Troi Jira-Plugin PlugIn leider (derzeit) nicht installiert werden. Verwenden Sie in diesem Fall bitte als benutzerdefiniertes Feld / custom field ein einfaches Textfeld "Textfeld „Textfeld (einzeilig) / Text Field (single line)".
...
Textfeld hinzufügen
Wenn Sie selber JIRA hosten:
Wenn Sie Jira selbst hosten, können Sie das Troi Jira-Plugin PlugIn installieren und haben dann im Bereich „Erweitert"Erweitert/Advanced“ den neuen Feldtyp „Calculation "Calculation position selection field“ zur Verfügung.
Das PlugIn bietet im Vergleich zur in der Atlassian Cloud gehosteten Variante die Funktion, die Kalkulationsposition aus einem Drop-Down auszuwählen. Ebenso wird der Projektpfad angezeigt
d.h. Projekt → Unterprojekt → Kalkulationsposition, was bei der oben beschrieben Variante nicht der Fall ist.
Benennen Sie es entsprechend
Calculation position selection field auswählen
Bei der Benenung des Feldes darauf achten, das es dem Feldnamen (Name des JIRA-Feldes für die Referenz zur Kalkulationsposition) entspricht,
der in Kapitel "Die Einrichtung der JIRA Umgebung in Troi" vergeben wurde
Konfigurieren Sie die Screens, in denen das Feld sichtbar sein soll
...