Sdílet prostřednictvím

Pole přiřazení na základě stavu, přechodu nebo důvod automatizace

  • Článek

Chcete automaticky přechod pracovních položek z jednoho státu do jiného státu na základě události, ke kterému dochází jinde v Visual Studio Application Lifecycle Management (ALM) nebo událost, nastane mimo Visual Studio ALM. Chcete například automatizaci přechod bug z jednoho státu do jiného, co dojde k volání nástroje sledování na základě. API sledování zboží práce a pracovní položku typ modelu jsou rozšířené podporovat automatický přechod pracovní položky jiných systémů.

Pokud je kód, který změní stav pracovní položky, můžete generalize kód přiřazením akce k přechodu stavu pomocí ACTION prvku. Předáte hodnotu vaší akce [WorkItem.GetNextState] metodu post-action stavu, pracovní položky. Tuto metodu používá verze ovládacího prvku zaškrtněte v dialogovém okně vyřešit chyby a zavřete úkoly, které souvisejí se změnami.

ACTIONje volitelné podřízený prvek ACTIONS.

Poznámka

Pracovní položka sledování API je součástí Visual Studio ALM SDK podle popisu v následující stránky na webu společnosti Microsoft: Rozšíření Team Foundation.

Například přednastavený nástroj automaticky přechodu pracovní položku do "Vyřešeno" poté, co uživatel zjistí změnu. Však jako zprostředkovatel integrace nevíte jaké má autor pracovní položky typ deklarován jako "Vyřešeno" stavu. 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žky typu autoři patří státu výslovně s názvem "Vyřešit".

Řešením je příliš omezující. Je také nekvalitní z mezinárodní perspektivy protože neumožňuje lokalizace států. Místo toho doplňky systému můžete deklarovat jako "Změnami" akce nebo "Dokončen" že indukuje automatického přechodu pro pracovní položky. Autor položky typu práce 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řidružování přechod stavu akce

  • Podrobnosti akce přechodu

  • Kontrola chyb Automatický přechod

Syntaxe pro prvek akce

Používá následující syntaxi pro ACTION prvku. Hodnota atributu Určuje název akce a je požadováno. Postupujte podle stejné konvence pro názvy polí referenční akce. Například Team Foundation – správa verzí používá Microsoft.VSTS.Actions.CheckIn identifikovat přechodu je vhodné pro pracovní položky, které jsou přidruženy kontrola in. Další informace naleznete v tématu Konvence pro sledování objektů pracovní položky.

<ACTION value="NameOfAction" />

parametr minOccurs = "0"

maxOccurs = "neomezeně"

Požadované kroky na podporu automatizace

Nástroj integrovat sledování zboží pracovní nástroj, musí provést následující kroky:

  1. Zjistěte jaký stav pracovní položky by měly být příznivou při akci provést.

  2. Pracovní položka nastavena "do" stav.

    Pracovní položka sledování API poskytuje metody pro provádění těchto kroků. Je součástí API sledování pracovních položek 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í je zaznamenána. Pokud musí sledovat akci, která způsobila přechod, zadáte položku pole s další práce sledovat ji nebo můžete definovat hodnotu důvod.

Zpět na začátek

Přidružování přechod stavu akce

Akce přechod stavu můžete automatizovat přechody pracovních položek v různých fázích jejich pracovní postup. Například Team Foundation Server systému kontroly verzí musí podporovat automatické přechody při zaškrtnutí položky práce času. Na podporu tohoto "microsoft.vsts.actions.checkin" akce nebyla definována.

Můžete definovat Autor pracovní položky typu "Vady" práce typu zboží, který má stav nazývá "Práce" a Jestliže vývojář upravuje pomocí této pracovní položky. Autor položky typu práce lze definovat jiného státu s názvem "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žku z "Práce" stát "připraven k sestavení" stav během operací změnami 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 akce 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 používání akcím přechodu:

  • Akce přechodu jsou volitelné. Pokud má položka akce pro zadanou akci aktuální stav instance pracovní položky, vrátí "do" stav. Pokud ne, vrácená hodnota je Null. Integrace řádné zpracování vrácené hodnoty Null. To je:

    • Selhat.

    • Nechte trasování nebo protokolu, který označuje, že nebyla integrace auto přechod protože požadované akce, která nebyla nalezena.

  • Pro každý typ položky pracovní akce musí být jedinečný pro páry ze státu a akce. To znamená, že autoři položky typu práce nelze zadat více "a" státy na stejnou akci.

  • Však podporuje více akcí na stejný přechod povolit 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, u kterých lze použít pouze znaky anglické.

  • Názvy akce by měly dodržovat stejné konvence názvů odkaz jako názvy polí odkaz na název akce konfliktům mezi dodavateli a zákazníky. Tato úmluva je však vynuceno nástrojem. Visual Studio ALMuses Microsoft.VSTS.Actions.<your action>.

Zpět na začátek

Kontrola chyb Automatický přechod

Doplňky můžete vyzkoušet dva typy automatického přechody. První je automatický přechod, který nastává z důvodu akce uživatele. Druhým je automatický přechod, který nastane bezobslužné automatizaci, například noční sestavení.

  • Akce uživatele auto přechody pro tento druh automatického přechodu uživatele je k dispozici reagovat pravidlo s problémy, které se zobrazí. Je třeba ověřit situaci, kdy Autor položky typu práce přidá povinné pole, který nerozpoznává integrace odborné pomoci. Podporu této situaci provést automatický přechod a potom zkontrolovat položky typu práce pro porušení pravidel. Pokud některý naleznete zobrazte formulář pro uživatele řešení.

  • Automatizace bezobslužné auto přechody musí předpokládat, že žádný uživatel se nenachází na tyto problémy vyřešit. V takovém případě by měly řádně nezdaří integrace. Protokol chyb by byl vyzkoušeli Automatický přechod, a měla dát důvod selhání státu.

Při definování obou typů automatického přechodu definujte přechodu tak, aby každé pracovní položky dosáhne platného stavu na konci přechod bez nutnosti zásahu uživatele. Jinými slovy pravidla definovaná pro stát, přičemž příznivou splněny poskytnutím výchozí nebo zkopírovat hodnoty všech polí. Libovolné pole stává neplatným po přechodu, přechod stavu se nezdaří.

Do pole ponechat stala neplatnou, postupujte takto:

  • Definovat DEFAULTREASON pro přechod stavu.

  • Pole, která by se stala požadované po přechod stavu, použít DEFAULT nebo COPY prvky pravidla určete hodnotu pro pole.

Například jste vytvořili akce přechod změnami, které přechody stavu pracovní položky z "Práce" na "Připraveno k sestavení". Pracovní položka pravidla "Připraven k sestavení" vyžadují, aby "vyřešen pomocí" nastavit 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živatele.

Zpět na začátek

Viz také

Koncepty

Kdy a kde platí pravidlo pro pole

Přidružování přechod stavu akce

Historie změn

Datum

Poslední dokumenty

Důvod

Leden 2011

Konsolidovat témata, která jsou určena pomocí rewrote ACTION prvku k automatizaci pole přiřazení.

Rozšíření informace