Zum Inhalt springen

Jira-Connector für Jitterbit Integration Studio

Zusammenfassung

Der Jira-Connector ermöglicht den Zugriff auf Jira.

Der Jira-Connector bietet eine Schnittstelle zur Erstellung einer Jira-Verbindung, die Grundlage für die Generierung von Instanzen von Jira-Aktivitäten. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, ü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 Standardbenutzerdefinierte Felder. Erweiterte benutzerdefinierte Felder werden nicht unterstützt.

Der Jira-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Tipp

Integrationsrezepte und Prozessvorlagen sind über den Jitterbit Marketplace für diesen Connector verfügbar.

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Jira-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) gedacht sind.

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

Jira-Aktivitätstypen

  • Suche: Ruft Objektdaten aus einem Jira-Projekt ab und ist als Quelle in einem Vorgang gedacht.

  • Problem: Erstellt, aktualisiert oder löscht ein Problem in einem Jira-Projekt und ist als Ziel in einem Vorgang gedacht.

  • Erstellen: Erstellt Objektdaten in einem Jira-Projekt und ist als Ziel in einem Vorgang gedacht.

  • Aktualisieren: Aktualisiert Objektdaten in einem Jira-Projekt und ist als Ziel in einem Vorgang gedacht.

  • Such-Dashboard: Ruft Dashboard-Daten von Jira ab und ist als Quelle in einem Vorgang vorgesehen.

  • Löschen: Löscht Objektdaten von Jira und ist als Ziel in einem Vorgang vorgesehen.

  • Übergang: Ruft Jira-Probleme ab oder aktualisiert sie und ist als Ziel in einem Vorgang vorgesehen.

  • Suchfilter: Ruft Filterdaten von Jira ab und ist als Quelle in einem Vorgang vorgesehen.

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit verweisen kann, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Endpunkte, die mit diesem Connector erstellt wurden, sind in Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Der Jira-Connector erfordert die Verwendung einer Agenten-Version 10.1 oder höher. Diese Agenten-Versionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

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

Hinweis

Für Jira Cloud Instanzen hat Atlassian seinen JQL (POST) API-Endpunkt eingestellt. Ab der Harmony 11.50-Version verwendet die Suchaktivität nun die JQL erweiterte Suche (POST). Siehe Atlassians Änderungsprotokoll für Unterschiede zwischen den neuen und alten API-Endpunkten.

Der 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-beinige OAuth 2.0-Authentifizierung für Agentenversion 10.83 / 11.21 oder höher.

Fehlerbehebung

Wenn Probleme mit dem Jira-Connector auftreten, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Test-Schaltfläche in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, die Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie wird verwendet).

  2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  3. Aktivieren Sie das Debug-Protokoll für den Betrieb (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Wenn Sie private Agenten verwenden, können Sie das ausführliche Protokollieren des Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

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

    Weitere Informationen zum ausführlichen Protokollieren von Connectors finden Sie unter Ausführliches Protokollieren für Connectors, die Jitterbit private Agenten verwenden.

  5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle auf weitere Informationen überprüfen.

  6. Für zusätzliche Überlegungen zur Fehlerbehebung siehe Betriebsfehlerbehebung.