Sdílet prostřednictvím

All WORKFLOW XML elements reference

  • Článek

Informace v tomto tématu můžete použít jako rychlou referenci na všechny elementy a hlavní atributy, které řídí pracovního postupu pro typ pracovní položky. Zadejte tyto prvky v WORKFLOW kontejner elementu, který je druhá hlavní část definice typu pracovní položky. Můžete použít STATES a TRANSITIONS podřízených elementů definovat různé stavy, které může uživatel zadat pro typ pracovní položky a přechody, které jsou povoleny mezi stavy. Další informace o tom, jak definovat tyto prvky naleznete v tématu Change the workflow for a work item type

Chcete-li upravit pracovního postupu, upravte definici pro typ pracovní položky. Podívejte se na téma Úprava nebo přidání vlastního typu pracovní položky (WIT).

Příklad pracovního postupu

Následující příklad ukazuje celkovou strukturu WORKFLOW elementu. Zadejte všechny stavy, ke kterým může uživatel nejprve přiřadit typ pracovní položky v rámci STATES kontejneru. V dalším kroku zadejte všechny přechody, které jsou povoleny z jednoho stavu do druhého. Každý stav odpovídá STATE odpovídá elementu a každý přechod TRANSITION elementu. V každé STATES a TRANSITIONS elementu kontejneru, můžete definovat stavy a přechody posloupnosti, které chcete.

Pro každý přechod určíte sadu důvody pro změnu stavu pracovní položky, včetně výchozí důvod. Můžete přiřadit hodnoty pro každý stav, přechod nebo důvod a umístit podmínky na hodnotách jednoho nebo více polí pomocí FIELD element (pracovní postup). Kromě toho můžete spustit akci, která má dojít během přechodu tak, že určíte ACTION elementu.

<WORKFLOW>
<STATES>
  <STATE value="Active">
    <FIELDS> . . . </FIELDS>
  </STATE>
  <STATE value="Resolved">
    <FIELDS> . . . </FIELDS>
  </STATE>
  <STATE value="Closed" />
</STATES>
<TRANSITIONS>
  <TRANSITION from="" to="Active">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
    <FIELDS> . . . </FIELDS>
  </TRANSITION>
  <TRANSITION from="Active" to="Resolved">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
    <ACTIONS > . . . </ACTIONS >
</TRANSITION>
<TRANSITION from="Resolved" to="Closed">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
    <ACTIONS > . . . </ACTIONS >
</TRANSITION>
<TRANSITION from="Resolved" to="Active">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
<TRANSITION from="Active" to="Closed ">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
<TRANSITION from="Closed" to="Active">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
</TRANSITIONS>
</WORKFLOW>

Syntaxe struktury

S použitím elementy, které jsou popsány v následující tabulce, můžete určit, do nichž státy člen týmu můžete nastavit pracovní položku určitého typu. V WORKFLOW části definice, které nejprve definujete stavy, a pak definovat přechody. Další informace naleznete v tématu Change the workflow for a work item type.

Element

Popis a syntaxe

Povinné?

ACTION

Definuje textový řetězec, který odpovídá pro akci, která má být provedena při systému pro sledování pracovních položek volání WorkItem.GetNextState metodu za účelem získání po akci stavu pracovní položky.

<ACTION value="NameOfAction" />

Další informace naleznete v tématu Automatizace přiřazení polí na základě stavu, přechodu nebo důvodu

Nepovinné

ACTIONS

Definuje kolekci ACTION elementy.

<ACTIONS>
   <ACTION>. . . </ACTION>
</ACTIONS>

Nepovinné

DEFAULTREASON

Definuje Nejběžnější příčina změna pracovní položku z jednoho stavu konkrétní na jiný stav určitého člena týmu.

<DEFAULTREASON value="ValueOfDefaultReason">
   <FIELDS>. . . </FIELDS>
</DEFAULTREASON>

Požadováno

FIELD

Určuje pole pro typ pracovní položky a pravidla a podmínky, které budou použity u tohoto pole, pokud člen týmu změní stav pracovní položky daného typu a Určuje důvod změny.

<FIELD refname="FieldReferenceName">
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
<FIELD>

Další informace naleznete v tématu FIELD (pracovní postup) – element (referenční dokumentace).

Nepovinné

FIELDS

Určuje kolekci FIELD elementy.

<FIELDS>
   <FIELD . . . </FIELD>
</FIELDS>

Nepovinné

REASON

Definuje další vysvětlení proč člen týmu změněn stav pracovní položky.

<REASON value="NameOfReason">
   <FIELDS>. . . </FIELDS>
</REASON>

Nepovinné

REASONS

Kolekce jedné DEFAULTREASON a volitelné REASON prvky, které popisují, proč se člen týmu změní stav pracovní položky.

<REASONS>
   <DEFAULTREASON>. . . </DEFAULTREASON>
   <REASON>. . . </REASON>
</REASONS>

STATE

Definuje platný stav pro typ pracovní položky. Tento element může obsahovat FIELDS element, který odkazuje na pravidla a podmínky, které budou použity na konkrétní pole, když člen týmu změní stav pracovní položky daného typu.

<STATE value="NameOfState">
  <FIELDS>. . . </FIELDS>
</STATE>

Požadováno

STATES

Určuje kolekci STATE prvky, které definují platnou stavy, ke kterým může uživatel přiřadit pracovní položky daného typu.

<STATES>
   <STATE>. . . </STATE>
</STATES>

Požadováno

TRANSITION

Určuje platné průběh nebo regresní z jednoho stavu do druhého pro pracovní položky určitého typu.

<TRANSITION from="NameOfStartingState" 
   to="NameOfEndingState" 
   for="UserOrGroupName"
   not="UserOrGroupName">
   <ACTIONS>. . . </ACTIONS>
   <REASONS>. . . </REASONS>
   <FIELDS>. . . </FIELDS>
</TRANSITION>

Další informace naleznete v tématu Přechod Element.

Požadováno

TRANSITIONS

Určuje kolekci TRANSITION elementy.

<TRANSITIONS>
    <TRANSITION>. . . </TRANSITION>
</TRANSITIONS>

Požadováno

WORKFLOW

Určuje kolekci STATES a TRANSITIONS kontejneru elementů, které společně definují pracovního postupu pro typ pracovní položky.

<WORKFLOW>
   <STATES>. . . </STATES>
   <TRANSITIONS>. . . </TRANSITIONS>
</WORKFLOW>

Požadováno

Viz také

Referenční dokumentace

FIELD (pracovní postup) – element (referenční dokumentace)

Koncepty

Change the workflow for a work item type