Verwenden von Linear-Aktionen in Aktionsflüssen

Linear ist ein Vorgangsverfolgungs- und Projektmanagement-Tool für Software-Teams. Mit dem Linear-Connector für den Aktionsgenerator können Sie Vorgänge, Projekte und Kommentare erstellen und verwalten, nach Vorgängen und Benutzern suchen und die Arbeit Ihres Teams direkt von Ihren Zendesk-Aktionsflüssen aus organisieren.

Welchen Plan habe ich

Suite, alle Versionen

Team, Growth, Professional, Enterprise oder Enterprise Plus

Support

Team, Professional oder Enterprise

Zusammenfassung: ◀▼

Sie können Ihre Aktionsflüsse mit Linear verbinden, um Vorgänge, Projekte und Kommentare direkt in Ihren Workflows zu erstellen, zu aktualisieren und zu verwalten. Diese Integration unterstützt das Suchen und Nachschlagen von Vorgängen und Benutzern, die Zuweisung von Vorgängen und die Organisation von Projekten, sodass Sie die Projektverwaltung und Vorgangsverfolgung optimieren können, ohne zwischen den Plattformen zu wechseln. Verwenden Sie ein dediziertes Dienstkonto für die sichere Zuweisung und Verwaltung externer Aktionen.

Durch Verbinden des Aktionsgenerators mit externen Systemen wie Linear können Administratoren Zendesk in automatisierten Workflows mit externen Systemen integrieren, um die Zusammenarbeit zu verbessern und für ein plattformübergreifend einheitliches Erlebnis zu sorgen.

Hinweis: Die mit externen Systemen verknüpften Schritte in Aktionsflüssen werden als externe Aktionen bezeichnet.

Linear ist ein Vorgangsverfolgungs- und Projektmanagement-Tool für Software-Teams. Mit dem Linear-Connector für den Aktionsgenerator können Sie Vorgänge, Projekte und Kommentare erstellen und verwalten, nach Vorgängen und Benutzern suchen und die Arbeit Ihres Teams direkt von Ihren Zendesk-Aktionsflüssen aus organisieren.

In diesem Beitrag werden folgende Themen behandelt:

• Verbinden von Linear mit dem Aktionsgenerator
• Verwenden von Linear-Aktionen in Aktionsflüssen

Verbinden von Linear mit dem Aktionsgenerator

Bevor Sie externe Aktionen in Aktionsflüsse einbinden können, müssen Sie den Aktionsgenerator mit dem externen System verbinden.

Beachten Sie beim Verbinden mit externen Systemen für die Verwendung in Aktionsflüssen die folgenden Best Practices:

• Alle von einem Aktionsfluss ausgeführten externen Aktionen werden dem Benutzer zugeordnet, der das externe System verbunden hat. Deshalb wird empfohlen, für die Verbindung mit einem externen System ein dediziertes Dienstkonto und keine persönlichen Anmeldedaten zu verwenden.
• Alle Integrationen fordern den Zugang zu erforderlichen Zugriffsarten an. Sie sollten die Zugriffsarten jedoch unbedingt überprüfen und validieren, bevor Sie die Verbindung zum externen System autorisieren.
• Bei der Verwaltung von Anmeldedaten für Tools wie OpenAI, die auf API-Schlüsseln basieren, sollten die Schlüssel nach Möglichkeit in einem sicheren Tresor oder Credential Manager gespeichert werden.

So verbinden Sie den Aktionsgenerator mit Linear

1. Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf Aktionen > Aktionsflüsse.
2. Erstellen oder bearbeiten Sie einen Aktionsfluss.
3. Öffnen Sie die Schritt-Seitenleiste.
4. Klicken Sie unter Externe Aktionen auf Linear.
5. Klicken Sie auf Verbinden.
6. Befolgen Sie die Anweisungen von Linear, um sich zu authentifizieren und den Verbindungsaufbau abzuschließen.

   Die Linear-Verbindung verwendet OAuth 2.0 mit der Gewährungsart „Autorisierungscode“. Beim Autorisieren der Verbindung werden Sie zu Linear weitergeleitet und müssen Ihrem Zendesk-Konto die erforderlichen Berechtigungen erteilen.

   Hinweis: Alle von einem Aktionsfluss ausgeführten externen Aktionen werden dem Benutzer zugeordnet, der das externe System verbunden hat. Deshalb wird empfohlen, für die Verbindung mit einem externen System ein dediziertes Dienstkonto und keine persönlichen Anmeldedaten zu verwenden.

Nach dem Verbindungsaufbau sehen Sie eine entsprechende Anzeige sowie Details zur verbundenen Instanz und den verfügbaren Linear-Aktionen.

Verwenden von Linear-Aktionen in Aktionsflüssen

Mit Linear-Aktionsschritten können Sie Formulare nachschlagen und nach Umfrageantworten suchen.

Folgende Linear-Aktionen sind verfügbar:

• Vorgang erstellen
• Vorgang aktualisieren
• Vorgang nach ID suchen
• Vorgänge suchen
• Kommentar zum Vorgang hinzufügen
• Benutzer nachschlagen
• Benutzer suchen
• Projekt erstellen
• Projekt aktualisieren
• Vorgang zum Projekt hinzufügen
• Vorgang einem Mitglied zuweisen

Erstellen eines Vorgangs

Mit der Aktion Vorgang erstellen können Sie einen neuen Vorgang mit den angegebenen Details in Linear erstellen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: Title, Team Optional: Description, Project, Assignee email, Status, Priority, Due date, Estimate Hinweis: Das Fälligkeitsdatum muss im Format JJJJ-MM-TT entsprechend der Zeitzone Ihres Linear-Kontos eingegeben werden. Verfügbare Prioritätsoptionen: Keine Priorität, Dringend, Hoch, Mittel, Niedrig.
Ausgabe	Vorgangsdetails wie ID, Kennung, Titel, Beschreibung und URL sowie Informationen zu Projekt, Mitarbeiter, Status, Priorität, Fälligkeitsdatum, geschätzter Fertigstellung und Zeitstempeln

Aktualisieren eines Vorgangs

Mit der Aktion Vorgang aktualisieren können Sie die Eigenschaften eines vorhandenen Vorgangs in Linear aktualisieren.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: Issue Optional: Title, Description, Assignee email, Project, Status, Priority, Due date, Estimate Hinweis: Das Fälligkeitsdatum muss im Format JJJJ-MM-TT entsprechend der Zeitzone Ihres Linear-Kontos eingegeben werden.
Ausgabe	Aktualisierte Vorgangsdetails wie ID, Kennung, Titel, Beschreibung und URL sowie Informationen zu Projekt, Mitarbeiter, Status, Priorität, Fälligkeitsdatum, geschätzter Fertigstellung und Zeitstempel der Aktualisierung

Nachschlagen eines Vorgangs

Mit der Aktion Vorgang nach ID suchen können Sie detaillierte Informationen zu einem bestimmten Vorgang abrufen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: Issue ID
Ausgabe	Vorgangsdetails wie ID, Kennung, Titel, Beschreibung und URL sowie Informationen zu Projekt, Mitarbeiter, Status, Priorität, Fälligkeitsdatum, geschätzter Fertigstellung und Zeitstempeln

Suchen nach Vorgängen

Mit der Aktion Vorgänge suchen können Sie anhand verschiedener Kriterien nach einem Vorgang suchen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Optional: Team, Project, Assignee email, Status, Order by, Limit, Cursor
Ausgabe	Array von Vorgängen mit ID, Kennung, Titel und URL sowie Informationen zu Status, Mitarbeiter, Priorität, Zeitstempel der Erstellung und Paginierung (hasNextPage, endCursor)

Hinzufügen eines Kommentars zu einem Vorgang

Mit der Aktion Kommentar zum Vorgang hinzufügen können Sie einem vorhandenen Vorgang einen Kommentar hinzufügen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: Issue, Body
Ausgabe	Details zum Kommentar wie ID, Text, Autor (ID und Name) sowie Zeitstempel der Erstellung

Nachschlagen eines Benutzers

Mit der Aktion Benutzer nachschlagen können Sie Benutzerinformationen anhand der E-Mail-Adresse oder des Anzeigenamens abrufen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: Lookup by, Value
Ausgabe	Benutzerdetails wie ID, Name, Anzeigename, E-Mail-Adresse, Avatar-URL und Profil-URL

Suchen nach Benutzern

Mit der Aktion Benutzer suchen können Sie anhand verschiedener Kriterien nach Benutzern suchen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: Query Optional: Limit, Cursor
Ausgabe	Array von Benutzern mit ID, Name, Anzeigename, E-Mail-Adresse und Avatar-URL sowie Informationen zur Paginierung (hasNextPage, endCursor)

Erstellen von Projekten

Mit der Aktion Projekt erstellen können Sie ein neues Projekt in Linear erstellen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: Name, Team Optional: Description, Start date, End date Hinweis: Das Startdatum und das Enddatum müssen im Format JJJJ-MM-TT entsprechend der Zeitzone Ihres Linear-Kontos eingegeben werden.
Ausgabe	Projektdetails wie ID, Name, Beschreibung und URL sowie Informationen zu Team (ID und Name), Startdatum, Enddatum und Zeitstempel der Erstellung

Aktualisieren von Projekten

Mit der Aktion Projekt aktualisieren können Sie die Eigenschaften eines vorhandenen Projekts aktualisieren.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: Project Optional: Name, Description, Start Date, End Date Hinweis: Das Startdatum und das Enddatum müssen im Format JJJJ-MM-TT entsprechend der Zeitzone Ihres Linear-Kontos eingegeben werden.
Ausgabe	Aktualisierte Projektdetails wie ID, Name, Beschreibung, URL, Startdatum, Enddatum und Zeitstempel der Aktualisierung

Hinzufügen eines Vorgangs zu einem Projekt

Mit der Aktion Vorgang zum Projekt hinzufügen können Sie einem Projekt einen vorhandenen Vorgang hinzufügen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: Issue, Project
Ausgabe	Vorgangsdetails wie ID, Kennung, Titel und URL sowie Informationen zum Projekt (ID und Name)

Zuweisen eines Vorgangs an ein Mitglied

Mit der Aktion Vorgang einem Mitglied zuweisen können Sie einen Vorgang per E-Mail einem Teammitglied zuweisen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: Issue, Assignee email
Ausgabe	Vorgangsdetails wie ID, Kennung, Titel und URL sowie Informationen zum Mitarbeiter (ID und Name)