Jira-Verbindungsanleitung für Jitterbit App Builder

Diese Verbindungsanleitung führt Sie durch den Prozess, wie Sie den App Builder mit Jira verbinden. Jira ist ein Fehlerverfolgungstool, das im agilen Projektmanagement verwendet wird und Teil der Atlassian-Produktreihe ist.

Voraussetzungen

• Sie müssen ein Atlassian-Konto haben
• Sie müssen ein gültiges API-Token für das Atlassian-Konto haben

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 den Konfigurationsschritten des App Builders benötigt.

Konfiguration im App Builder

Erstellen Sie einen Jira-Datenserver

1. Navigieren Sie zur IDE des App Builders
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. Zum Beispiel: Jira
   • Typ: Jira
   • Url: Basisdomain für die Atlassian Cloud-Instanz. Zum 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 das API-Token im Feld Erweitert im Format APIToken=<yourAPIToken> ein

   

8. Klicken Sie auf Speichern

Importieren Sie die Jira-Daten zur Anzeige im App Builder

1. Navigieren Sie zum App Builder IDE
2. Klicken Sie im Menü Connect auf Data Servers
3. Suchen Sie die Jira-Datenquelle und klicken Sie im rechten Bereich auf die Schaltfläche Details
4. Klicken Sie auf die Schaltfläche Import

5. Bestimmen Sie, welches Schema Sie importieren möchten:

   • Import From Pattern: Ermöglicht es Ihnen, nur die in diesem Feld angegebenen Tabellen zu importieren. Präfixe können verwendet werden, um nur eine Teilmenge von Tabellen zu importieren, zum Beispiel MyApp_* importiert nur Tabellen, die mit MyApp_ beginnen. Wenn das Feld leer bleibt, werden alle Tabellen importiert.
   • Klicken Sie auf Proceed, wenn Sie dazu aufgefordert werden. Der App Builder führt den Import als Hintergrundaufgabe aus.
   • Die Registerkarten Tables, Views und Procedures listen alle verfügbaren Optionen zusammen mit den entsprechenden Import Schema-Schaltflächen auf.

Nachdem Sie die Daten importiert haben, können Sie Geschäftslogik erstellen, um auf Panels Jira-Daten in Ihrer App Builder-App anzuzeigen.

Troubleshooting

Wenn Sie Probleme mit Jira haben, werden die folgenden Schritte zur Fehlersuche empfohlen:

1. Aktivieren Sie Datenprotokollierung, um Protokolldateien und Daten zu generieren, die Sie herunterladen und überprüfen können.

2. Konsultieren Sie die CData ADO.NET Provider für Jira-Dokumentation für detaillierte Informationen.

3. Einige spezifische Fehler sind unten aufgeführt, zusammen mit vorgeschlagenen Schritten zur Fehlersuche:

   • Wenn Sie keine Optionen für die Jira-Datenquelle von der Schaltfläche Import im App Builder sehen, überprüfen Sie, ob Sie ein gültiges API-Token eingegeben haben.

   • Wenn der App Builder nicht reagiert, während er versucht, eine App-Seite mit Jira-Daten zu laden, oder Jira eine Nachricht "Etwas ist schiefgelaufen" anzeigt, überprüfen Sie die verwendete Logik, um sicherzustellen, dass sie die zurückgegebenen Daten auf vernünftigere Kriterien einschränkt.