Azure DevOps modules

In een Adobe Workfront Fusion -scenario kunt u workflows automatiseren die Azure DevOps gebruiken en deze koppelen aan meerdere toepassingen en services van derden.

Als u instructies bij het creëren van een scenario nodig hebt, zie een scenario in Adobe Workfront Fusion creëren.

Voor informatie over modules, zie Modules in Adobe Workfront Fusion.

Toegangsvereisten

U moet de volgende toegang hebben om de functionaliteit in dit artikel te kunnen gebruiken:

Adobe Workfront plan*
Pro of hoger
Adobe Workfront licentie*
Plan, Work
Adobe Workfront Fusion licentie**

Huidige licentievereiste: geen Workfront Fusion licentievereiste.

of

Vereiste voor oudere licenties: Workfront Fusion voor werkautomatisering en integratie

Product

Huidige productvereiste: als u het abonnement Select of Prime Adobe Workfront hebt, moet uw organisatie Adobe Workfront Fusion en Adobe Workfront aanschaffen om de in dit artikel beschreven functionaliteit te kunnen gebruiken. Workfront Fusion wordt opgenomen in het Ultimate Workfront -abonnement.

of

Vereiste verouderd product: uw organisatie moet Adobe Workfront Fusion en Adobe Workfront aanschaffen om de in dit artikel beschreven functionaliteit te kunnen gebruiken.

Neem contact op met de Workfront -beheerder als u wilt weten welk abonnement, licentietype of toegang u hebt.

Voor informatie over Adobe Workfront Fusion vergunningen, zie Adobe Workfront Fusion vergunningen.

Vereisten

Als u Azure DevOps -modules wilt gebruiken, hebt u een Azure DevOps-account nodig.

Azure DevOps API-informatie

De Azure DevOps-connector gebruikt het volgende:

API-versie
v5.1
API-tag
v1.29.33

Verbinden Azure DevOps met Workfront Fusion connect-azure-devops-to-workfront-fusion

  1. Voeg een module Azure DevOps toe aan uw scenario.

  2. Klik op Add naast het veld Connection .

  3. Selecteer Azure DevOps in het veld Connection Type .

    note important
    IMPORTANT
    Het verbindingstype Azure DevOps (Request All Scopes) wordt in de nabije toekomst vervangen. Daarom raden wij u niet aan het te gebruiken.
  4. Vul de volgende velden in:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Connection name Voer een naam in voor de verbinding die u maakt.
    Organization Voer de naam in van de organisatie waaronder u de Azure DevOps -toepassing hebt gemaakt.
  5. Klik op Continue om het instellen van de verbinding te voltooien en door te gaan met het maken van uw scenario.

Azure DevOps modules en hun velden

Wanneer u Azure DevOps modules configureert, geeft Workfront Fusion de onderstaande velden weer. Daarnaast kunnen aanvullende Azure DevOps -velden worden weergegeven, afhankelijk van factoren zoals uw toegangsniveau in de app of service. Een bolde titel in een module wijst op een vereist gebied.

Als u de kaartknoop boven een gebied of een functie ziet, kunt u het gebruiken om variabelen en functies voor dat gebied te plaatsen. Voor meer informatie, zie informatie van de Kaart van één module aan een andere in Adobe Workfront Fusion.

Triggers

Watch for work items

Deze instant trigger-module voert een scenario uit wanneer een record wordt toegevoegd, bijgewerkt of verwijderd in Azure DevOps .

De module retourneert alle standaardvelden die aan de record zijn gekoppeld, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Webhook

Selecteer of voeg een webhaak voor de module toe.

Voor meer informatie over websites in trekkermodules, zie Onmiddellijke trekkers (webhooks) in Adobe Workfront Fusion.

Voor informatie over hoe te om een webhaak tot stand te brengen, zie Webhooks.

Handelingen

Custom API Call

Met deze actiemodule kunt u een aangepaste, geverifieerde aanroep van de Azure DevOps API maken. Op deze manier kunt u een automatisering van de gegevensstroom maken die niet door de andere Azure DevOps -modules kan worden uitgevoerd.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Verbinding maken Azure DevOps met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Azure DevOps -account met Workfront Fusion .
Base URL
Selecteer of wijs de basis-URL toe die u gebruikt om verbinding te maken met uw Azure DevOps -account
Relative URL

Voer de relatieve URL in waarmee u verbinding wilt maken voor deze API-aanroep.

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

API Version
Selecteer of wijs de versie van Azure DevOps API toe die u voor deze API vraag wilt verbinden. Als er geen versie is geselecteerd, maakt Workfront Fusion verbinding met Azure DevOps API versie 5.1.
Method
Selecteer de HTTP- verzoekmethode u de API vraag moet vormen. Zie HTTP-aanvraagmethoden in Adobe Workfront Fusion voor meer informatie.
Headers

Voeg de kopteksten van het verzoek toe in de vorm van een standaard JSON-object.

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

Query String

Voeg de query voor de API-aanroep toe als een standaard JSON-object.

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

Body

Voeg de inhoud van de hoofdtekst voor de API-aanroep toe in de vorm van een standaard JSON-object.

Opmerking:

Wanneer u voorwaardelijke instructies gebruikt, zoals if in uw JSON, plaatst u de aanhalingstekens buiten de voorwaardelijke instructie.

Create a record

Deze actiemodule leidt tot een nieuw project of het werkpunt.

De module geeft de object-id weer voor het nieuwe werkitem of de URL en statuscode van een nieuw gemaakt project.

Connection
Zie Verbinding maken Azure DevOps met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Azure DevOps -account met Workfront Fusion .
Record type

Selecteer of u een het werkpunt of een project wilt tot stand brengen.

  • Project

    Vul de volgende velden in:

    • Name:Ga of kaart een naam voor het nieuwe project in.

    • Description:Ga of kaart een beschrijving voor het nieuwe project in.

    • Visibility: Selecteer of u wilt dat uw project openbaar of privé is. De gebruikers moeten in uw organisatie worden ondertekend en moeten toegang tot het project hebben verleend om met een privé project in wisselwerking te staan. De openbare projecten zijn zichtbaar aan gebruikers die niet binnen aan uw organisatie worden ondertekend.

    • Version control: Selecteer of u het project Git of Team Foundation Version Control (TFCV) wilt gebruiken voor versiebeheer.

    • Work item process: Selecteer het werkproces dat u voor het project wilt gebruiken. De opties zijn Basic , Scrum , Capability Maturity Model Integration (CMMI) en Agile .

      Voor meer informatie over Azure DevOps processen, zie een Procesin de Azure DevOps Documentatie kiezen.

  • Work item

    Vul de volgende velden in:

    • Project: Selecteer het project waar u het het werkpunt wilt tot stand brengen.

    • Work item type: Selecteer het type werkitem dat u wilt maken.

    • Other fields:Op deze gebieden, ga de waarde in die u het het werkpunt voor een bepaalde bezit wilt hebben. Beschikbare velden zijn afhankelijk van het type werkitem.

Download an attachment

Deze actiemodule downloadt een bijlage.

De module retourneert de bestandsinhoud van de bijlage.

Connection
Zie Verbinding maken Azure DevOps met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Azure DevOps -account met Workfront Fusion .
Attachment URL
Voer de URL in van de bijlage die u wilt downloaden of wijs deze toe.

Deze actiemodule verbindt twee het werkpunten en bepaalt het verband tussen hen.

De module retourneert de id van het hoofdwerkitem en alle bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Verbinding maken Azure DevOps met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Azure DevOps -account met Workfront Fusion .
Work item ID
Voer de id in van het hoofdwerkitem waarnaar u een ander werkitem wilt koppelen of wijs deze toe.
Linked work item ID
Voer de id in van het werkitem dat u wilt koppelen aan het hoofdwerkitem of wijs deze toe.
Link Type

Bepaal de verhouding tussen de het werkpunten die u wilt verbinden.

Voor meer informatie, zie Verwijzing van het Type van Verbindingin de Azure DevOps Documentatie.

Comment
Voer de tekst van een opmerking in of wijs deze toe. Dit is nuttig om de redenering of de intentie van het verband uit te leggen.

Read record

Deze actiemodule leest gegevens uit één record in Azure DevOps .

U geeft de id van de record op.

De module retourneert de id van de record en de bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Verbinding maken Azure DevOps met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Azure DevOps -account met Workfront Fusion .
Record type

Selecteer of u een project of een het werkpunt wilt lezen

  • Project: Selecteer het project dat u wilt lezen.

  • Work item: Selecteer het project dat het het werkpunt bevat u wilt lezen, dan het type van het het werkpunt selecteren.

Outputs
Selecteer de informatie die u in de uitvoerbundel voor deze module wilt opnemen. Beschikbare velden zijn afhankelijk van het type werkitem.
ID
Voer de id in van de record die u wilt lezen of wijs deze toe.

Update a work item

Deze actiemodule werkt een bestaand werkitem bij met behulp van de bijbehorende id.

De module keert identiteitskaart van het bijgewerkte het werkpunt terug.

Connection
Zie Verbinding maken Azure DevOps met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Azure DevOps -account met Workfront Fusion .
Project
Selecteer het project dat het het werkpunt bevat u wilt bijwerken.
Work Item Type
Selecteer het type werkitem dat u wilt bijwerken.
Other Fields
Op elk van deze gebieden, ga de waarde in die u het het werkpunt voor een bepaalde bezit wilt hebben. Beschikbare velden zijn afhankelijk van het type werkitem.
Work item ID
Voer de id in van het werkitem dat u wilt bijwerken of wijs deze toe.

Upload an attachment

Deze actiemodule uploadt een bestand en koppelt dit aan een tijdelijk item.

De module retourneert de bijlage-id en een download-URL voor de bijlage.

Connection
Zie Verbinding maken Azure DevOps met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Azure DevOps -account met Workfront Fusion .
Project
Selecteer het project waar u een gehechtheid wilt uploaden.
Work item ID
Ga of kaart identiteitskaart van het het werkpunt in waar u een gehechtheid wilt uploaden.
Comment
Voer de tekst in van een opmerking die u aan de geüploade bijlage wilt toevoegen.
Source file
Selecteer een bronbestand uit een vorige module of voer de naam en inhoud van het bronbestand in of wijs deze toe.

Zoekopdrachten

List work items

Deze actiemodule wint alle het werkpunten van een specifiek type in een Azure DevOps project terug.

De module retourneert de id van het hoofdwerkitem en alle bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Verbinding maken Azure DevOps met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Azure DevOps -account met Workfront Fusion .
Project
Selecteer het project waarvan u de het werkpunten wilt terugwinnen.
Work item type
Selecteer het type werkitem dat u wilt ophalen.
Outputs
Selecteer de eigenschappen die u in de uitvoer van de module wilt weergeven. De beschikbare velden zijn afhankelijk van het type werkitem dat u wilt ophalen. U moet ten minste één eigenschap selecteren.
Limit
Voer het maximale aantal werkitems in dat Workfront Fusion tijdens één uitvoeringscyclus retourneert of wijs dit toe.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43