Jira Software Module
In einem Adobe Workfront Fusion -Szenario können Sie Workflows automatisieren, die Jira Software verwenden, und sie mit mehreren Anwendungen und Diensten von Drittanbietern verbinden.
Wenn Sie Anweisungen zum Erstellen eines Szenarios benötigen, finden Sie weitere Informationen unter Erstellen eines Szenarios in Adobe Workfront Fusion.
Weitere Informationen zu Modulen finden Sie unter Module in Adobe Workfront Fusion.
Zugriffsanforderungen
Sie müssen über den folgenden Zugriff verfügen, um die Funktionalität in diesem Artikel verwenden zu können:
Wenden Sie sich an Ihren Workfront -Administrator, um zu erfahren, welchen Plan, welchen Lizenztyp oder welchen Zugriff Sie haben.
Informationen zu Adobe Workfront Fusion -Lizenzen finden Sie unter Adobe Workfront Fusion Lizenzen
Voraussetzungen
Um Jira -Module zu verwenden, müssen Sie über ein Jira -Konto verfügen.
Jira-API-Informationen
Der Jira-Connector verwendet Folgendes:
Jira Software mit Workfront Fusion verbinden
Ihre Verbindungsmethode basiert darauf, 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 Dienst-URL und Ihrem Benutzernamen in das Feld Verbindung erstellen in Workfront Fusion einfügen.
API-Token in Jira erstellen
-
Gehen Sie zu https://id.atlassian.com/manage/api-tokens und melden Sie sich an.
-
Klicken Sie auf API-Token erstellen.
-
Geben Sie einen Namen für das Token ein, z. B. Workfront Fusion.
-
Kopieren Sie das Token mithilfe der Schaltfläche In die Zwischenablage kopieren .
note important IMPORTANT Sie können das Token nach dem Schließen dieses Dialogfelds nicht erneut anzeigen. 1. Speichern Sie das generierte Token an einem sicheren Ort.
-
Fahren Sie mit Konfigurieren des Jira API-Tokens in Workfront Fusion fort.
Konfigurieren des Jira-API-Tokens in Workfront Fusion
-
Fügen Sie in Workfront Fusion ein Jira -Modul zu einem Szenario hinzu, um das Feld Verbindung erstellen zu öffnen.
-
Geben Sie die folgenden Informationen an:
- Dienst-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 API-Token in Jira dieses Artikels erstellen.
- Dienst-URL: Dies ist die Basis-URL, mit der Sie auf Ihr Jira-Konto zugreifen. Beispiel:
-
Klicken Sie auf Weiter , 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 Kundenschlüssel, Ihren privaten Schlüssel und Ihre Dienst-URL. Möglicherweise müssen Sie sich für diese Informationen an Ihren Jira -Administrator wenden.
Öffentlichen und privaten Schlüssel für Ihre Jira-Verbindung generieren
Um einen privaten Schlüssel für Ihre Workfront Fusion Jira-Verbindung zu erhalten, müssen Sie öffentliche und private Schlüssel generieren.
-
Führen Sie in Ihrem Terminal die folgenden
openssl-Befehle 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 365Mit diesem Befehl wird ein X509-Zertifikat erstellt.
-
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8Dieser Befehl extrahiert den privaten Schlüssel (PKCS8-Format) in den
jira_privatekey.pcks8
-Datei. -
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pemMit diesem Befehl wird der öffentliche Schlüssel aus dem Zertifikat in die Datei
jira_publickey.pemextrahiert.note note NOTE Wenn Sie Windows verwenden, müssen Sie den öffentlichen Schlüssel möglicherweise manuell in der Datei jira_publickey.pemspeichern:-
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 namens
jira_publickey.pemein.
-
-
-
Fahren Sie mit Konfigurieren der Client-App als Verbraucher in Jira fort.
Konfigurieren der Client-App als Verbraucher in Jira
-
Melden Sie sich bei Ihrer Jira -Instanz an.
-
Klicken Sie im linken Navigationsfenster auf JiraEinstellungen
-
Geben Sie im Feld die URL der Anwendung ein, die Sie verknüpfen möchten .
code language-none https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1 -
Klicken Sie auf Neuen Link erstellen. Ignorieren Sie die Fehlermeldung "Von der eingegebenen URL wurde keine Antwort empfangen".
-
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 Kontrollkästchen Eingehenden Link erstellen .
-
Klicken Sie auf 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-Schlüssel ein, den Sie an einen sicheren Speicherort kopiert haben. Kundenname Geben Sie einen Namen Ihrer Wahl ein. Dieser Name dient Ihrer eigenen Referenz. Public key Fügen Sie den öffentlichen Schlüssel aus Ihrer jira_publickey.pem-Datei ein. -
Klicken Sie auf Weiter.
-
Fahren Sie mit Erstellen einer Verbindung zu Jira Server oder Jira Data Center in Workfront Fusion fort.
Erstellen einer Verbindung zu Jira Server oder Jira Data Center in Workfront Fusion
-
Klicken Sie in einem beliebigen Jira Server-Modul in Workfront Fusion auf Hinzufügen neben dem Feld Verbindung .
-
Füllen Sie im Bereich Verbindung erstellen die folgenden Felder aus:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Verbindungsname Geben Sie einen Namen für die Verbindung ein Consumer Key Fügen Sie den Consumer-Schlüssel ein, den Sie in Client-App als Verbraucher konfigurieren in Jira an einen sicheren Speicherort kopiert haben. Private Key Fügen Sie den privaten Schlüssel aus der Datei jira_privatekey.pcks8ein, die Sie unter Öffentliche und private Schlüssel für Ihre Jira Verbindung generieren erstellt haben.Service URL Geben Sie Ihre Jira Instanz-URL ein. Beispiel: yourorganization.atlassian.net -
Klicken Sie auf Weiter , um die Verbindung zu erstellen und zum Modul zurückzukehren.
Jira Software Module und ihre Felder
Wenn Sie Jira Software -Module konfigurieren, 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 im Dienst zusätzliche Jira Software -Felder angezeigt werden. Ein fett hervorgehobener Titel in einem Modul zeigt ein erforderliches Feld an.
Wenn Sie die Zuordnungsschaltfläche über einem Feld oder einer Funktion sehen, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Informationen von einem Modul einem anderen zuordnen in Adobe Workfront Fusion.
Trigger
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.
Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.
Erstellen eines Datensatzes
Dieses Aktionsmodul erstellt einen neuen Datensatz in Jira.
Das Modul gibt alle mit dem Datensatz verknüpften Standardfelder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.
Benutzerspezifischer API-Aufruf
Mit diesem Aktionsmodul können Sie einen benutzerdefinierten authentifizierten Aufruf an die Jira Software -API durchführen. Auf diese Weise können Sie eine Datenflussautomatisierung erstellen, die von anderen Jira Software -Modulen nicht ausgeführt werden kann.
Wenn Sie dieses Modul konfigurieren, 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-Anforderungsmethoden in Adobe Workfront Fusion.
<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 Textinhalt für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.
Hinweis:
Bei Verwendung von bedingten Anweisungen wie if in Ihrer JSON platzieren Sie die Anführungszeichen außerhalb der bedingten Anweisung.
Datensatz löschen
Dieses Aktionsmodul löscht einen bestimmten Datensatz.
Sie geben die Kennung des Datensatzes an.
Das Modul gibt die Kennung 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.
Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.
Herunterladen eines Anhangs
Dieses Aktionsmodul lädt eine bestimmte Anlage herunter.
Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.
Datensatz lesen
Dieses Aktionsmodul liest Daten aus einem einzelnen Datensatz in Jira Software.
Sie geben die Kennung des Datensatzes an.
Das Modul gibt alle mit dem Datensatz verknüpften Standardfelder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.
Datensatz aktualisieren
Dieses Aktionsmodul aktualisiert einen vorhandenen Datensatz, z. B. ein Problem oder ein Projekt.
Sie geben die Kennung des Datensatzes an.
Das Modul gibt die Kennung 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.
Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.
Suchvorgänge
Listeneinträge
Dieses Suchmodul ruft alle Elemente eines bestimmten Typs ab, die Ihrer Suchabfrage entsprechen
Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.
Suche nach Datensätzen
Dieses Suchmodul sucht nach Datensätzen in einem Objekt in Jira Software, die mit der von Ihnen angegebenen Suchabfrage übereinstimmen.
Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.