Freigeben über

Verweis für alle WORKFLOW-XML-Elemente

  • Artikel

Die im vorliegenden Thema enthaltenen Informationen können als Kurzübersicht für alle Elemente und Hauptattribute genutzt werden, die den Workflow eines Typs von Arbeitsaufgabe steuern. Sie geben diese Elemente im WORKFLOW-Elementcontainer an, dem zweiten Hauptabschnitt der Definition eines Arbeitsaufgabentyps. Sie verwenden die untergeordnete Elemente STATES und TRANSITIONS, um die verschiedenen Zustände, die ein Benutzer für einen Typ von Arbeitsaufgabe angeben kann, und die Übergänge zu definieren, die zwischen Zuständen erlaubt sind. Weitere Informationen zum Definieren dieser Elemente finden Sie unter Change the workflow for a work item type.

Um den Workflow zu ändern, müssen Sie die Definition eines Arbeitsaufgabentyps ändern. Weitere Informationen finden Sie unter Anpassen oder Hinzufügen eines benutzerdefinierten Arbeitsaufgabentyps (WIT).

WORKFLOW-Beispiel

Im folgenden Beispiel wird die Gesamtstruktur des WORKFLOW-Elements veranschaulicht. Sie geben alle Zustände an, die ein Benutzer einem Arbeitsaufgabentyp in einem STATES-Container zunächst zuweisen kann. Als Nächstes geben Sie alle Übergänge an, die von einem Zustand in einen anderen zulässig sind. Jeder Zustand entspricht einem STATE-Element, und jeder Übergang entspricht einem TRANSITION-Element. In jedem STATES- und TRANSITIONS-Containerelement können Sie die Zustände und Übergänge in der gewünschten Reihenfolge definieren.

Für jeden Übergang geben Sie eine Reihe von Gründen für das Ändern des Zustands der Arbeitsaufgabe an, einschließlich Standardgrund. Sie können Werte für jeden Zustand, Übergang oder Grund zuweisen und Bedingungen für die Werte eines oder mehrerer Felder mit dem (Workflow-) Element FIELD angeben. Darüber hinaus können Sie eine Aktion auslösen, die während eines Übergangs erfolgt, indem Sie das ACTION-Element angeben.

<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>

Syntaxstruktur

Durch Verwenden der Elemente, die in der folgende Tabelle beschrieben sind, können Sie angeben, welche Zustände ein Teammitglied einer Arbeitsaufgabe eines bestimmten Typs zuweisen kann. Im Abschnitt WORKFLOW der Definition legen Sie zuerst Zustände und anschließend Übergänge fest. Weitere Informationen finden Sie unter Change the workflow for a work item type.

Element

Beschreibung und Syntax

Erforderlich?

ACTION

Definiert eine Textzeichenfolge, die einer Aktion entspricht, die ausgeführt werden soll, wenn das System zum Nachverfolgen von Arbeitsaufgaben die WorkItem.GetNextState-Methode aufruft, um den Zustand der Arbeitsaufgabe nach der Aktion abzurufen.

<ACTION value="NameOfAction" />

Weitere Informationen finden Sie unter Automatisieren von Feldzuweisungen auf Grundlage von Zustand, Übergang oder Grund.

Optional

ACTIONS

Definiert eine Auflistung von ACTION-Elementen.

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

Optional

DEFAULTREASON

Definiert die häufigste Ursache, wegen der ein Teammitglied den Zustand einer Arbeitsaufgabe in einen anderen bestimmten Zustand ändert.

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

Erforderlich

FIELD

Gibt ein Feld für einen Typ von Arbeitsaufgabe und die Regeln und Bedingungen an, die auf dieses Feld angewendet werden, wenn ein Teammitglied den Zustand einer Arbeitsaufgabe dieses Typs ändert und einen Grund für die Änderung angibt.

<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>

Weitere Informationen finden Sie unter FIELD (Workflow)-Elementverweis.

Optional

FIELDS

Gibt eine Auflistung von FIELD-Elementen an.

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

Optional

REASON

Definiert eine zusätzliche Erläuterung, warum ein Teammitglied den Zustand einer Arbeitsaufgabe geändert hat.

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

Optional

REASONS

Eine Auflistung von einem DEFAULTREASON- und optionalen REASON-Elementen, die erklären, warum ein Teammitglied den Zustand einer Arbeitsaufgabe geändert hat.

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

STATE

Definiert einen gültigen Zustand für den Arbeitsaufgabentyp. Dieses Element kann ein FIELDS-Element enthalten, das auf Regeln und Bedingungen verweist, die auf ein bestimmtes Feld angewendet werden, wenn ein Teammitglied den Zustand einer Arbeitsaufgabe dieses Typs ändert.

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

Erforderlich

STATES

Gibt eine Auflistung von STATE-Elementen an, die die gültigen Zustände definieren, die ein Benutzer einer Arbeitsaufgabe dieses Typs zuweisen kann.

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

Erforderlich

TRANSITION

Gibt für Arbeitsaufgaben eines bestimmten Typs einen gültigen Fortschritt oder einen Rückschritt von einem Zustand zu einem anderen Zustand an.

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

Weitere Informationen finden Sie unter TRANSITION -Element.

Erforderlich

TRANSITIONS

Gibt eine Auflistung von TRANSITION-Elementen an.

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

Erforderlich

WORKFLOW

Gibt die Auflistung der STATES- und TRANSITIONS-Containerelemente an, die zusammen den Workflow für den Typ der Arbeitsaufgabe definieren.

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

Erforderlich

Siehe auch

Referenz

FIELD (Workflow)-Elementverweis

Konzepte

Change the workflow for a work item type