Provisioinnin konfigurointia varten tarvitset pääsyn Platform configuration -konsoliin.

1. Avaa Administration-alue (hammasratas-symboli).
2. Avaa Connectors-näkymä.
3. Valitse "New connector" 

4. Valitse Data Source -tyypiksi Generic REST API

5. Anna konnektorille nimi ja lisää yhteysasetukset:

• Connector name - anna konnektorille kuvaava nimi (nimen voi muuttaa myöhemmin)
• Host url - REST API:n perus-URL. Tätä voidaan käyttää kutsuttavan lopullisen URL-osoitteen etuliitteenä.
• REST Connector type - valitse Generic
• Authentication method - valitse Dynamic Token

• Login url: https://login.microsoftonline.com/2b6a6dc0-a6f1-47ff-8818-bafda12d454c/oauth2/v2.0/token
• Login body (muuta omat client_id- ja client_secret-arvosi, kahdella muulla attribuutilla on vakioarvot): client_id=123abc&client_secret=abcde&grant_type=client_credentials&scope=499b84ac-1321-427f-aa17-267ca6975798/.default
• Login Method: POST
• Login Content Type: application/x-www-form-urlencoded
• Login token valid for (sekunteina): 3598
• Login headers: Content-Type = application/x-www-form-urlencoded
• Token usage: Bearer @TOKEN@
• Token attribute in response: access_token

6. Aseta oikea sivutus (pagination), jos aiot käyttää tätä yhteyttä Scheduled tasks -ajastettujen tehtävien kanssa

7. Täytä WebAPI-käyttäjän tiedot

• WebAPI user - valitse oikea WebAPI-käyttäjä, jota käytetään kirjoitettaessa dataa ulkoisesta järjestelmästä Matrix42 Core-, Pro- ja IGA-ratkaisuihin
• WebAPI password - WebAPI-käyttäjän salasana

8. Tallenna konnektorin tiedot

9. Lisää ulkoinen Microsoft Azure DevOpsin juuri-https-varmenne luotetuksi Connector managementissa (EPE). Tämän voi tehdä vain Matrix42: Add certificate.

10. Matrix42 Core-, Pro- ja IGA-ratkaisu pystyy nyt muodostamaan yhteyden Microsoft Azure DevOpsiin

• Seuraava vaihe on määrittää ajastettu tehtävä (scheduled task) datan lukemista varten tai tapahtumapohjainen tehtävä (event task) datan kirjoittamista ja toimintoja varten Microsoft Azure DevOpsiin.

Datan lukeminen Microsoft Azure DevOpsista Scheduled tasks -tehtävillä ei ole tällä hetkellä tuettu. Syynä tähän on, että Microsoft Azure DevOps käyttää sivutusmenetelmää, jota Generic REST API -konnektorimme ei tue. Azure DevOpsin vastauksen headerissa on sivutusta varten x-ms-continuationtoken.

Yhden objektin voi kuitenkin yhä lukea Azure DevOpsista käyttämällä Event-based tasks -tehtäviä ja Workflow Orchestration Node -solmua Action-arvolla GET.

Alla on perusesimerkki Event task -tehtävästä ja Orchestration node -solmusta, joita käytetään tikettien luomiseen Microsoft Azure DevOpsiin.

1. Lisää Event-based task oikean konnektorin alle napsauttamalla “New Task”

2. Aseta attribuutit tehtävälle

Task name - kuvaava yksilöllinen nimi
Task usage - Event
Mappings type - Generic Template
Query - kutsuttavan API:n URL-osoite. Tässä esimerkissä luomme tiketin, joten Query voidaan jättää tyhjäksi. Tässä esimerkissä asetamme API-URL:n sen sijaan Orchestration node -solmun REST URL -attribuuttiin.

Query headers: aseta nämä kolme headeria kuvakaappauksen mukaisesti.
Accept / application/json
X-TFS-FedAuthRedirect / Suppress
Content-Type / application/json-patch+json

Date Attribute formatter - aseta oikea muoto, jos provisioit date-attribuutteja: yyyy-MM-dd
DateTime Attribute formatter - aseta oikea muoto, jos provisioit datetime-attribuutteja: yyyy-MM-ddTHH:mm:ssZ

Aseta Generic Mappings

Target template - mallipohja, jonka Workflow'sta kutsut tätä tehtävää
Target folder - datasi kansio

Älä aseta attribuutteja mapping-taulukkoon (external attribute - local attribute). Attribuuttien mappaus tehdään workflow'n orchestration-solmussa.

3. Tallenna tehtävä

4. Luo Orchestration node -solmu workflow'hun kutsumaan tätä event-based-tehtävää

Orchestrate - Provisioning Engine
Data Source - Generic REST API
Activity - Generic REST call
Target - Create ADO ticket (event-based-tehtäväsi nimi)
Action - tässä esimerkissä POST, koska luomme tikettejä
REST URL - tässä esimerkissä /$Bug?api-version=7.1, koska luomme tikettejä tyyppiä Bug; voit vaihtaa Bugin joksikin muuksi Azure DevOpsin tukemaksi tyypiksi luodaksesi erilaisia tikettejä.
REST Body - voit generoida API-kutsun rungon suoraan tässä. Tai monimutkaisemmissa tapauksissa generoida sen erikseen (script-solmussa) johonkin attribuuttiin ja käyttää sitten sitä attribuuttia tässä. Tässä tapauksessa tiketin luonnin runko luodaan suoraan tässä.
Tässä esimerkissä käytetty runko sisältää Title- ja ReproSteps-arvot, jotka luetaan tietokortin subject- ja details-attribuuteista. Effort on kovakoodattu arvoon 3.0. Tag on MyTESTTag ja AreaPath on kovakoodattu arvoon Test\My team1. Todellisessa areaPathissa on vain yksi \, mutta tässä sen täytyy olla kaksinkertainen \, jotta se on JSON-yhteensopiva.
[
{ "op": "add", "path": "/fields/System.Title", "value": "$subject$" },
{ "op": "add", "path": "/fields/Microsoft.VSTS.TCM.ReproSteps", "value": "$details$" },
{ "op": "add", "path": "/fields/Microsoft.VSTS.Scheduling.Effort", "value": 3.0 },
{ "op": "add", "path": "/fields/System.Tags", "value": "MyTESTTag" },
{ "op": "add", "path": "/fields/System.AreaPath", "value": "Test\My team1" }
]

REST Response attribute - API-kutsun vastaus tallennetaan tähän attribuuttiin
Provisioning exception - jos API-kutsussa on ongelma, poikkeus tallennetaan tähän attribuuttiin

Viimeistele workflow'n muut solmut ja kulku

Tallenna workflow ja julkaise se

5. Testaa workflow ja event-based-tehtävä

Tämä esimerkki-workflow luo yhden bug-tiketin ja lisää sille yhden alitehtävän

ADO-tiketin lisääminen

ADO-tiketin numeron hakeminen

ADO-alitehtävän lisääminen

hyödyntää luodun bug-tiketin numeroa, jonka tallensimme attribuuttiin “get ADO ticket number” -solmussa

Rajoitukset versiossa 2025.3

Enemmän kuin yhden tason alikyselyjä ajastetuille tehtäville ei tueta suorituskykysyistä.

Ajastettuja tehtäviä suurten datamäärien lukemiseen Microsoft Azure DevOpsista ei tueta, koska Microsoft Azure DevOps käyttää sivutusmenetelmää, jota Generic REST API -konnektorimme ei tue.