Vytvoření háku služby pro Azure DevOps Services a TFS pomocí Trello

  • Článek

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

Vytvářejte karty a seznamy v Trello v reakci na události z Azure DevOps. Například když se nasdílí kód nebo dojde k sestavení.

Získání autorizačního tokenu Trello

  1. Pokud nemáte účet Trello, zaregistrujte se na Trello.

  2. Přejděte na stránku Authorize Azure DevOps Services for Trello a přihlaste se pomocí svých přihlašovacích údajů Trello.

  3. Povolte Azure DevOps používat váš účet Trello.

    Povolit Azure DevOps Services

  4. Zkopírujte autorizační token.

    Autorizační token Trello

Vytvořte kartu nebo seznam Trello z události Azure DevOps Services.

  1. Přejděte na stránku Hooks služby projektu:

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

    Stránka správy projektu

    Vyberte Vytvořit předplatné.

  2. Vyberte službu Trello.

    Stránka služby, vybraná možnost Trello

  3. Nakonfigurujte aktivační událost sady Visual Studio. V tomto případě budeme mít předplatné, které odpoví při vytvoření pracovní položky.

    Stránka konfigurace triggeru

  4. Nastavte akci, kterou Trello provede v reakci na trigger – buď vytvořte kartu, nebo seznam.

    Stránka konfigurace akce

    Zástupné symboly můžete použít k vložení obsahu z události do názvu a popisu karet nebo seznamů, které odběr vytvoří. Když například spustíme testovací oznámení, vytvoří se karta s názvem "Chyba č. 5: Nějaký skvělý nový nápad!", protože testovací pracovní položka je chyba (ID=5) s názvem "Nějaký skvělý nový nápad!".

  5. Otestujte předplatné připojení služby a dokončete průvodce.

    Testovací oznámení

Teď je to nastavené. Přejděte do Trello a podívejte se na karty.

Úvodní panel s kartou pro chybu č. 5

Zástupné symboly

Zástupné symboly můžete vložit do názvu seznamu nebo názvu nebo popisu karty, kterou má vaše předplatné vytvořit. Při vytvoření seznamu nebo karty se zástupné symboly nahradí hodnotami z události, která byla vyvolána. Příklad, který jsme použili pro název karty na této stránce, používá:

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

Takže když se vytvoří chyba s ID 5 a názvem "Nějaký skvělý nový nápad!", název karty je "Chyba č. 5: Nějaký skvělý nový nápad!".

Základní forma zástupného symbolu je {{resource.field}} místo, kde zdroj představuje název zdroje, který vyvolává událost (pracovní položka, sestavení atd.) a pole je pole v oddílu zdroje události, například ID. Takže pokud je předplatné pro dokončené sestavení, může to vypadat nějak takto:

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

Kde je název prostředku a ID sestavení, jsou pole finishTime k dispozici v tomto prostředku. Pokud chcete porozumět typům událostí, polím a prostředkům dostupným pro použití, podívejte se na odkaz na události.

Pole pracovní položky

Pole pracovní položky se zobrazí v události v poli polí, například v tomto příkladu:

    " 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"
           },

Když pracujeme přímo z definice události, vytvořili bychom název karty jako v tomto příkladu:

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

Jako zástupce můžete odkazovat na všechna pole v oborech názvů System nebo Microsoft.Azure DevOps Services.Common, jako by se jednalo o pole prostředku. Z {{workitem.fields["System.workItemType"]}} se tak stane {{workitem.workItemType}}.

Zástupné výrazy

Tyto zástupné symboly používají implementaci šablon úchytů, která je z velké části kompatibilní s Mustache. Mezi užitečné výrazy patří:

Typ výrazu příklady
základní výrazy {{workitem.name}}
maticové výrazy {{pullRequest.reviewers.[0].displayName}}
Oddíly mustache {{#workitem.assignedTo}} Toto WI je přiřazeno. {{/workitem.assignedTo}}
Invertované oddíly knírek {{^workitem.assignedTo}} Tato WI není přiřazená. {{/workitem.assignedTo}}
Pomocné rutiny pro blokování úchytů with
if/else
unless
Každé
Cesty k úchytům ...
tohoto provozu
Příklad: {{../comment/id}} nebo {{this/title}}
Komentáře k šablonám {{!-- this is a handlebar comment --}}

Ceny

Azure DevOps neúčtuje poplatky za architekturu pro integraci s externími službami. Podívejte se na web konkrétní služby, kde najdete informace o cenách souvisejících s jejich službami.

Otázky a odpovědi

Otázka: Můžu programově vytvářet předplatná?

Ano, podrobnosti najdete tady.

Otázka: Můžu získat další informace o Trello?

A: Ano, trello.com.