För att konfigurera provisionering behöver du åtkomst till plattformskonfigurationskonsolen.

1. Öppna administrationsområdet (en kugghjulssymbol).
2. Öppna vyn Kontakter.
3. Välj "Ny koppling"

4. Välj datakälltyp som Generic REST API

5. Ange ett namn för kontakten och lägg till anslutningsinställningar:

• Anslutningsnamn - ge din anslutning ett vänligt namn (namnet kan ändras i efterhand)
• Värd-URL - bas-URL för REST API . Detta kan användas som prefix för den slutliga URL:en som ska anropas.
• REST kopplingstyp – välj Generisk
• Autentiseringsmetod - Välj dynamisk token

• Inloggningsadress: https://login.microsoftonline.com/2b6a6dc0-a6f1-47ff-8818-bafda12d454c/oauth2/v2.0/token
• Inloggningstext (ändra ditt client_id och client_secret, de andra två attributen har konstanta värden): client_id=123abc&client_secret=abcde&grant_type=client_credentials&scope=499b84ac-1321-427f-aa17-267ca6975798/.default
• Inloggningsmetod: POST
• Inloggningsinnehållstyp: application/x-www-form-urlencoded
• Giltig inloggningstoken (i sekunder): 3598
• Inloggningsrubriker: Content-Type = application/x-www-form-urlencoded
• Tokenanvändning: Bärare @TOKEN@
• Tokenattribut i svar: access_token

6. Ställ in korrekt paginering om du ska använda den här anslutningen med schemalagda uppgifter

7. Fyll i WebAPI användarinformation

• WebAPI användare - välj rätt WebAPI användare som används vid skrivning av data från externa system till Matrix42 Core , Pro and IGA lösningar
• WebAPI lösenord - lösenord för WebAPI användaren

8. Spara kontaktinformation

9. Lägg till ett externt Microsoft Azure DevOps root https-certifikat som ska vara betrott av Connector Management (EPE). Detta kan endast göras med Matrix42 : Lägg till certifikat.

10. Matrix42 Core , Pro and IGA lösningen kan nu ansluta till Microsoft Azure DevOps

• Nästa steg är att konfigurera en schemalagd uppgift för dataläsning eller en händelseuppgift för dataskrivning och åtgärder mot Microsoft Azure DevOps.

Det stöds för närvarande inte att läsa data från Microsoft Azure DevOps med schemalagda uppgifter . Anledningen till detta är att Microsoft Azure DevOps använder en pagineringsmetod som inte stöds av vår generiska REST API anslutning. I Azure DevOps innehåller svarshuvudet x-ms-continuationtoken för paginering.

Men du kan fortfarande läsa ett objekt från Azure DevOps genom att använda händelsebaserade uppgifter och arbetsflödesorhestreringsnoden med åtgärden GET.

Här är ett grundläggande exempel på en händelseuppgift och en orkestreringsnod, som används för att skapa ärenden till Microsoft Azure DevOps.

1. Lägg till händelsebaserad uppgift under rätt anslutning genom att klicka på "Ny uppgift"

2. Ange attribut för uppgiften

Uppgiftsnamn - beskrivande unikt namn
Uppgiftsanvändning - Händelse
Mappningstyp - Generisk mall
Fråga - URL för det API du vill anropa. I det här exemplet skapar vi en biljett, så vi använder frågan: Du kan ange detta tomt. I det här exemplet kommer vi att ställa in API-URL till Orchestration-nodens REST URL-attribut.

Frågerubriker: ställ in dessa tre rubriker som visas på skärmdumpen.
Acceptera / application/json
X-TFS-FedAuthRedirect / Undertryck
Innehållstyp / application/json-patch+json

Formatering av datumattribut – ange rätt format om du provisionerar datumattribut: åååå-MM-dd
Formatering av DateTime-attribut – ange rätt format om du provisionerar datetime-attribut: yyyy-MM-ddTHH:mm:ssZ

Ställ in generiska mappningar

Målmall - mall från vilken arbetsflöde du ska anropa den här uppgiften
Målmapp - mapp för dina data

Inga attribut har angetts för mappningstabellen (externt attribut - lokalt attribut). Attributmappning görs på arbetsflödesorkestreringsnoden.

3. Spara uppgift

4. Skapa Orchestration-noden i ditt arbetsflöde för att anropa denna händelsebaserade uppgift

Orkestrera - Pro
Datakälla - Generiskt REST API
Aktivitet - Generiskt REST anrop
Target - Skapa AD O-biljett (namn på din händelsebaserade uppgift)
Åtgärd - I det här exemplet POSTAR vi när vi skapar ärenden
REST URL – i det här exemplet /$Bug?api-version=7.1, eftersom vi skapar ärenden av typen bugg kan du ändra den buggen till något annat som stöds av Azure DevOps för att skapa en annan typ av ärenden.
REST Body - du kan generera API anropskroppen direkt här. Eller i mer komplicerade fall generera den separat (i skriptnoden) till något attribut, och sedan använda det attributet här. I det här fallet skapas kroppen för att skapa ärendet direkt här.
Den kropp vi använder i det här exemplet har värden för Titel och ReproSteps lästa från attributen `subject` och `details` för datacard. Hårdkodad `Effort` för 3.0. Taggarna `MyTESTTag` och `AreaPath` är hårdkodade till `Test\\My team1`. Den faktiska `areaPath` har bara en \ men denna måste ha en dubbel \\ för att vara json-kompatibel.
[
{ "op": "lägg till", "sökväg": "/fält/System.Titel", "värde": "$ämne$" },
{ "op": "lägg till", "sökväg": "/fält/Microsoft.VSTS.TCM.ReproSteps", "värde": "$detaljer$" },
{ "op": "lägg till", "sökväg": "/fält/Microsoft.VSTS.Scheduling.Effort", "värde": 3.0 },
{ "op": "lägg till", "sökväg": "/fält/System.Taggar", "värde": "MinTEST-tagg" },
{ "op": "add", "path": "/fields/System.AreaPath", "value": "Test\\Mitt team1" }
]

REST Response-attribut - svaret från API anropet kommer att lagras i detta attribut
Undantag Pro provisionering – om det är problem med API anropet kommer undantaget att lagras i detta attribut.

Slutför ditt arbetsflöde, andra noder och flöde

Spara arbetsflöde och publicera det

5. Testarbetsflöde och händelsebaserad uppgift

Det här exempelarbetsflödet skapar en buggbiljett och lägger till en underuppgift för den.

Lägg till AD O-biljett

Hämta AD O-biljettnummer

Lägg till AD O-underuppgift

använder det skapade buggärendenumret, som vi lagrade för att attributa på "get AD O ticket number" -noden

Begränsningar år 2025.3

Av prestandaskäl stöds inte fler än en nivå av underfrågor för schemalagda uppgifter.

Schemalagda uppgifter för att läsa stora mängder data från Microsoft Azure DevOps stöds inte eftersom Microsoft Azure DevOps använder en pagineringsmetod som inte stöds av vår generiska REST API anslutning.