Automatizace přiřazení polí na základě stavu, přechodu nebo důvodu
Možná budete chtít automaticky přechod pracovní položky z jednoho stavu do jiného stavu založené na události, k níž dojde jinde v Visual Studio Application Lifecycle Management (ALM) nebo události, k níž dojde mimo Visual Studio – sada ALM.Například můžete automatizovat přechodu chybu z jednoho stavu do druhého založené na co se stane při volání sledování nástroj.Pracovní položka typu modelu a pracovní položka sledování rozhraní API jsou rozšířit o podporu Automatický přechod pracovních položek jinými systémy.
Pokud máte kódu, která se změní stav pracovní položky, můžete generalize tento kód přidružením vaše akce přechod odpovídající stavu pomocí ACTION element.Předáte hodnotu vaše akce, která [WorkItem.GetNextState] metodu za účelem získání následné akce stav tuto pracovní položku.Verze dialogové okno řízení vrácení se změnami používá tuto metodu pro vyřešení chyby a uzavření úlohy, které jsou přidruženy k vrácení se změnami.
ACTIONje volitelný podřízený prvek ACTIONS.
[!POZNÁMKA]
Pracovní položka sledování API je součástí Visual Studio – sada ALM SDK, jak je popsáno podle na následující stránce webu společnosti Microsoft: rozšíření Team Foundation.
Nástroj je například předdefinované automaticky přejít na "Vyřešený" pracovní položky po ověří uživatele ke změně.Však jako zprostředkovatel integrace si nejste jisti, jaké stavu, autora typu pracovní položka má prohlášeny za "Vyřešeno".Autor může znamenat, vyřešeno, Uzavřeno, dokončeno, Test připraven pro, zahrnují v sestavení a tak dále.Jednu možnost bude vyžadovat, aby všechny pracovní položky typu Autoři mají být zahrnuty do stavu explicitně s názvem "Přeložit".
Zda je příliš omezující řešení.Také je špatná z mezinárodní perspektivy vzhledem k tomu, že neumožňuje lokalizace stavů.Namísto toho můžete společnostmi zajišťujícími integraci systémů deklarovat akci, například "Vrácení se změnami" nebo "Úplná", který indukuje na automatické přechod pro pracovní položky.Autor typ pracovní položky by poté deklarovat tuto akci na odpovídající přechodu.
V tomto tématu
Syntaxe pro daný Element akce
Kroky potřebné k automatizace odborné pomoci
Přechod stavu přidružením akce
Podrobnosti o akci přechodu
Automatický přechod Kontrola chyb
Syntaxe pro daný element akce
Následující syntaxe se používá pro ACTION element.Hodnota atributu Určuje název akce a je třeba zadat.Postupujte podle stejné konvence pro akce jako odkaz na názvy polí.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é jsou přidruženy k vrácení se změnami.Další informace naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky.
<ACTION value="NameOfAction" />
minOccurs = "0"
maxOccurs = "bez vazby"
Kroky potřebné k automatizace odborné pomoci
Nástroj integrací sledování pracovních položek, musí nástroj proveďte následující kroky:
Zjistěte, jaké stav pracovní položky by měla být přepnuta do po provedení akce.
Pracovní položka nastaven do stavu "na".
Pracovní položka sledování API poskytuje metody pro provedení následujících kroků.Pracovní položka sledování API je součástí Visual Studio – sada ALM SDK.Další informace získáte na následující stránce webu společnosti Microsoft: Team Foundation Server SDK.
[!POZNÁMKA]
Transakce akce, která způsobila přechod stavu konkrétní však není zaznamenána.Pokud je nutné sledovat akci, která způsobila přechod, můžete zadat pole s další pracovní položky sledovat nebo můžete definovat hodnotu z důvodu.
Zpět na začátek
Přidružit přechod stavu akce
Stav přechodu akce slouží k automatizaci přechody pracovních položek v různých fázích svých pracovních postupů.Můžete například Team Foundation Server systém správy verzí musí podporovat automatické přechody pracovních položek v době vrácení se změnami.Chcete-li to podporují "microsoft.vsts.actions.checkin" akce definována.
Pracovní položku typu Autor můžete definovat typ pracovní položky "O", který je ve stavu volá "Pracovní" a používat tuto pracovní položku při vývojář je provádění změn.Autor typ pracovní položky můžete definovat další stav volá "Připraveno k sestavení," což znamená, že vývojář má deklarovat kódu, které byly ovlivněny vady, aby byly připraveny k sestavení kódu.
Autor můžete automaticky přechod pracovní položku z "Pracovní" stavu do stavu "Připraveno k sestavení" během operace vrácení se změnami deklarací 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
Pomocí akce přechod stavu můžete automatizovat přechody pracovních položek v různých fázích svých pracovních postupů.Zvažte následující využití podrobnosti o přechodu akce:
Přechod akce jsou volitelné.Pokud aktuální stav instance pracovní položka má položka akce pro zadanou akci, vrátí stav "na".Pokud není, vrácená hodnota je Null.Integrace by měly zpracovávat řádném vrácené hodnoty Null.To je:
Nedošlo k selhání.
Nechte trasování nebo protokolu, která určuje, že integrace nebyl automatický přechod vzhledem k tomu, že je vyžadována akce, která nebyla nalezena.
Pro každý typ pracovní položky musí být jedinečný pro dvojice ze/akce stavu akce.To znamená, že autoři typ pracovní položky nelze zadat více stavů "na" pro stejnou akci.
Více akcí na stejném přechodu jsou však podporovány tak, aby povoloval více Automatický přechod integrace, jak je znázorněno v následujícím příkladu:
<TRANSITION from="Working" to="Ready To Build"> <ACTIONS> <ACTION value="Microsoft.VSTS.Actions.Checkin"/> <ACTION value="ADatum.Actions.Complete"/> </ACTIONS> </TRANSITION>Názvy akce jsou programové názvy, které můžete použít pouze anglické znaky.
Názvy akce se měli řídit stejné konvence názvů odkaz jako odkaz na názvy polí, aby se zamezilo konfliktům název akce mezi dodavateli a zákazníky.Nicméně konvencí nevynucuje nástroj.Visual Studio – sada ALMpoužívá Microsoft.VSTS.Actions.<your action>.
Automatický přechod Kontrola chyb
Můžete se pokusit zajišťujícími integraci systémů dva typy automatického přechody.První je na automatický přechod, k níž dojde z důvodu akce uživatele.Druhý je na automatický přechod, k níž dojde prostřednictvím bezobslužné automatizace, jako jsou například kódu sestavení.
Akce uživatele automaticky přechody pro tento druh Automatický přechod se uživatel nachází reagovat na jakékoli problémy související s pravidlo, které se zobrazí.Ujistěte se, že podporujete situace, k níž dojde při autora typ pracovní položky přidá povinné pole, které integrace nerozpozná.Chcete-li podporují tuto situaci, provést automatický přechod a potom zkontrolujte typ pracovní položky pro porušení pravidel.Pokud zjistíte, existuje, zobrazí formulář pro uživatele, kterého chcete vyřešit.
Automatizace bezobslužné automaticky přechody musí předpokládat, že žádný uživatel se nenachází tyto problémy vyřešit.V takovém případě integrace by měl řádném nezdaří.Protokolu chyb by měl stavu, že byl pokouší Automatický přechod a předá důvod selhání.
Při definování obou typů Automatický přechod, definujte přechodu tak, aby každý pracovní položka dosáhne platném stavu na konci přechodu bez nutnosti zásahu uživatele.Jinými slovy všech pravidel, která jsou definována pro stav, přičemž přepnuta do splnění poskytnutím výchozí hodnoty nebo zkopírovány hodnoty pro všechna pole.Pokud žádné pole se stane neplatnou po přechodu, přechod stavu se nezdaří.
Chcete-li zabránit stanete neplatné pole, proveďte následující kroky:
Definovat DEFAULTREASON pro přechod stavu.
Pole, které by se stal požadované po přechod stavu, použijte DEFAULT nebo COPY pravidlo prvky k zadání hodnoty pro pole.
Například jste vytvořili přechodu akce vrácení se změnami, které přechází stav pracovní položky "Funkčním" do "Připraveno k sestavení".Pracovní položka pravidla pro "Připraveno k sestavení" vyžadují, nastavit pole "Vyřešen By".Poté můžete definovat DEFAULT nebo COPY prvek pravidla pro "ResolvedBy" v TRANSITION oddílu.Kromě toho můžete definovat DEFAULTREASON a ujistěte se, že se povinného pole lze nastavit bez zásahu uživatele.