Valmistelun määrittämiseen tarvitset käyttöoikeuden alustan määrityskonsoliin.

1. Avaa hallinta-alue (ratassymboli).
2. Avaa Yhdistimet-näkymä.
3. Valitse "Uusi liitin"

4. Valitse tietolähteen tyypiksi Generic REST API

5. Anna liittimelle nimi ja lisää yhteysasetukset:

• Liittimen nimi – anna liittimellesi käyttäjäystävällinen nimi (nimeä voi muuttaa jälkikäteen)
• Isännän URL-osoite - REST API perus-URL. Tätä voidaan käyttää etuliitteenä kutsuttavalle lopulliselle URL-osoitteelle.
• REST liittimen tyyppi - valitse Yleinen
• Todennusmenetelmä - Valitse dynaaminen tunnus

• Kirjautumisosoite: https://login.microsoftonline.com/2b6a6dc0-a6f1-47ff-8818-bafda12d454c/oauth2/v2.0/token
• Kirjautumisen runko (muuta client_id ja client_secret, kahdella muulla attribuutilla on vakioarvot): client_id=123abc&client_secret=abcde&grant_type=client_credentials&scope=499b84ac-1321-427f-aa17-267ca6975798/.default
• Kirjautumistapa: POST
• Kirjautumisen sisällön tyyppi: application/x-www-form-urlencoded
• Kirjautumistunnus voimassa (sekunteina): 3598
• Kirjautumisotsikot: Content-Type = application/x-www-form-urlencoded
• Tokenin käyttö: Haltija @TOKEN@
• Token-attribuutti vastauksessa: access_token

6. Aseta oikea sivutus, jos aiot käyttää tätä yhteyttä ajoitettujen tehtävien kanssa

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

• WebAPI käyttäjä - valitse oikea WebAPI käyttäjä, jota käytetään kirjoitettaessa tietoja ulkoisesta järjestelmästä Matrix42 Core , Pro and IGA ratkaisuihin
• WebAPI salasana - WebAPI käyttäjän salasana

8. Tallenna liittimen tiedot

9. Lisää ulkoinen Microsoft Azure DevOps -juuritason https-sertifikaatti, johon Connector management (EPE) luottaa. Tämän voi tehdä vain Matrix42 :lla: Lisää sertifikaatti.

10. Matrix42 Core , Pro and IGA ratkaisut pystyvät nyt muodostamaan yhteyden Microsoft Azure DevOpsiin

• Seuraava vaihe on määrittää ajoitettu tehtävä datan lukemista varten tai tapahtumatehtävä datan kirjoittamista varten ja toiminnot Microsoft Azure DevOpsia varten.

Datan lukemista Microsoft Azure DevOpsista ajoitettujen tehtävien kanssa ei tällä hetkellä tueta . Syynä tähän on se, että Microsoft Azure DevOps käyttää sivutusmenetelmää, jota yleinen REST API -yhdistin ei tue. Azure DevOpsin vastausotsikko sisältää x-ms-continuationtokenin sivutusta varten.

Mutta voit silti lukea yhden objektin Azure DevOpsista käyttämällä tapahtumapohjaisia tehtäviä ja työnkulun orhestraatiosolmua toiminnolla GET.

Tässä on perusesimerkki tapahtumatehtävästä ja orkestrointisolmusta, joita käytetään tikettien luomiseen Microsoft Azure DevOpsiin.

1. Lisää tapahtumapohjainen tehtävä oikean liittimen alle napsauttamalla ”Uusi tehtävä”

2. Määritä tehtävälle määritteet

Tehtävän nimi - kuvaava yksilöllinen nimi
Tehtävien käyttö - Tapahtuma
Yhdistämistyyppi - Yleinen mallipohja
Kysely - kutsuttavan API :n URL-osoite. Tässä esimerkissä luomme tiketin, joten käytämme kyselyä: Voit jättää tämän tyhjäksi. Tässä esimerkissä asetamme API:n URL-osoitteeksi Orchestration-solmun REST URL -attribuutin.

Kyselyotsikot: aseta nämä kolme otsikkoa kuvakaappauksen mukaisesti.
Hyväksy / application/json
X-TFS-FedAuthRedirect / Suppress
Sisältötyyppi / application/json-patch+json

Päivämääräattribuutin muotoilija - aseta oikea muoto, jos olet määrittämässä päivämääräattribuutteja: vvvv-KK-pp
Päivämäärä- ja aika-attribuuttien muotoilija – aseta oikea muoto, jos olet määrittämässä päivämäärä- ja aika-attribuutteja: vvvv-KK-ppTHH:mm:ssZ

Aseta yleiset määritykset

Kohdemallipohja – mallipohja, josta työnkulkua aiot kutsua tätä tehtävää
Kohdekansio - kansio tiedoillesi

Määritystaululle (ulkoinen määrite - paikallinen määrite) ei ole asetettu määritteitä. Määritteiden yhdistäminen tehdään työnkulun orkestrointisolmussa.

3. Tallenna tehtävä

4. Luo työnkulkuusi Orchestration-solmu kutsuaksesi tätä tapahtumapohjaista tehtävää.

Orchestrate - Pro
Tietolähde - Yleinen REST API
Aktiviteetti - Yleinen REST kutsu
Target - Luo AD O -tiketti (tapahtumapohjaisen tehtävän nimi)
Toiminto - Tässä esimerkissä POST-lähetys luotaessa tikettejä
REST URL - tässä esimerkissä /$Bug?api-version=7.1 koska luomme tikettejä, joiden tyyppi on Bug, voit muuttaa bugin joksikin muuksi Azure DevOpsin tukemaksi tyypiksi luodaksesi erityyppisiä tikettejä.
REST runko - voit luoda API -kutsurungon suoraan tähän. Tai monimutkaisemmissa tapauksissa luoda sen erikseen (skriptin solmussa) jollekin attribuutille ja käyttää sitten kyseistä attribuuttia tässä. Tässä tapauksessa tiketin luomiseen tarvittava runko luodaan suoraan tähän.
Tässä esimerkissä käyttämämme runko sisältää Title- ja ReproSteps-arvot, jotka on luettu datakortin subject- ja details-attribuuteista. Effort on kovakoodattu versiolle 3.0. Tagi MyTESTTag ja AreaPath on kovakoodattu muotoon Test\\My team1. Varsinaisella areaPath-alueella on vain yksi \, mutta sen on oltava kaksinkertainen \\ ollakseen JSON-yhteensopiva.
[
{ "op": "lisää", "polku": "/kentät/Järjestelmä.Otsikko", "arvo": "$aihe$" },
{ "op": "lisää", "polku": "/kentät/Microsoft.VSTS.TCM.ReproSteps", "arvo": "$tiedot$" },
{ "op": "lisää", "polku": "/kentät/Microsoft.VSTS.Scheduling.Effort", "arvo": 3.0 },
{ "op": "add", "path": "/fields/System.Tags", "value": "OmaTEST-tunniste" },
{ "op": "add", "path": "/fields/System.AreaPath", "value": "Testi\\Oma tiimi1" }
]

REST vastausattribuutti - API -kutsun vastaus tallennetaan tähän attribuuttiin
Pro - jos API kutsussa on ongelma, poikkeus tallennetaan tähän attribuuttiin

Viimeistele työnkulkusi muut solmut ja työnkulku

Tallenna työnkulku ja julkaise se

5. Testien työnkulku ja tapahtumapohjainen tehtävä

Tämä esimerkkityönkulku luo yhden vikailmoituksen ja lisää sille yhden alitehtävän.

Lisää AD O -lippu

Hanki AD O -lipun numero

Lisää AD O -alitehtävä

käyttää luotua vikailmoitusnumeroa, jonka tallensimme ”hae AD O -ilmoitusnumero” -solmulle.

Rajoitukset vuonna 2025.3

Useampaa kuin yhtä alikyselytasoa ajoitetuille tehtäville ei tueta suorituskykysyistä.

Ajoitettuja tehtäviä suurten tietomäärien lukemiseen Microsoft Azure DevOpsista ei tueta, koska Microsoft Azure DevOps käyttää sivutusmenetelmää, jota yleinen REST API -yhdistin ei tue.