Linear-Issues aus Workflows anlegen
Eröffnen Sie aus einem Workflow ein Linear-Issue – im Team Ihrer Wahl, mit Priorität – und lassen Sie die Polzy-Aktion sich selbst schließen, wenn das Issue erledigt ist. Verbinden Sie Linear einmal mit einem persönlichen API-Schlüssel.
Auf dieser Seite
Wenn Feedback Ihr Produkt- oder Entwicklungsteam braucht, kann ein Workflow dafür ein Linear-Issue eröffnen – im Team Ihrer Wahl, mit Titel, Beschreibung und Priorität aus dem, was Polzy weiß. Hat der Workflow auch eine Polzy-Aktion angelegt, folgt die Aktion dem Issue und schließt sich selbst, sobald es erledigt oder abgebrochen ist. Am Ende dieser Anleitung ist Linear verbunden, und ein Workflow eröffnet Issues.
Linear ist im Tarif Business enthalten und wird aus Workflows genutzt. Nur ein Admin kann es verbinden und Workflows bauen.
Bevor Sie beginnen
Sie brauchen:
- Einen Arbeitsbereich im Tarif Business und darin die Rolle Admin.
- Integrationen und Workflows für den Arbeitsbereich eingeschaltet, unter Einstellungen → Allgemein → Was dieser Arbeitsbereich leistet.
- Ein Linear-Konto, das in den genutzten Teams Issues anlegen darf. Issues werden unter diesem Konto angelegt – ein eigenes Konto verhindert, dass sie an einer Person hängen.
- Einen persönlichen API-Schlüssel für dieses Konto (siehe unten).
Einen persönlichen API-Schlüssel erstellen
- Öffnen Sie in Linear Settings → Account → Security & access.
- Wählen Sie unter Personal API keys New key und nennen Sie ihn Polzy.
- Geben Sie ihm vollen Zugriff oder mindestens das Recht, Issues zu lesen und anzulegen, sowie Zugriff auf die Teams, die Polzy erreichen soll.
- Kopieren Sie den Schlüssel. Er beginnt mit
lin_api_.
Lässt Linear Sie keinen Schlüssel erstellen, hat ein Linear-Admin Schlüssel für Mitglieder unter Settings → Administration → API womöglich abgeschaltet. Linear erklärt Schlüssel in Linear: API and webhooks.
Linear mit Polzy verbinden
- Öffnen Sie in der Seitenleiste unter Automatisieren die Seite Integrationen und wählen Sie den Tab Verfügbar.
- Suchen Sie Linear und wählen Sie Verbinden.
- Fügen Sie den Schlüssel bei Persönlicher API-Schlüssel ein.
- Wählen Sie Verbindung testen. Polzy antwortet Connected as mit dem Namen des Kontos.
- Wählen Sie Verbinden.
Der Schlüssel wird verschlüsselt gespeichert. Nach dem Verbinden bietet die Zeile von Linear unter Integrationen Umfang einrichten, um den Schlüssel zu ersetzen, und Verwalten für seine Seite.
Ein Issue aus einem Workflow eröffnen
- Öffnen Sie Workflows und den Workflow, oder legen Sie einen neuen an.
- Ziehen Sie unter Connectors in Installierte Schritte den Schritt Linear-Issue anlegen · Linear auf die Arbeitsfläche, hinter den Schritt, auf den er folgen soll. Eine Zeile mit Schloss bedeutet, dass Linear noch nicht verbunden ist oder Aufmerksamkeit erfordert.
- Wählen Sie unter Team das Team. Die Liste zeigt jedes Team, das der Schlüssel sehen kann, mit Name und Schlüssel.
- Schreiben Sie den Titel, bis zu 255 Zeichen. Tippen Sie
{{, um einen Wert aus dem Lauf einzufügen, etwa den Titel der Aktion. - Schreiben Sie bei Bedarf eine Beschreibung.
- Wählen Sie eine Priorität: Keine Priorität, Dringend, Hoch, Mittel oder Niedrig.
Der Schritt gibt die Kennung des Issues, etwa CS-142, als {{connector.issueKey}} und seine Adresse als {{connector.url}} weiter. Ein Testlauf durchläuft den Workflow, ohne das Issue zu eröffnen; nur ein echter Lauf legt eines an. Workflows erklärt Auslöser und Schritte.
Die Aktion schließen, wenn das Issue erledigt ist
Läuft Linear-Issue anlegen im selben Workflow-Lauf nach Aktionspunkt erstellen, wird das Issue mit dieser Aktion verknüpft:
- Verfolgt in. Das Fenster der Aktion zeigt die Kennung des Issues, verlinkt mit Linear, und den Status, den Linear zuletzt gemeldet hat.
- Von Linear geschlossen. Polzy fragt Linear höchstens alle 10 Minuten nach dem Issue. Ist es abgeschlossen – oder abgebrochen, denn dort wird die Arbeit dann nicht mehr erledigt –, wechselt die Aktion zu Erledigt.
- Nur der Status. Kommentare und andere Änderungen bleiben in Linear. Eine zuerst in Polzy geschlossene Aktion wird nicht mehr abgefragt.
Was Polzy an Linear sendet
Nur, was der Schritt festlegt: Team, Titel, Beschreibung und Priorität, mit den Werten, die Sie einfügen. Sonst verlässt nichts über die Antwort oder die Person Polzy. Eine anonyme Antwort hat keine Person, daher sind Werte wie die E-Mail der antwortenden Person leer; was jemand geschrieben hat, wird erst nach der Sicherheitsprüfung gesendet. Einzelne Antworten hält die Mindestgruppengröße nicht zurück – überlegen Sie also, wer die Issues des Teams lesen kann, bevor Sie die Worte von Menschen hineinschreiben.
Fehlerbehebung
- Linear refused the credentials (401). Der Schlüssel ist falsch oder wurde widerrufen. Erstellen Sie einen neuen, wählen Sie in der Zeile von Linear unter Integrationen Umfang einrichten, fügen Sie ihn ein und wählen Sie Speichern. Ein Lauf, der darauf trifft, setzt Linear auf Erfordert Aufmerksamkeit.
- Linear: gefolgt von den Worten von Linear (in einem Lauf). Linear hat die Anfrage abgelehnt – oft, weil der Schlüssel keinen Zugriff auf dieses Team hat oder keine Issues anlegen darf. Prüfen Sie die Rechte des Schlüssels.
- Linear did not create the issue. Linear hat ohne Issue geantwortet. Starten Sie den Workflow erneut; passiert es immer wieder, prüfen Sie, ob das Team noch existiert.
- This step names no team oder The issue has no title. Füllen Sie Team und Titel des Schritts aus.
- Die Liste Team ist ein einfaches Feld. Der Schlüssel sieht keine Teams, oder Linear war nicht erreichbar.
- Die Aktion schließt sich nicht. Der Linear-Schritt lief nicht im selben Lauf nach Aktionspunkt erstellen, das Issue ist weder abgeschlossen noch abgebrochen, oder die Verbindung erfordert Aufmerksamkeit – die Abfragen pausieren, bis das behoben ist.
Gut zu wissen
- Eine Verbindung, alle Teams. Jeder Schritt wählt sein Team aus dem, was der Schlüssel sieht.
- Wer legt es an? Das Konto, zu dem der Schlüssel gehört.
- Kann ein Schritt dasselbe Issue zweimal eröffnen? Nein. Ein Schritt, der nach einem Absturz erneut läuft, verwendet, was er beim ersten Mal angelegt hat.
Nützliche Links
Verwandte Artikel
Angemeldete Mitglieder können Polzy fragen oder dem Team über Support schreiben. Wie schnell wir antworten, hängt von Ihrem Tarif ab.