Zum Inhalt springen

Jira Verbindungshandbuch für Jitterbit App Builder

Diese Verbindungsanleitung führt Sie Schritt für Schritt durch die Verbindung App Builder zu Jira. Jira ist ein Bug-Tracking-Tool, das im agilen Projektmanagement verwendet wird und Teil der Atlassian-Produktsuite ist.

Warnung

Nach dem Herstellen einer Jira-Verbindung zu App Builder müssen Sie die Logik zur Anzeige von Jira-Daten auf der Seite einschränken, damit nicht alle Datensätze abgefragt werden. Andernfalls kann es zu App Builder App scheint nicht zu reagieren.

Voraussetzungen

  • Sie müssen über ein Atlassian-Konto verfügen
  • Sie müssen über einen gültigen API Token für das Atlassian-Konto verfügen

Konfiguration in Atlassian

Erstellen Sie ein API Token aus Ihrem Atlassian-Konto:

  1. Melden Sie sich bei https://id.atlassian.com/manage-profile/security/api-tokens an.
  2. Klicken Sie auf API Token erstellen
  3. Geben Sie eine klare und prägnante Bezeichnung für das Token ein und klicken Sie auf Erstellen
  4. Klicken Sie auf In die Zwischenablage kopieren und fügen Sie das Token an einem sicheren Ort ein, um es zu speichern. Diese Informationen werden in der App Builder Konfigurationsschritte.

Konfiguration in App Builder

Erstellen Sie einen Jira Datenserver

  1. Navigieren Sie zu App Builder IDE
  2. Klicken Sie im Menü Verbinden auf Datenserver
  3. Klicken Sie auf die Schaltfläche + Server und geben Sie die folgenden Informationen ein:

    • Servername: Identifizierbarer Name für die Serververbindung. Beispiel: Jira
    • Typ: Jira
    • Url: Basisdomäne für die Atlassian Cloud-Instanz. Beispiel: https://yourcompany.atlassian.net/
  4. Klicken Sie auf Speichern

  5. Klicken Sie auf die Schaltfläche Erweiterte Einstellungen
  6. Klicken Sie auf Bearbeiten
  7. Geben Sie den API Token im Feld Erweitert ein, und verwenden Sie dabei das Format APIToken=<yourAPIToken>

    Beispiel für einen API Token-Wert, der im erweiterten Feld eingegeben wurde

  8. Klicken Sie auf Speichern

Importieren Sie die Jira Daten zur Anzeige in App Builder

  1. Navigieren Sie zu App Builder IDE
  2. Klicken Sie im Menü Verbinden auf Datenserver
  3. Suchen Sie die Jira-Datenquelle und klicken Sie im rechten Bereich auf die Schaltfläche Details
  4. Klicken Sie auf die Schaltfläche Importieren
  5. Bestimmen Sie, welches Schema Sie importieren möchten:

    • Importieren aus Muster: Ermöglicht Ihnen, nur die in diesem Feld angegebenen Tabellen zu importieren. Präfixe können verwendet werden, um nur eine Teilmenge der Tabellen zu importieren, zum Beispiel MyApp_* importiert nur Tabellen beginnend mit MyApp_. Wenn Sie das Feld leer lassen, werden alle Tabellen importiert.
    • Klicken Sie auf Fortfahren, wenn Sie dazu aufgefordert werden. App Builder führt den Import als Hintergrundaufgabe aus.
    • Die Registerkarten Tabellen, Ansichten und Prozeduren listen alle verfügbaren Optionen zusammen mit den entsprechenden Schaltflächen Schema importieren auf.

Nach dem Importieren der Daten können Sie eine Business-Logik erstellen, die Sie in Panels verwenden können, um Jira Daten auf Seiten in Ihrem App Builder App.

Fehlerbehebung

  • Wenn Sie keine Optionen für die Jira Datenquelle sehen, finden Sie im App Builder Schaltfläche Importieren. Überprüfen Sie, ob Sie ein gültiges API Token eingegeben haben.
  • Wenn App Builder beim Laden einer App-Seite mit Jira-Daten nicht zu reagieren scheint oder Jira die Meldung „Etwas ist schiefgelaufen“ anzeigt, überprüfen Sie die verwendete Logik, um sicherzustellen, dass die zurückgegebenen Daten auf sinnvollere Kriterien beschränkt werden.