Szolgáltatáshook létrehozása az Azure DevOps Serviceshez és a TFS-hez a Trello használatával

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Kártyák és listák létrehozása a Trello-ban az Azure DevOps eseményeire válaszul. Például a kód leküldésekor vagy buildeléskor.

Trello engedélyezési jogkivonat lekérése

1. Ha nincs Trello-fiókja, regisztráljon a Trello-nál.

2. Nyissa meg az Azure DevOps Services for Trello engedélyezése lapot, és jelentkezzen be Trello-hitelesítő adataival.

3. Engedélyezze az Azure DevOps számára a Trello-fiók használatát.

   

4. Másolja ki az engedélyezési jogkivonatot.

   

Trello-kártya vagy -lista létrehozása egy Azure DevOps Services-eseményből.

1. Nyissa meg a projekt Service Hooks oldalát:

   https://{orgName}/{project_name}/_settings/serviceHooks

   

   Válassza az Előfizetés létrehozása lehetőséget.

2. Válassza ki a Trello szolgáltatást.

   

3. Konfigurálja az eseményindító Visual Studio-eseményt. Ebben az esetben az előfizetés válaszol egy munkaelem létrehozásakor.

   

4. Állítsa be a Trello által az eseményindítóra válaszul végrehajtandó műveletet – hozzon létre egy kártyát vagy egy listát.

   

   Helyőrzőkkel beszúrhat tartalmat az eseményből az előfizetés által létrehozott kártyák vagy listák nevére és leírására. A tesztértesítés futtatásakor például a létrehozott kártya neve "Hiba #5: Valami nagyszerű új ötlet!", mert a tesztmunkaelem egy hiba (ID=5) "Valami nagyszerű új ötlet!" címmel.

5. Tesztelje a szolgáltatáshook-előfizetést, és fejezze be a varázslót.

   

Most már be van állítva. Nyissa meg a Trello-t, és nézze meg, hogy megjelennek-e a kártyák.

Helyőrzők

Helyőrzőket beszúrhat egy lista nevére, vagy az előfizetés által létrehozandó kártya nevére vagy leírására. Lista vagy kártya létrehozásakor a helyőrzőket a rendszer a létrehozott esemény értékeire cseréli. Az oldalon található kártyanévhez használt példa a következőket használja:

    {{workitem.workItemType}} #{{workitem.id}}: {{workitem.title}}

Tehát amikor egy hiba jön létre az 5-ös azonosítóval és a "Valami nagyszerű új ötlet!" címmel, a kártya neve "5. hiba: Néhány nagyszerű új ötlet!".

A helyőrző {{resource.field}} alapforma az, ahol az erőforrás az eseményt növelő erőforrás neve (munkaelem, build stb.), a mező pedig az esemény erőforrásszakaszában lévő mező, például azonosító. Így ha az előfizetés egy befejezett buildhez készült, akkor lehet, hogy valami hasonló

    Build {{build.id}} completed at {{build.finishTime}}

Ahol a build az erőforrás neve és azonosítója, a finishTime az erőforrásban elérhető mezők. A használható eseménytípusok, mezők és erőforrások megismeréséhez tekintse meg az eseményreferenciát.

Munkaelemmezők

A munkaelemmezők az eseményben jelennek meg a mezők tömbjében, például a következő példában:

    " fields": {
                " System.AreaPath": "Fabrikam-Fiber-Git", 
                " System.TeamProject": "Fabrikam-Fiber-Git", 
                " System.IterationPath": "Fabrikam-Fiber-Git", 
                " System.WorkItemType": "Product Backlog Item", 
                " System.State": "New", 
                " System.Reason": "New backlog item", 
                " System.CreatedDate": "2014-11-05T21:11:28.85Z", 
                " System.CreatedBy": "Normal Paulk", 
                " System.ChangedDate": "2014-11-05T21:11:29.23Z", 
                " System.ChangedBy": "Normal Paulk", 
                " System.Title": "Test PBI", 
                " Microsoft.Azure DevOps Services.Common.BacklogPriority": 999999999, 
                " WEF_6CB513B6E70E43499D9FC94E5BBFB784_Kanban.Column": "New"
           },

Ha közvetlenül az eseménydefinícióból dolgozik, a következő példához hasonlóan hoztuk volna létre a kártyanevünket:

    {{workitem.fields["System.workItemType"]}} #{{workitem.fields["System.id"]}: {{workitem.fields["System.title"]}}

Parancsikonként hivatkozhat a Rendszer vagy a Microsoft.Azure DevOps Services.Common névterek bármely mezőjére, mintha az erőforrás mezői lennének. A {{workitem.fields["System.workItemType"]}} csoportból például {{workitem.workItemType}} lesz.

Helyőrző kifejezések

Ezek a helyőrzők olyan kormánysablon-implementációt használnak, amely nagyrészt kompatibilis a Bajuszsal. Néhány hasznos kifejezés:

Kifejezés típusa	példák
alapkifejezések	{{workitem.name}}
tömbkifejezések	{{pullRequest.reviewers.[0].displayName}}
Bajuszszakaszok	{{#workitem.assignedTo}} Ez a WI van hozzárendelve {{/workitem.assignedTo}}
Bajusz fordított szakaszok	{{^workitem.assignedTo}} Ez a WI nincs hozzárendelve {{/workitem.assignedTo}}
A kezelőlécek blokksegítői	nevű és if/else Kivéve Minden
Kezelőlécek elérési útjai	... erre a(z) Például: {{../comment/id}} vagy {{this/title}}
Sablon megjegyzései	{{!-- this is a handlebar comment --}}

Díjszabás

Az Azure DevOps nem számít fel díjat a külső szolgáltatásokkal való integráció keretrendszeréért. Tekintse meg az adott szolgáltatás webhelyét a szolgáltatásaikkal kapcsolatos díjszabásért.

Kérdések és válaszok

K: Létrehozhatok programozott módon előfizetéseket?

Válasz: Igen, itt tekintsd meg a részleteket.

K: Kaphatok további információt a Trello-ról?

Válasz: Igen, trello.com.