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.

Előfeltételek

Kategória	Követelmények
engedélyek	- A Projektcsoportgazdák csoport tagja. A szervezettulajdonosok automatikusan ennek a csoportnak a tagjai. - Előfizetések szerkesztése és Előfizetések megtekintése, engedélyek beállítása Engedélyezett. Alapértelmezés szerint csak a projektgazdák rendelkeznek ezekkel az engedélyekkel. Az engedélyek más felhasználóknak való megadásához használhatja a parancssori eszközt vagy a Security REST API-t.
Eszközök	Trello

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

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

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

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

   engedélyezése

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 Előfizetés létrehozásalehető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ők használatával tartalmat illeszthet be az eseményből az előfizetés által létrehozott kártyák vagy listák nevébe és leírásába. 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ő alapformája {{resource.field}}, ahol az erőforrás az eseményt kiváltó erőforrás neve (például munkaelem, build stb.), a mező pedig egy mező az esemény erőforrás szakaszában, mint például az ID. Tehát, ha az előfizetés egy befejezett buildhez kapcsolódik, akkor elképzelhető, hogy valami hasonló.

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

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

Munkaelem mező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 dolgoznánk, a kártyanevünket így hoznánk létre, mint ez a példa:

    {{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. Így {{workitem.fields["System.workItemType"]}} lesz {{workitem.workItemType}}.

Helyőrző kifejezések

Ezek a helyőrzők handlebars sablonok implementációját használják, amelyek nagyrészt kompatibilisek Mustache. 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}} Ezt a WI-t rendelték hozzá {{/workitem.assignedTo}}
Bajusz fordított szakaszok	{{^workitem.assignedTo}} Ez a WI nincs hozzárendelve {{/workitem.assignedTo}}
A Handlebars blokktípusú segédprogramok	valamivel if/else kivéve ha mindegyik
Kezelőlécek elérési útjai	... ez Például {{../comment/id}} vagy {{this/title}}
Sablon megjegyzései	{{!-- this is a handlebar comment --}}

Árképzé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.

Q & A

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

Igen, itt láthatod a részleteket .

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

Válasz: Igen, trello.com.