DokumentationWorkfrontAnvändarhandbok om Workfront

Jira Software moduler

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Användare

I ett Adobe Workfront Fusion-scenario kan du automatisera arbetsflöden som använder Jira Software samt ansluta det till flera tredjepartsprogram och -tjänster.

Om du behöver instruktioner om hur du skapar ett scenario kan du läsa Skapa ett scenario i Adobe Workfront Fusion.

Mer information om moduler finns i Moduler i Adobe Workfront Fusion.

Åtkomstkrav

Du måste ha följande åtkomst för att kunna använda funktionerna i den här artikeln:

Adobe Workfront plan*
Pro eller högre
Adobe Workfront licens*
Plan, Work
Adobe Workfront Fusion licens**

Aktuellt licenskrav: Inget Workfront Fusion-licenskrav.

eller

Gammalt licenskrav: Workfront Fusion för Automatisering och integrering av arbetet

Produkt

Aktuellt produktkrav: Om du har planen Select eller Prime Adobe Workfront måste din organisation köpa både Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln. Workfront Fusion ingår i planen Ultimate Workfront.

eller

Äldre produktkrav: Din organisation måste köpa Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln.

Kontakta Workfront-administratören om du vill ta reda på vilken plan, licenstyp eller åtkomst du har.

Mer information om Adobe Workfront Fusion licenser finns i Adobe Workfront Fusion licenser

Förutsättningar

Om du vill använda Jira moduler måste du ha ett Jira-konto.

Jira API-information

Jira-anslutningen använder följande:

Jira Cloud
Jira Server
apiVersion
2
2
apiVersionAgile
1,0
1,0
API-tagg
1.7.29
1.0.19

Anslut Jira Software till Workfront Fusion

Anslutningsmetoden baseras på om du använder Jira Cloud eller Jira Server.

Anslut Jira Cloud till Workfront Fusion

Anslut Jira Cloud till Workfront Fusion

Om du vill ansluta Jira Software till Workfront Fusion måste du skapa en API-token och infoga den tillsammans med din tjänst-URL och ditt användarnamn i fältet Create a connection i Workfront Fusion.

Skapa en API-token i Jira

  1. Gå till https://id.atlassian.com/manage/api-tokens och logga in.

  2. Klicka på Create API token.

  3. Ange ett namn för token, till exempel Workfront Fusion.

  4. Kopiera token med knappen Copy to clipboard.

    note important
    IMPORTANT
    Du kan inte visa variabeln igen när du har stängt den här dialogrutan.

    1. Lagra den genererade token på en säker plats.

  5. Fortsätt med Konfigurera Jira API-token i Workfront Fusion.

Konfigurera API-token Jira i Workfront Fusion

  1. I Workfront Fusion lägger du till en Jira-modul i ett scenario för att öppna rutan Create a connection.

  2. Ange följande information:

    • Service URL: Detta är den bas-URL som du använder för att komma åt ditt Jira-konto. Exempel: yourorganization.atlassian.net
    • Username
    • API token: Detta är den API-token som du skapade i avsnittet Skapa en API-token i Jira i den här artikeln.

  3. Klicka på Continue för att skapa anslutningen och återgå till modulen.

Anslut Jira Server till Workfront Fusion

Om du vill auktorisera en anslutning mellan Workfront Fusion och Jira Server behöver du din konsumentnyckel, privata nyckel och tjänst-URL. Du kan behöva kontakta din Jira-administratör för att få tillgång till den här informationen.

Generera offentliga och privata nycklar för din Jira-anslutning

Om du vill hämta en privat nyckel för din Workfront Fusion Jira-anslutning måste du generera offentliga och privata nycklar.

  1. Kör följande openssl-kommandon i terminalen.

    • openssl genrsa -out jira_privatekey.pem 1024

      Det här kommandot genererar en 1024-bitars privat nyckel.

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

      Det här kommandot skapar ett X509-certifikat.

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

      Det här kommandot extraherar den privata nyckeln (PKCS8-format) till jira_privatekey.pcks8
      -fil.

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

      Det här kommandot extraherar den offentliga nyckeln från certifikatet till filen jira_publickey.pem.

      note note
      NOTE
      Om du använder Windows kan du behöva spara den offentliga nyckeln till filen jira_publickey.pem manuellt:

      1. Kör följande kommando i terminalen:

        openssl x509 -pubkey -noout -in jira_publickey.cer

      2. Kopiera terminalutdata (inklusive -------BEGIN PUBLIC KEY-------- och -------END PUBLIC KEY--------)

      3. Klistra in terminalutdata i en fil med namnet jira_publickey.pem.

  2. Fortsätt till Konfigurera klientappen som en konsument i Jira

Konfigurera klientappen som en konsument i Jira

  1. Logga in på din Jira-instans.

  2. Klicka på Jira Settings > Applications> Application links i den vänstra navigeringspanelen.

  3. I fältet Enter the URL of the application you want to link anger du

    code language-none 
    https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1

  4. Klicka på Create new link. Ignorera felmeddelandet"Inget svar togs emot från den URL du angav".

  5. I fönstret Link applications anger du värden i fälten Consumer key och Shared secret.

    Du kan välja värden för dessa fält.

  6. Kopiera värdena för fälten Consumer key och Shared secret till en säker plats.

    Du kommer att behöva dessa värden senare i konfigurationsprocessen.

  7. Fyll i URL-fälten enligt följande:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Fält Beskrivning
    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. Markera kryssrutan Create incoming link.

  9. Klicka på Continue.

  10. I fönstret Link applications fyller du i följande fält:

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
    Consumer Key Klistra in konsumentnyckeln som du kopierade till en säker plats.
    Consumer name Ange ett namn. Det här namnet är till för din egen referens.
    Public key Klistra in den offentliga nyckeln från din jira_publickey.pem-fil.

  11. Klicka på Continue.

  12. Fortsätt till Skapa en anslutning till Jira Server eller Jira Data Center i Workfront Fusion

Skapa en anslutning till Jira Server eller Jira Data Center i Workfront Fusion

NOTE
Använd appen Jira Server för att ansluta till Jira Server eller Jira Data Center.

  1. Klicka på Add bredvid fältet connection i någon Jira Server-modul i Workfront Fusion.

  2. Fyll i följande fält i panelen Create a connection:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Connection name Ange ett namn för anslutningen
    Consumer Key Klistra in den konsumentnyckel som du kopierade till en säker plats i Konfigurera klientappen som en konsument i Jira
    Private Key Klistra in den privata nyckeln från filen jira_privatekey.pcks8 som du skapade i Generera offentliga och privata nycklar för din Jira-anslutning.
    Service URL Ange din Jira-instans-URL. Exempel: yourorganization.atlassian.net

  3. Klicka på Continue för att skapa anslutningen och gå tillbaka till modulen.

Jira Software-moduler och deras fält

När du konfigurerar Jira Software moduler visar Workfront Fusion fälten som listas nedan. Dessutom kan ytterligare Jira Software fält visas, beroende på faktorer som din åtkomstnivå i appen eller tjänsten. En rubrik med fet stil i en modul visar ett obligatoriskt fält.

Om du ser kartknappen ovanför ett fält eller en funktion kan du använda den för att ange variabler och funktioner för det fältet. Mer information finns i Mappa information från en modul till en annan i Adobe Workfront Fusion.

Utlösare

Watch for records

Denna utlösarmodul startar ett scenario när en post läggs till, uppdateras eller tas bort.

Webhook

Välj den webkrok som du vill använda för att bevaka poster.

Så här lägger du till en ny webbkrok:

  1. Klicka på Add

  2. Ange ett namn för webkroken.

  3. Välj den anslutning som du vill använda för din webkrok.

    Instruktioner om hur du ansluter ditt Jira Software-konto till Workfront Fusion finns i Ansluta Jira Software till Workfront Fusion i den här artikeln.

  4. Välj den posttyp som du vill att programmet ska bevaka:

    • Comment
    • Issue
    • Project
    • Sprint

Åtgärder

Add issue to sprint

Den här åtgärdsmodulen lägger till en eller flera utgåvor i en utskrift.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Jira Software-konto till Workfront Fusion finns i Ansluta Jira Software till Workfront Fusion i den här artikeln.
Sprint ID
Ange eller mappa Sprint-ID:t för den utskrift som du vill lägga till ett problem i.
Issue ID or Keys
Lägg till ett ärende-ID eller en nyckel för varje problem som du vill lägga till i skrivaren.

Create a Record

Denna åtgärdsmodul skapar en ny post i Jira.

Modulen returnerar alla standardfält som är associerade med posten, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Jira Software-konto till Workfront Fusion finns i Ansluta Jira Software till Workfront Fusion i den här artikeln.
Record Type

Välj den typ av post som du vill att modulen ska skapa. När du väljer en posttyp visas andra fält som är specifika för den posttypen i modulen.

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

Custom API Call

Med den här åtgärdsmodulen kan du göra ett anpassat autentiserat anrop till API:t Jira Software. På så sätt kan du skapa en dataflödesautomatisering som inte kan utföras av de andra Jira Software-modulerna.

När du konfigurerar den här modulen visas följande fält.

Välj den HTTP-förfrågningsmetod som du behöver för att konfigurera API-anropet. Mer information finns i Metoder för HTTP-begäran i Adobe Workfront Fusion.

Connection
Instruktioner om hur du ansluter ditt Jira Software-konto till Workfront Fusion finns i Ansluta Jira Software till Workfront Fusion i den här artikeln.
URL
Ange en sökväg i förhållande till<Instance URL>/rest/api/2/
Method
Headers

Lägg till rubrikerna för begäran i form av ett standard-JSON-objekt.

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

Workfront Fusion lägger till auktoriseringsrubrikerna åt dig.

Query String

Lägg till frågan för API-anropet i form av ett standard-JSON-objekt.

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

Body

Lägg till brödinnehållet för API-anropet i form av ett standard-JSON-objekt.

Obs!

När du använder villkorssatser som if i JSON placerar du citattecknen utanför villkorssatsen.

Delete a record

Den här åtgärdsmodulen tar bort en viss post.

Du anger postens ID.

Modulen returnerar postens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Jira Software-konto till Workfront Fusion finns i Ansluta Jira Software till Workfront Fusion i den här artikeln.
Record Type

Välj den typ av post som du vill att modulen ska ta bort.

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
ID or Key
Ange eller mappa ID:t eller nyckeln för den post som du vill ta bort.

Download an attachment

Den här åtgärdsmodulen hämtar en viss bifogad fil.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Jira Software-konto till Workfront Fusion finns i Ansluta Jira Software till Workfront Fusion i den här artikeln.
ID
Ange eller mappa ID:t för den bifogade fil som du vill hämta.

Read a record

Den här åtgärdsmodulen läser data från en enskild post i Jira Software.

Du anger postens ID.

Modulen returnerar alla standardfält som är associerade med posten, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Jira Software-konto till Workfront Fusion finns i Ansluta Jira Software till Workfront Fusion i den här artikeln.
Record Type

Välj den typ av Jira-post som du vill att modulen ska läsa.

  • Attachment
  • Issue
  • Project
  • Sprint
  • User
Outputs
Välj de utdata som du vill ta emot. Utdataalternativen är tillgängliga baserat på vilken typ av post som har valts i fältet Record Type.
ID
Ange eller mappa det unika Jira Software-ID:t för posten som du vill att modulen ska läsa.

Update a record

Den här åtgärdsmodulen uppdaterar en befintlig post, t.ex. ett problem eller ett projekt.

Du anger postens ID.

Modulen returnerar postens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Jira Software-konto till Workfront Fusion finns i Ansluta Jira Software till Workfront Fusion i den här artikeln.
Record Type

Välj den typ av post som du vill att modulen ska uppdatera. När du väljer en posttyp visas andra fält som är specifika för den posttypen i modulen.

  • Comment
  • Issue
  • Project
  • Sprint
  • Transition issue
ID or Key
Ange eller mappa ID:t eller nyckeln för den post som du vill uppdatera.

Sökningar

List records

Den här sökmodulen hämtar alla objekt av en viss typ som matchar din sökfråga

Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Jira Software-konto till Workfront Fusion finns i Ansluta Jira Software till Workfront Fusion i den här artikeln.
Record Type

Välj den typ av post som du vill att modulen ska visa. När du väljer en posttyp visas andra fält som är specifika för den posttypen i modulen.

  • Comment
  • Issue
  • Project
  • Sprint issue
  • Worklog
Max Results
Ange eller mappa det maximala antal poster som du vill att modulen ska hämta under varje körningscykel för scenario.

Search for records

Den här sökmodulen söker efter poster i ett objekt i Jira Software som matchar den sökfråga du anger.

Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Jira Software-konto till Workfront Fusion finns i Ansluta Jira Software till Workfront Fusion i den här artikeln.
Record Type

Välj den typ av post som du vill att modulen ska söka efter. När du väljer en posttyp visas andra fält som är specifika för den posttypen i modulen.

  • Issues

  • Issues by JQL (Jira Query Lanuguage)

    Mer information om JQL finns i JQL på hjälpwebbplatsen för Atlassian.

  • Project

  • Project by issue

  • User

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43