Jira-moduler

NOTE
Dessa instruktioner gäller den nya versionen av Jira-anslutningen, som helt enkelt heter Jira. Instruktioner om de äldre Jira Cloud- och Jira Server-anslutningarna finns i Jira-programmoduler.

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

Jira-anslutningen kan användas för både Jira Cloud och Jira Data Server.

Instruktioner om hur du skapar ett scenario finns i artiklarna under Skapa scenarier: artikelindex.

Mer information om moduler finns i artiklarna under Moduler: artikelindex.

Åtkomstkrav

Expandera om du vill visa åtkomstkrav för funktionerna i den här artikeln.

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront package Alla
Adobe Workfront-licens

Nytt: Standard

eller

Aktuell: Arbete eller högre

Adobe Workfront Fusion-licens**

Aktuell: Inga Workfront Fusion-licenser krävs

eller

Äldre: Workfront Fusion for Work Automation and Integration

Produkt

Nytt:

  • Select or Prime Workfront package: Your organization must purchase Adobe Workfront Fusion.
  • Ultimate Workfront-paket: Workfront Fusion ingår.

eller

Aktuell: Din organisation måste köpa Adobe Workfront Fusion.

Mer information om informationen i den här tabellen finns i Åtkomstkrav i dokumentationen.

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

Förutsättningar

För att kunna använda Jira-moduler måste du ha ett Jira-konto.

Anslut Jira till Workfront Fusion

Skapa nödvändiga autentiseringsuppgifter

Om du vill skapa anslutningar till Jira behöver du följande:

Anslutningstyp
Kontotyp
Autentiseringsuppgifter krävs
OAuth 2
Alla
Klient-ID och klienthemlighet
Grundläggande
Jira Cloud
Jira API-token
Grundläggande
Jira Data Center
Jira Personal Access Token (PAT)

Instruktioner om hur du skapar något av dessa finns i Jiras dokumentation.

När du skapar dessa autentiseringsuppgifter behöver du följande information:

  • För OAuth 2:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Fusion datacenter Omdirigeringsadress
    USA https://app.workfrontfusion.com/oauth/cb/workfront-jira2
    EU https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira2
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira2
  • För personliga åtkomsttoken (PAT):

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Fusion datacenter Omdirigeringsadress
    USA https://app.workfrontfusion.com/oauth/cb/workfront-jira
    EU https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira
    note important
    IMPORTANT
    Om du vill använda en PAT-fil måste du aktivera följande i filerna jira/bin/WEB-INF/classes i filen jira-config.properties:
    • jira.rest.auth.allow.basic = true
    • jira.rest.csrf.disabled = true
    Om filen inte finns måste du skapa den.

Skapa anslutningen till Jira i Workfront Fusion

Så här skapar du en anslutning i Workfront Fusion:

  1. Klicka på Lägg till bredvid anslutningsfältet i en Jira-modul.

  2. Konfigurera följande fält:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto html-authored no-header
    Anslutningstyp Ange om du skapar en grundläggande anslutning eller en OAuth 2-anslutning.
    Anslutningsnamn Ange ett namn för den nya anslutningen.
    Tjänst-URL Ange din Jira-instans-URL. Det här är den URL du använder för att komma åt Jira.
    Jira-kontotyp Välj om du ansluter till Jira Cloud eller Jira Data Center.
    Klient-ID Om du skapar en OAuth 2-anslutning anger du ditt Jira Client-ID
    Klienthemlighet Om du skapar en OAuth 2-anslutning anger du din Jira-klienthemlighet
    E-post Om du skapar en grundläggande anslutning till Jira Cloud anger du din e-postadress.
    API-token Om du skapar en grundläggande anslutning till Jira Cloud anger du din API-token.
    Personlig åtkomsttoken Om du skapar en grundläggande anslutning till Jira Data Center anger du din personliga åtkomsttoken.
    API-version Välj den Jira API-version som du vill att anslutningen ska ansluta till.
  3. Klicka på Continue för att skapa anslutningen och gå tillbaka till modulen.

Jira-moduler och deras fält

När du konfigurerar Jira-moduler visas fälten som listas nedan i Workfront Fusion. Dessutom kan ytterligare Jira-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.

Växla karta

Utlösare

Håll utkik efter poster

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

Webkrok

Välj den webkrok som du vill använda för att bevaka poster, eller skapa en ny webkrok.

Så här skapar du en ny webbkrok:

  1. Klicka på Lägg till

  2. Ange ett namn för webkroken.

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

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

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

    • Problem
    • Kommentar
    • Arbetslogg
    • Projekt
    • Sprint
    • Bilaga
  5. Välj en eller flera händelsetyper som ska utlösa det här scenariot.

  6. Ange ett Jira-frågespråkfilter för den här modulen.

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

  7. Klicka på Spara för att spara webkroken.

Åtgärder

Lägg till utgåva i utskrift

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

Anslutning
Anvisningar om hur du ansluter ditt Jira-konto till Workfront Fusion finns i Ansluta Jira 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.
Problem-ID eller nycklar
Klicka på Lägg till objekt för varje problem eller nyckel som du vill lägga till i skrivaren och ange ID eller nyckel för problemet. Du kan ange upp till 50 i en modul.

Skapa en post

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

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

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

  • Bilaga
  • Kommentar
  • Problem
  • Projekt
  • Sprint
  • Arbetslogg
  • Användare
  • Styrelse
  • Kategori
  • Filter
Andra fält
Fyll i andra fält. Fälten är tillgängliga beroende på den valda posttypen.

Anpassat API-anrop

Med den här åtgärdsmodulen kan du göra ett anpassat autentiserat anrop till Jira API.

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.

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

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.

Frågesträng

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

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

Brödtext

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.

Ta bort en post

Den här åtgärdsmodulen tar bort den angivna posten.

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

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

  • Kommentar
  • Problem
  • Projekt
  • Sprint
  • Arbetslogg
  • Bilaga
  • Styrelse
  • Kategori
  • Filter
(Posttyp)ID
Ange eller mappa ID:t eller nyckeln för den post som du vill ta bort.

Hämta en bifogad fil

Den här åtgärdsmodulen hämtar den angivna bifogade filen.

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

Läsa en post

Den här åtgärdsmodulen läser data från den angivna posten i Jira.

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

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

  • Bilaga
  • Kommentar
  • Problem
  • Projekt
  • Sprint
  • Arbetslogg
  • Användare
  • Styrelse
  • Kategori
  • Filter
Utdata
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 Posttyp.
(Posttyp)-ID
Ange eller mappa det unika Jira-ID:t för den post som du vill att modulen ska läsa.

Uppdatera en post

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

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

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.

  • Kommentar
  • Problem
  • Projekt
  • Sprint
  • Övergångsproblem
  • Kategori
  • Filter
ID eller nyckel
Ange eller mappa ID:t eller nyckeln för den post som du vill uppdatera.
Andra fält
Fyll i andra fält. Fälten är tillgängliga beroende på den valda posttypen.

Sökningar

Sök efter poster

Den här sökmodulen söker efter poster i ett objekt i Jira 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.

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

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.

  • Problem
  • Projekt
  • Användare
  • Sprint
  • Styrelse
  • Arbetslogg
  • Kommentar
  • Övergångsproblem
  • Kategori
Maximalt antal resultat
Ange eller mappa det maximala antal poster som du vill att modulen ska hämta under varje körningscykel för scenario.
Förskjutning
Ange eller mappa ID:t för det första objektet som du vill hämta information för. Detta är ett sätt att numrera posterna. Om du anger det 5000:e objektet som förskjutning returnerar modulen objekten 5000-9999.
Andra fält
Fyll i andra fält. Fälten är tillgängliga beroende på den valda posttypen.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3