Mit der Linear-Schnittstelle übertragen Sie Projekte und Tickets aus ZEP nach Linear. ZEP ist das führende System: Daten fließen ausschließlich von ZEP nach Linear – ein Import aus Linear nach ZEP ist nicht vorgesehen.
Richtung Daten: ZEP → Linear
Produktlinienverfügbarkeit
Hinweis: Die Linear-Schnittstelle ist in ZEP Track, ZEP Control, ZEP Operations und ZEP Business enthalten.
Die Übertragung von Tickets setzt das Ticketsystem voraus. In ZEP Track, ZEP Control, ZEP Operations und ZEP Business ist das Ticketsystem zubuchbar. Die Buchung läuft über das ZEP Self-Service-Tool unter Administration > Account.
Für die Einrichtung und Konfiguration benötigen Sie unter Rollen & Rechte das Recht Administrationsbereich mit Bearbeiten. Administratoren haben dieses Recht immer.
Voraussetzungen
Für die Einrichtung benötigen Sie:
Zugriff auf den Schnittstellen Marktplatz in ZEP
Einen Linear-Account mit ausreichenden Berechtigungen
Die Berechtigung, in Linear eine OAuth2-App anzulegen
Die Möglichkeit, im Browser eine OAuth2-Verbindung zu autorisieren
Schnittstelle einrichten
Öffnen Sie in ZEP Administration > Schnittstellen > Schnittstellen Marktplatz. Wählen Sie Linear aus und klicken Sie auf Konfigurieren.
Richten Sie die Verbindung in drei Schritten ein:
Unter OAuth2-Einrichtungsanleitung zeigt ZEP die Callback-URL (Redirect URI). Legen Sie in Linear eine OAuth2-App an und tragen Sie diese URL dort als Redirect URI ein.
Tragen Sie unter Authentifizierungseinstellungen die Client-ID und das Client-Secret der Linear-App ein und unter Sonderinstellungen im Feld Name des Teams-Workspace den Namen Ihres Linear-Teams. Speichern Sie.
Klicken Sie unter Schnellaktionen auf Mit OAuth2 verbinden. Sie werden zu Linear weitergeleitet und erteilen ZEP einmalig die Berechtigung, Daten zu übertragen.
Anschließend legen Sie fest:
Daten Synchronisieren: Mit Linear Projekte synchronisieren und Linear Issues synchronisieren wählen Sie, was ZEP nach Linear überträgt. Beide sind voreingestellt aktiv.
Status-Mapping konfigurieren: Legen Sie fest, welcher ZEP-Ticketstatus welchem Linear-Status entspricht. Das Mapping wird in den Einstellungen der Schnittstelle hinterlegt.
Hinweis: Wenn ein Linear-Status gelöscht oder umbenannt wird, aktualisieren Sie das Status-Mapping in den Schnittstelleneinstellungen, damit die Synchronisation korrekt bleibt.
Datenübertragung
Die Schnittstelle überträgt die folgenden Daten aus ZEP nach Linear. ZEP-Tickets erscheinen in Linear als Issues.
Projekte
ZEP überträgt Projekte nach Linear. Übermittelt werden:
Name des Projekts
Key (Kurzbezeichnung)
Tickets
ZEP überträgt Ticket-Informationen nach Linear. Änderungen an Tickets in ZEP werden automatisch an Linear weitergegeben – die Ticket-Informationen in Linear bleiben damit aktuell, wenn sie in ZEP angepasst werden.
Status-Mapping
Im Feld Zep-Status -> Linear Status weisen Sie jedem ZEP-Ticketstatus den Namen des passenden Linear-Status zu. Das Feld ist leer vorbelegt. Folgende ZEP-Standardstatus stehen für das Mapping bereit:
ZEP-Status | Linear-Status (Beispiel) |
neu | neu |
in Bearbeitung | in Bearbeitung |
fertig | fertig |
abgelehnt | abgelehnt |
abgenommen | abgenommen |
abgerechnet | abgerechnet |
Synchronisation und Protokoll
ZEP gleicht die Daten stündlich im Hintergrund ab. Projekte und Tickets werden beim Import in Linear angelegt und bei Änderungen in ZEP automatisch aktualisiert.
ZEP ist das führende System für alle übertragenen Daten. Änderungen an Projekten und Tickets nehmen Sie in ZEP vor.