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
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:
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 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 Verbindung erstellen in Workfront Fusion einfügen.
Erstellen eines API-Tokens in Jira
-
Erstellen Sie in Jira ein API-Token.
Für Anweisungen empfehlen wir die Suche nach „Erstellen eines API-Tokens“ in der Jira-Dokumentation.
-
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.
-
Fahren Sie fort mit Konfigurieren des Jira -API-Tokens in Workfront Fusion.
Konfigurieren des Jira-API-Tokens in Workfront Fusion
-
Klicken Sie in einem Jira Cloud Modul in Workfront Fusion auf Hinzufügen neben dem Feld Verbindung.
-
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 - Benutzername
- API-Token: Dies ist das API-Token, das Sie im Abschnitt Erstellen eines API JiraTokens in diesem Artikel erstellt haben.
-
Klicken Sie Fortfahren, um die Verbindung herzustellen 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. Dies erfolgt über das Terminal Ihres Computers. Sie können Ihr Terminal finden, indem Sie im Startmenü oder in der Computer-Suchleiste (nicht in der Browser-Suchleiste) nach Terminal suchen.
-
Führen Sie in Ihrem Terminal die folgenden
opensslBefehle aus.-
openssl genrsa -out jira_privatekey.pem 1024Dieser Befehl generiert einen privaten 1024-Bit-Schlüssel.
-
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365Dieser Befehl erstellt ein X509-Zertifikat.
-
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8Mit 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.pemMit 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.pemmöglicherweise manuell speichern:-
Führen Sie in Ihrem Terminal den folgenden Befehl aus:
openssl x509 -pubkey -noout -in jira_publickey.cer -
Kopieren Sie die Terminal-Ausgabe, einschließlich
-------BEGIN PUBLIC KEY--------und-------END PUBLIC KEY--------. -
Fügen Sie die Terminal-Ausgabe in eine Datei mit dem Namen
jira_publickey.pemein.
-
-
-
Fahren Sie fort Konfigurieren der Client-App als Verbraucher in Jira
Konfigurieren der Client-App als Verbraucher in Jira
-
Melden Sie sich bei Ihrer Jira an.
-
Klicken Sie im linken Navigationsbereich auf JiraEinstellungen
-
Geben im Feld „URL der Anwendung eingeben, die verknüpft werden soll Folgendes ein
code language-none https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1 -
Klicken Sie Neuen Link erstellen. Ignorieren Sie die Fehlermeldung „Keine Antwort von der eingegebenen URL erhalten“.
-
Geben Sie im Fenster Anwendungen verknüpfen Werte in die Felder Consumer Key und Shared Secret ein.
Sie können die Werte für diese Felder auswählen.
-
Kopieren Sie die Werte der Felder Consumer Key und Shared Secret an einen sicheren Speicherort.
Sie benötigen diese Werte später im Konfigurationsprozess.
-
Füllen Sie die URL-Felder wie folgt aus:
table 0-row-2 1-row-2 2-row-2 3-row-2 Feld Beschreibung Anfrage-Token-URL <Jira base url>/plugins/servlet/oauth/request-tokenAutorisierungs-URL <Jira base url>/plugins/servlet/oauth/authorizeZugriffstoken-URL <Jira base url>/plugins/servlet/oauth/access-token -
Aktivieren Sie das Eingehenden Link erstellen.
-
Klicken Sie Weiter.
-
Füllen Sie im Fenster Anwendungen verknüpfen 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. Kundenname Geben Sie einen Namen Ihrer Wahl ein. Dieser Name dient als Referenz. Öffentlicher Schlüssel Fügen Sie den öffentlichen Schlüssel aus Ihrer jira_publickey.pemein. -
Klicken Sie Weiter.
-
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
-
Klicken Sie in einem Jira Server Modul in Workfront Fusion auf Hinzufügen neben dem Feld Verbindung.
-
Füllen im Bedienfeld Verbindung erstellen“ 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 Verbindungsname Einen Namen für die Verbindung eingeben Umgebung Wählen Sie aus, ob Sie eine Produktions- oder eine Nicht-Produktionsumgebung verwenden. Typ 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.pcks8ein, 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 -
Klicken Sie Fortfahren, 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.
Auslöser
Auf Datensätze achten
Dieses Trigger-Modul startet ein Szenario, wenn ein Datensatz hinzugefügt, aktualisiert oder gelöscht wird.
Aktionen
Problem zum Sprint hinzufügen
Dieses Aktionsmodul fügt einem Sprint ein oder mehrere Probleme hinzu.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Datensatz erstellen
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.
Benutzerdefinierter API-Aufruf
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.
<Instance URL>/rest/api/2/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.
Fügen Sie die Abfrage für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.
Beispiel: {"name":"something-urgent"}
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.
Löschen eines Datensatzes
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.
Anlage herunterladen
Dieses Aktionsmodul lädt eine bestimmte Anlage herunter.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Datensatz lesen
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.
Aktualisieren eines Datensatzes
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.
Suchvorgänge
Einträge auflisten
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.
Suche nach Datensätzen
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.