Freigeben über

XML-Elementreferenz für WORKFLOW

  • Artikel

Die im vorliegenden Thema enthaltenen Informationen können als Kurzübersicht für alle Elemente und Hauptattribute genutzt werden, die den Workflow für einen Typ von Arbeitsaufgabe steuern. Diese Elemente werden im WORKFLOW-Elementcontainer angegeben, der den zweiten Hauptabschnitt der Definition eines Arbeitsaufgabentyps bildet. Sie verwenden die untergeordneten Elemente STATES und TRANSITIONS zum Definieren der unterschiedlichen Zustände, die ein Benutzer für einen Arbeitsaufgabentyp angeben kann, bzw. zum Definieren der zulässigen Übergänge zwischen den Zuständen. Weitere Informationen zum Definieren dieser Elemente finden Sie unter Entwerfen des Workflows.

In diesem Thema

  • WORKFLOW-Beispiel

  • Syntaxstruktur für WORKFLOW-Elemente

WORKFLOW-Beispiel

Im folgenden Beispiel wird die Gesamtstruktur des WORKFLOW-Elements veranschaulicht. Alle Zustände, die ein Benutzer einem Arbeitsaufgabentyp zuweisen kann, werden innerhalb eines STATES-Containers angegeben. Anschließend werden alle zulässigen Übergänge zwischen den Zuständen angegeben. Jeder Zustand entspricht einem STATE-Element, und jeder Übergang entspricht einem TRANSITION-Element. Die Zustände und Übergänge können innerhalb der einzelnen STATES- und TRANSITIONS-Containerelemente in beliebiger Reihenfolge definiert werden.

Für jeden Übergang werden Gründe für die Änderung des Zustands der Arbeitsaufgabe angegeben. Hierzu zählt auch ein Standardgrund. Sie können mithilfe des FIELD (Workflow)-Elements Werte für jeden Zustand, Übergang oder Grund zuweisen und Bedingungen für die Werte von Feldern festlegen. Darüber hinaus kann durch Angeben des ACTION-Elements während eines Übergangs eine Aktion ausgelöst werden.

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

Zurück nach oben

Syntaxstruktur für WORKFLOW-Elemente

Anhand der Elemente in der folgenden Tabelle können Sie angeben, welche Zustände ein Teammitglied für eine Arbeitsaufgabe eines bestimmten Typs festlegen kann. Im Abschnitt WORKFLOW der Definition definieren Sie zuerst Zustände und dann Übergänge. Weitere Informationen finden Sie unter Entwerfen des Workflows.

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

Dient zum Definieren des häufigsten Grunds für die Änderung einer Arbeitsaufgabe von einem bestimmten Zustand in einen anderen bestimmten Zustand durch ein Teammitglied.

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

Erforderlich

FIELD

Gibt ein Feld für einen Arbeitsaufgabentyp sowie die Regeln und Bedingungen an, die für 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)-Element.

Optional

FIELDS

Gibt eine Auflistung von FIELD-Elementen an.

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

Optional

REASON

Dient zum Definieren einer zusätzlichen Erläuterung des Grunds für die Änderung des Zustands einer Arbeitsaufgabe durch ein Teammitglied.

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

Optional

REASONS

Eine Auflistung von einem DEFAULTREASON-Element sowie optionalen REASON-Elementen, mit denen der Grund für die Änderung des Zustands einer Arbeitsaufgabe durch ein Teammitglied erklärt wird.

<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 von einem Benutzer einer Arbeitsaufgabe dieses Typs zugewiesen werden können.

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

Erforderlich

TRANSITION

Gibt für Arbeitsaufgaben eines bestimmten Typs einen gültigen Fortschritt oder eine Regression 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 von STATES- sowie TRANSITIONS-Containerelementen an, die zusammen den Workflow für den Arbeitsaufgabentyp definieren.

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

Erforderlich

Zurück nach oben

Siehe auch

Referenz

FIELD (Workflow)-Element

Konzepte

Entwerfen des Workflows

Weitere Ressourcen

Definieren und Anpassen des Workflows für Arbeitsaufgaben