Zum Inhalt springen

Jira-Connector in Jitterbit Studio

Zusammenfassung

Der Jira-Connector stellt den Zugriff auf Jira her.

Der Jira-Connector bietet eine Schnittstelle zum Erstellen einer Jira-Verbindung, die Grundlage für die Generierung von Jira-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit Jira.

Der Jira-Connector unterstützt Jira Software Cloud, Jira Server und Jira Data Center.

Hinweis

Der Jira-Connector unterstützt Standard-Benutzerdefinierte Felder. Erweiterte benutzerdefinierte Felder werden nicht unterstützt.

Der Jira-Connector wird über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Design-Komponentenpalette aufgerufen (siehe Design component palette).

Tipp

Integration recipes und process templates sind für diesen Connector über Jitterbit Marketplace verfügbar.

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Jira-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

Zusammen werden eine bestimmte Jira-Verbindung und ihre Aktivitäten als Jira-Endpunkt bezeichnet:

Jira activity types

  • Search: Ruft Objektdaten aus einem Jira-Projekt ab und soll als Quelle in einem Vorgang verwendet werden.

  • Issue: Erstellt, aktualisiert oder löscht ein Problem in einem Jira-Projekt und soll als Ziel in einem Vorgang verwendet werden.

  • Create: Erstellt Objektdaten in einem Jira-Projekt und soll als Ziel in einem Vorgang verwendet werden.

  • Update: Aktualisiert Objektdaten in einem Jira-Projekt und soll als Ziel in einem Vorgang verwendet werden.

  • Search Dashboard: Ruft Dashboard-Daten aus Jira ab und soll als Quelle in einem Vorgang verwendet werden.

  • Delete: Löscht Objektdaten aus Jira und soll als Ziel in einem Vorgang verwendet werden.

  • Transition: Ruft Jira-Probleme ab oder aktualisiert sie und soll als Ziel in einem Vorgang verwendet werden.

  • Search Filter: Ruft Filterdaten aus Jira ab und soll als Quelle in einem Vorgang verwendet werden.

Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update aussetzen.

Der Jira-Connector verwendet die Jira REST API v3 für den Instanztyp Jira Cloud und die Jira REST API v2 für den Instanztyp Jira On-premise. Weitere Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

Info

Für Jira Cloud-Instanzen hat Atlassian seinen JQL (POST)-API-Endpunkt eingestellt. Ab dem Harmony 11.50 Release verwendet die Search-Aktivität nun den JQL enhanced search (POST). Weitere Informationen zu den Unterschieden zwischen den neuen und alten API-Endpunkten finden Sie im Atlassian-Changelog.

Die Jira On-premise-Instanztyp wird mit diesen Jira Server- und Jira Data Center-Versionen unterstützt:

  • 9.17.2
  • 9.17.1
  • 9.17.0
  • 9.12.12
  • 9.12.9
  • 9.12.8
  • 9.12.7
  • 9.4.3
  • 8.22.3 (nicht empfohlen)

Dieser Connector unterstützt 3-legged OAuth 2.0-Authentifizierung für Agent-Version 10.83 / 11.21 oder später.

Fehlerbehebung

Bei Problemen mit dem Jira-Connector werden diese Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren verwendet wird).

  2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

  3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agents können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agents einfügen:

    <logger name="org.jitterbit.connector.jira" level="DEBUG"/>

    Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agents.

  5. Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.