Automatizace přiřazení polí na základě stavu, přechodu nebo důvodu
Chcete automaticky přechod pracovních položek z jednoho státu do jiného státu na základě událost , který nastane, jinde v Visual Studio Application Lifecycle Management (ALM) nebo událost , která nastane mimo Visual Studio ALM.Například můžete automatizovat přechod chyba z jednoho státu do druhého dochází, nástroje pro sledování volání na základě.Pracovní položka typ modelu a API sledování zboží práce jsou rozšířené podporovat automatický přechod pracovní položky jiných systémů.
Pokud je kód, který změní stav pracovní položka, můžete přiřazením akce k přechodu stavu pomocí generalizaci kód ACTION prvku.Předáte hodnotu vaší akce [WorkItem.GetNextState] metoda post-action stav této pracovní položka. verze řízení zaškrtnutí v dialog používá tuto metoda k přeložit chyby a zavřít úkoly, které souvisejí se změnami.
ACTIONje volitelné podřízený prvek ACTIONS.
[!POZNÁMKA]
Pracovní položky sledování API je součástí Visual Studio ALM SDK, popsané v následující stránky na webu společnosti Microsoft: rozšíření Team Foundation.
Nástroj je například předvolbu automaticky přechodu pracovní položka k "Vyřešeno" po kontroluje uživatel ke změně.Však integrace poskytovatel, nevíte jaké stát má autor pracovní položka typ deklarován jako "Vyřešeno".Autor může znamenat vyřešeno, uzavřeno, dokončeno, připraven pro Test, zahrnují v sestavení a podobně.Jednou z možností bude vyžadovat, aby všechny pracovní položka typu autoři patří státu výslovně s názvem "Vyřešeno".
Tento řešení je příliš omezující.Je také nekvalitní z mezinárodní perspektivy protože neumožňuje lokalizace státy.Místo toho doplňky názvem doplňky systému můžete deklarovat jako "Změnami" nebo "Úplná", který indukuje automatické přechodu pro pracovní položky akce.Pracovní položka typ Autor by pak deklarovat tuto akci na odpovídající přechodu.
V tomto tématu
Syntaxe pro prvek akce
Požadované kroky na podporu Automatizace
Přechod stavu přidružení k akci
Podrobnosti o akci přechodu
Kontrola chyb Automatický přechod
Syntaxe pro prvek akce
Následující syntaxe je použit pro ACTION prvku.Hodnota atribut Určuje název akce a je požadována.Postupujte podle stejné konvence pro názvy pole odkazovat se akce.Například Team Foundation – správa verzí Microsoft.VSTS.Actions.CheckIn používá k identifikaci přechod, který je vhodný pro pracovní položky, které souvisejí se změnami.Další informace naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky.
<ACTION value="NameOfAction" />
parametr minOccurs = "0"
maxOccurs = "neomezeně"
Požadované kroky na podporu Automatizace
Integraci nástroj Sledování pracovních položek, musí nástroj proveďte následující kroky:
Zjistěte stav, jaké položka by měly být příznivou při provedení akce.
Nastavte položka do stavu "na".
Pracovní položky sledování API poskytuje metody pro provádění těchto kroků.Pracovní položky sledování API je součástí Visual Studio ALM SDK.Další informace naleznete na následující stránce na webu společnosti Microsoft: Team Foundation Server SDK.
[!POZNÁMKA]
Akce transakce, která způsobila přechod zejména stavu dochází není zaznamenána.Pokud musí sledovat akci, která způsobila přechodu, o další pracovní položka pole sledovat ji můžete zadat nebo definovat hodnotu z důvodu.
Zpět na začátek
Přechod stavu přidružení k akci
Akce přechod stavu lze automatizovat přechody pracovních položek v různých fázích jejich pracovní postup.Například Team Foundation Serversystému kontroly verze musí podporovat automatické přechody pracovních položek v okamžiku vrácení se změnami. Proto byla definována akce "microsoft.vsts.actions.checkin".
Autor typ položka práce můžete definovat typ položka práce "Vady", který má stav se nazývá "Pracovní" a Jestliže vývojář upravuje pomocí této pracovní položka .Autor položka typu práce lze definovat jiného státu, které se nazývá "Připraven K sestavení," což znamená, že vývojář prohlásil kód, který byl ovlivněn vadu k noční sestavení.
Autor automaticky přechod položka od státu "Pracovní" stavu "Připraveno K sestavení" během operace kontrola prohlášením následující:
<TRANSITION from="Working" to="Ready To Build">
<ACTIONS>
<ACTION value="microsoft.vsts.actions.checkin"/>
</ACTIONS>
</TRANSITION>
Zpět na začátek
Podrobnosti o akci přechodu
Akce přechod stavu lze použijte k automatizaci přechody pracovních položek v různých fázích jejich pracovní postup.Zvažte následující podrobnosti využití akcím přechodu:
Akce přechodu jsou volitelné.Pokud aktuální stav instance pracovní položka akce položka pro zadané akce, vrátí stát "na".Pokud ne, je vrácena hodnota Null.Integrace by řádně popisovač vrácené hodnoty Null.To je:
Nezdaří.
Ponechejte trasování nebo protokolu, který označuje, že integrace nebyla auto přechod, protože je akce, která nebyla nalezena.
Pro každý typ položka práce musí být jedinečný pro páry ze státu/akce akce.To znamená, že autoři typ položka práce nelze zadat více stavů "na" pro stejné akce.
Více akcí na stejný přechod jsou však podporovány pro více integrace Automatický přechod, jak ukazuje následující příklad:
<TRANSITION from="Working" to="Ready To Build"> <ACTIONS> <ACTION value="Microsoft.VSTS.Actions.Checkin"/> <ACTION value="ADatum.Actions.Complete"/> </ACTIONS> </TRANSITION>Akce názvy jsou programové názvy, které můžete použít pouze anglické znaky.
Akce, názvy by měly dodržovat stejné konvenceobor názvů odkazovat sejakoodkazovat se názvy pole, konfliktům název akce mezi dodavateli a zákazníky. Tato úmluva však není vynucena nástrojem.Visual Studio ALMuses Microsoft.VSTS.Actions.<your action>.
Zpět na začátek
Kontrola chyb Automatický přechod
Doplňky názvem doplňky zkusit dva typy automatického přechody.První je auto přechod, který nastává z důvodu akce uživatel .Druhým je automatického přechodu, způsobený bezobslužné automatizaci, například noční sestavení.
Akce uživatele auto přechody pro tento druh automatického přechodu uživatel je k dispozici reagovat na problémy související pravidlo, které se zobrazí.Je třeba ověřit, že podporují situace, který nastane, když Autor položka typu práce přidá povinné pole , který nerozpoznává integrace.Pro podporu této situaci provést automatický přechod a potom zkontrolovat položka typu práce pro porušení pravidel.Pokud některý naleznete zobrazení formulář pro uživatel přeložit.
Automatizace bezobslužné auto přechody musí předpokládat, že žádný uživatel je k dispozici přeložit těchto problémů.V tomto případě by měly řádně selhání integrace.chyba protokol by měl stát byl vyzkoušeli Automatický přechod, a předá důvod selhání.
Při definování buď typ automatického přechodu definujte přechodu tak, aby každé pracovní položka dosáhne platný stavu na konci přechod bez nutnosti zásahu uživatel .Jinými slovy všechna pravidla, která jsou definována pro stát, přičemž příznivou splnění poskytnutím výchozí nebo zkopírované hodnoty všech polí.Pokud všechna pole stane neplatný po přechodu, přechod stavu se nezdaří.
Aby se stala neplatnýponechat pole, proveďte následující:
Definovat DEFAULTREASON pro přechod stavu.
Pole, která by se stala požadované po přechod stavu, použít DEFAULT nebo COPY pravidlo určete hodnotu pro poleprvků.
Jste například vytvořili akci přechodu změnami, které přechody stavu pracovní položka z "Pracovní" k "Připraven k sestavení".Pracovní položkapravidla pro "Připraven k sestavení" vyžadují nastavit "Vyřešen pomocí" pole .By definovat DEFAULT nebo COPY prvek pravidla pro "ResolvedBy" v TRANSITION oddílu.Navíc by definovat DEFAULTREASON se přesvědčte, zda nastavena pole bez zásahu uživatel .
Zpět na začátek
Viz také
Koncepty
Kdy a kde se použije pravidlo pro pole