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
Ha nincs Trello-fiókja, regisztráljon Trello.
Nyissa meg a Az Azure DevOps Services for Trello engedélyezése lap, és jelentkezzen be Trello-hitelesítő adataival.
Engedélyezze az Azure DevOps számára a Trello-fiók használatát.
engedélyezése
Másolja ki az engedélyezési jogkivonatot.
Trello-kártya vagy -lista létrehozása egy Azure DevOps Services-eseményből.
Nyissa meg a projekt Service Hooks oldalát:
https://{orgName}/{project_name}/_settings/serviceHooks
Válassza Előfizetés létrehozásalehetőséget.
Válassza ki a Trello szolgáltatást.
Konfigurálja az eseményindító Visual Studio-eseményt. Ebben az esetben az előfizetés válaszol egy munkaelem létrehozásakor.
Á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.
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.