Jira-Integration

Conceptboard integriert Jira direkt in Ihre Boards und setzt Ideen in die Tat um. Importieren Sie Jira-Tickets als Board-Aufgaben, verwalten Sie Status und Verantwortliche und halten Sie alles synchron.

Jira mit Ihrem Conceptboard-Konto verbinden

So finden Sie die Jira-Integration in Boards:

1. Öffnen Sie das Board-Menü.
2. Wählen Sie „Dienste verbinden“ → „Jira“.
3. Wählen Sie im angezeigten Fenster „Mit Jira verbinden“.
4. Melden Sie sich in Ihrem Jira-Konto an.
5. Wählen Sie „Weiter“, wenn das angezeigte Konto das richtige ist.
   1. Falls es sich nicht um das richtige Konto handelt, können Sie „Anderes Konto verwenden“ wählen, um das gewünschte Konto zu finden.
   2. Wenn Sie ein Konto aus den verfügbaren Optionen entfernen möchten, wählen Sie „Konto entfernen“.
6. Melden Sie sich bei dem ausgewählten Konto an.
7. Wählen Sie „Akzeptieren“, um den Zugriff auf Ihr Jira-Konto zu erlauben.
8. Ihr Jira- und Conceptboard-Konto sind nun verbunden.

Jira-Tickets zum Board hinzufügen

Sie können auf zwei Arten auf das Suchmenü für Jira zugreifen.

1. Über das Menü „Dienste verbinden“:

Die Suchleiste für Jira-Tickets öffnet sich nach dem Anmelden automatisch. Um weitere Tickets hinzuzufügen, öffnen Sie „Dienste verbinden“ und wählen Sie „Jira-Issues importieren“.

2. Über das Menü „Einfügen“ -> „Widgets & Plugins“

• Wählen Sie „Widget einfügen“ aus.
• Wählen Sie anschließend „Jira issues“ aus.

Sobald Sie Zugriff auf das Suchmenü für Jira-Tickets haben, können Sie:

1. Wählen Sie den Jira-Bereich aus, dessen Tickets Sie anzeigen möchten.
2. Wählen Sie mithilfe der Suchleiste die Tickets aus, die Sie integrieren möchten.
3. Aktivieren Sie die Option „Per JQL-Abfrage suchen“ oben rechts im Menü, um die erweiterte Suche zu nutzen.
4. Wählen Sie ein oder mehrere Tickets aus, indem Sie das Kontrollkästchen links aktivieren.
   1. Scrollen Sie nach unten, um weitere Tickets zu laden. Bei jedem Scrollen bis zum Ende der Liste werden 20 Tickets nachgeladen.
   2. Um alle durch das Scrollen bereits geladenen Tickets auszuwählen, setzen Sie ein Häkchen in das Kontrollkästchen oben links neben dem Feld [TYPE].
   3. Um alle Tickets aus den Suchergebnissen einzufügen, scrollen Sie zunächst so weit nach unten, bis alle Tickets geladen sind. Wählen Sie anschließend alle Tickets aus, indem Sie das Kontrollkästchen oben links neben dem Feld [TYPE] ankreuzen.
5. Klicken Sie auf die Schaltfläche „(X) Issue(s) importieren“.
6. Das Suchmenü schließt sich automatisch.
7. Die Tickets werden als Board-Aufgaben hinzugefügt.
8. Die Jira-Aufgaben werden nacheinander in der Mitte Ihres Bildschirms angezeigt.

Jira-Tickets als Board-Aufgaben

Eine Jira-Aufgabe zeigt folgende Informationen an:

• Vorgangszusammenfassung
• Vorgangsstatus
• Vorgangsendedatum
• Vorgangsschlüssel und -link
• Letzte Synchronisierung
• Jira-Symbol

Die schwebende Symbolleiste umfasst folgende Funktionen:

• Farbe: Ändert die Farbe der Aufgaben.
• Label: Benutzerdefinierte Labels für die Aufgaben auf diesem Board (nicht mit der Jira-Label-Funktion verknüpft, exklusiv für Conceptboard)
• Aus Jira synchronisieren: Überträgt alle Aufgabenwerte aus dem Jira-Ticket an Conceptboard.
• Mit Jira synchronisieren: Überträgt alle Aufgabenwerte aus der Conceptboard-Aufgabe an Jira.
• Aufgabe bearbeiten: Wählen Sie „Aufgabe bearbeiten“, um weitere Felder zu bearbeiten, die nicht direkt in der Aufgabe sichtbar sind.

Wenn eine Jira-Aufgabe synchronisiert wird, zeigen wir diesen Status auf dem Board auf drei Arten an:

• eine Meldung in der oberen linken Ecke des Boards
• eine Kopie dieser Meldung im unteren Bereich der Aufgabe
• die Aufgabe ist zudem für alle Benutzer auf dem Board deaktiviert (ausgegraut), bis die Synchronisierung abgeschlossen ist

Jira-Aufgabe bearbeiten / Aufgabendetails

Sie können eine detaillierte Ansicht der Jira-Aufgabe aufrufen:

1. Die Aufgabe auswählen.
2. In der schwebenden Symbolleiste die Option „Aufgabe bearbeiten“ wählen.
3. Es öffnet sich ein Popup mit den Aufgabendetails.

Das Popup enthält:

• Vorgangslink
• Vorgangstyp
• Priorität
• Zusammenfassung
• Zugewiesene Person
• Ersteller
• Status
• Enddatum

So aktualisieren Sie die Aufgabe sowohl in Conceptboard als auch in Jira:

1. Wählen Sie die Schaltfläche „Aufgabe aktualisieren“.
2. Wählen Sie „Abbrechen“, um alle Änderungen zu verwerfen.

Jira-Konto von Conceptboards-Boards trennen

So trennen Sie Ihr Jira-Konto von Conceptboard:

1. Board-Menü öffnen
2. „Dienste verbinde “ auswählen
3. „Jira“ auswählen → „Jira-Account trennen“ (Diese Option ist nur verfügbar, wenn Sie bereits in einem Konto eingeloggt sind)

Wenn Sie eine On-Prem-Version von Jira nutzen

Unsere Jira-Integration ist auch für On-Prem-Lösungen verfügbar.

Bitte wenden Sie sich an Ihren Conceptboard-Kundenbetreuer für die Unterstützung bei der Einrichtung. Unser Support-Team benötigt dazu folgende Informationen von Ihnen:

• URL der Jira-API (base_url)

• Genaue Version Ihrer Jira-API (meistens Version 2)

• Authentifizierungsmethode:

  • PAT: Personal Access Token (Persönliches Zugriffstoken)

  • Basic Authentication (Basisauthentifizierung)

Suchverhalten in Jira und Jira On-Prem

Die einfache Suche verhält sich je nach Jira-Bereitstellung unterschiedlich:

• Jira Cloud unterstützt die Suche nach Vorgangsschlüsseln (z. B. ABC-12) sowie nach anderen durchsuchbaren Feldern.
• Jira On-Prem verwendet für die einfache Suche eine ältere Jira-API. Daher werden nur die Zusammenfassung (Summary) und die Beschreibung des Vorgangs durchsucht; eine direkte Suche nach dem Vorgangsschlüssel wird nicht unterstützt.

Warum erhalte ich unerwartete Suchergebnisse?

Wenn Sie nach einem Vorgangsschlüssel wie ABC-12 suchen, liefert Jira On-Prem möglicherweise auch andere Vorgänge, falls dieser Schlüssel in deren Zusammenfassung oder Beschreibung vorkommt (z. B. als Referenz auf einen anderen Vorgang).

Für möglichst präzise Ergebnisse in Jira On-Prem empfehlen wir, wann immer möglich JQL (Jira Query Language) zu verwenden.

Fehlerbehebung

Fehler 401 bei nicht autorisierter Anfrage

Beschreibung:

• Nutzer können die Jira-Integration nicht verwenden.
• Beim Öffnen des Fensters zur Suche nach Jira-Issues erscheint oben links auf dem Board eine Fehlermeldung.
• Beim Versuch, Jira-Issues mit Jira zu synchronisieren, erscheint oben links auf dem Board eine Fehlermeldung.

Woran liegt das?

Die Verbindung zur Jira-API wird regelmäßig unterbrochen.

Dies ist ein von der Jira-API so vorgesehenes Verhalten. Es steht in keinem Zusammenhang mit der Einrichtung der Conceptboard-Integration.

Was ist zu tun?

1. Trennen Sie die Verbindung Ihres Jira-Kontos von Conceptboard

2. Verbinden Sie Ihr Jira-Konto erneut

3. Es sollte nun ordnungsgemäß funktionieren