Jira Software

In einem Adobe Workfront Fusion Szenario können Sie Workflows automatisieren, die Jira Software verwenden, und sie mit mehreren Anwendungen und Services von Drittanbietern verbinden.

Diese Anweisungen gelten sowohl für Jira Cloud- als auch für Jira Server-Module.

Anweisungen zum Erstellen eines Szenarios finden Sie in den Artikeln unter Szenarios erstellen: Artikelindex.

Informationen zu Modulen finden Sie in den Artikeln unter Module: Artikelindex.

Zugriffsanforderungen

Erweitern Sie , um die Zugriffsanforderungen für die -Funktion in diesem Artikel anzuzeigen.

Sie müssen über folgenden Zugriff verfügen, um die Funktion in diesem Artikel verwenden zu können:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-Paket Beliebig
Adobe Workfront-Lizenz

Neu: Standard

Oder

Aktuell: Arbeit oder höher

Lizenz für Adobe Workfront Fusion**

Aktuell: Keine Workfront Fusion-Lizenzanforderung.

Oder

Legacy: Workfront Fusion für Arbeitsautomatisierung und -integration

Produkt

Neu:

  • Prime oder Workfront auswählen: Ihr Unternehmen muss Adobe Workfront Fusion erwerben.
  • Ultimate Workfront-Paket: Workfront Fusion ist enthalten.

Oder

Aktuell: Ihr Unternehmen muss Adobe Workfront Fusion erwerben.

Weitere Informationen zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.

Informationen zu Adobe Workfront Fusion finden Sie unter Adobe Workfront Fusion Lizenzen.

Voraussetzungen

Um Jira Module verwenden zu können, benötigen Sie ein Jira.

Jira-API-Informationen

Der Jira-Connector verwendet Folgendes:

Jira Cloud
Jira-Server
apiVersion
2
2
apiVersionAgile
1,0
1,0
API-Tag
1.7.29
1,0,19

Jira Software mit Workfront Fusion verbinden

Ihre Verbindungsmethode hängt davon ab, ob Sie Jira Cloud oder Jira Server verwenden.

Jira Cloud mit Workfront Fusion verbinden

Jira Cloud mit Workfront Fusion verbinden

Um Jira Software mit Workfront Fusion zu verbinden, müssen Sie ein API-Token erstellen und es zusammen mit Ihrer Service-URL und Ihrem Benutzernamen in das Feld Create a connection in Workfront Fusion einfügen.

Erstellen eines API-Tokens in Jira

  1. Erstellen Sie in Jira ein API-Token.

    Für Anweisungen empfehlen wir die Suche nach „Erstellen eines API-Tokens“ in der Jira-Dokumentation.

  2. Kopieren Sie das Token nach dem Erstellen an einen sicheren Speicherort.

    note important
    IMPORTANT
    Sie können das Token nach dem Schließen dieses Dialogfelds nicht mehr anzeigen.

    1. Bewahren Sie das generierte Token an einem sicheren Ort auf.

  3. Fahren Sie fort mit Konfigurieren des Jira -API-Tokens in Workfront Fusion.

Konfigurieren des Jira-API-Tokens in Workfront Fusion

  1. Klicken Sie in einem Jira Cloud Modul in Workfront Fusion auf Add neben dem Feld connection .

  2. Geben Sie die folgenden Informationen an:

    • Umgebung
    • Typ
    • Service URL: Dies ist die Basis-URL, mit der Sie auf Ihr Jira-Konto zugreifen. Beispiel: yourorganization.atlassian.net
    • Username
    • API token: Dies ist das API-Token, das Sie im Abschnitt Erstellen eines API-Tokens Jira dieses Artikels erstellt haben.
  3. Klicken Sie auf Continue , um die Verbindung zu erstellen und zum Modul zurückzukehren.

Jira Server mit Workfront Fusion verbinden

Um eine Verbindung zwischen Workfront Fusion und Jira Server zu autorisieren, benötigen Sie Ihren Consumer Key, den privaten Schlüssel und die Service-URL. Möglicherweise müssen Sie sich für diese Informationen an Ihren Jira wenden.

Generieren von öffentlichen und privaten Schlüsseln für Ihre Jira

Um einen privaten Schlüssel für Ihre Workfront Fusion Jira-Verbindung zu erhalten, müssen Sie öffentliche und private Schlüssel generieren.

  1. Führen Sie in Ihrem Terminal die folgenden openssl Befehle aus.

    • openssl genrsa -out jira_privatekey.pem 1024

      Dieser Befehl generiert einen privaten 1024-Bit-Schlüssel.

    • openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365

      Dieser Befehl erstellt ein X509-Zertifikat.

    • openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8

      Mit diesem Befehl wird der private Schlüssel (PKCS8-Format) in die jira_privatekey.pcks8-Datei extrahiert.

    • openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem

      Mit diesem Befehl wird der öffentliche Schlüssel aus dem Zertifikat in die jira_publickey.pem-Datei extrahiert.

      note note
      NOTE
      Wenn Sie Windows verwenden, müssen Sie den öffentlichen Schlüssel in der jira_publickey.pem möglicherweise manuell speichern:
      1. Führen Sie in Ihrem Terminal den folgenden Befehl aus:

        openssl x509 -pubkey -noout -in jira_publickey.cer

      2. Kopieren Sie die Terminal-Ausgabe, einschließlich -------BEGIN PUBLIC KEY-------- und -------END PUBLIC KEY--------.

      3. Fügen Sie die Terminal-Ausgabe in eine Datei mit dem Namen jira_publickey.pem ein.

  2. Fahren Sie fort Konfigurieren der Client-App als Verbraucher in Jira

Konfigurieren der Client-App als Verbraucher in Jira

  1. Melden Sie sich bei Ihrer Jira an.

  2. Klicken Sie im linken Navigationsbereich auf Jira Settings Jira settings icon > Applications > Application links.

  3. Geben Sie in das Feld Enter the URL of the application you want to link ein.

    code language-none
    https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
    
  4. Klicken Sie auf Create new link. Ignorieren Sie die Fehlermeldung „Keine Antwort von der eingegebenen URL erhalten“.

  5. Geben Sie im Link applications-Fenster Werte in die Felder Consumer key und Shared secret ein.

    Sie können die Werte für diese Felder auswählen.

  6. Kopieren Sie die Werte der Consumer key- und Shared secret an einen sicheren Speicherort.

    Sie benötigen diese Werte später im Konfigurationsprozess.

  7. Füllen Sie die URL-Felder wie folgt aus:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Feld Beschreibung
    Request Token URL <Jira base url>/plugins/servlet/oauth/request-token
    Authorization URL <Jira base url>/plugins/servlet/oauth/authorize
    Access Token URL <Jira base url>/plugins/servlet/oauth/access-token
  8. Aktivieren Sie das Kontrollkästchen Create incoming link .

  9. Klicken Sie auf Continue.

  10. Füllen Sie im Link applications die folgenden Felder aus:

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
    Consumer Key Fügen Sie den Consumer Key ein, den Sie an einen sicheren Speicherort kopiert haben.
    Consumer name Geben Sie einen Namen Ihrer Wahl ein. Dieser Name dient als Referenz.
    Public key Fügen Sie den öffentlichen Schlüssel aus Ihrer jira_publickey.pem ein.
  11. Klicken Sie auf Continue.

  12. Fahren Sie fort Erstellen einer Verbindung mit Jira Server oder Jira Data Center in Workfront Fusion

Erstellen einer Verbindung zu Jira Server oder Jira Data Center in Workfront Fusion

NOTE
Verwenden Sie die Jira Server-App, um eine Verbindung zu Jira Server oder Jira Data Center herzustellen.
  1. Klicken Sie in einem Jira Server Modul in Workfront Fusion auf Add neben dem Feld connection .

  2. Füllen Sie im Bedienfeld Create a connection die folgenden Felder aus:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection name Einen Namen für die Verbindung eingeben
    Environment Wählen Sie aus, ob Sie eine Produktions- oder eine Nicht-Produktionsumgebung verwenden.
    Type Wählen Sie aus, ob Sie ein Service-Konto oder ein persönliches Konto verwenden.
    Consumer Key Fügen Sie den Kundenschlüssel ein, den Sie an einen sicheren Speicherort in kopiert haben Konfigurieren Sie die Client-Anwendung als Verbraucher in Jira
    Private Key Fügen Sie den privaten Schlüssel aus der jira_privatekey.pcks8 ein, die Sie in erstellt haben Generieren Sie öffentliche und private Schlüssel für Ihre Jira Verbindung.
    Service URL Geben Sie Ihre Jira-Instanz-URL ein. Beispiel: yourorganization.atlassian.net
  3. Klicken Sie auf Continue , um die Verbindung zu erstellen, und kehren Sie zum Modul zurück.

Jira Software Module und ihre Felder

Beim Konfigurieren Jira Software Module zeigt Workfront Fusion die unten aufgeführten Felder an. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der App oder dem Service weitere Jira Software angezeigt werden. Ein fett gedruckter Titel in einem Modul gibt ein erforderliches Feld an.

Wenn die Zuordnungsschaltfläche über einem Feld oder einer Funktion angezeigt wird, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Zuordnen von Informationen von einem Modul zu einem anderen.

Umschalter für Zuordnung

Auslöser

Watch for records

Dieses Trigger-Modul startet ein Szenario, wenn ein Datensatz hinzugefügt, aktualisiert oder gelöscht wird.

Webhook

Wählen Sie den Webhook aus, den Sie auf Datensätze überwachen möchten.

So fügen Sie einen neuen Webhook hinzu:

  1. Klicken Add

  2. Geben Sie einen Namen für den Webhook ein.

  3. Wählen Sie die Verbindung aus, die Sie für Ihren Webhook verwenden möchten.

    Anweisungen zum Verbinden Ihres Jira Software-Kontos mit Workfront Fusion finden Sie unter Verbinden von Jira Software mit Workfront Fusion in diesem Artikel.

  4. Wählen Sie den Datensatztyp aus, auf den die Software achten soll:

    • Comment
    • Issue
    • Project
    • Sprint

Aktionen

Add issue to sprint

Dieses Aktionsmodul fügt einem Sprint ein oder mehrere Probleme hinzu.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Connection
Anweisungen zum Verbinden Ihres Jira Software-Kontos mit Workfront Fusion finden Sie unter Verbinden von Jira Software mit Workfront Fusion in diesem Artikel.
Sprint ID
Geben Sie die Sprint-ID des Sprints ein, dem Sie ein Problem hinzufügen möchten, oder ordnen Sie sie zu.
Issue ID or Keys
Klicken Sie für jedes Problem bzw. jeden Schlüssel, das bzw. den Sie anzeigen möchten, auf Add item und geben Sie die Problem-ID oder den Schlüssel ein. Sie können bis zu 50 in einem Modul eingeben.

Create a Record

Dieses Aktionsmodul erstellt einen neuen Datensatz in Jira.

Das Modul gibt alle Standardfelder zurück, die mit dem Datensatz verknüpft sind, sowie alle benutzerdefinierten Felder und Werte, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Connection
Anweisungen zum Verbinden Ihres Jira Software-Kontos mit Workfront Fusion finden Sie unter Verbinden von Jira Software mit Workfront Fusion in diesem Artikel.
Record Type

Wählen Sie den Typ des Datensatzes aus, den das Modul erstellen soll, und füllen Sie dann die anderen Felder aus, die für diesen Datensatztyp spezifisch sind und im Modul angezeigt werden.

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
  • Worklog

Custom API Call

Mit diesem Aktionsmodul können Sie einen benutzerdefinierten authentifizierten Aufruf an die Jira Software-API durchführen. Verwenden Sie dieses Modul, um eine Datenflussautomatisierung zu erstellen, die von den anderen Jira Software nicht durchgeführt werden kann.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anfragemethoden.

Connection
Anweisungen zum Verbinden Ihres Jira Software-Kontos mit Workfront Fusion finden Sie unter Verbinden von Jira Software mit Workfront Fusion in diesem Artikel.
URL
Pfad eingeben für<Instance URL>/rest/api/2/
Method
Headers

Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu.

Beispiel: {"Content-type":"application/json"}

Workfront Fusion Fügt die Autorisierungskopfzeilen für Sie hinzu.

Query String

Fügen Sie die Abfrage für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.

Beispiel: {"name":"something-urgent"}

Body

Fügen Sie den Hauptteil des Inhalts für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.

Hinweis:

Wenn Sie bedingte Anweisungen wie if in Ihrer JSON-Datei verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.

Delete a record

Dieses Aktionsmodul löscht den angegebenen Datensatz.

Sie geben die ID des Datensatzes an.

Das Modul gibt die ID des Datensatzes und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Connection
Anweisungen zum Verbinden Ihres Jira Software-Kontos mit Workfront Fusion finden Sie unter Verbinden von Jira Software mit Workfront Fusion in diesem Artikel.
Record Type

Wählen Sie den Typ des Datensatzes aus, den das Modul löschen soll.

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
ID or Key
Geben Sie die ID oder den Schlüssel des Datensatzes ein, den Sie löschen möchten, oder ordnen Sie sie zu.

Download an attachment

Dieses Aktionsmodul lädt eine bestimmte Anlage herunter.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Connection
Anweisungen zum Verbinden Ihres Jira Software-Kontos mit Workfront Fusion finden Sie unter Verbinden von Jira Software mit Workfront Fusion in diesem Artikel.
ID
Geben Sie die ID des Anhangs ein, den Sie herunterladen möchten, oder mappen Sie sie.

Read a record

Dieses Aktionsmodul liest Daten aus einem einzelnen Datensatz in Jira Software.

Sie geben die ID des Datensatzes an.

Das Modul gibt alle Standardfelder zurück, die mit dem Datensatz verknüpft sind, sowie alle benutzerdefinierten Felder und Werte, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Connection
Anweisungen zum Verbinden Ihres Jira Software-Kontos mit Workfront Fusion finden Sie unter Verbinden von Jira Software mit Workfront Fusion in diesem Artikel.
Record Type

Wählen Sie den Typ Jira Datensatzes aus, den das Modul lesen soll.

  • Attachment
  • Issue
  • Project
  • Sprint
  • User
Outputs
Wählen Sie die Ausgaben aus, die Sie empfangen möchten. Je nach dem im Feld "Record Type" ausgewählten Datensatztyp stehen Ausgabeoptionen zur Verfügung.
ID
Geben Sie die eindeutige Jira Software-ID des Datensatzes ein, den das Modul lesen soll, oder mappen Sie sie.

Update a record

Dieses Aktionsmodul aktualisiert einen vorhandenen Datensatz, z. B. ein Problem oder Projekt.

Sie geben die ID des Datensatzes an.

Das Modul gibt die ID des Datensatzes und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Connection
Anweisungen zum Verbinden Ihres Jira Software-Kontos mit Workfront Fusion finden Sie unter Verbinden von Jira Software mit Workfront Fusion in diesem Artikel.
Record Type

Wählen Sie den Typ des Datensatzes aus, den das Modul aktualisieren soll. Wenn Sie einen Datensatztyp auswählen, werden im Modul andere für diesen Datensatztyp spezifische Felder angezeigt.

  • Comment
  • Issue
  • Project
  • Sprint
  • Transition issue
ID or Key
Geben Sie die ID oder den Schlüssel des Datensatzes, den Sie aktualisieren möchten, ein oder ordnen Sie ihn zu und füllen Sie dann die anderen Felder aus, die für diesen Datensatztyp spezifisch sind und im Modul angezeigt werden.

Suchvorgänge

List records

Dieses Suchmodul ruft alle Elemente eines bestimmten Typs ab, die Ihrer Suchanfrage entsprechen

Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Connection
Anweisungen zum Verbinden Ihres Jira Software-Kontos mit Workfront Fusion finden Sie unter Verbinden von Jira Software mit Workfront Fusion in diesem Artikel.
Record Type

Wählen Sie den Datensatztyp aus, den das Modul auflisten soll. Wenn Sie einen Datensatztyp auswählen, werden im Modul andere für diesen Datensatztyp spezifische Felder angezeigt.

  • Comment
  • Issue
  • Project
  • Sprint issue
  • Worklog
Max Results
Geben Sie die maximale Anzahl von Datensätzen ein, die das Modul während jedes Szenario-Ausführungszyklus abrufen soll, oder mappen Sie sie.

Search for records

Dieses Suchmodul sucht in einem -Objekt nach Datensätzen, Jira Software mit der angegebenen Suchanfrage übereinstimmen.

Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Connection
Anweisungen zum Verbinden Ihres Jira Software-Kontos mit Workfront Fusion finden Sie unter Verbinden von Jira Software mit Workfront Fusion in diesem Artikel.
Record Type

Wählen Sie den Typ des Datensatzes aus, nach dem das Modul suchen soll. Wenn Sie einen Datensatztyp auswählen, werden im Modul andere für diesen Datensatztyp spezifische Felder angezeigt.

  • Issues

  • Issues by JQL (Jira Query Lanuguage)

    Weitere Informationen zu JQL finden Sie unter JQL auf der Atlassian-Hilfeseite.

  • Project

  • Project by issue

  • User

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3