Versions Compared

Key

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

Table of Contents
outlinetrue

...

Die Funktionalität

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

...

Abb.: Jira-Tab in TROI-Projekten


...

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.

...

  • 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

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

...

Bei Bedarf kann der in Jira erfasste Kommentar durch die Jira-Issue Nummer ergänzt werden. 


...

Installation von 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

...

Code Block
themeRDark
titleConfig Stuff
#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

...

Anlegen des benutzerdefinierten Feldes in JIRA

Navigieren Sie dazu zu Administration → Vorgänge/Issues → Benutzerdefinierte Felder/Custom Fields und klicken Sie auf Benutzerdefiniertes Feld hinzufügen/Add Custom Field.



Abb.: Benutzerdefiniertes Feld in Jira hinzufügen


...

Wenn Sie JIRA in der Atlassian Cloud hosten

Wenn Sie Jira in der Atlassian Cloud hosten, muss das JIRA-Plugin nicht installiert werden.

...



Abb.: Textfeld hinzufügen


...

Wenn Sie selber JIRA hosten

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.

...

Info
titleJira Cloud

Für die Authentifizierung bei Jira Cloud wird ein API Token benötigt.

Dieses Token wird als Benutzerpasswort-Passwort in den TROI-EInstellungen eingetragen.

API Token Generierung bei Atlassian unter https://id.atlassian.com/manage/api-tokens.


...

Troubleshooting

Fehlende Stunden bei Übertrag

Status
colourRed
titleProblem:
 

...