Zum Hauptinhalt springen

Jira-Integration - Einrichtungsanleitung

Verbinde dein Jira-Konto mit Goodweek, um Vorgänge, Projekte, Sprints und Workflows direkt aus deinem KI-Arbeitsbereich zu verwalten.

A
Verfasst von Antoine Stempien

Verbinde dein Jira-Konto mit Goodweek, um Vorgänge, Projekte, Sprints und Workflows direkt aus deinem KI-Arbeitsbereich zu verwalten.

ℹ️ Hinweis zur Governance

Goodweek überschreitet niemals die dem Benutzer in Jira gewährten Zugriffsebenen und gewährleistet so die Übereinstimmung mit den Governance-Richtlinien deiner Organisation. Ergebnisse und verfügbare Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff jedes Benutzers variieren.

📋 Voraussetzungen

Bevor Benutzer die Jira-Integration sehen und verbinden können, muss dein Organisationsadministrator sie zunächst im Goodweek-Admin-Panel unter dem Tab Integrationen aktivieren.

Admin-Einrichtung

Die Jira-Integration (App-Name: Composio- Jira Connector) verwendet OAuth 2.0 über Atlassian. Für die meisten Organisationen ist keine Admin-Genehmigung erforderlich. Einige Atlassian-Organisationen haben jedoch den "Zugriff für Drittanbieter-Apps über OAuth" auf Organisationsebene deaktiviert.

⚠️ Atlassian-Sicherheitsschalter

Wenn Benutzer beim Verbinden den Fehler "OAuth-App-Zugriff eingeschränkt" sehen, muss ein Atlassian-Organisationsadministrator den Zugriff für Drittanbieter-Apps unter admin.atlassian.com → Sicherheit → Zugriff für Drittanbieter-Apps aktivieren.

⚠️ Nur Jira Cloud

Diese Integration unterstützt nur Jira Cloud. Jira Data Center- und Jira Server-Installationen werden nicht unterstützt.

Benutzerverbindung

  1. Gehe in Goodweek zu Integrationen.

  2. Suche Jira und klicke auf Verbinden.

  3. Du wirst zu Atlassian weitergeleitet, wo du dich anmelden und den Zugriff autorisieren musst.

  4. Wähle die Jira-Site aus, die du verbinden möchtest, und klicke auf Akzeptieren, um zu Goodweek zurückzukehren.

Wichtige Hinweise

  • Jeder Benutzer muss sein eigenes Konto individuell verbinden.

  • Goodweek kann nur auf die Projekte und Vorgänge zugreifen, die dein individuelles Jira-Konto sehen darf.

  • Diese Integration unterstützt nur Jira Cloud. Data Center und Server werden nicht unterstützt.

  • Du kannst den Zugriff von Goodweek jederzeit über id.atlassian.com → Sicherheit → Verbundene Apps → Composio widerrufen.


Verfügbare Tools

Tool

Beschreibung

Typ

Search Issues Using JQL

Sucht Jira-Vorgänge mithilfe von JQL mit Paginierung und Feldauswahl.

Lesen

Search Issues (Advanced)

Erweiterte Vorgangssuche mit Unterstützung für strukturierte Filter und rohes JQL.

Lesen

Get Issue

Ruft einen Jira-Vorgang anhand von ID oder Schlüssel mit anpassbaren Feldern und Erweiterungen ab.

Lesen

Bulk Fetch Issues

Ruft bis zu 100 Jira-Vorgänge anhand ihrer IDs oder Schlüssel in einer einzigen Anfrage ab.

Lesen

Create Issue

Erstellt einen neuen Jira-Vorgang (Fehler, Aufgabe, Story usw.) in einem angegebenen Projekt.

Schreiben

Bulk Create Issues

Erstellt bis zu 50 Jira-Vorgänge in einem einzigen Aufruf mit vollem Funktionsumfang.

Schreiben

Edit Issue

Aktualisiert einen bestehenden Jira-Vorgang mit neuen Feldwerten und Operationen.

Lesen

Transition Issue

Verschiebt einen Jira-Vorgang in einen anderen Workflow-Status (z. B. To Do → In Bearbeitung → Erledigt).

Lesen

Assign Issue

Weist einen Jira-Vorgang einem Benutzer oder dem Standardbearbeiter zu oder hebt die Zuweisung auf.

Lesen

Get Transitions

Ruft die verfügbaren Workflow-Übergänge für einen Jira-Vorgang ab.

Lesen

List Issue Comments

Ruft paginierte Kommentare zu einem Jira-Vorgang ab.

Lesen

Get Comment

Ruft einen bestimmten Kommentar anhand der ID von einem Jira-Vorgang ab.

Lesen

Add Comment

Fügt einem bestehenden Jira-Vorgang einen Rich-Text-Kommentar hinzu.

Schreiben

Update Comment

Aktualisiert den Text oder die Sichtbarkeit eines bestehenden Jira-Kommentars.

Schreiben

Add Attachment

Lädt eine Datei hoch und hängt sie an einen Jira-Vorgang an.

Schreiben

Get Attachment

Ruft den Binärinhalt eines Jira-Anhangs anhand der ID ab.

Lesen

Link Issues

Verknüpft zwei Jira-Vorgänge über einen angegebenen Verknüpfungstyp mit optionalem Kommentar.

Schreiben

Get Issue Link Types

Ruft alle konfigurierten Vorgangsverknüpfungstypen aus Jira ab.

Lesen

Add Worklog

Fügt einem Jira-Vorgang ein Arbeitsprotokoll (Zeiterfassungseintrag) hinzu.

Schreiben

Get Worklogs

Ruft die Arbeitsprotokolle für einen angegebenen Jira-Vorgang ab.

Lesen

Get all Projects

Ruft alle sichtbaren Projekte über die paginierte Jira-API ab.

Lesen

Get Project

Ruft die Details eines Jira-Projekts anhand seiner ID oder seines Schlüssels ab.

Lesen

Create Project

Erstellt ein neues Jira-Projekt mit erforderlichem Lead, Vorlage und Typkonfiguration.

Schreiben

Get Project Versions

Ruft alle Versionen für ein Jira-Projekt ab.

Lesen

Create Version

Erstellt eine neue Version für Releases oder Meilensteine in einem Jira-Projekt.

Schreiben

List Boards

Ruft paginierte Jira-Boards mit Filter- und Sortieroptionen ab.

Lesen

Create Board

Erstellt ein neues Jira-Board (Kanban, Scrum oder Agility).

Schreiben

List Sprints

Ruft paginierte Sprints von einem Jira-Board mit optionaler Statusfilterung ab.

Lesen

Get Sprint

Ruft detaillierte Informationen zu einem bestimmten Sprint anhand seiner ID ab.

Lesen

Create Sprint

Erstellt einen neuen Sprint auf einem Jira-Board mit optionalem Start-/Enddatum und Ziel.

Schreiben

Move Issues to Sprint

Verschiebt einen oder mehrere Jira-Vorgänge in einen angegebenen aktiven Sprint.

Lesen

Get Current User

Ruft Informationen über den derzeit authentifizierten Jira-Benutzer ab.

Lesen

Get Issue Types

Ruft alle für den Benutzer verfügbaren Jira-Vorgangstypen ab.

Lesen

Get Issue Statuses

Ruft alle Vorgangsstatus ab, die mit Workflows in Jira verknüpft sind.

Lesen

Get Fields

Ruft Metadaten zu Jira-Vorgangsfeldern ab, einschließlich benutzerdefinierter Feld-IDs.

Lesen

Delete Issue

Löscht einen Jira-Vorgang anhand seiner ID oder seines Schlüssels dauerhaft und unwiderruflich.

⚠️ Destruktiv

Delete Comment

Löscht einen bestimmten Kommentar dauerhaft von einem Jira-Vorgang.

⚠️ Destruktiv

Delete Attachment

Löscht einen Anhang anhand seiner ID dauerhaft aus Jira.

⚠️ Destruktiv

Delete Worklog

Löscht einen Arbeitsprotokolleintrag von einem Jira-Vorgang.

⚠️ Destruktiv

Delete Version

Löscht eine Jira-Version und weist ihre Vorgänge optional neu zu.

⚠️ Destruktiv

Anwendungsfälle

  • Erstelle und aktualisiere Vorgänge direkt aus Konversationen. Erfasse neue Jira-Vorgänge – Fehler, Aufgaben oder Storys – mit dem richtigen Projekt, Typ und den richtigen Feldern direkt aus einer Goodweek-Konversation heraus, ohne die Jira-Oberfläche zu öffnen.

  • Suche und sortiere Vorgänge mithilfe von JQL. Führe JQL-Abfragen aus Goodweek heraus aus, um überfällige Vorgänge, nicht zugewiesene Aufgaben oder Sprint-Backlog-Elemente aufzudecken und direkt zu bearbeiten, ohne Jira zu öffnen.

  • Führe Vorgänge durch Workflows. Verschiebe Vorgänge zwischen Status (z. B. In Bearbeitung → Erledigt) direkt aus Goodweek heraus, um Sprintboards und Workflows aktuell zu halten.

  • Erfasse Zeiten und füge Kommentare hinzu. Erfasse Arbeitsprotokolle und füge Kommentare zu Vorgängen aus Goodweek hinzu, nachdem die Arbeit abgeschlossen ist, und halte so den Vorgangsverlauf genau, ohne das Tool zu wechseln.


Fehlerbehebung

"OAuth-App-Zugriff eingeschränkt" beim Verbinden

Deine Atlassian-Organisation hat den Zugriff für Drittanbieter-Apps eingeschränkt. Ein Atlassian-Organisationsadministrator muss ihn unter admin.atlassian.com → Sicherheit → Zugriff für Drittanbieter-Apps aktivieren.

Integration in Goodweek nicht sichtbar

Stelle sicher, dass dein Organisationsadministrator die Jira-Integration im Goodweek-Admin-Panel unter dem Tab Integrationen aktiviert hat.

Referenzen

Hat dies deine Frage beantwortet?