Azure DevOps moduler

I ett Adobe Workfront Fusion-scenario kan du automatisera arbetsflöden som använder Azure DevOps 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 Azure DevOps moduler måste du ha ett Azure DevOps-konto.

API-information för Azure DevOps

Azure DevOps-kopplingen använder följande:

API-version
v5.1
API-tagg
v1.29.33

Anslut Azure DevOps till Workfront Fusion connect-azure-devops-to-workfront-fusion

  1. Lägg till en Azure DevOps-modul i ditt scenario.

  2. Klicka på Add bredvid fältet Connection.

  3. Välj Azure DevOps i fältet Connection Type.

    note important
    IMPORTANT
    Anslutningstypen Azure DevOps (Request All Scopes) kommer att bli inaktuell inom den närmaste framtiden. Därför rekommenderar vi inte att du använder den.
  4. Fyll i följande fält:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Connection name Ange ett namn för anslutningen som du skapar.
    Organization Ange namnet på den organisation som du skapade ditt Azure DevOps-program under.
  5. Klicka på Continue för att slutföra konfigurationen av anslutningen och fortsätta skapa ditt scenario.

Azure DevOps-moduler och deras fält

När du konfigurerar Azure DevOps moduler visar Workfront Fusion fälten som listas nedan. Dessutom kan ytterligare Azure DevOps 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 work items

Denna snabbutlösarmodul kör ett scenario när en post läggs till, uppdateras eller tas bort i Azure DevOps.

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.

Webhook

Välj eller lägg till en webkrok för modulen.

Mer information om webhooks i utlösarmoduler finns i Direktutlösare (webhooks) i Adobe Workfront Fusion.

Mer information om hur du skapar en webkrok finns i Webhooks.

Åtgärder

Custom API Call

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

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

Connection
Instruktioner om hur du ansluter ditt Azure DevOps-konto till Workfront Fusion finns i Ansluta Azure DevOps till Workfront Fusion i den här artikeln.
Base URL
Välj eller mappa den bas-URL som du använder för att ansluta till ditt Azure DevOps-konto
Relative URL

Ange den relativa URL som du vill ansluta till för detta API-anrop.

Exempel: {organization}/_apis[/{area}]/{resource}

API Version
Markera eller mappa den version av Azure DevOps-API:t som du vill ansluta till för det här API-anropet. Om ingen version är markerad ansluter Workfront Fusion till Azure DevOps API version 5.1.
Method
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.
Headers

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

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

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.

Create a record

Den här åtgärdsmodulen skapar ett nytt projekt eller en ny arbetsuppgift.

Modulen matar ut objekt-ID:t för det nya arbetsobjektet eller URL:en och statuskoden för ett nyligen skapat projekt.

Connection
Instruktioner om hur du ansluter ditt Azure DevOps-konto till Workfront Fusion finns i Ansluta Azure DevOps till Workfront Fusion i den här artikeln.
Record type

Välj om du vill skapa en arbetsuppgift eller ett projekt.

  • Project

    Fyll i följande fält:

    • Name:Ange eller mappa ett namn för det nya projektet.

    • Description:Ange eller mappa en beskrivning för det nya projektet.

    • Visibility: Välj om du vill att projektet ska vara offentligt eller privat. Användarna måste vara inloggade i organisationen och ha beviljats åtkomst till projektet för att kunna interagera med ett privat projekt. Offentliga projekt är synliga för användare som inte är inloggade på din organisation.

    • Version control: Välj om du vill att projektet ska använda Git eller Team Foundation Version Control (TFCV) för versionskontroll.

    • Work item process: Välj den arbetsprocess som du vill använda för projektet. Alternativen är Basic, Scrum, Capability Maturity Model Integration (CMMI) och Agile.

      Mer information om Azure DevOps-processer finns i Välj en process i Azure DevOps-dokumentationen.

  • Work item

    Fyll i följande fält:

    • Project: Välj det projekt där du vill skapa arbetsposten.

    • Work item type: Välj den typ av arbetsuppgift som du vill skapa.

    • Other fields:I dessa fält anger du det värde som du vill att arbetsposten ska ha för en viss egenskap. Vilka fält som är tillgängliga beror på arbetsobjekttypen.

Download an attachment

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

Modulen returnerar filinnehållet i den bifogade filen.

Connection
Instruktioner om hur du ansluter ditt Azure DevOps-konto till Workfront Fusion finns i Ansluta Azure DevOps till Workfront Fusion i den här artikeln.
Attachment URL
Ange eller mappa URL:en för den bifogade fil som du vill hämta.

Den här åtgärdsmodulen länkar två arbetsobjekt och definierar relationen mellan dem.

Modulen returnerar ID:t för huvudobjektet 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 Azure DevOps-konto till Workfront Fusion finns i Ansluta Azure DevOps till Workfront Fusion i den här artikeln.
Work item ID
Ange eller mappa ID:t för det huvudsakliga arbetsobjekt som du vill länka ett annat arbetsobjekt till.
Linked work item ID
Ange eller mappa ID:t för arbetsuppgiften som du vill länka till huvudarbetsuppgiften.
Link Type

Definiera relationen mellan arbetsobjekten som du vill länka.

Mer information finns i Referens för länktyp i Azure DevOps -dokumentationen.

Comment
Ange eller mappa texten i en kommentar. Detta är användbart för att förklara länkens resonemang eller avsikt.

Read record

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

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 Azure DevOps-konto till Workfront Fusion finns i Ansluta Azure DevOps till Workfront Fusion i den här artikeln.
Record type

Välj om du vill läsa ett projekt eller en arbetsuppgift

  • Project: Välj det projekt som du vill läsa.

  • Work item: Välj det projekt som innehåller det arbetsobjekt som du vill läsa och välj sedan arbetsobjekttyp.

Outputs
Välj den information som du vill inkludera i utdatapaketet för den här modulen. Vilka fält som är tillgängliga beror på arbetsobjekttypen.
ID
Ange eller mappa ID:t för den post som du vill läsa.

Update a work item

Den här åtgärdsmodulen uppdaterar ett befintligt arbetsobjekt med dess ID.

Modulen returnerar ID:t för det uppdaterade arbetsobjektet.

Connection
Instruktioner om hur du ansluter ditt Azure DevOps-konto till Workfront Fusion finns i Ansluta Azure DevOps till Workfront Fusion i den här artikeln.
Project
Välj det projekt som innehåller den arbetsuppgift som du vill uppdatera.
Work Item Type
Välj den typ av arbetsuppgift som du vill uppdatera.
Other Fields
I vart och ett av dessa fält anger du det värde som du vill att arbetsposten ska ha för en viss egenskap. Vilka fält som är tillgängliga beror på arbetsobjekttypen.
Work item ID
Ange eller mappa ID:t för den arbetsuppgift som du vill uppdatera.

Upload an attachment

Den här åtgärdsmodulen överför en fil och bifogar den till ett arbetsobjekt.

Modulen returnerar den bifogade filens ID och en hämtnings-URL för den bifogade filen.

Connection
Instruktioner om hur du ansluter ditt Azure DevOps-konto till Workfront Fusion finns i Ansluta Azure DevOps till Workfront Fusion i den här artikeln.
Project
Välj det projekt där du vill överföra en bifogad fil.
Work item ID
Ange eller mappa ID:t för arbetsuppgiften där du vill överföra en bifogad fil.
Comment
Ange texten för en kommentar som du vill lägga till i den överförda bilagan.
Source file
Välj en källfil från en tidigare modul eller ange eller mappa källfilens namn och innehåll.

Sökningar

List work items

Den här åtgärdsmodulen hämtar alla arbetsobjekt av en viss typ i ett Azure DevOps-projekt.

Modulen returnerar ID:t för huvudobjektet 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 Azure DevOps-konto till Workfront Fusion finns i Ansluta Azure DevOps till Workfront Fusion i den här artikeln.
Project
Välj det projekt som du vill hämta arbetsobjekt från.
Work item type
Välj den typ av arbetsuppgift som du vill hämta.
Outputs
Markera de egenskaper som du vill ska visas i modulens utdata. Vilka fält som är tillgängliga beror på vilken typ av arbetsobjekt du vill hämta. Du måste välja minst en egenskap.
Limit
Ange eller mappa det maximala antalet arbetsobjekt som Workfront Fusion returnerar under en körningscykel.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43