Mit der Jira-Schnittstelle übernehmen Sie Strukturen aus Jira nach ZEP. Dadurch können Jira-Elemente wie Spaces und Issues in ZEP als Kunden, Projekte, Vorgänge oder Tickets genutzt werden.
Wichtig: Die Schnittstelle funktioniert nur mit der Produktlinie Jira Projektmanagement von Atlassian.
Die Jira-Schnittstelle ist eine Verbindung von Jira nach ZEP. Jira bleibt dabei das führende System für die übertragenen Strukturen.
Richtung Daten: Jira -> ZEP
Verknüpfung der Schnittstelle
Sie finden die Jira-Schnittstelle in ZEP unter Administration > Schnittstellen -> Schnittstellenmarktplatz.
Wählen Sie dort Jira aus und klicken Sie im Marktplatz auf Hinzufügen. Anschließend werden Sie in den Buchungsprozess im Self-Service-Tool geführt. Nach der Buchung können Sie die Schnittstelle in ZEP einrichten.
Voraussetzungen
Um Jira mit ZEP zu verbinden, benötigen Sie:
Zugriff auf den Schnittstellenmarktplatz in ZEP
Ihre Jira-E-Mail-Adresse
Einen Jira-API-Token
In den Authentifizierungseinstellungen tragen Sie bitte die Email-Adresse des Administrators ein und den API Token aus Jira:
Benutzername: Die E-Mail-Adresse des Jira-Administrators
Passwort: Das Jira-API-Token
Das Token selbst wird nicht in ZEP, sondern in Jira erzeugt: in Atlassian unter id.atlassian.com/manage-profile/security/api-tokens → "Create API token" → kopieren und in ZEP im Feld "Passwort" einfügen.
Wichtig:
Vorher noch den Jira Host eintragen (z. B.
firma.atlassian.net) –über Test Connection die Verbindung prüfen
Erst wenn der Test erfolgreich ist, springt der Status oben von "inaktiv" auf aktiv
Welche Daten werden übertragen?
Die Jira-Schnittstelle bietet eine flexible Zuordnung. Sie legen fest, wie Jira-Elemente in ZEP verwendet werden.
Jira-Element | Abbildung in ZEP |
Spaces | Projekte oder Kunden |
Epics | Projekte oder Vorgänge |
Issues | Tickets oder Vorgänge |
Bei Jira-Issues können unter anderem folgende Informationen nach ZEP übertragen und dort verwendet werden:
Titel beziehungsweise Zusammenfassung des Issues
Status
Priorität
Erstellungsdatum
Änderungsdatum
Fälligkeitsdatum, sofern vorhanden
Zuordnung zu einem übergeordneten Projekt oder Epic
Zuordnung von Creator und Assignee zu Mitarbeitenden in ZEP
Jira-Worklogs in ZEP verwenden
Jira-Worklogs können als Zeiten nach ZEP übertragen werden. ZEP übernimmt die Jira Zeitbuchung und ordnet sie dem Mitarbeiter und dem Projekt nach der jeweiligen Regelarbeitszeit des Mitarbeiters zu. Wenn in Jira bspw. 16 Stunden erfasst wurden, der Mitarbeiter aber nur eine Regelarbeitszeit von 8h hat, teilt ZEP die Zeiten auf zwei Tage auf. Jira-Worklogs können für die Zeiterfassung in ZEP ausgewertet werden. ZEP verarbeitet die Worklog-Informationen aus Jira und erzeugt daraus Anwesenheitseinträge in ZEP.
Einstellungen in ZEP
Bei der Einrichtung können Sie unter anderem festlegen:
Kundennummern-Präfix für automatisch angelegte Kunden
Standard-Abteilung für automatisch angelegte Projekte
Standard-Tätigkeit für die Zeiterfassung
Typischer Anwendungsfall:
Die Schnittstelle eignet sich, wenn Ihr Team Jira als Ticket-System nutzt und diese Struktur in ZEP für Projektarbeit, Vorgänge, Tickets oder Zeiterfassung verfügbar sein soll.